@bluelibs/runner 4.5.0-alpha → 4.5.0-alpha.2

package/dist/run.js

@@ -1,126 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-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("./globals/globalEvents");
-const Store_1 = require("./models/Store");
-const Logger_1 = require("./models/Logger");
-const define_1 = require("./define");
-const debug_1 = require("./globals/resources/debug");
-const processHooks_1 = require("./processHooks");
-const UnhandledError_1 = require("./models/UnhandledError");
-const RunResult_1 = require("./models/RunResult");
-const platform_1 = require("./platform");
-const platform = (0, platform_1.getPlatform)();
-/**
- * This is the central function that kicks off you runner. You can run as many resources as you want in a single process, they will run in complete isolation.
- *
- * @param resourceOrResourceWithConfig - The resource or resource with config to run.
- * @param options - The options for the run.
- * @returns A promise that resolves to the result of the run.
- */
-async function run(resourceOrResourceWithConfig, // For optional config
-options) {
-    const { debug = undefined, logs = {}, errorBoundary = true, shutdownHooks = true, dryRun = false, onUnhandledError: onUnhandledErrorOpt, runtimeCycleDetection = true, } = options || {};
-    const { printThreshold = platform.getEnv("NODE_ENV") === "test" ? null : "info", printStrategy = "pretty", bufferLogs = false, } = logs;
-    const eventManager = new EventManager_1.EventManager({
-        runtimeCycleDetection,
-    });
-    let { resource, config } = extractResourceAndConfig(resourceOrResourceWithConfig);
-    // ensure for logger, that it can be used only after: computeAllDependencies() has executed
-    const logger = new Logger_1.Logger({
-        printThreshold,
-        printStrategy,
-        bufferLogs,
-    });
-    const onUnhandledError = onUnhandledErrorOpt || (0, UnhandledError_1.createDefaultUnhandledError)(logger);
-    const store = new Store_1.Store(eventManager, logger, onUnhandledError);
-    const taskRunner = new TaskRunner_1.TaskRunner(store, eventManager, logger);
-    store.setTaskRunner(taskRunner);
-    // Register this run's event manager for global process error safety nets
-    let unhookProcessSafetyNets;
-    if (errorBoundary) {
-        unhookProcessSafetyNets = (0, processHooks_1.registerProcessLevelSafetyNets)((0, UnhandledError_1.bindProcessErrorHandler)(onUnhandledError));
-    }
-    const processor = new DependencyProcessor_1.DependencyProcessor(store, eventManager, taskRunner, logger);
-    // We may install shutdown hooks; capture unhook function to remove them on dispose
-    let unhookShutdown;
-    // Helper dispose that always unhooks process listeners first
-    const disposeAll = async () => {
-        try {
-            if (unhookProcessSafetyNets) {
-                unhookProcessSafetyNets();
-                unhookProcessSafetyNets = undefined;
-            }
-            if (unhookShutdown) {
-                unhookShutdown();
-                unhookShutdown = undefined;
-            }
-        }
-        finally {
-            await store.dispose();
-        }
-    };
-    try {
-        if (debug) {
-            store.storeGenericItem(debug_1.debugResource.with(debug));
-        }
-        // In the registration phase we register deeply all the resources, tasks, middleware and events
-        store.initializeStore(resource, config);
-        // the overrides that were registered now will override the other registered resources
-        await store.processOverrides();
-        store.validateDependencyGraph();
-        // Compile-time event emission cycle detection (cheap, graph-based)
-        store.validateEventEmissionGraph();
-        const boundedLogger = logger.with({ source: "run" });
-        if (dryRun) {
-            await boundedLogger.debug("Dry run mode. Skipping initialization...");
-            return new RunResult_1.RunResult(store.root.value, logger, store, eventManager, taskRunner, disposeAll);
-        }
-        // Beginning initialization
-        await boundedLogger.debug("Events stored. Attaching listeners...");
-        await processor.attachListeners();
-        await boundedLogger.debug("Listeners attached. Computing dependencies...");
-        await processor.computeAllDependencies();
-        // After this stage, logger print policy could have been set.
-        await boundedLogger.debug("Dependencies computed. Proceeding with initialization...");
-        // Now we can safely compute dependencies without being afraid of an infinite loop.
-        // The hooking part is done here.
-        // Now we can initialise the root resource
-        await processor.initializeRoot();
-        // disallow manipulation or attaching more
-        store.lock();
-        eventManager.lock();
-        await logger.lock();
-        await eventManager.emit(globalEvents_1.globalEvents.ready, {
-            root: store.root.resource,
-        }, "system");
-        await boundedLogger.info("Runner online. Awaiting tasks and events.");
-        if (shutdownHooks) {
-            unhookShutdown = (0, processHooks_1.registerShutdownHook)(() => store.dispose());
-        }
-        return new RunResult_1.RunResult(store.root.value, logger, store, eventManager, taskRunner, disposeAll);
-    }
-    catch (err) {
-        // Rollback initialized resources
-        await disposeAll();
-        throw err;
-    }
-}
-// process hooks moved to processHooks.ts for clarity
-function extractResourceAndConfig(resourceOrResourceWithConfig) {
-    let resource;
-    let config;
-    if ((0, define_1.isResourceWithConfig)(resourceOrResourceWithConfig)) {
-        resource = resourceOrResourceWithConfig.resource;
-        config = resourceOrResourceWithConfig.config;
-    }
-    else {
-        resource = resourceOrResourceWithConfig;
-        config = undefined;
-    }
-    return { resource, config };
-}
-//# sourceMappingURL=run.js.map

