@bluelibs/runner 4.8.6 → 4.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (173) hide show
  1. package/AI.md +8 -0
  2. package/README.md +39 -4
  3. package/dist/browser/index.cjs +543 -418
  4. package/dist/browser/index.cjs.map +1 -1
  5. package/dist/browser/index.d.mts +2221 -0
  6. package/dist/browser/index.d.ts +2221 -0
  7. package/dist/browser/index.mjs +543 -418
  8. package/dist/browser/index.mjs.map +1 -1
  9. package/dist/edge/index.cjs +543 -418
  10. package/dist/edge/index.cjs.map +1 -1
  11. package/dist/edge/index.d.mts +2221 -0
  12. package/dist/edge/index.d.ts +2221 -0
  13. package/dist/edge/index.mjs +543 -418
  14. package/dist/edge/index.mjs.map +1 -1
  15. package/dist/node/node.cjs +584 -436
  16. package/dist/node/node.cjs.map +1 -1
  17. package/dist/node/node.d.mts +2472 -0
  18. package/dist/node/node.d.ts +2425 -55
  19. package/dist/node/node.mjs +584 -436
  20. package/dist/node/node.mjs.map +1 -1
  21. package/dist/universal/index.cjs +541 -418
  22. package/dist/universal/index.cjs.map +1 -1
  23. package/dist/universal/index.d.mts +2221 -0
  24. package/dist/universal/index.d.ts +2221 -0
  25. package/dist/universal/index.mjs +541 -418
  26. package/dist/universal/index.mjs.map +1 -1
  27. package/package.json +5 -5
  28. package/dist/define.d.ts +0 -9
  29. package/dist/definers/builders/asyncContext.d.ts +0 -13
  30. package/dist/definers/builders/core.d.ts +0 -30
  31. package/dist/definers/builders/error.d.ts +0 -15
  32. package/dist/definers/builders/event.d.ts +0 -12
  33. package/dist/definers/builders/hook.d.ts +0 -20
  34. package/dist/definers/builders/middleware.d.ts +0 -39
  35. package/dist/definers/builders/resource.d.ts +0 -40
  36. package/dist/definers/builders/tag.d.ts +0 -10
  37. package/dist/definers/builders/task.d.ts +0 -37
  38. package/dist/definers/builders/task.phantom.d.ts +0 -27
  39. package/dist/definers/builders/utils.d.ts +0 -4
  40. package/dist/definers/defineAsyncContext.d.ts +0 -15
  41. package/dist/definers/defineError.d.ts +0 -26
  42. package/dist/definers/defineEvent.d.ts +0 -2
  43. package/dist/definers/defineHook.d.ts +0 -6
  44. package/dist/definers/defineOverride.d.ts +0 -17
  45. package/dist/definers/defineResource.d.ts +0 -2
  46. package/dist/definers/defineResourceMiddleware.d.ts +0 -2
  47. package/dist/definers/defineTag.d.ts +0 -12
  48. package/dist/definers/defineTask.d.ts +0 -18
  49. package/dist/definers/defineTaskMiddleware.d.ts +0 -2
  50. package/dist/definers/tools.d.ts +0 -53
  51. package/dist/defs.d.ts +0 -31
  52. package/dist/errors.d.ts +0 -62
  53. package/dist/globals/debug.d.ts +0 -10
  54. package/dist/globals/globalEvents.d.ts +0 -8
  55. package/dist/globals/globalMiddleware.d.ts +0 -31
  56. package/dist/globals/globalResources.d.ts +0 -41
  57. package/dist/globals/globalTags.d.ts +0 -11
  58. package/dist/globals/middleware/cache.middleware.d.ts +0 -27
  59. package/dist/globals/middleware/requireContext.middleware.d.ts +0 -6
  60. package/dist/globals/middleware/retry.middleware.d.ts +0 -21
  61. package/dist/globals/middleware/timeout.middleware.d.ts +0 -9
  62. package/dist/globals/middleware/tunnel.middleware.d.ts +0 -2
  63. package/dist/globals/resources/debug/debug.resource.d.ts +0 -7
  64. package/dist/globals/resources/debug/debug.tag.d.ts +0 -2
  65. package/dist/globals/resources/debug/debugConfig.resource.d.ts +0 -22
  66. package/dist/globals/resources/debug/executionTracker.middleware.d.ts +0 -50
  67. package/dist/globals/resources/debug/globalEvent.hook.d.ts +0 -27
  68. package/dist/globals/resources/debug/hook.hook.d.ts +0 -30
  69. package/dist/globals/resources/debug/index.d.ts +0 -6
  70. package/dist/globals/resources/debug/middleware.hook.d.ts +0 -30
  71. package/dist/globals/resources/debug/types.d.ts +0 -25
  72. package/dist/globals/resources/debug/utils.d.ts +0 -2
  73. package/dist/globals/resources/httpClientFactory.resource.d.ts +0 -28
  74. package/dist/globals/resources/queue.resource.d.ts +0 -10
  75. package/dist/globals/resources/tunnel/ejson-extensions.d.ts +0 -1
  76. package/dist/globals/resources/tunnel/error-utils.d.ts +0 -1
  77. package/dist/globals/resources/tunnel/plan.d.ts +0 -19
  78. package/dist/globals/resources/tunnel/protocol.d.ts +0 -47
  79. package/dist/globals/resources/tunnel/serializer.d.ts +0 -9
  80. package/dist/globals/resources/tunnel/tunnel.policy.tag.d.ts +0 -18
  81. package/dist/globals/resources/tunnel/tunnel.tag.d.ts +0 -2
  82. package/dist/globals/resources/tunnel/types.d.ts +0 -42
  83. package/dist/globals/tunnels/index.d.ts +0 -23
  84. package/dist/globals/types.d.ts +0 -4
  85. package/dist/http-client.d.ts +0 -25
  86. package/dist/http-fetch-tunnel.resource.d.ts +0 -11
  87. package/dist/index.d.ts +0 -117
  88. package/dist/models/DependencyProcessor.d.ts +0 -48
  89. package/dist/models/EventManager.d.ts +0 -153
  90. package/dist/models/LogPrinter.d.ts +0 -55
  91. package/dist/models/Logger.d.ts +0 -85
  92. package/dist/models/MiddlewareManager.d.ts +0 -75
  93. package/dist/models/OverrideManager.d.ts +0 -13
  94. package/dist/models/Queue.d.ts +0 -26
  95. package/dist/models/ResourceInitializer.d.ts +0 -20
  96. package/dist/models/RunResult.d.ts +0 -35
  97. package/dist/models/Semaphore.d.ts +0 -61
  98. package/dist/models/Store.d.ts +0 -73
  99. package/dist/models/StoreRegistry.d.ts +0 -49
  100. package/dist/models/StoreValidator.d.ts +0 -8
  101. package/dist/models/TaskRunner.d.ts +0 -27
  102. package/dist/models/UnhandledError.d.ts +0 -11
  103. package/dist/models/index.d.ts +0 -11
  104. package/dist/models/middleware/InterceptorRegistry.d.ts +0 -56
  105. package/dist/models/middleware/MiddlewareResolver.d.ts +0 -31
  106. package/dist/models/middleware/ResourceMiddlewareComposer.d.ts +0 -34
  107. package/dist/models/middleware/TaskMiddlewareComposer.d.ts +0 -43
  108. package/dist/models/middleware/ValidationHelper.d.ts +0 -20
  109. package/dist/models/middleware/index.d.ts +0 -6
  110. package/dist/models/middleware/types.d.ts +0 -10
  111. package/dist/models/utils/findCircularDependencies.d.ts +0 -16
  112. package/dist/models/utils/safeStringify.d.ts +0 -3
  113. package/dist/node/exposure/allowList.d.ts +0 -3
  114. package/dist/node/exposure/authenticator.d.ts +0 -6
  115. package/dist/node/exposure/cors.d.ts +0 -4
  116. package/dist/node/exposure/createNodeExposure.d.ts +0 -2
  117. package/dist/node/exposure/exposureServer.d.ts +0 -18
  118. package/dist/node/exposure/httpResponse.d.ts +0 -10
  119. package/dist/node/exposure/logging.d.ts +0 -4
  120. package/dist/node/exposure/multipart.d.ts +0 -27
  121. package/dist/node/exposure/requestBody.d.ts +0 -11
  122. package/dist/node/exposure/requestContext.d.ts +0 -17
  123. package/dist/node/exposure/requestHandlers.d.ts +0 -24
  124. package/dist/node/exposure/resourceTypes.d.ts +0 -60
  125. package/dist/node/exposure/router.d.ts +0 -17
  126. package/dist/node/exposure/serverLifecycle.d.ts +0 -13
  127. package/dist/node/exposure/types.d.ts +0 -31
  128. package/dist/node/exposure/utils.d.ts +0 -17
  129. package/dist/node/exposure.resource.d.ts +0 -12
  130. package/dist/node/files.d.ts +0 -9
  131. package/dist/node/http-mixed-client.d.ts +0 -30
  132. package/dist/node/http-smart-client.model.d.ts +0 -24
  133. package/dist/node/index.d.ts +0 -1
  134. package/dist/node/inputFile.model.d.ts +0 -22
  135. package/dist/node/inputFile.utils.d.ts +0 -14
  136. package/dist/node/platform/createFile.d.ts +0 -9
  137. package/dist/node/resources/http-mixed-client.factory.resource.d.ts +0 -17
  138. package/dist/node/resources/http-smart-client.factory.resource.d.ts +0 -16
  139. package/dist/node/tunnel.allowlist.d.ts +0 -7
  140. package/dist/node/upload/manifest.d.ts +0 -22
  141. package/dist/platform/adapters/browser.d.ts +0 -14
  142. package/dist/platform/adapters/edge.d.ts +0 -5
  143. package/dist/platform/adapters/node-als.d.ts +0 -1
  144. package/dist/platform/adapters/node.d.ts +0 -15
  145. package/dist/platform/adapters/universal-generic.d.ts +0 -14
  146. package/dist/platform/adapters/universal.d.ts +0 -17
  147. package/dist/platform/createFile.d.ts +0 -10
  148. package/dist/platform/createWebFile.d.ts +0 -11
  149. package/dist/platform/factory.d.ts +0 -2
  150. package/dist/platform/index.d.ts +0 -27
  151. package/dist/platform/types.d.ts +0 -29
  152. package/dist/processHooks.d.ts +0 -2
  153. package/dist/run.d.ts +0 -14
  154. package/dist/testing.d.ts +0 -25
  155. package/dist/tools/getCallerFile.d.ts +0 -1
  156. package/dist/tunnels/buildUniversalManifest.d.ts +0 -24
  157. package/dist/types/asyncContext.d.ts +0 -41
  158. package/dist/types/contracts.d.ts +0 -63
  159. package/dist/types/error.d.ts +0 -36
  160. package/dist/types/event.d.ts +0 -74
  161. package/dist/types/hook.d.ts +0 -23
  162. package/dist/types/inputFile.d.ts +0 -34
  163. package/dist/types/meta.d.ts +0 -22
  164. package/dist/types/resource.d.ts +0 -87
  165. package/dist/types/resourceMiddleware.d.ts +0 -47
  166. package/dist/types/runner.d.ts +0 -68
  167. package/dist/types/storeTypes.d.ts +0 -40
  168. package/dist/types/symbols.d.ts +0 -32
  169. package/dist/types/tag.d.ts +0 -46
  170. package/dist/types/task.d.ts +0 -54
  171. package/dist/types/taskMiddleware.d.ts +0 -48
  172. package/dist/types/utilities.d.ts +0 -113
  173. package/dist/utils/detectRunnerMode.d.ts +0 -9
