@bluelibs/runner 3.2.0 → 3.3.1

package/dist/define.d.ts

@@ -1,4 +1,11 @@
-import { ITask, ITaskDefinition, IResource, IResourceWithConfig, IResourceDefinition, IEventDefinition, IMiddlewareDefinition, DependencyMapType, DependencyValuesType, IMiddleware, IEvent, RegisterableItems } from "./defs";
+/**
+ * Factory functions for defining tasks, resources, events and middleware.
+ *
+ * These helpers create strongly-typed definitions while also wiring internal
+ * metadata: anonymous IDs, file path tags (for better debugging), lifecycle
+ * events, and global middleware flags. See README for high-level concepts.
+ */
+import { ITask, ITaskDefinition, IResource, IResourceWithConfig, IResourceDefinition, IEventDefinition, IMiddlewareDefinition, DependencyMapType, DependencyValuesType, IMiddleware, IEvent, RegisterableItems, ITag, ITagDefinition } from "./defs";
 export declare function defineTask<Input = undefined, Output extends Promise<any> = any, Deps extends DependencyMapType = any, TOn extends "*" | IEventDefinition | undefined = undefined>(taskConfig: ITaskDefinition<Input, Output, Deps, TOn>): ITask<Input, Output, Deps, TOn>;
 export declare function defineResource<TConfig = void, TValue = any, TDeps extends DependencyMapType = {}, TPrivate = any>(constConfig: IResourceDefinition<TConfig, TValue, TDeps, TPrivate>): IResource<TConfig, TValue, TDeps, TPrivate>;
 /**
@@ -27,3 +34,16 @@ export declare function isResource(definition: any): definition is IResource;
 export declare function isResourceWithConfig(definition: any): definition is IResourceWithConfig;
 export declare function isEvent(definition: any): definition is IEvent;
 export declare function isMiddleware(definition: any): definition is IMiddleware;
+/**
+ * Override helper that preserves the original `id` and returns the same type.
+ * You can override any property except `id`.
+ */
+export declare function defineOverride<T extends ITask<any, any, any, any>>(base: T, patch: Omit<Partial<T>, "id">): T;
+export declare function defineOverride<T extends IResource<any, any, any, any>>(base: T, patch: Omit<Partial<T>, "id">): T;
+export declare function defineOverride<T extends IMiddleware<any, any>>(base: T, patch: Omit<Partial<T>, "id">): T;
+/**
+ * Creates a tag definition.
+ * - `.with(config)` to create configured instances
+ * - `.extract(tags)` to extract this tag from a list of tags
+ */
+export declare function defineTag<TConfig = void>(definition: ITagDefinition<TConfig>): ITag<TConfig>;

package/dist/define.js

@@ -10,17 +10,32 @@ exports.isResource = isResource;
 exports.isResourceWithConfig = isResourceWithConfig;
 exports.isEvent = isEvent;
 exports.isMiddleware = isMiddleware;
