@bluelibs/runner 3.4.2 → 4.0.1

package/dist/definers/defineHook.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineHook = defineHook;
+const defs_1 = require("../defs");
+const getCallerFile_1 = require("../tools/getCallerFile");
+/**
+ * Define a hook (event listeners).
+ * Same shape as task with mandatory `on` and without `middleware`.
+ */
+function defineHook(hookDef) {
+    const filePath = (0, getCallerFile_1.getCallerFile)();
+    return {
+        [defs_1.symbolHook]: true,
+        [defs_1.symbolFilePath]: filePath,
+        id: hookDef.id,
+        dependencies: hookDef.dependencies || {},
+        on: hookDef.on,
+        order: hookDef.order,
+        run: hookDef.run,
+        meta: hookDef.meta || {},
+        tags: hookDef.tags || [],
+    };
+}
+//# sourceMappingURL=defineHook.js.map

package/dist/definers/defineHook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineHook.js","sourceRoot":"","sources":["../../src/definers/defineHook.ts"],"names":[],"mappings":";;AAeA,gCAiBC;AAhCD,kCAQiB;AACjB,0DAAuD;AAEvD;;;GAGG;AACH,SAAgB,UAAU,CAIxB,OAAuC;IACvC,MAAM,QAAQ,GAAG,IAAA,6BAAa,GAAE,CAAC;IACjC,OAAO;QACL,CAAC,iBAAU,CAAC,EAAE,IAAI;QAClB,CAAC,qBAAc,CAAC,EAAE,QAAQ;QAC1B,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,YAAY,EAAE,OAAO,CAAC,YAAY,IAAK,EAAQ;QAC/C,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAK,EAAY;QACnC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE;KACD,CAAC;AAC5B,CAAC"}

package/dist/definers/defineOverride.d.ts

@@ -0,0 +1,14 @@
+import { ITask, IResource, ITaskMiddleware, IResourceMiddleware, IHook } from "../defs";
+/**
+ * Override helper that preserves the original `id` and returns the same type.
+ * You can override any property except `id`. The override is shallow-merged over the base.
+ *
+ * @param base - The base definition to override.
+ * @param patch - Properties to override (except `id`).
+ * @returns A definition of the same kind with overrides applied.
+ */
+export declare function defineOverride<T extends ITask<any, any, any, any, any, any>>(base: T, patch: Omit<Partial<T>, "id"> & Pick<T, "run">): T;
+export declare function defineOverride<T extends IResource<any, any, any, any, any, any>>(base: T, patch: Omit<Partial<T>, "id"> & Pick<T, "init">): T;
+export declare function defineOverride<T extends ITaskMiddleware<any, any, any, any>>(base: T, patch: Omit<Partial<T>, "id">): T;
+export declare function defineOverride<T extends IResourceMiddleware<any, any, any, any>>(base: T, patch: Omit<Partial<T>, "id"> & Pick<T, "run">): T;
+export declare function defineOverride<T extends IHook<any, any, any>>(base: T, patch: Omit<Partial<T>, "id" | "on"> & Pick<T, "run">): T;

package/dist/definers/defineOverride.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineOverride = defineOverride;
+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,
+    };
+}
+//# sourceMappingURL=defineOverride.js.map

package/dist/definers/defineOverride.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineOverride.js","sourceRoot":"","sources":["../../src/definers/defineOverride.ts"],"names":[],"mappings":";;AAkCA,wCAWC;AAXD,SAAgB,cAAc,CAC5B,IAA+D,EAC/D,KAA8B;IAE9B,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;IACxC,0DAA0D;IAC1D,OAAO;QACL,GAAI,IAAY;QAChB,GAAG,IAAI;QACP,EAAE,EAAG,IAAY,CAAC,EAAE;KACd,CAAC;AACX,CAAC"}

package/dist/definers/defineResource.d.ts

@@ -0,0 +1,2 @@
+import { IResource, IResourceDefinition, DependencyMapType, IResourceMeta, TagType, ResourceMiddlewareAttachmentType } from "../defs";
+export declare function defineResource<TConfig = void, TValue extends Promise<any> = Promise<any>, TDeps extends DependencyMapType = {}, TPrivate = any, TMeta extends IResourceMeta = any, TTags extends TagType[] = TagType[], TMiddleware extends ResourceMiddlewareAttachmentType[] = ResourceMiddlewareAttachmentType[]>(constConfig: IResourceDefinition<TConfig, TValue, TDeps, TPrivate, any, any, TMeta, TTags, TMiddleware>): IResource<TConfig, TValue, TDeps, TPrivate, TMeta, TTags, TMiddleware>;