@@ -1,11 +0,0 @@
1
- import type { ExposureFetchConfig, ExposureFetchClient } from "./globals/resources/tunnel/types";
2
- export { normalizeError } from "./globals/resources/tunnel/error-utils";
3
- export type { ExposureFetchAuthConfig, ExposureFetchConfig, ExposureFetchClient, } from "./globals/resources/tunnel/types";
4
- /**
5
- * This functions communicates with the exposure server over HTTP.
6
- * It uses the @readmes/TUNNEL_HTTP_POLICY.md strategy.
7
- *
8
- * @param cfg
9
- * @returns
10
- */
11
- export declare function createExposureFetch(cfg: ExposureFetchConfig): ExposureFetchClient;
package/dist/index.d.ts DELETED
@@ -1,117 +0,0 @@
1
- import { defineTask, defineResource, defineEvent, defineTaskMiddleware, defineResourceMiddleware, defineTag, defineOverride, defineHook } from "./define";
2
- import { defineAsyncContext, createContext as oldCreateContext } from "./definers/defineAsyncContext";
3
- import { run } from "./run";
4
- import { createTestResource } from "./testing";
5
- declare const globals: {
6
- events: {
7
- readonly ready: import(".").IEvent<void>;
8
- };
9
- resources: {
10
- readonly store: import(".").IResource<void, Promise<import("./models").Store>, {}, any, any, import(".").TagType[], import(".").ResourceMiddlewareAttachmentType[]>;
11
- readonly middlewareManager: import(".").IResource<void, Promise<import("./models").MiddlewareManager>, {}, any, any, import(".").TagType[], import(".").ResourceMiddlewareAttachmentType[]>;
12
- readonly eventManager: import(".").IResource<void, Promise<import("./models").EventManager>, {}, any, any, import(".").TagType[], import(".").ResourceMiddlewareAttachmentType[]>;
13
- readonly taskRunner: import(".").IResource<void, Promise<import("./models").TaskRunner>, {}, any, any, import(".").TagType[], import(".").ResourceMiddlewareAttachmentType[]>;
14
- readonly logger: import(".").IResource<void, Promise<import("./models").Logger>, {}, any, any, import(".").TagType[], import(".").ResourceMiddlewareAttachmentType[]>;
15
- readonly serializer: import(".").IResource<void, Promise<import(".").Serializer>, {}, any, any, import(".").TagType[], import(".").ResourceMiddlewareAttachmentType[]>;
16
- readonly cache: import(".").IResource<{
17
- defaultOptions?: any;
18
- }, Promise<{
19
- map: Map<string, import(".").ICacheInstance>;
20
- cacheFactoryTask: import(".").TaskDependencyWithIntercept<any, Promise<import(".").ICacheInstance>>;
21
- defaultOptions: any;
22
- }>, {
23
- cacheFactoryTask: import(".").ITask<any, Promise<import(".").ICacheInstance>, any, any, import(".").TagType[], import(".").TaskMiddlewareAttachmentType[]>;
24
- }, any, any, import(".").TagType[], import(".").ResourceMiddlewareAttachmentType[]>;
25
- readonly queue: import(".").IResource<void, Promise<{
26
- map: Map<string, import("./models").Queue>;
27
- run: <T>(id: string, task: (signal: AbortSignal) => Promise<T>) => Promise<T>;
28
- }>, {}, {
29
- map: Map<string, import("./models").Queue>;
30
- }, {
31
- title: string;
32
- description: string;
33
- }, import(".").TagType[], import(".").ResourceMiddlewareAttachmentType[]>;
34
- readonly httpClientFactory: import(".").IResource<void, Promise<import(".").HttpClientFactory>, {
35
- serializer: import(".").IResource<void, Promise<import(".").Serializer>, {}, any, any, import(".").TagType[], import(".").ResourceMiddlewareAttachmentType[]>;
36
- store: import(".").IResource<void, Promise<import("./models").Store>, {}, any, any, import(".").TagType[], import(".").ResourceMiddlewareAttachmentType[]>;
37
- }, any, {
38
- title: string;
39
- description: string;
40
- }, import(".").TagType[], import(".").ResourceMiddlewareAttachmentType[]>;
41
- };
42
- middleware: {
43
- requireContext: import(".").ITaskMiddleware<{
44
- context: import(".").IAsyncContext<any>;
45
- }, void, void, any>;
46
- task: {
47
- requireContext: import(".").ITaskMiddleware<{
48
- context: import(".").IAsyncContext<any>;
49
- }, void, void, any>;
50
- cache: import(".").ITaskMiddleware<any, void, void, {
51
- cache: import(".").IResource<{
52
- defaultOptions?: any;
53
- }, Promise<{
54
- map: Map<string, import(".").ICacheInstance>;
55
- cacheFactoryTask: import(".").TaskDependencyWithIntercept<any, Promise<import(".").ICacheInstance>>;
56
- defaultOptions: any;
57
- }>, {
58
- cacheFactoryTask: import(".").ITask<any, Promise<import(".").ICacheInstance>, any, any, import(".").TagType[], import(".").TaskMiddlewareAttachmentType[]>;
59
- }, any, any, import(".").TagType[], import(".").ResourceMiddlewareAttachmentType[]>;
60
- }>;
61
- retry: import(".").ITaskMiddleware<import("./globals/middleware/retry.middleware").RetryMiddlewareConfig, void, void, any>;
62
- timeout: import(".").ITaskMiddleware<import("./globals/middleware/timeout.middleware").TimeoutMiddlewareConfig, void, void, any>;
63
- };
64
- resource: {
65
- retry: import(".").IResourceMiddleware<import("./globals/middleware/retry.middleware").RetryMiddlewareConfig, void, void, any>;
66
- timeout: import(".").IResourceMiddleware<import("./globals/middleware/timeout.middleware").TimeoutMiddlewareConfig, void, void, any>;
67
- };
68
- };
69
- tags: {
70
- system: import(".").ITag<{
71
- metadata?: Record<string, any>;
72
- }, void, void>;
73
- excludeFromGlobalHooks: import(".").ITag<{
74
- metadata?: Record<string, any>;
75
- }, void, void>;
76
- debug: import(".").ITag<import(".").DebugFriendlyConfig, void, void>;
77
- tunnel: import(".").ITag<void, void, import(".").TunnelRunner>;
78
- tunnelPolicy: import(".").ITag<import("./globals/resources/tunnel/tunnel.policy.tag").TunnelTaskMiddlewarePolicyConfig, void, void>;
79
- };
80
- tunnels: Readonly<{
81
- http: Readonly<{
82
- createClient(cfg: import("./globals/tunnels").HttpCreateClientConfig): import("./http-fetch-tunnel.resource").ExposureFetchClient;
83
- }>;
84
- }>;
85
- debug: {
86
- levels: {
87
- normal: import(".").DebugConfig;
88
- verbose: import(".").DebugConfig;
89
- };
90
- };
91
- };
92
- export { globals };
93
- export { defineTask as task, defineResource as resource, defineEvent as event, defineTaskMiddleware as taskMiddleware, defineResourceMiddleware as resourceMiddleware, defineAsyncContext as asyncContext, defineTag as tag, defineOverride as override, defineHook as hook, run, createTestResource, };
94
- declare const createContext: typeof oldCreateContext;
95
- export { createContext };
96
- export declare const r: Readonly<{
97
- resource: typeof import("./definers/builders/resource").resourceBuilder;
98
- task: import("./definers/builders/task").TaskBuilderWithPhantom;
99
- event: typeof import("./definers/builders/event").eventBuilder;
100
- hook: typeof import("./definers/builders/hook").hookBuilder;
101
- tag: typeof import("./definers/builders/tag").tagBuilder;
102
- asyncContext: typeof import("./definers/builders/asyncContext").asyncContextBuilder;
103
- error: typeof import("./definers/builders/error").errorBuilder;
104
- middleware: Readonly<{
105
- task: typeof import("./definers/builders/middleware").taskMiddlewareBuilder;
106
- resource: typeof import("./definers/builders/middleware").resourceMiddlewareBuilder;
107
- }>;
108
- }>;
109
- export * as definitions from "./defs";
110
- export * from "./models";
111
- export * from "./globals/types";
112
- export * as Errors from "./errors";
113
- export { PlatformAdapter, setPlatform } from "./platform";
114
- export { EJSON } from "@bluelibs/ejson";
115
- export * from "./http-client";
116
- export * from "./http-fetch-tunnel.resource";
117
- export type * from "./defs";
@@ -1,48 +0,0 @@
1
- import { DependencyMapType, DependencyValuesType, ITask, IResource, IEvent } from "../defs";
2
- import { Store } from "./Store";
3
- import { ResourceStoreElementType } from "../types/storeTypes";
4
- import { EventManager } from "./EventManager";
5
- import { ResourceInitializer } from "./ResourceInitializer";
6
- import { TaskRunner } from "./TaskRunner";
7
- import { Logger } from "./Logger";
8
- /**
9
- * This class is responsible of setting up dependencies with their respective computedValues.
10
- * Note that all elements must have been previously registered otherwise errors will be thrown
11
- * when trying to depend on something not in the store.
12
- */
13
- export declare class DependencyProcessor {
14
- protected readonly store: Store;
15
- protected readonly eventManager: EventManager;
16
- protected readonly taskRunner: TaskRunner;
17
- protected readonly resourceInitializer: ResourceInitializer;
18
- protected readonly logger: Logger;
19
- constructor(store: Store, eventManager: EventManager, taskRunner: TaskRunner, logger: Logger);
20
- /**
21
- * This function is going to go through all the resources, tasks and middleware to compute their required dependencies.
22
- */
23
- computeAllDependencies(): Promise<void>;
24
- private computeTaskDependencies;
25
- initializeUninitializedResources(): Promise<void>;
26
- /**
27
- * Processes dependencies and hooks
28
- * @param resource
29
- */
30
- protected processResourceDependencies<TD extends DependencyMapType>(resource: ResourceStoreElementType<any, any, TD>): Promise<void>;
31
- private wrapResourceDependencies;
32
- private makeTaskWithIntercept;
33
- initializeRoot(): Promise<void>;
34
- /**
35
- * Processes all hooks, should run before emission of any event.
36
- */
37
- attachListeners(): void;
38
- extractDependencies<T extends DependencyMapType>(map: T, source: string): Promise<DependencyValuesType<T>>;
39
- extractDependency(object: any, source: string): Promise<any>;
40
- /**
41
- * Converts the event into a running functions with real inputs
42
- * @param object
43
- * @returns
44
- */
45
- extractEventDependency(object: IEvent<any>, source: string): (input: any) => Promise<void>;
46
- extractTaskDependency(object: ITask<any, any, {}>): Promise<(input: unknown) => Promise<any>>;
47
- extractResourceDependency(object: IResource<any, any, any>): Promise<any>;
48
- }
@@ -1,153 +0,0 @@
1
- import { DependencyValuesType, EventHandlerType, IEvent, IEventEmission } from "../defs";
2
- import { IHook } from "../types/hook";
3
- /**
4
- * Options for configuring event listeners
5
- */
6
- export interface IEventHandlerOptions<T = any> {
7
- order?: number;
8
- filter?: (event: IEventEmission<T>) => boolean;
9
- /**
10
- * Represents the listener ID. Use this to avoid a listener calling himself.
11
- */
12
- id?: string;
13
- }
14
- /**
15
- * Interceptor for event emissions
16
- */
17
- export type EventEmissionInterceptor = (next: (event: IEventEmission<any>) => Promise<void>, event: IEventEmission<any>) => Promise<void>;
18
- /**
19
- * Interceptor for hook execution
20
- */
21
- export type HookExecutionInterceptor = (next: (hook: IHook<any, any>, event: IEventEmission<any>) => Promise<any>, hook: IHook<any, any>, event: IEventEmission<any>) => Promise<any>;
22
- /**
23
- * EventManager handles event emission, listener registration, and event processing.
24
- * It supports both specific event listeners and global listeners that handle all events.
25
- * Listeners are processed in order based on their priority.
26
- */
27
- export declare class EventManager {
28
- #private;
29
- private listeners;
30
- private globalListeners;
31
- private cachedMergedListeners;
32
- private globalListenersCacheValid;
33
- private emissionInterceptors;
34
- private hookInterceptors;
35
- private readonly emissionStack;
36
- private readonly currentHookIdContext;
37
- private readonly runtimeCycleDetection;
38
- constructor(options?: {
39
- runtimeCycleDetection?: boolean;
40
- });
41
- /**
42
- * Gets the current lock status of the EventManager
43
- */
44
- get isLocked(): boolean;
45
- /**
46
- * Locks the EventManager, preventing any further modifications to listeners
47
- */
48
- lock(): void;
49
- /**
50
- * Emits an event to all registered listeners for that event type.
51
- * Listeners are processed in order of priority and can stop event propagation.
52
- *
53
- * @param eventDefinition - The event definition to emit
54
- * @param data - The event payload data
55
- * @param source - The source identifier of the event emitter
56
- */
57
- emit<TInput>(eventDefinition: IEvent<TInput>, data: TInput, source: string): Promise<void>;
58
- /**
59
- * Registers an event listener for specific event(s).
60
- * Listeners are ordered by priority and executed in ascending order.
61
- *
62
- * @param event - The event definition(s) to listen for
63
- * @param handler - The callback function to handle the event
64
- * @param options - Configuration options for the listener
65
- */
66
- addListener<T>(event: IEvent<T> | Array<IEvent<T>>, handler: EventHandlerType<T>, options?: IEventHandlerOptions<T>): void;
67
- /**
68
- * Registers a global event listener that handles all events.
69
- * Global listeners are mixed with specific listeners and ordered by priority.
70
- *
71
- * @param handler - The callback function to handle events
72
- * @param options - Configuration options for the listener
73
- */
74
- addGlobalListener(handler: EventHandlerType, options?: IEventHandlerOptions): void;
75
- /**
76
- * Checks if there are any listeners registered for the given event
77
- *
78
- * @param eventDefinition - The event definition to check
79
- * @returns true if listeners exist, false otherwise
80
- */
81
- hasListeners<T>(eventDefinition: IEvent<T>): boolean;
82
- /**
83
- * Adds an interceptor for all event emissions
84
- * Interceptors are executed in the order they are added, with the ability to
85
- * modify, log, or prevent event emissions
86
- *
87
- * @param interceptor - The interceptor function to add
88
- */
89
- intercept(interceptor: EventEmissionInterceptor): void;
90
- /**
91
- * Adds an interceptor for hook execution
92
- * Interceptors are executed in the order they are added, with the ability to
93
- * modify, log, or prevent hook execution
94
- *
95
- * @param interceptor - The interceptor function to add
96
- */
97
- interceptHook(interceptor: HookExecutionInterceptor): void;
98
- /**
99
- * Executes a hook with all registered hook interceptors applied
100
- * This method should be used by TaskRunner when executing hooks
101
- *
102
- * @param hook - The hook to execute
103
- * @param event - The event that triggered the hook
104
- * @param computedDependencies - The computed dependencies for the hook
105
- * @returns Promise resolving to the hook execution result
106
- */
107
- executeHookWithInterceptors(hook: IHook<any, any>, event: IEventEmission<any>, computedDependencies: DependencyValuesType<any>): Promise<any>;
108
- /**
109
- * Throws an error if the EventManager is locked
110
- */
111
- private checkLock;
112
- /**
113
- * Merges two sorted arrays of listeners while maintaining order.
114
- * Used to combine event-specific listeners with global listeners.
115
- *
116
- * @param a - First array of listeners
117
- * @param b - Second array of listeners
118
- * @returns Merged and sorted array of listeners
119
- */
120
- private mergeSortedListeners;
121
- /**
122
- * Inserts a new listener into a sorted array using binary search.
123
- * Maintains order based on listener priority.
124
- *
125
- * @param listeners - Array to insert into
126
- * @param newListener - Listener to insert
127
- */
128
- private insertListener;
129
- /**
130
- * Returns true if the given emission carries the tag that marks
131
- * it as excluded from global ("*") listeners.
132
- *
133
- * @param event - The event emission to check
134
- * @returns true if event should exclude global listeners
135
- */
136
- private isExcludedFromGlobal;
137
- /**
138
- * Retrieves cached merged listeners for an event, or creates them if not cached.
139
- * Combines event-specific listeners with global listeners and sorts them by priority.
140
- *
141
- * @param eventId - The event ID to get listeners for
142
- * @returns Array of merged listeners sorted by priority
143
- */
144
- private getCachedMergedListeners;
145
- /**
146
- * Invalidates the cached merged listeners.
147
- * If eventId is provided, only invalidates cache for that specific event.
148
- * Otherwise, invalidates the global cache.
149
- *
150
- * @param eventId - Optional specific event ID to invalidate
151
- */
152
- private invalidateCache;
153
- }
@@ -1,55 +0,0 @@
1
- export type PrintStrategy = "pretty" | "plain" | "json" | "json_pretty";
2
- export type LogLevels = "trace" | "debug" | "info" | "warn" | "error" | "critical";
3
- export interface PrintableLog {
4
- level: LogLevels;
5
- source?: string;
6
- message: any;
7
- timestamp: Date;
8
- error?: {
9
- name: string;
10
- message: string;
11
- stack?: string;
12
- };
13
- data?: Record<string, any>;
14
- context?: Record<string, any>;
15
- }
16
- export type ColorTheme = {
17
- trace: string;
18
- debug: string;
19
- info: string;
20
- warn: string;
21
- error: string;
22
- critical: string;
23
- reset: string;
24
- bold: string;
25
- dim: string;
26
- blue: string;
27
- cyan: string;
28
- gray: string;
29
- };
30
- export declare class LogPrinter {
31
- private strategy;
32
- private colors;
33
- constructor(options: {
34
- strategy: PrintStrategy;
35
- useColors: boolean;
36
- colorTheme?: Partial<ColorTheme>;
37
- });
38
- print(log: PrintableLog): void;
39
- private pickWriter;
40
- private formatTime;
41
- private formatLevel;
42
- private formatSource;
43
- private formatMessage;
44
- private formatError;
45
- private formatData;
46
- private formatContext;
47
- private normalizeForJson;
48
- private static NO_COLORS;
49
- private static writers;
50
- static setWriters(writers: Partial<{
51
- log: (msg: any) => void;
52
- error?: (msg: any) => void;
53
- }>): void;
54
- static resetWriters(): void;
55
- }
@@ -1,85 +0,0 @@
1
- import { LogPrinter, PrintStrategy as PrinterStrategy } from "./LogPrinter";
2
- export type LogLevels = "trace" | "debug" | "info" | "warn" | "error" | "critical";
3
- export interface ILogInfo {
4
- source?: string;
5
- error?: unknown | Error;
6
- data?: Record<string, any>;
7
- context?: Record<string, any>;
8
- [key: string]: any;
9
- }
10
- export interface ILog {
11
- level: LogLevels;
12
- source?: string;
13
- message: any;
14
- timestamp: Date;
15
- error?: {
16
- name: string;
17
- message: string;
18
- stack?: string;
19
- };
20
- data?: Record<string, any>;
21
- context?: Record<string, any>;
22
- }
23
- export type PrintStrategy = PrinterStrategy;
24
- export declare class Logger {
25
- private printThreshold;
26
- private printStrategy;
27
- private bufferLogs;
28
- private buffer;
29
- private boundContext;
30
- private isLocked;
31
- private useColors;
32
- private printer;
33
- private source?;
34
- private rootLogger?;
35
- localListeners: Array<(log: ILog) => void | Promise<void>>;
36
- static Severity: {
37
- trace: number;
38
- debug: number;
39
- info: number;
40
- warn: number;
41
- error: number;
42
- critical: number;
43
- };
44
- constructor(options: {
45
- printThreshold: null | LogLevels;
46
- printStrategy: PrintStrategy;
47
- bufferLogs: boolean;
48
- useColors?: boolean;
49
- }, boundContext?: Record<string, any>, source?: string, printer?: LogPrinter);
50
- private detectColorSupport;
51
- /**
52
- * Creates a new logger instance with additional bound context
53
- */
54
- with({ source, additionalContext: context, }: {
55
- source?: string;
56
- additionalContext?: Record<string, any>;
57
- }): Logger;
58
- /**
59
- * Core logging method with structured LogInfo
60
- */
61
- log(level: LogLevels, message: any, logInfo?: ILogInfo): Promise<void>;
62
- private extractErrorInfo;
63
- info(message: any, logInfo?: ILogInfo): Promise<void>;
64
- error(message: any, logInfo?: ILogInfo): Promise<void>;
65
- warn(message: any, logInfo?: ILogInfo): Promise<void>;
66
- debug(message: any, logInfo?: ILogInfo): Promise<void>;
67
- trace(message: any, logInfo?: ILogInfo): Promise<void>;
68
- critical(message: any, logInfo?: ILogInfo): Promise<void>;
69
- /**
70
- * Direct print for tests and advanced scenarios. Delegates to LogPrinter.
71
- */
72
- print(log: ILog): void;
73
- /**
74
- * @param listener - A listener that will be triggered for every log.
75
- */
76
- onLog(listener: (log: ILog) => any): void;
77
- /**
78
- * Marks the logger as ready.
79
- * This is used to trigger the local listeners and print the buffered logs (if they exists)
80
- * @returns A promise that resolves when the logger is ready.
81
- */
82
- lock(): Promise<void>;
83
- private canPrint;
84
- private triggerLogListeners;
85
- }
@@ -1,75 +0,0 @@
1
- import { DependencyMapType, ITask, IResource } from "../defs";
2
- import { EventManager } from "./EventManager";
3
- import { Store } from "./Store";
4
- import { Logger } from "./Logger";
5
- import { ITaskMiddleware, IResourceMiddleware } from "../defs";
6
- import { TaskMiddlewareInterceptor, ResourceMiddlewareInterceptor } from "./middleware/types";
7
- export type { TaskMiddlewareInterceptor, ResourceMiddlewareInterceptor };
8
- /**
9
- * Centralizes middleware composition and execution for both tasks and resources.
10
- * Keeps observability emissions and unhandled error routing consistent.
11
- *
12
- * This is a facade that delegates to specialized composer classes for maintainability.
13
- */
14
- export declare class MiddlewareManager {
15
- protected readonly store: Store;
16
- protected readonly eventManager: EventManager;
17
- protected readonly logger: Logger;
18
- private readonly interceptorRegistry;
19
- private readonly middlewareResolver;
20
- private readonly taskComposer;
21
- private readonly resourceComposer;
22
- constructor(store: Store, eventManager: EventManager, logger: Logger);
23
- /**
24
- * @internal
25
- */
26
- get taskMiddlewareInterceptors(): TaskMiddlewareInterceptor[];
27
- /**
28
- * @internal
29
- */
30
- get resourceMiddlewareInterceptors(): ResourceMiddlewareInterceptor[];
31
- /**
32
- * Gets the current lock status of the MiddlewareManager
33
- */
34
- get isLocked(): boolean;
35
- /**
36
- * Locks the MiddlewareManager, preventing any further modifications to interceptors
37
- */
38
- lock(): void;
39
- /**
40
- * Adds an interceptor for task or resource middleware execution
41
- * Interceptors are executed in the order they are added, with the ability to
42
- * modify, log, or prevent middleware execution
43
- *
44
- * @param kind - The type of middleware to intercept ("task" or "resource")
45
- * @param interceptor - The interceptor function to add
46
- */
47
- intercept(kind: "task" | "resource", interceptor: TaskMiddlewareInterceptor | ResourceMiddlewareInterceptor): void;
48
- /**
49
- * Adds an interceptor for a specific middleware instance with better type safety
50
- * This method automatically determines the type and provides type-safe access
51
- *
52
- * @param middleware - The middleware instance to intercept
53
- * @param interceptor - The interceptor function with proper typing
54
- */
55
- interceptMiddleware(middleware: ITaskMiddleware<any, any, any, any> | IResourceMiddleware<any, any, any, any>, interceptor: TaskMiddlewareInterceptor | ResourceMiddlewareInterceptor): void;
56
- /**
57
- * Compose a runner for a task with its local interceptors and applicable middlewares.
58
- * Returns a function that accepts the task input and resolves to the task output.
59
- */
60
- composeTaskRunner<TInput, TOutput extends Promise<any>, TDeps extends DependencyMapType>(task: ITask<TInput, TOutput, TDeps>): (input: TInput) => Promise<Awaited<TOutput>>;
61
- /**
62
- * Run a resource init wrapped with its applicable middlewares.
63
- */
64
- runResourceInit<C, V extends Promise<any>, D extends DependencyMapType, TContext>(resource: IResource<C, V, D, TContext>, config: C, dependencies: any, context: TContext): Promise<V | undefined>;
65
- /**
66
- * Gets all "everywhere" middlewares that apply to the given task
67
- * @deprecated Internal method exposed for testing - may be removed in future versions
68
- */
69
- getEverywhereMiddlewareForTasks(task: ITask<any, any, any>): ITaskMiddleware[];
70
- /**
71
- * Gets all "everywhere" middlewares that apply to the given resource
72
- * @deprecated Internal method exposed for testing - may be removed in future versions
73
- */
74
- getEverywhereMiddlewareForResources(resource: IResource<any, any, any, any>): IResourceMiddleware[];
75
- }
@@ -1,13 +0,0 @@
1
- import { IResource, ITaskMiddleware, IResourceMiddleware, ITask, IResourceWithConfig, RegisterableItems, IHook } from "../defs";
2
- import { StoreRegistry } from "./StoreRegistry";
3
- export declare class OverrideManager {
4
- private readonly registry;
5
- overrides: Map<string, IResource | ITaskMiddleware | IResourceMiddleware | ITask | IResourceWithConfig | IHook>;
6
- overrideRequests: Set<{
7
- source: string;
8
- override: RegisterableItems;
9
- }>;
10
- constructor(registry: StoreRegistry);
11
- storeOverridesDeeply<C>(element: IResource<C, any, any>): void;
12
- processOverrides(): void;
13
- }
@@ -1,26 +0,0 @@
1
- /**
2
- * Cooperative task queue.
3
- * • Tasks run one‑after‑another (FIFO ordering).
4
- * • Dead‑lock detection prevents nesting.
5
- * • dispose() drains or cancels outstanding tasks, then rejects new ones.
6
- */
7
- export declare class Queue {
8
- private tail;
9
- private disposed;
10
- private abortController;
11
- private readonly executionContext;
12
- private readonly hasAsyncLocalStorage;
13
- /**
14
- * Schedule an asynchronous task.
15
- * @param task – receives an AbortSignal so it can cancel early if desired.
16
- */
17
- run<T>(task: (signal: AbortSignal) => Promise<T>): Promise<T>;
18
- /**
19
- * Disposes the queue.
20
- * @param options.cancel – if true, broadcasts AbortSignal to running task.
21
- * default: false (waits for tasks to finish).
22
- */
23
- dispose(options?: {
24
- cancel?: boolean;
25
- }): Promise<void>;
26
- }
@@ -1,20 +0,0 @@
1
- import { DependencyMapType, IResource, ResourceDependencyValuesType } from "../defs";
2
- import { EventManager } from "./EventManager";
3
- import { Store } from "./Store";
4
- import { Logger } from "./Logger";
5
- export declare class ResourceInitializer {
6
- protected readonly store: Store;
7
- protected readonly eventManager: EventManager;
8
- protected readonly logger: Logger;
9
- constructor(store: Store, eventManager: EventManager, logger: Logger);
10
- private readonly middlewareManager;
11
- /**
12
- * 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.
13
- * This function can throw only if any of the event listeners or run function throws
14
- */
15
- initializeResource<TConfig = null, TValue extends Promise<any> = Promise<any>, TDeps extends DependencyMapType = {}, TContext = any>(resource: IResource<TConfig, TValue, TDeps>, config: TConfig, dependencies: ResourceDependencyValuesType<TDeps>): Promise<{
16
- value: TValue;
17
- context: TContext;
18
- }>;
19
- initWithMiddleware<C, V extends Promise<any>, D extends DependencyMapType, TContext>(resource: IResource<C, V, D, TContext>, config: C, dependencies: ResourceDependencyValuesType<D>, context: TContext): Promise<V | undefined>;
20
- }
@@ -1,35 +0,0 @@
1
- import { DependencyMapType, IEvent, ITask } from "../defs";
2
- import { IResource } from "../defs";
3
- import { EventManager } from "./EventManager";
4
- import { Logger } from "./Logger";
5
- import { Store } from "./Store";
6
- import { TaskRunner } from "./TaskRunner";
7
- export declare class RunResult<V> {
8
- readonly value: V;
9
- readonly logger: Logger;
10
- readonly store: Store;
11
- private readonly eventManager;
12
- private readonly taskRunner;
13
- private readonly disposeFn;
14
- constructor(value: V, logger: Logger, store: Store, eventManager: EventManager, taskRunner: TaskRunner, disposeFn: () => Promise<void>);
15
- /**
16
- * Run a task within the context of the run result.
17
- * @param task - The task to run.
18
- * @param args - The arguments to pass to the task.
19
- * @returns The result of the task.
20
- */
21
- runTask: <I = undefined, O extends Promise<any> = any, D extends DependencyMapType = any>(task: ITask<I, O, D> | string, ...args: I extends undefined | void ? [] : [I]) => Promise<O | undefined>;
22
- /**
23
- * Emit an event within the context of the run result.
24
- * @param event - The event to emit.
25
- * @param payload - The payload to emit.
26
- */
27
- emitEvent: <P>(event: IEvent<P> | string, payload?: P extends undefined | void ? undefined : P) => Promise<void>;
28
- /**
29
- * Get the value of a resource from the run result.
30
- * @param resource - The resource to get the value of.
31
- * @returns The value of the resource.
32
- */
33
- getResourceValue: <Output extends Promise<any>>(resource: string | IResource<any, Output, any, any, any>) => Output extends Promise<infer U> ? U : Output;
34
- dispose: () => Promise<void>;
35
- }