@bluelibs/runner 2.2.3 → 3.0.0

package/dist/models/Logger.js

@@ -1,11 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Logger = void 0;
-const globalEvents_1 = require("../globalEvents");
+const globalEvents_1 = require("../globals/globalEvents");
 class Logger {
     eventManager;
     printThreshold = null;
-    severity = {
+    boundContext = {};
+    static Severity = {
         trace: 0,
         debug: 1,
         info: 2,
@@ -13,25 +14,53 @@ class Logger {
         error: 4,
         critical: 5,
     };
-    constructor(eventManager) {
+    constructor(eventManager, boundContext = {}) {
         this.eventManager = eventManager;
+        this.boundContext = { ...boundContext };
     }
     /**
-     * @param level
-     * @param message
+     * Creates a new logger instance with additional bound context
      */
-    async log(level, data, source) {
+    with(context) {
+        return new Logger(this.eventManager, {
+            ...this.boundContext,
+            ...context,
+        });
+    }
+    extractErrorInfo(error) {
+        return {
+            name: error.name,
+            message: error.message,
+            stack: error.stack,
+        };
+    }
+    /**
+     * Core logging method with structured LogInfo
+     */
+    log(level, message, logInfo = {}) {
+        const { source, error, data, ...context } = logInfo;
         const log = {
             level,
-            data,
-            source: source,
+            message,
+            source: source || this.boundContext.source,
             timestamp: new Date(),
+            error: error ? this.extractErrorInfo(error) : undefined,
+            data: data || undefined,
+            context: { ...this.boundContext, ...context },
         };
         if (this.printThreshold &&
-            this.severity[level] >= this.severity[this.printThreshold]) {
+            Logger.Severity[level] >= Logger.Severity[this.printThreshold]) {
             this.print(log);
         }
-        await this.eventManager.emit(globalEvents_1.globalEvents.log, log, source || "unknown");
+        if (this.eventManager.hasListeners(globalEvents_1.globalEvents.log)) {
+            setImmediate(() => {
+                this.eventManager
+                    .emit(globalEvents_1.globalEvents.log, log, source || this.boundContext.source || "unknown")
+                    .catch((err) => {
+                    console.error("Logger event emission failed:", err);
+                });
+            });
+        }
     }
     /**
      * Will print logs after that, use `null` to disable autoprinting.
@@ -41,47 +70,106 @@ class Logger {
         this.printThreshold = level;
     }
     print(log) {
-        // Extract the relevant information from the log
-        const { level, source: context, data, timestamp } = log;
-        // Format the timestamp to a more readable format
-        const formattedTimestamp = timestamp.toISOString();
-        // Format the log level for better visibility
-        const levelStr = `[${level.toUpperCase()}]`;
-        // Format the context, if provided
-        const contextStr = context ? `(${context})` : "";
-        // Handle different data types, especially if it's an error
-        let dataStr;
-        if (data instanceof Error) {
-            dataStr = `Error: ${data.name} - ${data.message}\nStack Trace:\n${data.stack}`;
-        }
-        else if (typeof data === "object") {
-            dataStr = JSON.stringify(data, null, 2); // Pretty-print JSON objects
+        const { level, source, message, timestamp, error, data, context } = log;
+        // Color codes for different log levels
+        const colors = {
+            trace: '\x1b[90m', // bright black/gray
+            debug: '\x1b[36m', // cyan
+            info: '\x1b[32m', // green
+            warn: '\x1b[33m', // yellow
+            error: '\x1b[31m', // red
+            critical: '\x1b[35m', // magenta
+            reset: '\x1b[0m', // reset
+            bold: '\x1b[1m', // bold
+            dim: '\x1b[2m', // dim
+            blue: '\x1b[34m', // blue
+            red: '\x1b[31m', // red
+            cyan: '\x1b[36m', // cyan
+        };
+        const levelColor = colors[level] || colors.info;
+        // Format timestamp
+        const time = timestamp.toLocaleTimeString('en-US', {
+            hour12: false,
+            hour: '2-digit',
+            minute: '2-digit',
+            second: '2-digit'
+        });
+        const ms = timestamp.getMilliseconds().toString().padStart(3, '0');
+        const formattedTime = `${colors.dim}${time}.${ms}${colors.reset}`;
+        // Format level with color and padding
+        const levelStr = `${levelColor}${colors.bold}${level.toUpperCase().padEnd(8)}${colors.reset}`;
+        // Format source
+        const sourceStr = source ? `${colors.blue}[${source}]${colors.reset} ` : '';
+        // Format the main message
+        let messageStr;
+        if (typeof message === 'object') {
+            messageStr = JSON.stringify(message, null, 2);
         }
         else {
-            dataStr = String(data); // Convert any other type to string
+            messageStr = String(message);
+        }
+        // Build the main log line
+        const mainLine = `${formattedTime} ${levelStr} ${sourceStr}${messageStr}`;
+        // Start building output lines
+        const lines = [mainLine];
+        // Add error information if present
+        if (error) {
+            lines.push(`${colors.dim}├─ ${colors.red}Error: ${error.name}${colors.reset}`);
+            lines.push(`${colors.dim}├─ ${colors.red}${error.message}${colors.reset}`);
+            if (error.stack) {
+                const stackLines = error.stack.split('\n').slice(1, 4); // Show first 3 stack frames
+                stackLines.forEach((line, index) => {
+                    const prefix = index === stackLines.length - 1 ? '└─' : '├─';
+                    lines.push(`${colors.dim}${prefix} ${colors.red}${line.trim()}${colors.reset}`);
+                });
+            }
+        }
+        // Add structured data if present
+        if (data && Object.keys(data).length > 0) {
+            lines.push(`${colors.dim}├─ ${colors.cyan}Data:${colors.reset}`);
+            const dataStr = JSON.stringify(data, null, 2);
+            const dataLines = dataStr.split('\n');
+            dataLines.forEach((line, index) => {
+                const prefix = index === dataLines.length - 1 ? '└─' : '├─';
+                lines.push(`${colors.dim}${prefix}   ${colors.cyan}${line}${colors.reset}`);
+            });
+        }
+        // Add context if present (excluding common context we already show)
+        const filteredContext = context ? { ...context } : {};
+        delete filteredContext.source; // Already shown in source
+        if (filteredContext && Object.keys(filteredContext).length > 0) {
+            lines.push(`${colors.dim}└─ ${colors.blue}Context:${colors.reset}`);
+            const contextStr = JSON.stringify(filteredContext, null, 2);
+            const contextLines = contextStr.split('\n');
+            contextLines.forEach((line, index) => {
+                const prefix = index === contextLines.length - 1 ? '  ' : '  ';
+                lines.push(`${colors.dim}${prefix}   ${colors.blue}${line}${colors.reset}`);
+            });
+        }
+        // Output all lines
+        lines.forEach(line => console.log(line));
+        // Add a subtle separator for multi-line logs
+        if (lines.length > 1) {
+            console.log(`${colors.dim}${colors.reset}`);
         }
-        // Construct the final log message
-        const logMessage = `${formattedTimestamp} ${levelStr} ${contextStr} - ${dataStr}`;
-        // Print the log message
-        console.log(logMessage);
     }
-    async info(data, source) {
-        await this.log("info", data, source);
+    info(message, logInfo = {}) {
+        this.log("info", message, logInfo);
     }
-    async error(data, source) {
-        await this.log("error", data, source);
+    error(message, logInfo = {}) {
+        this.log("error", message, logInfo);
     }
-    async warn(data, source) {
-        await this.log("warn", data, source);
+    warn(message, logInfo = {}) {
+        this.log("warn", message, logInfo);
     }
-    async debug(data, source) {
-        await this.log("debug", data, source);
+    debug(message, logInfo = {}) {
+        this.log("debug", message, logInfo);
     }
-    async trace(data, source) {
-        await this.log("trace", data, source);
+    trace(message, logInfo = {}) {
+        this.log("trace", message, logInfo);
     }
-    async critical(data, source) {
-        await this.log("critical", data, source);
+    critical(message, logInfo = {}) {
+        this.log("critical", message, logInfo);
     }
 }
 exports.Logger = Logger;

package/dist/models/Logger.js.map

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

package/dist/models/OverrideManager.d.ts

@@ -0,0 +1,13 @@
+import { IResource, IMiddleware, ITask, IResourceWithConfig, RegisterableItems } from "../defs";
+import { StoreRegistry } from "./StoreRegistry";
+export declare class OverrideManager {
+    private readonly registry;
+    overrides: Map<string, IResource | IMiddleware | ITask | IResourceWithConfig>;
+    overrideRequests: Set<{
+        source: string;
+        override: RegisterableItems;
+    }>;
+    constructor(registry: StoreRegistry);
+    storeOverridesDeeply<C>(element: IResource<C, any, any>): void;
+    processOverrides(): void;
+}

package/dist/models/OverrideManager.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OverrideManager = void 0;
+const utils = require("../define");
+const errors_1 = require("../errors");
+class OverrideManager {
+    registry;
+    overrides = new Map();
+    overrideRequests = new Set();
+    constructor(registry) {
+        this.registry = registry;
+    }
+    storeOverridesDeeply(element) {
+        element.overrides.forEach((override) => {
+            if (utils.isResource(override)) {
+                this.storeOverridesDeeply(override);
+            }
+            let id;
+            if (utils.isResourceWithConfig(override)) {
+                this.storeOverridesDeeply(override.resource);
+                id = override.resource.id;
+            }
+            else {
+                id = override.id;
+            }
+            this.overrideRequests.add({ source: element.id, override });
+            this.overrides.set(id, override);
+        });
+    }
+    processOverrides() {
+        // If we are trying to use override on something that wasn't previously registered, we throw an error.
+        for (const override of this.overrides.values()) {
+            let hasAnyItem = false;
+            if (utils.isTask(override)) {
+                hasAnyItem = this.registry.tasks.has(override.id);
+            }
+            else if (utils.isResource(override)) {
+                hasAnyItem = this.registry.resources.has(override.id);
+            }
+            else if (utils.isMiddleware(override)) {
+                hasAnyItem = this.registry.middlewares.has(override.id);
+            }
+            else if (utils.isResourceWithConfig(override)) {
+                hasAnyItem = this.registry.resources.has(override.resource.id);
+            }
+            if (!hasAnyItem) {
+                const id = utils.isResourceWithConfig(override)
+                    ? override.resource.id
+                    : override.id;
+                throw errors_1.Errors.dependencyNotFound(id);
+            }
+        }
+        for (const override of this.overrides.values()) {
+            if (utils.isTask(override)) {
+                this.registry.storeTask(override, false);
+            }
+            else if (utils.isResource(override)) {
+                this.registry.storeResource(override, false);
+            }
+            else if (utils.isMiddleware(override)) {
+                this.registry.storeMiddleware(override, false);
+            }
+            else if (utils.isResourceWithConfig(override)) {
+                this.registry.storeResourceWithConfig(override, false);
+            }
+        }
+    }
+}
+exports.OverrideManager = OverrideManager;
+//# sourceMappingURL=OverrideManager.js.map

package/dist/models/OverrideManager.js.map

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

package/dist/models/Queue.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Cooperative task queue.
+ *  • Tasks run one‑after‑another (FIFO ordering).
+ *  • Dead‑lock detection prevents nesting.
+ *  • dispose() drains or cancels outstanding tasks, then rejects new ones.
+ */
+export declare class Queue {
+    private tail;
+    private disposed;
+    private abortController;
+    private readonly executionContext;
+    /**
+     * Schedule an asynchronous task.
+     * @param task – receives an AbortSignal so it can cancel early if desired.
+     */
+    run<T>(task: (signal: AbortSignal) => Promise<T>): Promise<T>;
+    /**
+     * Disposes the queue.
+     * @param options.cancel – if true, broadcasts AbortSignal to running task.
+     *                         default: false (waits for tasks to finish).
+     */
+    dispose(options?: {
+        cancel?: boolean;
+    }): Promise<void>;
+}

package/dist/models/Queue.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Queue = void 0;
+const node_async_hooks_1 = require("node:async_hooks");
+/**
+ * Cooperative task queue.
+ *  • Tasks run one‑after‑another (FIFO ordering).
+ *  • Dead‑lock detection prevents nesting.
+ *  • dispose() drains or cancels outstanding tasks, then rejects new ones.
+ */
+class Queue {
+    tail = Promise.resolve();
+    disposed = false;
+    abortController = new AbortController();
+    // true while inside a queued task → helps detect "queue in queue"
+    executionContext = new node_async_hooks_1.AsyncLocalStorage();
+    /**
+     * Schedule an asynchronous task.
+     * @param task – receives an AbortSignal so it can cancel early if desired.
+     */
+    run(task) {
+        // 1. refuse new work if we've disposed
+        if (this.disposed) {
+            return Promise.reject(new Error("Queue has been disposed"));
+        }
+        // 2. detect dead‑locks (a queued task adding another queued task)
+        if (this.executionContext.getStore()) {
+            return Promise.reject(new Error("Dead‑lock detected: a queued task attempted to queue another task"));
+        }
+        const { signal } = this.abortController;
+        // 3. chain task after the current tail
+        const result = this.tail.then(() => this.executionContext.run(true, () => task(signal)));
+        // 4. preserve the chain even if the task rejects (swallow internally)
+        this.tail = result.catch(() => { });
+        return result;
+    }
+    /**
+     * Disposes the queue.
+     * @param options.cancel – if true, broadcasts AbortSignal to running task.
+     *                         default: false (waits for tasks to finish).
+     */
+    async dispose(options = {}) {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        if (options.cancel) {
+            this.abortController.abort(); // notify cooperative tasks
+        }
+        // wait for everything already chained to settle
+        await this.tail.catch(() => { });
+    }
+}
+exports.Queue = Queue;
+//# sourceMappingURL=Queue.js.map

package/dist/models/Queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Queue.js","sourceRoot":"","sources":["../../src/models/Queue.ts"],"names":[],"mappings":";;;AAAA,uDAAqD;AAErD;;;;;GAKG;AACH,MAAa,KAAK;IACR,IAAI,GAAqB,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3C,QAAQ,GAAG,KAAK,CAAC;IACjB,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;IAEhD,kEAAkE;IACjD,gBAAgB,GAAG,IAAI,oCAAiB,EAAW,CAAC;IAErE;;;OAGG;IACI,GAAG,CAAI,IAAyC;QACrD,uCAAuC;QACvC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC,CAAC;QAC9D,CAAC;QAED,kEAAkE;QAClE,IAAI,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,EAAE,CAAC;YACrC,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,KAAK,CACP,mEAAmE,CACpE,CACF,CAAC;QACJ,CAAC;QAED,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,eAAe,CAAC;QAExC,uCAAuC;QACvC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CACjC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CACpD,CAAC;QAEF,sEAAsE;QACtE,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAEnC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,OAAO,CAAC,UAAgC,EAAE;QACrD,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAE1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QAErB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC,CAAC,2BAA2B;QAC3D,CAAC;QAED,gDAAgD;QAChD,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAClC,CAAC;CACF;AAzDD,sBAyDC"}

package/dist/models/ResourceInitializer.d.ts

@@ -11,6 +11,9 @@ export declare class ResourceInitializer {
      * Begins the execution of an task. These are registered tasks and all sanity checks have been performed at this stage to ensure consistency of the object.
      * This function can throw only if any of the event listeners or run function throws
      */
-    initializeResource<TConfig = null, TValue = any, TDeps extends DependencyMapType = {}>(resource: IResource<TConfig, TValue, TDeps>, config: TConfig, dependencies: DependencyValuesType<TDeps>): Promise<TValue | undefined>;
-    initWithMiddleware<C, V, D extends DependencyMapType>(resource: IResource<C, V>, config: C, dependencies: D): Promise<V | undefined>;
+    initializeResource<TConfig = null, TValue = any, TDeps extends DependencyMapType = {}, TContext = any>(resource: IResource<TConfig, TValue, TDeps>, config: TConfig, dependencies: DependencyValuesType<TDeps>): Promise<{
+        value: TValue;
+        context: TContext;
+    }>;
+    initWithMiddleware<C, V, D extends DependencyMapType, TContext>(resource: IResource<C, V, D, TContext>, config: C, dependencies: DependencyValuesType<D>, context: TContext): Promise<V | undefined>;
 }

package/dist/models/ResourceInitializer.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ResourceInitializer = void 0;
-const globalEvents_1 = require("../globalEvents");
+const globalEvents_1 = require("../globals/globalEvents");
 class ResourceInitializer {
     store;
     eventManager;
@@ -16,6 +16,7 @@ class ResourceInitializer {
      * This function can throw only if any of the event listeners or run function throws
      */
     async initializeResource(resource, config, dependencies) {
+        const context = resource.context?.();
         await this.eventManager.emit(globalEvents_1.globalEvents.resources.beforeInit, {
             config,
             resource,
@@ -23,18 +24,20 @@ class ResourceInitializer {
         await this.eventManager.emit(resource.events.beforeInit, { config }, resource.id);
         let error, value;
         try {
-            value = await this.initWithMiddleware(resource, config, dependencies);
+            if (resource.init) {
+                value = await this.initWithMiddleware(resource, config, dependencies, context);
+            }
             await this.eventManager.emit(resource.events.afterInit, {
                 config,
-                value,
+                value: value,
             }, resource.id);
             await this.eventManager.emit(globalEvents_1.globalEvents.resources.afterInit, {
                 config,
                 resource,
-                value,
+                value: value,
             }, resource.id);
-            this.logger.debug(`Resource ${resource.id} initialized`, resource.id);
-            return value;
+            this.logger.debug(`Resource ${resource.id} initialized`, { source: resource.id });
+            return { value: value, context };
         }
         catch (e) {
             error = e;
@@ -44,27 +47,28 @@ class ResourceInitializer {
             }
             // If you want to rewthrow the error, this should be done inside the onError event.
             await this.eventManager.emit(resource.events.onError, {
-                error,
+                error: error,
                 suppress,
             }, resource.id);
             await this.eventManager.emit(globalEvents_1.globalEvents.resources.onError, {
-                error,
+                error: error,
                 resource,
                 suppress,
             }, resource.id);
             if (!isSuppressed)
                 throw e;
+            return { value: undefined, context: {} };
         }
     }
-    async initWithMiddleware(resource, config, dependencies) {
+    async initWithMiddleware(resource, config, dependencies, context) {
         let next = async (config) => {
             if (resource.init) {
-                return resource.init.call(null, config, dependencies);
+                return resource.init.call(null, config, dependencies, context);
             }
         };
         const existingMiddlewares = resource.middleware;
         const createdMiddlewares = [
-            ...this.store.getGlobalMiddlewares(existingMiddlewares.map((x) => x.id)),
+            ...this.store.getEverywhereMiddlewareForResources(existingMiddlewares.map((x) => x.id)),
             ...existingMiddlewares,
         ];
         for (let i = createdMiddlewares.length - 1; i >= 0; i--) {
@@ -73,10 +77,12 @@ class ResourceInitializer {
             const nextFunction = next;
             next = async (config) => {
                 return storeMiddleware.middleware.run({
-                    resourceDefinition: resource,
-                    config: config,
+                    resource: {
+                        definition: resource,
+                        config,
+                    },
                     next: nextFunction,
-                }, storeMiddleware.computedDependencies);
+                }, storeMiddleware.computedDependencies, middleware.config);
             };
         }
         return next(config);

package/dist/models/ResourceInitializer.js.map

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

package/dist/models/Semaphore.d.ts

@@ -0,0 +1,61 @@
+/**
+ * A semaphore that limits the number of concurrent operations.
+ * Used to prevent connection pool exhaustion by limiting concurrent
+ * database operations to the pool size.
+ */
+export declare class Semaphore {
+    private permits;
+    private readonly waitingQueue;
+    private disposed;
+    private readonly maxPermits;
+    constructor(maxPermits: number);
+    /**
+     * Acquire a permit. If no permits are available, waits until one becomes available.
+     */
+    acquire(options?: {
+        timeout?: number;
+        signal?: AbortSignal;
+    }): Promise<void>;
+    /**
+     * Release a permit, allowing waiting operations to proceed.
+     */
+    release(): void;
+    private removeFromQueue;
+    /**
+     * Execute a function with a permit, automatically releasing it afterwards.
+     */
+    withPermit<T>(fn: () => Promise<T>, options?: {
+        timeout?: number;
+        signal?: AbortSignal;
+    }): Promise<T>;
+    /**
+     * Dispose the semaphore, rejecting all waiting operations and preventing new ones.
+     */
+    dispose(): void;
+    /**
+     * Get current number of available permits (for debugging)
+     */
+    getAvailablePermits(): number;
+    /**
+     * Get current number of waiting operations (for debugging)
+     */
+    getWaitingCount(): number;
+    /**
+     * Get maximum number of permits
+     */
+    getMaxPermits(): number;
+    /**
+     * Check if the semaphore has been disposed
+     */
+    isDisposed(): boolean;
+    /**
+     * Get metrics about the current state of the semaphore
+     */
+    getMetrics(): {
+        availablePermits: number;
+        waitingCount: number;
+        maxPermits: number;
+        utilization: number;
+        disposed: boolean;
+    };
+}