package/dist/definers/defineResource.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineResource = defineResource;
+const defs_1 = require("../defs");
+const errors_1 = require("../errors");
+const getCallerFile_1 = require("../tools/getCallerFile");
+function defineResource(constConfig) {
+    /**
+     * Define a resource.
+     * Produces a strongly-typed resource with id, registration hooks,
+     * and optional config schema.
+     *
+     * - If `id` is omitted, an anonymous, file-based id is generated (resource or index flavored).
+     * - Provides `.with(config)` for config-bound registration with optional runtime validation.
+     *
+     * @typeParam TConfig - Configuration type accepted by the resource.
+     * @typeParam TValue - Promise type resolved by the resource `init`.
+     * @typeParam TDeps - Dependency map type this resource requires.
+     * @typeParam TPrivate - Private context type exposed to middleware during init.
+     * @typeParam TMeta - Arbitrary metadata type carried by the resource.
+     * @param constConfig - The resource definition config.
+     * @returns A branded resource definition usable by the runner.
+     */
+    // 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;
+    const id = constConfig.id;
+    return {
+        [defs_1.symbolResource]: true,
+        [defs_1.symbolFilePath]: filePath,
+        [defs_1.symbolIndexResource]: isIndexResource,
+        id,
+        dependencies: constConfig.dependencies,
+        dispose: constConfig.dispose,
+        register: constConfig.register || [],
+        overrides: constConfig.overrides || [],
+        init: constConfig.init,
+        context: constConfig.context,
+        configSchema: constConfig.configSchema,
+        resultSchema: constConfig.resultSchema,
+        tags: constConfig.tags || [],
+        with: function (config) {
+            // Validate config with schema if provided (fail fast)
+            if (constConfig.configSchema) {
+                try {
+                    config = constConfig.configSchema.parse(config);
+                }
+                catch (error) {
+                    throw new errors_1.ValidationError("Resource config", id, error instanceof Error ? error : new Error(String(error)));
+                }
+            }
+            return {
+                [defs_1.symbolResourceWithConfig]: true,
+                id: this.id,
+                resource: this,
+                config,
+            };
+        },
+        meta: (constConfig.meta || {}),
+        middleware: constConfig.middleware || [],
+        optional() {
+            return {
+                inner: this,
+                [defs_1.symbolOptionalDependency]: true,
+            };
+        },
+    };
+}
+//# sourceMappingURL=defineResource.js.map

package/dist/definers/defineResource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineResource.js","sourceRoot":"","sources":["../../src/definers/defineResource.ts"],"names":[],"mappings":";;AAkBA,wCAiGC;AAnHD,kCAciB;AACjB,sCAA4C;AAC5C,0DAAuD;AAEvD,SAAgB,cAAc,CAS5B,WAUC;IAED;;;;;;;;;;;;;;;OAeG;IACH,uEAAuE;IACvE,MAAM,QAAQ,GAAW,WAAW,CAAC,qBAAc,CAAC,IAAI,IAAA,6BAAa,GAAE,CAAC;IACxE,MAAM,eAAe,GAAG,WAAW,CAAC,0BAAmB,CAAC,IAAI,KAAK,CAAC;IAClE,MAAM,EAAE,GAAG,WAAW,CAAC,EAAE,CAAC;IAE1B,OAAO;QACL,CAAC,qBAAc,CAAC,EAAE,IAAI;QACtB,CAAC,qBAAc,CAAC,EAAE,QAAQ;QAC1B,CAAC,0BAAmB,CAAC,EAAE,eAAe;QACtC,EAAE;QACF,YAAY,EAAE,WAAW,CAAC,YAAY;QACtC,OAAO,EAAE,WAAW,CAAC,OAAO;QAC5B,QAAQ,EAAE,WAAW,CAAC,QAAQ,IAAI,EAAE;QACpC,SAAS,EAAE,WAAW,CAAC,SAAS,IAAI,EAAE;QACtC,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,OAAO,EAAE,WAAW,CAAC,OAAO;QAC5B,YAAY,EAAE,WAAW,CAAC,YAAY;QACtC,YAAY,EAAE,WAAW,CAAC,YAAY;QACtC,IAAI,EAAE,WAAW,CAAC,IAAI,IAAK,EAAuB;QAClD,IAAI,EAAE,UAAU,MAAe;YAC7B,sDAAsD;YACtD,IAAI,WAAW,CAAC,YAAY,EAAE,CAAC;gBAC7B,IAAI,CAAC;oBACH,MAAM,GAAG,WAAW,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBAClD,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,IAAI,wBAAe,CACvB,iBAAiB,EACjB,EAAE,EACF,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAC1D,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,OAAO;gBACL,CAAC,+BAAwB,CAAC,EAAE,IAAI;gBAChC,EAAE,EAAE,IAAI,CAAC,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,MAAM;aASP,CAAC;QACJ,CAAC;QAED,IAAI,EAAE,CAAC,WAAW,CAAC,IAAI,IAAI,EAAE,CAAU;QACvC,UAAU,EAAE,WAAW,CAAC,UAAU,IAAK,EAA6B;QACpE,QAAQ;YACN,OAAO;gBACL,KAAK,EAAE,IAAI;gBACX,CAAC,+BAAwB,CAAC,EAAE,IAAI;aAGjC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/definers/defineResourceMiddleware.d.ts

