@bluelibs/runner 3.2.0 → 3.3.0

package/dist/docs/introspect.js

@@ -0,0 +1,199 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.introspectResource = introspectResource;
+const EventManager_1 = require("../models/EventManager");
+const Logger_1 = require("../models/Logger");
+const Store_1 = require("../models/Store");
+const defs_1 = require("../defs");
+const model_1 = require("./model");
+async function introspectResource(root, config = {}, options = {}) {
+    const includeGlobals = options.includeGlobals ?? false;
+    // Build a Store but do not compute dependencies or initialize root.
+    const eventManager = new EventManager_1.EventManager();
+    const logger = new Logger_1.Logger(eventManager);
+    const store = new Store_1.Store(eventManager, logger);
+    // Only registration phase, with overrides processed, but no init.
+    store.initializeStore(root, config);
+    store.processOverrides();
+    const nodes = [];
+    const edges = [];
+    // Helpers
+    const shouldInclude = (id) => {
+        const str = (0, model_1.normalizeId)(id);
+        if (includeGlobals)
+            return true;
+        return !str.startsWith("globals.");
+    };
+    // Resources
+    for (const res of store.resources.values()) {
+        if (!shouldInclude(res.resource.id))
+            continue;
+        nodes.push({
+            ...(0, model_1.buildBaseNode)("resource", res.resource.id, res.resource[defs_1.symbols.filePath], res.resource.meta),
+        });
+        const regItems = Array.isArray(res.resource.register)
+            ? res.resource.register
+            : [];
+        for (const item of regItems) {
+            const targetId = item.id || item?.resource?.id;
+            if (!targetId || !shouldInclude(targetId))
+                continue;
+            edges.push({
+                type: "registers",
+                from: (0, model_1.normalizeId)(res.resource.id),
+                to: (0, model_1.normalizeId)(targetId),
+            });
+        }
+        // Resource dependencies
+        const deps = (res.resource.dependencies || {});
+        for (const depKey of Object.keys(deps)) {
+            const dep = deps[depKey];
+            const depId = dep?.id;
+            if (!depId || !shouldInclude(depId))
+                continue;
+            edges.push({
+                type: "dependsOn",
+                from: (0, model_1.normalizeId)(res.resource.id),
+                to: (0, model_1.normalizeId)(depId),
+                meta: { key: depKey },
+            });
+        }
+        // Resource middleware
+        for (const mw of res.resource.middleware || []) {
+            const mwId = mw.id;
+            if (!mwId || !shouldInclude(mwId))
+                continue;
+            edges.push({
+                type: "middleware",
+                from: (0, model_1.normalizeId)(res.resource.id),
+                to: (0, model_1.normalizeId)(mwId),
+                meta: { scope: "resource" },
+            });
+        }
+    }
+    // Tasks
+    for (const t of store.tasks.values()) {
+        if (!shouldInclude(t.task.id))
+            continue;
+        nodes.push({
+            ...(0, model_1.buildBaseNode)("task", t.task.id, t.task[defs_1.symbols.filePath], t.task.meta),
+            on: t.task.on
+                ? t.task.on === "*"
+                    ? "*"
+                    : (0, model_1.normalizeId)(t.task.on.id)
+                : undefined,
+            listenerOrder: t.task.listenerOrder,
+        });
+        // Dependencies
+        const deps = (t.task.dependencies || {});
+        for (const depKey of Object.keys(deps)) {
+            const dep = deps[depKey];
+            const depId = dep?.id;
+            if (!depId || !shouldInclude(depId))
+                continue;
+            edges.push({
+                type: "dependsOn",
+                from: (0, model_1.normalizeId)(t.task.id),
+                to: (0, model_1.normalizeId)(depId),
+                meta: { key: depKey },
+            });
+        }
+        // Middleware
+        for (const mw of t.task.middleware || []) {
+            const mwId = mw.id;
+            if (!mwId || !shouldInclude(mwId))
+                continue;
+            edges.push({
+                type: "middleware",
+                from: (0, model_1.normalizeId)(t.task.id),
+                to: (0, model_1.normalizeId)(mwId),
+                meta: { scope: "task" },
+            });
+        }
+        // Listeners
+        if (t.task.on && t.task.on !== "*") {
+            const eventId = t.task.on.id;
+            if (shouldInclude(eventId)) {
+                edges.push({
+                    type: "listensTo",
+                    from: (0, model_1.normalizeId)(t.task.id),
+                    to: (0, model_1.normalizeId)(eventId),
+                });
+            }
+        }
+    }
+    // Events (registered globally + lifecycle + custom)
+    for (const e of store.events.values()) {
+        const eventId = e.event.id;
+        if (!eventId)
+            continue;
+        if (!shouldInclude(eventId))
+            continue;
+        nodes.push({
+            ...(0, model_1.buildBaseNode)("event", eventId, e.event[defs_1.symbols.filePath], e.event.meta),
+        });
+    }
+    // Middleware nodes
+    for (const mw of store.middlewares.values()) {
+        if (!shouldInclude(mw.middleware.id))
+            continue;
+        nodes.push({
+            ...(0, model_1.buildBaseNode)("middleware", mw.middleware.id, mw.middleware[defs_1.symbols.filePath], mw.middleware.meta),
+            everywhere: {
+                tasks: Boolean(mw.middleware[defs_1.symbols.middlewareEverywhereTasks]),
+                resources: Boolean(mw.middleware[defs_1.symbols.middlewareEverywhereResources]),
+            },
+        });
+        // Dependencies of middleware
+        const deps = (mw.middleware.dependencies || {});
+        for (const depKey of Object.keys(deps)) {
+            const dep = deps[depKey];
+            const depId = dep?.id;
+            if (!depId || !shouldInclude(depId))
+                continue;
+            edges.push({
+                type: "dependsOn",
+                from: (0, model_1.normalizeId)(mw.middleware.id),
+                to: (0, model_1.normalizeId)(depId),
+                meta: { key: depKey },
+            });
+        }
+    }
+    // Override requests and overrides mapping
+    for (const req of store.overrideRequests) {
+        const source = req.source;
+        const targetId = req.override?.id || req.override?.resource?.id;
+        if (targetId && shouldInclude(source) && shouldInclude(targetId)) {
+            edges.push({
+                type: "overrideRequest",
+                from: (0, model_1.normalizeId)(source),
+                to: (0, model_1.normalizeId)(targetId),
+            });
+        }
+    }
+    for (const [id, ov] of store.overrides) {
+        if (!shouldInclude(id))
+            continue;
+        edges.push({
+            type: "overrides",
+            from: (0, model_1.normalizeId)(ov.id || ov?.resource?.id),
+            to: (0, model_1.normalizeId)(id),
+        });
+    }
+    const graph = {
+        version: 1,
+        summary: {
+            counts: {
+                resources: nodes.filter((n) => n.kind === "resource").length,
+                tasks: nodes.filter((n) => n.kind === "task").length,
+                events: nodes.filter((n) => n.kind === "event").length,
+                middleware: nodes.filter((n) => n.kind === "middleware").length,
+                edges: edges.length,
+            },
+        },
+        nodes,
+        edges,
+    };
+    return graph;
+}
+//# sourceMappingURL=introspect.js.map

