@bluelibs/runner 4.6.0 → 4.7.0-alpha

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 (156) hide show
  1. package/AI.md +319 -579
  2. package/README.md +886 -731
  3. package/dist/browser/index.cjs +1438 -251
  4. package/dist/browser/index.cjs.map +1 -1
  5. package/dist/browser/index.mjs +1433 -252
  6. package/dist/browser/index.mjs.map +1 -1
  7. package/dist/context.d.ts +31 -0
  8. package/dist/define.d.ts +9 -0
  9. package/dist/definers/builders/core.d.ts +30 -0
  10. package/dist/definers/builders/event.d.ts +12 -0
  11. package/dist/definers/builders/hook.d.ts +20 -0
  12. package/dist/definers/builders/middleware.d.ts +39 -0
  13. package/dist/definers/builders/resource.d.ts +40 -0
  14. package/dist/definers/builders/tag.d.ts +10 -0
  15. package/dist/definers/builders/task.d.ts +37 -0
  16. package/dist/definers/builders/task.phantom.d.ts +27 -0
  17. package/dist/definers/builders/utils.d.ts +4 -0
  18. package/dist/definers/defineEvent.d.ts +2 -0
  19. package/dist/definers/defineHook.d.ts +6 -0
  20. package/dist/definers/defineOverride.d.ts +17 -0
  21. package/dist/definers/defineResource.d.ts +2 -0
  22. package/dist/definers/defineResourceMiddleware.d.ts +2 -0
  23. package/dist/definers/defineTag.d.ts +12 -0
  24. package/dist/definers/defineTask.d.ts +18 -0
  25. package/dist/definers/defineTaskMiddleware.d.ts +2 -0
  26. package/dist/definers/tools.d.ts +47 -0
  27. package/dist/defs.d.ts +29 -0
  28. package/dist/edge/index.cjs +1438 -251
  29. package/dist/edge/index.cjs.map +1 -1
  30. package/dist/edge/index.mjs +1433 -252
  31. package/dist/edge/index.mjs.map +1 -1
  32. package/dist/errors.d.ts +104 -0
  33. package/dist/globals/globalEvents.d.ts +8 -0
  34. package/dist/globals/globalMiddleware.d.ts +31 -0
  35. package/dist/globals/globalResources.d.ts +32 -0
  36. package/dist/globals/globalTags.d.ts +11 -0
  37. package/dist/globals/middleware/cache.middleware.d.ts +27 -0
  38. package/dist/globals/middleware/requireContext.middleware.d.ts +6 -0
  39. package/dist/globals/middleware/retry.middleware.d.ts +21 -0
  40. package/dist/globals/middleware/timeout.middleware.d.ts +9 -0
  41. package/dist/globals/middleware/tunnel.middleware.d.ts +2 -0
  42. package/dist/globals/resources/debug/debug.resource.d.ts +7 -0
  43. package/dist/globals/resources/debug/debug.tag.d.ts +2 -0
  44. package/dist/globals/resources/debug/debugConfig.resource.d.ts +22 -0
  45. package/dist/globals/resources/debug/executionTracker.middleware.d.ts +50 -0
  46. package/dist/globals/resources/debug/globalEvent.hook.d.ts +27 -0
  47. package/dist/globals/resources/debug/hook.hook.d.ts +30 -0
  48. package/dist/globals/resources/debug/index.d.ts +6 -0
  49. package/dist/globals/resources/debug/middleware.hook.d.ts +30 -0
  50. package/dist/globals/resources/debug/types.d.ts +25 -0
  51. package/dist/globals/resources/debug/utils.d.ts +2 -0
  52. package/dist/globals/resources/queue.resource.d.ts +10 -0
  53. package/dist/globals/resources/tunnel/ejson-extensions.d.ts +1 -0
  54. package/dist/globals/resources/tunnel/error-utils.d.ts +1 -0
  55. package/dist/globals/resources/tunnel/plan.d.ts +19 -0
  56. package/dist/globals/resources/tunnel/protocol.d.ts +40 -0
  57. package/dist/globals/resources/tunnel/serializer.d.ts +9 -0
  58. package/dist/globals/resources/tunnel/tunnel.policy.tag.d.ts +18 -0
  59. package/dist/globals/resources/tunnel/tunnel.tag.d.ts +2 -0
  60. package/dist/globals/resources/tunnel/types.d.ts +17 -0
  61. package/dist/globals/tunnels/index.d.ts +23 -0
  62. package/dist/globals/types.d.ts +1 -0
  63. package/dist/http-client.d.ts +23 -0
  64. package/dist/http-fetch-tunnel.resource.d.ts +22 -0
  65. package/dist/index.d.ts +99 -0
  66. package/dist/models/DependencyProcessor.d.ts +48 -0
  67. package/dist/models/EventManager.d.ts +153 -0
  68. package/dist/models/LogPrinter.d.ts +55 -0
  69. package/dist/models/Logger.d.ts +85 -0
  70. package/dist/models/MiddlewareManager.d.ts +86 -0
  71. package/dist/models/OverrideManager.d.ts +13 -0
  72. package/dist/models/Queue.d.ts +26 -0
  73. package/dist/models/ResourceInitializer.d.ts +20 -0
  74. package/dist/models/RunResult.d.ts +35 -0
  75. package/dist/models/Semaphore.d.ts +61 -0
  76. package/dist/models/Store.d.ts +69 -0
  77. package/dist/models/StoreRegistry.d.ts +43 -0
  78. package/dist/models/StoreValidator.d.ts +8 -0
  79. package/dist/models/TaskRunner.d.ts +27 -0
  80. package/dist/models/UnhandledError.d.ts +11 -0
  81. package/dist/models/index.d.ts +11 -0
  82. package/dist/models/utils/findCircularDependencies.d.ts +16 -0
  83. package/dist/models/utils/safeStringify.d.ts +3 -0
  84. package/dist/node/exposure/allowList.d.ts +3 -0
  85. package/dist/node/exposure/authenticator.d.ts +6 -0
  86. package/dist/node/exposure/cors.d.ts +4 -0
  87. package/dist/node/exposure/createNodeExposure.d.ts +2 -0
  88. package/dist/node/exposure/exposureServer.d.ts +18 -0
  89. package/dist/node/exposure/httpResponse.d.ts +10 -0
  90. package/dist/node/exposure/logging.d.ts +4 -0
  91. package/dist/node/exposure/multipart.d.ts +27 -0
  92. package/dist/node/exposure/requestBody.d.ts +11 -0
  93. package/dist/node/exposure/requestContext.d.ts +17 -0
  94. package/dist/node/exposure/requestHandlers.d.ts +24 -0
  95. package/dist/node/exposure/resourceTypes.d.ts +60 -0
  96. package/dist/node/exposure/router.d.ts +17 -0
  97. package/dist/node/exposure/serverLifecycle.d.ts +13 -0
  98. package/dist/node/exposure/types.d.ts +31 -0
  99. package/dist/node/exposure/utils.d.ts +17 -0
  100. package/dist/node/exposure.resource.d.ts +12 -0
  101. package/dist/node/files.d.ts +9 -0
  102. package/dist/node/http-smart-client.model.d.ts +22 -0
  103. package/dist/node/index.d.ts +1 -0
  104. package/dist/node/inputFile.model.d.ts +22 -0
  105. package/dist/node/inputFile.utils.d.ts +14 -0
  106. package/dist/node/mixed-http-client.node.d.ts +27 -0
  107. package/dist/node/node.cjs +11168 -0
  108. package/dist/node/node.cjs.map +1 -0
  109. package/dist/node/node.d.ts +6 -0
  110. package/dist/node/node.mjs +11099 -0
  111. package/dist/node/node.mjs.map +1 -0
  112. package/dist/node/platform/createFile.d.ts +9 -0
  113. package/dist/node/tunnel.allowlist.d.ts +7 -0
  114. package/dist/node/upload/manifest.d.ts +22 -0
  115. package/dist/platform/adapters/browser.d.ts +14 -0
  116. package/dist/platform/adapters/edge.d.ts +5 -0
  117. package/dist/platform/adapters/node-als.d.ts +1 -0
  118. package/dist/platform/adapters/node.d.ts +15 -0
  119. package/dist/platform/adapters/universal-generic.d.ts +14 -0
  120. package/dist/platform/adapters/universal.d.ts +17 -0
  121. package/dist/platform/createFile.d.ts +10 -0
  122. package/dist/platform/createWebFile.d.ts +11 -0
  123. package/dist/platform/factory.d.ts +2 -0
  124. package/dist/platform/index.d.ts +27 -0
  125. package/dist/platform/types.d.ts +29 -0
  126. package/dist/processHooks.d.ts +2 -0
  127. package/dist/run.d.ts +14 -0
  128. package/dist/testing.d.ts +25 -0
  129. package/dist/tools/getCallerFile.d.ts +1 -0
  130. package/dist/tunnels/buildUniversalManifest.d.ts +24 -0
  131. package/dist/types/contracts.d.ts +63 -0
  132. package/dist/types/event.d.ts +74 -0
  133. package/dist/types/hook.d.ts +23 -0
  134. package/dist/types/inputFile.d.ts +34 -0
  135. package/dist/types/meta.d.ts +18 -0
  136. package/dist/types/resource.d.ts +87 -0
  137. package/dist/types/resourceMiddleware.d.ts +47 -0
  138. package/dist/types/runner.d.ts +55 -0
  139. package/dist/types/storeTypes.d.ts +40 -0
  140. package/dist/types/symbols.d.ts +28 -0
  141. package/dist/types/tag.d.ts +46 -0
  142. package/dist/types/task.d.ts +50 -0
  143. package/dist/types/taskMiddleware.d.ts +48 -0
  144. package/dist/types/utilities.d.ts +111 -0
  145. package/dist/universal/index.cjs +1438 -251
  146. package/dist/universal/index.cjs.map +1 -1
  147. package/dist/universal/index.mjs +1433 -252
  148. package/dist/universal/index.mjs.map +1 -1
  149. package/package.json +34 -8
  150. package/dist/index.d.mts +0 -1747
  151. package/dist/index.unused.js +0 -4466
  152. package/dist/index.unused.js.map +0 -1
  153. package/dist/node/index.cjs +0 -4498
  154. package/dist/node/index.cjs.map +0 -1
  155. package/dist/node/index.mjs +0 -4466
  156. package/dist/node/index.mjs.map +0 -1