package/dist/run.js.map

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

package/dist/testing.d.ts

@@ -1,25 +0,0 @@
-import { IResource, IResourceWithConfig, ITaskMiddleware, IResourceMiddleware, ITask, RegisterableItems, DependencyMapType } from "./defs";
-import { EventManager, Logger, Store, TaskRunner } from "./models";
-/**
- * Helper to create a minimal test harness resource that wraps a root app (or any registerable)
- * and exposes convenient testing utilities while running the full ecosystem
- * (registration, overrides, middleware, events) without modifying the core API.
- * @deprecated Use `run` instead with your testResource, as it provides the necessary toolkit.
- */
-export declare function createTestResource(root: RegisterableItems, options?: {
-    overrides?: Array<IResource | ITask | ITaskMiddleware | IResourceMiddleware | IResourceWithConfig>;
-}): IResource<void, Promise<ReturnType<typeof buildTestFacade>>>;
-declare function buildTestFacade(deps: {
-    taskRunner: TaskRunner;
-    store: Store;
-    logger: Logger;
-    eventManager: EventManager;
-}): {
-    runTask: <I, O extends Promise<any>, D extends DependencyMapType>(task: ITask<I, O, D>, ...args: I extends undefined ? [] : [I]) => Promise<Awaited<O> | undefined>;
-    getResource: (id: string) => any;
-    taskRunner: TaskRunner;
-    store: Store;
-    logger: Logger;
-    eventManager: EventManager;
-};
-export {};

package/dist/testing.js