package/dist/docs/introspect.js.map

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

package/dist/docs/markdown.d.ts

@@ -0,0 +1,2 @@
+import { DocsGraph } from "./model";
+export declare function renderMarkdown(graph: DocsGraph, outDir: string): void;

package/dist/docs/markdown.js

@@ -0,0 +1,148 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderMarkdown = renderMarkdown;
+const fs = require("fs");
+const path = require("path");
+function ensureDir(dir) {
+    fs.mkdirSync(dir, { recursive: true });
+}
+function escapeMd(s) {
+    if (!s)
+        return "";
+    return String(s).replace(/\|/g, "\\|");
+}
+function kinds(nodes) {
+    return {
+        resources: nodes.filter((n) => n.kind === "resource"),
+        tasks: nodes.filter((n) => n.kind === "task"),
+        events: nodes.filter((n) => n.kind === "event"),
+        middleware: nodes.filter((n) => n.kind === "middleware"),
+    };
+}
+function slugifyId(id) {
+    return id
+        .replace(/Symbol\(([^)]*)\)/g, "$1")
+        .replace(/[^a-zA-Z0-9._-]+/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^-|-$|\.$/g, "");
+}
+function kindDir(kind) {
+    if (kind === "resource")
+        return "resources";
+    if (kind === "task")
+        return "tasks";
+    if (kind === "event")
+        return "events";
+    return "middleware";
+}
+function renderTable(nodes) {
+    if (nodes.length === 0)
+        return "_None_\n";
+    let out = "| ID | Title | Description | File | Tags |\n| --- | --- | --- | --- | --- |\n";
+    for (const n of nodes) {
+        const tags = Array.isArray(n.tags)
+            ? n.tags
+                .map((t) => (typeof t === "string" ? t : t?.id ?? "[tag]"))
+                .join(", ")
+            : "";
+        const link = `${kindDir(n.kind)}/${slugifyId(n.id)}.md`;
+        out += `| [${escapeMd(n.id)}](${link}) | ${escapeMd(n.title)} | ${escapeMd(n.description)} | ${escapeMd(n.file)} | ${escapeMd(tags)} |\n`;
+    }
+    return out + "\n";
+}
+function renderMarkdown(graph, outDir) {
+    ensureDir(outDir);
+    ensureDir(path.join(outDir, "resources"));
+    ensureDir(path.join(outDir, "tasks"));
+    ensureDir(path.join(outDir, "events"));
+    ensureDir(path.join(outDir, "middleware"));
+    const idx = [
+        `# Project Book`,
+        ``,
+        `This document was generated from your Runner definitions.`,
+        ``,
+        `## Summary`,
+        `- Resources: ${graph.summary.counts.resources}`,
+        `- Tasks: ${graph.summary.counts.tasks}`,
+        `- Events: ${graph.summary.counts.events}`,
+        `- Middleware: ${graph.summary.counts.middleware}`,
+        `- Edges: ${graph.summary.counts.edges}`,
+        ``,
+        `## Table of Contents`,
+        `- [Resources](#resources)`,
+        `- [Tasks](#tasks)`,
+        `- [Events](#events)`,
+        `- [Middleware](#middleware)`,
+        `- [Namespaces](#namespaces)`,
+        ``,
+    ];
+    const grouped = kinds(graph.nodes);
+    idx.push("## Resources\n\n" + renderTable(grouped.resources));
+    idx.push("## Tasks\n\n" + renderTable(grouped.tasks));
+    idx.push("## Events\n\n" + renderTable(grouped.events));
+    idx.push("## Middleware\n\n" + renderTable(grouped.middleware));
+    // Namespaces section
+    const byNs = new Map();
+    for (const n of graph.nodes) {
+        const ns = n.namespace || "(none)";
+        const list = byNs.get(ns) || [];
+        list.push(n);
+        byNs.set(ns, list);
+    }
+    idx.push("## Namespaces\n");
+    for (const [ns, list] of Array.from(byNs.entries()).sort((a, b) => a[0].localeCompare(b[0]))) {
+        const counts = kinds(list);
+        idx.push(`### ${ns}\n- resources: ${counts.resources.length}\n- tasks: ${counts.tasks.length}\n- events: ${counts.events.length}\n- middleware: ${counts.middleware.length}\n`);
+    }
+    const readme = idx.join("\n");
+    fs.writeFileSync(path.join(outDir, "index.md"), readme, "utf-8");
+    fs.writeFileSync(path.join(outDir, "README.md"), readme, "utf-8");
+    // Build reverse edge index for dependents
+    const incoming = new Map();
+    for (const e of graph.edges) {
+        const list = incoming.get(e.to) || [];
+        list.push({ type: e.type, from: e.from, meta: e.meta });
+        incoming.set(e.to, list);
+    }
+    // Detail pages
+    for (const n of graph.nodes) {
+        const header = [
+            `# ${n.id}`,
+            "",
+            n.title ? `> ${n.title}` : "",
+            n.description ? `\n${n.description}\n` : "",
+        ];
+        const file = n.file
+            ? `- File: \
+\`${n.file}\``
+            : "";
+        const tags = Array.isArray(n.tags)
+            ? n.tags
+                .map((t) => typeof t === "string" ? `\`${t}\`` : `\`${t?.id}\``)
+                .join(" ")
+            : "";
+        const edgesOut = graph.edges.filter((e) => e.from === n.id);
+        const edgesIn = incoming.get(n.id) || [];
+        const sect = [
+            ...header,
+            "",
+            file,
+            tags ? `- Tags: ${tags}` : "",
+            "",
+            "## Outgoing",
+            edgesOut.length ? "" : "_None_",
+            ...edgesOut.map((e) => `- ${e.type} → \
+\`${e.to}\`${e.meta ? ` (${JSON.stringify(e.meta)})` : ""}`),
+            "",
+            "## Incoming",
+            edgesIn.length ? "" : "_None_",
+            ...edgesIn.map((e) => `- ${e.type} ← \
+\`${e.from}\`${e.meta ? ` (${JSON.stringify(e.meta)})` : ""}`),
+            "",
+            "[Back to index](../index.md)",
+        ].filter(Boolean);
+        const dir = path.join(outDir, kindDir(n.kind));
+        fs.writeFileSync(path.join(dir, `${slugifyId(n.id)}.md`), sect.join("\n"), "utf-8");
+    }
+}
+//# sourceMappingURL=markdown.js.map

