@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
package/package.json CHANGED
@@ -1,14 +1,14 @@
1
1
  {
2
2
  "name": "@bluelibs/runner",
3
- "version": "4.8.6",
3
+ "version": "4.9.0",
4
4
  "description": "BlueLibs Runner",
5
5
  "sideEffects": false,
6
6
  "main": "dist/universal/index.cjs",
7
7
  "module": "dist/universal/index.mjs",
8
- "types": "dist/index.d.ts",
8
+ "types": "dist/universal/index.d.ts",
9
9
  "exports": {
10
10
  ".": {
11
- "types": "./dist/index.d.ts",
11
+ "types": "./dist/universal/index.d.ts",
12
12
  "browser": {
13
13
  "import": "./dist/browser/index.mjs",
14
14
  "require": "./dist/browser/index.cjs",
@@ -77,7 +77,7 @@
77
77
  "node": ">=18"
78
78
  },
79
79
  "scripts": {
80
- "build": "tsc -p tsconfig.declarations.json && tsup --config tsup.config.ts --sourcemap",
80
+ "build": "tsup --config tsup.config.ts --sourcemap",
81
81
  "clean": "rm -rf dist",
82
82
  "watch": "tsup --config tsup.config.ts --watch",
83
83
  "test": "jest --verbose --runInBand",
@@ -125,7 +125,7 @@
125
125
  "typescript": "^5.6.2",
126
126
  "zod": "^4.0.17"
127
127
  },
128
- "typings": "dist/index.d.ts",
128
+ "typings": "dist/universal/index.d.ts",
129
129
  "typescript": {
130
130
  "definition": "dist/index.d.ts"
131
131
  },
package/dist/define.d.ts DELETED
@@ -1,9 +0,0 @@
1
- export { defineTask } from "./definers/defineTask";
2
- export { defineHook } from "./definers/defineHook";
3
- export { defineResource } from "./definers/defineResource";
4
- export { defineEvent } from "./definers/defineEvent";
5
- export { defineTaskMiddleware } from "./definers/defineTaskMiddleware";
6
- export { defineResourceMiddleware } from "./definers/defineResourceMiddleware";
7
- export { defineOverride } from "./definers/defineOverride";
8
- export { defineTag } from "./definers/defineTag";
9
- export { isTask, isPhantomTask, isResource, isResourceWithConfig, isEvent, isHook, isTaskMiddleware, isResourceMiddleware, isTag, isOptional, isError, isAsyncContext, } from "./definers/tools";
@@ -1,13 +0,0 @@
1
- import type { IAsyncContext } from "../../types/asyncContext";
2
- import type { IValidationSchema } from "../../types/utilities";
3
- import type { IAsyncContextMeta } from "../../types/meta";
4
- export interface AsyncContextFluentBuilder<T = unknown> {
5
- id: string;
6
- serialize(fn: (data: T) => string): AsyncContextFluentBuilder<T>;
7
- parse(fn: (raw: string) => T): AsyncContextFluentBuilder<T>;
8
- configSchema(schema: IValidationSchema<T>): AsyncContextFluentBuilder<T>;
9
- meta<TNewMeta extends IAsyncContextMeta>(m: TNewMeta): AsyncContextFluentBuilder<T>;
10
- build(): IAsyncContext<T>;
11
- }
12
- export declare function asyncContextBuilder<T = unknown>(id: string): AsyncContextFluentBuilder<T>;
13
- export declare const asyncContext: typeof asyncContextBuilder;
@@ -1,30 +0,0 @@
1
- import type { DependencyMapType, IEventDefinition, IResourceDefinition, ITaskDefinition, IHookDefinition, ITaskMiddlewareDefinition, IResourceMiddlewareDefinition, TagType, ResourceMiddlewareAttachmentType, TaskMiddlewareAttachmentType } from "../../defs";
2
- import type { IResourceMeta, ITaskMeta } from "../../defs";
3
- export type Immutable<T> = {
4
- readonly [K in keyof T]: Immutable<T[K]>;
5
- };
6
- export type ReadonlyDeep<T> = Immutable<T>;
7
- export interface ResourceBuilder<TConfig = void, TValue extends Promise<any> = Promise<any>, TDeps extends DependencyMapType = {}, TContext = any, TMeta extends IResourceMeta = any, TTags extends TagType[] = TagType[], TMiddleware extends ResourceMiddlewareAttachmentType[] = ResourceMiddlewareAttachmentType[]> {
8
- id: string;
9
- definition: ReadonlyDeep<IResourceDefinition<TConfig, TValue, TDeps, TContext, any, any, TMeta, TTags, TMiddleware>>;
10
- }
11
- export interface TaskBuilder<TInput = undefined, TOutput extends Promise<any> = any, TDeps extends DependencyMapType = {}, TMeta extends ITaskMeta = any, TTags extends TagType[] = TagType[], TMiddleware extends TaskMiddlewareAttachmentType[] = TaskMiddlewareAttachmentType[]> {
12
- id: string;
13
- definition: ReadonlyDeep<ITaskDefinition<TInput, TOutput, TDeps, TMeta, TTags, TMiddleware>>;
14
- }
15
- export interface EventBuilder<TPayload = void> {
16
- id: string;
17
- definition: ReadonlyDeep<IEventDefinition<TPayload>>;
18
- }
19
- export interface HookBuilder<TDeps extends DependencyMapType = {}, TOn extends "*" | IEventDefinition<any> | readonly IEventDefinition<any>[] = any, TMeta extends ITaskMeta = any> {
20
- id: string;
21
- definition: ReadonlyDeep<IHookDefinition<TDeps, TOn, TMeta>>;
22
- }
23
- export interface TaskMiddlewareBuilder<TConfig = any, TEnforceInputContract = void, TEnforceOutputContract = void, TDependencies extends DependencyMapType = any> {
24
- id: string;
25
- definition: ReadonlyDeep<ITaskMiddlewareDefinition<TConfig, TEnforceInputContract, TEnforceOutputContract, TDependencies>>;
26
- }
27
- export interface ResourceMiddlewareBuilder<TConfig = any, TEnforceInputContract = void, TEnforceOutputContract = void, TDependencies extends DependencyMapType = any> {
28
- id: string;
29
- definition: ReadonlyDeep<IResourceMiddlewareDefinition<TConfig, TEnforceInputContract, TEnforceOutputContract, TDependencies>>;
30
- }
@@ -1,15 +0,0 @@
1
- import type { DefaultErrorType } from "../../types/error";
2
- import { ErrorHelper } from "../defineError";
3
- import type { IValidationSchema } from "../../types/utilities";
4
- import type { IErrorMeta } from "../../types/meta";
5
- export interface ErrorFluentBuilder<TData extends DefaultErrorType = DefaultErrorType> {
6
- id: string;
7
- serialize(fn: (data: TData) => string): ErrorFluentBuilder<TData>;
8
- parse(fn: (raw: string) => TData): ErrorFluentBuilder<TData>;
9
- dataSchema(schema: IValidationSchema<TData>): ErrorFluentBuilder<TData>;
10
- build(): ErrorHelper<TData>;
11
- format(fn: (data: TData) => string): ErrorFluentBuilder<TData>;
12
- meta<TNewMeta extends IErrorMeta>(m: TNewMeta): ErrorFluentBuilder<TData>;
13
- }
14
- export declare function errorBuilder<TData extends DefaultErrorType = DefaultErrorType>(id: string): ErrorFluentBuilder<TData>;
15
- export declare const error: typeof errorBuilder;
@@ -1,12 +0,0 @@
1
- import type { IEvent, IEventMeta, IValidationSchema, TagType } from "../../defs";
2
- export interface EventFluentBuilder<TPayload = void> {
3
- id: string;
4
- payloadSchema<TNew>(schema: IValidationSchema<TNew>): EventFluentBuilder<TNew>;
5
- tags<TNewTags extends TagType[]>(t: TNewTags, options?: {
6
- override?: boolean;
7
- }): EventFluentBuilder<TPayload>;
8
- meta<TNewMeta extends IEventMeta>(m: TNewMeta): EventFluentBuilder<TPayload>;
9
- build(): IEvent<TPayload>;
10
- }
11
- export declare function eventBuilder(id: string): EventFluentBuilder<void>;
12
- export declare const event: typeof eventBuilder;
@@ -1,20 +0,0 @@
1
- import type { DependencyMapType, IEventDefinition, IHook, IHookDefinition, ITaskMeta, TagType } from "../../defs";
2
- export interface HookFluentBuilder<TDeps extends DependencyMapType = {}, TOn extends "*" | IEventDefinition<any> | readonly IEventDefinition<any>[] = any, TMeta extends ITaskMeta = ITaskMeta> {
3
- id: string;
4
- on<TNewOn extends "*" | IEventDefinition<any> | readonly IEventDefinition<any>[]>(on: TNewOn): HookFluentBuilder<TDeps, TNewOn, TMeta>;
5
- order(order: number): HookFluentBuilder<TDeps, TOn, TMeta>;
6
- dependencies<TNewDeps extends DependencyMapType>(deps: TNewDeps | (() => TNewDeps), options?: {
7
- override?: false;
8
- }): HookFluentBuilder<TDeps & TNewDeps, TOn, TMeta>;
9
- dependencies<TNewDeps extends DependencyMapType>(deps: TNewDeps | (() => TNewDeps), options: {
10
- override: true;
11
- }): HookFluentBuilder<TNewDeps, TOn, TMeta>;
12
- tags<TNewTags extends TagType[]>(t: TNewTags, options?: {
13
- override?: boolean;
14
- }): HookFluentBuilder<TDeps, TOn, TMeta>;
15
- meta<TNewMeta extends ITaskMeta>(m: TNewMeta): HookFluentBuilder<TDeps, TOn, TNewMeta>;
16
- run(fn: IHookDefinition<TDeps, TOn, TMeta>["run"]): HookFluentBuilder<TDeps, TOn, TMeta>;
17
- build(): IHook<TDeps, TOn, TMeta>;
18
- }
19
- export declare function hookBuilder(id: string): HookFluentBuilder<{}, any, ITaskMeta>;
20
- export declare const hook: typeof hookBuilder;
@@ -1,39 +0,0 @@
1
- import type { DependencyMapType, ITaskMiddleware, ITaskMiddlewareDefinition, IResourceMiddleware, IResourceMiddlewareDefinition, IValidationSchema, IMiddlewareMeta, TagType, ITask, IResource } from "../../defs";
2
- export interface TaskMiddlewareFluentBuilder<C = any, In = void, Out = void, D extends DependencyMapType = {}> {
3
- id: string;
4
- dependencies<TNewDeps extends DependencyMapType>(deps: TNewDeps | ((config: C) => TNewDeps), options?: {
5
- override?: false;
6
- }): TaskMiddlewareFluentBuilder<C, In, Out, D & TNewDeps>;
7
- dependencies<TNewDeps extends DependencyMapType>(deps: TNewDeps | ((config: C) => TNewDeps), options: {
8
- override: true;
9
- }): TaskMiddlewareFluentBuilder<C, In, Out, TNewDeps>;
10
- configSchema<TNew>(schema: IValidationSchema<TNew>): TaskMiddlewareFluentBuilder<TNew, In, Out, D>;
11
- run(fn: ITaskMiddlewareDefinition<C, In, Out, D>["run"]): TaskMiddlewareFluentBuilder<C, In, Out, D>;
12
- meta<TNewMeta extends IMiddlewareMeta>(m: TNewMeta): TaskMiddlewareFluentBuilder<C, In, Out, D>;
13
- tags<TNewTags extends TagType[]>(t: TNewTags, options?: {
14
- override?: boolean;
15
- }): TaskMiddlewareFluentBuilder<C, In, Out, D>;
16
- everywhere(flag: boolean | ((task: ITask<any, any, any, any>) => boolean)): TaskMiddlewareFluentBuilder<C, In, Out, D>;
17
- build(): ITaskMiddleware<C, In, Out, D>;
18
- }
19
- export declare function taskMiddlewareBuilder<C = void, In = void, Out = void, D extends DependencyMapType = {}>(id: string): TaskMiddlewareFluentBuilder<C, In, Out, D>;
20
- export interface ResourceMiddlewareFluentBuilder<C = any, In = void, Out = void, D extends DependencyMapType = {}> {
21
- id: string;
22
- dependencies<TNewDeps extends DependencyMapType>(deps: TNewDeps | ((config: C) => TNewDeps), options?: {
23
- override?: false;
24
- }): ResourceMiddlewareFluentBuilder<C, In, Out, D & TNewDeps>;
25
- dependencies<TNewDeps extends DependencyMapType>(deps: TNewDeps | ((config: C) => TNewDeps), options: {
26
- override: true;
27
- }): ResourceMiddlewareFluentBuilder<C, In, Out, TNewDeps>;
28
- configSchema<TNew>(schema: IValidationSchema<TNew>): ResourceMiddlewareFluentBuilder<TNew, In, Out, D>;
29
- run(fn: IResourceMiddlewareDefinition<C, In, Out, D>["run"]): ResourceMiddlewareFluentBuilder<C, In, Out, D>;
30
- meta<TNewMeta extends IMiddlewareMeta>(m: TNewMeta): ResourceMiddlewareFluentBuilder<C, In, Out, D>;
31
- tags<TNewTags extends TagType[]>(t: TNewTags, options?: {
32
- override?: boolean;
33
- }): ResourceMiddlewareFluentBuilder<C, In, Out, D>;
34
- everywhere(flag: boolean | ((resource: IResource<any, any, any, any, any>) => boolean)): ResourceMiddlewareFluentBuilder<C, In, Out, D>;
35
- build(): IResourceMiddleware<C, In, Out, D>;
36
- }
37
- export declare function resourceMiddlewareBuilder<C = void, In = void, Out = void, D extends DependencyMapType = {}>(id: string): ResourceMiddlewareFluentBuilder<C, In, Out, D>;
38
- export declare const taskMiddleware: typeof taskMiddlewareBuilder;
39
- export declare const resourceMiddleware: typeof resourceMiddlewareBuilder;
@@ -1,40 +0,0 @@
1
- import type { DependencyMapType, IResource, IResourceDefinition, IResourceMeta, IValidationSchema, OverridableElements, RegisterableItems, ResourceInitFn, ResourceMiddlewareAttachmentType, TagType } from "../../defs";
2
- type ShouldReplaceConfig<T> = [T] extends [void] ? true : [T] extends [undefined] ? true : false;
3
- type ResolveConfig<TExisting, TProposed> = ShouldReplaceConfig<TExisting> extends true ? TProposed : TExisting;
4
- export interface ResourceFluentBuilder<TConfig = void, TValue extends Promise<any> = Promise<any>, TDeps extends DependencyMapType = {}, TContext = any, TMeta extends IResourceMeta = IResourceMeta, TTags extends TagType[] = TagType[], TMiddleware extends ResourceMiddlewareAttachmentType[] = ResourceMiddlewareAttachmentType[]> {
5
- id: string;
6
- dependencies<TNewDeps extends DependencyMapType>(deps: TNewDeps | ((config: TConfig) => TNewDeps), options?: {
7
- override?: false;
8
- }): ResourceFluentBuilder<TConfig, TValue, TDeps & TNewDeps, TContext, TMeta, TTags, TMiddleware>;
9
- dependencies<TNewDeps extends DependencyMapType>(deps: TNewDeps | ((config: TConfig) => TNewDeps), options: {
10
- override: true;
11
- }): ResourceFluentBuilder<TConfig, TValue, TNewDeps, TContext, TMeta, TTags, TMiddleware>;
12
- register(items: RegisterableItems | Array<RegisterableItems> | ((config: TConfig) => RegisterableItems | Array<RegisterableItems>), options?: {
13
- override?: boolean;
14
- }): ResourceFluentBuilder<TConfig, TValue, TDeps, TContext, TMeta, TTags, TMiddleware>;
15
- middleware<TNewMw extends ResourceMiddlewareAttachmentType[]>(mw: TNewMw, options?: {
16
- override?: boolean;
17
- }): ResourceFluentBuilder<TConfig, TValue, TDeps, TContext, TMeta, TTags, TNewMw>;
18
- tags<TNewTags extends TagType[]>(tags: TNewTags, options?: {
19
- override?: false;
20
- }): ResourceFluentBuilder<TConfig, TValue, TDeps, TContext, TMeta, [
21
- ...TTags,
22
- ...TNewTags
23
- ], TMiddleware>;
24
- tags<TNewTags extends TagType[]>(tags: TNewTags, options: {
25
- override: true;
26
- }): ResourceFluentBuilder<TConfig, TValue, TDeps, TContext, TMeta, TNewTags, TMiddleware>;
27
- context<TNewCtx>(factory: () => TNewCtx): ResourceFluentBuilder<TConfig, TValue, TDeps, TNewCtx, TMeta, TTags, TMiddleware>;
28
- configSchema<TNewConfig>(schema: IValidationSchema<TNewConfig>): ResourceFluentBuilder<TNewConfig, TValue, TDeps, TContext, TMeta, TTags, TMiddleware>;
29
- resultSchema<TResolved>(schema: IValidationSchema<TResolved>): ResourceFluentBuilder<TConfig, Promise<TResolved>, TDeps, TContext, TMeta, TTags, TMiddleware>;
30
- init<TNewConfig = TConfig, TNewValue extends Promise<any> = TValue>(fn: ResourceInitFn<ResolveConfig<TConfig, TNewConfig>, TNewValue, TDeps, TContext, TMeta, TTags, TMiddleware>): ResourceFluentBuilder<ResolveConfig<TConfig, TNewConfig>, TNewValue, TDeps, TContext, TMeta, TTags, TMiddleware>;
31
- dispose(fn: NonNullable<IResourceDefinition<TConfig, TValue, TDeps, TContext, any, any, TMeta, TTags, TMiddleware>["dispose"]>): ResourceFluentBuilder<TConfig, TValue, TDeps, TContext, TMeta, TTags, TMiddleware>;
32
- meta<TNewMeta extends IResourceMeta>(m: TNewMeta): ResourceFluentBuilder<TConfig, TValue, TDeps, TContext, TNewMeta, TTags, TMiddleware>;
33
- overrides(o: Array<OverridableElements>, options?: {
34
- override?: boolean;
35
- }): ResourceFluentBuilder<TConfig, TValue, TDeps, TContext, TMeta, TTags, TMiddleware>;
36
- build(): IResource<TConfig, TValue, TDeps, TContext, TMeta, TTags, TMiddleware>;
37
- }
38
- export declare function resourceBuilder<TConfig = void>(id: string): ResourceFluentBuilder<TConfig, Promise<any>, {}, any, IResourceMeta, TagType[], ResourceMiddlewareAttachmentType[]>;
39
- export declare const resource: typeof resourceBuilder;
40
- export {};
@@ -1,10 +0,0 @@
1
- import type { ITag, ITagMeta, IValidationSchema } from "../../defs";
2
- export interface TagFluentBuilder<TConfig = void, TEnforceIn = void, TEnforceOut = void> {
3
- id: string;
4
- meta<TNewMeta extends ITagMeta>(m: TNewMeta): TagFluentBuilder<TConfig, TEnforceIn, TEnforceOut>;
5
- configSchema<TNewConfig>(schema: IValidationSchema<TNewConfig>): TagFluentBuilder<TNewConfig, TEnforceIn, TEnforceOut>;
6
- config<TNewConfig>(config: TNewConfig): TagFluentBuilder<TNewConfig, TEnforceIn, TEnforceOut>;
7
- build(): ITag<TConfig, TEnforceIn, TEnforceOut>;
8
- }
9
- export declare function tagBuilder<TConfig = void, TEnforceIn = void, TEnforceOut = void>(id: string): TagFluentBuilder<TConfig, TEnforceIn, TEnforceOut>;
10
- export declare const tag: typeof tagBuilder;
@@ -1,37 +0,0 @@
1
- import type { DependencyMapType, ITask, ITaskDefinition, ITaskMeta, IValidationSchema, TagType, TaskMiddlewareAttachmentType } from "../../defs";
2
- import { type PhantomTaskFluentBuilder } from "./task.phantom";
3
- type ShouldReplaceInput<T> = [T] extends [undefined] ? true : [T] extends [void] ? true : (0 extends 1 & T ? true : false);
4
- type ResolveInput<TExisting, TProposed> = ShouldReplaceInput<TExisting> extends true ? TProposed : TExisting;
5
- export interface TaskFluentBuilder<TInput = undefined, TOutput extends Promise<any> = Promise<any>, TDeps extends DependencyMapType = {}, TMeta extends ITaskMeta = ITaskMeta, TTags extends TagType[] = TagType[], TMiddleware extends TaskMiddlewareAttachmentType[] = TaskMiddlewareAttachmentType[]> {
6
- id: string;
7
- dependencies<TNewDeps extends DependencyMapType>(deps: TNewDeps | (() => TNewDeps), options?: {
8
- override?: false;
9
- }): TaskFluentBuilder<TInput, TOutput, TDeps & TNewDeps, TMeta, TTags, TMiddleware>;
10
- dependencies<TNewDeps extends DependencyMapType>(deps: TNewDeps | (() => TNewDeps), options: {
11
- override: true;
12
- }): TaskFluentBuilder<TInput, TOutput, TNewDeps, TMeta, TTags, TMiddleware>;
13
- middleware<TNewMw extends TaskMiddlewareAttachmentType[]>(mw: TNewMw, options?: {
14
- override?: boolean;
15
- }): TaskFluentBuilder<TInput, TOutput, TDeps, TMeta, TTags, TNewMw>;
16
- tags<TNewTags extends TagType[]>(t: TNewTags, options?: {
17
- override?: false;
18
- }): TaskFluentBuilder<TInput, TOutput, TDeps, TMeta, [
19
- ...TTags,
20
- ...TNewTags
21
- ], TMiddleware>;
22
- tags<TNewTags extends TagType[]>(t: TNewTags, options: {
23
- override: true;
24
- }): TaskFluentBuilder<TInput, TOutput, TDeps, TMeta, TNewTags, TMiddleware>;
25
- inputSchema<TNewInput>(schema: IValidationSchema<TNewInput>): TaskFluentBuilder<TNewInput, TOutput, TDeps, TMeta, TTags, TMiddleware>;
26
- resultSchema<TResolved>(schema: IValidationSchema<TResolved>): TaskFluentBuilder<TInput, Promise<TResolved>, TDeps, TMeta, TTags, TMiddleware>;
27
- run<TNewInput = TInput, TNewOutput extends Promise<any> = TOutput>(fn: NonNullable<ITaskDefinition<ResolveInput<TInput, TNewInput>, TNewOutput, TDeps, TMeta, TTags, TMiddleware>["run"]>): TaskFluentBuilder<ResolveInput<TInput, TNewInput>, TNewOutput, TDeps, TMeta, TTags, TMiddleware>;
28
- meta<TNewMeta extends ITaskMeta>(m: TNewMeta): TaskFluentBuilder<TInput, TOutput, TDeps, TNewMeta, TTags, TMiddleware>;
29
- build(): ITask<TInput, TOutput, TDeps, TMeta, TTags, TMiddleware>;
30
- }
31
- export declare function taskBuilder(id: string): TaskFluentBuilder<undefined, Promise<any>, {}, ITaskMeta, TagType[], TaskMiddlewareAttachmentType[]>;
32
- export interface TaskBuilderWithPhantom {
33
- (id: string): TaskFluentBuilder<undefined, Promise<any>, {}, ITaskMeta, TagType[], TaskMiddlewareAttachmentType[]>;
34
- phantom: <TInput = undefined, TResolved = any>(id: string) => PhantomTaskFluentBuilder<TInput, TResolved, {}, ITaskMeta, TagType[], TaskMiddlewareAttachmentType[]>;
35
- }
36
- export declare const task: TaskBuilderWithPhantom;
37
- export {};
@@ -1,27 +0,0 @@
1
- import type { DependencyMapType, ITaskMeta, IValidationSchema, TagType, TaskMiddlewareAttachmentType, IPhantomTask } from "../../defs";
2
- export interface PhantomTaskFluentBuilder<TInput = undefined, TResolved = any, TDeps extends DependencyMapType = {}, TMeta extends ITaskMeta = ITaskMeta, TTags extends TagType[] = TagType[], TMiddleware extends TaskMiddlewareAttachmentType[] = TaskMiddlewareAttachmentType[]> {
3
- id: string;
4
- dependencies<TNewDeps extends DependencyMapType>(deps: TNewDeps | (() => TNewDeps), options?: {
5
- override?: false;
6
- }): PhantomTaskFluentBuilder<TInput, TResolved, TDeps & TNewDeps, TMeta, TTags, TMiddleware>;
7
- dependencies<TNewDeps extends DependencyMapType>(deps: TNewDeps | (() => TNewDeps), options: {
8
- override: true;
9
- }): PhantomTaskFluentBuilder<TInput, TResolved, TNewDeps, TMeta, TTags, TMiddleware>;
10
- middleware<TNewMw extends TaskMiddlewareAttachmentType[]>(mw: TNewMw, options?: {
11
- override?: boolean;
12
- }): PhantomTaskFluentBuilder<TInput, TResolved, TDeps, TMeta, TTags, TNewMw>;
13
- tags<TNewTags extends TagType[]>(t: TNewTags, options?: {
14
- override?: false;
15
- }): PhantomTaskFluentBuilder<TInput, TResolved, TDeps, TMeta, [
16
- ...TTags,
17
- ...TNewTags
18
- ], TMiddleware>;
19
- tags<TNewTags extends TagType[]>(t: TNewTags, options: {
20
- override: true;
21
- }): PhantomTaskFluentBuilder<TInput, TResolved, TDeps, TMeta, TNewTags, TMiddleware>;
22
- inputSchema<TNewInput>(schema: IValidationSchema<TNewInput>): PhantomTaskFluentBuilder<TNewInput, TResolved, TDeps, TMeta, TTags, TMiddleware>;
23
- resultSchema<TNewResolved>(schema: IValidationSchema<TNewResolved>): PhantomTaskFluentBuilder<TInput, TNewResolved, TDeps, TMeta, TTags, TMiddleware>;
24
- meta<TNewMeta extends ITaskMeta>(m: TNewMeta): PhantomTaskFluentBuilder<TInput, TResolved, TDeps, TNewMeta, TTags, TMiddleware>;
25
- build(): IPhantomTask<TInput, TResolved, TDeps, TMeta, TTags, TMiddleware>;
26
- }
27
- export declare function phantomTaskBuilder<TInput = undefined, TResolved = any>(id: string): PhantomTaskFluentBuilder<TInput, TResolved, {}, ITaskMeta, TagType[], TaskMiddlewareAttachmentType[]>;
@@ -1,4 +0,0 @@
1
- import type { DependencyMapType } from "../../defs";
2
- export declare function cloneState<S, NS>(s: S, patch: Partial<NS>): NS;
3
- export declare function mergeArray<T>(existing: ReadonlyArray<T> | undefined, addition: ReadonlyArray<T>, override: boolean): T[];
4
- export declare function mergeDepsNoConfig<TExisting extends DependencyMapType, TNew extends DependencyMapType>(existing: TExisting | (() => TExisting) | undefined, addition: TNew | (() => TNew), override: boolean): (TExisting & TNew) | (() => TExisting & TNew);
@@ -1,15 +0,0 @@
1
- import { contextError } from "../errors";
2
- import { IAsyncContext, IAsyncContextDefinition } from "../types/asyncContext";
3
- export { contextError as ContextError };
4
- export declare const storage: import("../platform").IAsyncLocalStorage<Map<string, unknown>>;
5
- /** Returns the currently active store or undefined. */
6
- export declare function getCurrentStore(): Map<string, unknown> | undefined;
7
- /**
8
- * Create a new typed Context. The result contains helpers similar to React’s
9
- * Context API but adapted for async usage in Runner.
10
- */
11
- export declare function defineAsyncContext<T>(def: IAsyncContextDefinition<T>): IAsyncContext<T>;
12
- export type { IAsyncContext } from "../types/asyncContext";
13
- /** Convenience creator allowing optional name. Used by tests and legacy API. */
14
- /** @deprecated Use defineAsyncContext instead */
15
- export declare function createContext<T>(name?: string): IAsyncContext<T>;
@@ -1,26 +0,0 @@
1
- import { DefaultErrorType, IErrorDefinition, IErrorHelper, IErrorDefinitionFinal } from "../types/error";
2
- import { symbolError, symbolOptionalDependency } from "../types/symbols";
3
- declare class RunnerError<TData extends DefaultErrorType = DefaultErrorType> extends Error {
4
- readonly id: string;
5
- readonly data: TData;
6
- constructor(id: string, message: string, data: TData);
7
- }
8
- export declare class ErrorHelper<TData extends DefaultErrorType = DefaultErrorType> implements IErrorHelper<TData> {
9
- private readonly definition;
10
- [symbolError]: true;
11
- constructor(definition: IErrorDefinitionFinal<TData>);
12
- get id(): string;
13
- throw(data: TData): never;
14
- is(error: unknown): error is RunnerError<TData>;
15
- optional(): {
16
- readonly inner: IErrorHelper<TData>;
17
- readonly [symbolOptionalDependency]: true;
18
- };
19
- }
20
- /**
21
- * Create a new error that is going to be used
22
- * @param definition
23
- * @returns
24
- */
25
- export declare function defineError<TData extends DefaultErrorType = DefaultErrorType>(definition: IErrorDefinition<TData>): ErrorHelper<TData>;
26
- export {};
@@ -1,2 +0,0 @@
1
- import { IEvent, IEventDefinition } from "../defs";
2
- export declare function defineEvent<TPayload = void>(config: IEventDefinition<TPayload>): IEvent<TPayload>;
@@ -1,6 +0,0 @@
1
- import { DependencyMapType, IEventDefinition, ITaskMeta, IHook, IHookDefinition } from "../defs";
2
- /**
3
- * Define a hook (event listeners).
4
- * Same shape as task with mandatory `on` and without `middleware`.
5
- */
6
- export declare function defineHook<D extends DependencyMapType = any, TOn extends "*" | IEventDefinition<any> | readonly IEventDefinition<any>[] = any, TMeta extends ITaskMeta = any>(hookDef: IHookDefinition<D, TOn, TMeta>): IHook<D, TOn, TMeta>;
@@ -1,17 +0,0 @@
1
- import { ITask, IResource, ITaskMiddleware, IResourceMiddleware, IHook } from "../defs";
2
- /**
3
- * Override helper that preserves the original `id` and returns the same type.
4
- * You can override any property except `id`. The override is shallow-merged over the base.
5
- *
6
- * @param base - The base definition to override.
7
- * @param patch - Properties to override (except `id`).
8
- * @returns A definition of the same kind with overrides applied.
9
- */
10
- type AnyTask = ITask<any, any, any, any, any, any>;
11
- type AnyResource = IResource<any, any, any, any, any, any, any>;
12
- type AnyTaskMiddleware = ITaskMiddleware<any, any, any, any>;
13
- type AnyResourceMiddleware = IResourceMiddleware<any, any, any, any>;
14
- type AnyHook = IHook<any, any, any>;
15
- type OverridePatch<T> = T extends AnyTask ? Omit<Partial<T>, "id"> & Pick<T, "run"> : T extends AnyResource ? Omit<Partial<T>, "id"> & Pick<T, "init"> : T extends AnyTaskMiddleware ? Omit<Partial<T>, "id"> : T extends AnyResourceMiddleware ? Omit<Partial<T>, "id"> & Pick<T, "run"> : T extends AnyHook ? Omit<Partial<T>, "id" | "on"> & Pick<T, "run"> : never;
16
- export declare function defineOverride<T extends AnyTask | AnyResource | AnyTaskMiddleware | AnyResourceMiddleware | AnyHook>(base: T, patch: OverridePatch<T>): T;
17
- export {};
@@ -1,2 +0,0 @@
1
- import { IResource, IResourceDefinition, DependencyMapType, IResourceMeta, TagType, ResourceMiddlewareAttachmentType } from "../defs";
2
- export declare function defineResource<TConfig = void, TValue extends Promise<any> = Promise<any>, TDeps extends DependencyMapType = {}, TPrivate = any, TMeta extends IResourceMeta = any, TTags extends TagType[] = TagType[], TMiddleware extends ResourceMiddlewareAttachmentType[] = ResourceMiddlewareAttachmentType[]>(constConfig: IResourceDefinition<TConfig, TValue, TDeps, TPrivate, any, any, TMeta, TTags, TMiddleware>): IResource<TConfig, TValue, TDeps, TPrivate, TMeta, TTags, TMiddleware>;
@@ -1,2 +0,0 @@
1
- import { IResourceMiddleware, IResourceMiddlewareDefinition, DependencyMapType } from "../defs";
2
- export declare function defineResourceMiddleware<TConfig = any, TEnforceInputContract = void, TEnforceOutputContract = void, TDependencies extends DependencyMapType = any>(middlewareDef: IResourceMiddlewareDefinition<TConfig, TEnforceInputContract, TEnforceOutputContract, TDependencies>): IResourceMiddleware<TConfig, TEnforceInputContract, TEnforceOutputContract, TDependencies>;
@@ -1,12 +0,0 @@
1
- import { ITag, ITagDefinition } from "../defs";
2
- /**
3
- * Create a tag definition.
4
- * - `.with(config)` to create configured instances
5
- * - `.extract(tags)` to extract this tag from a list of tags or a taggable's meta
6
- *
7
- * @typeParam TConfig - Configuration type carried by configured tags.
8
- * @typeParam TEnforceContract - Optional helper type to enforce a contract when tags are used.
9
- * @param definition - The tag definition (id).
10
- * @returns A tag object with helpers to configure and extract.
11
- */
12
- export declare function defineTag<TConfig = void, TEnforceInputContract = void, TEnforceOutputContract = void>(definition: ITagDefinition<TConfig, TEnforceInputContract, TEnforceOutputContract>): ITag<TConfig, TEnforceInputContract, TEnforceOutputContract>;
@@ -1,18 +0,0 @@
1
- import { ITask, ITaskDefinition, DependencyMapType, ITaskMeta, TagType, TaskMiddlewareAttachmentType, IPhantomTask } from "../defs";
2
- /**
3
- * Define a task.
4
- * Generates a strongly-typed task object with id, dependencies,
5
- * middleware, and metadata.
6
- *
7
- * @typeParam Input - Input type accepted by the task's `run` function.
8
- * @typeParam Output - Promise type returned by the `run` function.
9
- * @typeParam Deps - Dependency map type this task requires.
10
- * @typeParam TOn - Event type or "*" this task listens to.
11
- * @typeParam TMeta - Arbitrary metadata type carried by the task.
12
- * @param taskConfig - The task definition config.
13
- * @returns A branded task definition usable by the runner.
14
- */
15
- export declare function defineTask<Input = undefined, Output extends Promise<any> = any, Deps extends DependencyMapType = any, TMeta extends ITaskMeta = any, TTags extends TagType[] = TagType[], TMiddleware extends TaskMiddlewareAttachmentType[] = TaskMiddlewareAttachmentType[]>(taskConfig: ITaskDefinition<Input, Output, Deps, TMeta, TTags, TMiddleware>): ITask<Input, Output, Deps, TMeta, TTags, TMiddleware>;
16
- export declare namespace defineTask {
17
- var phantom: <Input = undefined, Output extends Promise<any> = any>(taskConfig: Omit<ITaskDefinition<Input, Output, any, any, any, any>, "run">) => IPhantomTask<Input, Output, any, any, any, any>;
18
- }
@@ -1,2 +0,0 @@
1
- import { ITaskMiddleware, ITaskMiddlewareDefinition, DependencyMapType } from "../defs";
2
- export declare function defineTaskMiddleware<TConfig = any, TEnforceInputContract = void, TEnforceOutputContract = void, TDependencies extends DependencyMapType = any>(middlewareDef: ITaskMiddlewareDefinition<TConfig, TEnforceInputContract, TEnforceOutputContract, TDependencies>): ITaskMiddleware<TConfig, TEnforceInputContract, TEnforceOutputContract, TDependencies>;
@@ -1,53 +0,0 @@
1
- /**
2
- * Type guard and utility functions for checking definition types.
3
- */
4
- import { ITask, IResource, IResourceWithConfig, ITaskMiddleware, IResourceMiddleware, IEvent, IHook, IOptionalDependency, ITag, IPhantomTask } from "../defs";
5
- import { IErrorHelper } from "../types/error";
6
- import type { IAsyncContext } from "../types/asyncContext";
7
- /**
8
- * Type guard: checks if a definition is a Task.
9
- * @param definition - Any value to test.
10
- * @returns True when `definition` is a branded Task.
11
- */
12
- export declare function isTask(definition: any): definition is ITask;
13
- /** Type guard: checks if a definition is a Phantom Task. */
14
- export declare function isPhantomTask(definition: any): definition is IPhantomTask;
15
- /**
16
- * Type guard: checks if a definition is a Resource.
17
- * @param definition - Any value to test.
18
- * @returns True when `definition` is a branded Resource.
19
- */
20
- export declare function isResource(definition: any): definition is IResource;
21
- /**
22
- * Type guard: checks if a definition is a Resource that carries config via `.with()`.
23
- * @param definition - Any value to test.
24
- * @returns True when `definition` is a branded ResourceWithConfig.
25
- */
26
- export declare function isResourceWithConfig(definition: any): definition is IResourceWithConfig;
27
- /**
28
- * Type guard: checks if a definition is an Event.
29
- * @param definition - Any value to test.
30
- * @returns True when `definition` is a branded Event.
31
- */
32
- export declare function isEvent(definition: any): definition is IEvent;
33
- /** Type guard: checks if a definition is a Hook. */
34
- export declare function isHook(definition: any): definition is IHook;
35
- /**
36
- * Type guard: checks if a definition is a Middleware.
37
- * @param definition - Any value to test.
38
- * @returns True when `definition` is a branded Middleware.
39
- */
40
- export declare function isTaskMiddleware(definition: any): definition is ITaskMiddleware;
41
- export declare function isResourceMiddleware(definition: any): definition is IResourceMiddleware;
42
- /**
43
- * Type guard: checks if a definition is a Tag.
44
- * @param definition - Any value to test.
45
- * @returns True when `definition` is a branded Tag.
46
- */
47
- export declare function isTag(definition: any): definition is ITag;
48
- /** Type guard: checks if a definition is an Optional Dependency wrapper. */
49
- export declare function isOptional(definition: any): definition is IOptionalDependency<any>;
50
- /** Type guard: checks if a definition is an Error helper. */
51
- export declare function isError(definition: any): definition is IErrorHelper<any>;
52
- /** Type guard: checks if a definition is an Async Context. */
53
- export declare function isAsyncContext(definition: any): definition is IAsyncContext<any>;
package/dist/defs.d.ts DELETED
@@ -1,31 +0,0 @@
1
- /**
2
- * Core public TypeScript types for BlueLibs Runner.
3
- *
4
- * This file contains the strongly-typed contract for tasks, resources, events
5
- * and middleware. It mirrors the mental model described in the README:
6
- * - Tasks are functions
7
- * - Resources are singletons (with init/dispose hooks)
8
- * - Hooks are event listeners without middleware
9
- * - Events are simple, strongly-typed emissions
10
- * - Middleware can target both tasks and resources (taskMiddleware, resourceMiddleware)
11
- *
12
- * DX goals:
13
- * - Crystal‑clear generics and helper types that infer dependency shapes
14
- * - Friendly JSDoc you can hover in editors to understand usage instantly
15
- * - Safe overrides and strong typing around config and register mechanics
16
- */
17
- export * from "./types/utilities";
18
- export * from "./types/symbols";
19
- export * from "./types/tag";
20
- export * from "./types/hook";
21
- export * from "./types/resource";
22
- export * from "./types/event";
23
- export * from "./types/task";
24
- export * from "./types/taskMiddleware";
25
- export * from "./types/resourceMiddleware";
26
- export * from "./types/meta";
27
- export * from "./types/runner";
28
- export * from "./types/asyncContext";
29
- export * from "./types/error";
30
- export { ICacheInstance } from "./globals/middleware/cache.middleware";
31
- export * from "./types/storeTypes";
package/dist/errors.d.ts DELETED
@@ -1,62 +0,0 @@
1
- import type { DefaultErrorType } from "./types/error";
2
- export declare const duplicateRegistrationError: import("./definers/defineError").ErrorHelper<{
3
- type: string;
4
- id: string;
5
- } & DefaultErrorType>;
6
- export declare const dependencyNotFoundError: import("./definers/defineError").ErrorHelper<{
7
- key: string;
8
- } & DefaultErrorType>;
9
- export declare const unknownItemTypeError: import("./definers/defineError").ErrorHelper<{
10
- item: unknown;
11
- } & DefaultErrorType>;
12
- export declare const contextError: import("./definers/defineError").ErrorHelper<{
13
- details?: string;
14
- } & DefaultErrorType>;
15
- export declare const circularDependenciesError: import("./definers/defineError").ErrorHelper<{
16
- cycles: string[];
17
- } & DefaultErrorType>;
18
- export declare const eventNotFoundError: import("./definers/defineError").ErrorHelper<{
19
- id: string;
20
- } & DefaultErrorType>;
21
- export declare const resourceNotFoundError: import("./definers/defineError").ErrorHelper<{
22
- id: string;
23
- } & DefaultErrorType>;
24
- export declare const middlewareNotRegisteredError: import("./definers/defineError").ErrorHelper<{
25
- type: "task" | "resource";
26
- source: string;
27
- middlewareId: string;
28
- } & DefaultErrorType>;
29
- export declare const tagNotFoundError: import("./definers/defineError").ErrorHelper<{
30
- id: string;
31
- } & DefaultErrorType>;
32
- export declare const lockedError: import("./definers/defineError").ErrorHelper<{
33
- what: string;
34
- } & DefaultErrorType>;
35
- export declare const storeAlreadyInitializedError: import("./definers/defineError").ErrorHelper<DefaultErrorType>;
36
- export declare const validationError: import("./definers/defineError").ErrorHelper<{
37
- subject: string;
38
- id: string;
39
- originalError: string | Error;
40
- } & DefaultErrorType>;
41
- export declare const eventCycleError: import("./definers/defineError").ErrorHelper<{
42
- path: Array<{
43
- id: string;
44
- source: string;
45
- }>;
46
- } & DefaultErrorType>;
47
- export declare const eventEmissionCycleError: import("./definers/defineError").ErrorHelper<{
48
- cycles: string[];
49
- } & DefaultErrorType>;
50
- export declare const platformUnsupportedFunctionError: import("./definers/defineError").ErrorHelper<{
51
- functionName: string;
52
- } & DefaultErrorType>;
53
- export declare const cancellationError: import("./definers/defineError").ErrorHelper<{
54
- reason?: string;
55
- } & DefaultErrorType>;
56
- export declare const tunnelOwnershipConflictError: import("./definers/defineError").ErrorHelper<{
57
- taskId: string;
58
- currentOwnerId: string;
59
- attemptedOwnerId: string;
60
- } & DefaultErrorType>;
61
- export declare function isCancellationError(err: unknown): boolean;
62
- export type { IErrorHelper } from "./types/error";
@@ -1,10 +0,0 @@
1
- export declare const debugLevels: {
2
- normal: import("./types").DebugConfig;
3
- verbose: import("./types").DebugConfig;
4
- };
5
- export declare const debug: {
6
- levels: {
7
- normal: import("./types").DebugConfig;
8
- verbose: import("./types").DebugConfig;
9
- };
10
- };
@@ -1,8 +0,0 @@
1
- import { IEvent } from "../defs";
2
- export declare const globalEvents: {
3
- /**
4
- * Emitted when the system is fully initialized and ready for work.
5
- */
6
- readonly ready: IEvent<void>;
7
- };
8
- export declare const globalEventsArray: IEvent<any>[];