@@ -1,42 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createTestResource = createTestResource;
-const define_1 = require("./define");
-const globalResources_1 = require("./globals/globalResources");
-let testResourceCounter = 0;
-/**
- * Helper to create a minimal test harness resource that wraps a root app (or any registerable)
- * and exposes convenient testing utilities while running the full ecosystem
- * (registration, overrides, middleware, events) without modifying the core API.
- * @deprecated Use `run` instead with your testResource, as it provides the necessary toolkit.
- */
-function createTestResource(root, options) {
-    return (0, define_1.defineResource)({
-        id: `testing.${root.id}.${++testResourceCounter}`,
-        register: [root],
-        overrides: options?.overrides || [],
-        dependencies: {
-            taskRunner: globalResources_1.globalResources.taskRunner,
-            store: globalResources_1.globalResources.store,
-            logger: globalResources_1.globalResources.logger,
-            eventManager: globalResources_1.globalResources.eventManager,
-        },
-        async init(_, deps) {
-            return buildTestFacade(deps);
-        },
-    });
-}
-function buildTestFacade(deps) {
-    return {
-        // Run a task within the fully initialized ecosystem
-        runTask: (task, ...args) => deps.taskRunner.run(task, ...args),
-        // Access a resource value by id (string or symbol)
-        getResource: (id) => deps.store.resources.get(id)?.value,
-        // Expose internals when needed in tests (not recommended for app usage)
-        taskRunner: deps.taskRunner,
-        store: deps.store,
-        logger: deps.logger,
-        eventManager: deps.eventManager,
-    };
-}
-//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"testing.js","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":";;AAyBA,gDA0BC;AAnDD,qCAA0C;AAC1C,+DAA4D;AAgB5D,IAAI,mBAAmB,GAAG,CAAC,CAAC;AAE5B;;;;;GAKG;AACH,SAAgB,kBAAkB,CAChC,IAAuB,EACvB,OAQC;IAED,OAAO,IAAA,uBAAc,EAAC;QACpB,EAAE,EAAE,WAAW,IAAI,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE;QACjD,QAAQ,EAAE,CAAC,IAAI,CAAC;QAChB,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,EAAE;QACnC,YAAY,EAAE;YACZ,UAAU,EAAE,iCAAe,CAAC,UAAU;YACtC,KAAK,EAAE,iCAAe,CAAC,KAAK;YAC5B,MAAM,EAAE,iCAAe,CAAC,MAAM;YAC9B,YAAY,EAAE,iCAAe,CAAC,YAAY;SAC3C;QACD,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI;YAChB,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AACD,SAAS,eAAe,CAAC,IAKxB;IACC,OAAO;QACL,oDAAoD;QACpD,OAAO,EAAE,CACP,IAAoB,EACpB,GAAG,IAAoC,EACN,EAAE,CACnC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,IAAI,CAAQ;QAC3C,mDAAmD;QACnD,WAAW,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,KAAK;QAChE,wEAAwE;QACxE,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,YAAY,EAAE,IAAI,CAAC,YAAY;KAChC,CAAC;AACJ,CAAC"}

package/dist/tools/getCallerFile.d.ts

@@ -1 +0,0 @@
-export declare function getCallerFile(): string;

package/dist/tools/getCallerFile.js

@@ -1,30 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getCallerFile = getCallerFile;
-function getCallerFile() {
-    const originalFunc = Error.prepareStackTrace;
-    try {
-        const err = new Error();
-        let callerfile;
-        let currentfile;
-        // Safeguard prepareStackTrace
-        Error.prepareStackTrace = (err, stack) => stack;
-        const stack = err.stack;
-        // Don't know how to test this.
-        // if (stack.length < 3) {
-        //   // We need at least 3 frames: current function, its caller, and one above
-        //   return undefined;
-        // }
-        // Remove the first frame (getCallerFile itself)
-        stack.shift();
-        // Remove the second frame (the direct caller of getCallerFile)
-        currentfile = stack.shift()?.getFileName?.();
-        // The third frame (the caller above the immediate one)
-        callerfile = stack.shift()?.getFileName?.();
-        return callerfile; // Return the file name of the caller above
-    }
-    finally {
-        Error.prepareStackTrace = originalFunc;
-    }
-}
-//# sourceMappingURL=getCallerFile.js.map

package/dist/tools/getCallerFile.js.map

@@ -1 +0,0 @@
-{"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,EAAE,CAAC;QAE7C,uDAAuD;QACvD,UAAU,GAAG,KAAK,CAAC,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,CAAC;QAE5C,OAAO,UAAoB,CAAC,CAAC,2CAA2C;IAC1E,CAAC;YAAS,CAAC;QACT,KAAK,CAAC,iBAAiB,GAAG,YAAY,CAAC;IACzC,CAAC;AACH,CAAC"}

package/dist/types/contracts.d.ts

