@bluelibs/runner 2.2.4 → 3.1.0

package/dist/resource.types.d.ts

@@ -0,0 +1,31 @@
+import { IResourceMeta } from "./common.types";
+import { RegisterableItems } from "./task.types";
+import { MiddlewareAttachments } from "./middleware.types";
+import { IEventDefinition } from "./event.types";
+export interface IResourceDefinition<TConfig = any, TValue = unknown, TDependencies extends import("./task.types").DependencyMapType = {}, TContext = any, THooks = any, TRegisterableItems = any> {
+    id: string;
+    dependencies?: TDependencies | ((config: TConfig) => TDependencies);
+    register?: Array<RegisterableItems> | ((config: TConfig) => Array<RegisterableItems>);
+    init?: (this: any, config: TConfig, dependencies: import("./task.types").DependencyValuesType<TDependencies>, context: TContext) => Promise<TValue>;
+    dispose?: (this: any, value: TValue, config: TConfig, dependencies: import("./task.types").DependencyValuesType<TDependencies>, context: TContext) => Promise<void>;
+    meta?: IResourceMeta;
+    overrides?: Array<IResource | import("./task.types").ITask | import("./middleware.types").IMiddleware | IResourceWithConfig>;
+    middleware?: MiddlewareAttachments[];
+    context?: () => TContext;
+}
+export interface IResource<TConfig = void, TValue = any, TDependencies extends import("./task.types").DependencyMapType = any, TContext = any> extends IResourceDefinition<TConfig, TValue, TDependencies, TContext> {
+    with(config: TConfig): IResourceWithConfig<TConfig, TValue, TDependencies>;
+    register: Array<RegisterableItems> | ((config: TConfig) => Array<RegisterableItems>);
+    events: {
+        beforeInit: IEventDefinition<import("./task.types").BeforeInitEventPayload<TConfig>>;
+        afterInit: IEventDefinition<import("./task.types").AfterInitEventPayload<TConfig, TValue>>;
+        onError: IEventDefinition<import("./task.types").OnErrorEventPayload>;
+    };
+    overrides: Array<IResource | import("./task.types").ITask | import("./middleware.types").IMiddleware | IResourceWithConfig>;
+    middleware: MiddlewareAttachments[];
+}
+export interface IResourceWithConfig<TConfig = any, TValue = any, TDependencies extends import("./task.types").DependencyMapType = any> {
+    id: string;
+    resource: IResource<TConfig, TValue, TDependencies>;
+    config: TConfig;
+}

package/dist/resource.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=resource.types.js.map

package/dist/resource.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.types.js","sourceRoot":"","sources":["../src/resource.types.ts"],"names":[],"mappings":""}

package/dist/run.d.ts

@@ -21,4 +21,7 @@ export type RunnerState = {
     events: Record<string, EventStoreElementType>;
     middleware: Record<string, MiddlewareStoreElementType>;
 };
-export declare function run<C, V>(resource: IResource<C, V>, config?: C): Promise<V>;
+export declare function run<C, V>(resource: IResource<C, V>, config?: C): Promise<{
+    value: V;
+    dispose: () => Promise<void>;
+}>;

package/dist/run.js

@@ -4,11 +4,11 @@ exports.run = run;
 const TaskRunner_1 = require("./models/TaskRunner");
 const DependencyProcessor_1 = require("./models/DependencyProcessor");
 const EventManager_1 = require("./models/EventManager");
-const globalEvents_1 = require("./globalEvents");
+const globalEvents_1 = require("./globals/globalEvents");
 const Store_1 = require("./models/Store");
 const findCircularDependencies_1 = require("./tools/findCircularDependencies");
 const errors_1 = require("./errors");
