@bluelibs/runner 1.2.0 → 1.3.0

package/README.md

@@ -6,9 +6,9 @@
 <a href="https://bluelibs.github.io/runner/" target="_blank"><img src="https://img.shields.io/badge/read-typedocs-blue" alt="Docs" /></a>
 </p>
 
-These are the building blocks to create amazing applications. It's a more functional approach to building small and large-scale applications.
+BlueLibs Runner is a framework that provides a functional approach to building applications, whether small or large-scale. Its core concepts include Tasks, Resources, Events, and Middleware. Tasks represent the units of logic, while resources are singletons that provide shared services across the application. Events facilitate communication between different parts of the system, and middleware allows interception and modification of task execution. The framework emphasizes an async-first philosophy, ensuring that all operations are executed asynchronously for smoother application flow.
 
-These are the building blocks:
+## Building Blocks
 
 - **Tasks**: Core units of logic that encapsulate specific tasks. They can depend on resources, other tasks, and event emitters.
 - **Resources**: Singleton objects providing shared functionality. They can be constants, services, functions. They can depend on other resources, tasks, and event emitters.
@@ -89,7 +89,7 @@ Resources are more like services, they are singletons, they are meant to be used
 
 ### Resource dispose()
 
-Resources can have a `dispose()` method that can be used to clean up resources. This is useful for cleaning up resources like closing database connections, etc. You typically want to use this when you have opened pending connections or you need to do some cleanup or a graceful shutdown.
+Resources can have a `dispose()` method that can be used for cleanups. This is useful for cleaning up resources like closing database connections, etc. You typically want to use this when you have opened pending connections or you need to do some cleanup or a graceful shutdown.
 
 ```ts
 import { task, run, resource } from "@bluelibs/runner";
@@ -99,13 +99,14 @@ const dbResource = resource({
     const db = await connectToDatabase();
     return db;
   },
+  // the value returned from init() will be passed to dispose()
   async dispose(db, config, deps) {
     return db.close();
   },
 });
 ```
 
-If you want to call dispose, you have to do it through the global store.
+If you want to call dispose, you have to do it through the global resource called `store`, as everything is encapsulated.
 
 ```ts
 import { task, run, resource, globals } from "@bluelibs/runner";
@@ -117,6 +118,7 @@ const app = resource({
     store: globals.resources.store,
   },
   async init(_, deps) {
+    // We use the fact that we can reuse the value we got from here
     return {
       dispose: async () => deps.store.dispose(),
     };
@@ -128,15 +130,43 @@ const value = await run(app);
 await value.dispose();
 ```
 
-## Encapsulation
+### Resource with()
 
-We want to make sure that our tasks are not dependent on the outside world. This is why we have the `dependencies` object.
+Resources can be configured with a configuration object. This is useful when you want to pass in configuration to them. For example, you're building a library and you're initialising a mailer service, you can pass in the SMTP credentials as a configuration.
 
-You cannot call on an task outside from dependencies. And not only that, it has to be explicitly registered to the container.
+```ts
+import { task, run, resource } from "@bluelibs/runner";
+
+type Config = { smtpUrl: string; defaultFrom: string };
+const emailerResource = resource({
+  async init(config: Config) {
+    // run config checks
+    return {
+      sendEmail: async (to: string, subject: string, body: string) => {
+        // send *email*
+      },
+    };
+  },
+});
+
+const app = resource({
+  id: "app",
+  register: [
+    // proper autocompletion is present
+    emailerResource.with({ smtpUrl: "smtp://localhost", defaultFrom: "" }),
+  ],
+});
+```
+
+If by any chance your main `app` has configs then they will be passed via the second argument of `run`, like this:
+
+```ts
+run(app, config);
+```
 
 ## Dependencies
 