@@ -1,55 +0,0 @@
-import { TagType } from "./tag";
-export declare const CONTRACT: unique symbol;
-export type CONTRACT = typeof CONTRACT;
-export interface IContractable<TConfig = any, TInput = void, TOutput = void> {
-    readonly __containsContract: true;
-    readonly [CONTRACT]: {
-        config: TConfig;
-        input: TInput;
-        output: TOutput;
-    };
-}
-export interface ITag<TConfig = any, TOutput = void> extends IContractable<TConfig, void, TOutput> {
-}
-export interface IMiddleware<TConfig = any, TInput = void, TOutput = void> extends IContractable<TConfig, TInput, TOutput> {
-}
-type NonVoid<T> = [T] extends [void] ? never : T;
-type IsTuple<T extends readonly unknown[]> = number extends T["length"] ? false : true;
-type UnionToIntersection<U> = (U extends any ? (arg: U) => void : never) extends (arg: infer I) => void ? I : never;
-type Simplify<T> = {
-    [K in keyof T]: T[K];
-} & {};
-type IsUnknown<T> = unknown extends T ? [T] extends [unknown] ? true : false : false;
-type UnknownToNever<T> = IsUnknown<T> extends true ? never : T;
-type ExtractContractOf<T, Kind extends "input" | "output"> = T extends IContractable<any, infer I, infer O> ? UnknownToNever<Kind extends "input" ? NonVoid<I> : NonVoid<O>> : never;
-type FilterContractsKind<TItems extends readonly unknown[], Kind extends "input" | "output", Acc extends readonly unknown[] = []> = TItems extends readonly [infer H, ...infer R] ? ExtractContractOf<H, Kind> extends never ? FilterContractsKind<R, Kind, Acc> : FilterContractsKind<R, Kind, [...Acc, ExtractContractOf<H, Kind>]> : Acc;
-type ExtractContractsFromCollection<TItems extends readonly unknown[], Kind extends "input" | "output"> = IsTuple<TItems> extends true ? FilterContractsKind<TItems, Kind> : Array<ExtractContractOf<TItems[number], Kind>>;
-export type ExtractInputTypeFromContracts<TItems extends readonly unknown[]> = ExtractContractsFromCollection<TItems, "input">;
-export type ExtractOutputTypeFromContracts<TItems extends readonly unknown[]> = ExtractContractsFromCollection<TItems, "output">;
-type ContractsUnionInputs<TItems extends readonly unknown[]> = ExtractInputTypeFromContracts<TItems> extends readonly (infer U)[] ? U : never;
-type ContractsUnionOutputs<TItems extends readonly unknown[]> = ExtractOutputTypeFromContracts<TItems> extends readonly (infer U)[] ? U : never;
-type ContractsIntersectionInputs<TItems extends readonly unknown[]> = UnionToIntersection<ContractsUnionInputs<TItems>>;
-type ContractsIntersectionOutputs<TItems extends readonly unknown[]> = UnionToIntersection<ContractsUnionOutputs<TItems>>;
-export type HasInputContracts<TItems extends readonly unknown[]> = [
-    ContractsUnionInputs<TItems>
-] extends [never] ? false : true;
-export type HasOutputContracts<TItems extends readonly unknown[]> = [
-    ContractsUnionOutputs<TItems>
-] extends [never] ? false : true;
-export type InputContractViolationError<TItems extends readonly unknown[], TActual> = {
-    message: "Value does not satisfy all input contracts";
-    expected: Simplify<ContractsIntersectionInputs<TItems>>;
-    received: TActual;
-};
-export type OutputContractViolationError<TItems extends readonly unknown[], TActual> = {
-    message: "Value does not satisfy all output contracts";
-    expected: Simplify<ContractsIntersectionOutputs<TItems>>;
-    received: TActual;
-};
-export type EnsureInputSatisfiesContracts<TItems extends readonly unknown[], TValue> = [ContractsUnionInputs<TItems>] extends [never] ? TValue : TValue extends Promise<infer U> ? Promise<U extends ContractsIntersectionInputs<TItems> ? U : InputContractViolationError<TItems, U>> : TValue extends ContractsIntersectionInputs<TItems> ? TValue : InputContractViolationError<TItems, TValue>;
-export type EnsureOutputSatisfiesContracts<TItems extends readonly unknown[], TResponse> = [ContractsUnionOutputs<TItems>] extends [never] ? TResponse : TResponse extends Promise<infer U> ? Promise<U extends ContractsIntersectionOutputs<TItems> ? U : OutputContractViolationError<TItems, U>> : TResponse extends ContractsIntersectionOutputs<TItems> ? TResponse : OutputContractViolationError<TItems, TResponse>;
-/** @deprecated Use ExtractOutputTypeFromContracts instead */
-export type ExtractTagsWithNonVoidReturnTypeFromTags<TTags extends TagType[]> = ExtractOutputTypeFromContracts<TTags>;
-/** @deprecated Use EnsureOutputSatisfiesContracts instead */
-export type EnsureResponseSatisfiesContracts<TTags extends TagType[], TResponse> = EnsureOutputSatisfiesContracts<TTags, TResponse>;
-export {};