@@ -1,4466 +0,0 @@
1
- import { LRUCache } from 'lru-cache';
2
-
3
- var __defProp = Object.defineProperty;
4
- var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
5
- var __export = (target, all) => {
6
- for (var name in all)
7
- __defProp(target, name, { get: all[name], enumerable: true });
8
- };
9
-
10
- // src/defs.ts
11
- var defs_exports = {};
12
- __export(defs_exports, {
13
- isOneOf: () => isOneOf,
14
- onAnyOf: () => onAnyOf,
15
- symbolEvent: () => symbolEvent,
16
- symbolFilePath: () => symbolFilePath,
17
- symbolHook: () => symbolHook,
18
- symbolMiddleware: () => symbolMiddleware,
19
- symbolMiddlewareConfigured: () => symbolMiddlewareConfigured,
20
- symbolOptionalDependency: () => symbolOptionalDependency,
21
- symbolResource: () => symbolResource,
22
- symbolResourceMiddleware: () => symbolResourceMiddleware,
23
- symbolResourceWithConfig: () => symbolResourceWithConfig,
24
- symbolTag: () => symbolTag,
25
- symbolTagConfigured: () => symbolTagConfigured,
26
- symbolTask: () => symbolTask,
27
- symbolTaskMiddleware: () => symbolTaskMiddleware
28
- });
29
-
30
- // src/types/symbols.ts
31
- var symbolTask = Symbol.for("runner.task");
32
- var symbolResource = Symbol.for("runner.resource");
33
- var symbolResourceWithConfig = Symbol.for(
34
- "runner.resourceWithConfig"
35
- );
36
- var symbolEvent = Symbol.for("runner.event");
37
- var symbolMiddleware = Symbol.for("runner.middleware");
38
- var symbolTaskMiddleware = Symbol.for(
39
- "runner.taskMiddleware"
40
- );
41
- var symbolResourceMiddleware = Symbol.for(
42
- "runner.resourceMiddleware"
43
- );
44
- var symbolMiddlewareConfigured = Symbol.for(
45
- "runner.middlewareConfigured"
46
- );
47
- var symbolHook = Symbol.for("runner.hook");
48
- var symbolTag = Symbol.for("runner.tag");
49
- var symbolTagConfigured = Symbol.for(
50
- "runner.tagConfigured"
51
- );
52
- var symbolOptionalDependency = Symbol.for(
53
- "runner.optionalDependency"
54
- );
55
- var symbolFilePath = Symbol.for("runner.filePath");
56
-
57
- // src/types/event.ts
58
- function onAnyOf(...defs) {
59
- return defs;
60
- }
61
- __name(onAnyOf, "onAnyOf");
62
- function isOneOf(emission, defs) {
63
- return defs.some((d) => d.id === emission.id);
64
- }
65
- __name(isOneOf, "isOneOf");
66
- var cacheFactoryTask = defineTask({
67
- id: "globals.tasks.cacheFactory",
68
- run: /* @__PURE__ */ __name(async (options) => {
69
- return new LRUCache(options);
70
- }, "run")
71
- });
72
- var cacheResource = defineResource({
73
- id: "globals.resources.cache",
74
- register: [cacheFactoryTask],
75
- dependencies: {
76
- cacheFactoryTask
77
- },
78
- init: /* @__PURE__ */ __name(async (config, { cacheFactoryTask: cacheFactoryTask2 }) => {
79
- return {
80
- map: /* @__PURE__ */ new Map(),
81
- cacheFactoryTask: cacheFactoryTask2,
82
- defaultOptions: {
83
- ttl: 10 * 1e3,
84
- max: 100,
85
- // Maximum number of items in cache
86
- ttlAutopurge: true,
87
- // Automatically purge expired items
88
- ...config.defaultOptions
89
- }
90
- };
91
- }, "init"),
92
- dispose: /* @__PURE__ */ __name(async (cache) => {
93
- for (const cacheInstance of cache.map.values()) {
94
- await cacheInstance.clear();
95
- }
96
- }, "dispose")
97
- });
98
- var defaultKeyBuilder = /* @__PURE__ */ __name((taskId, input) => `${taskId}-${JSON.stringify(input)}`, "defaultKeyBuilder");
99
- var cacheMiddleware = defineTaskMiddleware({
100
- id: "globals.middleware.cache",
101
- dependencies: { cache: cacheResource },
102
- async run({ task, next }, deps, config) {
103
- const { cache } = deps;
104
- config = {
105
- keyBuilder: defaultKeyBuilder,
106
- ttl: 10 * 1e3,
107
- max: 100,
108
- // Maximum number of items in cache
109
- ttlAutopurge: true,
110
- // Automatically purge expired items
111
- ...config
112
- };
113
- const taskId = task.definition.id;
114
- let cacheHolderForTask = cache.map.get(taskId);
115
- if (!cacheHolderForTask) {
116
- const { keyBuilder, ...lruOptions } = config;
117
- const cacheOptions = {
118
- ...cache.defaultOptions,
119
- ...lruOptions
120
- };
121
- cacheHolderForTask = await cache.cacheFactoryTask(cacheOptions);
122
- cache.map.set(taskId, cacheHolderForTask);
123
- }
124
- const key = config.keyBuilder(taskId, task.input);
125
- const cachedValue = await cacheHolderForTask.get(key);
126
- if (cachedValue) {
127
- return cachedValue;
128
- }
129
- const result = await next(task.input);
130
- await cacheHolderForTask.set(key, result);
131
- return result;
132
- }
133
- });
134
-
135
- // src/tools/getCallerFile.ts
136
- function getCallerFile() {
137
- const originalFunc = Error.prepareStackTrace;
138
- try {
139
- const err = new Error();
140
- let callerfile;
141
- let currentfile;
142
- Error.prepareStackTrace = (err2, stack2) => stack2;
143
- const stack = err.stack;
144
- stack.shift();
145
- currentfile = stack.shift()?.getFileName?.();
146
- callerfile = stack.shift()?.getFileName?.();
147
- return callerfile;
148
- } finally {
149
- Error.prepareStackTrace = originalFunc;
150
- }
151
- }
152
- __name(getCallerFile, "getCallerFile");
153
-
154
- // src/definers/defineTask.ts
155
- function defineTask(taskConfig) {
156
- const filePath = getCallerFile();
157
- const id2 = taskConfig.id;
158
- return {
159
- [symbolTask]: true,
160
- [symbolFilePath]: filePath,
161
- id: id2,
162
- dependencies: taskConfig.dependencies || {},
163
- middleware: taskConfig.middleware || [],
164
- run: taskConfig.run,
165
- inputSchema: taskConfig.inputSchema,
166
- resultSchema: taskConfig.resultSchema,
167
- meta: taskConfig.meta || {},
168
- tags: taskConfig.tags || [],
169
- // autorun,
170
- optional() {
171
- return {
172
- inner: this,
173
- [symbolOptionalDependency]: true
174
- };
175
- }
176
- };
177
- }
178
- __name(defineTask, "defineTask");
179
-
180
- // src/definers/defineHook.ts
181
- function defineHook(hookDef) {
182
- const filePath = getCallerFile();
183
- return {
184
- [symbolHook]: true,
185
- [symbolFilePath]: filePath,
186
- id: hookDef.id,
187
- dependencies: hookDef.dependencies || {},
188
- on: hookDef.on,
189
- order: hookDef.order,
190
- run: hookDef.run,
191
- meta: hookDef.meta || {},
192
- tags: hookDef.tags || []
193
- };
194
- }
195
- __name(defineHook, "defineHook");
196
-
197
- // src/errors.ts
198
- var errors_exports = {};
199
- __export(errors_exports, {
200
- CircularDependenciesError: () => CircularDependenciesError,
201
- ContextError: () => ContextError,
202
- DependencyNotFoundError: () => DependencyNotFoundError,
203
- DuplicateRegistrationError: () => DuplicateRegistrationError,
204
- EventCycleError: () => EventCycleError,
205
- EventEmissionCycleError: () => EventEmissionCycleError,
206
- EventNotFoundError: () => EventNotFoundError,
207
- LockedError: () => LockedError,
208
- MiddlewareNotRegisteredError: () => MiddlewareNotRegisteredError,
209
- PlatformUnsupportedFunction: () => PlatformUnsupportedFunction,
210
- ResourceNotFoundError: () => ResourceNotFoundError,
211
- RuntimeError: () => RuntimeError,
212
- StoreAlreadyInitializedError: () => StoreAlreadyInitializedError,
213
- TagNotFoundError: () => TagNotFoundError,
214
- UnknownItemTypeError: () => UnknownItemTypeError,
215
- ValidationError: () => ValidationError
216
- });
217
-
218
- // src/platform/adapters/node-als.ts
219
- async function loadAsyncLocalStorageClass() {
220
- const mod = await import('async_hooks');
221
- return mod.AsyncLocalStorage;
222
- }
223
- __name(loadAsyncLocalStorageClass, "loadAsyncLocalStorageClass");
224
-
225
- // src/platform/adapters/node.ts
226
- var NodePlatformAdapter = class {
227
- constructor() {
228
- this.id = "node";
229
- this.setTimeout = globalThis.setTimeout;
230
- this.clearTimeout = globalThis.clearTimeout;
231
- }
232
- static {
233
- __name(this, "NodePlatformAdapter");
234
- }
235
- async init() {
236
- this.alsClass = await loadAsyncLocalStorageClass();
237
- }
238
- onUncaughtException(handler) {
239
- process.on("uncaughtException", handler);
240
- return () => process.off("uncaughtException", handler);
241
- }
242
- onUnhandledRejection(handler) {
243
- const h = /* @__PURE__ */ __name((reason) => handler(reason), "h");
244
- process.on("unhandledRejection", h);
245
- return () => process.off("unhandledRejection", h);
246
- }
247
- onShutdownSignal(handler) {
248
- process.on("SIGINT", handler);
249
- process.on("SIGTERM", handler);
250
- return () => {
251
- process.off("SIGINT", handler);
252
- process.off("SIGTERM", handler);
253
- };
254
- }
255
- exit(code) {
256
- process.exit(code);
257
- }
258
- getEnv(key) {
259
- return process.env[key];
260
- }
261
- hasAsyncLocalStorage() {
262
- return true;
263
- }
264
- createAsyncLocalStorage() {
265
- let instance;
266
- const ensure = /* @__PURE__ */ __name(() => {
267
- if (!this.alsClass) {
268
- throw new PlatformUnsupportedFunction(
269
- "createAsyncLocalStorage: Platform not initialized"
270
- );
271
- }
272
- return instance ??= new this.alsClass();
273
- }, "ensure");
274
- return {
275
- getStore: /* @__PURE__ */ __name(() => ensure().getStore(), "getStore"),
276
- run: /* @__PURE__ */ __name((store2, callback) => ensure().run(store2, callback), "run")
277
- };
278
- }
279
- };
280
-
281
- // src/platform/adapters/browser.ts
282
- var BrowserPlatformAdapter = class {
283
- constructor() {
284
- this.id = "browser";
285
- this.setTimeout = globalThis.setTimeout;
286
- this.clearTimeout = globalThis.clearTimeout;
287
- }
288
- static {
289
- __name(this, "BrowserPlatformAdapter");
290
- }
291
- async init() {
292
- }
293
- onUncaughtException(handler) {
294
- const target = globalThis.window ?? globalThis;
295
- const h = /* @__PURE__ */ __name((e) => handler(e?.error ?? e), "h");
296
- target.addEventListener?.("error", h);
297
- return () => target.removeEventListener?.("error", h);
298
- }
299
- onUnhandledRejection(handler) {
300
- const target = globalThis.window ?? globalThis;
301
- const wrap = /* @__PURE__ */ __name((e) => handler(e?.reason ?? e), "wrap");
302
- target.addEventListener?.("unhandledrejection", wrap);
303
- return () => target.removeEventListener?.("unhandledrejection", wrap);
304
- }
305
- onShutdownSignal(handler) {
306
- const win = globalThis.window ?? globalThis;
307
- const handlers = {};
308
- handlers.before = (e) => handler();
309
- win.addEventListener?.("beforeunload", handlers.before);
310
- const doc = globalThis.document;
311
- if (doc && typeof win.addEventListener === "function") {
312
- handlers.visibility = () => {
313
- if (doc.visibilityState === "hidden") handler();
314
- };
315
- win.addEventListener?.("visibilitychange", handlers.visibility);
316
- }
317
- return () => {
318
- win.removeEventListener?.("beforeunload", handlers.before);
319
- if (handlers.visibility) win.removeEventListener?.("visibilitychange", handlers.visibility);
320
- };
321
- }
322
- exit() {
323
- throw new PlatformUnsupportedFunction("exit");
324
- }
325
- getEnv(key) {
326
- const g = globalThis;
327
- if (g.__ENV__ && typeof g.__ENV__ === "object") return g.__ENV__[key];
328
- if (typeof process !== "undefined" && process.env)
329
- return process.env[key];
330
- if (g.env && typeof g.env === "object") return g.env[key];
331
- return void 0;
332
- }
333
- hasAsyncLocalStorage() {
334
- return false;
335
- }
336
- createAsyncLocalStorage() {
337
- return {
338
- getStore: /* @__PURE__ */ __name(() => {
339
- throw new PlatformUnsupportedFunction("createAsyncLocalStorage");
340
- }, "getStore"),
341
- run: /* @__PURE__ */ __name(() => {
342
- throw new PlatformUnsupportedFunction("createAsyncLocalStorage");
343
- }, "run")
344
- };
345
- }
346
- };
347
-
348
- // src/platform/adapters/edge.ts
349
- var EdgePlatformAdapter = class extends BrowserPlatformAdapter {
350
- constructor() {
351
- super(...arguments);
352
- this.id = "edge";
353
- }
354
- static {
355
- __name(this, "EdgePlatformAdapter");
356
- }
357
- onShutdownSignal(handler) {
358
- return () => {
359
- };
360
- }
361
- };
362
-
363
- // src/platform/adapters/universal-generic.ts
364
- var GenericUniversalPlatformAdapter = class {
365
- constructor() {
366
- this.id = "universal";
367
- this.setTimeout = globalThis.setTimeout;
368
- this.clearTimeout = globalThis.clearTimeout;
369
- }
370
- static {
371
- __name(this, "GenericUniversalPlatformAdapter");
372
- }
373
- async init() {
374
- }
375
- onUncaughtException(handler) {
376
- const tgt = globalThis;
377
- if (tgt.addEventListener) {
378
- const h = /* @__PURE__ */ __name((e) => handler(e?.error ?? e), "h");
379
- tgt.addEventListener("error", h);
380
- return () => tgt.removeEventListener?.("error", h);
381
- }
382
- return () => {
383
- };
384
- }
385
- onUnhandledRejection(handler) {
386
- const tgt = globalThis;
387
- if (tgt.addEventListener) {
388
- const wrap = /* @__PURE__ */ __name((e) => handler(e?.reason ?? e), "wrap");
389
- tgt.addEventListener("unhandledrejection", wrap);
390
- return () => tgt.removeEventListener?.("unhandledrejection", wrap);
391
- }
392
- return () => {
393
- };
394
- }
395
- onShutdownSignal(handler) {
396
- const tgt = globalThis;
397
- if (tgt.addEventListener) {
398
- const handlers = {};
399
- handlers.before = (e) => handler();
400
- tgt.addEventListener("beforeunload", handlers.before);
401
- const doc = globalThis.document;
402
- if (doc) {
403
- handlers.visibility = () => {
404
- if (doc.visibilityState === "hidden") handler();
405
- };
406
- tgt.addEventListener?.("visibilitychange", handlers.visibility);
407
- }
408
- return () => {
409
- tgt.removeEventListener?.("beforeunload", handlers.before);
410
- if (handlers.visibility)
411
- tgt.removeEventListener?.("visibilitychange", handlers.visibility);
412
- };
413
- }
414
- return () => {
415
- };
416
- }
417
- exit() {
418
- throw new PlatformUnsupportedFunction("exit");
419
- }
420
- getEnv(key) {
421
- const g = globalThis;
422
- if (g.__ENV__ && typeof g.__ENV__ === "object") return g.__ENV__[key];
423
- if (typeof process !== "undefined" && process.env)
424
- return process.env[key];
425
- if (g.env && typeof g.env === "object") return g.env[key];
426
- return void 0;
427
- }
428
- hasAsyncLocalStorage() {
429
- return false;
430
- }
431
- createAsyncLocalStorage() {
432
- return {
433
- getStore: /* @__PURE__ */ __name(() => {
434
- throw new PlatformUnsupportedFunction("createAsyncLocalStorage");
435
- }, "getStore"),
436
- run: /* @__PURE__ */ __name(() => {
437
- throw new PlatformUnsupportedFunction("createAsyncLocalStorage");
438
- }, "run")
439
- };
440
- }
441
- };
442
-
443
- // src/platform/adapters/universal.ts
444
- function detectEnvironment() {
445
- if (typeof window !== "undefined" && typeof document !== "undefined") {
446
- return "browser";
447
- }
448
- if (typeof process !== "undefined" && process.versions && process.versions.node) {
449
- return "node";
450
- }
451
- if (typeof globalThis.Deno !== "undefined") {
452
- return "universal";
453
- }
454
- if (typeof globalThis.Bun !== "undefined" || typeof process !== "undefined" && process.versions?.bun) {
455
- return "universal";
456
- }
457
- if (typeof globalThis.WorkerGlobalScope !== "undefined" && typeof self !== "undefined" && self instanceof globalThis.WorkerGlobalScope) {
458
- return "edge";
459
- }
460
- return "universal";
461
- }
462
- __name(detectEnvironment, "detectEnvironment");
463
- var UniversalPlatformAdapter = class {
464
- constructor() {
465
- this.id = "universal";
466
- this.inner = null;
467
- this.setTimeout = globalThis.setTimeout;
468
- this.clearTimeout = globalThis.clearTimeout;
469
- }
470
- static {
471
- __name(this, "UniversalPlatformAdapter");
472
- }
473
- async init() {
474
- if (!this.inner) {
475
- const kind = detectEnvironment();
476
- if (typeof globalThis.document !== "undefined" || typeof globalThis.addEventListener === "function") {
477
- this.inner = new BrowserPlatformAdapter();
478
- } else {
479
- switch (kind) {
480
- case "node":
481
- this.inner = new NodePlatformAdapter();
482
- break;
483
- // istanbul ignore next: this branch is unreachable in practice because detectEnvironment()
484
- // returns "browser" only when document is defined; we keep it for completeness.
485
- case "browser":
486
- this.inner = new BrowserPlatformAdapter();
487
- break;
488
- case "edge":
489
- this.inner = new EdgePlatformAdapter();
490
- break;
491
- default:
492
- this.inner = new GenericUniversalPlatformAdapter();
493
- }
494
- }
495
- }
496
- await this.inner.init();
497
- }
498
- get() {
499
- if (!this.inner) {
500
- const kind = detectEnvironment();
501
- if (typeof globalThis.document !== "undefined" || typeof globalThis.addEventListener === "function") {
502
- this.inner = new BrowserPlatformAdapter();
503
- } else {
504
- switch (kind) {
505
- case "node":
506
- this.inner = new NodePlatformAdapter();
507
- break;
508
- // istanbul ignore next: this branch is unreachable in practice because detectEnvironment()
509
- // returns "browser" only when document is defined; we keep it for completeness.
510
- case "browser":
511
- this.inner = new BrowserPlatformAdapter();
512
- break;
513
- case "edge":
514
- this.inner = new EdgePlatformAdapter();
515
- break;
516
- default:
517
- this.inner = new GenericUniversalPlatformAdapter();
518
- }
519
- }
520
- }
521
- return this.inner;
522
- }
523
- onUncaughtException(handler) {
524
- return this.get().onUncaughtException(handler);
525
- }
526
- onUnhandledRejection(handler) {
527
- return this.get().onUnhandledRejection(handler);
528
- }
529
- onShutdownSignal(handler) {
530
- return this.get().onShutdownSignal(handler);
531
- }
532
- exit(code) {
533
- return this.get().exit(code);
534
- }
535
- getEnv(key) {
536
- return this.get().getEnv(key);
537
- }
538
- hasAsyncLocalStorage() {
539
- return this.get().hasAsyncLocalStorage();
540
- }
541
- createAsyncLocalStorage() {
542
- return this.get().createAsyncLocalStorage();
543
- }
544
- };
545
-
546
- // src/platform/factory.ts
547
- function createPlatformAdapter() {
548
- {
549
- switch ("node") {
550
- case "node":
551
- return new NodePlatformAdapter();
552
- case "browser":
553
- return new BrowserPlatformAdapter();
554
- case "edge":
555
- return new EdgePlatformAdapter();
556
- }
557
- }
558
- return new UniversalPlatformAdapter();
559
- }
560
- __name(createPlatformAdapter, "createPlatformAdapter");
561
-
562
- // src/platform/index.ts
563
- var platformInstance = null;
564
- function getPlatform() {
565
- if (!platformInstance) {
566
- platformInstance = createPlatformAdapter();
567
- platformInstance.id;
568
- }
569
- return platformInstance;
570
- }
571
- __name(getPlatform, "getPlatform");
572
-
573
- // src/errors.ts
574
- var RuntimeError = class extends Error {
575
- static {
576
- __name(this, "RuntimeError");
577
- }
578
- constructor(message) {
579
- super(message);
580
- this.name = "RuntimeError";
581
- }
582
- };
583
- var DuplicateRegistrationError = class extends RuntimeError {
584
- static {
585
- __name(this, "DuplicateRegistrationError");
586
- }
587
- constructor(type, id2) {
588
- super(
589
- `${type} "${id2.toString()}" already registered. You might have used the same 'id' in two different components or you may have registered the same element twice.`
590
- );
591
- this.name = "DuplicateRegistrationError";
592
- }
593
- };
594
- var DependencyNotFoundError = class extends RuntimeError {
595
- static {
596
- __name(this, "DependencyNotFoundError");
597
- }
598
- constructor(key) {
599
- super(
600
- `Dependency ${key.toString()} not found. Did you forget to register it through a resource?`
601
- );
602
- this.name = "DependencyNotFoundError";
603
- }
604
- };
605
- var UnknownItemTypeError = class extends RuntimeError {
606
- static {
607
- __name(this, "UnknownItemTypeError");
608
- }
609
- constructor(item) {
610
- super(
611
- `Unknown item type: ${item}. Please ensure you are not using different versions of '@bluelibs/runner'`
612
- );
613
- this.name = "UnknownItemTypeError";
614
- }
615
- };
616
- var ContextError = class extends Error {
617
- static {
618
- __name(this, "ContextError");
619
- }
620
- constructor(message) {
621
- super(message);
622
- this.name = "ContextError";
623
- }
624
- };
625
- var CircularDependenciesError = class extends RuntimeError {
626
- static {
627
- __name(this, "CircularDependenciesError");
628
- }
629
- constructor(cycles) {
630
- const cycleDetails = cycles.map((cycle) => ` \u2022 ${cycle}`).join("\n");
631
- const hasMiddleware = cycles.some((cycle) => cycle.includes("middleware"));
632
- let guidance = "\n\nTo resolve circular dependencies:";
633
- guidance += "\n \u2022 Consider refactoring to reduce coupling between components";
634
- guidance += "\n \u2022 Extract shared dependencies into separate resources";
635
- if (hasMiddleware) {
636
- guidance += "\n \u2022 For middleware: you can filter out tasks/resources using everywhere(fn)";
637
- guidance += "\n \u2022 Consider using events for communication instead of direct dependencies";
638
- }
639
- super(`Circular dependencies detected:
640
- ${cycleDetails}${guidance}`);
641
- this.name = "CircularDependenciesError";
642
- }
643
- };
644
- var EventNotFoundError = class extends RuntimeError {
645
- static {
646
- __name(this, "EventNotFoundError");
647
- }
648
- constructor(id2) {
649
- super(`Event "${id2.toString()}" not found. Did you forget to register it?`);
650
- this.name = "EventNotFoundError";
651
- }
652
- };
653
- var ResourceNotFoundError = class extends RuntimeError {
654
- static {
655
- __name(this, "ResourceNotFoundError");
656
- }
657
- constructor(id2) {
658
- super(
659
- `Resource "${id2.toString()}" not found. Did you forget to register it or are you using the correct id?`
660
- );
661
- this.name = "ResourceNotFoundError";
662
- }
663
- };
664
- var MiddlewareNotRegisteredError = class extends RuntimeError {
665
- static {
666
- __name(this, "MiddlewareNotRegisteredError");
667
- }
668
- constructor(type, source, middlewareId) {
669
- super(
670
- `Middleware inside ${type} "${source}" depends on "${middlewareId}" but it's not registered. Did you forget to register it?`
671
- );
672
- this.name = `MiddlewareNotRegisteredError: ${type} ${source} ${middlewareId}`;
673
- }
674
- };
675
- var TagNotFoundError = class extends RuntimeError {
676
- static {
677
- __name(this, "TagNotFoundError");
678
- }
679
- constructor(id2) {
680
- super(
681
- `Tag "${id2}" not registered. Did you forget to register it inside a resource?`
682
- );
683
- this.name = "TagNotRegisteredError";
684
- }
685
- };
686
- var LockedError = class extends RuntimeError {
687
- static {
688
- __name(this, "LockedError");
689
- }
690
- constructor(what) {
691
- super(`Cannot modify the ${what.toString()} when it is locked.`);
692
- this.name = "LockedError";
693
- }
694
- };
695
- var StoreAlreadyInitializedError = class extends RuntimeError {
696
- static {
697
- __name(this, "StoreAlreadyInitializedError");
698
- }
699
- constructor() {
700
- super("Store already initialized. Cannot reinitialize.");
701
- this.name = "StoreAlreadyInitializedError";
702
- }
703
- };
704
- var ValidationError = class extends RuntimeError {
705
- static {
706
- __name(this, "ValidationError");
707
- }
708
- constructor(type, id2, originalError) {
709
- const errorMessage = originalError instanceof Error ? originalError.message : String(originalError);
710
- super(`${type} validation failed for ${id2.toString()}: ${errorMessage}`);
711
- this.name = "ValidationError";
712
- }
713
- };
714
- var EventCycleError = class extends RuntimeError {
715
- static {
716
- __name(this, "EventCycleError");
717
- }
718
- constructor(path) {
719
- const chain = path.map((p) => `${p.id}\u2190${p.source}`).join(" -> ");
720
- super(
721
- `Event emission cycle detected:
722
- ${chain}
723
-
724
- Break the cycle by changing hook logic (avoid mutual emits) or gate with conditions/tags.`
725
- );
726
- this.name = "EventCycleError";
727
- }
728
- };
729
- var EventEmissionCycleError = class extends RuntimeError {
730
- static {
731
- __name(this, "EventEmissionCycleError");
732
- }
733
- constructor(cycles) {
734
- const list = cycles.map((c) => ` \u2022 ${c}`).join("\n");
735
- super(
736
- `Event emission cycles detected between hooks and events:
737
- ${list}
738
-
739
- This was detected at compile time (dry-run). Break the cycle by avoiding mutual emits between hooks or scoping hooks using tags.`
740
- );
741
- this.name = "EventEmissionCycleError";
742
- }
743
- };
744
- var PlatformUnsupportedFunction = class extends RuntimeError {
745
- static {
746
- __name(this, "PlatformUnsupportedFunction");
747
- }
748
- constructor(functionName) {
749
- super(
750
- `Platform function not supported in this environment: ${functionName}. Detected platform: ${detectEnvironment()}.`
751
- );
752
- this.name = "PlatformUnsupportedFunction";
753
- }
754
- };
755
-
756
- // src/definers/defineResource.ts
757
- function defineResource(constConfig) {
758
- const filePath = constConfig[symbolFilePath] || getCallerFile();
759
- const id2 = constConfig.id;
760
- return {
761
- [symbolResource]: true,
762
- [symbolFilePath]: filePath,
763
- id: id2,
764
- dependencies: constConfig.dependencies,
765
- dispose: constConfig.dispose,
766
- register: constConfig.register || [],
767
- overrides: constConfig.overrides || [],
768
- init: constConfig.init,
769
- context: constConfig.context,
770
- configSchema: constConfig.configSchema,
771
- resultSchema: constConfig.resultSchema,
772
- tags: constConfig.tags || [],
773
- with: /* @__PURE__ */ __name(function(config) {
774
- if (constConfig.configSchema) {
775
- try {
776
- config = constConfig.configSchema.parse(config);
777
- } catch (error) {
778
- throw new ValidationError(
779
- "Resource config",
780
- id2,
781
- error instanceof Error ? error : new Error(String(error))
782
- );
783
- }
784
- }
785
- return {
786
- [symbolResourceWithConfig]: true,
787
- id: this.id,
788
- resource: this,
789
- config
790
- };
791
- }, "with"),
792
- meta: constConfig.meta || {},
793
- middleware: constConfig.middleware || [],
794
- optional() {
795
- return {
796
- inner: this,
797
- [symbolOptionalDependency]: true
798
- };
799
- }
800
- };
801
- }
802
- __name(defineResource, "defineResource");
803
-
804
- // src/definers/defineEvent.ts
805
- function defineEvent(config) {
806
- const callerFilePath = getCallerFile();
807
- const eventConfig = config;
808
- return {
809
- ...eventConfig,
810
- id: eventConfig.id,
811
- [symbolFilePath]: callerFilePath,
812
- [symbolEvent]: true,
813
- // This is a workaround
814
- tags: eventConfig.tags || [],
815
- optional() {
816
- return {
817
- inner: this,
818
- [symbolOptionalDependency]: true
819
- };
820
- }
821
- };
822
- }
823
- __name(defineEvent, "defineEvent");
824
-
825
- // src/definers/defineTaskMiddleware.ts
826
- function defineTaskMiddleware(middlewareDef) {
827
- const filePath = getCallerFile();
828
- const base = {
829
- [symbolFilePath]: filePath,
830
- [symbolTaskMiddleware]: true,
831
- config: {},
832
- configSchema: middlewareDef.configSchema,
833
- ...middlewareDef,
834
- dependencies: middlewareDef.dependencies || {}
835
- };
836
- const wrap = /* @__PURE__ */ __name((obj) => {
837
- return {
838
- ...obj,
839
- with: /* @__PURE__ */ __name((config) => {
840
- if (obj.configSchema) {
841
- try {
842
- config = obj.configSchema.parse(config);
843
- } catch (error) {
844
- throw new ValidationError(
845
- "Middleware config",
846
- obj.id,
847
- error instanceof Error ? error : new Error(String(error))
848
- );
849
- }
850
- }
851
- return wrap({
852
- ...obj,
853
- [symbolMiddlewareConfigured]: true,
854
- config: {
855
- ...obj.config,
856
- ...config
857
- }
858
- });
859
- }, "with")
860
- };
861
- }, "wrap");
862
- return wrap(base);
863
- }
864
- __name(defineTaskMiddleware, "defineTaskMiddleware");
865
-
866
- // src/definers/defineResourceMiddleware.ts
867
- function defineResourceMiddleware(middlewareDef) {
868
- const filePath = getCallerFile();
869
- const base = {
870
- [symbolFilePath]: filePath,
871
- [symbolResourceMiddleware]: true,
872
- config: {},
873
- configSchema: middlewareDef.configSchema,
874
- ...middlewareDef,
875
- dependencies: middlewareDef.dependencies || {}
876
- };
877
- const wrap = /* @__PURE__ */ __name((obj) => {
878
- return {
879
- ...obj,
880
- with: /* @__PURE__ */ __name((config) => {
881
- if (obj.configSchema) {
882
- try {
883
- config = obj.configSchema.parse(config);
884
- } catch (error) {
885
- throw new ValidationError(
886
- "Middleware config",
887
- obj.id,
888
- error
889
- );
890
- }
891
- }
892
- return wrap({
893
- ...obj,
894
- [symbolMiddlewareConfigured]: true,
895
- config: {
896
- ...obj.config,
897
- ...config
898
- }
899
- });
900
- }, "with")
901
- };
902
- }, "wrap");
903
- return wrap(base);
904
- }
905
- __name(defineResourceMiddleware, "defineResourceMiddleware");
906
-
907
- // src/definers/defineOverride.ts
908
- function defineOverride(base, patch) {
909
- const rest = patch;
910
- return {
911
- ...base,
912
- ...rest,
913
- id: base.id
914
- };
915
- }
916
- __name(defineOverride, "defineOverride");
917
-
918
- // src/definers/defineTag.ts
919
- function defineTag(definition) {
920
- const id2 = definition.id;
921
- const filePath = getCallerFile();
922
- const foundation = {
923
- id: id2,
924
- meta: definition.meta,
925
- config: definition.config,
926
- configSchema: definition.configSchema
927
- };
928
- return {
929
- ...foundation,
930
- [symbolTag]: true,
931
- [symbolFilePath]: filePath,
932
- /**
933
- * Specify custom config for this tag which extends the default one if exists
934
- * @param tagConfig
935
- * @returns
936
- */
937
- with(tagConfig) {
938
- if (definition.configSchema) {
939
- try {
940
- tagConfig = definition.configSchema.parse(tagConfig);
941
- } catch (error) {
942
- throw new ValidationError("Tag config", this.id, error);
943
- }
944
- }
945
- let config;
946
- if (typeof tagConfig === "object") {
947
- if (typeof foundation.config === "object") {
948
- config = {
949
- ...foundation.config,
950
- ...tagConfig
951
- };
952
- } else {
953
- config = tagConfig;
954
- }
955
- } else {
956
- config = tagConfig;
957
- }
958
- return {
959
- ...foundation,
960
- [symbolTagConfigured]: true,
961
- config
962
- };
963
- },
964
- /**
965
- * Checks if the tag exists in a taggable or a list of tags.
966
- * @param target
967
- * @returns
968
- */
969
- exists(target) {
970
- let currentTags = [];
971
- if (Array.isArray(target)) {
972
- currentTags = target;
973
- } else {
974
- currentTags = target.tags;
975
- }
976
- for (const candidate of currentTags) {
977
- if (candidate.id === id2) {
978
- return true;
979
- }
980
- }
981
- return false;
982
- },
983
- /**
984
- * Function which serves 2 purposes, verifying if the task exists, and retrieving its config
985
- * @param target
986
- * @returns
987
- */
988
- extract(target) {
989
- let currentTags = [];
990
- if (Array.isArray(target)) {
991
- currentTags = target;
992
- } else {
993
- currentTags = target.tags || [];
994
- }
995
- for (const candidate of currentTags) {
996
- if (candidate.id === id2) {
997
- return candidate.config;
998
- }
999
- }
1000
- return;
1001
- }
1002
- };
1003
- }
1004
- __name(defineTag, "defineTag");
1005
-
1006
- // src/definers/tools.ts
1007
- function isTask(definition) {
1008
- return definition && definition[symbolTask];
1009
- }
1010
- __name(isTask, "isTask");
1011
- function isResource(definition) {
1012
- return definition && definition[symbolResource];
1013
- }
1014
- __name(isResource, "isResource");
1015
- function isResourceWithConfig(definition) {
1016
- return definition && definition[symbolResourceWithConfig];
1017
- }
1018
- __name(isResourceWithConfig, "isResourceWithConfig");
1019
- function isEvent(definition) {
1020
- return definition && definition[symbolEvent];
1021
- }
1022
- __name(isEvent, "isEvent");
1023
- function isHook(definition) {
1024
- return definition && definition[symbolHook];
1025
- }
1026
- __name(isHook, "isHook");
1027
- function isTaskMiddleware(definition) {
1028
- return definition && definition[symbolTaskMiddleware];
1029
- }
1030
- __name(isTaskMiddleware, "isTaskMiddleware");
1031
- function isResourceMiddleware(definition) {
1032
- return definition && definition[symbolResourceMiddleware];
1033
- }
1034
- __name(isResourceMiddleware, "isResourceMiddleware");
1035
- function isTag(definition) {
1036
- return definition && definition[symbolTag];
1037
- }
1038
- __name(isTag, "isTag");
1039
- function isOptional(definition) {
1040
- return definition && definition[symbolOptionalDependency];
1041
- }
1042
- __name(isOptional, "isOptional");
1043
-
1044
- // src/globals/middleware/requireContext.middleware.ts
1045
- var requireContextTaskMiddleware = defineTaskMiddleware({
1046
- id: "globals.middleware.requireContext",
1047
- async run({ task, next }, deps, config) {
1048
- if (!config.context) {
1049
- throw new Error(
1050
- "Context not available. Did you forget to pass 'context' to the middleware?"
1051
- );
1052
- }
1053
- config.context.use();
1054
- return next(task?.input);
1055
- }
1056
- });
1057
-
1058
- // src/context.ts
1059
- var platform = getPlatform();
1060
- var storage = platform.createAsyncLocalStorage();
1061
- function getCurrentStore() {
1062
- return storage.getStore();
1063
- }
1064
- __name(getCurrentStore, "getCurrentStore");
1065
- function createContext(name = "runner.context") {
1066
- if (!platform.hasAsyncLocalStorage()) {
1067
- throw new PlatformUnsupportedFunction(
1068
- `createAsyncLocalStorage: Cannot create context ${name}: no async storage available in this environment`
1069
- );
1070
- }
1071
- const ctxId = Symbol(name);
1072
- const use = /* @__PURE__ */ __name(() => {
1073
- const store2 = getCurrentStore();
1074
- if (!store2 || !store2.has(ctxId)) {
1075
- throw new ContextError(
1076
- `Context not available for symbol ${ctxId.toString()}`
1077
- );
1078
- }
1079
- return store2.get(ctxId);
1080
- }, "use");
1081
- const provide = /* @__PURE__ */ __name((value, fn) => {
1082
- const currentStore = getCurrentStore();
1083
- const map = currentStore ? new Map(currentStore) : /* @__PURE__ */ new Map();
1084
- map.set(ctxId, value);
1085
- return storage.run(map, fn);
1086
- }, "provide");
1087
- const api = {
1088
- id: ctxId,
1089
- use,
1090
- provide,
1091
- require() {
1092
- return requireContextTaskMiddleware.with({ context: api });
1093
- }
1094
- };
1095
- return api;
1096
- }
1097
- __name(createContext, "createContext");
1098
-
1099
- // src/globals/resources/debug/debug.tag.ts
1100
- var debugTag = defineTag({
1101
- id: "globals.tags.debug",
1102
- meta: {
1103
- title: "Debug",
1104
- description: "Debug-specific tags. Used for filtering out noise when you're focusing on your application."
1105
- }
1106
- });
1107
-
1108
- // src/globals/globalTags.ts
1109
- var globalTags = {
1110
- system: defineTag({
1111
- id: "globals.tags.system",
1112
- meta: {
1113
- title: "System",
1114
- description: "System-wide tags. Used for filtering out noise when you're focusing on your application."
1115
- }
1116
- }),
1117
- excludeFromGlobalHooks: defineTag({
1118
- id: "globals.tags.excludeFromGlobalHooks",
1119
- meta: {
1120
- title: "Exclude Event From Global Hooks",
1121
- description: "Marks events that should not be dispatched to global hooks (on: '*')."
1122
- }
1123
- }),
1124
- debug: debugTag
1125
- };
1126
-
1127
- // src/globals/globalEvents.ts
1128
- globalTags.system;
1129
- var globalEvents = {
1130
- // Minimal core events retained if any (custom events can still be defined by users)
1131
- /**
1132
- * Emitted when the system is fully initialized and ready for work.
1133
- */
1134
- ready: defineEvent({
1135
- id: "globals.events.ready",
1136
- meta: {
1137
- title: "System Ready",
1138
- description: "Emitted when the system has completed boot and is ready for listeners to start work.This runs right before returning value for run()."
1139
- }
1140
- })
1141
- };
1142
- var globalEventsArray = [globalEvents.ready];
1143
-
1144
- // src/models/Queue.ts
1145
- var Queue = class {
1146
- constructor() {
1147
- this.tail = Promise.resolve();
1148
- this.disposed = false;
1149
- this.abortController = new AbortController();
1150
- // true while inside a queued task → helps detect "queue in queue"
1151
- this.executionContext = getPlatform().createAsyncLocalStorage();
1152
- this.hasAsyncLocalStorage = getPlatform().hasAsyncLocalStorage();
1153
- }
1154
- static {
1155
- __name(this, "Queue");
1156
- }
1157
- /**
1158
- * Schedule an asynchronous task.
1159
- * @param task – receives an AbortSignal so it can cancel early if desired.
1160
- */
1161
- run(task) {
1162
- if (this.disposed) {
1163
- return Promise.reject(new Error("Queue has been disposed"));
1164
- }
1165
- if (this.hasAsyncLocalStorage && this.executionContext.getStore()) {
1166
- return Promise.reject(
1167
- new Error(
1168
- "Dead\u2011lock detected: a queued task attempted to queue another task"
1169
- )
1170
- );
1171
- }
1172
- const { signal } = this.abortController;
1173
- const result = this.tail.then(
1174
- () => this.hasAsyncLocalStorage ? this.executionContext.run(true, () => task(signal)) : task(signal)
1175
- );
1176
- this.tail = result.catch(() => {
1177
- });
1178
- return result;
1179
- }
1180
- /**
1181
- * Disposes the queue.
1182
- * @param options.cancel – if true, broadcasts AbortSignal to running task.
1183
- * default: false (waits for tasks to finish).
1184
- */
1185
- async dispose(options = {}) {
1186
- if (this.disposed) return;
1187
- this.disposed = true;
1188
- if (options.cancel) {
1189
- this.abortController.abort();
1190
- }
1191
- await this.tail.catch(() => {
1192
- });
1193
- }
1194
- };
1195
-
1196
- // src/globals/resources/queue.resource.ts
1197
- var queueResource = defineResource({
1198
- id: "globals.resources.queue",
1199
- context: /* @__PURE__ */ __name(() => ({
1200
- map: /* @__PURE__ */ new Map()
1201
- }), "context"),
1202
- init: /* @__PURE__ */ __name(async (_, deps, context) => {
1203
- const map = context.map;
1204
- return {
1205
- map,
1206
- run: /* @__PURE__ */ __name((id2, task) => {
1207
- if (!map.has(id2)) {
1208
- map.set(id2, new Queue());
1209
- }
1210
- return map.get(id2).run(task);
1211
- }, "run")
1212
- };
1213
- }, "init"),
1214
- dispose: /* @__PURE__ */ __name(async (value, _, deps, context) => {
1215
- context.map.forEach((queue) => queue.dispose());
1216
- }, "dispose"),
1217
- meta: {
1218
- title: "Queue Map",
1219
- description: "A global map that can be used to store and retrieve queues. You can run exclusive tasks based on using an id. queue.run(id, task) will run the task in the queue with the given id. If the queue does not exist, it will be created."
1220
- }
1221
- });
1222
-
1223
- // src/globals/globalResources.ts
1224
- var systemTag2 = globalTags.system;
1225
- var store = defineResource({
1226
- id: "globals.resources.store",
1227
- meta: {
1228
- title: "Store",
1229
- description: "A global store that can be used to store and retrieve tasks, resources, events and middleware"
1230
- },
1231
- tags: [systemTag2]
1232
- });
1233
- var globalResources = {
1234
- store,
1235
- middlewareManager: defineResource({
1236
- id: "globals.resources.middlewareManager",
1237
- meta: {
1238
- title: "Middleware Manager",
1239
- description: "Manages all middleware and middleware interceptors."
1240
- },
1241
- tags: [systemTag2]
1242
- }),
1243
- eventManager: defineResource({
1244
- id: "globals.resources.eventManager",
1245
- meta: {
1246
- title: "Event Manager",
1247
- description: "Manages all events and event listeners. This is meant to be used internally for most use-cases."
1248
- },
1249
- tags: [systemTag2]
1250
- }),
1251
- taskRunner: defineResource({
1252
- id: "globals.resources.taskRunner",
1253
- meta: {
1254
- title: "Task Runner",
1255
- description: "Manages the execution of tasks and task dependencies. This is meant to be used internally for most use-cases."
1256
- },
1257
- tags: [systemTag2]
1258
- }),
1259
- logger: defineResource({
1260
- id: "globals.resources.logger",
1261
- meta: {
1262
- // We skip system tag for logger because it's part of the utility toolkit.
1263
- title: "Logger",
1264
- description: "Logs all events and errors. This is meant to be used internally for most use-cases. Emits a globals.log event for each log."
1265
- },
1266
- tags: [systemTag2]
1267
- }),
1268
- cache: cacheResource,
1269
- queue: queueResource
1270
- };
1271
-
1272
- // src/globals/middleware/retry.middleware.ts
1273
- var retryTaskMiddleware = defineTaskMiddleware({
1274
- id: "globals.middleware.retry.task",
1275
- async run({ task, next }, deps, config) {
1276
- const input = task?.input;
1277
- let attempts = 0;
1278
- const maxRetries = config.retries ?? 3;
1279
- const shouldStop = config.stopRetryIf ?? (() => false);
1280
- while (true) {
1281
- try {
1282
- return await next(input);
1283
- } catch (error) {
1284
- const err = error;
1285
- if (shouldStop(err) || attempts >= maxRetries) {
1286
- throw error;
1287
- }
1288
- const delay = config.delayStrategy ? config.delayStrategy(attempts, err) : 100 * Math.pow(2, attempts);
1289
- if (delay > 0) {
1290
- await new Promise((resolve) => setTimeout(resolve, delay));
1291
- }
1292
- attempts++;
1293
- }
1294
- }
1295
- }
1296
- });
1297
- var retryResourceMiddleware = defineResourceMiddleware({
1298
- id: "globals.middleware.retry.resource",
1299
- async run({ resource, next }, deps, config) {
1300
- const input = resource?.config;
1301
- let attempts = 0;
1302
- const maxRetries = config.retries ?? 3;
1303
- const shouldStop = config.stopRetryIf ?? (() => false);
1304
- while (true) {
1305
- try {
1306
- return await next(input);
1307
- } catch (error) {
1308
- const err = error;
1309
- if (shouldStop(err) || attempts >= maxRetries) {
1310
- throw error;
1311
- }
1312
- const delay = config.delayStrategy ? config.delayStrategy(attempts, err) : 100 * Math.pow(2, attempts);
1313
- if (delay > 0) {
1314
- await new Promise((resolve) => setTimeout(resolve, delay));
1315
- }
1316
- attempts++;
1317
- }
1318
- }
1319
- }
1320
- });
1321
-
1322
- // src/globals/middleware/timeout.middleware.ts
1323
- var timeoutTaskMiddleware = defineTaskMiddleware({
1324
- id: "globals.middleware.timeout.task",
1325
- async run({ task, next }, _deps, config) {
1326
- const input = task?.input;
1327
- const ttl = Math.max(0, config.ttl);
1328
- const message = `Operation timed out after ${ttl}ms`;
1329
- if (ttl === 0) {
1330
- const error = new Error(message);
1331
- error.name = "TimeoutError";
1332
- throw error;
1333
- }
1334
- const controller = new AbortController();
1335
- const timeoutPromise = new Promise((_, reject) => {
1336
- const timeoutId = setTimeout(() => {
1337
- controller.abort();
1338
- const error = new Error(message);
1339
- error.name = "TimeoutError";
1340
- reject(error);
1341
- }, ttl);
1342
- controller.signal.addEventListener("abort", () => {
1343
- clearTimeout(timeoutId);
1344
- });
1345
- });
1346
- return Promise.race([next(input), timeoutPromise]);
1347
- }
1348
- });
1349
- var timeoutResourceMiddleware = defineResourceMiddleware({
1350
- id: "globals.middleware.timeout.resource",
1351
- async run({ resource, next }, _deps, config) {
1352
- const input = resource?.config;
1353
- const ttl = Math.max(0, config.ttl);
1354
- const message = `Operation timed out after ${ttl}ms`;
1355
- if (ttl === 0) {
1356
- const error = new Error(message);
1357
- error.name = "TimeoutError";
1358
- throw error;
1359
- }
1360
- const controller = new AbortController();
1361
- const timeoutPromise = new Promise((_, reject) => {
1362
- const timeoutId = setTimeout(() => {
1363
- controller.abort();
1364
- const error = new Error(message);
1365
- error.name = "TimeoutError";
1366
- reject(error);
1367
- }, ttl);
1368
- controller.signal.addEventListener("abort", () => {
1369
- clearTimeout(timeoutId);
1370
- });
1371
- });
1372
- return Promise.race([next(input), timeoutPromise]);
1373
- }
1374
- });
1375
-
1376
- // src/globals/globalMiddleware.ts
1377
- var globalMiddlewares = {
1378
- requireContext: requireContextTaskMiddleware,
1379
- task: {
1380
- requireContext: requireContextTaskMiddleware,
1381
- cache: cacheMiddleware,
1382
- // common with resources
1383
- retry: retryTaskMiddleware,
1384
- timeout: timeoutTaskMiddleware
1385
- },
1386
- resource: {
1387
- retry: retryResourceMiddleware,
1388
- timeout: timeoutResourceMiddleware
1389
- }
1390
- };
1391
-
1392
- // src/models/TaskRunner.ts
1393
- var TaskRunner = class {
1394
- constructor(store2, eventManager, logger) {
1395
- this.store = store2;
1396
- this.eventManager = eventManager;
1397
- this.logger = logger;
1398
- this.runnerStore = /* @__PURE__ */ new Map();
1399
- this.middlewareManager = this.store.getMiddlewareManager();
1400
- }
1401
- static {
1402
- __name(this, "TaskRunner");
1403
- }
1404
- /**
1405
- * Begins the execution of an task. These are registered tasks and all sanity checks have been performed at this stage to ensure consistency of the object.
1406
- * This function can throw only if any of the event listeners or run function throws
1407
- * @param task the task to be run
1408
- * @param input the input to be passed to the task
1409
- */
1410
- async run(task, input) {
1411
- let runner = this.runnerStore.get(task.id);
1412
- if (!runner) {
1413
- runner = this.createRunnerWithMiddleware(task);
1414
- this.runnerStore.set(task.id, runner);
1415
- }
1416
- try {
1417
- return await runner(input);
1418
- } catch (error) {
1419
- try {
1420
- await this.store.onUnhandledError({
1421
- error,
1422
- kind: "task",
1423
- source: task.id
1424
- });
1425
- } catch (_) {
1426
- }
1427
- throw error;
1428
- }
1429
- }
1430
- /**
1431
- * Creates the function with the chain of middleware.
1432
- * @param task
1433
- * @param input
1434
- * @param taskDependencies
1435
- * @returns
1436
- */
1437
- createRunnerWithMiddleware(task) {
1438
- return this.middlewareManager.composeTaskRunner(task);
1439
- }
1440
- };
1441
-
1442
- // src/models/MiddlewareManager.ts
1443
- var MiddlewareManager = class {
1444
- constructor(store2, eventManager, logger) {
1445
- this.store = store2;
1446
- this.eventManager = eventManager;
1447
- this.logger = logger;
1448
- // Interceptor storage
1449
- this.taskMiddlewareInterceptors = [];
1450
- this.resourceMiddlewareInterceptors = [];
1451
- // Per-middleware interceptor storage
1452
- this.perMiddlewareInterceptors = /* @__PURE__ */ new Map();
1453
- this.perResourceMiddlewareInterceptors = /* @__PURE__ */ new Map();
1454
- // Locking mechanism to prevent modifications after initialization
1455
- this.#isLocked = false;
1456
- }
1457
- static {
1458
- __name(this, "MiddlewareManager");
1459
- }
1460
- #isLocked;
1461
- /**
1462
- * Gets the current lock status of the MiddlewareManager
1463
- */
1464
- get isLocked() {
1465
- return this.#isLocked;
1466
- }
1467
- /**
1468
- * Locks the MiddlewareManager, preventing any further modifications to interceptors
1469
- */
1470
- lock() {
1471
- this.#isLocked = true;
1472
- }
1473
- /**
1474
- * Throws an error if the MiddlewareManager is locked
1475
- */
1476
- checkLock() {
1477
- if (this.#isLocked) {
1478
- throw new LockedError("MiddlewareManager");
1479
- }
1480
- }
1481
- /**
1482
- * Adds an interceptor for task or resource middleware execution
1483
- * Interceptors are executed in the order they are added, with the ability to
1484
- * modify, log, or prevent middleware execution
1485
- *
1486
- * @param kind - The type of middleware to intercept ("task" or "resource")
1487
- * @param interceptor - The interceptor function to add
1488
- */
1489
- intercept(kind, interceptor) {
1490
- this.checkLock();
1491
- if (kind === "task") {
1492
- this.taskMiddlewareInterceptors.push(
1493
- interceptor
1494
- );
1495
- } else {
1496
- this.resourceMiddlewareInterceptors.push(
1497
- interceptor
1498
- );
1499
- }
1500
- }
1501
- /**
1502
- * Adds an interceptor for a specific middleware instance with better type safety
1503
- * This method automatically determines the type and provides type-safe access
1504
- *
1505
- * @param middleware - The middleware instance to intercept
1506
- * @param interceptor - The interceptor function with proper typing
1507
- */
1508
- interceptMiddleware(middleware, interceptor) {
1509
- this.checkLock();
1510
- if (isTaskMiddleware(middleware)) {
1511
- if (!this.perMiddlewareInterceptors.has(middleware.id)) {
1512
- this.perMiddlewareInterceptors.set(middleware.id, []);
1513
- }
1514
- this.perMiddlewareInterceptors.get(middleware.id).push(interceptor);
1515
- } else if (isResourceMiddleware(middleware)) {
1516
- if (!this.perResourceMiddlewareInterceptors.has(middleware.id)) {
1517
- this.perResourceMiddlewareInterceptors.set(middleware.id, []);
1518
- }
1519
- this.perResourceMiddlewareInterceptors.get(middleware.id).push(interceptor);
1520
- } else {
1521
- throw new Error("Unknown middleware type");
1522
- }
1523
- }
1524
- /**
1525
- * Wrap a middleware with its specific interceptors in onion style
1526
- */
1527
- wrapMiddlewareWithInterceptors(middleware, middlewareRunner, interceptors) {
1528
- if (!interceptors.length) {
1529
- return middlewareRunner;
1530
- }
1531
- const reversedInterceptors = [...interceptors].reverse();
1532
- let wrapped = middlewareRunner;
1533
- for (let i = reversedInterceptors.length - 1; i >= 0; i--) {
1534
- const interceptor = reversedInterceptors[i];
1535
- const nextFunction = wrapped;
1536
- wrapped = /* @__PURE__ */ __name(async (input) => {
1537
- const executionInput = {
1538
- task: {
1539
- definition: null,
1540
- // Will be filled by middleware.run
1541
- input
1542
- },
1543
- next: nextFunction
1544
- };
1545
- const wrappedNext = /* @__PURE__ */ __name((i2) => {
1546
- return nextFunction(i2.task.input);
1547
- }, "wrappedNext");
1548
- return interceptor(wrappedNext, executionInput);
1549
- }, "wrapped");
1550
- }
1551
- return wrapped;
1552
- }
1553
- /**
1554
- * Wrap a resource middleware with its specific interceptors in onion style
1555
- */
1556
- wrapResourceMiddlewareWithInterceptors(middleware, middlewareRunner, interceptors) {
1557
- if (!interceptors.length) {
1558
- return middlewareRunner;
1559
- }
1560
- const reversedInterceptors = [...interceptors].reverse();
1561
- let wrapped = middlewareRunner;
1562
- for (let i = reversedInterceptors.length - 1; i >= 0; i--) {
1563
- const interceptor = reversedInterceptors[i];
1564
- const nextFunction = wrapped;
1565
- wrapped = /* @__PURE__ */ __name(async (config) => {
1566
- const executionInput = {
1567
- resource: {
1568
- definition: null,
1569
- // Will be filled by middleware.run
1570
- config
1571
- },
1572
- next: nextFunction
1573
- };
1574
- const wrappedNext = /* @__PURE__ */ __name((input) => {
1575
- return nextFunction(input.resource.config);
1576
- }, "wrappedNext");
1577
- return interceptor(wrappedNext, executionInput);
1578
- }, "wrapped");
1579
- }
1580
- return wrapped;
1581
- }
1582
- /**
1583
- * Compose a runner for a task with its local interceptors and applicable middlewares.
1584
- * Returns a function that accepts the task input and resolves to the task output.
1585
- */
1586
- composeTaskRunner(task) {
1587
- const storeTask = this.store.tasks.get(task.id);
1588
- let next = /* @__PURE__ */ __name(async (input) => {
1589
- let rawInput = input;
1590
- if (task.inputSchema) {
1591
- try {
1592
- rawInput = task.inputSchema.parse(rawInput);
1593
- } catch (error) {
1594
- throw new ValidationError(
1595
- "Task input",
1596
- task.id,
1597
- error instanceof Error ? error : new Error(String(error))
1598
- );
1599
- }
1600
- }
1601
- const deps = storeTask.computedDependencies;
1602
- const rawResult = await task.run.call(null, rawInput, deps);
1603
- if (task.resultSchema) {
1604
- try {
1605
- return task.resultSchema.parse(rawResult);
1606
- } catch (error) {
1607
- throw new ValidationError("Task result", task.id, error);
1608
- }
1609
- }
1610
- return rawResult;
1611
- }, "next");
1612
- if (storeTask.interceptors && storeTask.interceptors.length > 0) {
1613
- for (let i = storeTask.interceptors.length - 1; i >= 0; i--) {
1614
- const interceptor = storeTask.interceptors[i];
1615
- const nextFunction = next;
1616
- next = /* @__PURE__ */ __name(async (input) => interceptor(nextFunction, input), "next");
1617
- }
1618
- }
1619
- if (this.taskMiddlewareInterceptors.length > 0) {
1620
- const reversedInterceptors = [
1621
- ...this.taskMiddlewareInterceptors
1622
- ].reverse();
1623
- const createExecutionInput = /* @__PURE__ */ __name((input, nextFunc) => ({
1624
- task: {
1625
- definition: task,
1626
- input
1627
- },
1628
- next: nextFunc
1629
- }), "createExecutionInput");
1630
- let currentNext = next;
1631
- for (let i = reversedInterceptors.length - 1; i >= 0; i--) {
1632
- const interceptor = reversedInterceptors[i];
1633
- const nextFunction = currentNext;
1634
- currentNext = /* @__PURE__ */ __name(async (input) => {
1635
- const executionInput = createExecutionInput(input, nextFunction);
1636
- const wrappedNext = /* @__PURE__ */ __name((i2) => {
1637
- return nextFunction(i2.task.input);
1638
- }, "wrappedNext");
1639
- return interceptor(wrappedNext, executionInput);
1640
- }, "currentNext");
1641
- }
1642
- next = currentNext;
1643
- }
1644
- const createdMiddlewares = this.getApplicableTaskMiddlewares(task);
1645
- if (createdMiddlewares.length === 0) {
1646
- return next;
1647
- }
1648
- for (let i = createdMiddlewares.length - 1; i >= 0; i--) {
1649
- const middleware = createdMiddlewares[i];
1650
- const storeMiddleware = this.store.taskMiddlewares.get(middleware.id);
1651
- const nextFunction = next;
1652
- const baseMiddlewareRunner = /* @__PURE__ */ __name(async (input) => {
1653
- return storeMiddleware.middleware.run(
1654
- {
1655
- task: {
1656
- definition: task,
1657
- input
1658
- },
1659
- next: nextFunction
1660
- },
1661
- storeMiddleware.computedDependencies,
1662
- middleware.config
1663
- );
1664
- }, "baseMiddlewareRunner");
1665
- const middlewareInterceptors = this.perMiddlewareInterceptors.get(middleware.id) || [];
1666
- const wrappedMiddleware = this.wrapMiddlewareWithInterceptors(
1667
- middleware,
1668
- baseMiddlewareRunner,
1669
- middlewareInterceptors
1670
- );
1671
- next = wrappedMiddleware;
1672
- }
1673
- return next;
1674
- }
1675
- /**
1676
- * Run a resource init wrapped with its applicable middlewares.
1677
- */
1678
- async runResourceInit(resource, config, dependencies, context) {
1679
- let next = /* @__PURE__ */ __name(async (cfg) => {
1680
- if (!resource.init) return void 0;
1681
- const rawValue = await resource.init.call(
1682
- null,
1683
- cfg,
1684
- dependencies,
1685
- context
1686
- );
1687
- if (resource.resultSchema) {
1688
- try {
1689
- return resource.resultSchema.parse(rawValue);
1690
- } catch (error) {
1691
- throw new ValidationError(
1692
- "Resource result",
1693
- resource.id,
1694
- error
1695
- );
1696
- }
1697
- }
1698
- return rawValue;
1699
- }, "next");
1700
- const createdMiddlewares = this.getApplicableResourceMiddlewares(resource);
1701
- for (let i = createdMiddlewares.length - 1; i >= 0; i--) {
1702
- const middleware = createdMiddlewares[i];
1703
- const storeMiddleware = this.store.resourceMiddlewares.get(
1704
- middleware.id
1705
- );
1706
- const nextFunction = next;
1707
- const baseMiddlewareRunner = /* @__PURE__ */ __name(async (cfg) => {
1708
- try {
1709
- const result = await storeMiddleware.middleware.run(
1710
- {
1711
- resource: {
1712
- definition: resource,
1713
- config: cfg
1714
- },
1715
- next: nextFunction
1716
- },
1717
- storeMiddleware.computedDependencies,
1718
- middleware.config
1719
- );
1720
- return result;
1721
- } catch (error) {
1722
- try {
1723
- await this.store.onUnhandledError({
1724
- error,
1725
- kind: "resourceInit",
1726
- source: resource.id
1727
- });
1728
- } catch (_) {
1729
- }
1730
- throw error;
1731
- }
1732
- }, "baseMiddlewareRunner");
1733
- const middlewareInterceptors = this.perResourceMiddlewareInterceptors.get(middleware.id) || [];
1734
- const wrappedMiddleware = this.wrapResourceMiddlewareWithInterceptors(
1735
- middleware,
1736
- baseMiddlewareRunner,
1737
- middlewareInterceptors
1738
- );
1739
- next = wrappedMiddleware;
1740
- }
1741
- if (this.resourceMiddlewareInterceptors.length > 0) {
1742
- const reversedInterceptors = [
1743
- ...this.resourceMiddlewareInterceptors
1744
- ].reverse();
1745
- const createExecutionInput = /* @__PURE__ */ __name((config2, nextFunc) => ({
1746
- resource: {
1747
- definition: resource,
1748
- config: config2
1749
- },
1750
- next: nextFunc
1751
- }), "createExecutionInput");
1752
- let currentNext = next;
1753
- for (let i = reversedInterceptors.length - 1; i >= 0; i--) {
1754
- const interceptor = reversedInterceptors[i];
1755
- const nextFunction = currentNext;
1756
- currentNext = /* @__PURE__ */ __name(async (cfg) => {
1757
- const executionInput = createExecutionInput(cfg, nextFunction);
1758
- const wrappedNext = /* @__PURE__ */ __name((input) => {
1759
- return nextFunction(input.resource.config);
1760
- }, "wrappedNext");
1761
- return interceptor(wrappedNext, executionInput);
1762
- }, "currentNext");
1763
- }
1764
- next = currentNext;
1765
- }
1766
- return next(config);
1767
- }
1768
- getApplicableTaskMiddlewares(task) {
1769
- const existingMiddlewares = task.middleware;
1770
- const existingMiddlewareIds = existingMiddlewares.map((x) => x.id);
1771
- const globalMiddlewares2 = this.getEverywhereMiddlewareForTasks(task).filter(
1772
- (x) => !existingMiddlewareIds.includes(x.id)
1773
- );
1774
- return [...globalMiddlewares2, ...existingMiddlewares];
1775
- }
1776
- getApplicableResourceMiddlewares(resource) {
1777
- const existingMiddlewares = resource.middleware;
1778
- const existingMiddlewareIds = existingMiddlewares.map((x) => x.id);
1779
- const globalMiddlewares2 = this.getEverywhereMiddlewareForResources(
1780
- resource
1781
- ).filter((x) => !existingMiddlewareIds.includes(x.id));
1782
- return [...globalMiddlewares2, ...existingMiddlewares];
1783
- }
1784
- /**
1785
- * @param task
1786
- * @returns
1787
- */
1788
- getEverywhereMiddlewareForTasks(task) {
1789
- return Array.from(this.store.taskMiddlewares.values()).filter((x) => Boolean(x.middleware.everywhere)).filter((x) => {
1790
- if (typeof x.middleware.everywhere === "function") {
1791
- return x.middleware.everywhere(task);
1792
- }
1793
- return true;
1794
- }).map((x) => x.middleware);
1795
- }
1796
- /**
1797
- * Returns all global middleware for resource, which do not depend on the target resource.
1798
- */
1799
- getEverywhereMiddlewareForResources(target) {
1800
- return Array.from(this.store.resourceMiddlewares.values()).filter((x) => Boolean(x.middleware.everywhere)).filter((x) => {
1801
- if (typeof x.middleware.everywhere === "function") {
1802
- return x.middleware.everywhere(target);
1803
- }
1804
- return true;
1805
- }).map((x) => x.middleware);
1806
- }
1807
- };
1808
-
1809
- // src/models/ResourceInitializer.ts
1810
- var ResourceInitializer = class {
1811
- constructor(store2, eventManager, logger) {
1812
- this.store = store2;
1813
- this.eventManager = eventManager;
1814
- this.logger = logger;
1815
- this.middlewareManager = new MiddlewareManager(
1816
- this.store,
1817
- this.eventManager,
1818
- this.logger
1819
- );
1820
- }
1821
- static {
1822
- __name(this, "ResourceInitializer");
1823
- }
1824
- /**
1825
- * Begins the execution of an task. These are registered tasks and all sanity checks have been performed at this stage to ensure consistency of the object.
1826
- * This function can throw only if any of the event listeners or run function throws
1827
- */
1828
- async initializeResource(resource, config, dependencies) {
1829
- const context = resource.context?.();
1830
- let value;
1831
- if (!resource.init) {
1832
- resource.init = (async () => void 0);
1833
- }
1834
- if (resource.init) {
1835
- value = await this.initWithMiddleware(
1836
- resource,
1837
- config,
1838
- dependencies,
1839
- context
1840
- );
1841
- }
1842
- return { value, context };
1843
- }
1844
- // Lifecycle emissions removed
1845
- async initWithMiddleware(resource, config, dependencies, context) {
1846
- return this.middlewareManager.runResourceInit(
1847
- resource,
1848
- config,
1849
- dependencies,
1850
- context
1851
- );
1852
- }
1853
- };
1854
-
1855
- // src/models/utils/safeStringify.ts
1856
- function safeStringify(value, space, options) {
1857
- const seen = /* @__PURE__ */ new WeakSet();
1858
- const holderDepth = /* @__PURE__ */ new WeakMap();
1859
- const maxDepth = typeof options?.maxDepth === "number" ? options.maxDepth : Infinity;
1860
- const replacer = /* @__PURE__ */ __name(function(_key, val) {
1861
- if (typeof val === "function") {
1862
- return "function()";
1863
- }
1864
- if (typeof val === "bigint") {
1865
- return val.toString();
1866
- }
1867
- const holderObject = Object(this);
1868
- const parentDepth = holderDepth.get(holderObject) || 0;
1869
- const currentDepth = parentDepth + 1;
1870
- if (typeof val === "object" && val !== null) {
1871
- if (seen.has(val)) return "[Circular]";
1872
- if (currentDepth > maxDepth) {
1873
- return Array.isArray(val) ? "[Array]" : "[Object]";
1874
- }
1875
- seen.add(val);
1876
- holderDepth.set(val, currentDepth);
1877
- }
1878
- return val;
1879
- }, "replacer");
1880
- try {
1881
- return JSON.stringify(value, replacer, space);
1882
- } catch {
1883
- try {
1884
- return String(value);
1885
- } catch {
1886
- return "[Unserializable]";
1887
- }
1888
- }
1889
- }
1890
- __name(safeStringify, "safeStringify");
1891
-
1892
- // src/models/LogPrinter.ts
1893
- var ansiRegex = /[›][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]/g;
1894
- function stripAnsi(str) {
1895
- return str.replace(ansiRegex, "");
1896
- }
1897
- __name(stripAnsi, "stripAnsi");
1898
- var COLORS = {
1899
- trace: "\x1B[90m",
1900
- debug: "\x1B[36m",
1901
- info: "\x1B[32m",
1902
- warn: "\x1B[33m",
1903
- error: "\x1B[31m",
1904
- critical: "\x1B[35m",
1905
- reset: "\x1B[0m",
1906
- bold: "\x1B[1m",
1907
- dim: "\x1B[2m",
1908
- blue: "\x1B[34m",
1909
- cyan: "\x1B[36m",
1910
- gray: "\x1B[90m"
1911
- };
1912
- var ICONS = {
1913
- trace: "\u25CB",
1914
- debug: "\u25C6",
1915
- info: "\u25CF",
1916
- warn: "\u25B2",
1917
- error: "\u2715",
1918
- critical: "\u2588"
1919
- };
1920
- var LogPrinter = class _LogPrinter {
1921
- static {
1922
- __name(this, "LogPrinter");
1923
- }
1924
- constructor(options) {
1925
- this.strategy = options.strategy;
1926
- if (options.strategy === "plain") {
1927
- this.colors = _LogPrinter.NO_COLORS;
1928
- } else {
1929
- const base = options.useColors || options.colorTheme ? COLORS : _LogPrinter.NO_COLORS;
1930
- this.colors = { ...base, ...options.colorTheme || {} };
1931
- }
1932
- }
1933
- print(log) {
1934
- if (this.strategy === "json") {
1935
- _LogPrinter.writers.log(safeStringify(this.normalizeForJson(log)));
1936
- return;
1937
- }
1938
- if (this.strategy === "json_pretty") {
1939
- _LogPrinter.writers.log(safeStringify(this.normalizeForJson(log), 2));
1940
- return;
1941
- }
1942
- const { level, source, message, timestamp, error, data, context } = log;
1943
- const timePart = this.formatTime(timestamp);
1944
- const levelPart = this.formatLevel(level);
1945
- const sourcePart = this.formatSource(source);
1946
- const headerLine = [timePart, levelPart, sourcePart].filter(Boolean).join(" ");
1947
- const messageString = this.formatMessage(message);
1948
- const messageLines = messageString.split("\n");
1949
- const output = [headerLine];
1950
- const timePartLength = stripAnsi(timePart).length;
1951
- const levelPartLength = stripAnsi(levelPart).length;
1952
- const indentation = " ".repeat(timePartLength + 1 + levelPartLength + 1);
1953
- if (message) {
1954
- output.push(...messageLines.map((line) => `${indentation}${line}`));
1955
- }
1956
- const errorLines = this.formatError(error);
1957
- const dataLines = this.formatData(data);
1958
- const contextLines = this.formatContext(context);
1959
- const detailsExist = errorLines.length > 0 || dataLines.length > 0 || contextLines.length > 0;
1960
- if (detailsExist) {
1961
- output.push("");
1962
- }
1963
- output.push(...errorLines, ...dataLines, ...contextLines);
1964
- if (detailsExist) {
1965
- output.push("");
1966
- }
1967
- const writer = this.pickWriter(level);
1968
- output.forEach((line) => writer(line));
1969
- writer("");
1970
- }
1971
- pickWriter(level) {
1972
- const toError = level === "warn" || level === "error" || level === "critical";
1973
- if (toError && typeof _LogPrinter.writers.error === "function") {
1974
- return (msg) => _LogPrinter.writers.error(msg);
1975
- }
1976
- return (msg) => _LogPrinter.writers.log(msg);
1977
- }
1978
- formatTime(timestamp) {
1979
- const time = timestamp.toISOString().slice(11, 19);
1980
- const ms = timestamp.getMilliseconds().toString().padStart(3, "0");
1981
- return `${this.colors.gray}${time}.${ms}${this.colors.reset}`;
1982
- }
1983
- formatLevel(level) {
1984
- const color = this.colors[level] || this.colors.info;
1985
- const icon = ICONS[level] || "\u25CF";
1986
- const label = level.toUpperCase().padEnd(7);
1987
- return `${color}${icon} ${this.colors.bold}${label}${this.colors.reset}`;
1988
- }
1989
- formatSource(source) {
1990
- if (!source) return "";
1991
- return `${this.colors.cyan}${source}${this.colors.reset}`;
1992
- }
1993
- formatMessage(message) {
1994
- if (typeof message === "object" && message !== null) {
1995
- return safeStringify(message, 2);
1996
- }
1997
- return String(message);
1998
- }
1999
- formatError(error, indentation = " ") {
2000
- if (!error) return [];
2001
- const lines = [];
2002
- lines.push(
2003
- `${indentation}${this.colors.gray}\u2570\u2500${this.colors.reset} ${this.colors.error}Error: ${error.name}: ${error.message}${this.colors.reset}`
2004
- );
2005
- if (error.stack) {
2006
- const frames = error.stack.split("\n").slice(1);
2007
- frames.forEach((frame) => {
2008
- const cleaned = frame.trim().replace(/^at /, "");
2009
- lines.push(
2010
- `${indentation} ${this.colors.gray}\u21B3${this.colors.reset} ${this.colors.dim}${cleaned}${this.colors.reset}`
2011
- );
2012
- });
2013
- }
2014
- return lines;
2015
- }
2016
- formatData(data, indentation = " ") {
2017
- if (!data || Object.keys(data).length === 0) return [];
2018
- const lines = [];
2019
- const formatted = safeStringify(data, 2, { maxDepth: 3 }).split("\n");
2020
- lines.push(
2021
- `${indentation}${this.colors.gray}\u2570\u2500${this.colors.reset} ${this.colors.cyan}Data:${this.colors.reset}`
2022
- );
2023
- formatted.forEach((line) => {
2024
- lines.push(`${indentation}${this.colors.dim}${line}${this.colors.reset}`);
2025
- });
2026
- return lines;
2027
- }
2028
- formatContext(context, indentation = " ") {
2029
- if (!context) return [];
2030
- const filtered = { ...context };
2031
- delete filtered.source;
2032
- if (Object.keys(filtered).length === 0) return [];
2033
- const lines = [];
2034
- const formatted = safeStringify(filtered, 2, { maxDepth: 3 }).split("\n");
2035
- lines.push(
2036
- `${indentation}${this.colors.gray}\u2570\u2500${this.colors.reset} ${this.colors.blue}Context:${this.colors.reset}`
2037
- );
2038
- formatted.forEach((line) => {
2039
- lines.push(`${indentation}${this.colors.dim}${line}${this.colors.reset}`);
2040
- });
2041
- return lines;
2042
- }
2043
- normalizeForJson(log) {
2044
- const normalized = { ...log };
2045
- if (typeof log.message === "object") {
2046
- const text = safeStringify(log.message);
2047
- try {
2048
- normalized.message = JSON.parse(text);
2049
- } catch {
2050
- normalized.message = text;
2051
- }
2052
- }
2053
- return normalized;
2054
- }
2055
- static {
2056
- this.NO_COLORS = {
2057
- trace: "",
2058
- debug: "",
2059
- info: "",
2060
- warn: "",
2061
- error: "",
2062
- critical: "",
2063
- reset: "",
2064
- bold: "",
2065
- dim: "",
2066
- blue: "",
2067
- cyan: "",
2068
- gray: ""
2069
- };
2070
- }
2071
- static {
2072
- this.writers = {
2073
- // eslint-disable-next-line no-console
2074
- log: /* @__PURE__ */ __name((msg) => console.log(msg), "log"),
2075
- // eslint-disable-next-line no-console
2076
- error: /* @__PURE__ */ __name((msg) => console.error?.(msg), "error")
2077
- };
2078
- }
2079
- static setWriters(writers) {
2080
- _LogPrinter.writers = { ..._LogPrinter.writers, ...writers };
2081
- }
2082
- static resetWriters() {
2083
- _LogPrinter.writers = {
2084
- log: /* @__PURE__ */ __name((msg) => console.log(msg), "log"),
2085
- error: /* @__PURE__ */ __name((msg) => console.error?.(msg), "error")
2086
- };
2087
- }
2088
- };
2089
-
2090
- // src/models/Logger.ts
2091
- var Logger = class _Logger {
2092
- constructor(options, boundContext = {}, source, printer) {
2093
- this.printThreshold = "info";
2094
- this.printStrategy = "pretty";
2095
- this.bufferLogs = false;
2096
- this.buffer = [];
2097
- this.boundContext = {};
2098
- this.isLocked = false;
2099
- this.useColors = true;
2100
- // Observable why not?
2101
- this.localListeners = [];
2102
- this.boundContext = { ...boundContext };
2103
- this.printThreshold = options.printThreshold;
2104
- this.printStrategy = options.printStrategy;
2105
- this.bufferLogs = options.bufferLogs;
2106
- this.useColors = typeof options.useColors === "boolean" ? options.useColors : this.detectColorSupport();
2107
- this.source = source;
2108
- this.printer = printer ? printer : new LogPrinter({
2109
- strategy: this.printStrategy,
2110
- useColors: this.useColors
2111
- });
2112
- }
2113
- static {
2114
- __name(this, "Logger");
2115
- }
2116
- static {
2117
- this.Severity = {
2118
- trace: 0,
2119
- debug: 1,
2120
- info: 2,
2121
- warn: 3,
2122
- error: 4,
2123
- critical: 5
2124
- };
2125
- }
2126
- detectColorSupport() {
2127
- const noColor = typeof process !== "undefined" && !!process.env.NO_COLOR;
2128
- if (noColor) return false;
2129
- const isTty = typeof process !== "undefined" && !!process.stdout && !!process.stdout.isTTY;
2130
- return isTty;
2131
- }
2132
- /**
2133
- * Creates a new logger instance with additional bound context
2134
- */
2135
- with({
2136
- source,
2137
- additionalContext: context
2138
- }) {
2139
- const child = new _Logger(
2140
- {
2141
- printThreshold: this.printThreshold,
2142
- printStrategy: this.printStrategy,
2143
- bufferLogs: this.bufferLogs,
2144
- useColors: this.useColors
2145
- },
2146
- { ...this.boundContext, ...context },
2147
- source,
2148
- this.printer
2149
- );
2150
- child.rootLogger = this.rootLogger ?? this;
2151
- return child;
2152
- }
2153
- /**
2154
- * Core logging method with structured LogInfo
2155
- */
2156
- async log(level, message, logInfo = {}) {
2157
- const { source, error, data, ...context } = logInfo;
2158
- const log = {
2159
- level,
2160
- message,
2161
- source: source || this.source,
2162
- timestamp: /* @__PURE__ */ new Date(),
2163
- error: error ? this.extractErrorInfo(error) : void 0,
2164
- data: data || void 0,
2165
- context: { ...this.boundContext, ...context }
2166
- };
2167
- const root = this.rootLogger ?? this;
2168
- if (root.bufferLogs) {
2169
- root.buffer.push(log);
2170
- return;
2171
- }
2172
- await root.triggerLogListeners(log);
2173
- if (root.canPrint(level)) {
2174
- root.printer.print(log);
2175
- }
2176
- }
2177
- extractErrorInfo(error) {
2178
- if (error instanceof Error) {
2179
- return {
2180
- name: error.name,
2181
- message: error.message,
2182
- stack: error.stack
2183
- };
2184
- }
2185
- return {
2186
- name: "UnknownError",
2187
- message: String(error)
2188
- };
2189
- }
2190
- async info(message, logInfo) {
2191
- await this.log("info", message, logInfo);
2192
- }
2193
- async error(message, logInfo) {
2194
- await this.log("error", message, logInfo);
2195
- }
2196
- async warn(message, logInfo) {
2197
- await this.log("warn", message, logInfo);
2198
- }
2199
- async debug(message, logInfo) {
2200
- await this.log("debug", message, logInfo);
2201
- }
2202
- async trace(message, logInfo) {
2203
- await this.log("trace", message, logInfo);
2204
- }
2205
- async critical(message, logInfo) {
2206
- await this.log("critical", message, logInfo);
2207
- }
2208
- /**
2209
- * Direct print for tests and advanced scenarios. Delegates to LogPrinter.
2210
- */
2211
- print(log) {
2212
- this.printer.print(log);
2213
- }
2214
- /**
2215
- * @param listener - A listener that will be triggered for every log.
2216
- */
2217
- onLog(listener) {
2218
- if (this.rootLogger && this.rootLogger !== this) {
2219
- this.rootLogger.onLog(listener);
2220
- } else {
2221
- this.localListeners.push(listener);
2222
- }
2223
- }
2224
- /**
2225
- * Marks the logger as ready.
2226
- * This is used to trigger the local listeners and print the buffered logs (if they exists)
2227
- * @returns A promise that resolves when the logger is ready.
2228
- */
2229
- async lock() {
2230
- const root = this.rootLogger ?? this;
2231
- if (root.isLocked) {
2232
- return;
2233
- }
2234
- if (root.bufferLogs) {
2235
- for (const log of root.buffer) {
2236
- await root.triggerLogListeners(log);
2237
- }
2238
- for (const log of root.buffer) {
2239
- if (root.canPrint(log.level)) {
2240
- root.printer.print(log);
2241
- }
2242
- }
2243
- }
2244
- root.bufferLogs = false;
2245
- root.buffer = [];
2246
- root.isLocked = true;
2247
- }
2248
- canPrint(level) {
2249
- if (this.printThreshold === null) {
2250
- return false;
2251
- }
2252
- return this.printThreshold && _Logger.Severity[level] >= _Logger.Severity[this.printThreshold];
2253
- }
2254
- async triggerLogListeners(log) {
2255
- if (this.rootLogger && this.rootLogger !== this) {
2256
- await this.rootLogger.triggerLogListeners(log);
2257
- }
2258
- for (const listener of this.localListeners) {
2259
- try {
2260
- await listener(log);
2261
- } catch (error) {
2262
- this.print({
2263
- level: "error",
2264
- message: "Error in log listener",
2265
- timestamp: /* @__PURE__ */ new Date(),
2266
- error: {
2267
- name: "ListenerError",
2268
- message: error instanceof Error ? error.message : String(error)
2269
- }
2270
- });
2271
- continue;
2272
- }
2273
- }
2274
- }
2275
- };
2276
-
2277
- // src/models/DependencyProcessor.ts
2278
- var DependencyProcessor = class {
2279
- constructor(store2, eventManager, taskRunner, logger) {
2280
- this.store = store2;
2281
- this.eventManager = eventManager;
2282
- this.taskRunner = taskRunner;
2283
- this.logger = logger.with({ source: "dependencyProcessor" });
2284
- this.resourceInitializer = new ResourceInitializer(
2285
- store2,
2286
- eventManager,
2287
- logger
2288
- );
2289
- }
2290
- static {
2291
- __name(this, "DependencyProcessor");
2292
- }
2293
- /**
2294
- * This function is going to go through all the resources, tasks and middleware to compute their required dependencies.
2295
- */
2296
- async computeAllDependencies() {
2297
- for (const middleware of this.store.resourceMiddlewares.values()) {
2298
- const computedDependencies = await this.extractDependencies(
2299
- middleware.middleware.dependencies,
2300
- middleware.middleware.id
2301
- );
2302
- middleware.computedDependencies = computedDependencies;
2303
- middleware.isInitialized = true;
2304
- }
2305
- for (const middleware of this.store.taskMiddlewares.values()) {
2306
- const computedDependencies = await this.extractDependencies(
2307
- middleware.middleware.dependencies,
2308
- middleware.middleware.id
2309
- );
2310
- middleware.computedDependencies = computedDependencies;
2311
- middleware.isInitialized = true;
2312
- }
2313
- for (const resource of this.store.resources.values()) {
2314
- await this.processResourceDependencies(resource);
2315
- }
2316
- for (const task of this.store.tasks.values()) {
2317
- await this.computeTaskDependencies(task);
2318
- }
2319
- for (const hookStoreElement of this.store.hooks.values()) {
2320
- const hook = hookStoreElement.hook;
2321
- const deps = hook.dependencies;
2322
- hookStoreElement.computedDependencies = await this.extractDependencies(
2323
- deps,
2324
- hook.id
2325
- );
2326
- }
2327
- await this.initializeUninitializedResources();
2328
- }
2329
- async computeTaskDependencies(task) {
2330
- const deps = task.task.dependencies;
2331
- task.computedDependencies = await this.extractDependencies(
2332
- deps,
2333
- task.task.id
2334
- );
2335
- task.isInitialized = true;
2336
- }
2337
- // Most likely these are resources that no-one has dependencies towards
2338
- // We need to ensure they work too!
2339
- async initializeUninitializedResources() {
2340
- for (const resource of this.store.resources.values()) {
2341
- if (resource.isInitialized === false && // The root is the last one to be initialized and is done in a separate process.
2342
- resource.resource.id !== this.store.root.resource.id) {
2343
- await this.processResourceDependencies(resource);
2344
- const { value, context } = await this.resourceInitializer.initializeResource(
2345
- resource.resource,
2346
- resource.config,
2347
- resource.computedDependencies
2348
- );
2349
- resource.context = context;
2350
- resource.value = value;
2351
- resource.isInitialized = true;
2352
- }
2353
- }
2354
- }
2355
- /**
2356
- * Processes dependencies and hooks
2357
- * @param resource
2358
- */
2359
- async processResourceDependencies(resource) {
2360
- const deps = resource.resource.dependencies || {};
2361
- const extracted = await this.extractDependencies(
2362
- deps,
2363
- resource.resource.id
2364
- );
2365
- resource.computedDependencies = this.wrapResourceDependencies(
2366
- deps,
2367
- extracted
2368
- );
2369
- }
2370
- wrapResourceDependencies(deps, extracted) {
2371
- const wrapped = {};
2372
- for (const key of Object.keys(deps)) {
2373
- const original = deps[key];
2374
- const value = extracted[key];
2375
- if (isOptional(original)) {
2376
- const inner = original.inner;
2377
- if (isTask(inner)) {
2378
- wrapped[key] = value ? this.makeTaskWithIntercept(inner) : void 0;
2379
- } else {
2380
- wrapped[key] = value;
2381
- }
2382
- continue;
2383
- }
2384
- if (isTask(original)) {
2385
- wrapped[key] = this.makeTaskWithIntercept(original);
2386
- } else {
2387
- wrapped[key] = value;
2388
- }
2389
- }
2390
- return wrapped;
2391
- }
2392
- makeTaskWithIntercept(original) {
2393
- const taskId = original.id;
2394
- const fn = /* @__PURE__ */ __name((input) => {
2395
- const storeTask = this.store.tasks.get(taskId);
2396
- const effective = storeTask.task;
2397
- return this.taskRunner.run(effective, input);
2398
- }, "fn");
2399
- return Object.assign(fn, {
2400
- intercept: /* @__PURE__ */ __name((middleware) => {
2401
- this.store.checkLock();
2402
- const storeTask = this.store.tasks.get(taskId);
2403
- if (!storeTask.interceptors) storeTask.interceptors = [];
2404
- storeTask.interceptors.push(middleware);
2405
- }, "intercept")
2406
- });
2407
- }
2408
- async initializeRoot() {
2409
- const rootResource = this.store.root;
2410
- const { value, context } = await this.resourceInitializer.initializeResource(
2411
- rootResource.resource,
2412
- rootResource.config,
2413
- // They are already computed
2414
- rootResource.computedDependencies
2415
- );
2416
- rootResource.context = context;
2417
- rootResource.value = value;
2418
- rootResource.isInitialized = true;
2419
- }
2420
- /**
2421
- * Processes all hooks, should run before emission of any event.
2422
- */
2423
- attachListeners() {
2424
- for (const hookStoreElement of this.store.hooks.values()) {
2425
- const hook = hookStoreElement.hook;
2426
- if (hook.on) {
2427
- const eventDefinition = hook.on;
2428
- const handler = /* @__PURE__ */ __name(async (receivedEvent) => {
2429
- if (receivedEvent.source === hook.id) {
2430
- return;
2431
- }
2432
- return this.eventManager.executeHookWithInterceptors(
2433
- hook,
2434
- receivedEvent,
2435
- hookStoreElement.computedDependencies
2436
- );
2437
- }, "handler");
2438
- const order = hook.order ?? 0;
2439
- if (eventDefinition === "*") {
2440
- this.eventManager.addGlobalListener(handler, { order });
2441
- } else if (Array.isArray(eventDefinition)) {
2442
- for (const ed of eventDefinition) {
2443
- if (this.store.events.get(ed.id) === void 0) {
2444
- throw new EventNotFoundError(ed.id);
2445
- }
2446
- }
2447
- this.eventManager.addListener(eventDefinition, handler, {
2448
- order
2449
- });
2450
- } else {
2451
- if (this.store.events.get(eventDefinition.id) === void 0) {
2452
- throw new EventNotFoundError(eventDefinition.id);
2453
- }
2454
- this.eventManager.addListener(eventDefinition, handler, {
2455
- order
2456
- });
2457
- }
2458
- }
2459
- }
2460
- }
2461
- async extractDependencies(map, source) {
2462
- const object = {};
2463
- for (const key in map) {
2464
- try {
2465
- object[key] = await this.extractDependency(map[key], source);
2466
- if (object[key] instanceof Logger) {
2467
- object[key] = object[key].with({ source });
2468
- }
2469
- } catch (e) {
2470
- const errorMessage = String(e);
2471
- this.logger.error(
2472
- `Failed to extract dependency from source: ${source} -> ${key} with error: ${errorMessage}`
2473
- );
2474
- throw e;
2475
- }
2476
- }
2477
- this.logger.trace(`Finished computing dependencies for source: ${source}`);
2478
- return object;
2479
- }
2480
- async extractDependency(object, source) {
2481
- this.logger.trace(`Extracting dependency -> ${source} -> ${object?.id}`);
2482
- if (isOptional(object)) {
2483
- const inner = object.inner;
2484
- if (isResource(inner)) {
2485
- const exists = this.store.resources.get(inner.id) !== void 0;
2486
- return exists ? this.extractResourceDependency(inner) : void 0;
2487
- } else if (isTask(inner)) {
2488
- const exists = this.store.tasks.get(inner.id) !== void 0;
2489
- return exists ? this.extractTaskDependency(inner) : void 0;
2490
- } else if (isEvent(inner)) {
2491
- const exists = this.store.events.get(inner.id) !== void 0;
2492
- return exists ? this.extractEventDependency(inner, source) : void 0;
2493
- }
2494
- throw new UnknownItemTypeError(inner);
2495
- }
2496
- if (isResource(object)) {
2497
- return this.extractResourceDependency(object);
2498
- } else if (isTask(object)) {
2499
- return this.extractTaskDependency(object);
2500
- } else if (isEvent(object)) {
2501
- return this.extractEventDependency(object, source);
2502
- } else {
2503
- throw new UnknownItemTypeError(object);
2504
- }
2505
- }
2506
- /**
2507
- * Converts the event into a running functions with real inputs
2508
- * @param object
2509
- * @returns
2510
- */
2511
- extractEventDependency(object, source) {
2512
- return async (input) => {
2513
- return this.eventManager.emit(object, input, source);
2514
- };
2515
- }
2516
- async extractTaskDependency(object) {
2517
- const storeTask = this.store.tasks.get(object.id);
2518
- if (storeTask === void 0) {
2519
- throw new DependencyNotFoundError(`Task ${object.id}`);
2520
- }
2521
- if (!storeTask.isInitialized) {
2522
- const dependencies = object.dependencies;
2523
- storeTask.computedDependencies = await this.extractDependencies(
2524
- dependencies,
2525
- storeTask.task.id
2526
- );
2527
- storeTask.isInitialized = true;
2528
- }
2529
- return (input) => {
2530
- return this.taskRunner.run(storeTask.task, input);
2531
- };
2532
- }
2533
- async extractResourceDependency(object) {
2534
- const storeResource = this.store.resources.get(object.id);
2535
- if (storeResource === void 0) {
2536
- throw new DependencyNotFoundError(`Resource ${object.id}`);
2537
- }
2538
- const { resource, config } = storeResource;
2539
- if (!storeResource.isInitialized) {
2540
- if (resource.init) {
2541
- const depMap = resource.dependencies || {};
2542
- const raw = await this.extractDependencies(depMap, resource.id);
2543
- const wrapped = this.wrapResourceDependencies(depMap, raw);
2544
- const { value, context } = await this.resourceInitializer.initializeResource(
2545
- resource,
2546
- config,
2547
- wrapped
2548
- );
2549
- storeResource.context = context;
2550
- storeResource.value = value;
2551
- }
2552
- storeResource.isInitialized = true;
2553
- }
2554
- return storeResource.value;
2555
- }
2556
- };
2557
-
2558
- // src/models/EventManager.ts
2559
- var HandlerOptionsDefaults = { order: 0 };
2560
- var EventManager = class {
2561
- constructor(options) {
2562
- // Core storage for event listeners
2563
- this.listeners = /* @__PURE__ */ new Map();
2564
- this.globalListeners = [];
2565
- // Caching system for merged listeners to improve performance
2566
- this.cachedMergedListeners = /* @__PURE__ */ new Map();
2567
- this.globalListenersCacheValid = true;
2568
- // Interceptors storage
2569
- this.emissionInterceptors = [];
2570
- this.hookInterceptors = [];
2571
- // Locking mechanism to prevent modifications after initialization
2572
- this.#isLocked = false;
2573
- this.runtimeCycleDetection = options?.runtimeCycleDetection ?? true;
2574
- if (getPlatform().hasAsyncLocalStorage() && this.runtimeCycleDetection) {
2575
- this.emissionStack = getPlatform().createAsyncLocalStorage();
2576
- this.currentHookIdContext = getPlatform().createAsyncLocalStorage();
2577
- } else {
2578
- this.runtimeCycleDetection = false;
2579
- this.emissionStack = null;
2580
- this.currentHookIdContext = null;
2581
- }
2582
- }
2583
- static {
2584
- __name(this, "EventManager");
2585
- }
2586
- #isLocked;
2587
- // ==================== PUBLIC API ====================
2588
- /**
2589
- * Gets the current lock status of the EventManager
2590
- */
2591
- get isLocked() {
2592
- return this.#isLocked;
2593
- }
2594
- /**
2595
- * Locks the EventManager, preventing any further modifications to listeners
2596
- */
2597
- lock() {
2598
- this.#isLocked = true;
2599
- }
2600
- /**
2601
- * Emits an event to all registered listeners for that event type.
2602
- * Listeners are processed in order of priority and can stop event propagation.
2603
- *
2604
- * @param eventDefinition - The event definition to emit
2605
- * @param data - The event payload data
2606
- * @param source - The source identifier of the event emitter
2607
- */
2608
- async emit(eventDefinition, data, source) {
2609
- if (eventDefinition.payloadSchema) {
2610
- try {
2611
- data = eventDefinition.payloadSchema.parse(data);
2612
- } catch (error) {
2613
- throw new ValidationError(
2614
- "Event payload",
2615
- eventDefinition.id,
2616
- error instanceof Error ? error : new Error(String(error))
2617
- );
2618
- }
2619
- }
2620
- const frame = { id: eventDefinition.id, source };
2621
- const processEmission = /* @__PURE__ */ __name(async () => {
2622
- const excludeFromGlobal = globalTags.excludeFromGlobalHooks.exists(eventDefinition);
2623
- const allListeners = excludeFromGlobal ? this.listeners.get(eventDefinition.id) || [] : this.getCachedMergedListeners(eventDefinition.id);
2624
- let propagationStopped = false;
2625
- const event = {
2626
- id: eventDefinition.id,
2627
- data,
2628
- timestamp: /* @__PURE__ */ new Date(),
2629
- source,
2630
- meta: eventDefinition.meta || {},
2631
- stopPropagation: /* @__PURE__ */ __name(() => {
2632
- propagationStopped = true;
2633
- }, "stopPropagation"),
2634
- isPropagationStopped: /* @__PURE__ */ __name(() => propagationStopped, "isPropagationStopped"),
2635
- tags: eventDefinition.tags
2636
- };
2637
- const baseEmit = /* @__PURE__ */ __name(async (eventToEmit) => {
2638
- if (allListeners.length === 0) {
2639
- return;
2640
- }
2641
- this.isExcludedFromGlobal(eventToEmit);
2642
- for (const listener of allListeners) {
2643
- if (propagationStopped) {
2644
- break;
2645
- }
2646
- if (listener.id && listener.id === eventToEmit.source) {
2647
- continue;
2648
- }
2649
- if (!listener.filter || listener.filter(eventToEmit)) {
2650
- await listener.handler(eventToEmit);
2651
- }
2652
- }
2653
- }, "baseEmit");
2654
- let emitWithInterceptors = baseEmit;
2655
- const reversedInterceptors = [...this.emissionInterceptors].reverse();
2656
- for (const interceptor of reversedInterceptors) {
2657
- const nextFunction = emitWithInterceptors;
2658
- emitWithInterceptors = /* @__PURE__ */ __name(async (eventToEmit) => interceptor(nextFunction, eventToEmit), "emitWithInterceptors");
2659
- }
2660
- await emitWithInterceptors(event);
2661
- }, "processEmission");
2662
- if (this.runtimeCycleDetection && this.emissionStack && this.currentHookIdContext) {
2663
- const currentStack = this.emissionStack.getStore();
2664
- if (currentStack) {
2665
- const cycleStart = currentStack.findIndex(
2666
- (f) => f.id === frame.id
2667
- );
2668
- if (cycleStart !== -1) {
2669
- const top = currentStack[currentStack.length - 1];
2670
- const currentHookId = this.currentHookIdContext.getStore();
2671
- const safeReEmitBySameHook = top.id === frame.id && currentHookId && currentHookId === source;
2672
- if (!safeReEmitBySameHook) {
2673
- throw new EventCycleError([
2674
- ...currentStack.slice(cycleStart),
2675
- frame
2676
- ]);
2677
- }
2678
- }
2679
- }
2680
- const nextStack = currentStack ? [...currentStack, frame] : [frame];
2681
- await this.emissionStack.run(nextStack, processEmission);
2682
- } else {
2683
- await processEmission();
2684
- }
2685
- }
2686
- /**
2687
- * Registers an event listener for specific event(s).
2688
- * Listeners are ordered by priority and executed in ascending order.
2689
- *
2690
- * @param event - The event definition(s) to listen for
2691
- * @param handler - The callback function to handle the event
2692
- * @param options - Configuration options for the listener
2693
- */
2694
- addListener(event, handler, options = HandlerOptionsDefaults) {
2695
- this.checkLock();
2696
- const newListener = {
2697
- handler,
2698
- order: options.order || 0,
2699
- filter: options.filter,
2700
- id: options.id,
2701
- isGlobal: false
2702
- };
2703
- if (Array.isArray(event)) {
2704
- event.forEach((id2) => this.addListener(id2, handler, options));
2705
- } else {
2706
- const eventId = event.id;
2707
- const listeners = this.listeners.get(eventId);
2708
- if (listeners) {
2709
- this.insertListener(listeners, newListener);
2710
- } else {
2711
- this.listeners.set(eventId, [newListener]);
2712
- }
2713
- this.invalidateCache(eventId);
2714
- }
2715
- }
2716
- /**
2717
- * Registers a global event listener that handles all events.
2718
- * Global listeners are mixed with specific listeners and ordered by priority.
2719
- *
2720
- * @param handler - The callback function to handle events
2721
- * @param options - Configuration options for the listener
2722
- */
2723
- addGlobalListener(handler, options = HandlerOptionsDefaults) {
2724
- this.checkLock();
2725
- const newListener = {
2726
- handler,
2727
- order: options.order || 0,
2728
- filter: options.filter,
2729
- id: options.id,
2730
- isGlobal: true
2731
- };
2732
- this.insertListener(this.globalListeners, newListener);
2733
- this.invalidateCache();
2734
- }
2735
- /**
2736
- * Checks if there are any listeners registered for the given event
2737
- *
2738
- * @param eventDefinition - The event definition to check
2739
- * @returns true if listeners exist, false otherwise
2740
- */
2741
- hasListeners(eventDefinition) {
2742
- const eventListeners = this.listeners.get(eventDefinition.id) || [];
2743
- if (eventListeners.length > 0) {
2744
- return true;
2745
- }
2746
- if (this.globalListeners.length === 0) {
2747
- return false;
2748
- }
2749
- const isExcludedFromGlobal = globalTags.excludeFromGlobalHooks.exists(eventDefinition);
2750
- return !isExcludedFromGlobal;
2751
- }
2752
- /**
2753
- * Adds an interceptor for all event emissions
2754
- * Interceptors are executed in the order they are added, with the ability to
2755
- * modify, log, or prevent event emissions
2756
- *
2757
- * @param interceptor - The interceptor function to add
2758
- */
2759
- intercept(interceptor) {
2760
- this.checkLock();
2761
- this.emissionInterceptors.push(interceptor);
2762
- }
2763
- /**
2764
- * Adds an interceptor for hook execution
2765
- * Interceptors are executed in the order they are added, with the ability to
2766
- * modify, log, or prevent hook execution
2767
- *
2768
- * @param interceptor - The interceptor function to add
2769
- */
2770
- interceptHook(interceptor) {
2771
- this.checkLock();
2772
- this.hookInterceptors.push(interceptor);
2773
- }
2774
- /**
2775
- * Executes a hook with all registered hook interceptors applied
2776
- * This method should be used by TaskRunner when executing hooks
2777
- *
2778
- * @param hook - The hook to execute
2779
- * @param event - The event that triggered the hook
2780
- * @param computedDependencies - The computed dependencies for the hook
2781
- * @returns Promise resolving to the hook execution result
2782
- */
2783
- async executeHookWithInterceptors(hook, event, computedDependencies) {
2784
- const baseExecute = /* @__PURE__ */ __name(async (hookToExecute, eventForHook) => {
2785
- try {
2786
- const result = await hookToExecute.run(
2787
- eventForHook,
2788
- computedDependencies
2789
- );
2790
- return result;
2791
- } catch (err) {
2792
- throw err;
2793
- }
2794
- }, "baseExecute");
2795
- let executeWithInterceptors = baseExecute;
2796
- const reversedInterceptors = [...this.hookInterceptors].reverse();
2797
- for (const interceptor of reversedInterceptors) {
2798
- const nextFunction = executeWithInterceptors;
2799
- executeWithInterceptors = /* @__PURE__ */ __name(async (hookToExecute, eventForHook) => interceptor(nextFunction, hookToExecute, eventForHook), "executeWithInterceptors");
2800
- }
2801
- if (this.runtimeCycleDetection) {
2802
- return await this.currentHookIdContext?.run(
2803
- hook.id,
2804
- async () => await executeWithInterceptors(hook, event)
2805
- );
2806
- } else {
2807
- return await executeWithInterceptors(hook, event);
2808
- }
2809
- }
2810
- // ==================== PRIVATE METHODS ====================
2811
- /**
2812
- * Throws an error if the EventManager is locked
2813
- */
2814
- checkLock() {
2815
- if (this.#isLocked) {
2816
- throw new LockedError("EventManager");
2817
- }
2818
- }
2819
- /**
2820
- * Merges two sorted arrays of listeners while maintaining order.
2821
- * Used to combine event-specific listeners with global listeners.
2822
- *
2823
- * @param a - First array of listeners
2824
- * @param b - Second array of listeners
2825
- * @returns Merged and sorted array of listeners
2826
- */
2827
- mergeSortedListeners(a, b) {
2828
- const result = [];
2829
- let i = 0, j = 0;
2830
- while (i < a.length && j < b.length) {
2831
- if (a[i].order <= b[j].order) {
2832
- result.push(a[i++]);
2833
- } else {
2834
- result.push(b[j++]);
2835
- }
2836
- }
2837
- while (i < a.length) result.push(a[i++]);
2838
- while (j < b.length) result.push(b[j++]);
2839
- return result;
2840
- }
2841
- /**
2842
- * Inserts a new listener into a sorted array using binary search.
2843
- * Maintains order based on listener priority.
2844
- *
2845
- * @param listeners - Array to insert into
2846
- * @param newListener - Listener to insert
2847
- */
2848
- insertListener(listeners, newListener) {
2849
- let low = 0;
2850
- let high = listeners.length;
2851
- while (low < high) {
2852
- const mid = low + high >>> 1;
2853
- if (listeners[mid].order < newListener.order) {
2854
- low = mid + 1;
2855
- } else {
2856
- high = mid;
2857
- }
2858
- }
2859
- listeners.splice(low, 0, newListener);
2860
- }
2861
- /**
2862
- * Returns true if the given emission carries the tag that marks
2863
- * it as excluded from global ("*") listeners.
2864
- *
2865
- * @param event - The event emission to check
2866
- * @returns true if event should exclude global listeners
2867
- */
2868
- isExcludedFromGlobal(event) {
2869
- return globalTags.excludeFromGlobalHooks.exists(event);
2870
- }
2871
- /**
2872
- * Retrieves cached merged listeners for an event, or creates them if not cached.
2873
- * Combines event-specific listeners with global listeners and sorts them by priority.
2874
- *
2875
- * @param eventId - The event ID to get listeners for
2876
- * @returns Array of merged listeners sorted by priority
2877
- */
2878
- getCachedMergedListeners(eventId) {
2879
- if (!this.globalListenersCacheValid) {
2880
- this.cachedMergedListeners.clear();
2881
- this.globalListenersCacheValid = true;
2882
- }
2883
- let cached = this.cachedMergedListeners.get(eventId);
2884
- if (!cached) {
2885
- const eventListeners = this.listeners.get(eventId) || [];
2886
- if (eventListeners.length === 0 && this.globalListeners.length === 0) {
2887
- cached = [];
2888
- } else if (eventListeners.length === 0) {
2889
- cached = this.globalListeners;
2890
- } else if (this.globalListeners.length === 0) {
2891
- cached = eventListeners;
2892
- } else {
2893
- cached = this.mergeSortedListeners(
2894
- eventListeners,
2895
- this.globalListeners
2896
- );
2897
- }
2898
- this.cachedMergedListeners.set(eventId, cached);
2899
- }
2900
- return cached;
2901
- }
2902
- /**
2903
- * Invalidates the cached merged listeners.
2904
- * If eventId is provided, only invalidates cache for that specific event.
2905
- * Otherwise, invalidates the global cache.
2906
- *
2907
- * @param eventId - Optional specific event ID to invalidate
2908
- */
2909
- invalidateCache(eventId) {
2910
- if (eventId) {
2911
- this.cachedMergedListeners.delete(eventId);
2912
- } else {
2913
- this.globalListenersCacheValid = false;
2914
- }
2915
- }
2916
- };
2917
-
2918
- // src/models/utils/findCircularDependencies.ts
2919
- function findCircularDependencies(nodes) {
2920
- const result = {
2921
- cycles: [],
2922
- missingDependencies: []
2923
- };
2924
- const visited = /* @__PURE__ */ new Set();
2925
- const stack = /* @__PURE__ */ new Set();
2926
- const path = [];
2927
- function dfs(node) {
2928
- if (stack.has(node.id)) {
2929
- const cycleStartIndex = path.indexOf(node.id);
2930
- const cycle = path.slice(cycleStartIndex).concat(node.id).join(" -> ");
2931
- result.cycles.push(cycle);
2932
- return;
2933
- }
2934
- if (visited.has(node.id)) return;
2935
- visited.add(node.id);
2936
- stack.add(node.id);
2937
- path.push(node.id);
2938
- for (const [depKey, dependentNode] of Object.entries(node.dependencies)) {
2939
- if (!dependentNode) {
2940
- result.missingDependencies.push({
2941
- nodeId: node.id,
2942
- dependencyId: depKey
2943
- });
2944
- continue;
2945
- }
2946
- dfs(dependentNode);
2947
- }
2948
- stack.delete(node.id);
2949
- path.pop();
2950
- }
2951
- __name(dfs, "dfs");
2952
- for (const node of nodes) {
2953
- if (!visited.has(node.id)) {
2954
- dfs(node);
2955
- }
2956
- }
2957
- result.cycles = Array.from(new Set(result.cycles));
2958
- return result;
2959
- }
2960
- __name(findCircularDependencies, "findCircularDependencies");
2961
-
2962
- // src/models/StoreValidator.ts
2963
- var StoreValidator = class {
2964
- constructor(registry) {
2965
- this.registry = registry;
2966
- }
2967
- static {
2968
- __name(this, "StoreValidator");
2969
- }
2970
- checkIfIDExists(id2) {
2971
- if (this.registry.tasks.has(id2)) {
2972
- throw new DuplicateRegistrationError("Task", id2);
2973
- }
2974
- if (this.registry.resources.has(id2)) {
2975
- throw new DuplicateRegistrationError("Resource", id2);
2976
- }
2977
- if (this.registry.events.has(id2)) {
2978
- throw new DuplicateRegistrationError("Event", id2);
2979
- }
2980
- if (this.registry.taskMiddlewares.has(id2)) {
2981
- throw new DuplicateRegistrationError("Middleware", id2);
2982
- }
2983
- if (this.registry.resourceMiddlewares.has(id2)) {
2984
- throw new DuplicateRegistrationError("Middleware", id2);
2985
- }
2986
- if (this.registry.tags.has(id2)) {
2987
- throw new DuplicateRegistrationError("Tag", id2);
2988
- }
2989
- if (this.registry.hooks.has(id2)) {
2990
- throw new DuplicateRegistrationError("Hook", id2);
2991
- }
2992
- }
2993
- runSanityChecks() {
2994
- for (const task of this.registry.tasks.values()) {
2995
- const middlewares = task.task.middleware;
2996
- middlewares.forEach((middlewareAttachment) => {
2997
- if (!this.registry.taskMiddlewares.has(middlewareAttachment.id)) {
2998
- throw new MiddlewareNotRegisteredError(
2999
- "task",
3000
- task.task.id,
3001
- middlewareAttachment.id
3002
- );
3003
- }
3004
- });
3005
- }
3006
- for (const resource of this.registry.resources.values()) {
3007
- const middlewares = resource.resource.middleware;
3008
- middlewares.forEach((middlewareAttachment) => {
3009
- if (!this.registry.resourceMiddlewares.has(middlewareAttachment.id)) {
3010
- throw new MiddlewareNotRegisteredError(
3011
- "resource",
3012
- resource.resource.id,
3013
- middlewareAttachment.id
3014
- );
3015
- }
3016
- });
3017
- }
3018
- this.ensureAllTagsUsedAreRegistered();
3019
- }
3020
- ensureAllTagsUsedAreRegistered() {
3021
- const taggables = [
3022
- ...Array.from(this.registry.tasks.values()).map((x) => x.task),
3023
- ...Array.from(this.registry.resources.values()).map((x) => x.resource),
3024
- ...Array.from(this.registry.events.values()).map((x) => x.event),
3025
- ...Array.from(this.registry.taskMiddlewares.values()).map(
3026
- (x) => x.middleware
3027
- ),
3028
- ...Array.from(this.registry.resourceMiddlewares.values()).map(
3029
- (x) => x.middleware
3030
- ),
3031
- ...Array.from(this.registry.hooks.values()).map((x) => x.hook)
3032
- ];
3033
- for (const taggable of taggables) {
3034
- const tags = taggable.tags;
3035
- if (tags) {
3036
- for (const tag of tags) {
3037
- if (!this.registry.tags.has(tag.id)) {
3038
- throw new TagNotFoundError(tag.id);
3039
- }
3040
- }
3041
- }
3042
- }
3043
- }
3044
- };
3045
-
3046
- // src/models/StoreRegistry.ts
3047
- var StoreRegistry = class {
3048
- constructor(store2) {
3049
- this.store = store2;
3050
- this.tasks = /* @__PURE__ */ new Map();
3051
- this.resources = /* @__PURE__ */ new Map();
3052
- this.events = /* @__PURE__ */ new Map();
3053
- this.taskMiddlewares = /* @__PURE__ */ new Map();
3054
- this.resourceMiddlewares = /* @__PURE__ */ new Map();
3055
- this.hooks = /* @__PURE__ */ new Map();
3056
- this.tags = /* @__PURE__ */ new Map();
3057
- this.validator = new StoreValidator(this);
3058
- }
3059
- static {
3060
- __name(this, "StoreRegistry");
3061
- }
3062
- getValidator() {
3063
- return this.validator;
3064
- }
3065
- storeGenericItem(item) {
3066
- if (isTask(item)) {
3067
- this.storeTask(item);
3068
- } else if (isHook && isHook(item)) {
3069
- this.storeHook(item);
3070
- } else if (isResource(item)) {
3071
- this.storeResource(item);
3072
- } else if (isEvent(item)) {
3073
- this.storeEvent(item);
3074
- } else if (isTaskMiddleware(item)) {
3075
- this.storeTaskMiddleware(item);
3076
- } else if (isResourceMiddleware(item)) {
3077
- this.storeResourceMiddleware(item);
3078
- } else if (isResourceWithConfig(item)) {
3079
- this.storeResourceWithConfig(item);
3080
- } else if (isTag(item)) {
3081
- this.storeTag(item);
3082
- } else {
3083
- throw new UnknownItemTypeError(item);
3084
- }
3085
- }
3086
- storeTag(item) {
3087
- this.validator.checkIfIDExists(item.id);
3088
- this.tags.set(item.id, item);
3089
- }
3090
- storeHook(item, overrideMode = "normal") {
3091
- overrideMode === "normal" && this.validator.checkIfIDExists(item.id);
3092
- const hook = this.getFreshValue(item, this.hooks, "hook", overrideMode);
3093
- this.hooks.set(hook.id, {
3094
- hook,
3095
- computedDependencies: {}
3096
- });
3097
- }
3098
- storeTaskMiddleware(item, storingMode = "normal") {
3099
- storingMode === "normal" && this.validator.checkIfIDExists(item.id);
3100
- const middleware = this.getFreshValue(
3101
- item,
3102
- this.taskMiddlewares,
3103
- "middleware",
3104
- storingMode
3105
- );
3106
- this.taskMiddlewares.set(item.id, {
3107
- middleware,
3108
- computedDependencies: {},
3109
- isInitialized: false
3110
- });
3111
- }
3112
- storeResourceMiddleware(item, overrideMode = "normal") {
3113
- overrideMode === "normal" && this.validator.checkIfIDExists(item.id);
3114
- const middleware = this.getFreshValue(
3115
- item,
3116
- this.resourceMiddlewares,
3117
- "middleware",
3118
- overrideMode
3119
- );
3120
- this.resourceMiddlewares.set(item.id, {
3121
- middleware,
3122
- computedDependencies: {},
3123
- isInitialized: false
3124
- });
3125
- }
3126
- storeEvent(item) {
3127
- this.validator.checkIfIDExists(item.id);
3128
- this.events.set(item.id, { event: item });
3129
- }
3130
- storeResourceWithConfig(item, storingMode = "normal") {
3131
- storingMode === "normal" && this.validator.checkIfIDExists(item.resource.id);
3132
- const prepared = this.getFreshValue(
3133
- item.resource,
3134
- this.resources,
3135
- "resource",
3136
- storingMode,
3137
- item.config
3138
- );
3139
- this.resources.set(prepared.id, {
3140
- resource: prepared,
3141
- config: item.config,
3142
- value: void 0,
3143
- isInitialized: false,
3144
- context: {}
3145
- });
3146
- this.computeRegistrationDeeply(prepared, item.config);
3147
- return prepared;
3148
- }
3149
- computeRegistrationDeeply(element, config) {
3150
- const items = typeof element.register === "function" ? element.register(config) : element.register;
3151
- element.register = items;
3152
- for (const item of items) {
3153
- this.storeGenericItem(item);
3154
- }
3155
- }
3156
- storeResource(item, overrideMode = "normal") {
3157
- overrideMode === "normal" && this.validator.checkIfIDExists(item.id);
3158
- const prepared = this.getFreshValue(
3159
- item,
3160
- this.resources,
3161
- "resource",
3162
- overrideMode
3163
- );
3164
- this.resources.set(prepared.id, {
3165
- resource: prepared,
3166
- config: {},
3167
- value: void 0,
3168
- isInitialized: false,
3169
- context: prepared.context?.() || {}
3170
- });
3171
- this.computeRegistrationDeeply(prepared, {});
3172
- return prepared;
3173
- }
3174
- storeTask(item, storingMode = "normal") {
3175
- storingMode === "normal" && this.validator.checkIfIDExists(item.id);
3176
- const task = this.getFreshValue(item, this.tasks, "task", storingMode);
3177
- this.tasks.set(task.id, {
3178
- task,
3179
- computedDependencies: {},
3180
- isInitialized: false
3181
- });
3182
- }
3183
- // Feels like a dependencyProcessor task?
3184
- getDependentNodes() {
3185
- const depenedants = [];
3186
- const nodeMap = /* @__PURE__ */ new Map();
3187
- this.setupBlankNodes(nodeMap, depenedants);
3188
- for (const task of this.tasks.values()) {
3189
- const node = nodeMap.get(task.task.id);
3190
- if (task.task.dependencies) {
3191
- for (const [depKey, depItem] of Object.entries(
3192
- task.task.dependencies
3193
- )) {
3194
- const candidate = isOptional(depItem) ? depItem.inner : depItem;
3195
- const depNode = nodeMap.get(candidate.id);
3196
- if (depNode) {
3197
- node.dependencies[depKey] = depNode;
3198
- }
3199
- }
3200
- }
3201
- const t = task.task;
3202
- for (const middleware of t.middleware) {
3203
- const middlewareNode = nodeMap.get(middleware.id);
3204
- if (middlewareNode) {
3205
- node.dependencies[middleware.id] = middlewareNode;
3206
- }
3207
- }
3208
- }
3209
- for (const storeTaskMiddleware of this.taskMiddlewares.values()) {
3210
- const node = nodeMap.get(storeTaskMiddleware.middleware.id);
3211
- const { middleware } = storeTaskMiddleware;
3212
- if (middleware.dependencies) {
3213
- for (const [depKey, depItem] of Object.entries(
3214
- middleware.dependencies
3215
- )) {
3216
- const candidate = isOptional(depItem) ? depItem.inner : depItem;
3217
- const depNode = nodeMap.get(candidate.id);
3218
- if (depNode) {
3219
- node.dependencies[depKey] = depNode;
3220
- }
3221
- }
3222
- }
3223
- if (middleware.everywhere) {
3224
- const filter = typeof middleware.everywhere === "function" ? middleware.everywhere : () => true;
3225
- for (const task of this.tasks.values()) {
3226
- if (filter(task.task)) {
3227
- const taskNode = nodeMap.get(task.task.id);
3228
- taskNode.dependencies[`__middleware.${middleware.id}`] = node;
3229
- }
3230
- }
3231
- }
3232
- }
3233
- for (const storeResourceMiddleware of this.resourceMiddlewares.values()) {
3234
- const node = nodeMap.get(storeResourceMiddleware.middleware.id);
3235
- const { middleware } = storeResourceMiddleware;
3236
- if (middleware.dependencies) {
3237
- for (const [depKey, depItem] of Object.entries(
3238
- middleware.dependencies
3239
- )) {
3240
- const candidate = isOptional(depItem) ? depItem.inner : depItem;
3241
- const depNode = nodeMap.get(candidate.id);
3242
- if (depNode) {
3243
- node.dependencies[depKey] = depNode;
3244
- }
3245
- }
3246
- }
3247
- if (middleware.everywhere) {
3248
- const filter = typeof middleware.everywhere === "function" ? middleware.everywhere : () => true;
3249
- for (const resource of this.resources.values()) {
3250
- if (filter(resource.resource)) {
3251
- const resourceNode = nodeMap.get(resource.resource.id);
3252
- resourceNode.dependencies[`__middleware.${middleware.id}`] = node;
3253
- }
3254
- }
3255
- }
3256
- }
3257
- for (const resource of this.resources.values()) {
3258
- const node = nodeMap.get(resource.resource.id);
3259
- if (resource.resource.dependencies) {
3260
- for (const [depKey, depItem] of Object.entries(
3261
- resource.resource.dependencies
3262
- )) {
3263
- const candidate = isOptional(depItem) ? depItem.inner : depItem;
3264
- const depNode = nodeMap.get(candidate.id);
3265
- if (depNode) {
3266
- node.dependencies[depKey] = depNode;
3267
- }
3268
- }
3269
- }
3270
- for (const middleware of resource.resource.middleware) {
3271
- const middlewareNode = nodeMap.get(middleware.id);
3272
- if (middlewareNode) {
3273
- node.dependencies[middleware.id] = middlewareNode;
3274
- }
3275
- }
3276
- }
3277
- for (const hook of this.hooks.values()) {
3278
- const node = nodeMap.get(hook.hook.id);
3279
- if (hook.hook.dependencies) {
3280
- for (const [depKey, depItem] of Object.entries(
3281
- hook.hook.dependencies
3282
- )) {
3283
- const candidate = isOptional(depItem) ? depItem.inner : depItem;
3284
- const depNode = nodeMap.get(candidate.id);
3285
- if (depNode) {
3286
- node.dependencies[depKey] = depNode;
3287
- }
3288
- }
3289
- }
3290
- }
3291
- return depenedants;
3292
- }
3293
- /**
3294
- * Builds a directed graph of event emissions based on hooks listening to events
3295
- * and their dependencies on events (emission capability). Ignores wildcard hooks by default.
3296
- */
3297
- buildEventEmissionGraph() {
3298
- const nodes = /* @__PURE__ */ new Map();
3299
- for (const e of this.events.values()) {
3300
- nodes.set(e.event.id, { id: e.event.id, dependencies: {} });
3301
- }
3302
- for (const h of this.hooks.values()) {
3303
- const listened = [];
3304
- const on = h.hook.on;
3305
- if (on === "*") continue;
3306
- if (Array.isArray(on)) listened.push(...on.map((e) => e.id));
3307
- else listened.push(on.id);
3308
- const depEvents = [];
3309
- const deps = h.hook.dependencies;
3310
- if (deps) {
3311
- for (const value of Object.values(deps)) {
3312
- const candidate = isOptional(value) ? value.inner : value;
3313
- if (candidate && isEvent(candidate)) {
3314
- depEvents.push(candidate.id);
3315
- }
3316
- }
3317
- }
3318
- for (const srcId of listened) {
3319
- const srcNode = nodes.get(srcId);
3320
- if (!srcNode) continue;
3321
- for (const dstId of depEvents) {
3322
- if (srcId === dstId) continue;
3323
- const dstNode = nodes.get(dstId);
3324
- if (dstNode) {
3325
- srcNode.dependencies[dstId] = dstNode;
3326
- }
3327
- }
3328
- }
3329
- }
3330
- return Array.from(nodes.values());
3331
- }
3332
- setupBlankNodes(nodeMap, depenedants) {
3333
- for (const task of this.tasks.values()) {
3334
- const node = {
3335
- id: task.task.id,
3336
- dependencies: {}
3337
- };
3338
- nodeMap.set(task.task.id, node);
3339
- depenedants.push(node);
3340
- }
3341
- for (const middleware of this.taskMiddlewares.values()) {
3342
- const node = {
3343
- id: middleware.middleware.id,
3344
- dependencies: {}
3345
- };
3346
- nodeMap.set(middleware.middleware.id, node);
3347
- depenedants.push(node);
3348
- }
3349
- for (const middleware of this.resourceMiddlewares.values()) {
3350
- const node = {
3351
- id: middleware.middleware.id,
3352
- dependencies: {}
3353
- };
3354
- nodeMap.set(middleware.middleware.id, node);
3355
- depenedants.push(node);
3356
- }
3357
- for (const resource of this.resources.values()) {
3358
- const node = {
3359
- id: resource.resource.id,
3360
- dependencies: {}
3361
- };
3362
- nodeMap.set(resource.resource.id, node);
3363
- depenedants.push(node);
3364
- }
3365
- for (const hook of this.hooks.values()) {
3366
- const node = {
3367
- id: hook.hook.id,
3368
- dependencies: {}
3369
- };
3370
- nodeMap.set(hook.hook.id, node);
3371
- depenedants.push(node);
3372
- }
3373
- }
3374
- getTasksWithTag(tag) {
3375
- const tagId = typeof tag === "string" ? tag : tag.id;
3376
- return Array.from(this.tasks.values()).filter((x) => {
3377
- return x.task.tags.some((t) => t.id === tagId);
3378
- }).map((x) => x.task);
3379
- }
3380
- getResourcesWithTag(tag) {
3381
- const tagId = typeof tag === "string" ? tag : tag.id;
3382
- return Array.from(this.resources.values()).filter((x) => {
3383
- return x.resource.tags.some((t) => t.id === tagId);
3384
- }).map((x) => x.resource);
3385
- }
3386
- /**
3387
- * Used to fetch the value cloned, and if we're dealing with an override, we need to extend the previous value.
3388
- */
3389
- getFreshValue(item, collection, key, overrideMode, config) {
3390
- let currentItem;
3391
- if (overrideMode === "override") {
3392
- const existing = collection.get(item.id)[key];
3393
- currentItem = { ...existing, ...item };
3394
- } else {
3395
- currentItem = { ...item };
3396
- }
3397
- currentItem.dependencies = typeof currentItem.dependencies === "function" ? currentItem.dependencies(config || currentItem.config) : currentItem.dependencies;
3398
- return currentItem;
3399
- }
3400
- };
3401
-
3402
- // src/models/OverrideManager.ts
3403
- var OverrideManager = class {
3404
- constructor(registry) {
3405
- this.registry = registry;
3406
- this.overrides = /* @__PURE__ */ new Map();
3407
- this.overrideRequests = /* @__PURE__ */ new Set();
3408
- }
3409
- static {
3410
- __name(this, "OverrideManager");
3411
- }
3412
- storeOverridesDeeply(element) {
3413
- element.overrides.forEach((override) => {
3414
- if (!override) {
3415
- return;
3416
- }
3417
- if (isResource(override)) {
3418
- this.storeOverridesDeeply(override);
3419
- }
3420
- let id2;
3421
- if (isResourceWithConfig(override)) {
3422
- this.storeOverridesDeeply(override.resource);
3423
- id2 = override.resource.id;
3424
- } else {
3425
- id2 = override.id;
3426
- }
3427
- this.overrideRequests.add({ source: element.id, override });
3428
- this.overrides.set(id2, override);
3429
- });
3430
- }
3431
- processOverrides() {
3432
- for (const override of this.overrides.values()) {
3433
- let hasAnyItem = false;
3434
- if (isTask(override)) {
3435
- hasAnyItem = this.registry.tasks.has(override.id);
3436
- } else if (isResource(override)) {
3437
- hasAnyItem = this.registry.resources.has(override.id);
3438
- } else if (isTaskMiddleware(override)) {
3439
- hasAnyItem = this.registry.taskMiddlewares.has(override.id);
3440
- } else if (isResourceMiddleware(override)) {
3441
- hasAnyItem = this.registry.resourceMiddlewares.has(override.id);
3442
- } else if (isResourceWithConfig(override)) {
3443
- hasAnyItem = this.registry.resources.has(override.resource.id);
3444
- } else if (isHook(override)) {
3445
- hasAnyItem = this.registry.hooks.has(override.id);
3446
- }
3447
- if (!hasAnyItem) {
3448
- const id2 = isResourceWithConfig(override) ? override.resource.id : override.id;
3449
- throw new DependencyNotFoundError(id2);
3450
- }
3451
- }
3452
- for (const override of this.overrides.values()) {
3453
- if (isTask(override)) {
3454
- this.registry.storeTask(override, "override");
3455
- } else if (isResource(override)) {
3456
- this.registry.storeResource(override, "override");
3457
- } else if (isTaskMiddleware(override)) {
3458
- this.registry.storeTaskMiddleware(override, "override");
3459
- } else if (isResourceMiddleware(override)) {
3460
- this.registry.storeResourceMiddleware(override, "override");
3461
- } else if (isResourceWithConfig(override)) {
3462
- this.registry.storeResourceWithConfig(override, "override");
3463
- } else if (isHook(override)) {
3464
- this.registry.storeHook(override, "override");
3465
- }
3466
- }
3467
- }
3468
- };
3469
-
3470
- // src/models/Store.ts
3471
- var Store = class {
3472
- constructor(eventManager, logger, onUnhandledError) {
3473
- this.eventManager = eventManager;
3474
- this.logger = logger;
3475
- this.onUnhandledError = onUnhandledError;
3476
- this.registry = new StoreRegistry(this);
3477
- this.validator = this.registry.getValidator();
3478
- this.overrideManager = new OverrideManager(this.registry);
3479
- this.middlewareManager = new MiddlewareManager(this, eventManager, logger);
3480
- }
3481
- static {
3482
- __name(this, "Store");
3483
- }
3484
- #isLocked = false;
3485
- #isInitialized = false;
3486
- // Delegate properties to registry
3487
- get tasks() {
3488
- return this.registry.tasks;
3489
- }
3490
- get hooks() {
3491
- return this.registry.hooks;
3492
- }
3493
- get resources() {
3494
- return this.registry.resources;
3495
- }
3496
- get events() {
3497
- return this.registry.events;
3498
- }
3499
- get taskMiddlewares() {
3500
- return this.registry.taskMiddlewares;
3501
- }
3502
- get resourceMiddlewares() {
3503
- return this.registry.resourceMiddlewares;
3504
- }
3505
- get tags() {
3506
- return this.registry.tags;
3507
- }
3508
- get overrides() {
3509
- return this.overrideManager.overrides;
3510
- }
3511
- get overrideRequests() {
3512
- return this.overrideManager.overrideRequests;
3513
- }
3514
- // Expose the shared MiddlewareManager instance so other components (like TaskRunner)
3515
- // can compose runners using the same interceptor configuration.
3516
- getMiddlewareManager() {
3517
- return this.middlewareManager;
3518
- }
3519
- get isLocked() {
3520
- return this.#isLocked;
3521
- }
3522
- lock() {
3523
- this.#isLocked = true;
3524
- }
3525
- checkLock() {
3526
- if (this.#isLocked) {
3527
- throw new Error("Cannot modify the Store when it is locked.");
3528
- }
3529
- }
3530
- registerGlobalComponents() {
3531
- const builtInResourcesMap = /* @__PURE__ */ new Map();
3532
- builtInResourcesMap.set(globalResources.store, this);
3533
- builtInResourcesMap.set(globalResources.eventManager, this.eventManager);
3534
- builtInResourcesMap.set(globalResources.logger, this.logger);
3535
- builtInResourcesMap.set(globalResources.taskRunner, this.taskRunner);
3536
- builtInResourcesMap.set(
3537
- globalResources.middlewareManager,
3538
- this.middlewareManager
3539
- );
3540
- this.registry.storeGenericItem(globalResources.queue);
3541
- for (const [resource, value] of builtInResourcesMap.entries()) {
3542
- this.registry.storeGenericItem(resource);
3543
- const entry = this.resources.get(resource.id);
3544
- if (entry) {
3545
- entry.value = value;
3546
- entry.isInitialized = true;
3547
- }
3548
- }
3549
- Object.values(globalTags).forEach((tag) => {
3550
- this.registry.storeTag(tag);
3551
- });
3552
- globalEventsArray.forEach((event) => {
3553
- this.registry.storeEvent(event);
3554
- });
3555
- const builtInTaskMiddlewares = [
3556
- requireContextTaskMiddleware,
3557
- retryTaskMiddleware,
3558
- timeoutTaskMiddleware
3559
- ];
3560
- builtInTaskMiddlewares.forEach((middleware) => {
3561
- this.registry.taskMiddlewares.set(middleware.id, {
3562
- middleware,
3563
- computedDependencies: {},
3564
- isInitialized: false
3565
- });
3566
- });
3567
- const builtInResourceMiddlewares = [
3568
- retryResourceMiddleware,
3569
- timeoutResourceMiddleware
3570
- ];
3571
- builtInResourceMiddlewares.forEach((middleware) => {
3572
- this.registry.resourceMiddlewares.set(middleware.id, {
3573
- middleware,
3574
- computedDependencies: {},
3575
- isInitialized: false
3576
- });
3577
- });
3578
- }
3579
- setTaskRunner(taskRunner) {
3580
- this.taskRunner = taskRunner;
3581
- }
3582
- setupRootResource(root, config) {
3583
- root.dependencies = typeof root.dependencies === "function" ? root.dependencies(config) : root.dependencies;
3584
- this.root = {
3585
- resource: root,
3586
- computedDependencies: {},
3587
- config,
3588
- value: void 0,
3589
- isInitialized: false,
3590
- context: {}
3591
- };
3592
- this.registry.computeRegistrationDeeply(root, config);
3593
- this.registry.resources.set(root.id, this.root);
3594
- }
3595
- validateDependencyGraph() {
3596
- const dependentNodes = this.registry.getDependentNodes();
3597
- const circularDependencies = findCircularDependencies(dependentNodes);
3598
- if (circularDependencies.cycles.length > 0) {
3599
- throw new CircularDependenciesError(circularDependencies.cycles);
3600
- }
3601
- }
3602
- validateEventEmissionGraph() {
3603
- const eventNodes = this.registry.buildEventEmissionGraph();
3604
- const circular = findCircularDependencies(eventNodes);
3605
- if (circular.cycles.length > 0) {
3606
- throw new EventEmissionCycleError(circular.cycles);
3607
- }
3608
- }
3609
- initializeStore(root, config) {
3610
- if (this.#isInitialized) {
3611
- throw new StoreAlreadyInitializedError();
3612
- }
3613
- this.registerGlobalComponents();
3614
- this.setupRootResource(root, config);
3615
- this.validator.runSanityChecks();
3616
- for (const resource of this.resources.values()) {
3617
- this.overrideManager.storeOverridesDeeply(resource.resource);
3618
- }
3619
- this.#isInitialized = true;
3620
- }
3621
- async dispose() {
3622
- for (const resource of this.resources.values()) {
3623
- if (resource.isInitialized && resource.resource.dispose) {
3624
- await resource.resource.dispose(
3625
- resource.value,
3626
- resource.config,
3627
- resource.computedDependencies,
3628
- resource.context
3629
- );
3630
- }
3631
- }
3632
- }
3633
- /**
3634
- * Internal, avoid using this method directly.
3635
- */
3636
- processOverrides() {
3637
- this.overrideManager.processOverrides();
3638
- }
3639
- /**
3640
- * Internal, avoid using this method directly.
3641
- * @param item
3642
- * @returns
3643
- */
3644
- storeGenericItem(item) {
3645
- return this.registry.storeGenericItem(item);
3646
- }
3647
- /**
3648
- * Returns all tasks with the given tag.
3649
- * @param tag - The tag to filter by.
3650
- * @returns The tasks with the given tag.
3651
- */
3652
- getTasksWithTag(tag) {
3653
- return this.registry.getTasksWithTag(tag);
3654
- }
3655
- /**
3656
- * Returns all resources with the given tag.
3657
- * @param tag - The tag to filter by.
3658
- * @returns The resources with the given tag.
3659
- */
3660
- getResourcesWithTag(tag) {
3661
- return this.registry.getResourcesWithTag(tag);
3662
- }
3663
- };
3664
-
3665
- // src/globals/resources/debug/types.ts
3666
- var allFalse = Object.freeze({
3667
- logResourceBeforeRun: false,
3668
- logResourceAfterRun: false,
3669
- logMiddlewareBeforeRun: false,
3670
- logMiddlewareAfterRun: false,
3671
- logTaskBeforeRun: false,
3672
- logTaskAfterRun: false,
3673
- logTaskInput: false,
3674
- logTaskOutput: false,
3675
- logResourceConfig: false,
3676
- logResourceValue: false,
3677
- logHookTriggered: false,
3678
- logHookCompleted: false,
3679
- logEventEmissionOnRun: false,
3680
- logEventEmissionInput: false
3681
- });
3682
- var levelNormal = Object.freeze({
3683
- ...allFalse,
3684
- logTaskAfterRun: true,
3685
- logTaskBeforeRun: true,
3686
- logResourceBeforeRun: true,
3687
- logResourceAfterRun: true,
3688
- logMiddlewareBeforeRun: true,
3689
- logMiddlewareAfterRun: true,
3690
- logHookTriggered: true,
3691
- logHookCompleted: true,
3692
- logEventEmissionOnRun: true
3693
- });
3694
- Object.freeze(levelNormal);
3695
- var levelVerbose = Object.freeze({
3696
- ...levelNormal,
3697
- logTaskInput: true,
3698
- logTaskOutput: true,
3699
- logResourceConfig: true,
3700
- logResourceValue: true,
3701
- logHookTriggered: true,
3702
- logHookCompleted: true
3703
- });
3704
- Object.freeze(levelVerbose);
3705
- function formatConfig(config) {
3706
- if (config === "normal") {
3707
- return { ...levelNormal };
3708
- }
3709
- if (config === "verbose") {
3710
- return { ...levelVerbose };
3711
- }
3712
- return { ...allFalse, ...config };
3713
- }
3714
- __name(formatConfig, "formatConfig");
3715
- var getConfig = /* @__PURE__ */ __name((config, taggable) => {
3716
- if (!taggable) {
3717
- return formatConfig(config);
3718
- }
3719
- const debugTagConfig = debugTag.extract(taggable);
3720
- if (debugTagConfig) {
3721
- const debugTagConfigFormatted = formatConfig(debugTagConfig);
3722
- return { ...formatConfig(config), ...debugTagConfigFormatted };
3723
- }
3724
- return formatConfig(config);
3725
- }, "getConfig");
3726
-
3727
- // src/globals/resources/debug/debugConfig.resource.ts
3728
- var debugConfig = defineResource({
3729
- id: "globals.debug.resources.config",
3730
- meta: {
3731
- title: "Debug Config",
3732
- description: "Debug config. This is used to debug the system."
3733
- },
3734
- tags: [globalTags.system],
3735
- init: /* @__PURE__ */ __name(async (config) => {
3736
- const myConfig = { ...getConfig(config) };
3737
- Object.freeze(myConfig);
3738
- return myConfig;
3739
- }, "init")
3740
- });
3741
-
3742
- // src/globals/resources/debug/utils.ts
3743
- var hasSystemTag = /* @__PURE__ */ __name((definition) => {
3744
- const maybeTags = definition.tags;
3745
- if (!Array.isArray(maybeTags)) {
3746
- return false;
3747
- }
3748
- return globalTags.system.exists(definition);
3749
- }, "hasSystemTag");
3750
-
3751
- // src/globals/resources/debug/globalEvent.hook.ts
3752
- var globalEventListener = defineHook({
3753
- id: "globals.debug.hooks.onAnyEvent",
3754
- on: "*",
3755
- dependencies: {
3756
- logger: globalResources.logger,
3757
- debugConfig
3758
- },
3759
- run: /* @__PURE__ */ __name(async (event, { logger, debugConfig: debugConfig2 }) => {
3760
- if (hasSystemTag(event)) {
3761
- return;
3762
- }
3763
- debugConfig2 = getConfig(debugConfig2, event);
3764
- if (debugConfig2.logEventEmissionOnRun) {
3765
- const message = `Event ${String(event.id)} emitted`;
3766
- await logger.info(message, {
3767
- source: "globals.debug.hooks.onAnyEvent",
3768
- data: debugConfig2.logEventEmissionInput ? { data: event.data } : void 0
3769
- });
3770
- }
3771
- }, "run"),
3772
- meta: {
3773
- title: "Non-system Event Logger",
3774
- description: "Logs all non-system events."
3775
- },
3776
- tags: [globalTags.system]
3777
- });
3778
-
3779
- // src/globals/resources/debug/executionTracker.middleware.ts
3780
- var tasksTrackerMiddleware = defineTaskMiddleware({
3781
- id: "globals.debug.middleware.task.executionTracker",
3782
- everywhere: /* @__PURE__ */ __name((task) => !globalTags.system.exists(task), "everywhere"),
3783
- dependencies: {
3784
- logger: globalResources.logger,
3785
- debugConfig,
3786
- store: globalResources.store
3787
- },
3788
- run: /* @__PURE__ */ __name(async ({ task, next }, { logger, debugConfig: debugConfig2, store: store2 }) => {
3789
- const start = Date.now();
3790
- logger = logger.with({
3791
- source: tasksTrackerMiddleware.id
3792
- });
3793
- debugConfig2 = getConfig(debugConfig2, task?.definition);
3794
- const taskStartMessage = `Task ${task.definition.id} is running...`;
3795
- const shouldShowData = debugConfig2.logTaskInput && task.input;
3796
- await logger.info(taskStartMessage, {
3797
- data: shouldShowData ? { input: task.input } : void 0
3798
- });
3799
- const result = await next(task.input);
3800
- const duration = Date.now() - start;
3801
- const taskCompleteMessage = `Task ${task.definition.id} completed in ${duration}ms`;
3802
- const shouldShowResult = debugConfig2.logTaskOutput && result;
3803
- await logger.info(taskCompleteMessage, {
3804
- data: shouldShowResult ? { result } : void 0
3805
- });
3806
- return result;
3807
- }, "run"),
3808
- meta: {
3809
- title: "Execution Tracker",
3810
- description: "Tracks the execution of tasks and resources."
3811
- },
3812
- tags: [globalTags.system]
3813
- });
3814
- var resourcesTrackerMiddleware = defineResourceMiddleware({
3815
- id: "globals.debug.middleware.resource.executionTracker",
3816
- dependencies: {
3817
- logger: globalResources.logger,
3818
- debugConfig,
3819
- store: globalResources.store
3820
- },
3821
- everywhere: /* @__PURE__ */ __name((resource) => !globalTags.system.exists(resource), "everywhere"),
3822
- run: /* @__PURE__ */ __name(async ({ resource, next }, { logger, debugConfig: debugConfig2, store: store2 }) => {
3823
- const start = Date.now();
3824
- logger = logger.with({
3825
- source: resourcesTrackerMiddleware.id
3826
- });
3827
- debugConfig2 = getConfig(debugConfig2, resource?.definition);
3828
- const resourceStartMessage = `Resource ${resource.definition.id} is initializing...`;
3829
- const isConfigEmpty = Object.keys(resource.config || {}).length === 0;
3830
- const shouldShowConfig = debugConfig2.logResourceConfig && !isConfigEmpty;
3831
- await logger.info(resourceStartMessage, {
3832
- data: shouldShowConfig ? { config: resource.config } : void 0
3833
- });
3834
- const result = await next(resource.config);
3835
- const duration = Date.now() - start;
3836
- const resourceCompleteMessage = `Resource ${String(
3837
- resource.definition.id
3838
- )} initialized in ${duration}ms`;
3839
- const shouldShowResult = debugConfig2.logResourceValue && result !== void 0;
3840
- await logger.info(resourceCompleteMessage, {
3841
- data: shouldShowResult ? { result } : void 0
3842
- });
3843
- return result;
3844
- }, "run"),
3845
- meta: {
3846
- title: "Execution Tracker",
3847
- description: "Tracks the execution of tasks and resources."
3848
- },
3849
- tags: [globalTags.system]
3850
- });
3851
-
3852
- // src/globals/resources/debug/middleware.hook.ts
3853
- var id = "globals.debug.resources.middlewareInterceptor";
3854
- var middlewareInterceptorResource = defineResource({
3855
- id,
3856
- meta: {
3857
- title: "Middleware Interceptor",
3858
- description: "Intercepts task and resource middleware, skipping system-tagged entities."
3859
- },
3860
- tags: [globalTags.system],
3861
- dependencies: {
3862
- logger: globalResources.logger,
3863
- debugConfig,
3864
- middlewareManager: globalResources.middlewareManager
3865
- },
3866
- init: /* @__PURE__ */ __name(async (event, deps) => {
3867
- const { logger, debugConfig: debugConfig2, middlewareManager } = deps;
3868
- middlewareManager.intercept(
3869
- "task",
3870
- async (next, input) => {
3871
- const taskDef = input.task.definition;
3872
- if (!hasSystemTag(taskDef)) {
3873
- const cfg = getConfig(debugConfig2, event);
3874
- if (cfg.logMiddlewareBeforeRun) {
3875
- const msg = `Middleware triggered for task ${String(taskDef.id)}`;
3876
- await logger.info(msg, {
3877
- source: id
3878
- });
3879
- }
3880
- }
3881
- const result = await next(input);
3882
- if (!hasSystemTag(taskDef)) {
3883
- const cfg = getConfig(debugConfig2, event);
3884
- if (cfg.logMiddlewareAfterRun) {
3885
- const msg = `Middleware completed for task ${String(taskDef.id)}`;
3886
- await logger.info(msg, {
3887
- source: id
3888
- });
3889
- }
3890
- }
3891
- return result;
3892
- }
3893
- );
3894
- middlewareManager.intercept(
3895
- "resource",
3896
- async (next, input) => {
3897
- const resourceDef = input.resource.definition;
3898
- if (!hasSystemTag(resourceDef)) {
3899
- const cfg = getConfig(debugConfig2, event);
3900
- if (cfg.logMiddlewareBeforeRun) {
3901
- const msg = `Middleware triggered for resource ${String(
3902
- resourceDef.id
3903
- )}`;
3904
- await logger.info(msg, {
3905
- source: id
3906
- });
3907
- }
3908
- }
3909
- const result = await next(input);
3910
- if (!hasSystemTag(resourceDef)) {
3911
- const cfg = getConfig(debugConfig2, event);
3912
- if (cfg.logMiddlewareAfterRun) {
3913
- const msg = `Middleware completed for resource ${String(
3914
- resourceDef.id
3915
- )}`;
3916
- await logger.info(msg, {
3917
- source: id
3918
- });
3919
- }
3920
- }
3921
- return result;
3922
- }
3923
- );
3924
- }, "init")
3925
- });
3926
-
3927
- // src/globals/resources/debug/hook.hook.ts
3928
- var hookInterceptorResource = defineResource({
3929
- id: "globals.debug.resources.hookInterceptor",
3930
- meta: {
3931
- title: "Hook Interceptor",
3932
- description: "Intercepts hooks for debug logging, skipping system-tagged hooks."
3933
- },
3934
- tags: [globalTags.system],
3935
- dependencies: {
3936
- logger: globalResources.logger,
3937
- debugConfig,
3938
- eventManager: globalResources.eventManager
3939
- },
3940
- init: /* @__PURE__ */ __name(async (event, deps) => {
3941
- deps.eventManager.interceptHook(async (next, hook, event2) => {
3942
- const { logger, debugConfig: debugConfig2 } = deps;
3943
- if (hasSystemTag(hook)) {
3944
- return await next(hook, event2);
3945
- }
3946
- const resolved = getConfig(debugConfig2, event2);
3947
- if (resolved.logHookTriggered) {
3948
- const hookId = hook.id;
3949
- let logString = `Hook triggered for ${String(hookId)}`;
3950
- await logger.info(logString, {
3951
- source: "globals.debug.resources.hookInterceptor"
3952
- });
3953
- }
3954
- await next(hook, event2);
3955
- if (resolved.logHookCompleted) {
3956
- const hookId = hook.id;
3957
- let logString = `Hook completed for ${String(hookId)}`;
3958
- await logger.info(logString, {
3959
- source: "globals.debug.resources.hookInterceptor"
3960
- });
3961
- }
3962
- });
3963
- }, "init")
3964
- });
3965
-
3966
- // src/globals/resources/debug/debug.resource.ts
3967
- var debugResource = defineResource({
3968
- id: "globals.resources.debug",
3969
- register: /* @__PURE__ */ __name((config) => {
3970
- return [
3971
- debugConfig.with(config),
3972
- globalEventListener,
3973
- middlewareInterceptorResource,
3974
- hookInterceptorResource,
3975
- tasksTrackerMiddleware,
3976
- resourcesTrackerMiddleware
3977
- ];
3978
- }, "register"),
3979
- meta: {
3980
- title: "Debug",
3981
- description: "Debug resource. This is used to debug the system."
3982
- },
3983
- tags: [globalTags.system]
3984
- });
3985
-
3986
- // src/processHooks.ts
3987
- var platform2 = getPlatform();
3988
- var activeErrorHandlers = /* @__PURE__ */ new Set();
3989
- var processSafetyNetsInstalled = false;
3990
- function installGlobalProcessSafetyNetsOnce() {
3991
- if (processSafetyNetsInstalled) return;
3992
- processSafetyNetsInstalled = true;
3993
- const onUncaughtException = /* @__PURE__ */ __name(async (err) => {
3994
- for (const handler of activeErrorHandlers) {
3995
- try {
3996
- await handler(err, "uncaughtException");
3997
- } catch (_) {
3998
- }
3999
- }
4000
- }, "onUncaughtException");
4001
- const onUnhandledRejection = /* @__PURE__ */ __name(async (reason) => {
4002
- for (const handler of activeErrorHandlers) {
4003
- try {
4004
- await handler(reason, "unhandledRejection");
4005
- } catch (_) {
4006
- }
4007
- }
4008
- }, "onUnhandledRejection");
4009
- platform2.onUncaughtException(onUncaughtException);
4010
- platform2.onUnhandledRejection(onUnhandledRejection);
4011
- }
4012
- __name(installGlobalProcessSafetyNetsOnce, "installGlobalProcessSafetyNetsOnce");
4013
- function registerProcessLevelSafetyNets(handler) {
4014
- installGlobalProcessSafetyNetsOnce();
4015
- activeErrorHandlers.add(handler);
4016
- return () => {
4017
- activeErrorHandlers.delete(handler);
4018
- };
4019
- }
4020
- __name(registerProcessLevelSafetyNets, "registerProcessLevelSafetyNets");
4021
- var activeDisposers = /* @__PURE__ */ new Set();
4022
- var shutdownHooksInstalled = false;
4023
- function installGlobalShutdownHooksOnce() {
4024
- if (shutdownHooksInstalled) return;
4025
- shutdownHooksInstalled = true;
4026
- const handler = /* @__PURE__ */ __name(async () => {
4027
- try {
4028
- const disposers = Array.from(activeDisposers);
4029
- for (const d of disposers) {
4030
- try {
4031
- await d();
4032
- } catch {
4033
- }
4034
- activeDisposers.delete(d);
4035
- }
4036
- } finally {
4037
- try {
4038
- platform2.exit(0);
4039
- } catch (e) {
4040
- if (!(e instanceof PlatformUnsupportedFunction)) {
4041
- throw e;
4042
- }
4043
- }
4044
- }
4045
- }, "handler");
4046
- platform2.onShutdownSignal(handler);
4047
- }
4048
- __name(installGlobalShutdownHooksOnce, "installGlobalShutdownHooksOnce");
4049
- function registerShutdownHook(disposeOnce) {
4050
- installGlobalShutdownHooksOnce();
4051
- activeDisposers.add(disposeOnce);
4052
- return () => {
4053
- activeDisposers.delete(disposeOnce);
4054
- };
4055
- }
4056
- __name(registerShutdownHook, "registerShutdownHook");
4057
-
4058
- // src/models/UnhandledError.ts
4059
- function createDefaultUnhandledError(logger) {
4060
- return async ({ error, kind, source }) => {
4061
- const normalizedError = error instanceof Error ? error : new Error(String(error));
4062
- await logger.error(`${normalizedError.toString()}`, {
4063
- source,
4064
- error: normalizedError,
4065
- data: {
4066
- kind
4067
- }
4068
- });
4069
- };
4070
- }
4071
- __name(createDefaultUnhandledError, "createDefaultUnhandledError");
4072
- function bindProcessErrorHandler(handler) {
4073
- return async (error, source) => {
4074
- try {
4075
- await handler({ error, kind: "process", source });
4076
- } catch {
4077
- }
4078
- };
4079
- }
4080
- __name(bindProcessErrorHandler, "bindProcessErrorHandler");
4081
- async function safeReportUnhandledError(handler, info) {
4082
- try {
4083
- await handler(info);
4084
- } catch {
4085
- }
4086
- }
4087
- __name(safeReportUnhandledError, "safeReportUnhandledError");
4088
-
4089
- // src/models/RunResult.ts
4090
- var RunResult = class {
4091
- constructor(value, logger, store2, eventManager, taskRunner, disposeFn) {
4092
- this.value = value;
4093
- this.logger = logger;
4094
- this.store = store2;
4095
- this.eventManager = eventManager;
4096
- this.taskRunner = taskRunner;
4097
- this.disposeFn = disposeFn;
4098
- /**
4099
- * Run a task within the context of the run result.
4100
- * @param task - The task to run.
4101
- * @param args - The arguments to pass to the task.
4102
- * @returns The result of the task.
4103
- */
4104
- this.runTask = /* @__PURE__ */ __name((task, ...args) => {
4105
- if (typeof task === "string") {
4106
- const taskId = task;
4107
- if (!this.store.tasks.has(taskId)) {
4108
- throw new RuntimeError(`Task "${taskId}" not found.`);
4109
- }
4110
- task = this.store.tasks.get(taskId).task;
4111
- }
4112
- return this.taskRunner.run(task, ...args);
4113
- }, "runTask");
4114
- /**
4115
- * Emit an event within the context of the run result.
4116
- * @param event - The event to emit.
4117
- * @param payload - The payload to emit.
4118
- */
4119
- this.emitEvent = /* @__PURE__ */ __name((event, payload) => {
4120
- if (typeof event === "string") {
4121
- const eventId = event;
4122
- if (!this.store.events.has(eventId)) {
4123
- throw new RuntimeError(`Event "${eventId}" not found.`);
4124
- }
4125
- event = this.store.events.get(eventId).event;
4126
- }
4127
- return this.eventManager.emit(event, payload, "outside");
4128
- }, "emitEvent");
4129
- /**
4130
- * Get the value of a resource from the run result.
4131
- * @param resource - The resource to get the value of.
4132
- * @returns The value of the resource.
4133
- */
4134
- this.getResourceValue = /* @__PURE__ */ __name((resource) => {
4135
- const resourceId = typeof resource === "string" ? resource : resource.id;
4136
- if (!this.store.resources.has(resourceId)) {
4137
- throw new ResourceNotFoundError(resourceId);
4138
- }
4139
- return this.store.resources.get(resourceId).value;
4140
- }, "getResourceValue");
4141
- this.dispose = /* @__PURE__ */ __name(() => {
4142
- return this.disposeFn();
4143
- }, "dispose");
4144
- }
4145
- static {
4146
- __name(this, "RunResult");
4147
- }
4148
- };
4149
-
4150
- // src/run.ts
4151
- async function run(resourceOrResourceWithConfig, options) {
4152
- await getPlatform().init();
4153
- const {
4154
- debug = void 0,
4155
- logs = {},
4156
- errorBoundary = true,
4157
- shutdownHooks = true,
4158
- dryRun = false,
4159
- onUnhandledError: onUnhandledErrorOpt,
4160
- runtimeCycleDetection = true
4161
- } = options || {};
4162
- const {
4163
- printThreshold = getPlatform().getEnv("NODE_ENV") === "test" ? null : "info",
4164
- printStrategy = "pretty",
4165
- bufferLogs = false
4166
- } = logs;
4167
- const eventManager = new EventManager({
4168
- runtimeCycleDetection
4169
- });
4170
- let { resource, config } = extractResourceAndConfig(
4171
- resourceOrResourceWithConfig
4172
- );
4173
- const logger = new Logger({
4174
- printThreshold,
4175
- printStrategy,
4176
- bufferLogs
4177
- });
4178
- const onUnhandledError = onUnhandledErrorOpt || createDefaultUnhandledError(logger);
4179
- const store2 = new Store(eventManager, logger, onUnhandledError);
4180
- const taskRunner = new TaskRunner(store2, eventManager, logger);
4181
- store2.setTaskRunner(taskRunner);
4182
- let unhookProcessSafetyNets;
4183
- if (errorBoundary) {
4184
- unhookProcessSafetyNets = registerProcessLevelSafetyNets(
4185
- bindProcessErrorHandler(onUnhandledError)
4186
- );
4187
- }
4188
- const processor = new DependencyProcessor(
4189
- store2,
4190
- eventManager,
4191
- taskRunner,
4192
- logger
4193
- );
4194
- let unhookShutdown;
4195
- const disposeAll = /* @__PURE__ */ __name(async () => {
4196
- try {
4197
- if (unhookProcessSafetyNets) {
4198
- unhookProcessSafetyNets();
4199
- unhookProcessSafetyNets = void 0;
4200
- }
4201
- if (unhookShutdown) {
4202
- unhookShutdown();
4203
- unhookShutdown = void 0;
4204
- }
4205
- } finally {
4206
- await store2.dispose();
4207
- }
4208
- }, "disposeAll");
4209
- try {
4210
- if (debug) {
4211
- store2.storeGenericItem(debugResource.with(debug));
4212
- }
4213
- store2.initializeStore(resource, config);
4214
- await store2.processOverrides();
4215
- store2.validateDependencyGraph();
4216
- store2.validateEventEmissionGraph();
4217
- const boundedLogger = logger.with({ source: "run" });
4218
- if (dryRun) {
4219
- await boundedLogger.debug("Dry run mode. Skipping initialization...");
4220
- return new RunResult(
4221
- store2.root.value,
4222
- logger,
4223
- store2,
4224
- eventManager,
4225
- taskRunner,
4226
- disposeAll
4227
- );
4228
- }
4229
- await boundedLogger.debug("Events stored. Attaching listeners...");
4230
- await processor.attachListeners();
4231
- await boundedLogger.debug("Listeners attached. Computing dependencies...");
4232
- await processor.computeAllDependencies();
4233
- await boundedLogger.debug(
4234
- "Dependencies computed. Proceeding with initialization..."
4235
- );
4236
- await processor.initializeRoot();
4237
- store2.lock();
4238
- eventManager.lock();
4239
- await logger.lock();
4240
- await eventManager.emit(globalEvents.ready, void 0, "run");
4241
- await boundedLogger.info("Runner online. Awaiting tasks and events.");
4242
- if (shutdownHooks) {
4243
- unhookShutdown = registerShutdownHook(() => store2.dispose());
4244
- }
4245
- return new RunResult(
4246
- store2.root.value,
4247
- logger,
4248
- store2,
4249
- eventManager,
4250
- taskRunner,
4251
- disposeAll
4252
- );
4253
- } catch (err) {
4254
- await disposeAll();
4255
- throw err;
4256
- }
4257
- }
4258
- __name(run, "run");
4259
- function extractResourceAndConfig(resourceOrResourceWithConfig) {
4260
- let resource;
4261
- let config;
4262
- if (isResourceWithConfig(resourceOrResourceWithConfig)) {
4263
- resource = resourceOrResourceWithConfig.resource;
4264
- config = resourceOrResourceWithConfig.config;
4265
- } else {
4266
- resource = resourceOrResourceWithConfig;
4267
- config = void 0;
4268
- }
4269
- return { resource, config };
4270
- }
4271
- __name(extractResourceAndConfig, "extractResourceAndConfig");
4272
-
4273
- // src/testing.ts
4274
- var testResourceCounter = 0;
4275
- function createTestResource(root, options) {
4276
- return defineResource({
4277
- id: `testing.${root.id}.${++testResourceCounter}`,
4278
- register: [root],
4279
- overrides: options?.overrides || [],
4280
- dependencies: {
4281
- taskRunner: globalResources.taskRunner,
4282
- store: globalResources.store,
4283
- logger: globalResources.logger,
4284
- eventManager: globalResources.eventManager
4285
- },
4286
- async init(_, deps) {
4287
- return buildTestFacade(deps);
4288
- }
4289
- });
4290
- }
4291
- __name(createTestResource, "createTestResource");
4292
- function buildTestFacade(deps) {
4293
- return {
4294
- // Run a task within the fully initialized ecosystem
4295
- runTask: /* @__PURE__ */ __name((task, ...args) => deps.taskRunner.run(task, ...args), "runTask"),
4296
- // Access a resource value by id (string or symbol)
4297
- getResource: /* @__PURE__ */ __name((id2) => deps.store.resources.get(id2)?.value, "getResource"),
4298
- // Expose internals when needed in tests (not recommended for app usage)
4299
- taskRunner: deps.taskRunner,
4300
- store: deps.store,
4301
- logger: deps.logger,
4302
- eventManager: deps.eventManager
4303
- };
4304
- }
4305
- __name(buildTestFacade, "buildTestFacade");
4306
-
4307
- // src/models/Semaphore.ts
4308
- var Semaphore = class {
4309
- constructor(maxPermits) {
4310
- this.waitingQueue = [];
4311
- this.disposed = false;
4312
- if (maxPermits <= 0) {
4313
- throw new Error("maxPermits must be greater than 0");
4314
- }
4315
- this.permits = maxPermits;
4316
- this.maxPermits = maxPermits;
4317
- }
4318
- static {
4319
- __name(this, "Semaphore");
4320
- }
4321
- /**
4322
- * Acquire a permit. If no permits are available, waits until one becomes available.
4323
- */
4324
- async acquire(options) {
4325
- if (this.disposed) {
4326
- throw new Error("Semaphore has been disposed");
4327
- }
4328
- if (options?.signal?.aborted) {
4329
- throw new Error("Operation was aborted");
4330
- }
4331
- if (this.permits > 0) {
4332
- this.permits--;
4333
- return;
4334
- }
4335
- return new Promise((resolve, reject) => {
4336
- const operation = { resolve, reject };
4337
- if (options?.timeout && options.timeout > 0) {
4338
- operation.timeout = setTimeout(() => {
4339
- this.removeFromQueue(operation);
4340
- reject(
4341
- new Error(`Semaphore acquire timeout after ${options.timeout}ms`)
4342
- );
4343
- }, options.timeout);
4344
- }
4345
- if (options?.signal) {
4346
- const abortHandler = /* @__PURE__ */ __name(() => {
4347
- this.removeFromQueue(operation);
4348
- reject(new Error("Operation was aborted"));
4349
- }, "abortHandler");
4350
- options.signal.addEventListener("abort", abortHandler, { once: true });
4351
- const originalResolve = operation.resolve;
4352
- const originalReject = operation.reject;
4353
- operation.resolve = () => {
4354
- options.signal.removeEventListener("abort", abortHandler);
4355
- originalResolve();
4356
- };
4357
- operation.reject = (error) => {
4358
- options.signal.removeEventListener("abort", abortHandler);
4359
- originalReject(error);
4360
- };
4361
- }
4362
- this.waitingQueue.push(operation);
4363
- });
4364
- }
4365
- /**
4366
- * Release a permit, allowing waiting operations to proceed.
4367
- */
4368
- release() {
4369
- if (this.disposed) {
4370
- return;
4371
- }
4372
- if (this.waitingQueue.length > 0) {
4373
- const nextOperation = this.waitingQueue.shift();
4374
- if (nextOperation.timeout) {
4375
- clearTimeout(nextOperation.timeout);
4376
- }
4377
- nextOperation.resolve();
4378
- } else {
4379
- this.permits = Math.min(this.permits + 1, this.maxPermits);
4380
- }
4381
- }
4382
- removeFromQueue(operation) {
4383
- const index = this.waitingQueue.indexOf(operation);
4384
- if (index !== -1) {
4385
- this.waitingQueue.splice(index, 1);
4386
- if (operation.timeout) {
4387
- clearTimeout(operation.timeout);
4388
- }
4389
- }
4390
- }
4391
- /**
4392
- * Execute a function with a permit, automatically releasing it afterwards.
4393
- */
4394
- async withPermit(fn, options) {
4395
- await this.acquire(options);
4396
- try {
4397
- return await fn();
4398
- } finally {
4399
- this.release();
4400
- }
4401
- }
4402
- /**
4403
- * Dispose the semaphore, rejecting all waiting operations and preventing new ones.
4404
- */
4405
- dispose() {
4406
- if (this.disposed) {
4407
- return;
4408
- }
4409
- this.disposed = true;
4410
- while (this.waitingQueue.length > 0) {
4411
- const operation = this.waitingQueue.shift();
4412
- if (operation.timeout) {
4413
- clearTimeout(operation.timeout);
4414
- }
4415
- operation.reject(new Error("Semaphore has been disposed"));
4416
- }
4417
- }
4418
- /**
4419
- * Get current number of available permits (for debugging)
4420
- */
4421
- getAvailablePermits() {
4422
- return this.permits;
4423
- }
4424
- /**
4425
- * Get current number of waiting operations (for debugging)
4426
- */
4427
- getWaitingCount() {
4428
- return this.waitingQueue.length;
4429
- }
4430
- /**
4431
- * Get maximum number of permits
4432
- */
4433
- getMaxPermits() {
4434
- return this.maxPermits;
4435
- }
4436
- /**
4437
- * Check if the semaphore has been disposed
4438
- */
4439
- isDisposed() {
4440
- return this.disposed;
4441
- }
4442
- /**
4443
- * Get metrics about the current state of the semaphore
4444
- */
4445
- getMetrics() {
4446
- return {
4447
- availablePermits: this.permits,
4448
- waitingCount: this.waitingQueue.length,
4449
- maxPermits: this.maxPermits,
4450
- utilization: (this.maxPermits - this.permits) / this.maxPermits,
4451
- disposed: this.disposed
4452
- };
4453
- }
4454
- };
4455
-
4456
- // src/index.ts
4457
- var globals = {
4458
- events: globalEvents,
4459
- resources: globalResources,
4460
- middleware: globalMiddlewares,
4461
- tags: globalTags
4462
- };
4463
-
4464
- export { DependencyProcessor, errors_exports as Errors, EventManager, Logger, MiddlewareManager, Queue, ResourceInitializer, RunResult, Semaphore, Store, TaskRunner, allFalse, bindProcessErrorHandler, createContext, createDefaultUnhandledError, createTestResource, defs_exports as definitions, defineEvent as event, getConfig, globals, defineHook as hook, levelNormal, levelVerbose, defineOverride as override, defineResource as resource, defineResourceMiddleware as resourceMiddleware, run, safeReportUnhandledError, defineTag as tag, defineTask as task, defineTaskMiddleware as taskMiddleware };
4465
- //# sourceMappingURL=index.mjs.map
4466
- //# sourceMappingURL=index.mjs.map