@@ -0,0 +1,2 @@
+import { IResourceMiddleware, IResourceMiddlewareDefinition, DependencyMapType } from "../defs";
+export declare function defineResourceMiddleware<TConfig = any, TEnforceInputContract = void, TEnforceOutputContract = void, TDependencies extends DependencyMapType = any>(middlewareDef: IResourceMiddlewareDefinition<TConfig, TEnforceInputContract, TEnforceOutputContract, TDependencies>): IResourceMiddleware<TConfig, TEnforceInputContract, TEnforceOutputContract, TDependencies>;

package/dist/definers/defineResourceMiddleware.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineResourceMiddleware = defineResourceMiddleware;
+const defs_1 = require("../defs");
+const errors_1 = require("../errors");
+const getCallerFile_1 = require("../tools/getCallerFile");
+function defineResourceMiddleware(middlewareDef) {
+    const filePath = (0, getCallerFile_1.getCallerFile)();
+    const base = {
+        [defs_1.symbolFilePath]: filePath,
+        [defs_1.symbolResourceMiddleware]: true,
+        config: {},
+        configSchema: middlewareDef.configSchema,
+        ...middlewareDef,
+        dependencies: middlewareDef.dependencies || {},
+    };
+    const wrap = (obj) => {
+        return {
+            ...obj,
+            with: (config) => {
+                if (obj.configSchema) {
+                    try {
+                        config = obj.configSchema.parse(config);
+                    }
+                    catch (error) {
+                        throw new errors_1.ValidationError("Middleware config", obj.id, error);
+                    }
+                }
+                return wrap({
+                    ...obj,
+                    [defs_1.symbolMiddlewareConfigured]: true,
+                    config: {
+                        ...obj.config,
+                        ...config,
+                    },
+                });
+            },
+        };
+    };
+    return wrap(base);
+}
+//# sourceMappingURL=defineResourceMiddleware.js.map

package/dist/definers/defineResourceMiddleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineResourceMiddleware.js","sourceRoot":"","sources":["../../src/definers/defineResourceMiddleware.ts"],"names":[],"mappings":";;AAYA,4DAgFC;AA5FD,kCAQiB;AACjB,sCAA4C;AAC5C,0DAAuD;AAEvD,SAAgB,wBAAwB,CAMtC,aAKC;IAOD,MAAM,QAAQ,GAAG,IAAA,6BAAa,GAAE,CAAC;IACjC,MAAM,IAAI,GAAG;QACX,CAAC,qBAAc,CAAC,EAAE,QAAQ;QAC1B,CAAC,+BAAwB,CAAC,EAAE,IAAI;QAChC,MAAM,EAAE,EAAa;QACrB,YAAY,EAAE,aAAa,CAAC,YAAY;QACxC,GAAG,aAAa;QAChB,YAAY,EAAE,aAAa,CAAC,YAAY,IAAK,EAAoB;KAMlE,CAAC;IAEF,MAAM,IAAI,GAAG,CACX,GAOC,EAMD,EAAE;QACF,OAAO;YACL,GAAG,GAAG;YACN,IAAI,EAAE,CAAC,MAAe,EAAE,EAAE;gBACxB,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;oBACrB,IAAI,CAAC;wBACH,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;oBAC1C,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,MAAM,IAAI,wBAAe,CACvB,mBAAmB,EACnB,GAAG,CAAC,EAAE,EACN,KAAc,CACf,CAAC;oBACJ,CAAC;gBACH,CAAC;gBACD,OAAO,IAAI,CAAC;oBACV,GAAG,GAAG;oBACN,CAAC,iCAA0B,CAAC,EAAE,IAAI;oBAClC,MAAM,EAAE;wBACN,GAAI,GAAG,CAAC,MAAkB;wBAC1B,GAAG,MAAM;qBACV;iBAC6G,CAAC,CAAC;YACpH,CAAC;SAMF,CAAC;IACJ,CAAC,CAAC;IAEF,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC;AACpB,CAAC"}