package/dist/docs/markdown.js.map

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

package/dist/docs/model.d.ts

@@ -0,0 +1,62 @@
+export type NormalizedId = string;
+export type NodeKind = "resource" | "task" | "event" | "middleware";
+export type BaseNode = {
+    id: NormalizedId;
+    kind: NodeKind;
+    file?: string;
+    title?: string;
+    description?: string;
+    tags?: any[];
+    namespace?: string;
+};
+export type ResourceNode = BaseNode & {
+    kind: "resource";
+};
+export type TaskNode = BaseNode & {
+    kind: "task";
+    on?: NormalizedId | "*";
+    listenerOrder?: number;
+};
+export type EventNode = BaseNode & {
+    kind: "event";
+};
+export type MiddlewareNode = BaseNode & {
+    kind: "middleware";
+    everywhere?: {
+        tasks: boolean;
+        resources: boolean;
+    };
+};
+export type GraphNode = ResourceNode | TaskNode | EventNode | MiddlewareNode;
+export type EdgeType = "registers" | "dependsOn" | "listensTo" | "middleware" | "overrideRequest" | "overrides";
+export type GraphEdge = {
+    type: EdgeType;
+    from: NormalizedId;
+    to: NormalizedId;
+    meta?: Record<string, any>;
+};
+export type DocsGraph = {
+    version: 1;
+    summary: {
+        counts: {
+            resources: number;
+            tasks: number;
+            events: number;
+            middleware: number;
+            edges: number;
+        };
+    };
+    nodes: GraphNode[];
+    edges: GraphEdge[];
+    packages?: {
+        name: string;
+        root?: string;
+    }[];
+};
+export declare function guessNamespaceFromId(id: string): string | undefined;
+export declare function normalizeId(id: string | symbol): NormalizedId;
+export declare function buildBaseNode(kind: NodeKind, id: string | symbol, file: string | undefined, meta: {
+    title?: string;
+    description?: string;
+    tags?: any[];
+} | undefined): BaseNode;

