@bluelibs/runner-dev 5.1.0 → 6.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AI.md +80 -6
- package/README.md +216 -22
- package/dist/cli/generators/scaffold/templates/package.json.d.ts +2 -2
- package/dist/cli/generators/scaffold/templates/package.json.js +2 -2
- package/dist/cli/generators/scaffold.js +1 -135
- package/dist/cli/generators/scaffold.js.map +1 -1
- package/dist/cli/generators/templates.js +2 -1
- package/dist/cli/generators/templates.js.map +1 -1
- package/dist/generated/resolvers-types.d.ts +545 -112
- package/dist/index.d.ts +39 -39
- package/dist/resources/cli.config.resource.d.ts +1 -1
- package/dist/resources/cli.config.resource.js +2 -2
- package/dist/resources/cli.config.resource.js.map +1 -1
- package/dist/resources/coverage.resource.d.ts +2 -2
- package/dist/resources/coverage.resource.js +3 -3
- package/dist/resources/coverage.resource.js.map +1 -1
- package/dist/resources/dev.resource.d.ts +1 -1
- package/dist/resources/dev.resource.js +2 -2
- package/dist/resources/dev.resource.js.map +1 -1
- package/dist/resources/docs.generator.resource.d.ts +4 -3
- package/dist/resources/docs.generator.resource.js +2 -2
- package/dist/resources/docs.generator.resource.js.map +1 -1
- package/dist/resources/graphql-accumulator.resource.d.ts +2 -2
- package/dist/resources/graphql-accumulator.resource.js +7 -3
- package/dist/resources/graphql-accumulator.resource.js.map +1 -1
- package/dist/resources/graphql.cli.resource.d.ts +1 -1
- package/dist/resources/graphql.cli.resource.js +2 -2
- package/dist/resources/graphql.cli.resource.js.map +1 -1
- package/dist/resources/graphql.query.cli.task.d.ts +14 -16
- package/dist/resources/graphql.query.cli.task.js +3 -3
- package/dist/resources/graphql.query.cli.task.js.map +1 -1
- package/dist/resources/graphql.query.task.d.ts +18 -18
- package/dist/resources/graphql.query.task.js +4 -4
- package/dist/resources/graphql.query.task.js.map +1 -1
- package/dist/resources/http.tag.d.ts +1 -1
- package/dist/resources/http.tag.js +2 -2
- package/dist/resources/http.tag.js.map +1 -1
- package/dist/resources/introspector.cli.resource.d.ts +2 -2
- package/dist/resources/introspector.cli.resource.js +37 -3
- package/dist/resources/introspector.cli.resource.js.map +1 -1
- package/dist/resources/introspector.resource.d.ts +3 -2
- package/dist/resources/introspector.resource.js +6 -6
- package/dist/resources/introspector.resource.js.map +1 -1
- package/dist/resources/live.resource.d.ts +7 -6
- package/dist/resources/live.resource.js +64 -25
- package/dist/resources/live.resource.js.map +1 -1
- package/dist/resources/models/Introspector.d.ts +59 -15
- package/dist/resources/models/Introspector.js +467 -137
- package/dist/resources/models/Introspector.js.map +1 -1
- package/dist/resources/models/durable.runtime.d.ts +1 -1
- package/dist/resources/models/durable.runtime.js +53 -2
- package/dist/resources/models/durable.runtime.js.map +1 -1
- package/dist/resources/models/durable.tools.d.ts +1 -1
- package/dist/resources/models/durable.tools.js +6 -3
- package/dist/resources/models/durable.tools.js.map +1 -1
- package/dist/resources/models/initializeFromStore.js +126 -19
- package/dist/resources/models/initializeFromStore.js.map +1 -1
- package/dist/resources/models/initializeFromStore.utils.d.ts +12 -7
- package/dist/resources/models/initializeFromStore.utils.js +319 -23
- package/dist/resources/models/initializeFromStore.utils.js.map +1 -1
- package/dist/resources/models/introspector.tools.js +18 -6
- package/dist/resources/models/introspector.tools.js.map +1 -1
- package/dist/resources/routeHandlers/createLiveStreamHandler.d.ts +16 -0
- package/dist/resources/routeHandlers/createLiveStreamHandler.js +127 -0
- package/dist/resources/routeHandlers/createLiveStreamHandler.js.map +1 -0
- package/dist/resources/routeHandlers/getDocsData.d.ts +4 -0
- package/dist/resources/routeHandlers/getDocsData.js +28 -0
- package/dist/resources/routeHandlers/getDocsData.js.map +1 -1
- package/dist/resources/routeHandlers/registerHttpRoutes.hook.d.ts +26 -23
- package/dist/resources/routeHandlers/registerHttpRoutes.hook.js +10 -9
- package/dist/resources/routeHandlers/registerHttpRoutes.hook.js.map +1 -1
- package/dist/resources/routeHandlers/requestCorrelation.d.ts +11 -0
- package/dist/resources/routeHandlers/requestCorrelation.js +29 -0
- package/dist/resources/routeHandlers/requestCorrelation.js.map +1 -0
- package/dist/resources/server.resource.d.ts +20 -20
- package/dist/resources/server.resource.js +17 -5
- package/dist/resources/server.resource.js.map +1 -1
- package/dist/resources/swap.cli.resource.d.ts +4 -4
- package/dist/resources/swap.cli.resource.js +2 -2
- package/dist/resources/swap.cli.resource.js.map +1 -1
- package/dist/resources/swap.resource.d.ts +7 -6
- package/dist/resources/swap.resource.js +188 -38
- package/dist/resources/swap.resource.js.map +1 -1
- package/dist/resources/swap.tools.d.ts +3 -2
- package/dist/resources/swap.tools.js +27 -27
- package/dist/resources/swap.tools.js.map +1 -1
- package/dist/resources/telemetry.resource.d.ts +1 -1
- package/dist/resources/telemetry.resource.js +46 -43
- package/dist/resources/telemetry.resource.js.map +1 -1
- package/dist/runner-compat.d.ts +85 -0
- package/dist/runner-compat.js +178 -0
- package/dist/runner-compat.js.map +1 -0
- package/dist/runner-node-compat.d.ts +2 -0
- package/dist/runner-node-compat.js +28 -0
- package/dist/runner-node-compat.js.map +1 -0
- package/dist/schema/index.js +8 -8
- package/dist/schema/index.js.map +1 -1
- package/dist/schema/model.d.ts +100 -20
- package/dist/schema/model.js.map +1 -1
- package/dist/schema/query.js +25 -1
- package/dist/schema/query.js.map +1 -1
- package/dist/schema/types/AllType.js +13 -2
- package/dist/schema/types/AllType.js.map +1 -1
- package/dist/schema/types/BaseElementCommon.js +10 -0
- package/dist/schema/types/BaseElementCommon.js.map +1 -1
- package/dist/schema/types/ErrorType.js +1 -1
- package/dist/schema/types/ErrorType.js.map +1 -1
- package/dist/schema/types/EventType.js +19 -2
- package/dist/schema/types/EventType.js.map +1 -1
- package/dist/schema/types/InterceptorOwnersType.d.ts +2 -0
- package/dist/schema/types/InterceptorOwnersType.js +63 -0
- package/dist/schema/types/InterceptorOwnersType.js.map +1 -0
- package/dist/schema/types/LaneSummaryTypes.d.ts +3 -0
- package/dist/schema/types/LaneSummaryTypes.js +19 -0
- package/dist/schema/types/LaneSummaryTypes.js.map +1 -0
- package/dist/schema/types/LiveType.js +81 -76
- package/dist/schema/types/LiveType.js.map +1 -1
- package/dist/schema/types/ResourceType.js +101 -15
- package/dist/schema/types/ResourceType.js.map +1 -1
- package/dist/schema/types/RunOptionsType.d.ts +2 -0
- package/dist/schema/types/RunOptionsType.js +107 -0
- package/dist/schema/types/RunOptionsType.js.map +1 -0
- package/dist/schema/types/TagType.js +35 -4
- package/dist/schema/types/TagType.js.map +1 -1
- package/dist/schema/types/TaskType.js +20 -0
- package/dist/schema/types/TaskType.js.map +1 -1
- package/dist/schema/types/index.d.ts +4 -2
- package/dist/schema/types/index.js +10 -7
- package/dist/schema/types/index.js.map +1 -1
- package/dist/schema/types/middleware/common.d.ts +3 -2
- package/dist/schema/types/middleware/common.js +19 -13
- package/dist/schema/types/middleware/common.js.map +1 -1
- package/dist/ui/.vite/manifest.json +2 -2
- package/dist/ui/assets/docs-Btkv97Ls.js +302 -0
- package/dist/ui/assets/docs-Btkv97Ls.js.map +1 -0
- package/dist/ui/assets/docs-CipvKUxZ.css +1 -0
- package/dist/utils/healthCollectors.d.ts +37 -0
- package/dist/utils/healthCollectors.js +147 -0
- package/dist/utils/healthCollectors.js.map +1 -0
- package/dist/utils/lane-resources.d.ts +55 -0
- package/dist/utils/lane-resources.js +143 -0
- package/dist/utils/lane-resources.js.map +1 -0
- package/dist/utils/zod.js +36 -3
- package/dist/utils/zod.js.map +1 -1
- package/dist/version.d.ts +1 -1
- package/dist/version.js +1 -1
- package/package.json +4 -6
- package/readmes/runner-AI.md +740 -0
- package/readmes/runner-durable-workflows.md +2247 -0
- package/readmes/runner-full-guide.md +5869 -0
- package/readmes/runner-remote-lanes.md +909 -0
- package/dist/ui/assets/docs-B_-zFz4-.css +0 -1
- package/dist/ui/assets/docs-Be-GHfZi.js +0 -353
- package/dist/ui/assets/docs-Be-GHfZi.js.map +0 -1
|
@@ -72,7 +72,7 @@ function computeUnemittedEvents(introspector) {
|
|
|
72
72
|
const events = introspector.getEvents();
|
|
73
73
|
return events
|
|
74
74
|
.filter((e) => introspector.getEmittersOfEvent(e.id).length === 0)
|
|
75
|
-
.filter((e) => e.id !== "
|
|
75
|
+
.filter((e) => e.id !== "system.events.ready")
|
|
76
76
|
.filter((e) => e.id !== "*")
|
|
77
77
|
.map((e) => ({ id: e.id }));
|
|
78
78
|
}
|
|
@@ -82,8 +82,8 @@ function computeUnusedMiddleware(introspector) {
|
|
|
82
82
|
.filter((m) => {
|
|
83
83
|
const used = (m.usedByTasks?.length ?? 0) > 0 ||
|
|
84
84
|
(m.usedByResources?.length ?? 0) > 0;
|
|
85
|
-
const
|
|
86
|
-
return !used && !
|
|
85
|
+
const autoApplyEnabled = Boolean(m.autoApply?.enabled);
|
|
86
|
+
return !used && !autoApplyEnabled;
|
|
87
87
|
})
|
|
88
88
|
.map((m) => ({ id: m.id }));
|
|
89
89
|
}
|
|
@@ -166,7 +166,7 @@ function buildDiagnostics(introspector) {
|
|
|
166
166
|
{ kind: "MIDDLEWARE", nodes: introspector.getMiddlewares() },
|
|
167
167
|
];
|
|
168
168
|
for (const e of computeOrphanEvents(introspector)) {
|
|
169
|
-
if (
|
|
169
|
+
if (isIgnoredEventDiagnosticId(e.id))
|
|
170
170
|
continue;
|
|
171
171
|
diags.push({
|
|
172
172
|
severity: "warning",
|
|
@@ -177,7 +177,7 @@ function buildDiagnostics(introspector) {
|
|
|
177
177
|
});
|
|
178
178
|
}
|
|
179
179
|
for (const e of computeUnemittedEvents(introspector)) {
|
|
180
|
-
if (
|
|
180
|
+
if (isIgnoredEventDiagnosticId(e.id))
|
|
181
181
|
continue;
|
|
182
182
|
diags.push({
|
|
183
183
|
severity: "warning",
|
|
@@ -238,7 +238,19 @@ function buildDiagnostics(introspector) {
|
|
|
238
238
|
// System events helpers
|
|
239
239
|
function isSystemEventId(eventId) {
|
|
240
240
|
const id = String(eventId).toLowerCase();
|
|
241
|
-
return id.startsWith("
|
|
241
|
+
return id.startsWith("system.") || id.startsWith("runner.") || id === "*";
|
|
242
|
+
}
|
|
243
|
+
function isIgnoredEventDiagnosticId(eventId) {
|
|
244
|
+
if (isSystemEventId(eventId))
|
|
245
|
+
return true;
|
|
246
|
+
const id = String(eventId).toLowerCase();
|
|
247
|
+
const normalizedId = id.replace(/-/g, ".");
|
|
248
|
+
// Durable workflow runtime emits framework-owned internal events that are not
|
|
249
|
+
// application-level extension points and should not be treated as diagnostics noise.
|
|
250
|
+
return (/(^|\.)durable\.audit\./.test(normalizedId) ||
|
|
251
|
+
/(^|\.)durable\.emit\./.test(normalizedId) ||
|
|
252
|
+
/(^|\.)durable\.execution\./.test(normalizedId) ||
|
|
253
|
+
/(^|\.)durable\.note\./.test(normalizedId));
|
|
242
254
|
}
|
|
243
255
|
// Internal helper to stamp a non-enumerable discriminator used by GraphQL type resolution
|
|
244
256
|
function stampElementKind(obj, kind) {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"introspector.tools.js","sourceRoot":"","sources":["../../../src/resources/models/introspector.tools.ts"],"names":[],"mappings":";;AAKA,gCAIC;AAED,8CASC;AAED,0BAMC;AAED,wBAIC;AAED,8CAQC;AAGD,kDAQC;AAED,wDASC;AAED,0DAaC;AAED,4DA2BC;AAED,8DAkDC;AAED,kDAQC;AAED,4CAoFC;AAGD,0CAGC;
|
|
1
|
+
{"version":3,"file":"introspector.tools.js","sourceRoot":"","sources":["../../../src/resources/models/introspector.tools.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import type { Request, Response } from "express";
|
|
2
|
+
import type { Live } from "../live.resource";
|
|
3
|
+
export interface LiveStreamDeps {
|
|
4
|
+
live: Live;
|
|
5
|
+
}
|
|
6
|
+
/**
|
|
7
|
+
* Creates an Express route handler that streams live telemetry data via
|
|
8
|
+
* Server-Sent Events (SSE). The handler:
|
|
9
|
+
*
|
|
10
|
+
* 1. Subscribes to `live.onRecord()` for near-instant push of new entries.
|
|
11
|
+
* 2. Debounces rapid bursts (100 ms) to avoid flooding the connection.
|
|
12
|
+
* 3. Pushes system health snapshots every 2 s on a separate cadence.
|
|
13
|
+
* 4. Sends heartbeat comments every 15 s to keep proxies from closing idle connections.
|
|
14
|
+
* 5. Cleans up all timers and subscriptions on client disconnect.
|
|
15
|
+
*/
|
|
16
|
+
export declare function createLiveStreamHandler({ live }: LiveStreamDeps): (_req: Request, res: Response) => void;
|
|
@@ -0,0 +1,127 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.createLiveStreamHandler = createLiveStreamHandler;
|
|
4
|
+
const healthCollectors_1 = require("../../utils/healthCollectors");
|
|
5
|
+
/** Debounce interval (ms) for batching rapid record notifications into a single SSE push. */
|
|
6
|
+
const DEBOUNCE_MS = 100;
|
|
7
|
+
/** How often (ms) system health metrics (memory, cpu, eventLoop, gc) are pushed. */
|
|
8
|
+
const HEALTH_INTERVAL_MS = 2_000;
|
|
9
|
+
/** How often (ms) a heartbeat comment is sent to keep the connection alive through proxies. */
|
|
10
|
+
const HEARTBEAT_INTERVAL_MS = 15_000;
|
|
11
|
+
/** Maximum number of entries per category in a single SSE push. */
|
|
12
|
+
const MAX_ENTRIES_PER_PUSH = 1_000;
|
|
13
|
+
// ---------------------------------------------------------------------------
|
|
14
|
+
// Helpers
|
|
15
|
+
// ---------------------------------------------------------------------------
|
|
16
|
+
function safeStringify(value) {
|
|
17
|
+
if (value == null)
|
|
18
|
+
return null;
|
|
19
|
+
if (typeof value === "string")
|
|
20
|
+
return value;
|
|
21
|
+
try {
|
|
22
|
+
return JSON.stringify(value);
|
|
23
|
+
}
|
|
24
|
+
catch {
|
|
25
|
+
return String(value);
|
|
26
|
+
}
|
|
27
|
+
}
|
|
28
|
+
/**
|
|
29
|
+
* Creates an Express route handler that streams live telemetry data via
|
|
30
|
+
* Server-Sent Events (SSE). The handler:
|
|
31
|
+
*
|
|
32
|
+
* 1. Subscribes to `live.onRecord()` for near-instant push of new entries.
|
|
33
|
+
* 2. Debounces rapid bursts (100 ms) to avoid flooding the connection.
|
|
34
|
+
* 3. Pushes system health snapshots every 2 s on a separate cadence.
|
|
35
|
+
* 4. Sends heartbeat comments every 15 s to keep proxies from closing idle connections.
|
|
36
|
+
* 5. Cleans up all timers and subscriptions on client disconnect.
|
|
37
|
+
*/
|
|
38
|
+
function createLiveStreamHandler({ live }) {
|
|
39
|
+
return (_req, res) => {
|
|
40
|
+
// --- SSE headers ---------------------------------------------------------
|
|
41
|
+
res.setHeader("Content-Type", "text/event-stream");
|
|
42
|
+
res.setHeader("Cache-Control", "no-cache");
|
|
43
|
+
res.setHeader("Connection", "keep-alive");
|
|
44
|
+
res.setHeader("X-Accel-Buffering", "no"); // nginx
|
|
45
|
+
res.flushHeaders();
|
|
46
|
+
let cursor = 0; // start from the beginning so the initial push picks up existing entries
|
|
47
|
+
let debounceTimer = null;
|
|
48
|
+
let closed = false;
|
|
49
|
+
// --- Write helpers -------------------------------------------------------
|
|
50
|
+
/** Write a single SSE frame. */
|
|
51
|
+
const sendEvent = (eventName, data) => {
|
|
52
|
+
if (closed)
|
|
53
|
+
return;
|
|
54
|
+
try {
|
|
55
|
+
res.write(`event: ${eventName}\ndata: ${JSON.stringify(data)}\n\n`);
|
|
56
|
+
}
|
|
57
|
+
catch {
|
|
58
|
+
cleanup();
|
|
59
|
+
}
|
|
60
|
+
};
|
|
61
|
+
/** Read new telemetry entries since `cursor`, serialize, and push. */
|
|
62
|
+
const pushDelta = () => {
|
|
63
|
+
if (closed)
|
|
64
|
+
return;
|
|
65
|
+
const query = { afterTimestamp: cursor, last: MAX_ENTRIES_PER_PUSH };
|
|
66
|
+
const logs = live
|
|
67
|
+
.getLogs(query)
|
|
68
|
+
.map((l) => ({ ...l, data: safeStringify(l.data) }));
|
|
69
|
+
const emissions = live
|
|
70
|
+
.getEmissions(query)
|
|
71
|
+
.map((e) => ({ ...e, payload: safeStringify(e.payload) }));
|
|
72
|
+
const errors = live
|
|
73
|
+
.getErrors(query)
|
|
74
|
+
.map((e) => ({ ...e, data: safeStringify(e.data) }));
|
|
75
|
+
const runs = live.getRuns(query);
|
|
76
|
+
if (logs.length + emissions.length + errors.length + runs.length === 0) {
|
|
77
|
+
return;
|
|
78
|
+
}
|
|
79
|
+
// Advance cursor past everything we just delivered
|
|
80
|
+
const latest = (0, healthCollectors_1.latestTimestamp)(logs, emissions, errors, runs);
|
|
81
|
+
if (latest !== undefined)
|
|
82
|
+
cursor = latest;
|
|
83
|
+
sendEvent("telemetry", { logs, emissions, errors, runs });
|
|
84
|
+
};
|
|
85
|
+
/** Debounced notification handler — batches rapid record calls. */
|
|
86
|
+
const onRecordNotification = () => {
|
|
87
|
+
if (closed || debounceTimer)
|
|
88
|
+
return;
|
|
89
|
+
debounceTimer = setTimeout(() => {
|
|
90
|
+
debounceTimer = null;
|
|
91
|
+
pushDelta();
|
|
92
|
+
}, DEBOUNCE_MS);
|
|
93
|
+
};
|
|
94
|
+
// --- Subscriptions & timers ----------------------------------------------
|
|
95
|
+
const unsubscribe = live.onRecord(onRecordNotification);
|
|
96
|
+
const healthTimer = setInterval(() => {
|
|
97
|
+
if (!closed)
|
|
98
|
+
sendEvent("health", (0, healthCollectors_1.getHealthSnapshot)());
|
|
99
|
+
}, HEALTH_INTERVAL_MS);
|
|
100
|
+
const heartbeatTimer = setInterval(() => {
|
|
101
|
+
if (!closed)
|
|
102
|
+
res.write(": heartbeat\n\n");
|
|
103
|
+
}, HEARTBEAT_INTERVAL_MS);
|
|
104
|
+
// --- Initial push --------------------------------------------------------
|
|
105
|
+
sendEvent("health", (0, healthCollectors_1.getHealthSnapshot)());
|
|
106
|
+
pushDelta(); // push any pre-existing entries
|
|
107
|
+
// If nothing existed, advance cursor to now so future pushes are incremental
|
|
108
|
+
if (cursor === 0)
|
|
109
|
+
cursor = Date.now() - 1;
|
|
110
|
+
// --- Cleanup on disconnect -----------------------------------------------
|
|
111
|
+
const cleanup = () => {
|
|
112
|
+
if (closed)
|
|
113
|
+
return;
|
|
114
|
+
closed = true;
|
|
115
|
+
unsubscribe();
|
|
116
|
+
clearInterval(healthTimer);
|
|
117
|
+
clearInterval(heartbeatTimer);
|
|
118
|
+
if (debounceTimer) {
|
|
119
|
+
clearTimeout(debounceTimer);
|
|
120
|
+
debounceTimer = null;
|
|
121
|
+
}
|
|
122
|
+
};
|
|
123
|
+
res.on("close", cleanup);
|
|
124
|
+
res.on("error", cleanup);
|
|
125
|
+
};
|
|
126
|
+
}
|
|
127
|
+
//# sourceMappingURL=createLiveStreamHandler.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"createLiveStreamHandler.js","sourceRoot":"","sources":["../../../src/resources/routeHandlers/createLiveStreamHandler.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,6 +1,10 @@
|
|
|
1
1
|
import express from "express";
|
|
2
2
|
import { Introspector } from "../models/Introspector";
|
|
3
3
|
import { Store } from "@bluelibs/runner";
|
|
4
|
+
export interface DocsContentPayload {
|
|
5
|
+
minimalMd: string;
|
|
6
|
+
completeMd: string;
|
|
7
|
+
}
|
|
4
8
|
export interface DocsRouteConfig {
|
|
5
9
|
uiDir: string;
|
|
6
10
|
store: Store;
|
|
@@ -9,6 +9,32 @@ const promises_1 = __importDefault(require("node:fs/promises"));
|
|
|
9
9
|
const node_path_1 = __importDefault(require("node:path"));
|
|
10
10
|
const help_1 = require("../../mcp/help");
|
|
11
11
|
const durable_runtime_1 = require("../models/durable.runtime");
|
|
12
|
+
async function readDocsAsset(localPath, packageDocPath) {
|
|
13
|
+
const packageDoc = await (0, help_1.readPackageDoc)("@bluelibs/runner-dev", packageDocPath).catch(() => ({ content: "" }));
|
|
14
|
+
const packageContent = packageDoc.content || "";
|
|
15
|
+
if (packageContent) {
|
|
16
|
+
return packageContent;
|
|
17
|
+
}
|
|
18
|
+
try {
|
|
19
|
+
return await promises_1.default.readFile(node_path_1.default.resolve(__dirname, localPath), "utf8");
|
|
20
|
+
}
|
|
21
|
+
catch {
|
|
22
|
+
return "";
|
|
23
|
+
}
|
|
24
|
+
}
|
|
25
|
+
async function readDocsContent() {
|
|
26
|
+
const [minimalMd, completeMd] = await Promise.all([
|
|
27
|
+
readDocsAsset("../../../readmes/runner-AI.md", "readmes/runner-AI.md"),
|
|
28
|
+
readDocsAsset("../../../readmes/runner-full-guide.md", "readmes/runner-full-guide.md"),
|
|
29
|
+
]);
|
|
30
|
+
if (!minimalMd && !completeMd) {
|
|
31
|
+
return undefined;
|
|
32
|
+
}
|
|
33
|
+
return {
|
|
34
|
+
minimalMd,
|
|
35
|
+
completeMd,
|
|
36
|
+
};
|
|
37
|
+
}
|
|
12
38
|
// Serve JSON data for docs UI to fetch client-side
|
|
13
39
|
function createDocsDataRouteHandler(config) {
|
|
14
40
|
return async (req, res) => {
|
|
@@ -84,6 +110,7 @@ function createDocsDataRouteHandler(config) {
|
|
|
84
110
|
// Expose framework and dev docs separately
|
|
85
111
|
const runnerFrameworkMd = runnerFrameworkAiMd || "";
|
|
86
112
|
const runnerDevMd = runnerDevAiMd || "";
|
|
113
|
+
const docsContent = await readDocsContent();
|
|
87
114
|
// Obtain GraphQL SDL if available
|
|
88
115
|
let graphqlSdl;
|
|
89
116
|
try {
|
|
@@ -149,6 +176,7 @@ function createDocsDataRouteHandler(config) {
|
|
|
149
176
|
introspectorData: data,
|
|
150
177
|
runnerFrameworkMd,
|
|
151
178
|
runnerDevMd,
|
|
179
|
+
docsContent,
|
|
152
180
|
projectOverviewMd,
|
|
153
181
|
graphqlSdl,
|
|
154
182
|
});
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"getDocsData.js","sourceRoot":"","sources":["../../../src/resources/routeHandlers/getDocsData.ts"],"names":[],"mappings":";;;;;
|
|
1
|
+
{"version":3,"file":"getDocsData.js","sourceRoot":"","sources":["../../../src/resources/routeHandlers/getDocsData.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,64 +1,67 @@
|
|
|
1
1
|
export declare const registerHttpRoutes: import("@bluelibs/runner").IHook<{
|
|
2
|
-
store: import("@bluelibs/runner").IResource<void, Promise<import("@bluelibs/runner").Store>, {}, any, any, import("@bluelibs/runner").
|
|
2
|
+
store: import("@bluelibs/runner").IResource<void, Promise<import("@bluelibs/runner").Store>, {}, any, any, import("@bluelibs/runner").ResourceTagType[], import("@bluelibs/runner").ResourceMiddlewareAttachmentType[]>;
|
|
3
3
|
server: import("@bluelibs/runner").IResource<import("../server.resource").ServerConfig, Promise<import("../server.resource").ServerInstance>, {
|
|
4
|
-
store: import("@bluelibs/runner").IResource<void, Promise<import("@bluelibs/runner").Store>, {}, any, any, import("@bluelibs/runner").
|
|
5
|
-
logger: import("@bluelibs/runner").IResource<void, Promise<import("@bluelibs/runner").Logger>, {}, any, any, import("@bluelibs/runner").
|
|
4
|
+
store: import("@bluelibs/runner").IResource<void, Promise<import("@bluelibs/runner").Store>, {}, any, any, import("@bluelibs/runner").ResourceTagType[], import("@bluelibs/runner").ResourceMiddlewareAttachmentType[]>;
|
|
5
|
+
logger: import("@bluelibs/runner").IResource<void, Promise<import("@bluelibs/runner").Logger>, {}, any, any, import("@bluelibs/runner").ResourceTagType[], import("@bluelibs/runner").ResourceMiddlewareAttachmentType[]>;
|
|
6
6
|
introspector: import("@bluelibs/runner").IResource<void, Promise<import("../..").Introspector>, {
|
|
7
|
-
store: import("@bluelibs/runner").IResource<void, Promise<import("@bluelibs/runner").Store>, {}, any, any, import("@bluelibs/runner").
|
|
7
|
+
store: import("@bluelibs/runner").IResource<void, Promise<import("@bluelibs/runner").Store>, {}, any, any, import("@bluelibs/runner").ResourceTagType[], import("@bluelibs/runner").ResourceMiddlewareAttachmentType[]>;
|
|
8
|
+
runtime: import("@bluelibs/runner").IResource<void, Promise<import("@bluelibs/runner").RunResult<unknown>>, {}, any, any, import("@bluelibs/runner").ResourceTagType[], import("@bluelibs/runner").ResourceMiddlewareAttachmentType[]>;
|
|
8
9
|
}, any, {
|
|
9
10
|
title: string;
|
|
10
11
|
description: string;
|
|
11
|
-
}, import("@bluelibs/runner").
|
|
12
|
+
}, import("@bluelibs/runner").ResourceTagType[], import("@bluelibs/runner").ResourceMiddlewareAttachmentType[]>;
|
|
12
13
|
live: import("@bluelibs/runner").IResource<{
|
|
13
14
|
maxEntries?: number;
|
|
14
15
|
}, Promise<import("../live.resource").Live>, {
|
|
15
16
|
liveService: import("@bluelibs/runner").IResource<{
|
|
16
17
|
maxEntries?: number;
|
|
17
18
|
}, Promise<import("../live.resource").Live>, {
|
|
18
|
-
store: import("@bluelibs/runner").IResource<void, Promise<import("@bluelibs/runner").Store>, {}, any, any, import("@bluelibs/runner").
|
|
19
|
+
store: import("@bluelibs/runner").IResource<void, Promise<import("@bluelibs/runner").Store>, {}, any, any, import("@bluelibs/runner").ResourceTagType[], import("@bluelibs/runner").ResourceMiddlewareAttachmentType[]>;
|
|
19
20
|
}, any, {
|
|
20
21
|
title: string;
|
|
21
22
|
description: string;
|
|
22
|
-
}, import("@bluelibs/runner").
|
|
23
|
-
|
|
24
|
-
}, void, void>[], import("@bluelibs/runner").ResourceMiddlewareAttachmentType[]>;
|
|
25
|
-
logger: import("@bluelibs/runner").IResource<void, Promise<import("@bluelibs/runner").Logger>, {}, any, any, import("@bluelibs/runner").TagType[], import("@bluelibs/runner").ResourceMiddlewareAttachmentType[]>;
|
|
23
|
+
}, import("@bluelibs/runner").ResourceTagType[], import("@bluelibs/runner").ResourceMiddlewareAttachmentType[]>;
|
|
24
|
+
logger: import("@bluelibs/runner").IResource<void, Promise<import("@bluelibs/runner").Logger>, {}, any, any, import("@bluelibs/runner").ResourceTagType[], import("@bluelibs/runner").ResourceMiddlewareAttachmentType[]>;
|
|
26
25
|
}, any, {
|
|
27
26
|
title: string;
|
|
28
27
|
description: string;
|
|
29
|
-
}, import("@bluelibs/runner").
|
|
28
|
+
}, import("@bluelibs/runner").ResourceTagType[], import("@bluelibs/runner").ResourceMiddlewareAttachmentType[]>;
|
|
30
29
|
swapManager: import("@bluelibs/runner").IResource<void, Promise<import("../swap.resource").ISwapManager>, {
|
|
31
|
-
store: import("@bluelibs/runner").IResource<void, Promise<import("@bluelibs/runner").Store>, {}, any, any, import("@bluelibs/runner").
|
|
32
|
-
taskRunner: import("@bluelibs/runner").IResource<void, Promise<import("@bluelibs/runner").TaskRunner>, {}, any, any, import("@bluelibs/runner").
|
|
30
|
+
store: import("@bluelibs/runner").IResource<void, Promise<import("@bluelibs/runner").Store>, {}, any, any, import("@bluelibs/runner").ResourceTagType[], import("@bluelibs/runner").ResourceMiddlewareAttachmentType[]>;
|
|
31
|
+
taskRunner: import("@bluelibs/runner").IResource<void, Promise<import("@bluelibs/runner").TaskRunner>, {}, any, any, import("@bluelibs/runner").ResourceTagType[], import("@bluelibs/runner").ResourceMiddlewareAttachmentType[]>;
|
|
33
32
|
introspector: import("@bluelibs/runner").IResource<void, Promise<import("../..").Introspector>, {
|
|
34
|
-
store: import("@bluelibs/runner").IResource<void, Promise<import("@bluelibs/runner").Store>, {}, any, any, import("@bluelibs/runner").
|
|
33
|
+
store: import("@bluelibs/runner").IResource<void, Promise<import("@bluelibs/runner").Store>, {}, any, any, import("@bluelibs/runner").ResourceTagType[], import("@bluelibs/runner").ResourceMiddlewareAttachmentType[]>;
|
|
34
|
+
runtime: import("@bluelibs/runner").IResource<void, Promise<import("@bluelibs/runner").RunResult<unknown>>, {}, any, any, import("@bluelibs/runner").ResourceTagType[], import("@bluelibs/runner").ResourceMiddlewareAttachmentType[]>;
|
|
35
35
|
}, any, {
|
|
36
36
|
title: string;
|
|
37
37
|
description: string;
|
|
38
|
-
}, import("@bluelibs/runner").
|
|
39
|
-
eventManager: import("@bluelibs/runner").IResource<void, Promise<import("@bluelibs/runner").EventManager>, {}, any, any, import("@bluelibs/runner").
|
|
38
|
+
}, import("@bluelibs/runner").ResourceTagType[], import("@bluelibs/runner").ResourceMiddlewareAttachmentType[]>;
|
|
39
|
+
eventManager: import("@bluelibs/runner").IResource<void, Promise<import("@bluelibs/runner").EventManager>, {}, any, any, import("@bluelibs/runner").ResourceTagType[], import("@bluelibs/runner").ResourceMiddlewareAttachmentType[]>;
|
|
40
40
|
}, any, {
|
|
41
41
|
title: string;
|
|
42
42
|
description: string;
|
|
43
|
-
}, import("@bluelibs/runner").
|
|
43
|
+
}, import("@bluelibs/runner").ResourceTagType[], import("@bluelibs/runner").ResourceMiddlewareAttachmentType[]>;
|
|
44
44
|
graphql: import("@bluelibs/runner").IResource<void, Promise<{
|
|
45
45
|
getSchema: () => import("graphql").GraphQLSchema;
|
|
46
46
|
}>, {}, any, {
|
|
47
47
|
title: string;
|
|
48
48
|
description: string;
|
|
49
|
-
}, import("@bluelibs/runner").
|
|
49
|
+
}, import("@bluelibs/runner").ResourceTagType[], import("@bluelibs/runner").ResourceMiddlewareAttachmentType[]>;
|
|
50
50
|
coverage: import("@bluelibs/runner").IResource<void, Promise<import("../coverage.resource").CoverageService>, {
|
|
51
|
-
store: import("@bluelibs/runner").IResource<void, Promise<import("@bluelibs/runner").Store>, {}, any, any, import("@bluelibs/runner").
|
|
51
|
+
store: import("@bluelibs/runner").IResource<void, Promise<import("@bluelibs/runner").Store>, {}, any, any, import("@bluelibs/runner").ResourceTagType[], import("@bluelibs/runner").ResourceMiddlewareAttachmentType[]>;
|
|
52
52
|
}, any, {
|
|
53
53
|
title: string;
|
|
54
54
|
description: string;
|
|
55
|
-
}, import("@bluelibs/runner").
|
|
55
|
+
}, import("@bluelibs/runner").ResourceTagType[], import("@bluelibs/runner").ResourceMiddlewareAttachmentType[]>;
|
|
56
56
|
}, any, {
|
|
57
57
|
title: string;
|
|
58
58
|
description: string;
|
|
59
|
-
}, import("@bluelibs/runner").
|
|
60
|
-
taskRunner: import("@bluelibs/runner").IResource<void, Promise<import("@bluelibs/runner").TaskRunner>, {}, any, any, import("@bluelibs/runner").
|
|
61
|
-
}, import("@bluelibs/runner").IEvent<void
|
|
59
|
+
}, import("@bluelibs/runner").ResourceTagType[], import("@bluelibs/runner").ResourceMiddlewareAttachmentType[]>;
|
|
60
|
+
taskRunner: import("@bluelibs/runner").IResource<void, Promise<import("@bluelibs/runner").TaskRunner>, {}, any, any, import("@bluelibs/runner").ResourceTagType[], import("@bluelibs/runner").ResourceMiddlewareAttachmentType[]>;
|
|
61
|
+
}, import("@bluelibs/runner").IEvent<void> & {
|
|
62
|
+
parallel?: boolean | undefined;
|
|
63
|
+
transactional?: boolean | undefined;
|
|
64
|
+
}, {
|
|
62
65
|
title: string;
|
|
63
66
|
description: string;
|
|
64
67
|
}>;
|
|
@@ -4,26 +4,27 @@ exports.registerHttpRoutes = void 0;
|
|
|
4
4
|
const runner_1 = require("@bluelibs/runner");
|
|
5
5
|
const http_tag_1 = require("../http.tag");
|
|
6
6
|
const server_resource_1 = require("../server.resource");
|
|
7
|
-
exports.registerHttpRoutes = (0, runner_1.
|
|
8
|
-
id: "runner-dev
|
|
7
|
+
exports.registerHttpRoutes = (0, runner_1.defineHook)({
|
|
8
|
+
id: "runner-dev-hooks-registerHttpRoutes",
|
|
9
9
|
meta: {
|
|
10
10
|
title: "HTTP Routes Registration",
|
|
11
11
|
description: "Automatically registers Express HTTP routes for tasks tagged with httpTag when the application becomes ready",
|
|
12
12
|
},
|
|
13
|
-
on: runner_1.
|
|
13
|
+
on: runner_1.events.ready,
|
|
14
14
|
dependencies: {
|
|
15
|
-
store: runner_1.
|
|
15
|
+
store: runner_1.resources.store,
|
|
16
16
|
server: server_resource_1.serverResource,
|
|
17
|
-
taskRunner: runner_1.
|
|
17
|
+
taskRunner: runner_1.resources.taskRunner,
|
|
18
18
|
},
|
|
19
19
|
async run(_e, { store, server, taskRunner }) {
|
|
20
|
-
const
|
|
21
|
-
if (
|
|
20
|
+
const taggedTasks = store.getTagAccessor(http_tag_1.httpTag).tasks;
|
|
21
|
+
if (taggedTasks.length === 0)
|
|
22
22
|
return;
|
|
23
23
|
// Access express app exposed by server resource
|
|
24
24
|
const app = server.app;
|
|
25
|
-
for (const task of
|
|
26
|
-
|
|
25
|
+
for (const { definition: task, config: cfg } of taggedTasks) {
|
|
26
|
+
if (!cfg)
|
|
27
|
+
continue;
|
|
27
28
|
const method = cfg.method;
|
|
28
29
|
const path = cfg.path;
|
|
29
30
|
if (!method || !path)
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"registerHttpRoutes.hook.js","sourceRoot":"","sources":["../../../src/resources/routeHandlers/registerHttpRoutes.hook.ts"],"names":[],"mappings":";;;AACA,
|
|
1
|
+
{"version":3,"file":"registerHttpRoutes.hook.js","sourceRoot":"","sources":["../../../src/resources/routeHandlers/registerHttpRoutes.hook.ts"],"names":[],"mappings":";;;AACA,6CAAiE;AACjE,0CAAsC;AACtC,wDAAoD;AAEvC,QAAA,kBAAkB,GAAG,IAAA,mBAAU,EAAC;IAC3C,EAAE,EAAE,qCAAqC;IACzC,IAAI,EAAE;QACJ,KAAK,EAAE,0BAA0B;QACjC,WAAW,EACT,8GAA8G;KACjH;IACD,EAAE,EAAE,eAAM,CAAC,KAAK;IAChB,YAAY,EAAE;QACZ,KAAK,EAAE,kBAAS,CAAC,KAAK;QACtB,MAAM,EAAE,gCAAc;QACtB,UAAU,EAAE,kBAAS,CAAC,UAAU;KACjC;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE;QACzC,MAAM,WAAW,GAAG,KAAK,CAAC,cAAc,CAAC,kBAAO,CAAC,CAAC,KAAK,CAAC;QACxD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAErC,gDAAgD;QAChD,MAAM,GAAG,GAAoB,MAAM,CAAC,GAAG,CAAC;QAExC,KAAK,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,WAAW,EAAE,CAAC;YAC5D,IAAI,CAAC,GAAG;gBAAE,SAAS;YACnB,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;YAC1B,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;YACtB,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI;gBAAE,SAAS;YAC/B,MAAM,OAAO,GAAG,KAAK,EAAE,GAAoB,EAAE,GAAqB,EAAE,EAAE;gBACpE,IAAI,CAAC;oBACH,4CAA4C;oBAC5C,MAAM,KAAK,GAAG;wBACZ,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;wBACnB,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC;wBACrB,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;qBACrB,CAAC;oBACF,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;oBACjD,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACnB,CAAC;gBAAC,OAAO,GAAQ,EAAE,CAAC;oBAClB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,IAAI,gBAAgB,EAAE,CAAC,CAAC;gBACpE,CAAC;YACH,CAAC,CAAC;YACD,GAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import type { Request, Response, NextFunction } from "express";
|
|
2
|
+
/**
|
|
3
|
+
* Express middleware that wraps each incoming request in an AsyncLocalStorage
|
|
4
|
+
* context carrying a fresh `correlationId`. This ensures all logs, emissions,
|
|
5
|
+
* errors, and runs recorded during the request automatically inherit a traceId
|
|
6
|
+
* — even when the code is not inside a task/hook execution.
|
|
7
|
+
*
|
|
8
|
+
* If a context already exists (e.g. a task triggered the request internally),
|
|
9
|
+
* the existing correlationId is preserved.
|
|
10
|
+
*/
|
|
11
|
+
export declare function createRequestCorrelationMiddleware(): (req: Request, _res: Response, next: NextFunction) => void;
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.createRequestCorrelationMiddleware = createRequestCorrelationMiddleware;
|
|
4
|
+
const node_crypto_1 = require("node:crypto");
|
|
5
|
+
const telemetry_chain_1 = require("../telemetry.chain");
|
|
6
|
+
/**
|
|
7
|
+
* Express middleware that wraps each incoming request in an AsyncLocalStorage
|
|
8
|
+
* context carrying a fresh `correlationId`. This ensures all logs, emissions,
|
|
9
|
+
* errors, and runs recorded during the request automatically inherit a traceId
|
|
10
|
+
* — even when the code is not inside a task/hook execution.
|
|
11
|
+
*
|
|
12
|
+
* If a context already exists (e.g. a task triggered the request internally),
|
|
13
|
+
* the existing correlationId is preserved.
|
|
14
|
+
*/
|
|
15
|
+
function createRequestCorrelationMiddleware() {
|
|
16
|
+
return (req, _res, next) => {
|
|
17
|
+
const existing = telemetry_chain_1.runContext.getStore();
|
|
18
|
+
if (existing) {
|
|
19
|
+
// Already inside a run context — don't override
|
|
20
|
+
return next();
|
|
21
|
+
}
|
|
22
|
+
const raw = req.headers["x-correlation-id"];
|
|
23
|
+
const correlationId = (Array.isArray(raw) ? raw[0] : raw) || (0, node_crypto_1.randomUUID)();
|
|
24
|
+
telemetry_chain_1.runContext.run({ chain: [], correlationId }, () => {
|
|
25
|
+
next();
|
|
26
|
+
});
|
|
27
|
+
};
|
|
28
|
+
}
|
|
29
|
+
//# sourceMappingURL=requestCorrelation.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"requestCorrelation.js","sourceRoot":"","sources":["../../../src/resources/routeHandlers/requestCorrelation.ts"],"names":[],"mappings":";;AAaA,gFAeC;AA3BD,6CAAyC;AACzC,wDAAgD;AAEhD;;;;;;;;GAQG;AACH,SAAgB,kCAAkC;IAChD,OAAO,CAAC,GAAY,EAAE,IAAc,EAAE,IAAkB,EAAE,EAAE;QAC1D,MAAM,QAAQ,GAAG,4BAAU,CAAC,QAAQ,EAAE,CAAC;QACvC,IAAI,QAAQ,EAAE,CAAC;YACb,gDAAgD;YAChD,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC;QAED,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;QAC5C,MAAM,aAAa,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,IAAA,wBAAU,GAAE,CAAC;QAE1E,4BAAU,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,GAAG,EAAE;YAChD,IAAI,EAAE,CAAC;QACT,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}
|