package/dist/types/contracts.js

@@ -1,4 +0,0 @@
-"use strict";
-// Solution to enforce input,output contracts from 'tags' and 'middleware'
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=contracts.js.map

package/dist/types/contracts.js.map

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

package/dist/types/event.d.ts

@@ -1,74 +0,0 @@
-import { IOptionalDependency, IValidationSchema } from "../defs";
-import { TagType } from "./tag";
-import { IEventMeta } from "./meta";
-import { CommonPayload, symbolEvent, symbolFilePath } from "./utilities";
-export type EventHandlerType<T = any> = (event: IEventEmission<T>) => any | Promise<any>;
-export declare function onAnyOf<T extends readonly IEventDefinition<any>[]>(...defs: T): T;
-/**
- * Runtime guard that checks if an emission belongs to one of the given event defs.
- * Narrows payload type to the intersection of the provided events' payloads.
- */
-export declare function isOneOf<TDefs extends readonly IEventDefinition<any>[]>(emission: IEventEmission<any>, defs: TDefs): emission is IEventEmission<CommonPayload<TDefs>>;
-export interface IEventDefinition<TPayload = void> {
-    id: string;
-    meta?: IEventMeta;
-    /**
-     * Optional validation schema for runtime payload validation.
-     * When provided, event payload will be validated when emitted.
-     */
-    payloadSchema?: IValidationSchema<TPayload>;
-    tags?: TagType[];
-}
-/**
- * The definioten of the event.
- * This is different from the event emission.
- */
-export interface IEvent<TPayload = any> extends IEventDefinition<TPayload> {
-    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;
-    [symbolFilePath]: string;
-    /** Return an optional dependency wrapper for this event. */
-    optional: () => IOptionalDependency<IEvent<TPayload>>;
-    tags: TagType[];
-}
-/**
- * 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;
-    /**
-     * 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;
-    /**
-     * Metadata associated with the event definition.
-     */
-    meta: IEventMeta;
-    /**
-     * Stops propagation to remaining event listeners.
-     */
-    stopPropagation(): void;
-    /**
-     * Returns true if propagation has been stopped.
-     */
-    isPropagationStopped(): boolean;
-    /**
-     * The tags that the event carries.
-     */
-    tags: TagType[];
-}

package/dist/types/event.js

@@ -1,17 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.onAnyOf = onAnyOf;
-exports.isOneOf = isOneOf;
-const utilities_1 = require("./utilities");
-// Helper to keep tuple inference intact for multi-event hooks
-function onAnyOf(...defs) {
-    return defs;
-}
-/**
- * Runtime guard that checks if an emission belongs to one of the given event defs.
- * Narrows payload type to the intersection of the provided events' payloads.
- */
-function isOneOf(emission, defs) {
-    return defs.some((d) => d.id === emission.id);
-}
-//# sourceMappingURL=event.js.map