package/dist/docs/model.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.guessNamespaceFromId = guessNamespaceFromId;
+exports.normalizeId = normalizeId;
+exports.buildBaseNode = buildBaseNode;
+function guessNamespaceFromId(id) {
+    if (!id)
+        return undefined;
+    const parts = id.split(".");
+    if (parts.length < 2)
+        return parts[0] || undefined;
+    // Heuristic: first two segments, eg: "app.tasks"
+    return parts.slice(0, 2).join(".");
+}
+function normalizeId(id) {
+    if (typeof id === "string")
+        return id;
+    const s = id.toString?.() || String(id);
+    return s;
+}
+function buildBaseNode(kind, id, file, meta) {
+    const normId = normalizeId(id);
+    return {
+        id: normId,
+        kind,
+        file,
+        title: meta?.title,
+        description: meta?.description,
+        tags: meta?.tags,
+        namespace: typeof id === "string" ? guessNamespaceFromId(id) : undefined,
+    };
+}
+//# sourceMappingURL=model.js.map

package/dist/docs/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../src/docs/model.ts"],"names":[],"mappings":";;AAuEA,oDAMC;AAED,kCAIC;AAED,sCAgBC;AA9BD,SAAgB,oBAAoB,CAAC,EAAU;IAC7C,IAAI,CAAC,EAAE;QAAE,OAAO,SAAS,CAAC;IAC1B,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC5B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;IACnD,iDAAiD;IACjD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACrC,CAAC;AAED,SAAgB,WAAW,CAAC,EAAmB;IAC7C,IAAI,OAAO,EAAE,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IACtC,MAAM,CAAC,GAAI,EAAU,CAAC,QAAQ,EAAE,EAAE,IAAI,MAAM,CAAC,EAAE,CAAC,CAAC;IACjD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAgB,aAAa,CAC3B,IAAc,EACd,EAAmB,EACnB,IAAwB,EACxB,IAAwE;IAExE,MAAM,MAAM,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC;IAC/B,OAAO;QACL,EAAE,EAAE,MAAM;QACV,IAAI;QACJ,IAAI;QACJ,KAAK,EAAE,IAAI,EAAE,KAAK;QAClB,WAAW,EAAE,IAAI,EAAE,WAAW;QAC9B,IAAI,EAAE,IAAI,EAAE,IAAI;QAChB,SAAS,EAAE,OAAO,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;KAC7D,CAAC;AAChB,CAAC"}

