@bluelibs/runner 3.0.0 → 3.1.0

package/README.md

@@ -63,7 +63,7 @@ const createUser = task({
 const app = resource({
   id: "app",
   // Here you make the system aware of resources, tasks, middleware, and events.
-  register: [server, createUser],
+  register: [server.with({ port: 3000 }), createUser],
   dependencies: { server, createUser },
   init: async (_, { server, createUser }) => {
     server.app.post("/users", async (req, res) => {
@@ -74,7 +74,7 @@ const app = resource({
 });
 
 // That's it. No webpack configs, no decorators, no XML.
-const { dispose } = await run(app, { port: 3000 });
+const { dispose } = await run(app);
 ```
 
 ## The Big Four: Your New Building Blocks
@@ -1670,6 +1670,107 @@ async function processBatch(items: any[]) {
 - **Ignoring disposal**: Always dispose semaphores to prevent memory leaks
 - **Wrong permit count**: Too few = slow, too many = defeats the purpose
 
+## Anonymous IDs: Because Naming Things Is Hard
+
+One of our favorite quality-of-life features: **anonymous IDs**. Instead of manually naming every component, the framework can generate unique symbol-based identifiers based on your file path and variable name. It's like having a really good naming assistant who never gets tired.
+
+### How Anonymous IDs Work
+
+When you omit the `id` property, the framework generates a unique symbol based on file path. Takes up until first 'src' or 'node_modules' and generates based on the paths.
+
+```typescript
+// In src/services/email.ts
+const emailService = resource({
+  // Generated ID: Symbol('services.email.resource')
+  init: async () => new EmailService(),
+});
+
+// In src/tasks/user.ts
+const createUser = task({
+  // Generated ID: Symbol('tasks.user.task')
+  dependencies: { emailService },
+  run: async (userData, { emailService }) => {
+    // Business logic
+  },
+});
+```
+
+### Benefits of Anonymous IDs
+
+1. **Less Bikeshedding**: No more debates about naming conventions
+2. **Automatic Uniqueness**: Guaranteed collision-free identifiers
+3. **Faster Prototyping**: Just write code, framework handles the rest
+4. **Refactor-Friendly**: Rename files/variables and IDs update automatically
+5. **Stack Trace Integration**: Error messages include helpful file locations
+
+### When to Use Manual vs Anonymous IDs
+
+| Use Case                | Recommendation | Reason                                  |
+| ----------------------- | -------------- | --------------------------------------- |
+| Internal tasks          | Anonymous      | No external references needed           |
+| Event definitions       | Manual         | Need predictable names for listeners    |
+| Public APIs             | Manual         | External modules need stable references |
+| Middleware              | Manual         | Often reused across projects            |
+| Configuration resources | Anonymous      | Usually internal infrastructure         |
+| Test doubles/mocks      | Anonymous      | One-off usage in tests                  |
+| Cross-module services   | Manual         | Multiple files depend on them           |
+
+### Anonymous ID Examples by Pattern
+
+```typescript
+// ✅ Great for anonymous IDs
+const database = resource({
+  init: async () => new Database(),
+  dispose: async (db) => db.close(),
+});
+
+const processPayment = task({
+  dependencies: { database },
+  run: async (payment, { database }) => {
+    // Internal business logic
+  },
+});
+
+// ✅ Better with manual IDs
+const paymentProcessed = event<{ paymentId: string }>({
+  id: "app.events.paymentProcessed", // Other modules listen to this
+});
+
+const authMiddleware = middleware({
+  id: "app.middleware.auth", // Reused across multiple tasks
+  run: async ({ task, next }) => {
+    // Auth logic
+  },
+});
+
+// ✅ Mixed approach - totally fine!
+const app = resource({
+  id: "app", // Main entry point gets manual ID
+  register: [
+    database, // Anonymous
+    processPayment, // Anonymous
+    paymentProcessed, // Manual
+    authMiddleware, // Manual
+  ],
+});
+```
+
+### Debugging with Anonymous IDs
+
+Anonymous IDs show up clearly in error messages and logs:
+
+```typescript
+// Error message example:
+// TaskRunError: Task failed at Symbol('tasks.payment.task')
+//   at file:///project/src/tasks/payment.ts:15:23
+
+// Logging with context:
+logger.info("Processing payment", {
+  taskId: processPayment.definition.id, // Symbol('tasks.payment.task')
+  file: "src/tasks/payment.ts",
+});
+```
+
 ## Why Choose BlueLibs Runner?
 
 ### What You Get

package/dist/define.d.ts

@@ -1,4 +1,4 @@
-import { ITask, ITaskDefinition, IResource, IResourceWithConfig, IResourceDefinition, IEventDefinition, IMiddlewareDefinition, DependencyMapType, DependencyValuesType, IMiddleware, IEventDefinitionConfig, RegisterableItems } from "./defs";
+import { ITask, ITaskDefinition, IResource, IResourceWithConfig, IResourceDefinition, IEventDefinition, IMiddlewareDefinition, DependencyMapType, DependencyValuesType, IMiddleware, IEvent, RegisterableItems } from "./defs";
 export declare function defineTask<Input = undefined, Output extends Promise<any> = any, Deps extends DependencyMapType = any, TOn extends "*" | IEventDefinition | undefined = undefined>(taskConfig: ITaskDefinition<Input, Output, Deps, TOn>): ITask<Input, Output, Deps, TOn>;
 export declare function defineResource<TConfig = void, TValue = any, TDeps extends DependencyMapType = {}, TPrivate = any>(constConfig: IResourceDefinition<TConfig, TValue, TDeps, TPrivate>): IResource<TConfig, TValue, TDeps, TPrivate>;
 /**
@@ -10,7 +10,7 @@ export declare function defineResource<TConfig = void, TValue = any, TDeps exten
 export declare function defineIndex<T extends Record<string, RegisterableItems>, D extends {
     [K in keyof T]: T[K] extends IResourceWithConfig<any, any, any> ? T[K]["resource"] : T[K];
 } & DependencyMapType>(items: T): IResource<void, DependencyValuesType<D>, D>;
-export declare function defineEvent<TPayload = any>(config: IEventDefinitionConfig<TPayload>): IEventDefinition<TPayload>;
+export declare function defineEvent<TPayload = void>(config: IEventDefinition<TPayload>): IEvent<TPayload>;
 export type MiddlewareEverywhereOptions = {
     /**
      * Enable this for tasks. Default is true.
@@ -25,5 +25,5 @@ export declare function defineMiddleware<TConfig extends Record<string, any>, TD
 export declare function isTask(definition: any): definition is ITask;
 export declare function isResource(definition: any): definition is IResource;
 export declare function isResourceWithConfig(definition: any): definition is IResourceWithConfig;
-export declare function isEvent(definition: any): definition is IEventDefinition;
+export declare function isEvent(definition: any): definition is IEvent;
 export declare function isMiddleware(definition: any): definition is IMiddleware;

package/dist/define.js

@@ -16,10 +16,12 @@ const getCallerFile_1 = require("./tools/getCallerFile");
 // Helper function to get the caller file
 function defineTask(taskConfig) {
     const filePath = (0, getCallerFile_1.getCallerFile)();
+    const isAnonymous = !Boolean(taskConfig.id);
+    const id = taskConfig.id || (0, getCallerFile_1.generateCallerIdFromFile)(filePath, "task");
     return {
         [defs_1.symbols.task]: true,
         [defs_1.symbols.filePath]: filePath,
-        id: taskConfig.id,
+        id,
         dependencies: taskConfig.dependencies || {},
         middleware: taskConfig.middleware || [],
         run: taskConfig.run,
@@ -28,19 +30,25 @@ function defineTask(taskConfig) {
         events: {
             beforeRun: {
                 ...defineEvent({
-                    id: `${taskConfig.id}.events.beforeRun`,
+                    id: isAnonymous
+                        ? Symbol(`anonymous-task.events.beforeRun`)
+                        : `${id}.events.beforeRun`,
                 }),
                 [defs_1.symbols.filePath]: (0, getCallerFile_1.getCallerFile)(),
             },
             afterRun: {
                 ...defineEvent({
-                    id: `${taskConfig.id}.events.afterRun`,
+                    id: isAnonymous
+                        ? Symbol(`anonymous-task.events.afterRun`)
+                        : `${id}.events.afterRun`,
                 }),
                 [defs_1.symbols.filePath]: (0, getCallerFile_1.getCallerFile)(),
             },
             onError: {
                 ...defineEvent({
-                    id: `${taskConfig.id}.events.onError`,
+                    id: isAnonymous
+                        ? Symbol(`anonymous-task.events.onError`)
+                        : `${id}.events.onError`,
                 }),
                 [defs_1.symbols.filePath]: (0, getCallerFile_1.getCallerFile)(),
             },
@@ -50,11 +58,16 @@ function defineTask(taskConfig) {
     };
 }
 function defineResource(constConfig) {
-    const filePath = (0, getCallerFile_1.getCallerFile)();
+    // The symbolFilePath might already come from defineIndex() for example
+    const filePath = constConfig[defs_1.symbolFilePath] || (0, getCallerFile_1.getCallerFile)();
+    const isIndexResource = constConfig[defs_1.symbolIndexResource] || false;
+    const isAnonymous = !Boolean(constConfig.id);
+    const id = constConfig.id ||
+        (0, getCallerFile_1.generateCallerIdFromFile)(filePath, isIndexResource ? "index" : "resource");
     return {
         [defs_1.symbols.resource]: true,
         [defs_1.symbols.filePath]: filePath,
-        id: constConfig.id,
+        id,
         dependencies: constConfig.dependencies,
         dispose: constConfig.dispose,
         register: constConfig.register || [],
@@ -72,19 +85,25 @@ function defineResource(constConfig) {
         events: {
             beforeInit: {
                 ...defineEvent({
-                    id: `${constConfig.id}.events.beforeInit`,
+                    id: isAnonymous
+                        ? Symbol(`anonymous-resource.events.beforeInit`)
+                        : `${id}.events.beforeInit`,
                 }),
                 [defs_1.symbols.filePath]: filePath,
             },
             afterInit: {
                 ...defineEvent({
-                    id: `${constConfig.id}.events.afterInit`,
+                    id: isAnonymous
+                        ? Symbol(`anonymous-resource.events.afterInit`)
+                        : `${id}.events.afterInit`,
                 }),
                 [defs_1.symbols.filePath]: filePath,
             },
             onError: {
                 ...defineEvent({
-                    id: `${constConfig.id}.events.onError`,
+                    id: isAnonymous
+                        ? Symbol(`anonymous-resource.events.onError`)
+                        : `${id}.events.onError`,
                 }),
                 [defs_1.symbols.filePath]: filePath,
             },
@@ -112,27 +131,33 @@ function defineIndex(items) {
             dependencies[key] = item;
         }
     }
+    const callerFilePath = (0, getCallerFile_1.getCallerFile)();
     return defineResource({
-        id: `index.${Math.random().toString(36).slice(2)}`,
         register,
         dependencies,
         async init(_, deps) {
             return deps;
         },
+        [defs_1.symbols.filePath]: callerFilePath,
+        [defs_1.symbols.indexResource]: true,
     });
 }
 function defineEvent(config) {
+    const callerFilePath = (0, getCallerFile_1.getCallerFile)();
     return {
-        [defs_1.symbols.filePath]: (0, getCallerFile_1.getCallerFile)(),
-        [defs_1.symbolEvent]: true,
         ...config,
+        id: config.id || (0, getCallerFile_1.generateCallerIdFromFile)(callerFilePath, "event"),
+        [defs_1.symbols.filePath]: callerFilePath,
+        [defs_1.symbolEvent]: true, // This is a workaround
     };
 }
 function defineMiddleware(middlewareDef) {
+    const filePath = (0, getCallerFile_1.getCallerFile)();
     const object = {
-        [defs_1.symbols.filePath]: (0, getCallerFile_1.getCallerFile)(),
+        [defs_1.symbols.filePath]: filePath,
         [defs_1.symbols.middleware]: true,
         config: {},
+        id: middlewareDef.id || (0, getCallerFile_1.generateCallerIdFromFile)(filePath, "middleware"),
         ...middlewareDef,
         dependencies: middlewareDef.dependencies || {},
     };
@@ -155,7 +180,7 @@ function defineMiddleware(middlewareDef) {
                 [defs_1.symbols.middlewareEverywhereTasks]: tasks,
                 [defs_1.symbols.middlewareEverywhereResources]: resources,
                 everywhere() {
-                    throw errors_1.Errors.middlewareAlreadyGlobal(middlewareDef.id);
+                    throw errors_1.Errors.middlewareAlreadyGlobal(object.id);
                 },
             };
         },

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

@@ -1,3 +1,4 @@
+import { MiddlewareEverywhereOptions } from "./define";
 export { ICacheInstance } from "./globals/middleware/cache.middleware";
 export declare const symbolTask: unique symbol;
 export declare const symbolResource: unique symbol;
@@ -11,10 +12,12 @@ export declare const symbolMiddlewareEverywhereResources: unique symbol;
 export declare const symbolFilePath: unique symbol;
 export declare const symbolDispose: unique symbol;
 export declare const symbolStore: unique symbol;
+export declare const symbolIndexResource: unique symbol;
 export declare const symbols: {
     task: symbol;
     resource: symbol;
     resourceWithConfig: symbol;
+    indexResource: symbol;
     event: symbol;
     middleware: symbol;
     middlewareEverywhereTasks: symbol;
@@ -40,22 +43,31 @@ export type DependencyMapType = Record<string, ITask<any, any, any, any> | IReso
 type ExtractTaskInput<T> = T extends ITask<infer I, any, infer D> ? I : never;
 type ExtractTaskOutput<T> = T extends ITask<any, infer O, infer D> ? O : never;
 type ExtractResourceValue<T> = T extends IResource<any, infer V, infer D> ? V : never;
-type ExtractEventParams<T> = T extends IEventDefinition<infer P> ? P : never;
+type ExtractEventParams<T> = T extends IEvent<infer P> ? P : never;
+/**
+ * This represents a task dependency function that can be called with or without parameters.
+ */
 type TaskDependency<I, O> = (...args: I extends null | void ? [] : [I]) => O;
+/**
+ * This represents the resource's value type.
+ */
 type ResourceDependency<V> = V;
-type EventDependency<P> = (input: P) => Promise<void>;
+/**
+ * This represents an event emission function that can be called with or without parameters.
+ */
+type EventDependency<P> = P extends void ? (() => Promise<void>) & ((input?: Record<string, never>) => Promise<void>) : (input: P) => Promise<void>;
 export type DependencyValueType<T> = T extends ITask<any, any, any> ? TaskDependency<ExtractTaskInput<T>, ExtractTaskOutput<T>> : T extends IResource<any, any> ? ResourceDependency<ExtractResourceValue<T>> : T extends IEventDefinition<any> ? EventDependency<ExtractEventParams<T>> : never;
 export type DependencyValuesType<T extends DependencyMapType> = {
     [K in keyof T]: DependencyValueType<T[K]>;
 };
 export type RegisterableItems<T = any> = IResourceWithConfig<any> | IResource<void, any, any, any> | IResource<{
     [K in any]?: any;
-}, any, any, any> | ITaskDefinition<any, any, any, any> | IMiddlewareDefinition<any> | IEventDefinition<any>;
+}, any, any, any> | ITask<any, any, any, any> | IMiddleware<any> | IEvent<any>;
 export type MiddlewareAttachments = IMiddleware<void> | IMiddleware<{
     [K in any]?: any;
 }> | IMiddlewareConfigured<any>;
 export interface ITaskDefinition<TInput = any, TOutput extends Promise<any> = any, TDependencies extends DependencyMapType = {}, TOn extends "*" | IEventDefinition<any> | undefined = undefined> {
-    id: string;
+    id?: string | symbol;
     dependencies?: TDependencies | (() => TDependencies);
     middleware?: MiddlewareAttachments[];
     /**
@@ -68,7 +80,7 @@ export interface ITaskDefinition<TInput = any, TOutput extends Promise<any> = an
      */
     listenerOrder?: number;
     meta?: ITaskMeta;
-    run: (input: TOn extends undefined ? TInput : IEvent<TOn extends "*" ? any : ExtractEventParams<TOn>>, dependencies: DependencyValuesType<TDependencies>) => TOutput;
+    run: (input: TOn extends undefined ? TInput : IEventEmission<TOn extends "*" ? any : ExtractEventParams<TOn>>, dependencies: DependencyValuesType<TDependencies>) => TOutput;
 }
 export type BeforeRunEventPayload<TInput> = {
     input: TInput;
@@ -96,6 +108,7 @@ export type AfterInitEventPayload<TConfig, TValue> = {
  * This is the response after the definition has been prepared. TODO: better naming?
  */
 export interface ITask<TInput = any, TOutput extends Promise<any> = any, TDependencies extends DependencyMapType = {}, TOn extends "*" | IEventDefinition<any> | undefined = undefined> extends ITaskDefinition<TInput, TOutput, TDependencies, TOn> {
+    id: string | symbol;
     dependencies: TDependencies | (() => TDependencies);
     computedDependencies?: DependencyValuesType<TDependencies>;
     middleware: MiddlewareAttachments[];
@@ -103,13 +116,13 @@ export interface ITask<TInput = any, TOutput extends Promise<any> = any, TDepend
      * These events are automatically populated after the task has been defined.
      */
     events: {
-        beforeRun: IEventDefinition<BeforeRunEventPayload<TInput>>;
-        afterRun: IEventDefinition<AfterRunEventPayload<TInput, TOutput>>;
-        onError: IEventDefinition<OnErrorEventPayload>;
+        beforeRun: IEvent<BeforeRunEventPayload<TInput>>;
+        afterRun: IEvent<AfterRunEventPayload<TInput, TOutput>>;
+        onError: IEvent<OnErrorEventPayload>;
     };
 }
 export interface IResourceDefinition<TConfig = any, TValue = unknown, TDependencies extends DependencyMapType = {}, TContext = any, THooks = any, TRegisterableItems = any> {
-    id: string;
+    id?: string | symbol;
     dependencies?: TDependencies | ((config: TConfig) => TDependencies);
     register?: Array<RegisterableItems> | ((config: TConfig) => Array<RegisterableItems>);
     init?: (this: any, config: TConfig, dependencies: DependencyValuesType<TDependencies>, context: TContext) => Promise<TValue>;
@@ -126,17 +139,26 @@ export interface IResourceDefinition<TConfig = any, TValue = unknown, TDependenc
     overrides?: Array<IResource | ITask | IMiddleware | IResourceWithConfig>;
     middleware?: MiddlewareAttachments[];
     context?: () => TContext;
+    /**
+     * This is optional and used from an index resource to get the correct caller.
+     */
+    [symbolFilePath]?: string;
+    /**
+     * This is used internally when creating index resources.
+     */
+    [symbolIndexResource]?: boolean;
 }
 export interface IResource<TConfig = void, TValue = any, TDependencies extends DependencyMapType = any, TContext = any> extends IResourceDefinition<TConfig, TValue, TDependencies, TContext> {
+    id: string | symbol;
     with(config: TConfig): IResourceWithConfig<TConfig, TValue, TDependencies>;
     register: Array<RegisterableItems> | ((config: TConfig) => Array<RegisterableItems>);
     /**
      * These events are automatically populated after the task has been defined.
      */
     events: {
-        beforeInit: IEventDefinition<BeforeInitEventPayload<TConfig>>;
-        afterInit: IEventDefinition<AfterInitEventPayload<TConfig, TValue>>;
-        onError: IEventDefinition<OnErrorEventPayload>;
+        beforeInit: IEvent<BeforeInitEventPayload<TConfig>>;
+        afterInit: IEvent<AfterInitEventPayload<TConfig, TValue>>;
+        onError: IEvent<OnErrorEventPayload>;
     };
     overrides: Array<IResource | ITask | IMiddleware | IResourceWithConfig>;
     middleware: MiddlewareAttachments[];
@@ -146,8 +168,27 @@ export interface IResourceWithConfig<TConfig = any, TValue = any, TDependencies
     resource: IResource<TConfig, TValue, TDependencies>;
     config: TConfig;
 }
-export interface IEvent<TPayload = any> {
-    id: string;
+export type EventHandlerType<T = any> = (event: IEventEmission<T>) => any | Promise<any>;
+export interface IEventDefinition<TPayload = void> {
+    id?: string | symbol;
+    meta?: IEventMeta;
+}
+export interface IEvent<TPayload = any> extends IEventDefinition<TPayload> {
+    id: string | symbol;
+    /**
+     * We use this event to discriminate between resources with just 'id' and 'events' as they collide. This is a workaround, should be redone using classes and instanceof.
+     */
+    [symbolEvent]: true;
+}
+/**
+ * This represents the object that is passed to event handlers
+ */
+export interface IEventEmission<TPayload = any> {
+    /**
+     * The ID of the event. This is the same as the event's ID.
+     * This is useful for global event listeners.
+     */
+    id: string | symbol;
     /**
      * The data that the event carries. It can be anything.
      */
@@ -159,23 +200,10 @@ export interface IEvent<TPayload = any> {
     /**
      * The source of the event. This can be useful for debugging.
      */
-    source: string;
-}
-export type EventHandlerType<T = any> = (event: IEvent<T>) => any | Promise<any>;
-export interface IEventDefinitionConfig<TPayload = void> {
-    id: string;
-    meta?: IEventMeta;
-}
-export interface IEventDefinition<TPayload = void> {
-    id: string;
-    /**
-     * We use this event to discriminate between resources with just 'id' and 'events' as they collide. This is a workaround, should be redone using classes and instanceof.
-     */
-    [symbolEvent]: true;
-    meta?: IEventMeta;
+    source: string | symbol;
 }
 export interface IMiddlewareDefinition<TConfig = any, TDependencies extends DependencyMapType = any> {
-    id: string;
+    id?: string | symbol;
     dependencies?: TDependencies | (() => TDependencies);
     run: (input: IMiddlewareExecutionInput, dependencies: DependencyValuesType<TDependencies>, config: TConfig) => Promise<any>;
     meta?: IMiddlewareMeta;
@@ -185,8 +213,9 @@ export interface IMiddleware<TConfig = any, TDependencies extends DependencyMapT
     [symbolMiddlewareConfigured]?: boolean;
     [symbolMiddlewareEverywhereTasks]?: boolean;
     [symbolMiddlewareEverywhereResources]?: boolean;
+    id: string | symbol;
     dependencies: TDependencies | (() => TDependencies);
-    everywhere(): IMiddleware<TConfig, TDependencies>;
+    everywhere(config?: MiddlewareEverywhereOptions): IMiddleware<TConfig, TDependencies>;
     config: TConfig;
     with: (config: TConfig) => IMiddlewareConfigured<TConfig, TDependencies>;
 }
@@ -208,17 +237,3 @@ export interface IMiddlewareExecutionInput<TTaskInput = any, TResourceConfig = a
     };
     next: (taskInputOrResourceConfig?: TTaskInput | TResourceConfig) => Promise<any>;
 }
-export interface IHookDefinition<D extends DependencyMapType = {}, T = any, B extends boolean = false> {
-    event: "*" | IEventDefinition<T>;
-    /**
-     * The higher the number, the higher the priority.
-     * We recommend using numbers between -1000 and 1000.
-     */
-    order?: number;
-    /**
-     * These are hooks that run before any resource instantiation.
-     * @param event
-     */
-    early?: B;
-    run: (event: IEvent<T>, dependencies: T extends true ? void : DependencyValuesType<D>) => Promise<void> | void;
-}

package/dist/defs.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.symbols = exports.symbolStore = exports.symbolDispose = exports.symbolFilePath = exports.symbolMiddlewareEverywhereResources = exports.symbolMiddlewareEverywhereTasks = exports.symbolMiddlewareGlobal = exports.symbolMiddlewareConfigured = exports.symbolMiddleware = exports.symbolEvent = exports.symbolResourceWithConfig = exports.symbolResource = exports.symbolTask = void 0;
+exports.symbols = exports.symbolIndexResource = exports.symbolStore = exports.symbolDispose = exports.symbolFilePath = exports.symbolMiddlewareEverywhereResources = exports.symbolMiddlewareEverywhereTasks = exports.symbolMiddlewareGlobal = exports.symbolMiddlewareConfigured = exports.symbolMiddleware = exports.symbolEvent = exports.symbolResourceWithConfig = exports.symbolResource = exports.symbolTask = void 0;
 exports.symbolTask = Symbol("runner.task");
 exports.symbolResource = Symbol("runner.resource");
 exports.symbolResourceWithConfig = Symbol("runner.resourceWithConfig");
@@ -13,10 +13,12 @@ exports.symbolMiddlewareEverywhereResources = Symbol("runner.middlewareGlobalRes
 exports.symbolFilePath = Symbol("runner.filePath");
 exports.symbolDispose = Symbol("runner.dispose");
 exports.symbolStore = Symbol("runner.store");
+exports.symbolIndexResource = Symbol("runner.indexResource");
 exports.symbols = {
     task: exports.symbolTask,
     resource: exports.symbolResource,
     resourceWithConfig: exports.symbolResourceWithConfig,
+    indexResource: exports.symbolIndexResource,
     event: exports.symbolEvent,
     middleware: exports.symbolMiddleware,
     middlewareEverywhereTasks: exports.symbolMiddlewareEverywhereTasks,

package/dist/defs.js.map

@@ -1 +1 @@
-{"version":3,"file":"defs.js","sourceRoot":"","sources":["../src/defs.ts"],"names":[],"mappings":";;;AAEa,QAAA,UAAU,GAAkB,MAAM,CAAC,aAAa,CAAC,CAAC;AAClD,QAAA,cAAc,GAAkB,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAC1D,QAAA,wBAAwB,GAAkB,MAAM,CAC3D,2BAA2B,CAC5B,CAAC;AACW,QAAA,WAAW,GAAkB,MAAM,CAAC,cAAc,CAAC,CAAC;AACpD,QAAA,gBAAgB,GAAkB,MAAM,CAAC,mBAAmB,CAAC,CAAC;AAC9D,QAAA,0BAA0B,GAAkB,MAAM,CAC7D,6BAA6B,CAC9B,CAAC;AACW,QAAA,sBAAsB,GAAkB,MAAM,CACzD,yBAAyB,CAC1B,CAAC;AACW,QAAA,+BAA+B,GAAkB,MAAM,CAClE,8BAA8B,CAC/B,CAAC;AACW,QAAA,mCAAmC,GAAkB,MAAM,CACtE,kCAAkC,CACnC,CAAC;AAEW,QAAA,cAAc,GAAkB,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAC1D,QAAA,aAAa,GAAkB,MAAM,CAAC,gBAAgB,CAAC,CAAC;AACxD,QAAA,WAAW,GAAkB,MAAM,CAAC,cAAc,CAAC,CAAC;AAEpD,QAAA,OAAO,GAAG;IACrB,IAAI,EAAE,kBAAU;IAChB,QAAQ,EAAE,sBAAc;IACxB,kBAAkB,EAAE,gCAAwB;IAC5C,KAAK,EAAE,mBAAW;IAClB,UAAU,EAAE,wBAAgB;IAC5B,yBAAyB,EAAE,uCAA+B;IAC1D,6BAA6B,EAAE,2CAAmC;IAClE,QAAQ,EAAE,sBAAc;IACxB,OAAO,EAAE,qBAAa;IACtB,KAAK,EAAE,mBAAW;CACnB,CAAC"}
+{"version":3,"file":"defs.js","sourceRoot":"","sources":["../src/defs.ts"],"names":[],"mappings":";;;AAKa,QAAA,UAAU,GAAkB,MAAM,CAAC,aAAa,CAAC,CAAC;AAClD,QAAA,cAAc,GAAkB,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAC1D,QAAA,wBAAwB,GAAkB,MAAM,CAC3D,2BAA2B,CAC5B,CAAC;AACW,QAAA,WAAW,GAAkB,MAAM,CAAC,cAAc,CAAC,CAAC;AACpD,QAAA,gBAAgB,GAAkB,MAAM,CAAC,mBAAmB,CAAC,CAAC;AAC9D,QAAA,0BAA0B,GAAkB,MAAM,CAC7D,6BAA6B,CAC9B,CAAC;AACW,QAAA,sBAAsB,GAAkB,MAAM,CACzD,yBAAyB,CAC1B,CAAC;AACW,QAAA,+BAA+B,GAAkB,MAAM,CAClE,8BAA8B,CAC/B,CAAC;AACW,QAAA,mCAAmC,GAAkB,MAAM,CACtE,kCAAkC,CACnC,CAAC;AAEW,QAAA,cAAc,GAAkB,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAC1D,QAAA,aAAa,GAAkB,MAAM,CAAC,gBAAgB,CAAC,CAAC;AACxD,QAAA,WAAW,GAAkB,MAAM,CAAC,cAAc,CAAC,CAAC;AAEpD,QAAA,mBAAmB,GAAkB,MAAM,CACtD,sBAAsB,CACvB,CAAC;AAEW,QAAA,OAAO,GAAG;IACrB,IAAI,EAAE,kBAAU;IAChB,QAAQ,EAAE,sBAAc;IACxB,kBAAkB,EAAE,gCAAwB;IAC5C,aAAa,EAAE,2BAAmB;IAClC,KAAK,EAAE,mBAAW;IAClB,UAAU,EAAE,wBAAgB;IAC5B,yBAAyB,EAAE,uCAA+B;IAC1D,6BAA6B,EAAE,2CAAmC;IAClE,QAAQ,EAAE,sBAAc;IACxB,OAAO,EAAE,qBAAa;IACtB,KAAK,EAAE,mBAAW;CACnB,CAAC"}

package/dist/errors.d.ts

@@ -1,10 +1,10 @@
 export declare const Errors: {
-    duplicateRegistration: (type: string, id: string) => Error;
-    dependencyNotFound: (key: string) => Error;
+    duplicateRegistration: (type: string, id: string | symbol) => Error;
+    dependencyNotFound: (key: string | symbol) => Error;
     unknownItemType: (item: any) => Error;
     circularDependencies: (cycles: string[]) => Error;
-    eventNotFound: (id: string) => Error;
-    middlewareAlreadyGlobal: (id: string) => Error;
-    locked: (what: string) => Error;
+    eventNotFound: (id: string | symbol) => Error;
+    middlewareAlreadyGlobal: (id: string | symbol) => Error;
+    locked: (what: string | symbol) => Error;
     storeAlreadyInitialized: () => Error;
 };

package/dist/errors.js

@@ -2,13 +2,14 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Errors = void 0;
 exports.Errors = {
-    duplicateRegistration: (type, id) => new Error(`${type} "${id}" already registered`),
-    dependencyNotFound: (key) => new Error(`Dependency ${key} not found. Did you forget to register it through a resource?`),
+    duplicateRegistration: (type, id) => new Error(`${type} "${id.toString()}" already registered`),
+    dependencyNotFound: (key) => new Error(`Dependency ${key.toString()} not found. Did you forget to register it through a resource?`),
     unknownItemType: (item) => new Error(`Unknown item type: ${item}`),
     circularDependencies: (cycles) => new Error(`Circular dependencies detected: ${cycles.join(", ")}`),
-    eventNotFound: (id) => new Error(`Event "${id}" not found. Did you forget to register it?`),
-    middlewareAlreadyGlobal: (id) => new Error("Cannot call .everywhere() on an already global middleware: " + id),
-    locked: (what) => new Error(`Cannot modify the ${what} when it is locked.`),
+    eventNotFound: (id) => new Error(`Event "${id.toString()}" not found. Did you forget to register it?`),
+    middlewareAlreadyGlobal: (id) => new Error("Cannot call .everywhere() on an already global middleware: " +
+        id.toString),
+    locked: (what) => new Error(`Cannot modify the ${what.toString()} when it is locked.`),
     storeAlreadyInitialized: () => new Error("Store already initialized. Cannot reinitialize."),
 };
 //# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AAEa,QAAA,MAAM,GAAG;IACpB,qBAAqB,EAAE,CAAC,IAAY,EAAE,EAAU,EAAE,EAAE,CAClD,IAAI,KAAK,CAAC,GAAG,IAAI,KAAK,EAAE,sBAAsB,CAAC;IAEjD,kBAAkB,EAAE,CAAC,GAAW,EAAE,EAAE,CAClC,IAAI,KAAK,CACP,cAAc,GAAG,+DAA+D,CACjF;IAEH,eAAe,EAAE,CAAC,IAAS,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,sBAAsB,IAAI,EAAE,CAAC;IAEvE,oBAAoB,EAAE,CAAC,MAAgB,EAAE,EAAE,CACzC,IAAI,KAAK,CAAC,mCAAmC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IAEnE,aAAa,EAAE,CAAC,EAAU,EAAE,EAAE,CAC5B,IAAI,KAAK,CAAC,UAAU,EAAE,6CAA6C,CAAC;IAEtE,uBAAuB,EAAE,CAAC,EAAU,EAAE,EAAE,CACtC,IAAI,KAAK,CACP,6DAA6D,GAAG,EAAE,CACnE;IAEH,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE,CACvB,IAAI,KAAK,CAAC,qBAAqB,IAAI,qBAAqB,CAAC;IAE3D,uBAAuB,EAAE,GAAG,EAAE,CAC5B,IAAI,KAAK,CAAC,iDAAiD,CAAC;CAC/D,CAAC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AAEa,QAAA,MAAM,GAAG;IACpB,qBAAqB,EAAE,CAAC,IAAY,EAAE,EAAmB,EAAE,EAAE,CAC3D,IAAI,KAAK,CAAC,GAAG,IAAI,KAAK,EAAE,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAE5D,kBAAkB,EAAE,CAAC,GAAoB,EAAE,EAAE,CAC3C,IAAI,KAAK,CACP,cAAc,GAAG,CAAC,QAAQ,EAAE,+DAA+D,CAC5F;IAEH,eAAe,EAAE,CAAC,IAAS,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,sBAAsB,IAAI,EAAE,CAAC;IAEvE,oBAAoB,EAAE,CAAC,MAAgB,EAAE,EAAE,CACzC,IAAI,KAAK,CAAC,mCAAmC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IAEnE,aAAa,EAAE,CAAC,EAAmB,EAAE,EAAE,CACrC,IAAI,KAAK,CACP,UAAU,EAAE,CAAC,QAAQ,EAAE,6CAA6C,CACrE;IAEH,uBAAuB,EAAE,CAAC,EAAmB,EAAE,EAAE,CAC/C,IAAI,KAAK,CACP,6DAA6D;QAC3D,EAAE,CAAC,QAAQ,CACd;IAEH,MAAM,EAAE,CAAC,IAAqB,EAAE,EAAE,CAChC,IAAI,KAAK,CAAC,qBAAqB,IAAI,CAAC,QAAQ,EAAE,qBAAqB,CAAC;IAEtE,uBAAuB,EAAE,GAAG,EAAE,CAC5B,IAAI,KAAK,CAAC,iDAAiD,CAAC;CAC/D,CAAC"}

package/dist/globals/globalEvents.d.ts

@@ -1,41 +1,41 @@
-import { ITask, IResource } from "../defs";
+import { ITask, IResource, IEvent } from "../defs";
 import { ILog } from "../models/Logger";
 export declare const globalEvents: {
-    beforeInit: import("../defs").IEventDefinition<any>;
-    afterInit: import("../defs").IEventDefinition<any>;
-    log: import("../defs").IEventDefinition<ILog>;
+    beforeInit: IEvent<void>;
+    afterInit: IEvent<void>;
+    log: IEvent<ILog>;
     tasks: {
-        beforeRun: import("../defs").IEventDefinition<{
+        beforeRun: IEvent<{
             task: ITask<any, any, any>;
             input: any;
         }>;
-        afterRun: import("../defs").IEventDefinition<{
+        afterRun: IEvent<{
             task: ITask<any, any, any>;
             input: any;
             output: any;
             setOutput: (newOutput: any) => void;
         }>;
-        onError: import("../defs").IEventDefinition<{
+        onError: IEvent<{
             error: any;
             suppress: () => void;
             task: ITask<any, any, any>;
         }>;
     };
     resources: {
-        beforeInit: import("../defs").IEventDefinition<{
+        beforeInit: IEvent<{
             resource: IResource<any, any, any>;
             config: any;
         }>;
-        afterInit: import("../defs").IEventDefinition<{
+        afterInit: IEvent<{
             resource: IResource<any, any, any>;
             config: any;
             value: any;
         }>;
-        onError: import("../defs").IEventDefinition<{
+        onError: IEvent<{
             error: Error;
             suppress: () => void;
             resource: IResource<any, any, any>;
         }>;
     };
 };
-export declare const globalEventsArray: import("../defs").IEventDefinition<any>[];
+export declare const globalEventsArray: IEvent<void>[];

package/dist/globals/globalMiddleware.d.ts

@@ -12,7 +12,7 @@ export declare const globalMiddlewares: {
             defaultOptions?: any;
             async?: boolean;
         }, {
-            map: Map<string, import("./middleware/cache.middleware").ICacheInstance>;
+            map: Map<string | symbol, import("./middleware/cache.middleware").ICacheInstance>;
             cacheFactoryTask: (...args: [] | [any]) => Promise<import("./middleware/cache.middleware").ICacheInstance>;
             async: boolean | undefined;
             defaultOptions: any;