package/dist/types/event.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"event.js","sourceRoot":"","sources":["../../src/types/event.ts"],"names":[],"mappings":";;AAUA,0BAIC;AAMD,0BAKC;AAtBD,2CAAyE;AAMzE,8DAA8D;AAC9D,SAAgB,OAAO,CACrB,GAAG,IAAO;IAEV,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,SAAgB,OAAO,CACrB,QAA6B,EAC7B,IAAW;IAEX,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,EAAE,CAAC,CAAC;AAChD,CAAC"}

package/dist/types/hook.d.ts

@@ -1,23 +0,0 @@
-import { DependencyMapType, DependencyValuesType, IEventDefinition, IEventEmission, ExtractEventParams } from "../defs";
-import { TagType } from "./tag";
-import { ITaskMeta } from "./meta";
-import { CommonPayload, symbolFilePath, symbolHook } from "./utilities";
-type OnType = "*" | IEventDefinition<any> | readonly IEventDefinition<any>[];
-export interface IHookDefinition<TDependencies extends DependencyMapType = {}, TOn extends OnType = any, TMeta extends ITaskMeta = any> {
-    id: string;
-    dependencies?: TDependencies | (() => TDependencies);
-    on: TOn;
-    /** Listener execution order. Lower numbers run first. */
-    order?: number;
-    meta?: TMeta;
-    run: (event: IEventEmission<TOn extends "*" ? any : TOn extends readonly IEventDefinition<any>[] ? CommonPayload<TOn> : ExtractEventParams<TOn>>, dependencies: DependencyValuesType<TDependencies>) => Promise<any>;
-    tags?: TagType[];
-}
-export interface IHook<TDependencies extends DependencyMapType = {}, TOn extends OnType = any, TMeta extends ITaskMeta = any> extends IHookDefinition<TDependencies, TOn, TMeta> {
-    id: string;
-    dependencies: TDependencies | (() => TDependencies);
-    [symbolFilePath]: string;
-    [symbolHook]: true;
-    tags: TagType[];
-}
-export {};

package/dist/types/hook.js

@@ -1,4 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const utilities_1 = require("./utilities");
-//# sourceMappingURL=hook.js.map

package/dist/types/hook.js.map

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

package/dist/types/meta.d.ts

@@ -1,18 +0,0 @@
-/**
- * Common metadata you can attach to tasks/resources/events/middleware.
- * Useful for docs, filtering and middleware decisions.
- */
-export interface IMeta {
-    title?: string;
-    description?: string;
-}
-export interface ITaskMeta extends IMeta {
-}
-export interface IResourceMeta extends IMeta {
-}
-export interface IEventMeta extends IMeta {
-}
-export interface IMiddlewareMeta extends IMeta {
-}
-export interface ITagMeta extends IMeta {
-}

package/dist/types/meta.js