package/dist/express/docsRouter.d.ts

@@ -0,0 +1,12 @@
+import { Router } from "express";
+import type { IResource } from "../defs";
+type DocsRouterOptions = {
+    getRoot: () => {
+        resource: IResource<any, any, any, any>;
+        config?: any;
+    };
+    includeGlobals?: boolean;
+    enabled?: boolean | (() => boolean);
+};
+export declare function createDocsRouter(options: DocsRouterOptions): Router;
+export {};

package/dist/express/docsRouter.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDocsRouter = createDocsRouter;
+const express_1 = require("express");
+const introspect_1 = require("../docs/introspect");
+function createDocsRouter(options) {
+    const router = express_1.default.Router();
+    const isEnabled = () => {
+        if (typeof options.enabled === "function")
+            return options.enabled();
+        if (typeof options.enabled === "boolean")
+            return options.enabled;
+        return process.env.RUNNER_DOCS === "1";
+    };
+    router.get("/docs.json", async (req, res) => {
+        if (!isEnabled())
+            return res.status(404).end();
+        const { resource, config } = options.getRoot();
+        const graph = await (0, introspect_1.introspectResource)(resource, config ?? {}, {
+            includeGlobals: options.includeGlobals,
+        });
+        res.json(graph);
+    });
+    router.get("/docs", (req, res) => {
+        if (!isEnabled())
+            return res.status(404).end();
+        res.setHeader("content-type", "text/html");
+        res.end(`<!doctype html>
+<html>
+  <head>
+    <meta charset="utf-8" />
+    <title>Runner Docs</title>
+    <style>
+      body { font-family: -apple-system, Segoe UI, Roboto, sans-serif; margin: 2rem; }
+      pre { background: #f6f8fa; padding: 1rem; overflow: auto; }
+    </style>
+  </head>
+  <body>
+    <h1>Runner Docs</h1>
+    <p>This is a minimal viewer. Fetching <code>/docs.json</code> below:</p>
+    <pre id="out">Loading...</pre>
+    <script>
+      fetch('./docs.json').then(r=>r.json()).then(g=>{
+        document.getElementById('out').textContent = JSON.stringify(g, null, 2);
+      }).catch(e=>{
+        document.getElementById('out').textContent = String(e);
+      });
+    </script>
+  </body>
+  </html>`);
+    });
+    return router;
+}
+//# sourceMappingURL=docsRouter.js.map