-You can depend on `tasks`, `resources`, `events` and `middleware`.
+You can depend on `tasks`, `resources`, `events` and (indirectly) on `middleware`.
 
 ```ts
 import { task, resource, run, event } from "@bluelibs/runner";
@@ -150,7 +180,7 @@ const helloWorld = task({
 
 const app = resource({
   id: "app",
-  register: [helloWorld],
+  register: [helloWorld, logMiddleware],
   dependencies: {
     helloWorld,
   },
@@ -211,14 +241,14 @@ const helloTask = task({
   },
 });
 
-const root = resource({
+const app = resource({
   id: "app",
   register: [afterRegisterEvent, helloTask],
   dependencies: {
     afterRegisterEvent,
   },
   async init(_, deps) {
-    deps.afterRegisterEvent({ userId: "XXX" });
+    await deps.afterRegisterEvent({ userId: "XXX" });
   },
 });
 ```
@@ -242,6 +272,7 @@ const root = resource({
     {
       event: global.events.afterInit,
       async run(event, deps) {
+        // both dependencies and event are properly infered through typescript
         console.log("User has been registered!");
       },
     },
@@ -252,16 +283,55 @@ const root = resource({
 });
 ```
 
+### hooks wildcard
+
+You can listen to all events by using the wildcard `*`.
+
+```ts
+import { task, resource, run, event, global } from "@bluelibs/runner";
+
+const afterRegisterEvent = event<{ userId: string }>({
+  id: "app.user.registered",
+});
+
+const root = resource({
+  id: "app",
+  register: [afterRegisterEvent],
+  dependencies: {},
+  hooks: [
+    {
+      event: "*",
+      async run(event, deps) {
+        console.log(
+          "Generic event detected",
+          event.id,
+          event.data,
+          event.timestamp
+        );
+      },
+    },
+  ],
+  async init(_, deps) {
+    deps.afterRegisterEvent({ userId: "XXX" });
+  },
+});
+```
+
 When using hooks, inside resource() you benefit of autocompletion, in order to keep things clean, if your hooks become large and long consider switching to tasks and `on`. This is a more explicit way to listen to events, and your resource registers them.
 
 The hooks from a `resource` are mostly used for configuration, and blending in the system.
 
+### When to use either?
+
+- `hooks` are for resources to extend each other, compose functionalities, they are mostly used for configuration and blending in the system.
+- `on` is for when you want to perform a task when something happens.
+
 ## Middleware
 
-Middleware is a way to intercept the execution of tasks. It's a powerful way to add additional functionality to your tasks. First middleware that gets registered is the first that runs, the last middleware that runs is 'closest' to the task, most likely the last element inside `middleware` array at task level.
+Middleware is a way to intercept the execution of tasks or initialization of resources. It's a powerful way to add additional functionality. First middleware that gets registered is the first that runs, giving it a form of priority, the last middleware that runs is 'closest' to the task, most likely the last element inside `middleware` array at task level.
 
 ```ts
-import { task, run, event } from "@bluelibs/runner";
+import { task, resource, run, event } from "@bluelibs/runner";
 
 const logMiddleware = middleware({
   id: "app.middleware.log",
@@ -269,11 +339,18 @@ const logMiddleware = middleware({
     // inject tasks, resources, eventCallers here.
   },
   async run(data, deps) {
-    const { taskDefinition, next, input } = data;
-
-    console.log("Before task", taskDefinition.id);
-    const result = await next(input); // pass the input to the next middleware or task
-    console.log("After task", taskDefinition.id);
+    const { taskDefinition, resourceDefinition, config, next, input } = data;
+
+    // The middleware can be for a task or a resource, depending on which you get the right elements.
+    if (taskDefinition) {
+      console.log("Before task", taskDefinition.id);
+      const result = await next(input); // pass the input to the next middleware or task
+      console.log("After task", taskDefinition.id);
+    } else {
+      console.log("Before resource", resourceDefinition.id);
+      const result = await next(config); // pass the input to the next middleware or task
+      console.log("After resource", resourceDefinition.id);
+    }
 
     return result;
   },
@@ -288,34 +365,14 @@ const helloTask = task({
 });
 ```
 
-You can use middleware creators (function that returns) for configurable middlewares such as:
-
-```ts
-import { middleware } from "@bluelibs/runner";
-
-function createLogMiddleware(config) {
-  return middleware({
-    // your config-based middleware here.
-  });
-}
-```
-
-However, if you want to register a middleware for all tasks, here's how you can do it:
+However, if you want to register a middleware for all tasks and resources, here's how you can do it:
 
 ```ts
 import { run, resource } from "@bluelibs/runner";
 
 const logMiddleware = middleware({
   id: "app.middleware.log",
-  async run(data, deps) {
-    const { taskDefinition, next, input } = data;
-
-    console.log("Before task", task.id);
-    const result = await next(input);
-    console.log("After task", task.id);
-
-    return result;
-  },
+  // ... rest
 });
 
 const root = resource({
@@ -326,20 +383,9 @@ const root = resource({
 
 The middleware can only be registered once. This means that if you register a middleware as global, you cannot specify it as a task middleware.
 
-### Middleware for resources
-
-Unfortunately, middleware for resources is not supported at the moment. The main reason for this is simplicity and the fact that resources are not meant to be executed, but rather to be initialized.
-
-You have access to the global events if you want to hook into the initialisation system.
-
-### When to use either?
-
-- `hooks` are for resources to extend each other, compose functionalities, they are mostly used for configuration and blending in the system.
-- `on` is for when you want to perform a task when something happens.
-
 ## Errors
 
-If an error is thrown in a task, the error will be propagated up.
+If an error is thrown in a task, the error will be propagated up to the top runner.
 
 ```ts
 import { task, run, event } from "@bluelibs/runner";
@@ -362,7 +408,9 @@ const app = resource({
   },
 });
 
-run(app);
+run(app).catch((err) => {
+  console.error(err);
+});
 ```
 
 You can listen to errors via events:
@@ -371,8 +419,11 @@ You can listen to errors via events:
 const helloWorld = task({
   id: "app.onError",
   on: helloWorld.events.onError,
-  run({ error, input }, deps) {
+  run({ error, input, suppress }, deps) {
     // this will be called when an error happens
+
+    // if you handled the error, and you don't want it propagated to the top, supress the propagation.
+    suppress();
   },
 });
 ```
@@ -397,7 +448,7 @@ const helloWorld = task({
 });
 ```
 
-This is particularly helpful to use in conjunction with global middlewares, or global events, etc.
+This is particularly helpful to use in conjunction with global middlewares, or global events, they can read some meta tag definition and act accordingly.
 
 The interfaces look like this:
 
@@ -495,7 +546,7 @@ Now you can freely use any of the tasks, resources, events, and middlewares from
 
 This approach is very powerful when you have multiple packages and you want to compose them together.
 
-## Real world usage.
+## Real world examples
 
 Typically you have an express server (to handle HTTP requests), a database, and a bunch of services. You can define all of these in a single file and run them.
 
@@ -570,47 +621,7 @@ const app = resource({
 run();
 ```
 
-### Resources can receive configs
-
-Resources are super configurable.
-
-```ts
-import { resource, run } from "@bluelibs/runner";
-
-type EmailerOptions = {
-  smtpUrl: string;
-  defaultFrom: string;
-};
-
-const emailerResource = resource({
-  id: "app.config",
-  async init(config: EmailerOptions) {
-    return {
-      sendEmail: async (to: string, subject: string, body: string) => {
-        // send *email*
-      },
-    };
-    // or return some service that sends email
-  },
-});
-
-const app = resource({
-  id: "app",
-  register: [
-    // You can pass the config here
-    emailerResource.with({
-      smtpUrl: "smtp://localhost",
-      defaultFrom: "",
-    }),
-    // Leaving it simply emailerResource is similar to passing an empty object.
-    // We leave this for simplicity in some cases but we recommend using .with() for clarity.
-  ],
-});
-
-run(app);
-```
-
-## Useful events
+## Global Events
 
 ### Task level
 
@@ -650,15 +661,19 @@ const app = resource({
 run(app);
 ```
 
-## Resource level
+### Business Config
 
 ```ts
 import { task, run, event } from "@bluelibs/runner";
 
+const businessData = {
+  pricePerSubscription: 9.99,
+};
+
 const businessConfig = resource({
   id: "app.config",
   async init() {
-    return businessData;
+    return businessData; // if you use it as a const you will have full typesafety
   },
 });
 
@@ -690,10 +705,12 @@ const app = resource({
 run(app);
 ```
 
-## Moving further
+### Moving further
 
 This is just a "language" of developing applications. It simplifies dependency injection to the barebones, it forces you to think more functional and use classes less.
 
+This doesn't mean you shouldn't use classes, just not for hooking things up together.
+
 You can add many services or external things into the runner ecosystem with things like:
 
 ```ts
@@ -743,7 +760,7 @@ const app = resource({
 run(app);
 ```
 
-## Inter-communication between resources
+### Inter-communication between resources
 
 By stating dependencies you often don't care about the initialisation order, but sometimes you really do, for example, let's imagine a security service that allows you to inject a custom hashing function let's say to shift from md5 to sha256.
 
@@ -829,6 +846,39 @@ const app = resource({
 });
 ```
 
+## Overrides
+
+Previously, we explored how we can extend functionality through events. However, sometimes you want to override a resource with a new one or simply swap out a task or a middleware that you import from another package and they don't offer the ability.
+
+```ts
+import { resource, run, event } from "@bluelibs/runner";
+
+// This example is for resources but override works for tasks, events, and middleware as well.
+const securityResource = resource({
+  id: "app.security",
+  async init() {
+    // returns a security service
+  },
+});
+
+const override = resource({
+  ...securityResource,
+  init: async () => {
+    // a new and custom service
+  },
+});
+
+const app = resource({
+  id: "app",
+  register: [securityResource], // this resource might be registered by any element in the dependency tree.
+  overrides: [override],
+});
+```
+
+Now the `securityResource` will be overriden by the new one and whenever it's used it will use the new one.
+
+Overrides can only happen once and only if the overriden resource is registered. If two resources try to override the same resource, an error will be thrown.
+
 ## Logging
 
 We expose through globals a logger that you can use to log things.
@@ -891,39 +941,6 @@ You can in theory do it in `hooks` as well, but as specified `hooks` are mostly
 
 The logger's `log()` function is async as it works with events. If you don't want your system hanging on logs, simply omit the `await`
 
-## Overrides
-
-Previously, we explored how we can extend functionality through events. However, sometimes you want to override a resource with a new one or simply swap out a task or a middleware that you import from another package and they don't offer the ability.
-
-```ts
-import { resource, run, event } from "@bluelibs/runner";
-
-// This example is for resources but override works for tasks, events, and middleware as well.
-const securityResource = resource({
-  id: "app.security",
-  async init() {
-    // returns a security service
-  },
-});
-
-const override = resource({
-  ...securityResource,
-  init: async () => {
-    // a new and custom service
-  },
-});
-
-const app = resource({
-  id: "app",
-  register: [securityResource], // this resource might be registered by any element in the dependency tree.
-  overrides: [override],
-});
-```
-
-Now the `securityResource` will be overriden by the new one and whenever it's used it will use the new one.
-
-Overrides can only happen once and only if the overriden resource is registered. If two resources try to override the same resource, an error will be thrown.
-
 ## Testing
 
 ### Unit Testing

package/dist/define.d.ts

@@ -1,6 +1,6 @@
 import { ITask, ITaskDefinition, IResource, IResourceWithConfig, IResourceDefinintion, IEventDefinition, IMiddlewareDefinition, DependencyMapType, IMiddleware } from "./defs";
-export declare function defineTask<Input = undefined, Output extends Promise<any> = any, Deps extends DependencyMapType = any, Test = any>(config: ITaskDefinition<Input, Output, Deps, Test>): ITask<Input, Output, Deps, Test>;
-export declare function defineResource<TConfig = void, TValue = any, TDeps extends DependencyMapType = {}>(constConfig: IResourceDefinintion<TConfig, TValue, TDeps>): IResource<TConfig, TValue, TDeps>;
+export declare function defineTask<Input = undefined, Output extends Promise<any> = any, Deps extends DependencyMapType = any, Test = any>(taskConfig: ITaskDefinition<Input, Output, Deps, Test>): ITask<Input, Output, Deps, Test>;
+export declare function defineResource<TConfig = void, TValue = any, TDeps extends DependencyMapType = {}, THooks = any>(constConfig: IResourceDefinintion<TConfig, TValue, TDeps, THooks>): IResource<TConfig, TValue, TDeps>;
 export declare function defineEvent<TPayload = any>(config: IEventDefinition<TPayload>): IEventDefinition<TPayload>;
 export declare function defineMiddleware<TDeps extends DependencyMapType = {}>(config: IMiddlewareDefinition<TDeps>): IMiddleware<TDeps>;
 export declare function isTask(definition: any): definition is ITask;

package/dist/define.js

@@ -11,25 +11,26 @@ exports.isEvent = isEvent;
 exports.isMiddleware = isMiddleware;
 const defs_1 = require("./defs");
 const errors_1 = require("./errors");
-function defineTask(config) {
+function defineTask(taskConfig) {
     return {
         [defs_1.symbols.task]: true,
-        id: config.id,
-        dependencies: config.dependencies || {},
-        middleware: config.middleware || [],
-        run: config.run,
-        on: config.on,
+        id: taskConfig.id,
+        dependencies: taskConfig.dependencies || {},
+        middleware: taskConfig.middleware || [],
+        run: taskConfig.run,
+        on: taskConfig.on,
         events: {
             beforeRun: defineEvent({
-                id: `${config.id}.beforeRun`,
+                id: `${taskConfig.id}.beforeRun`,
             }),
             afterRun: defineEvent({
-                id: `${config.id}.afterRun`,
+                id: `${taskConfig.id}.afterRun`,
             }),
             onError: defineEvent({
-                id: `${config.id}.onError`,
+                id: `${taskConfig.id}.onError`,
             }),
         },
+        meta: taskConfig.meta || {},
         // autorun,
     };
 }
@@ -61,6 +62,8 @@ function defineResource(constConfig) {
                 id: `${constConfig.id}.onError`,
             }),
         },
+        meta: constConfig.meta || {},
+        middleware: constConfig.middleware || [],
     };
 }
 function defineEvent(config) {

package/dist/define.js.map

@@ -1 +1 @@
-{"version":3,"file":"define.js","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"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"}

package/dist/defs.d.ts

@@ -9,7 +9,7 @@ export declare const symbols: {
 export interface IMeta {
     title?: string;
     description?: string;
-    tags: string[];
+    tags?: string[];
 }
 export interface ITaskMeta extends IMeta {
 }
@@ -44,6 +44,10 @@ export type AfterRunEventPayload<TInput, TOutput> = {
 };
 export type OnErrorEventPayload = {
     error: any;
+    /**
+     * This function can be called to suppress the error from being thrown.
+     */
+    suppress(): void;
 };
 export type BeforeInitEventPayload<TConfig> = {
     config: TConfig;
@@ -68,10 +72,10 @@ export interface ITask<TInput = any, TOutput extends Promise<any> = any, TDepend
         onError: IEventDefinition<OnErrorEventPayload>;
     };
 }
-export interface IResourceDefinintion<TConfig = void, TValue = unknown, TDependencies extends DependencyMapType = {}> {
+export interface IResourceDefinintion<TConfig = void, TValue = unknown, TDependencies extends DependencyMapType = {}, THooks = any> {
     id: string;
     dependencies?: TDependencies | ((config: TConfig) => TDependencies);
-    hooks?: IHookDefinition<TDependencies>[] | ((config: TConfig) => IHookDefinition<TDependencies>[]);
+    hooks?: IHookDefinition<TDependencies, THooks>[] | ((config: TConfig) => IHookDefinition<TDependencies, THooks>[]);
     register?: Array<RegisterableItems> | ((config: TConfig) => Array<RegisterableItems>);
     init?: (config: TConfig, dependencies: DependencyValuesType<TDependencies>) => Promise<TValue>;
     /**
@@ -85,6 +89,7 @@ export interface IResourceDefinintion<TConfig = void, TValue = unknown, TDepende
     dispose?: (value: TValue, config: TConfig, dependencies: DependencyValuesType<TDependencies>) => Promise<TValue>;
     meta?: IResourceMeta;
     overrides?: Array<IResource | ITask | IMiddleware | IResourceWithConfig>;
+    middleware?: IMiddlewareDefinition[];
 }
 export interface IResource<TConfig = void, TValue = any, TDependencies extends DependencyMapType = any> extends IResourceDefinintion<TConfig, TValue, TDependencies> {
     with(config: TConfig): IResourceWithConfig<TConfig, TValue, TDependencies>;
@@ -99,6 +104,7 @@ export interface IResource<TConfig = void, TValue = any, TDependencies extends D
     };
     hooks: IHookDefinition<TDependencies>[] | ((config: TConfig) => IHookDefinition<TDependencies>[]);
     overrides: Array<IResource | ITask | IMiddleware | IResourceWithConfig>;
+    middleware: IMiddlewareDefinition[];
 }
 export interface IResourceWithConfig<TConfig = any, TValue = any, TDependencies extends DependencyMapType = any> {
     resource: IResource<TConfig, TValue, TDependencies>;
@@ -107,6 +113,7 @@ export interface IResourceWithConfig<TConfig = any, TValue = any, TDependencies
 export interface IEvent<TPayload = any> {
     id: string;
     data: TPayload;
+    timestamp: Date;
 }
 export type EventHandlerType<T = any> = (event: IEvent<T>) => any | Promise<any>;
 export interface IEventDefinition<TPayload = void> {
@@ -129,10 +136,12 @@ export interface IMiddlewareDefinitionConfigured<C extends Record<string, any> =
 }
 export interface IMiddlewareExecutionInput {
     taskDefinition?: ITask;
-    input: any;
-    next: (input?: any) => Promise<any>;
+    resourceDefinition?: IResource;
+    config?: any;
+    input?: any;
+    next: (taskInputOrResourceConfig?: any) => Promise<any>;
 }
 export interface IHookDefinition<D extends DependencyMapType = {}, T = any> {
-    event: IEventDefinition<T>;
+    event: "*" | IEventDefinition<T>;
     run: (event: IEvent<T>, dependencies: DependencyValuesType<D>) => Promise<void> | void;
 }

package/dist/globalEvents.d.ts

@@ -15,7 +15,8 @@ export declare const globalEvents: {
             output: any;
         }>;
         onError: import("./defs").IEventDefinition<{
-            error: Error;
+            error: any;
+            suppress: () => void;
             task: ITask<any, any, any>;
         }>;
     };
@@ -31,6 +32,7 @@ export declare const globalEvents: {
         }>;
         onError: import("./defs").IEventDefinition<{
             error: Error;
+            suppress: () => void;
             resource: IResource<any, any, any>;
         }>;
     };

package/dist/globalEvents.js.map

@@ -1 +1 @@
-{"version":3,"file":"globalEvents.js","sourceRoot":"","sources":["../src/globalEvents.ts"],"names":[],"mappings":";;;AAAA,qCAAuC;AAI1B,QAAA,YAAY,GAAG;IAC1B,UAAU,EAAE,IAAA,oBAAW,EAAC;QACtB,EAAE,EAAE,mBAAmB;KACxB,CAAC;IACF,SAAS,EAAE,IAAA,oBAAW,EAAC;QACrB,EAAE,EAAE,kBAAkB;KACvB,CAAC;IACF,GAAG,EAAE,IAAA,oBAAW,EAAO;QACrB,EAAE,EAAE,YAAY;KACjB,CAAC;IACF,KAAK,EAAE;QACL,SAAS,EAAE,IAAA,oBAAW,EAGnB;YACD,EAAE,EAAE,wBAAwB;SAC7B,CAAC;QACF,QAAQ,EAAE,IAAA,oBAAW,EAIlB;YACD,EAAE,EAAE,uBAAuB;SAC5B,CAAC;QACF,OAAO,EAAE,IAAA,oBAAW,EAGjB;YACD,EAAE,EAAE,sBAAsB;SAC3B,CAAC;KACH;IACD,SAAS,EAAE;QACT,UAAU,EAAE,IAAA,oBAAW,EAGpB;YACD,EAAE,EAAE,6BAA6B;SAClC,CAAC;QACF,SAAS,EAAE,IAAA,oBAAW,EAInB;YACD,EAAE,EAAE,4BAA4B;SACjC,CAAC;QACF,OAAO,EAAE,IAAA,oBAAW,EAGjB;YACD,EAAE,EAAE,0BAA0B;SAC/B,CAAC;KACH;CACF,CAAC;AAEW,QAAA,iBAAiB,GAAG;IAC/B,oBAAY,CAAC,UAAU;IACvB,oBAAY,CAAC,SAAS;IACtB,oBAAY,CAAC,KAAK,CAAC,SAAS;IAC5B,oBAAY,CAAC,KAAK,CAAC,QAAQ;IAC3B,oBAAY,CAAC,KAAK,CAAC,OAAO;IAC1B,oBAAY,CAAC,SAAS,CAAC,UAAU;IACjC,oBAAY,CAAC,SAAS,CAAC,SAAS;IAChC,oBAAY,CAAC,SAAS,CAAC,OAAO;CAC/B,CAAC"}
+{"version":3,"file":"globalEvents.js","sourceRoot":"","sources":["../src/globalEvents.ts"],"names":[],"mappings":";;;AAAA,qCAAuC;AAI1B,QAAA,YAAY,GAAG;IAC1B,UAAU,EAAE,IAAA,oBAAW,EAAC;QACtB,EAAE,EAAE,mBAAmB;KACxB,CAAC;IACF,SAAS,EAAE,IAAA,oBAAW,EAAC;QACrB,EAAE,EAAE,kBAAkB;KACvB,CAAC;IACF,GAAG,EAAE,IAAA,oBAAW,EAAO;QACrB,EAAE,EAAE,YAAY;KACjB,CAAC;IACF,KAAK,EAAE;QACL,SAAS,EAAE,IAAA,oBAAW,EAGnB;YACD,EAAE,EAAE,wBAAwB;SAC7B,CAAC;QACF,QAAQ,EAAE,IAAA,oBAAW,EAIlB;YACD,EAAE,EAAE,uBAAuB;SAC5B,CAAC;QACF,OAAO,EAAE,IAAA,oBAAW,EAIjB;YACD,EAAE,EAAE,sBAAsB;SAC3B,CAAC;KACH;IACD,SAAS,EAAE;QACT,UAAU,EAAE,IAAA,oBAAW,EAGpB;YACD,EAAE,EAAE,6BAA6B;SAClC,CAAC;QACF,SAAS,EAAE,IAAA,oBAAW,EAInB;YACD,EAAE,EAAE,4BAA4B;SACjC,CAAC;QACF,OAAO,EAAE,IAAA,oBAAW,EAIjB;YACD,EAAE,EAAE,0BAA0B;SAC/B,CAAC;KACH;CACF,CAAC;AAEW,QAAA,iBAAiB,GAAG;IAC/B,oBAAY,CAAC,UAAU;IACvB,oBAAY,CAAC,SAAS;IACtB,oBAAY,CAAC,KAAK,CAAC,SAAS;IAC5B,oBAAY,CAAC,KAAK,CAAC,QAAQ;IAC3B,oBAAY,CAAC,KAAK,CAAC,OAAO;IAC1B,oBAAY,CAAC,SAAS,CAAC,UAAU;IACjC,oBAAY,CAAC,SAAS,CAAC,SAAS;IAChC,oBAAY,CAAC,SAAS,CAAC,OAAO;CAC/B,CAAC"}

package/dist/index.d.ts

@@ -16,7 +16,8 @@ declare const globals: {
                 output: any;
             }>;
             onError: import("./defs").IEventDefinition<{
-                error: Error;
+                error: any;
+                suppress: () => void;
                 task: import("./defs").ITask<any, any, any>;
             }>;
         };
@@ -32,6 +33,7 @@ declare const globals: {
             }>;
             onError: import("./defs").IEventDefinition<{
                 error: Error;
+                suppress: () => void;
                 resource: import("./defs").IResource<any, any, any>;
             }>;
         };