@@ -1,7 +0,0 @@
-"use strict";
-/**
- * Common metadata you can attach to tasks/resources/events/middleware.
- * Useful for docs, filtering and middleware decisions.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=meta.js.map

package/dist/types/meta.js.map

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

package/dist/types/resource.d.ts

@@ -1,84 +0,0 @@
-import { DependencyMapType, IOptionalDependency, IResourceMiddleware, IValidationSchema, OverridableElements, RegisterableItems, ResourceDependencyValuesType, ResourceMiddlewareAttachmentType } from "../defs";
-import { TagType } from "./tag";
-import { IResourceMeta } from "./meta";
-import { symbolFilePath, symbolIndexResource, symbolResource, symbolResourceWithConfig } from "./symbols";
-import { EnsureInputSatisfiesContracts, EnsureOutputSatisfiesContracts, HasInputContracts, HasOutputContracts } from "./contracts";
-export interface IResourceDefinition<TConfig = any, TValue extends Promise<any> = Promise<any>, TDependencies extends DependencyMapType = {}, TContext = any, THooks = any, TRegisterableItems = any, TMeta extends IResourceMeta = any, TTags extends TagType[] = TagType[], TMiddleware extends ResourceMiddlewareAttachmentType[] = ResourceMiddlewareAttachmentType[]> {
-    /** Stable identifier. */
-    id: string;
-    /** Static or lazy dependency map. Receives `config` when provided. */
-    dependencies?: TDependencies | ((config: TConfig) => TDependencies);
-    /**
-     * Register other registerables (resources/tasks/middleware/events). Accepts a
-     * static array or a function of `config` to support dynamic wiring.
-     */
-    register?: Array<RegisterableItems> | ((config: TConfig) => Array<RegisterableItems>);
-    /**
-     * Initialize and return the resource value. Called once during boot.
-     */
-    init?: (config: HasInputContracts<[...TTags, ...TMiddleware]> extends true ? EnsureInputSatisfiesContracts<[...TTags, ...TMiddleware], TConfig> : TConfig, dependencies: ResourceDependencyValuesType<TDependencies>, context: TContext) => HasOutputContracts<[...TTags, ...TMiddleware]> extends true ? EnsureOutputSatisfiesContracts<[...TTags, ...TMiddleware], TValue> : TValue;
-    /**
-     * Optional validation schema for the resource's resolved value.
-     * When provided, the value will be validated immediately after `init` resolves,
-     * without considering middleware.
-     */
-    resultSchema?: IValidationSchema<TValue extends Promise<infer U> ? U : TValue>;
-    /**
-     * Clean-up function for the resource. This is called when the resource is no longer needed.
-     *
-     * @param value The value of the resource (undefined if no init method)
-     * @param config The configuration it received
-     * @param dependencies The dependencies it needed
-     * @returns Promise<void>
-     */
-    dispose?: (this: any, value: TValue extends Promise<infer U> ? U : TValue, config: TConfig, dependencies: ResourceDependencyValuesType<TDependencies>, context: TContext) => Promise<void>;
-    meta?: TMeta;
-    /**
-     * Optional validation schema for runtime config validation.
-     * When provided, resource config will be validated when .with() is called.
-     */
-    configSchema?: IValidationSchema<TConfig>;
-    /**
-     * Safe overrides to swap behavior while preserving identities. See
-     * README: Overrides.
-     */
-    overrides?: Array<OverridableElements>;
-    /** Middleware applied around init/dispose. */
-    middleware?: TMiddleware;
-    /**
-     * Create a private, mutable context shared between `init` and `dispose`.
-     */
-    context?: () => TContext;
-    /**
-     * This is optional and used from an index resource to get the correct caller.
-     * This is the reason we allow it here as well.
-     */
-    [symbolFilePath]?: string;
-    /**
-     * This is used internally when creating index resources.
-     */
-    [symbolIndexResource]?: boolean;
-    tags?: TTags;
-}
-export interface IResource<TConfig = void, TValue extends Promise<any> = Promise<any>, TDependencies extends DependencyMapType = any, TContext = any, TMeta extends IResourceMeta = any, TTags extends TagType[] = TagType[], TMiddleware extends ResourceMiddlewareAttachmentType[] = ResourceMiddlewareAttachmentType[]> extends IResourceDefinition<TConfig, TValue, TDependencies, TContext, any, any, TMeta, TTags, TMiddleware> {
-    id: string;
-    with(config: TConfig): IResourceWithConfig<TConfig, TValue, TDependencies, TContext, TMeta, TTags, TMiddleware>;
-    register: Array<RegisterableItems> | ((config: TConfig) => Array<RegisterableItems>);
-    overrides: Array<OverridableElements>;
-    middleware: TMiddleware;
-    [symbolFilePath]: string;
-    [symbolIndexResource]: boolean;
-    [symbolResource]: true;
-    /** Return an optional dependency wrapper for this resource. */
-    optional: () => IOptionalDependency<IResource<TConfig, TValue, TDependencies, TContext, TMeta, TTags, TMiddleware>>;
-    tags: TTags;
-}
-export interface IResourceWithConfig<TConfig = any, TValue extends Promise<any> = Promise<any>, TDependencies extends DependencyMapType = any, TContext = any, TMeta extends IResourceMeta = any, TTags extends TagType[] = TagType[], TMiddleware extends IResourceMiddleware<any, any, any, any>[] = IResourceMiddleware[]> {
-    [symbolResourceWithConfig]: true;
-    /** The id of the underlying resource. */
-    id: string;
-    /** The underlying resource definition. */
-    resource: IResource<TConfig, TValue, TDependencies, TContext, TMeta, TTags, TMiddleware>;
-    /** The configuration captured by `.with(config)`. */
-    config: TConfig;
-}