package/dist/express/docsRouter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docsRouter.js","sourceRoot":"","sources":["../../src/express/docsRouter.ts"],"names":[],"mappings":";;AAUA,4CA8CC;AAxDD,qCAA0C;AAC1C,mDAAwD;AASxD,SAAgB,gBAAgB,CAAC,OAA0B;IACzD,MAAM,MAAM,GAAG,iBAAO,CAAC,MAAM,EAAE,CAAC;IAChC,MAAM,SAAS,GAAG,GAAG,EAAE;QACrB,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,UAAU;YAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QACpE,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,SAAS;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC;QACjE,OAAO,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,GAAG,CAAC;IACzC,CAAC,CAAC;IAEF,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QAC1C,IAAI,CAAC,SAAS,EAAE;YAAE,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;QAC/C,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;QAC/C,MAAM,KAAK,GAAG,MAAM,IAAA,+BAAkB,EAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,EAAE;YAC7D,cAAc,EAAE,OAAO,CAAC,cAAc;SACvC,CAAC,CAAC;QACH,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAC/B,IAAI,CAAC,SAAS,EAAE;YAAE,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;QAC/C,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;QAC3C,GAAG,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;UAsBF,CAAC,CAAC;IACV,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/globals/globalMiddleware.d.ts

@@ -20,4 +20,5 @@ export declare const globalMiddlewares: {
             cacheFactoryTask: import("../defs").ITask<any, Promise<import("./middleware/cache.middleware").ICacheInstance>, any, undefined>;
         }, any>;
     }>;
+    timeout: import("../defs").IMiddleware<import("./middleware/timeout.middleware").TimeoutMiddlewareConfig, import("../defs").DependencyMapType>;
 };

package/dist/globals/globalMiddleware.js

@@ -4,6 +4,7 @@ exports.globalMiddlewares = void 0;
 const cache_middleware_1 = require("./middleware/cache.middleware");
 const requireContext_middleware_1 = require("./middleware/requireContext.middleware");
 const retry_middleware_1 = require("./middleware/retry.middleware");
+const timeout_middleware_1 = require("./middleware/timeout.middleware");
 /**
  * Global middlewares
  */
@@ -11,5 +12,6 @@ exports.globalMiddlewares = {
     requireContext: requireContext_middleware_1.requireContextMiddleware,
     retry: retry_middleware_1.retryMiddleware,
     cache: cache_middleware_1.cacheMiddleware,
+    timeout: timeout_middleware_1.timeoutMiddleware,
 };
 //# sourceMappingURL=globalMiddleware.js.map

package/dist/globals/globalMiddleware.js.map

@@ -1 +1 @@
-{"version":3,"file":"globalMiddleware.js","sourceRoot":"","sources":["../../src/globals/globalMiddleware.ts"],"names":[],"mappings":";;;AAEA,oEAAgE;AAChE,sFAAkF;AAClF,oEAAgE;AAEhE;;GAEG;AACU,QAAA,iBAAiB,GAAG;IAC/B,cAAc,EAAE,oDAAwB;IACxC,KAAK,EAAE,kCAAe;IACtB,KAAK,EAAE,kCAAe;CACvB,CAAC"}
+{"version":3,"file":"globalMiddleware.js","sourceRoot":"","sources":["../../src/globals/globalMiddleware.ts"],"names":[],"mappings":";;;AAEA,oEAAgE;AAChE,sFAAkF;AAClF,oEAAgE;AAChE,wEAAoE;AAEpE;;GAEG;AACU,QAAA,iBAAiB,GAAG;IAC/B,cAAc,EAAE,oDAAwB;IACxC,KAAK,EAAE,kCAAe;IACtB,KAAK,EAAE,kCAAe;IACtB,OAAO,EAAE,sCAAiB;CAC3B,CAAC"}

package/dist/globals/middleware/timeout.middleware.d.ts

@@ -0,0 +1,8 @@
+export interface TimeoutMiddlewareConfig {
+    /**
+     * Maximum time in milliseconds before the wrapped operation is aborted
+     * and a timeout error is thrown. Defaults to 5000ms.
+     */
+    ttl: number;
+}
+export declare const timeoutMiddleware: import("../../defs").IMiddleware<TimeoutMiddlewareConfig, import("../../defs").DependencyMapType>;