+exports.defineOverride = defineOverride;
+exports.defineTag = defineTag;
+/**
+ * Factory functions for defining tasks, resources, events and middleware.
+ *
+ * These helpers create strongly-typed definitions while also wiring internal
+ * metadata: anonymous IDs, file path tags (for better debugging), lifecycle
+ * events, and global middleware flags. See README for high-level concepts.
+ */
 const defs_1 = require("./defs");
 const errors_1 = require("./errors");
 const getCallerFile_1 = require("./tools/getCallerFile");
 // Helper function to get the caller file
 function defineTask(taskConfig) {
+    /**
+     * Creates a task definition.
+     * - Generates an anonymous id based on file path when `id` is omitted
+     * - Wires lifecycle events: beforeRun, afterRun, onError
+     * - Carries through dependencies and middleware as declared
+     */
     const filePath = (0, getCallerFile_1.getCallerFile)();
     const isAnonymous = !Boolean(taskConfig.id);
     const id = taskConfig.id || (0, getCallerFile_1.generateCallerIdFromFile)(filePath, "task");
     return {
-        [defs_1.symbols.task]: true,
-        [defs_1.symbols.filePath]: filePath,
+        [defs_1.symbolTask]: true,
+        [defs_1.symbolFilePath]: filePath,
         id,
         dependencies: taskConfig.dependencies || {},
         middleware: taskConfig.middleware || [],
@@ -34,7 +49,7 @@ function defineTask(taskConfig) {
                         ? Symbol(`anonymous-task.events.beforeRun`)
                         : `${id}.events.beforeRun`,
                 }),
-                [defs_1.symbols.filePath]: (0, getCallerFile_1.getCallerFile)(),
+                [defs_1.symbolFilePath]: (0, getCallerFile_1.getCallerFile)(),
             },
             afterRun: {
                 ...defineEvent({
@@ -42,7 +57,7 @@ function defineTask(taskConfig) {
                         ? Symbol(`anonymous-task.events.afterRun`)
                         : `${id}.events.afterRun`,
                 }),
-                [defs_1.symbols.filePath]: (0, getCallerFile_1.getCallerFile)(),
+                [defs_1.symbolFilePath]: (0, getCallerFile_1.getCallerFile)(),
             },
             onError: {
                 ...defineEvent({
@@ -50,7 +65,7 @@ function defineTask(taskConfig) {
                         ? Symbol(`anonymous-task.events.onError`)
                         : `${id}.events.onError`,
                 }),
-                [defs_1.symbols.filePath]: (0, getCallerFile_1.getCallerFile)(),
+                [defs_1.symbolFilePath]: (0, getCallerFile_1.getCallerFile)(),
             },
         },
         meta: taskConfig.meta || {},
@@ -58,6 +73,12 @@ function defineTask(taskConfig) {
     };
 }
 function defineResource(constConfig) {
+    /**
+     * Creates a resource definition.
+     * - Generates anonymous id when omitted (resource or index flavor)
+     * - Wires lifecycle events: beforeInit, afterInit, onError
+     * - Exposes `.with(config)` for config‑bound registration
+     */
     // The symbolFilePath might already come from defineIndex() for example
     const filePath = constConfig[defs_1.symbolFilePath] || (0, getCallerFile_1.getCallerFile)();
     const isIndexResource = constConfig[defs_1.symbolIndexResource] || false;
@@ -65,8 +86,9 @@ function defineResource(constConfig) {
     const id = constConfig.id ||
         (0, getCallerFile_1.generateCallerIdFromFile)(filePath, isIndexResource ? "index" : "resource");
     return {
-        [defs_1.symbols.resource]: true,
-        [defs_1.symbols.filePath]: filePath,
+        [defs_1.symbolResource]: true,
+        [defs_1.symbolFilePath]: filePath,
+        [defs_1.symbolIndexResource]: isIndexResource,
         id,
         dependencies: constConfig.dependencies,
         dispose: constConfig.dispose,
@@ -76,7 +98,7 @@ function defineResource(constConfig) {
         context: constConfig.context,
         with: function (config) {
             return {
-                [defs_1.symbols.resourceWithConfig]: true,
+                [defs_1.symbolResourceWithConfig]: true,
                 id: this.id,
                 resource: this,
                 config,
@@ -89,7 +111,7 @@ function defineResource(constConfig) {
                         ? Symbol(`anonymous-resource.events.beforeInit`)
                         : `${id}.events.beforeInit`,
                 }),
-                [defs_1.symbols.filePath]: filePath,
+                [defs_1.symbolFilePath]: filePath,
             },
             afterInit: {
                 ...defineEvent({
@@ -97,7 +119,7 @@ function defineResource(constConfig) {
                         ? Symbol(`anonymous-resource.events.afterInit`)
                         : `${id}.events.afterInit`,
                 }),
-                [defs_1.symbols.filePath]: filePath,
+                [defs_1.symbolFilePath]: filePath,
             },
             onError: {
                 ...defineEvent({
@@ -105,7 +127,7 @@ function defineResource(constConfig) {
                         ? Symbol(`anonymous-resource.events.onError`)
                         : `${id}.events.onError`,
                 }),
-                [defs_1.symbols.filePath]: filePath,
+                [defs_1.symbolFilePath]: filePath,
             },
         },
         meta: constConfig.meta || {},
@@ -119,6 +141,7 @@ function defineResource(constConfig) {
  * access them naturally: `deps.services.myTask()` or `deps.services.myResource`.
  */
 function defineIndex(items) {
+    // Build dependency map from given items; unwrap `.with()` to the base resource
     const dependencies = {};
     const register = [];
     for (const key of Object.keys(items)) {
@@ -138,25 +161,35 @@ function defineIndex(items) {
         async init(_, deps) {
             return deps;
         },
-        [defs_1.symbols.filePath]: callerFilePath,
-        [defs_1.symbols.indexResource]: true,
+        [defs_1.symbolFilePath]: callerFilePath,
+        [defs_1.symbolIndexResource]: true,
     });
 }
 function defineEvent(config) {
+    /**
+     * Creates an event definition. Anonymous ids are generated from file path
+     * when omitted. The returned object is branded for runtime checks.
+     */
     const callerFilePath = (0, getCallerFile_1.getCallerFile)();
     const eventConfig = config || {};
     return {
         ...eventConfig,
         id: eventConfig.id || (0, getCallerFile_1.generateCallerIdFromFile)(callerFilePath, "event"),
-        [defs_1.symbols.filePath]: callerFilePath,
+        [defs_1.symbolFilePath]: callerFilePath,
         [defs_1.symbolEvent]: true, // This is a workaround
     };
 }
 function defineMiddleware(middlewareDef) {
+    /**
+     * Creates a middleware definition with:
+     * - Anonymous id generation when omitted
+     * - `.with(config)` to create configured instances
+     * - `.everywhere()` to mark as global (optionally scoping to tasks/resources)
+     */
     const filePath = (0, getCallerFile_1.getCallerFile)();
     const object = {
-        [defs_1.symbols.filePath]: filePath,
-        [defs_1.symbols.middleware]: true,
+        [defs_1.symbolFilePath]: filePath,
+        [defs_1.symbolMiddleware]: true,
         config: {},
         id: middlewareDef.id || (0, getCallerFile_1.generateCallerIdFromFile)(filePath, "middleware"),
         ...middlewareDef,
@@ -178,8 +211,8 @@ function defineMiddleware(middlewareDef) {
             const { tasks = true, resources = true } = options;
             return {
                 ...object,
-                [defs_1.symbols.middlewareEverywhereTasks]: tasks,
-                [defs_1.symbols.middlewareEverywhereResources]: resources,
+                [defs_1.symbolMiddlewareEverywhereTasks]: tasks,
+                [defs_1.symbolMiddlewareEverywhereResources]: resources,
                 everywhere() {
                     throw errors_1.Errors.middlewareAlreadyGlobal(object.id);
                 },
@@ -188,18 +221,57 @@ function defineMiddleware(middlewareDef) {
     };
 }
 function isTask(definition) {
-    return definition && definition[defs_1.symbols.task];
+    return definition && definition[defs_1.symbolTask];
 }
 function isResource(definition) {
-    return definition && definition[defs_1.symbols.resource];
+    return definition && definition[defs_1.symbolResource];
 }
 function isResourceWithConfig(definition) {
-    return definition && definition[defs_1.symbols.resourceWithConfig];
+    return definition && definition[defs_1.symbolResourceWithConfig];
 }
 function isEvent(definition) {
-    return definition && definition[defs_1.symbols.event];
+    return definition && definition[defs_1.symbolEvent];
 }
 function isMiddleware(definition) {
-    return definition && definition[defs_1.symbols.middleware];
+    return definition && definition[defs_1.symbolMiddleware];
+}
+function defineOverride(base, patch) {
+    const { id: _ignored, ...rest } = (patch || {});
+    // Ensure we never change the id, and merge overrides last
+    return {
+        ...base,
+        ...rest,
+        id: base.id,
+    };
+}
+/**
+ * Creates a tag definition.
+ * - `.with(config)` to create configured instances
+ * - `.extract(tags)` to extract this tag from a list of tags
+ */
+function defineTag(definition) {
+    const id = definition.id;
+    return {
+        id,
+        with(tagConfig) {
+            return {
+                id,
+                tag: this,
+                config: tagConfig,
+            };
+        },
+        extract(target) {
+            const tags = Array.isArray(target) ? target : target?.meta?.tags || [];
+            for (const candidate of tags) {
+                if (typeof candidate === "string")
+                    continue;
+                // Configured instance
+                if (candidate.id === id) {
+                    return candidate;
+                }
+            }
+            return null;
+        },
+    };
 }
 //# sourceMappingURL=define.js.map

package/dist/define.js.map

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

package/dist/defs/core.d.ts

@@ -0,0 +1,144 @@
+import { IEventMeta, IMiddlewareMeta, IResourceMeta, ITaskMeta } from "./tags";
+import { symbolEvent, symbolMiddleware, symbolMiddlewareConfigured, symbolMiddlewareEverywhereResources, symbolMiddlewareEverywhereTasks } from "./symbols";
+export interface ITask<TInput = any, TOutput extends Promise<any> = any, TDependencies extends DependencyMapType = {}, TOn extends "*" | IEventDefinition<any> | undefined = undefined> extends ITaskDefinition<TInput, TOutput, TDependencies, TOn> {
+    id: string | symbol;
+    dependencies: TDependencies | (() => TDependencies);
+    computedDependencies?: DependencyValuesType<TDependencies>;
+    middleware: MiddlewareAttachments[];
+    events: {
+        beforeRun: IEvent<BeforeRunEventPayload<TInput>>;
+        afterRun: IEvent<AfterRunEventPayload<TInput, TOutput>>;
+        onError: IEvent<OnErrorEventPayload>;
+    };
+}
+export type DependencyMapType = Record<string, ITask<any, any, any, any> | IResource<any, any, any> | IEventDefinition<any>>;
+type ExtractTaskInput<T> = T extends ITask<infer I, any, any, any> ? I : never;
+type ExtractTaskOutput<T> = T extends ITask<any, infer O, any, any> ? O : never;
+type ExtractResourceValue<T> = T extends IResource<any, infer V, any> ? V : never;
+type ExtractEventParams<T> = T extends IEvent<infer P> ? P : never;
+type TaskDependency<I, O> = (...args: I extends null | void ? [] : [I]) => O;
+type ResourceDependency<V> = V;
+type EventDependency<P> = P extends void ? (() => Promise<void>) & ((input?: Record<string, never>) => Promise<void>) : (input: P) => Promise<void>;
+export type DependencyValueType<T> = T extends ITask<any, any, any, any> ? TaskDependency<ExtractTaskInput<T>, ExtractTaskOutput<T>> : T extends IResource<any, any, any> ? ResourceDependency<ExtractResourceValue<T>> : T extends IEventDefinition<any> ? EventDependency<ExtractEventParams<T>> : never;
+export type DependencyValuesType<T extends DependencyMapType> = {
+    [K in keyof T]: DependencyValueType<T[K]>;
+};
+export type RegisterableItems<T = any> = IResourceWithConfig<any> | IResource<void, any, any, any> | IResource<{
+    [K in any]?: any;
+}, any, any, any> | ITask<any, any, any, any> | IMiddleware<any> | IEvent<any>;
+export type MiddlewareAttachments = IMiddleware<void> | IMiddleware<{
+    [K in any]?: any;
+}> | IMiddlewareConfigured<any>;
+export interface ITaskDefinition<TInput = any, TOutput extends Promise<any> = any, TDependencies extends DependencyMapType = {}, TOn extends "*" | IEventDefinition<any> | undefined = undefined> {
+    id?: string | symbol;
+    dependencies?: TDependencies | (() => TDependencies);
+    middleware?: MiddlewareAttachments[];
+    on?: TOn;
+    listenerOrder?: number;
+    meta?: ITaskMeta;
+    run: (input: TOn extends undefined ? TInput : IEventEmission<TOn extends "*" ? any : ExtractEventParams<TOn>>, dependencies: DependencyValuesType<TDependencies>) => TOutput;
+}
+export type BeforeRunEventPayload<TInput> = {
+    input: TInput;
+};
+export type AfterRunEventPayload<TInput, TOutput> = {
+    input: TInput;
+    output: TOutput extends Promise<infer U> ? U : TOutput;
+    setOutput(newOutput: TOutput extends Promise<infer U> ? U : TOutput): void;
+};
+export type OnErrorEventPayload = {
+    error: any;
+    suppress(): void;
+};
+export type BeforeInitEventPayload<TConfig> = {
+    config: TConfig;
+};
+export type AfterInitEventPayload<TConfig, TValue> = {
+    config: TConfig;
+    value: TValue;
+};
+export interface IResourceDefinition<TConfig = any, TValue = unknown, TDependencies extends DependencyMapType = {}, TContext = any> {
+    id?: string | symbol;
+    dependencies?: TDependencies | ((config: TConfig) => TDependencies);
+    register?: Array<RegisterableItems> | ((config: TConfig) => Array<RegisterableItems>);
+    init?: (this: any, config: TConfig, dependencies: DependencyValuesType<TDependencies>, context: TContext) => Promise<TValue>;
+    dispose?: (this: any, value: TValue, config: TConfig, dependencies: DependencyValuesType<TDependencies>, context: TContext) => Promise<void>;
+    meta?: IResourceMeta;
+    overrides?: Array<IResource | ITask | IMiddleware | IResourceWithConfig>;
+    middleware?: MiddlewareAttachments[];
+    context?: () => TContext;
+    [symbolFilePath]?: string;
+    [symbolIndexResource]?: boolean;
+}
+import { symbolFilePath, symbolIndexResource } from "./symbols";
+export interface IResource<TConfig = void, TValue = any, TDependencies extends DependencyMapType = any, TContext = any> extends IResourceDefinition<TConfig, TValue, TDependencies, TContext> {
+    id: string | symbol;
+    with(config: TConfig): IResourceWithConfig<TConfig, TValue, TDependencies>;
+    register: Array<RegisterableItems> | ((config: TConfig) => Array<RegisterableItems>);
+    events: {
+        beforeInit: IEvent<BeforeInitEventPayload<TConfig>>;
+        afterInit: IEvent<AfterInitEventPayload<TConfig, TValue>>;
+        onError: IEvent<OnErrorEventPayload>;
+    };
+    overrides: Array<IResource | ITask | IMiddleware | IResourceWithConfig>;
+    middleware: MiddlewareAttachments[];
+}
+export interface IResourceWithConfig<TConfig = any, TValue = any, TDependencies extends DependencyMapType = any> {
+    id: string;
+    resource: IResource<TConfig, TValue, TDependencies>;
+    config: TConfig;
+}
+export type EventHandlerType<T = any> = (event: IEventEmission<T>) => any | Promise<any>;
+export interface IEventDefinition<TPayload = void> {
+    id?: string | symbol;
+    meta?: IEventMeta;
+}
+export interface IEvent<TPayload = any> extends IEventDefinition<TPayload> {
+    id: string | symbol;
+    [symbolEvent]: true;
+}
+export interface IMiddlewareDefinition<TConfig = any, TDependencies extends DependencyMapType = any> {
+    id?: string | symbol;
+    dependencies?: TDependencies | ((config: TConfig) => TDependencies);
+    run: (input: IMiddlewareExecutionInput, dependencies: DependencyValuesType<TDependencies>, config: TConfig) => Promise<any>;
+    meta?: IMiddlewareMeta;
+}
+export interface IMiddleware<TConfig = any, TDependencies extends DependencyMapType = any> extends IMiddlewareDefinition<TConfig, TDependencies> {
+    [symbolMiddleware]: true;
+    [symbolMiddlewareConfigured]?: boolean;
+    [symbolMiddlewareEverywhereTasks]?: boolean;
+    [symbolMiddlewareEverywhereResources]?: boolean;
+    id: string | symbol;
+    dependencies: TDependencies | (() => TDependencies);
+    everywhere(config?: import("../define").MiddlewareEverywhereOptions): IMiddleware<TConfig, TDependencies>;
+    config: TConfig;
+    with: (config: TConfig) => IMiddlewareConfigured<TConfig, TDependencies>;
+}
+export interface IMiddlewareConfigured<TConfig = any, TDependencies extends DependencyMapType = any> extends IMiddleware<TConfig, TDependencies> {
+    [symbolMiddlewareConfigured]: true;
+}
+export interface IMiddlewareDefinitionConfigured<C extends Record<string, any> = {}> {
+    middleware: IMiddleware<C>;
+    config?: C;
+}
+export interface IMiddlewareExecutionInput<TTaskInput = any, TResourceConfig = any> {
+    task?: {
+        definition: ITask<TTaskInput>;
+        input: TTaskInput;
+    };
+    resource?: {
+        definition: IResource<TResourceConfig>;
+        config: TResourceConfig;
+    };
+    next: (taskInputOrResourceConfig?: TTaskInput | TResourceConfig) => Promise<any>;
+}
+export interface IEventEmission<TPayload = any> {
+    id: string | symbol;
+    data: TPayload;
+    timestamp: Date;
+    source: string | symbol;
+    meta: IEventMeta;
+    stopPropagation(): void;
+    isPropagationStopped(): boolean;
+}
+export {};

package/dist/defs/core.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const symbols_1 = require("./symbols");
+// symbol imports referenced above
+const symbols_2 = require("./symbols");
+//# sourceMappingURL=core.js.map

package/dist/defs/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../src/defs/core.ts"],"names":[],"mappings":";;AACA,uCASmB;AAyInB,kCAAkC;AAClC,uCAAgE"}

package/dist/defs/symbols.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Internal brand symbols used to tag created objects at runtime and help with
+ * type‑narrowing. Prefer the `isTask`/`isResource`/`isEvent`/`isMiddleware`
+ * helpers instead of touching these directly.
+ * @internal
+ */
+export declare const symbolTask: unique symbol;
+export declare const symbolResource: unique symbol;
+export declare const symbolResourceWithConfig: unique symbol;
+export declare const symbolEvent: unique symbol;
+export declare const symbolMiddleware: unique symbol;
+export declare const symbolMiddlewareConfigured: unique symbol;
+export declare const symbolMiddlewareGlobal: unique symbol;
+export declare const symbolMiddlewareEverywhereTasks: unique symbol;
+export declare const symbolMiddlewareEverywhereResources: unique symbol;
+/** @internal Path to aid anonymous id generation and error messages */
+export declare const symbolFilePath: unique symbol;
+/** @internal Marks disposable instances */
+export declare const symbolDispose: unique symbol;
+/** @internal Link to internal Store */
+export declare const symbolStore: unique symbol;
+/** @internal Brand used by index() resources */
+export declare const symbolIndexResource: unique symbol;
+/**
+ * Convenience bag of internal symbols. Intended for framework internals;
+ * consumers should not rely on this shape.
+ * @internal
+ */
+export declare const symbols: {
+    task: symbol;
+    resource: symbol;
+    resourceWithConfig: symbol;
+    indexResource: symbol;
+    event: symbol;
+    middleware: symbol;
+    middlewareEverywhereTasks: symbol;
+    middlewareEverywhereResources: symbol;
+    filePath: symbol;
+    dispose: symbol;
+    store: symbol;
+};
+export type SymbolsBag = typeof symbols;

package/dist/defs/symbols.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.symbols = exports.symbolIndexResource = exports.symbolStore = exports.symbolDispose = exports.symbolFilePath = exports.symbolMiddlewareEverywhereResources = exports.symbolMiddlewareEverywhereTasks = exports.symbolMiddlewareGlobal = exports.symbolMiddlewareConfigured = exports.symbolMiddleware = exports.symbolEvent = exports.symbolResourceWithConfig = exports.symbolResource = exports.symbolTask = void 0;
+/**
+ * Internal brand symbols used to tag created objects at runtime and help with
+ * type‑narrowing. Prefer the `isTask`/`isResource`/`isEvent`/`isMiddleware`
+ * helpers instead of touching these directly.
+ * @internal
+ */
+exports.symbolTask = Symbol("runner.task");
+exports.symbolResource = Symbol("runner.resource");
+exports.symbolResourceWithConfig = Symbol("runner.resourceWithConfig");
+exports.symbolEvent = Symbol("runner.event");
+exports.symbolMiddleware = Symbol("runner.middleware");
+exports.symbolMiddlewareConfigured = Symbol("runner.middlewareConfigured");
+exports.symbolMiddlewareGlobal = Symbol("runner.middlewareGlobal");
+exports.symbolMiddlewareEverywhereTasks = Symbol("runner.middlewareGlobalTasks");
+exports.symbolMiddlewareEverywhereResources = Symbol("runner.middlewareGlobalResources");
+/** @internal Path to aid anonymous id generation and error messages */
+exports.symbolFilePath = Symbol("runner.filePath");
+/** @internal Marks disposable instances */
+exports.symbolDispose = Symbol("runner.dispose");
+/** @internal Link to internal Store */
+exports.symbolStore = Symbol("runner.store");
+/** @internal Brand used by index() resources */
+exports.symbolIndexResource = Symbol("runner.indexResource");
+/**
+ * Convenience bag of internal symbols. Intended for framework internals;
+ * consumers should not rely on this shape.
+ * @internal
+ */
+exports.symbols = {
+    task: exports.symbolTask,
+    resource: exports.symbolResource,
+    resourceWithConfig: exports.symbolResourceWithConfig,
+    indexResource: exports.symbolIndexResource,
+    event: exports.symbolEvent,
+    middleware: exports.symbolMiddleware,
+    middlewareEverywhereTasks: exports.symbolMiddlewareEverywhereTasks,
+    middlewareEverywhereResources: exports.symbolMiddlewareEverywhereResources,
+    filePath: exports.symbolFilePath,
+    dispose: exports.symbolDispose,
+    store: exports.symbolStore,
+};
+//# sourceMappingURL=symbols.js.map

package/dist/defs/symbols.js.map

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

package/dist/defs/tags.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Tag system and metadata types.
+ */
+export interface ITagDefinition<TConfig = void> {
+    id: string | symbol;
+}
+/**
+ * A configured instance of a tag as produced by `ITag.with()`.
+ */
+export interface ITagWithConfig<TConfig = void> {
+    id: string | symbol;
+    /** The tag definition used to produce this configured instance. */
+    tag: ITag<TConfig>;
+    /** The configuration captured for this tag instance. */
+    config: TConfig;
+}
+/**
+ * A tag definition (builder). Use `.with(config)` to obtain configured instances,
+ * and `.extract(tags)` to find either a configured instance or the bare tag in a list.
+ */
+export interface ITag<TConfig = void> extends ITagDefinition<TConfig> {
+    /** Creates a configured instance of the tag. */
+    with(config: TConfig): ITagWithConfig<TConfig>;
+    /**
+     * Extracts either a configured instance or the bare tag from a list of tags
+     * or from a taggable object (`{ meta: { tags?: [] } }`).
+     */
+    extract(target: TagType[] | ITaggable): ExtractedTagResult<TConfig> | null;
+}
+/**
+ * Restrict bare tags to those whose config can be omitted (void or optional object),
+ * mirroring the same principle used for resources in `RegisterableItems`.
+ * Required-config tags must appear as configured instances.
+ */
+export type TagType = string | ITag<void> | ITag<{
+    [K in any]?: any;
+}> | ITagWithConfig<any>;
+/**
+ * Conditional result type for `ITag.extract`:
+ * - For void config → just the identifier
+ * - For optional object config → identifier with optional config
+ * - For required config → identifier with required config
+ */
+export type ExtractedTagResult<TConfig> = {} extends TConfig ? {
+    id: string | symbol;
+    config?: TConfig;
+} : {
+    id: string | symbol;
+    config: TConfig;
+};
+/** Any object that can carry tags via metadata. */
+export interface ITaggable {
+    meta?: {
+        tags?: TagType[];
+    };
+}
+/** Common metadata you can attach to tasks/resources/events/middleware. */
+export interface IMeta {
+    title?: string;
+    description?: string;
+    tags?: TagType[];
+}
+export interface ITaskMeta extends IMeta {
+}
+export interface IResourceMeta extends IMeta {
+}
+export interface IEventMeta extends IMeta {
+}
+export interface IMiddlewareMeta extends IMeta {
+}

package/dist/defs/tags.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Tag system and metadata types.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=tags.js.map

package/dist/defs/tags.js.map

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