@bluelibs/runner 3.4.2 → 4.0.1

package/dist/testing.d.ts

@@ -1,12 +1,13 @@
-import { IResource, IResourceWithConfig, IMiddleware, ITask, RegisterableItems, DependencyMapType } from "./defs";
+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 | IMiddleware | IResourceWithConfig>;
+    overrides?: Array<IResource | ITask | ITaskMiddleware | IResourceMiddleware | IResourceWithConfig>;
 }): IResource<void, Promise<ReturnType<typeof buildTestFacade>>>;
 declare function buildTestFacade(deps: {
     taskRunner: TaskRunner;
@@ -14,8 +15,8 @@ declare function buildTestFacade(deps: {
     logger: Logger;
     eventManager: EventManager;
 }): {
-    runTask: <I, O extends Promise<any>, D extends DependencyMapType>(task: ITask<I, O, D>, input: I) => Promise<Awaited<O> | undefined>;
-    getResource: (id: string | symbol) => any;
+    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;

package/dist/testing.js

@@ -8,10 +8,11 @@ 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: `tests.createTestResource.${++testResourceCounter}`,
+        id: `testing.${root.id}.${++testResourceCounter}`,
         register: [root],
         overrides: options?.overrides || [],
         dependencies: {
@@ -28,7 +29,7 @@ function createTestResource(root, options) {
 function buildTestFacade(deps) {
     return {
         // Run a task within the fully initialized ecosystem
-        runTask: (task, input) => deps.taskRunner.run(task, input),
+        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)

package/dist/testing.js.map

@@ -1 +1 @@
-{"version":3,"file":"testing.js","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":";;AAsBA,gDAoBC;AA1CD,qCAA0C;AAC1C,+DAA4D;AAc5D,IAAI,mBAAmB,GAAG,CAAC,CAAC;AAE5B;;;;GAIG;AACH,SAAgB,kBAAkB,CAChC,IAAuB,EACvB,OAEC;IAED,OAAO,IAAA,uBAAc,EAAC;QACpB,EAAE,EAAE,4BAA4B,EAAE,mBAAmB,EAAE;QACvD,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;AAED,SAAS,eAAe,CAAC,IAKxB;IACC,OAAO;QACL,oDAAoD;QACpD,OAAO,EAAE,CACP,IAAoB,EACpB,KAAQ,EACyB,EAAE,CACnC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAQ;QACzC,mDAAmD;QACnD,WAAW,EAAE,CAAC,EAAmB,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,KAAK;QACzE,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"}
+{"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,9 +1 @@
 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,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getCallerFile = getCallerFile;
-exports.generateCallerIdFromFile = generateCallerIdFromFile;
 function getCallerFile() {
     const originalFunc = Error.prepareStackTrace;
     try {
@@ -28,54 +27,4 @@ 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) {
-    // Normalize paths for consistency across platforms
-    const normalizedPath = filePath.replace(/\\/g, "/");
-    const cwdNormalized = process.cwd().replace(/\\/g, "/");
-    const parts = normalizedPath.split("/");
-    const nodeModulesIndex = parts.lastIndexOf("node_modules");
-    let relevantParts;
-    if (nodeModulesIndex !== -1) {
-        // If inside node_modules, generate id relative to the package path
-        relevantParts = parts.slice(nodeModulesIndex + 1);
-    }
-    else if (normalizedPath === cwdNormalized ||
-        normalizedPath.startsWith(cwdNormalized + "/")) {
-        // Prefer generating id relative to the workspace root (process.cwd())
-        const relativeToCwd = normalizedPath
-            .slice(cwdNormalized.length)
-            .replace(/^\//, "");
-        relevantParts = relativeToCwd.length > 0 ? relativeToCwd.split("/") : [""];
-    }
-    else {
-        // Fallback: use the last N parts if path is outside cwd and not in node_modules
-        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":"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"}
+{"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,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

@@ -0,0 +1,55 @@
+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

@@ -0,0 +1,4 @@
+"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

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

package/dist/types/event.d.ts

@@ -1,17 +1,32 @@
-import { symbolEvent } from './symbols';
-import type { IEventMeta } from './metadata';
+import { IOptionalDependency, IValidationSchema } from "../defs";
+import { TagType } from "./tag";
+import { IEventMeta } from "./meta";
+import { symbolEvent, symbolFilePath } from "./utilities";
 export type EventHandlerType<T = any> = (event: IEventEmission<T>) => any | Promise<any>;
 export interface IEventDefinition<TPayload = void> {
-    /** Stable identifier. Omit to get an anonymous id. */
-    id?: string | symbol;
+    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 | symbol;
+    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
@@ -21,7 +36,7 @@ export interface IEventEmission<TPayload = any> {
      * The ID of the event. This is the same as the event's ID.
      * This is useful for global event listeners.
      */
-    id: string | symbol;
+    id: string;
     /**
      * The data that the event carries. It can be anything.
      */
@@ -33,7 +48,7 @@ export interface IEventEmission<TPayload = any> {
     /**
      * The source of the event. This can be useful for debugging.
      */
-    source: string | symbol;
+    source: string;
     /**
      * Metadata associated with the event definition.
      */
@@ -46,4 +61,8 @@ export interface IEventEmission<TPayload = any> {
      * Returns true if propagation has been stopped.
      */
     isPropagationStopped(): boolean;
+    /**
+     * The tags that the event carries.
+     */
+    tags: TagType[];
 }

package/dist/types/event.js

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

package/dist/types/event.js.map

@@ -1 +1 @@
-{"version":3,"file":"event.js","sourceRoot":"","sources":["../../src/types/event.ts"],"names":[],"mappings":";;AAAA,uCAAwC"}
+{"version":3,"file":"event.js","sourceRoot":"","sources":["../../src/types/event.ts"],"names":[],"mappings":";;AAGA,2CAA0D"}

package/dist/types/hook.d.ts

@@ -0,0 +1,21 @@
+import { DependencyMapType, DependencyValuesType, IEventDefinition, IEventEmission, ExtractEventParams } from "../defs";
+import { TagType } from "./tag";
+import { ITaskMeta } from "./meta";
+import { symbolFilePath, symbolHook } from "./utilities";
+export interface IHookDefinition<TDependencies extends DependencyMapType = {}, TOn extends "*" | IEventDefinition<any> = 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 : ExtractEventParams<TOn>>, dependencies: DependencyValuesType<TDependencies>) => Promise<any>;
+    tags?: TagType[];
+}
+export interface IHook<TDependencies extends DependencyMapType = {}, TOn extends "*" | IEventDefinition<any> = any, TMeta extends ITaskMeta = any> extends IHookDefinition<TDependencies, TOn, TMeta> {
+    id: string;
+    dependencies: TDependencies | (() => TDependencies);
+    [symbolFilePath]: string;
+    [symbolHook]: true;
+    tags: TagType[];
+}

package/dist/{models/StoreTypes.js → types/hook.js}

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

package/dist/types/hook.js.map

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

package/dist/types/meta.d.ts

@@ -1,7 +1,10 @@
+/**
+ * Common metadata you can attach to tasks/resources/events/middleware.
+ * Useful for docs, filtering and middleware decisions.
+ */
 export interface IMeta {
     title?: string;
     description?: string;
-    tags?: string[];
 }
 export interface ITaskMeta extends IMeta {
 }
@@ -11,3 +14,5 @@ export interface IEventMeta extends IMeta {
 }
 export interface IMiddlewareMeta extends IMeta {
 }
+export interface ITagMeta extends IMeta {
+}

package/dist/types/meta.js

@@ -1,5 +1,7 @@
 "use strict";
-// Layer 1: Foundation - Meta Interfaces
-// No dependencies
+/**
+ * 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 +1 @@
-{"version":3,"file":"meta.js","sourceRoot":"","sources":["../../src/types/meta.ts"],"names":[],"mappings":";AAAA,wCAAwC;AACxC,kBAAkB"}
+{"version":3,"file":"meta.js","sourceRoot":"","sources":["../../src/types/meta.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/types/resource.d.ts

@@ -1,35 +1,11 @@
-import type { symbolFilePath, symbolIndexResource } from './symbols';
-import type { IResourceMeta } from './metadata';
-import type { DependencyMapType, DependencyValuesType } from './dependencies';
-import type { IEvent } from './event';
-import type { MiddlewareAttachments } from './middleware';
-export type BeforeInitEventPayload<TConfig> = {
-    config: TConfig;
-};
-export type AfterInitEventPayload<TConfig, TValue> = {
-    config: TConfig;
-    value: TValue;
-};
-export type OnErrorEventPayloadResource = {
-    error: any;
-    /**
-     * This function can be called to suppress the error from being thrown.
-     */
-    suppress(): void;
-};
-/**
- * Anything you can put inside a resource's `register: []`.
- * - Resources (with or without `.with()`)
- * - Tasks
- * - Middleware
- * - Events
- */
-export type RegisterableItems<T = any> = IResourceWithConfig<any> | IResource<void, any, any, any> | IResource<{
-    [K in any]?: any;
-}, any, any, any> | any | any | any;
-export interface IResourceDefinition<TConfig = any, TValue = unknown, TDependencies extends DependencyMapType = {}, TContext = any, THooks = any, TRegisterableItems = any> {
-    /** Stable identifier. Omit to get an anonymous id. */
-    id?: string | symbol;
+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);
     /**
@@ -40,7 +16,13 @@ export interface IResourceDefinition<TConfig = any, TValue = unknown, TDependenc
     /**
      * Initialize and return the resource value. Called once during boot.
      */
-    init?: (this: any, config: TConfig, dependencies: DependencyValuesType<TDependencies>, context: TContext) => Promise<TValue>;
+    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.
      *
@@ -49,48 +31,54 @@ export interface IResourceDefinition<TConfig = any, TValue = unknown, TDependenc
      * @param dependencies The dependencies it needed
      * @returns Promise<void>
      */
-    dispose?: (this: any, value: TValue, config: TConfig, dependencies: DependencyValuesType<TDependencies>, context: TContext) => Promise<void>;
-    meta?: IResourceMeta;
+    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<IResource | any | any | IResourceWithConfig>;
+    overrides?: Array<OverridableElements>;
     /** Middleware applied around init/dispose. */
-    middleware?: MiddlewareAttachments[];
+    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 = any, TDependencies extends DependencyMapType = any, TContext = any> extends IResourceDefinition<TConfig, TValue, TDependencies, TContext> {
-    id: string | symbol;
-    with(config: TConfig): IResourceWithConfig<TConfig, TValue, TDependencies>;
+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>);
-    /**
-     * These events are automatically populated after the task has been defined.
-     */
-    events: {
-        beforeInit: IEvent<BeforeInitEventPayload<TConfig>>;
-        afterInit: IEvent<AfterInitEventPayload<TConfig, TValue>>;
-        onError: IEvent<OnErrorEventPayloadResource>;
-    };
-    overrides: Array<IResource | any | any | IResourceWithConfig>;
-    middleware: MiddlewareAttachments[];
+    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 = any, TDependencies extends DependencyMapType = any> {
+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>;
+    resource: IResource<TConfig, TValue, TDependencies, TContext, TMeta, TTags, TMiddleware>;
     /** The configuration captured by `.with(config)`. */
     config: TConfig;
 }

package/dist/types/resource.js

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

package/dist/types/resource.js.map

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

package/dist/types/resourceMiddleware.d.ts

@@ -0,0 +1,47 @@
+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/{middleware.types.js → types/resourceMiddleware.js}

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

package/dist/types/resourceMiddleware.js.map

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

package/dist/types/runner.d.ts

@@ -0,0 +1,37 @@
+import { DebugFriendlyConfig } from "../globals/resources/debug";
+import { LogLevels, PrintStrategy } from "../models/Logger";
+import { OnUnhandledError } from "../models/UnhandledError";
+export type RunOptions = {
+    /**
+     * Defaults to undefined. If true, we introduce logging to the console.
+     */
+    debug?: DebugFriendlyConfig;
+    logs?: {
+        /**
+         * Defaults to info. Use null to disable logging.
+         */
+        printThreshold?: null | LogLevels;
+        /**
+         * Defaults to PRETTY. How to print the logs.
+         */
+        printStrategy?: PrintStrategy;
+        /**
+         * Defaults to false. If true, we buffer logs until the root resource is ready.
+         * This provides you with the chance to see the logs before the root resource is ready.
+         */
+        bufferLogs?: boolean;
+    };
+    /**
+     * When true (default), installs a central error boundary that catches uncaught errors
+     * from process-level events and routes them to `onUnhandledError`.
+     */
+    errorBoundary?: boolean;
+    /**
+     * When true (default), installs SIGINT/SIGTERM handlers that call dispose() on the root.
+     */
+    shutdownHooks?: boolean;
+    /**
+     * Custom handler for any unhandled error caught by Runner. Defaults to logging via the created logger.
+     */
+    onUnhandledError?: OnUnhandledError;
+};

package/dist/types/{base.js → runner.js}

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

package/dist/types/runner.js.map

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