package/dist/globals/middleware/timeout.middleware.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.timeoutMiddleware = void 0;
+const define_1 = require("../../define");
+exports.timeoutMiddleware = (0, define_1.defineMiddleware)({
+    id: "globals.middleware.timeout",
+    async run({ task, resource, next }, _deps, config) {
+        const input = task ? task.input : resource?.config;
+        const ttl = Math.max(0, config.ttl);
+        const message = `Operation timed out after ${ttl}ms`;
+        // Fast-path: immediate timeout
+        if (ttl === 0) {
+            const error = new Error(message);
+            error.name = "TimeoutError";
+            throw error;
+        }
+        const controller = new AbortController();
+        // Create a timeout promise that rejects when aborted
+        const timeoutPromise = new Promise((_, reject) => {
+            const timeoutId = setTimeout(() => {
+                controller.abort();
+                const error = new Error(message);
+                error.name = "TimeoutError";
+                reject(error);
+            }, ttl);
+            // Clean up timeout if abort signal fires for other reasons
+            controller.signal.addEventListener("abort", () => {
+                clearTimeout(timeoutId);
+            });
+        });
+        // Race between the actual operation and the timeout
+        return Promise.race([next(input), timeoutPromise]);
+    },
+});
+//# sourceMappingURL=timeout.middleware.js.map

package/dist/globals/middleware/timeout.middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.middleware.js","sourceRoot":"","sources":["../../../src/globals/middleware/timeout.middleware.ts"],"names":[],"mappings":";;;AAAA,yCAAgD;AAUnC,QAAA,iBAAiB,GAAG,IAAA,yBAAgB,EAAC;IAChD,EAAE,EAAE,4BAA4B;IAChC,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,MAA+B;QACxE,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC;QAEnD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;QACpC,MAAM,OAAO,GAAG,6BAA6B,GAAG,IAAI,CAAC;QAErD,+BAA+B;QAC/B,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC;YACd,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;YAChC,KAAa,CAAC,IAAI,GAAG,cAAc,CAAC;YACrC,MAAM,KAAK,CAAC;QACd,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QAEzC,qDAAqD;QACrD,MAAM,cAAc,GAAG,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;YAC/C,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;gBAChC,UAAU,CAAC,KAAK,EAAE,CAAC;gBACnB,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;gBAChC,KAAa,CAAC,IAAI,GAAG,cAAc,CAAC;gBACrC,MAAM,CAAC,KAAK,CAAC,CAAC;YAChB,CAAC,EAAE,GAAG,CAAC,CAAC;YAER,2DAA2D;YAC3D,UAAU,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;gBAC/C,YAAY,CAAC,SAAS,CAAC,CAAC;YAC1B,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,oDAAoD;QACpD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC;IACrD,CAAC;CACF,CAAC,CAAC"}

package/dist/index.d.ts

@@ -1,6 +1,7 @@
-import { defineTask, defineResource, defineEvent, defineMiddleware, defineIndex } from "./define";
+import { defineTask, defineResource, defineEvent, defineMiddleware, defineIndex, defineTag, defineOverride } from "./define";
 import { createContext } from "./context";
 import { run } from "./run";
+import { createTestResource } from "./testing";
 declare const globals: {
     events: {
         beforeInit: import("./defs").IEvent<void>;
@@ -81,9 +82,10 @@ declare const globals: {
                 cacheFactoryTask: import("./defs").ITask<any, Promise<import("./defs").ICacheInstance>, any, undefined>;
             }, any>;
         }>;
+        timeout: import("./defs").IMiddleware<import("./globals/middleware/timeout.middleware").TimeoutMiddlewareConfig, import("./defs").DependencyMapType>;
     };
 };
 export { globals };
-export { defineTask as task, defineResource as resource, defineEvent as event, defineMiddleware as middleware, defineIndex as index, run, createContext, };
+export { defineTask as task, defineResource as resource, defineEvent as event, defineMiddleware as middleware, defineIndex as index, defineTag as tag, defineOverride as override, run, createContext, createTestResource, };
 export * as definitions from "./defs";
 export { Semaphore, Store, EventManager, TaskRunner, Queue } from "./models";