package/dist/definers/defineTag.d.ts

@@ -0,0 +1,12 @@
+import { ITag, ITagDefinition } from "../defs";
+/**
+ * Create a tag definition.
+ * - `.with(config)` to create configured instances
+ * - `.extract(tags)` to extract this tag from a list of tags or a taggable's meta
+ *
+ * @typeParam TConfig - Configuration type carried by configured tags.
+ * @typeParam TEnforceContract - Optional helper type to enforce a contract when tags are used.
+ * @param definition - The tag definition (id).
+ * @returns A tag object with helpers to configure and extract.
+ */
+export declare function defineTag<TConfig = void, TEnforceInputContract = void, TEnforceOutputContract = void>(definition: ITagDefinition<TConfig, TEnforceInputContract, TEnforceOutputContract>): ITag<TConfig, TEnforceInputContract, TEnforceOutputContract>;

package/dist/definers/defineTag.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineTag = defineTag;
+const defs_1 = require("../defs");
+const errors_1 = require("../errors");
+const getCallerFile_1 = require("../tools/getCallerFile");
+/**
+ * Create a tag definition.
+ * - `.with(config)` to create configured instances
+ * - `.extract(tags)` to extract this tag from a list of tags or a taggable's meta
+ *
+ * @typeParam TConfig - Configuration type carried by configured tags.
+ * @typeParam TEnforceContract - Optional helper type to enforce a contract when tags are used.
+ * @param definition - The tag definition (id).
+ * @returns A tag object with helpers to configure and extract.
+ */
+function defineTag(definition) {
+    const id = definition.id;
+    const filePath = (0, getCallerFile_1.getCallerFile)();
+    const foundation = {
+        id,
+        meta: definition.meta,
+        config: definition.config,
+    };
+    return {
+        ...foundation,
+        [defs_1.symbolTag]: true,
+        [defs_1.symbolFilePath]: filePath,
+        /**
+         * Specify custom config for this tag which extends the default one if exists
+         * @param tagConfig
+         * @returns
+         */
+        with(tagConfig) {
+            if (definition.configSchema) {
+                try {
+                    tagConfig = definition.configSchema.parse(tagConfig);
+                }
+                catch (error) {
+                    throw new errors_1.ValidationError("Tag config", this.id, error);
+                }
+            }
+            let config;
+            if (typeof tagConfig === "object") {
+                if (typeof foundation.config === "object") {
+                    config = {
+                        ...foundation.config,
+                        ...tagConfig,
+                    };
+                }
+                else {
+                    config = tagConfig;
+                }
+            }
+            else {
+                config = tagConfig;
+            }
+            return {
+                ...foundation,
+                [defs_1.symbolTagConfigured]: true,
+                config,
+            };
+        },
+        /**
+         * Checks if the tag exists in a taggable or a list of tags.
+         * @param target
+         * @returns
+         */
+        exists(target) {
+            let currentTags = [];
+            if (Array.isArray(target)) {
+                currentTags = target;
+            }
+            else {
+                currentTags = target.tags;
+            }
+            for (const candidate of currentTags) {
+                if (candidate.id === id) {
+                    return true;
+                }
+            }
+            return false;
+        },
+        /**
+         * Function which serves 2 purposes, verifying if the task exists, and retrieving its config
+         * @param target
+         * @returns
+         */
+        extract(target) {
+            let currentTags = [];
+            if (Array.isArray(target)) {
+                currentTags = target;
+            }
+            else {
+                currentTags = target.tags || [];
+            }
+            for (const candidate of currentTags) {
+                if (candidate.id === id) {
+                    return candidate.config;
+                }
+            }
+            return;
+        },
+    };
+}
+//# sourceMappingURL=defineTag.js.map