package/dist/types/resource.js

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

package/dist/types/resource.js.map

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

package/dist/types/resourceMiddleware.d.ts

@@ -1,47 +0,0 @@
-import { DependencyMapType, DependencyValuesType, IValidationSchema, IResource } from "../defs";
-import { TagType } from "./tag";
-import { IMiddlewareMeta } from "./meta";
-import { symbolFilePath, symbolMiddlewareConfigured, symbolResourceMiddleware } from "./symbols";
-import { IContractable } from "./contracts";
-export interface IResourceMiddlewareDefinition<TConfig = any, TEnforceInputContract = void, TEnforceOutputContract = void, TDependencies extends DependencyMapType = any> {
-    id: string;
-    /** Static or lazy dependency map. */
-    dependencies?: TDependencies | ((config: TConfig) => TDependencies);
-    /**
-     * Optional validation schema for runtime config validation.
-     * When provided, middleware config will be validated when .with() is called.
-     */
-    configSchema?: IValidationSchema<TConfig>;
-    /**
-     * The middleware body, called with resource execution input.
-     */
-    run: (input: IResourceMiddlewareExecutionInput<TEnforceInputContract extends void ? any : TEnforceInputContract, TEnforceOutputContract extends void ? any : TEnforceOutputContract>, dependencies: DependencyValuesType<TDependencies>, config: TConfig) => Promise<any>;
-    meta?: IMiddlewareMeta;
-    tags?: TagType[];
-    everywhere?: boolean | ((resource: IResource<any, any, any, any, any>) => boolean);
-}
-export interface IResourceMiddleware<TConfig = any, TEnforceInputContract = void, TEnforceOutputContract = void, TDependencies extends DependencyMapType = any> extends IResourceMiddlewareDefinition<TConfig, TEnforceInputContract, TEnforceOutputContract, TDependencies>, IContractable<TConfig, TEnforceInputContract, TEnforceOutputContract> {
-    [symbolResourceMiddleware]: true;
-    id: string;
-    dependencies: TDependencies | (() => TDependencies);
-    /** Current configuration object (empty by default). */
-    config: TConfig;
-    /** Configure the middleware and return a marked, configured instance. */
-    with: (config: TConfig) => IResourceMiddlewareConfigured<TConfig, TEnforceInputContract, TEnforceOutputContract, TDependencies>;
-    [symbolFilePath]: string;
-    tags: TagType[];
-}
-export interface IResourceMiddlewareConfigured<TConfig = any, TEnforceInputContract = void, TEnforceOutputContract = void, TDependencies extends DependencyMapType = any> extends IResourceMiddleware<TConfig, TEnforceInputContract, TEnforceOutputContract, TDependencies> {
-    [symbolMiddlewareConfigured]: true;
-}
-export interface IResourceMiddlewareExecutionInput<TResourceConfig = any, TResourceOutput = any> {
-    /** Resource hook */
-    resource: {
-        definition: IResource<TResourceConfig, any, any, any, any>;
-        config: TResourceConfig;
-    };
-    next: (resourceConfig?: TResourceConfig) => Promise<TResourceOutput>;
-}
-export type ResourceMiddlewareAttachmentType = IResourceMiddleware<void, any, any, any> | IResourceMiddleware<{
-    [K in any]?: any;
-}, any, any, any> | IResourceMiddlewareConfigured<any, any, any, any>;

package/dist/types/resourceMiddleware.js

@@ -1,4 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const symbols_1 = require("./symbols");
-//# sourceMappingURL=resourceMiddleware.js.map

package/dist/types/resourceMiddleware.js.map

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