-const globalResources_1 = require("./globalResources");
+const globalResources_1 = require("./globals/globalResources");
 const Logger_1 = require("./models/Logger");
 async function run(resource, config) {
     const eventManager = new EventManager_1.EventManager();
@@ -44,6 +44,9 @@ async function run(resource, config) {
     await logger.debug("System initialized and operational.");
     // disallow manipulation or attaching more
     store.lock();
-    return store.root.value;
+    return {
+        value: store.root.value,
+        dispose: () => store.dispose(),
+    };
 }
 //# sourceMappingURL=run.js.map

package/dist/run.js.map

@@ -1 +1 @@
-{"version":3,"file":"run.js","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":";;AAsDA,kBAuDC;AA7GD,oDAAiD;AAUjD,sEAAmE;AACnE,wDAAqD;AACrD,iDAA8C;AAC9C,0CAAuC;AACvC,+EAA4E;AAC5E,qCAAkC;AAClC,uDAAoD;AACpD,4CAAyC;AAqClC,KAAK,UAAU,GAAG,CACvB,QAAyB,EACzB,MAAU;IAEV,MAAM,YAAY,GAAG,IAAI,2BAAY,EAAE,CAAC;IAExC,2FAA2F;IAC3F,MAAM,MAAM,GAAG,IAAI,eAAM,CAAC,YAAY,CAAC,CAAC;IAExC,MAAM,KAAK,GAAG,IAAI,aAAK,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,IAAI,uBAAU,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;IAC/D,MAAM,SAAS,GAAG,IAAI,yCAAmB,CACvC,KAAK,EACL,YAAY,EACZ,UAAU,EACV,MAAM,CACP,CAAC;IAEF,+FAA+F;IAC/F,KAAK,CAAC,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACxC,KAAK,CAAC,gBAAgB,CAAC,iCAAe,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5D,KAAK,CAAC,gBAAgB,CAAC,iCAAe,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IAEpE,kGAAkG;IAClG,MAAM,cAAc,GAAG,KAAK,CAAC,iBAAiB,EAAE,CAAC;IACjD,MAAM,oBAAoB,GAAG,IAAA,mDAAwB,EAAC,cAAc,CAAC,CAAC;IACtE,IAAI,oBAAoB,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3C,MAAM,eAAM,CAAC,oBAAoB,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;IACjE,CAAC;IAED,sFAAsF;IACtF,MAAM,KAAK,CAAC,gBAAgB,EAAE,CAAC;IAE/B,iGAAiG;IACjG,MAAM,KAAK,CAAC,sBAAsB,EAAE,CAAC;IACrC,MAAM,SAAS,CAAC,eAAe,EAAE,CAAC;IAClC,MAAM,SAAS,CAAC,sBAAsB,EAAE,CAAC;IAEzC,6DAA6D;IAC7D,MAAM,MAAM,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;IAE1D,mFAAmF;IACnF,iCAAiC;IACjC,MAAM,YAAY,CAAC,IAAI,CAAC,2BAAY,CAAC,UAAU,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;IAEpE,0CAA0C;IAC1C,MAAM,SAAS,CAAC,cAAc,EAAE,CAAC;IAEjC,MAAM,YAAY,CAAC,IAAI,CAAC,2BAAY,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;IACnE,MAAM,MAAM,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;IAE1D,0CAA0C;IAC1C,KAAK,CAAC,IAAI,EAAE,CAAC;IAEb,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;AAC1B,CAAC"}
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":";;AAsDA,kBA0DC;AAhHD,oDAAiD;AAUjD,sEAAmE;AACnE,wDAAqD;AACrD,yDAAsD;AACtD,0CAAuC;AACvC,+EAA4E;AAC5E,qCAAkC;AAClC,+DAA4D;AAC5D,4CAAyC;AAqClC,KAAK,UAAU,GAAG,CACvB,QAAyB,EACzB,MAAU;IAEV,MAAM,YAAY,GAAG,IAAI,2BAAY,EAAE,CAAC;IAExC,2FAA2F;IAC3F,MAAM,MAAM,GAAG,IAAI,eAAM,CAAC,YAAY,CAAC,CAAC;IAExC,MAAM,KAAK,GAAG,IAAI,aAAK,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,IAAI,uBAAU,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;IAC/D,MAAM,SAAS,GAAG,IAAI,yCAAmB,CACvC,KAAK,EACL,YAAY,EACZ,UAAU,EACV,MAAM,CACP,CAAC;IAEF,+FAA+F;IAC/F,KAAK,CAAC,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACxC,KAAK,CAAC,gBAAgB,CAAC,iCAAe,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5D,KAAK,CAAC,gBAAgB,CAAC,iCAAe,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IAEpE,kGAAkG;IAClG,MAAM,cAAc,GAAG,KAAK,CAAC,iBAAiB,EAAE,CAAC;IACjD,MAAM,oBAAoB,GAAG,IAAA,mDAAwB,EAAC,cAAc,CAAC,CAAC;IACtE,IAAI,oBAAoB,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3C,MAAM,eAAM,CAAC,oBAAoB,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;IACjE,CAAC;IAED,sFAAsF;IACtF,MAAM,KAAK,CAAC,gBAAgB,EAAE,CAAC;IAE/B,iGAAiG;IACjG,MAAM,KAAK,CAAC,sBAAsB,EAAE,CAAC;IACrC,MAAM,SAAS,CAAC,eAAe,EAAE,CAAC;IAClC,MAAM,SAAS,CAAC,sBAAsB,EAAE,CAAC;IAEzC,6DAA6D;IAC7D,MAAM,MAAM,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;IAE1D,mFAAmF;IACnF,iCAAiC;IACjC,MAAM,YAAY,CAAC,IAAI,CAAC,2BAAY,CAAC,UAAU,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;IAEpE,0CAA0C;IAC1C,MAAM,SAAS,CAAC,cAAc,EAAE,CAAC;IAEjC,MAAM,YAAY,CAAC,IAAI,CAAC,2BAAY,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;IACnE,MAAM,MAAM,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;IAE1D,0CAA0C;IAC1C,KAAK,CAAC,IAAI,EAAE,CAAC;IAEb,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK;QACvB,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE;KAC/B,CAAC;AACJ,CAAC"}

package/dist/symbols.d.ts

@@ -0,0 +1,24 @@
+export declare const symbolTask: unique symbol;
+export declare const symbolResource: unique symbol;
+export declare const symbolResourceWithConfig: unique symbol;
+export declare const symbolEvent: unique symbol;
+export declare const symbolMiddleware: unique symbol;
+export declare const symbolMiddlewareConfigured: unique symbol;
+export declare const symbolMiddlewareGlobal: unique symbol;
+export declare const symbolMiddlewareEverywhereTasks: unique symbol;
+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 symbols: {
+    task: symbol;
+    resource: symbol;
+    resourceWithConfig: symbol;
+    event: symbol;
+    middleware: symbol;
+    middlewareEverywhereTasks: symbol;
+    middlewareEverywhereResources: symbol;
+    filePath: symbol;
+    dispose: symbol;
+    store: symbol;
+};

package/dist/symbols.js

@@ -0,0 +1,29 @@
+"use strict";
+// Symbol constants
+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.symbolTask = Symbol("runner.task");
+exports.symbolResource = Symbol("runner.resource");
+exports.symbolResourceWithConfig = Symbol("runner.resourceWithConfig");
+exports.symbolEvent = Symbol("runner.event");
+exports.symbolMiddleware = Symbol("runner.middleware");
+exports.symbolMiddlewareConfigured = Symbol("runner.middlewareConfigured");
+exports.symbolMiddlewareGlobal = Symbol("runner.middlewareGlobal");
+exports.symbolMiddlewareEverywhereTasks = Symbol("runner.middlewareGlobalTasks");
+exports.symbolMiddlewareEverywhereResources = Symbol("runner.middlewareGlobalResources");
+exports.symbolFilePath = Symbol("runner.filePath");
+exports.symbolDispose = Symbol("runner.dispose");
+exports.symbolStore = Symbol("runner.store");
+exports.symbols = {
+    task: exports.symbolTask,
+    resource: exports.symbolResource,
+    resourceWithConfig: exports.symbolResourceWithConfig,
+    event: exports.symbolEvent,
+    middleware: exports.symbolMiddleware,
+    middlewareEverywhereTasks: exports.symbolMiddlewareEverywhereTasks,
+    middlewareEverywhereResources: exports.symbolMiddlewareEverywhereResources,
+    filePath: exports.symbolFilePath,
+    dispose: exports.symbolDispose,
+    store: exports.symbolStore,
+};
+//# sourceMappingURL=symbols.js.map

package/dist/symbols.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbols.js","sourceRoot":"","sources":["../src/symbols.ts"],"names":[],"mappings":";AAAA,mBAAmB;;;AAEN,QAAA,UAAU,GAAkB,MAAM,CAAC,aAAa,CAAC,CAAC;AAClD,QAAA,cAAc,GAAkB,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAC1D,QAAA,wBAAwB,GAAkB,MAAM,CAAC,2BAA2B,CAAC,CAAC;AAC9E,QAAA,WAAW,GAAkB,MAAM,CAAC,cAAc,CAAC,CAAC;AACpD,QAAA,gBAAgB,GAAkB,MAAM,CAAC,mBAAmB,CAAC,CAAC;AAC9D,QAAA,0BAA0B,GAAkB,MAAM,CAAC,6BAA6B,CAAC,CAAC;AAClF,QAAA,sBAAsB,GAAkB,MAAM,CAAC,yBAAyB,CAAC,CAAC;AAC1E,QAAA,+BAA+B,GAAkB,MAAM,CAAC,8BAA8B,CAAC,CAAC;AACxF,QAAA,mCAAmC,GAAkB,MAAM,CAAC,kCAAkC,CAAC,CAAC;AAChG,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"}

package/dist/task.types.d.ts

@@ -0,0 +1,55 @@
+import { ITaskMeta, DependencyMapType, DependencyValuesType } from "./common.types";
+import { MiddlewareAttachments } from "./middleware.types";
+import { IEvent, IEventDefinition } from "./event.types";
+export type DependencyMapType = Record<string, ITask<any, any, any, any> | IResource<any, any, any> | IEventDefinition<any>>;
+export type ExtractTaskInput<T> = T extends ITask<infer I, any, infer D> ? I : never;
+export type ExtractTaskOutput<T> = T extends ITask<any, infer O, infer D> ? O : never;
+export type ExtractResourceValue<T> = T extends IResource<any, infer V, infer D> ? V : never;
+export type ExtractEventParams<T> = T extends IEventDefinition<infer P> ? P : never;
+export type TaskDependency<I, O> = (...args: I extends null | void ? [] : [I]) => O;
+export type ResourceDependency<V> = V;
+export type EventDependency<P> = (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>;
+export interface ITaskDefinition<TInput = any, TOutput extends Promise<any> = any, TDependencies extends DependencyMapType = {}, TOn extends "*" | IEventDefinition<any> | undefined = undefined> {
+    id: string;
+    dependencies?: TDependencies | (() => TDependencies);
+    middleware?: MiddlewareAttachments[];
+    on?: TOn;
+    listenerOrder?: number;
+    meta?: ITaskMeta;
+    run: (input: TOn extends undefined ? TInput : IEvent<TOn extends "*" ? any : ExtractEventParams<TOn>>, dependencies: DependencyValuesType<TDependencies>) => TOutput;
+}
+export type BeforeRunEventPayload<TInput> = {
+    input: TInput;
+};
+export type AfterRunEventPayload<TInput, TOutput> = {
+    input: TInput;
+    output: TOutput extends Promise<infer U> ? U : TOutput;
+    setOutput(newOutput: TOutput extends Promise<infer U> ? U : TOutput): void;
+};
+export type OnErrorEventPayload = {
+    error: any;
+    suppress(): void;
+};
+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> {
+    dependencies: TDependencies | (() => TDependencies);
+    computedDependencies?: DependencyValuesType<TDependencies>;
+    middleware: MiddlewareAttachments[];
+    events: {
+        beforeRun: IEventDefinition<BeforeRunEventPayload<TInput>>;
+        afterRun: IEventDefinition<AfterRunEventPayload<TInput, TOutput>>;
+        onError: IEventDefinition<OnErrorEventPayload>;
+    };
+}
+export * from "./task.types";
+export * from "./resource.types";
+export * from "./event.types";
+export * from "./middleware.types";
+export * from "./symbols";
+export * from "./common.types";

package/dist/task.types.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./task.types"), exports);
+__exportStar(require("./resource.types"), exports);
+__exportStar(require("./event.types"), exports);
+__exportStar(require("./middleware.types"), exports);
+__exportStar(require("./symbols"), exports);
+__exportStar(require("./common.types"), exports);
+//# sourceMappingURL=task.types.js.map

package/dist/task.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.types.js","sourceRoot":"","sources":["../src/task.types.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AA+FA,+CAA6B;AAC7B,mDAAiC;AACjC,gDAA8B;AAC9B,qDAAmC;AACnC,4CAA0B;AAC1B,iDAA+B"}

package/dist/tools/getCallerFile.d.ts

@@ -1 +1,9 @@
-export declare function getCallerFile(): string | undefined;
+export declare function getCallerFile(): string;
+/**
+ * Gets a file path, looks at all the parts between current path and 'src' and generates a unique symbol based on that.
+ * If there is no 'src' to be found, it will rely on using the last 4 parts of the path.
+ * This is useful for generating unique IDs for tasks, resources, etc.
+ * @param filePath
+ * @returns
+ */
+export declare function generateCallerIdFromFile(filePath: string, suffix?: string, fallbackParts?: number): symbol;

package/dist/tools/getCallerFile.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getCallerFile = getCallerFile;
+exports.generateCallerIdFromFile = generateCallerIdFromFile;
 function getCallerFile() {
     const originalFunc = Error.prepareStackTrace;
     try {
@@ -27,4 +28,44 @@ function getCallerFile() {
         Error.prepareStackTrace = originalFunc;
     }
 }
+/**
+ * Gets a file path, looks at all the parts between current path and 'src' and generates a unique symbol based on that.
+ * If there is no 'src' to be found, it will rely on using the last 4 parts of the path.
+ * This is useful for generating unique IDs for tasks, resources, etc.
+ * @param filePath
+ * @returns
+ */
+function generateCallerIdFromFile(filePath, suffix = "", fallbackParts = 4) {
+    filePath = filePath.replace(/\\/g, "/"); // Normalize path for consistency.
+    const parts = filePath.split("/");
+    const srcIndex = parts.lastIndexOf("src");
+    const nodeModulesIndex = parts.lastIndexOf("node_modules");
+    const breakIndex = Math.max(srcIndex, nodeModulesIndex);
+    let relevantParts;
+    if (breakIndex !== -1) {
+        relevantParts = parts.slice(breakIndex + 1);
+    }
+    else {
+        relevantParts = parts.slice(-fallbackParts);
+    }
+    if (relevantParts.length > 0) {
+        const lastPartIndex = relevantParts.length - 1;
+        const lastPart = relevantParts[lastPartIndex];
+        const dotIndex = lastPart.lastIndexOf(".");
+        if (dotIndex !== -1 && dotIndex > 0) {
+            const extension = lastPart.substring(dotIndex + 1);
+            const knownExtensions = ["ts", "js", "tsx", "jsx", "json", "node"];
+            if (knownExtensions.includes(extension)) {
+                relevantParts[lastPartIndex] = lastPart.substring(0, dotIndex);
+            }
+        }
+    }
+    const id = relevantParts.join(".");
+    const lastPart = relevantParts.length > 0 ? relevantParts[relevantParts.length - 1] : "";
+    let finalId = id;
+    if (suffix && !lastPart.includes(suffix)) {
+        finalId += "." + suffix;
+    }
+    return Symbol(finalId);
+}
 //# sourceMappingURL=getCallerFile.js.map

package/dist/tools/getCallerFile.js.map

@@ -1 +1 @@
-{"version":3,"file":"getCallerFile.js","sourceRoot":"","sources":["../../src/tools/getCallerFile.ts"],"names":[],"mappings":";;AAAA,sCAgCC;AAhCD,SAAgB,aAAa;IAC3B,MAAM,YAAY,GAAG,KAAK,CAAC,iBAAiB,CAAC;IAE7C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,IAAI,UAAU,CAAC;QACf,IAAI,WAAW,CAAC;QAEhB,8BAA8B;QAC9B,KAAK,CAAC,iBAAiB,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC;QAEhD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAqC,CAAC;QAExD,+BAA+B;QAC/B,0BAA0B;QAC1B,8EAA8E;QAC9E,sBAAsB;QACtB,IAAI;QAEJ,gDAAgD;QAChD,KAAK,CAAC,KAAK,EAAE,CAAC;QAEd,+DAA+D;QAC/D,WAAW,GAAG,KAAK,CAAC,KAAK,EAAE,EAAE,WAAW,EAAE,CAAC;QAE3C,uDAAuD;QACvD,UAAU,GAAG,KAAK,CAAC,KAAK,EAAE,EAAE,WAAW,EAAE,CAAC;QAE1C,OAAO,UAAU,CAAC,CAAC,2CAA2C;IAChE,CAAC;YAAS,CAAC;QACT,KAAK,CAAC,iBAAiB,GAAG,YAAY,CAAC;IACzC,CAAC;AACH,CAAC"}
+{"version":3,"file":"getCallerFile.js","sourceRoot":"","sources":["../../src/tools/getCallerFile.ts"],"names":[],"mappings":"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"}

package/dist/tools/registratorId.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Generate a registrator ID based on file path
+ */
+export declare function generateRegistratorId(filePath: string | undefined, explicitId?: string): string;

package/dist/tools/registratorId.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateRegistratorId = generateRegistratorId;
+// Counter to handle multiple registrators in the same file
+let registratorCounter = 0;
+/**
+ * Generate a registrator ID based on file path
+ */
+function generateRegistratorId(filePath, explicitId) {
+    // If explicit ID is provided, use it
+    if (explicitId) {
+        return explicitId;
+    }
+    // Use file path or fallback
+    if (!filePath) {
+        registratorCounter++;
+        return `registrator.unknown.${registratorCounter}`;
+    }
+    // Extract path from 'src' onwards
+    const srcIndex = filePath.lastIndexOf("/src/");
+    if (srcIndex !== -1) {
+        // Get everything after '/src/'
+        let relativePath = filePath.substring(srcIndex + 5);
+        // Remove file extension
+        relativePath = relativePath.replace(/\.(ts|js)$/, "");
+        // Replace path separators with dots
+        relativePath = relativePath.replace(/\//g, ".");
+        // Add counter to handle multiple registrators in same file
+        registratorCounter++;
+        return `registrator.${relativePath}.${registratorCounter}`;
+    }
+    // Fallback: use filename only
+    const filename = filePath
+        .split("/")
+        .pop()
+        ?.replace(/\.(ts|js)$/, "") || "unknown";
+    registratorCounter++;
+    return `registrator.${filename}.${registratorCounter}`;
+}
+//# sourceMappingURL=registratorId.js.map

package/dist/tools/registratorId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registratorId.js","sourceRoot":"","sources":["../../src/tools/registratorId.ts"],"names":[],"mappings":";;AAMA,sDAyCC;AA/CD,2DAA2D;AAC3D,IAAI,kBAAkB,GAAG,CAAC,CAAC;AAE3B;;GAEG;AACH,SAAgB,qBAAqB,CACnC,QAA4B,EAC5B,UAAmB;IAEnB,qCAAqC;IACrC,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,4BAA4B;IAC5B,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,kBAAkB,EAAE,CAAC;QACrB,OAAO,uBAAuB,kBAAkB,EAAE,CAAC;IACrD,CAAC;IAED,kCAAkC;IAClC,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAC/C,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;QACpB,+BAA+B;QAC/B,IAAI,YAAY,GAAG,QAAQ,CAAC,SAAS,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;QAEpD,wBAAwB;QACxB,YAAY,GAAG,YAAY,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;QAEtD,oCAAoC;QACpC,YAAY,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAEhD,2DAA2D;QAC3D,kBAAkB,EAAE,CAAC;QACrB,OAAO,eAAe,YAAY,IAAI,kBAAkB,EAAE,CAAC;IAC7D,CAAC;IAED,8BAA8B;IAC9B,MAAM,QAAQ,GACZ,QAAQ;SACL,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,EAAE;QACN,EAAE,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,IAAI,SAAS,CAAC;IAE7C,kBAAkB,EAAE,CAAC;IACrB,OAAO,eAAe,QAAQ,IAAI,kBAAkB,EAAE,CAAC;AACzD,CAAC"}

package/dist/tools/simpleHash.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Simple hash function that generates predictable hashes
+ * This is not cryptographically secure but suitable for generating IDs
+ */
+export declare function simpleHash(str: string): string;
+/**
+ * Generate a registrator ID based on file path and items count
+ */
+export declare function generateRegistratorId(filePath: string | undefined, itemsCount: number): string;

package/dist/tools/simpleHash.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.simpleHash = simpleHash;
+exports.generateRegistratorId = generateRegistratorId;
+/**
+ * Simple hash function that generates predictable hashes
+ * This is not cryptographically secure but suitable for generating IDs
+ */
+function simpleHash(str) {
+    let hash = 0;
+    if (str.length === 0)
+        return hash.toString();
+    for (let i = 0; i < str.length; i++) {
+        const char = str.charCodeAt(i);
+        hash = (hash << 5) - hash + char;
+        hash = hash & hash; // Convert to 32bit integer
+    }
+    // Convert to positive hex string
+    const hashStr = Math.abs(hash).toString(16);
+    return hashStr.padStart(8, "0");
+}
+/**
+ * Generate a registrator ID based on file path and items count
+ */
+function generateRegistratorId(filePath, itemsCount) {
+    // Use file path or fallback
+    const path = filePath || "unknown";
+    // Create a deterministic string to hash
+    const hashInput = `registrator:${path}:${itemsCount}`;
+    // Generate hash
+    const hash = simpleHash(hashInput);
+    return `registrator.${hash}`;
+}
+//# sourceMappingURL=simpleHash.js.map

package/dist/tools/simpleHash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simpleHash.js","sourceRoot":"","sources":["../../src/tools/simpleHash.ts"],"names":[],"mappings":";;AAIA,gCAaC;AAKD,sDAcC;AApCD;;;GAGG;AACH,SAAgB,UAAU,CAAC,GAAW;IACpC,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IAE7C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC/B,IAAI,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;QACjC,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,2BAA2B;IACjD,CAAC;IAED,iCAAiC;IACjC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC5C,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB,CACnC,QAA4B,EAC5B,UAAkB;IAElB,4BAA4B;IAC5B,MAAM,IAAI,GAAG,QAAQ,IAAI,SAAS,CAAC;IAEnC,wCAAwC;IACxC,MAAM,SAAS,GAAG,eAAe,IAAI,IAAI,UAAU,EAAE,CAAC;IAEtD,gBAAgB;IAChB,MAAM,IAAI,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;IAEnC,OAAO,eAAe,IAAI,EAAE,CAAC;AAC/B,CAAC"}

package/dist/types/base-interfaces.d.ts

@@ -0,0 +1,18 @@
+export interface ITask<TInput = any, TOutput extends Promise<any> = any, TDependencies = any, TOn = any> {
+    id: string;
+}
+export interface IResource<TConfig = void, TValue = any, TDependencies = any, TContext = any> {
+    id: string;
+}
+export interface IEventDefinition<TPayload = void> {
+    id: string;
+}
+export interface IMiddleware<TConfig = any, TDependencies = any> {
+    id: string;
+}
+export interface IResourceWithConfig<TConfig = any, TValue = any, TDependencies = any> {
+    id: string;
+}
+export interface IMiddlewareConfigured<TConfig = any, TDependencies = any> {
+    id: string;
+}

package/dist/types/base-interfaces.js

@@ -0,0 +1,6 @@
+"use strict";
+// Layer 2: Core Abstractions - Forward Declarations
+// These are forward declarations only to break circular dependencies
+// They include minimal required properties for dependency system to work
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=base-interfaces.js.map

package/dist/types/base-interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-interfaces.js","sourceRoot":"","sources":["../../src/types/base-interfaces.ts"],"names":[],"mappings":";AAAA,oDAAoD;AACpD,qEAAqE;AACrE,yEAAyE"}

package/dist/types/base.d.ts

@@ -0,0 +1,13 @@
+export interface IMeta {
+    title?: string;
+    description?: string;
+    tags?: string[];
+}
+export interface ITaskMeta extends IMeta {
+}
+export interface IResourceMeta extends IMeta {
+}
+export interface IEventMeta extends IMeta {
+}
+export interface IMiddlewareMeta extends IMeta {
+}

package/dist/types/base.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=base.js.map

package/dist/types/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/types/base.ts"],"names":[],"mappings":""}

package/dist/types/dependencies.d.ts

@@ -0,0 +1,22 @@
+interface ITask<TInput = any, TOutput extends Promise<any> = any, TDependencies extends DependencyMapType = {}, TOn extends "*" | IEventDefinition<any> | undefined = undefined> {
+    id: string;
+}
+interface IResource<TConfig = void, TValue = any, TDependencies extends DependencyMapType = any, TContext = any> {
+    id: string;
+}
+interface IEventDefinition<TPayload = void> {
+    id: string;
+}
+export type DependencyMapType = Record<string, ITask<any, any, any, any> | IResource<any, any, any> | IEventDefinition<any>>;
+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 TaskDependency<I, O> = (...args: I extends null | void ? [] : [I]) => O;
+type ResourceDependency<V> = V;
+type EventDependency<P> = (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 {};

package/dist/types/dependencies.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=dependencies.js.map

package/dist/types/dependencies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.js","sourceRoot":"","sources":["../../src/types/dependencies.ts"],"names":[],"mappings":""}

package/dist/types/dependency-core.d.ts

@@ -0,0 +1,14 @@
+import type { ITask, IResource, IEventDefinition } from './base-interfaces';
+export type DependencyMapType = Record<string, ITask<any, any, any, any> | IResource<any, any, any> | IEventDefinition<any>>;
+type ExtractTaskInput<T> = T extends ITask<infer I, any, any, any> ? I : never;
+type ExtractTaskOutput<T> = T extends ITask<any, infer O, any, any> ? O : never;
+type ExtractResourceValue<T> = T extends IResource<any, infer V, any> ? V : never;
+type ExtractEventParams<T> = T extends IEventDefinition<infer P> ? P : never;
+type TaskDependency<I, O> = (...args: I extends null | void ? [] : [I]) => O;
+type ResourceDependency<V> = V;
+type EventDependency<P> = (input: P) => Promise<void>;
+export type DependencyValueType<T> = T extends ITask<any, any, any, any> ? TaskDependency<ExtractTaskInput<T>, ExtractTaskOutput<T>> : T extends IResource<any, 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 {};

package/dist/types/dependency-core.js

@@ -0,0 +1,5 @@
+"use strict";
+// Layer 2: Core Abstractions - Dependency System
+// Uses forward declarations to break circular dependencies
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=dependency-core.js.map

package/dist/types/dependency-core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-core.js","sourceRoot":"","sources":["../../src/types/dependency-core.ts"],"names":[],"mappings":";AAAA,iDAAiD;AACjD,2DAA2D"}

package/dist/types/events.d.ts

@@ -0,0 +1,52 @@
+import { symbolEvent } from './symbols';
+import type { IEventMeta } from './meta';
+export interface IEvent<TPayload = any> {
+    id: string;
+    /**
+     * The data that the event carries. It can be anything.
+     */
+    data: TPayload;
+    /**
+     * The timestamp when the event was created.
+     */
+    timestamp: Date;
+    /**
+     * 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;
+}
+export type BeforeRunEventPayload<TInput> = {
+    input: TInput;
+};
+export type AfterRunEventPayload<TInput, TOutput> = {
+    input: TInput;
+    output: TOutput extends Promise<infer U> ? U : TOutput;
+    setOutput(newOutput: TOutput extends Promise<infer U> ? U : TOutput): void;
+};
+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;
+};
+export type AfterInitEventPayload<TConfig, TValue> = {
+    config: TConfig;
+    value: TValue;
+};

package/dist/types/events.js

@@ -0,0 +1,6 @@
+"use strict";
+// Layer 3: Component Definitions - Events
+// Imports from Layer 1 & 2
+Object.defineProperty(exports, "__esModule", { value: true });
+const symbols_1 = require("./symbols");
+//# sourceMappingURL=events.js.map

package/dist/types/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/types/events.ts"],"names":[],"mappings":";AAAA,0CAA0C;AAC1C,2BAA2B;;AAE3B,uCAAwC"}

package/dist/types/hooks.d.ts

@@ -0,0 +1,16 @@
+import type { IEventDefinition, IEvent } from './events';
+import type { DependencyMapType, DependencyValuesType } from './dependency-core';
+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/types/hooks.js

@@ -0,0 +1,5 @@
+"use strict";
+// Layer 4: Integration Types - Hooks
+// Imports from event and dependency systems
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=hooks.js.map

package/dist/types/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/types/hooks.ts"],"names":[],"mappings":";AAAA,qCAAqC;AACrC,4CAA4C"}

package/dist/types/index.d.ts

@@ -0,0 +1,14 @@
+export * from './symbols';
+export * from './base';
+export * from './utilities';
+export * from './dependencies';
+export * from './events';
+export * from './tasks';
+export * from './resources';
+export * from './middleware';
+export * from './hooks';
+import type { IResourceWithConfig, IResource, ITaskDefinition, IMiddlewareDefinition, IEventDefinition } from './index';
+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>;
+export { ICacheInstance } from "../globals/middleware/cache.middleware";