package/dist/definers/defineTag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineTag.js","sourceRoot":"","sources":["../../src/definers/defineTag.ts"],"names":[],"mappings":";;AAuBA,8BAsGC;AA7HD,kCASiB;AACjB,sCAA4C;AAC5C,0DAAuD;AAEvD;;;;;;;;;GASG;AACH,SAAgB,SAAS,CAKvB,UAIC;IAED,MAAM,EAAE,GAAG,UAAU,CAAC,EAAE,CAAC;IACzB,MAAM,QAAQ,GAAG,IAAA,6BAAa,GAAE,CAAC;IACjC,MAAM,UAAU,GAAG;QACjB,EAAE;QACF,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,MAAM,EAAE,UAAU,CAAC,MAAM;KACsC,CAAC;IAElE,OAAO;QACL,GAAG,UAAU;QACb,CAAC,gBAAS,CAAC,EAAE,IAAI;QACjB,CAAC,qBAAc,CAAC,EAAE,QAAQ;QAC1B;;;;WAIG;QACH,IAAI,CAAC,SAAkB;YACrB,IAAI,UAAU,CAAC,YAAY,EAAE,CAAC;gBAC5B,IAAI,CAAC;oBACH,SAAS,GAAG,UAAU,CAAC,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;gBACvD,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,IAAI,wBAAe,CAAC,YAAY,EAAE,IAAI,CAAC,EAAE,EAAE,KAAc,CAAC,CAAC;gBACnE,CAAC;YACH,CAAC;YACD,IAAI,MAAe,CAAC;YACpB,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;gBAClC,IAAI,OAAO,UAAU,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;oBAC1C,MAAM,GAAG;wBACP,GAAG,UAAU,CAAC,MAAM;wBACpB,GAAG,SAAS;qBACb,CAAC;gBACJ,CAAC;qBAAM,CAAC;oBACN,MAAM,GAAG,SAAS,CAAC;gBACrB,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,SAAS,CAAC;YACrB,CAAC;YACD,OAAO;gBACL,GAAG,UAAU;gBACb,CAAC,0BAAmB,CAAC,EAAE,IAAI;gBAC3B,MAAM;aAKP,CAAC;QACJ,CAAC;QACD;;;;WAIG;QACH,MAAM,CAAC,MAA6B;YAClC,IAAI,WAAW,GAAc,EAAE,CAAC;YAChC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1B,WAAW,GAAG,MAAM,CAAC;YACvB,CAAC;iBAAM,CAAC;gBACN,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC;YAC5B,CAAC;YAED,KAAK,MAAM,SAAS,IAAI,WAAW,EAAE,CAAC;gBACpC,IAAI,SAAS,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;oBACxB,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC;YAED,OAAO,KAAK,CAAC;QACf,CAAC;QACD;;;;WAIG;QACH,OAAO,CAAC,MAA6B;YACnC,IAAI,WAAW,GAAc,EAAE,CAAC;YAChC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1B,WAAW,GAAG,MAAM,CAAC;YACvB,CAAC;iBAAM,CAAC;gBACN,WAAW,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YAClC,CAAC;YAED,KAAK,MAAM,SAAS,IAAI,WAAW,EAAE,CAAC;gBACpC,IAAI,SAAS,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;oBACxB,OAAO,SAAS,CAAC,MAAiB,CAAC;gBACrC,CAAC;YACH,CAAC;YAED,OAAO;QACT,CAAC;KACqE,CAAC;AAC3E,CAAC"}

package/dist/definers/defineTask.d.ts

@@ -0,0 +1,15 @@
+import { ITask, ITaskDefinition, DependencyMapType, ITaskMeta, TagType, TaskMiddlewareAttachmentType } from "../defs";
+/**
+ * Define a task.
+ * Generates a strongly-typed task object with id, dependencies,
+ * middleware, and metadata.
+ *
+ * @typeParam Input - Input type accepted by the task's `run` function.
+ * @typeParam Output - Promise type returned by the `run` function.
+ * @typeParam Deps - Dependency map type this task requires.
+ * @typeParam TOn - Event type or "*" this task listens to.
+ * @typeParam TMeta - Arbitrary metadata type carried by the task.
+ * @param taskConfig - The task definition config.
+ * @returns A branded task definition usable by the runner.
+ */
+export declare function defineTask<Input = undefined, Output extends Promise<any> = any, Deps extends DependencyMapType = any, TMeta extends ITaskMeta = any, TTags extends TagType[] = TagType[], TMiddleware extends TaskMiddlewareAttachmentType[] = TaskMiddlewareAttachmentType[]>(taskConfig: ITaskDefinition<Input, Output, Deps, TMeta, TTags, TMiddleware>): ITask<Input, Output, Deps, TMeta, TTags, TMiddleware>;

package/dist/definers/defineTask.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineTask = defineTask;
+const defs_1 = require("../defs");
+const getCallerFile_1 = require("../tools/getCallerFile");
+/**
+ * Define a task.
+ * Generates a strongly-typed task object with id, dependencies,
+ * middleware, and metadata.
+ *
+ * @typeParam Input - Input type accepted by the task's `run` function.
+ * @typeParam Output - Promise type returned by the `run` function.
+ * @typeParam Deps - Dependency map type this task requires.
+ * @typeParam TOn - Event type or "*" this task listens to.
+ * @typeParam TMeta - Arbitrary metadata type carried by the task.
+ * @param taskConfig - The task definition config.
+ * @returns A branded task definition usable by the runner.
+ */
+function defineTask(taskConfig) {
+    const filePath = (0, getCallerFile_1.getCallerFile)();
+    const id = taskConfig.id;
+    return {
+        [defs_1.symbolTask]: true,
+        [defs_1.symbolFilePath]: filePath,
+        id,
+        dependencies: taskConfig.dependencies || {},
+        middleware: taskConfig.middleware || [],
+        run: taskConfig.run,
+        inputSchema: taskConfig.inputSchema,
+        resultSchema: taskConfig.resultSchema,
+        meta: taskConfig.meta || {},
+        tags: taskConfig.tags || [],
+        // autorun,
+        optional() {
+            return {
+                inner: this,
+                [defs_1.symbolOptionalDependency]: true,
+            };
+        },
+    };
+}
+//# sourceMappingURL=defineTask.js.map

package/dist/definers/defineTask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineTask.js","sourceRoot":"","sources":["../../src/definers/defineTask.ts"],"names":[],"mappings":";;AA2BA,gCAiCC;AA5DD,kCAWiB;AACjB,0DAAuD;AAEvD;;;;;;;;;;;;GAYG;AACH,SAAgB,UAAU,CAQxB,UAA2E;IAE3E,MAAM,QAAQ,GAAG,IAAA,6BAAa,GAAE,CAAC;IACjC,MAAM,EAAE,GAAG,UAAU,CAAC,EAAE,CAAC;IACzB,OAAO;QACL,CAAC,iBAAU,CAAC,EAAE,IAAI;QAClB,CAAC,qBAAc,CAAC,EAAE,QAAQ;QAC1B,EAAE;QACF,YAAY,EAAE,UAAU,CAAC,YAAY,IAAK,EAAW;QACrD,UAAU,EAAE,UAAU,CAAC,UAAU,IAAK,EAA6B;QACnE,GAAG,EAAE,UAAU,CAAC,GAAG;QACnB,WAAW,EAAE,UAAU,CAAC,WAAW;QACnC,YAAY,EAAE,UAAU,CAAC,YAAY;QACrC,IAAI,EAAE,UAAU,CAAC,IAAI,IAAK,EAAY;QACtC,IAAI,EAAE,UAAU,CAAC,IAAI,IAAK,EAAuB;QACjD,WAAW;QACX,QAAQ;YACN,OAAO;gBACL,KAAK,EAAE,IAAI;gBACX,CAAC,+BAAwB,CAAC,EAAE,IAAI;aAGjC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/definers/defineTaskMiddleware.d.ts

@@ -0,0 +1,2 @@
+import { ITaskMiddleware, ITaskMiddlewareDefinition, DependencyMapType } from "../defs";
+export declare function defineTaskMiddleware<TConfig = any, TEnforceInputContract = void, TEnforceOutputContract = void, TDependencies extends DependencyMapType = any>(middlewareDef: ITaskMiddlewareDefinition<TConfig, TEnforceInputContract, TEnforceOutputContract, TDependencies>): ITaskMiddleware<TConfig, TEnforceInputContract, TEnforceOutputContract, TDependencies>;

package/dist/definers/defineTaskMiddleware.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineTaskMiddleware = defineTaskMiddleware;
+const defs_1 = require("../defs");
+const errors_1 = require("../errors");
+const getCallerFile_1 = require("../tools/getCallerFile");
+function defineTaskMiddleware(middlewareDef) {
+    const filePath = (0, getCallerFile_1.getCallerFile)();
+    const base = {
+        [defs_1.symbolFilePath]: filePath,
+        [defs_1.symbolTaskMiddleware]: true,
+        config: {},
+        configSchema: middlewareDef.configSchema,
+        ...middlewareDef,
+        dependencies: middlewareDef.dependencies || {},
+    };
+    const wrap = (obj) => {
+        return {
+            ...obj,
+            with: (config) => {
+                if (obj.configSchema) {
+                    try {
+                        config = obj.configSchema.parse(config);
+                    }
+                    catch (error) {
+                        throw new errors_1.ValidationError("Middleware config", obj.id, error instanceof Error ? error : new Error(String(error)));
+                    }
+                }
+                return wrap({
+                    ...obj,
+                    [defs_1.symbolMiddlewareConfigured]: true,
+                    config: {
+                        ...obj.config,
+                        ...config,
+                    },
+                });
+            },
+        };
+    };
+    return wrap(base);
+}
+//# sourceMappingURL=defineTaskMiddleware.js.map

package/dist/definers/defineTaskMiddleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineTaskMiddleware.js","sourceRoot":"","sources":["../../src/definers/defineTaskMiddleware.ts"],"names":[],"mappings":";;AAaA,oDAiFC;AA9FD,kCASiB;AACjB,sCAA4C;AAC5C,0DAAuD;AAEvD,SAAgB,oBAAoB,CAMlC,aAKC;IAOD,MAAM,QAAQ,GAAG,IAAA,6BAAa,GAAE,CAAC;IACjC,MAAM,IAAI,GAAG;QACX,CAAC,qBAAc,CAAC,EAAE,QAAQ;QAC1B,CAAC,2BAAoB,CAAC,EAAE,IAAI;QAC5B,MAAM,EAAE,EAAa;QACrB,YAAY,EAAE,aAAa,CAAC,YAAY;QACxC,GAAG,aAAa;QAChB,YAAY,EACT,aAAa,CAAC,YAA8B,IAAK,EAAoB;KAMzE,CAAC;IAEF,MAAM,IAAI,GAAG,CACX,GAOC,EAMD,EAAE;QACF,OAAO;YACL,GAAG,GAAG;YACN,IAAI,EAAE,CAAC,MAAe,EAAE,EAAE;gBACxB,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;oBACrB,IAAI,CAAC;wBACH,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;oBAC1C,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,MAAM,IAAI,wBAAe,CACvB,mBAAmB,EACnB,GAAG,CAAC,EAAE,EACN,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAC1D,CAAC;oBACJ,CAAC;gBACH,CAAC;gBACD,OAAO,IAAI,CAAC;oBACV,GAAG,GAAG;oBACN,CAAC,iCAA0B,CAAC,EAAE,IAAI;oBAClC,MAAM,EAAE;wBACN,GAAI,GAAG,CAAC,MAAkB;wBAC1B,GAAG,MAAM;qBACV;iBACyG,CAAC,CAAC;YAChH,CAAC;SAMF,CAAC;IACJ,CAAC,CAAC;IAEF,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC;AACpB,CAAC"}

package/dist/definers/tools.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Type guard and utility functions for checking definition types.
+ */
+import { ITask, IResource, IResourceWithConfig, ITaskMiddleware, IResourceMiddleware, IEvent, IHook, IOptionalDependency, ITag } from "../defs";
+/**
+ * Type guard: checks if a definition is a Task.
+ * @param definition - Any value to test.
+ * @returns True when `definition` is a branded Task.
+ */
+export declare function isTask(definition: any): definition is ITask;
+/**
+ * Type guard: checks if a definition is a Resource.
+ * @param definition - Any value to test.
+ * @returns True when `definition` is a branded Resource.
+ */
+export declare function isResource(definition: any): definition is IResource;
+/**
+ * Type guard: checks if a definition is a Resource that carries config via `.with()`.
+ * @param definition - Any value to test.
+ * @returns True when `definition` is a branded ResourceWithConfig.
+ */
+export declare function isResourceWithConfig(definition: any): definition is IResourceWithConfig;
+/**
+ * Type guard: checks if a definition is an Event.
+ * @param definition - Any value to test.
+ * @returns True when `definition` is a branded Event.
+ */
+export declare function isEvent(definition: any): definition is IEvent;
+/** Type guard: checks if a definition is a Hook. */
+export declare function isHook(definition: any): definition is IHook;
+/**
+ * Type guard: checks if a definition is a Middleware.
+ * @param definition - Any value to test.
+ * @returns True when `definition` is a branded Middleware.
+ */
+export declare function isTaskMiddleware(definition: any): definition is ITaskMiddleware;
+export declare function isResourceMiddleware(definition: any): definition is IResourceMiddleware;
+/**
+ * Type guard: checks if a definition is a Tag.
+ * @param definition - Any value to test.
+ * @returns True when `definition` is a branded Tag.
+ */
+export declare function isTag(definition: any): definition is ITag;
+/** Type guard: checks if a definition is an Optional Dependency wrapper. */
+export declare function isOptional(definition: any): definition is IOptionalDependency<any>;

package/dist/definers/tools.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isTask = isTask;
+exports.isResource = isResource;
+exports.isResourceWithConfig = isResourceWithConfig;
+exports.isEvent = isEvent;
+exports.isHook = isHook;
+exports.isTaskMiddleware = isTaskMiddleware;
+exports.isResourceMiddleware = isResourceMiddleware;
+exports.isTag = isTag;
+exports.isOptional = isOptional;
+/**
+ * Type guard and utility functions for checking definition types.
+ */
+const defs_1 = require("../defs");
+/**
+ * Type guard: checks if a definition is a Task.
+ * @param definition - Any value to test.
+ * @returns True when `definition` is a branded Task.
+ */
+function isTask(definition) {
+    return definition && definition[defs_1.symbolTask];
+}
+/**
+ * Type guard: checks if a definition is a Resource.
+ * @param definition - Any value to test.
+ * @returns True when `definition` is a branded Resource.
+ */
+function isResource(definition) {
+    return definition && definition[defs_1.symbolResource];
+}
+/**
+ * Type guard: checks if a definition is a Resource that carries config via `.with()`.
+ * @param definition - Any value to test.
+ * @returns True when `definition` is a branded ResourceWithConfig.
+ */
+function isResourceWithConfig(definition) {
+    return definition && definition[defs_1.symbolResourceWithConfig];
+}
+/**
+ * Type guard: checks if a definition is an Event.
+ * @param definition - Any value to test.
+ * @returns True when `definition` is a branded Event.
+ */
+function isEvent(definition) {
+    return definition && definition[defs_1.symbolEvent];
+}
+/** Type guard: checks if a definition is a Hook. */
+function isHook(definition) {
+    return definition && definition[defs_1.symbolHook];
+}
+/**
+ * Type guard: checks if a definition is a Middleware.
+ * @param definition - Any value to test.
+ * @returns True when `definition` is a branded Middleware.
+ */
+function isTaskMiddleware(definition) {
+    return definition && definition[defs_1.symbolTaskMiddleware];
+}
+function isResourceMiddleware(definition) {
+    return definition && definition[defs_1.symbolResourceMiddleware];
+}
+/**
+ * Type guard: checks if a definition is a Tag.
+ * @param definition - Any value to test.
+ * @returns True when `definition` is a branded Tag.
+ */
+function isTag(definition) {
+    return definition && definition[defs_1.symbolTag];
+}
+/** Type guard: checks if a definition is an Optional Dependency wrapper. */
+function isOptional(definition) {
+    return definition && definition[defs_1.symbolOptionalDependency];
+}
+//# sourceMappingURL=tools.js.map

package/dist/definers/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/definers/tools.ts"],"names":[],"mappings":";;AA6BA,wBAEC;AAOD,gCAEC;AAOD,oDAIC;AAOD,0BAEC;AAGD,wBAEC;AAOD,4CAIC;AAED,oDAIC;AAOD,sBAEC;AAGD,gCAIC;AAlGD;;GAEG;AACH,kCAmBiB;AAEjB;;;;GAIG;AACH,SAAgB,MAAM,CAAC,UAAe;IACpC,OAAO,UAAU,IAAI,UAAU,CAAC,iBAAU,CAAC,CAAC;AAC9C,CAAC;AAED;;;;GAIG;AACH,SAAgB,UAAU,CAAC,UAAe;IACxC,OAAO,UAAU,IAAI,UAAU,CAAC,qBAAc,CAAC,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,SAAgB,oBAAoB,CAClC,UAAe;IAEf,OAAO,UAAU,IAAI,UAAU,CAAC,+BAAwB,CAAC,CAAC;AAC5D,CAAC;AAED;;;;GAIG;AACH,SAAgB,OAAO,CAAC,UAAe;IACrC,OAAO,UAAU,IAAI,UAAU,CAAC,kBAAW,CAAC,CAAC;AAC/C,CAAC;AAED,oDAAoD;AACpD,SAAgB,MAAM,CAAC,UAAe;IACpC,OAAO,UAAU,IAAI,UAAU,CAAC,iBAAU,CAAC,CAAC;AAC9C,CAAC;AAED;;;;GAIG;AACH,SAAgB,gBAAgB,CAC9B,UAAe;IAEf,OAAO,UAAU,IAAI,UAAU,CAAC,2BAAoB,CAAC,CAAC;AACxD,CAAC;AAED,SAAgB,oBAAoB,CAClC,UAAe;IAEf,OAAO,UAAU,IAAI,UAAU,CAAC,+BAAwB,CAAC,CAAC;AAC5D,CAAC;AAED;;;;GAIG;AACH,SAAgB,KAAK,CAAC,UAAe;IACnC,OAAO,UAAU,IAAI,UAAU,CAAC,gBAAS,CAAC,CAAC;AAC7C,CAAC;AAED,4EAA4E;AAC5E,SAAgB,UAAU,CACxB,UAAe;IAEf,OAAO,UAAU,IAAI,UAAU,CAAC,+BAAwB,CAAC,CAAC;AAC5D,CAAC"}