opencode-windows-scheduler 1.1.0 → 1.2.1
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/CHANGELOG.md +60 -1
- package/README.md +18 -8
- package/README.ru.md +13 -3
- package/ROADMAP-STRATEGY.md +2 -2
- package/ROADMAP.md +51 -18
- package/dist/core/analytics.d.ts +10 -0
- package/dist/core/analytics.d.ts.map +1 -1
- package/dist/core/analytics.js +21 -0
- package/dist/core/dry-run.d.ts +18 -1
- package/dist/core/dry-run.d.ts.map +1 -1
- package/dist/core/dry-run.js +49 -3
- package/dist/core/matrix.d.ts.map +1 -1
- package/dist/core/matrix.js +10 -0
- package/dist/core/one-shot.d.ts +62 -0
- package/dist/core/one-shot.d.ts.map +1 -0
- package/dist/core/one-shot.js +126 -0
- package/dist/core/otel.d.ts +4 -0
- package/dist/core/otel.d.ts.map +1 -0
- package/dist/core/otel.js +98 -0
- package/dist/core/prometheus.d.ts +23 -0
- package/dist/core/prometheus.d.ts.map +1 -0
- package/dist/core/prometheus.js +146 -0
- package/dist/core/ps-wrapper.d.ts +36 -2
- package/dist/core/ps-wrapper.d.ts.map +1 -1
- package/dist/core/ps-wrapper.js +124 -4
- package/dist/core/record-history.d.ts.map +1 -1
- package/dist/core/record-history.js +9 -0
- package/dist/core/schedule-gate.d.ts +2 -0
- package/dist/core/schedule-gate.d.ts.map +1 -0
- package/dist/core/schedule-gate.js +182 -0
- package/dist/core/schedule-v2.d.ts +88 -0
- package/dist/core/schedule-v2.d.ts.map +1 -0
- package/dist/core/schedule-v2.js +496 -0
- package/dist/core/scheduler/linux.d.ts +12 -3
- package/dist/core/scheduler/linux.d.ts.map +1 -1
- package/dist/core/scheduler/linux.js +80 -3
- package/dist/core/scheduler/mac.d.ts.map +1 -1
- package/dist/core/scheduler/mac.js +17 -3
- package/dist/core/scheduler/posix.d.ts.map +1 -1
- package/dist/core/scheduler/posix.js +3 -0
- package/dist/core/scheduler/registry.d.ts +4 -0
- package/dist/core/scheduler/registry.d.ts.map +1 -1
- package/dist/core/scheduler/types.d.ts +20 -3
- package/dist/core/scheduler/types.d.ts.map +1 -1
- package/dist/core/scheduler/windows.d.ts.map +1 -1
- package/dist/core/scheduler/windows.js +23 -2
- package/dist/core/session.d.ts +34 -0
- package/dist/core/session.d.ts.map +1 -0
- package/dist/core/session.js +105 -0
- package/dist/core/structured-log.d.ts +84 -0
- package/dist/core/structured-log.d.ts.map +1 -0
- package/dist/core/structured-log.js +137 -0
- package/dist/core/wrappers/bash.d.ts +24 -0
- package/dist/core/wrappers/bash.d.ts.map +1 -1
- package/dist/core/wrappers/bash.js +70 -3
- package/dist/db/history-repo.d.ts +8 -0
- package/dist/db/history-repo.d.ts.map +1 -1
- package/dist/db/history-repo.js +76 -6
- package/dist/db/metrics-repo.d.ts +3 -0
- package/dist/db/metrics-repo.d.ts.map +1 -1
- package/dist/db/metrics-repo.js +16 -8
- package/dist/db/migrate.d.ts.map +1 -1
- package/dist/db/migrate.js +8 -1
- package/dist/db/schema.d.ts +1 -1
- package/dist/db/schema.d.ts.map +1 -1
- package/dist/db/schema.js +19 -0
- package/dist/gui-experimental.cjs +1 -0
- package/dist/history.d.ts +7 -0
- package/dist/history.d.ts.map +1 -1
- package/dist/history.js +13 -0
- package/dist/index.d.ts +137 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1323 -78
- package/dist/integrations.d.ts +64 -0
- package/dist/integrations.d.ts.map +1 -0
- package/dist/integrations.js +205 -0
- package/dist/notifications.d.ts +112 -6
- package/dist/notifications.d.ts.map +1 -1
- package/dist/notifications.js +396 -34
- package/dist/profiles.d.ts +60 -0
- package/dist/profiles.d.ts.map +1 -0
- package/dist/profiles.js +209 -0
- package/dist/rpc.d.ts +592 -4
- package/dist/rpc.d.ts.map +1 -1
- package/dist/rpc.js +233 -6
- package/dist/server.d.ts +2 -0
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +473 -58
- package/dist/settings.d.ts +95 -0
- package/dist/settings.d.ts.map +1 -1
- package/dist/settings.js +186 -8
- package/dist/shared/jobs-view.d.ts +43 -5
- package/dist/shared/jobs-view.d.ts.map +1 -1
- package/dist/shared/jobs-view.js +125 -7
- package/dist/task-transfer.d.ts +32 -3
- package/dist/task-transfer.d.ts.map +1 -1
- package/dist/task-transfer.js +101 -3
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +3 -11
- package/dist/workspaces.d.ts +43 -0
- package/dist/workspaces.d.ts.map +1 -1
- package/dist/workspaces.js +174 -8
- package/docs/ARCHITECTURE.md +32 -12
- package/docs/FEATURES.md +186 -10
- package/gui-experimental.cjs +4 -2
- package/package.json +15 -2
- package/scripts/demo-dashboard.mjs +12 -2
- package/src/core/analytics.ts +36 -0
- package/src/core/dry-run.ts +65 -4
- package/src/core/matrix.ts +10 -0
- package/src/core/one-shot.ts +173 -0
- package/src/core/otel.ts +128 -0
- package/src/core/prometheus.ts +215 -0
- package/src/core/ps-wrapper.ts +144 -4
- package/src/core/record-history.ts +13 -0
- package/src/core/schedule-gate.ts +213 -0
- package/src/core/schedule-v2.ts +533 -0
- package/src/core/scheduler/linux.ts +90 -3
- package/src/core/scheduler/mac.ts +35 -4
- package/src/core/scheduler/posix.ts +3 -0
- package/src/core/scheduler/registry.ts +4 -0
- package/src/core/scheduler/types.ts +20 -3
- package/src/core/scheduler/windows.ts +24 -2
- package/src/core/session.ts +115 -0
- package/src/core/structured-log.ts +205 -0
- package/src/core/wrappers/bash.ts +98 -2
- package/src/db/history-repo.ts +90 -7
- package/src/db/metrics-repo.ts +19 -7
- package/src/db/migrate.ts +7 -1
- package/src/db/schema.ts +25 -0
- package/src/gui.tsx +3832 -2868
- package/src/history.ts +17 -0
- package/src/index.ts +1670 -117
- package/src/integrations.ts +253 -0
- package/src/notifications.ts +516 -40
- package/src/profiles.ts +236 -0
- package/src/rpc.ts +244 -6
- package/src/server.ts +506 -58
- package/src/settings.ts +336 -9
- package/src/shared/jobs-view.ts +158 -8
- package/src/task-transfer.ts +151 -5
- package/src/tui.tsx +290 -14
- package/src/types.ts +3 -13
- package/src/workspaces.ts +214 -8
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
import type http from "node:http";
|
|
2
|
+
import type { HookSettings } from "./settings.js";
|
|
3
|
+
type HeaderMap = Record<string, string | string[] | undefined>;
|
|
4
|
+
/** Сравнение строк без утечки длины через раннее завершение. */
|
|
5
|
+
export declare function timingSafeStringEqual(expected: string, provided: string): boolean;
|
|
6
|
+
/** Проверяет токен из query-параметра или заголовка. */
|
|
7
|
+
export declare function verifyHookToken(expected: string, provided: string | null): boolean;
|
|
8
|
+
/** Считает HMAC-SHA256 по сырому телу и возвращает значение в формате `sha256=<hex>`. */
|
|
9
|
+
export declare function signHookPayload(secret: string, body: Buffer | string): string;
|
|
10
|
+
/** Достаёт подпись из поддерживаемых заголовков. */
|
|
11
|
+
export declare function extractHookSignature(headers: HeaderMap): string | null;
|
|
12
|
+
/** Достаёт токен из поддерживаемых заголовков (если нет query-параметра). */
|
|
13
|
+
export declare function extractHookToken(headers: HeaderMap): string | null;
|
|
14
|
+
/**
|
|
15
|
+
* Проверяет HMAC-подпись. Принимает `sha256=<hex>` и «голый» hex;
|
|
16
|
+
* алгоритмы кроме SHA-256 намеренно не поддерживаются.
|
|
17
|
+
*/
|
|
18
|
+
export declare function verifyHookSignature(secret: string, body: Buffer | string, signature: string | null): boolean;
|
|
19
|
+
/**
|
|
20
|
+
* Проверяет необязательный timestamp против текущего времени.
|
|
21
|
+
* 0 в настройках — проверка выключена. Без заголовка запрос разрешён.
|
|
22
|
+
*/
|
|
23
|
+
export declare function verifyHookTimestamp(value: string | null, toleranceSeconds: number, nowMs?: number): {
|
|
24
|
+
ok: boolean;
|
|
25
|
+
reason?: string;
|
|
26
|
+
};
|
|
27
|
+
export interface HookAuthInput {
|
|
28
|
+
settings: HookSettings;
|
|
29
|
+
token: string | null;
|
|
30
|
+
signature: string | null;
|
|
31
|
+
timestamp: string | null;
|
|
32
|
+
/** Сырое тело запроса — ровно те байты, по которым считался HMAC. */
|
|
33
|
+
body: Buffer;
|
|
34
|
+
/** Текущее время (для тестов). */
|
|
35
|
+
nowMs?: number;
|
|
36
|
+
}
|
|
37
|
+
export interface HookAuthResult {
|
|
38
|
+
ok: boolean;
|
|
39
|
+
/** HTTP-статус для отказа (200 при успехе). */
|
|
40
|
+
status: number;
|
|
41
|
+
error?: string;
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
* Полная проверка входящего хука: включён ли канал, токен, HMAC, timestamp.
|
|
45
|
+
* Возвращает понятную ошибку на русском для ответа и логов.
|
|
46
|
+
*/
|
|
47
|
+
export declare function authenticateHookRequest(input: HookAuthInput): HookAuthResult;
|
|
48
|
+
export type BodyReadResult = {
|
|
49
|
+
ok: true;
|
|
50
|
+
body: Buffer;
|
|
51
|
+
} | {
|
|
52
|
+
ok: false;
|
|
53
|
+
status: number;
|
|
54
|
+
error: string;
|
|
55
|
+
};
|
|
56
|
+
/**
|
|
57
|
+
* Читает тело запроса с ограничением размера.
|
|
58
|
+
*
|
|
59
|
+
* Лишние байты не накапливаются в памяти: после превышения лимита поток
|
|
60
|
+
* дочитывается и отбрасывается, чтобы клиент получил внятный 413, а не reset.
|
|
61
|
+
*/
|
|
62
|
+
export declare function readRequestBody(req: http.IncomingMessage, maxBytes: number): Promise<BodyReadResult>;
|
|
63
|
+
export {};
|
|
64
|
+
//# sourceMappingURL=integrations.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"integrations.d.ts","sourceRoot":"","sources":["../src/integrations.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AA2BlD,KAAK,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;AAQ/D,gEAAgE;AAChE,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAOjF;AAED,wDAAwD;AACxD,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAElF;AAED,yFAAyF;AACzF,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAI7E;AAED,oDAAoD;AACpD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAMtE;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAMlE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,SAAS,EAAE,MAAM,GAAG,IAAI,GACvB,OAAO,CAUT;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,gBAAgB,EAAE,MAAM,EACxB,KAAK,SAAa,GACjB;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAoBlC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,aAAa,GAAG,cAAc,CA2C5E;AAED,MAAM,MAAM,cAAc,GACtB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC1B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,CAAC,CA6CzB"}
|
|
@@ -0,0 +1,205 @@
|
|
|
1
|
+
import crypto from "node:crypto";
|
|
2
|
+
/**
|
|
3
|
+
* Входящие webhook-триггеры (Спринт 22).
|
|
4
|
+
*
|
|
5
|
+
* Контракт:
|
|
6
|
+
* POST /api/hooks/<task>?token=<token>
|
|
7
|
+
* X-Scheduler-Signature: sha256=<hex hmac по сырому телу>
|
|
8
|
+
* X-Scheduler-Timestamp: <unix seconds|milliseconds> (необязательно)
|
|
9
|
+
*
|
|
10
|
+
* Для совместимости с GitHub Actions принимается также `X-Hub-Signature-256`,
|
|
11
|
+
* для GitLab — `X-Gitlab-Token` вместо query-параметра.
|
|
12
|
+
*
|
|
13
|
+
* HMAC считается по **сырому телу** запроса (без нормализации JSON), поэтому
|
|
14
|
+
* отправитель должен подписывать ровно те байты, которые кладёт в body.
|
|
15
|
+
*/
|
|
16
|
+
/** Заголовки, в которых может прийти HMAC-подпись. */
|
|
17
|
+
const SIGNATURE_HEADERS = [
|
|
18
|
+
"x-scheduler-signature",
|
|
19
|
+
"x-hub-signature-256",
|
|
20
|
+
"x-signature-256",
|
|
21
|
+
];
|
|
22
|
+
/** Заголовки, в которых может прийти токен (альтернатива query-параметру). */
|
|
23
|
+
const TOKEN_HEADERS = ["x-scheduler-token", "x-gitlab-token"];
|
|
24
|
+
/** Первое значение заголовка (Node может вернуть массив). */
|
|
25
|
+
function firstHeader(value) {
|
|
26
|
+
if (Array.isArray(value))
|
|
27
|
+
return value.length > 0 ? String(value[0]) : null;
|
|
28
|
+
return typeof value === "string" && value.trim() ? value.trim() : null;
|
|
29
|
+
}
|
|
30
|
+
/** Сравнение строк без утечки длины через раннее завершение. */
|
|
31
|
+
export function timingSafeStringEqual(expected, provided) {
|
|
32
|
+
if (typeof expected !== "string" || typeof provided !== "string")
|
|
33
|
+
return false;
|
|
34
|
+
if (!expected || !provided)
|
|
35
|
+
return false;
|
|
36
|
+
const expectedHash = crypto.createHash("sha256").update(expected, "utf8").digest();
|
|
37
|
+
const providedHash = crypto.createHash("sha256").update(provided, "utf8").digest();
|
|
38
|
+
const equal = crypto.timingSafeEqual(expectedHash, providedHash);
|
|
39
|
+
return equal && expected.length === provided.length;
|
|
40
|
+
}
|
|
41
|
+
/** Проверяет токен из query-параметра или заголовка. */
|
|
42
|
+
export function verifyHookToken(expected, provided) {
|
|
43
|
+
return typeof provided === "string" && timingSafeStringEqual(expected, provided);
|
|
44
|
+
}
|
|
45
|
+
/** Считает HMAC-SHA256 по сырому телу и возвращает значение в формате `sha256=<hex>`. */
|
|
46
|
+
export function signHookPayload(secret, body) {
|
|
47
|
+
const payload = Buffer.isBuffer(body) ? body : Buffer.from(body, "utf8");
|
|
48
|
+
const digest = crypto.createHmac("sha256", secret).update(payload).digest("hex");
|
|
49
|
+
return `sha256=${digest}`;
|
|
50
|
+
}
|
|
51
|
+
/** Достаёт подпись из поддерживаемых заголовков. */
|
|
52
|
+
export function extractHookSignature(headers) {
|
|
53
|
+
for (const name of SIGNATURE_HEADERS) {
|
|
54
|
+
const value = firstHeader(headers[name]);
|
|
55
|
+
if (value)
|
|
56
|
+
return value;
|
|
57
|
+
}
|
|
58
|
+
return null;
|
|
59
|
+
}
|
|
60
|
+
/** Достаёт токен из поддерживаемых заголовков (если нет query-параметра). */
|
|
61
|
+
export function extractHookToken(headers) {
|
|
62
|
+
for (const name of TOKEN_HEADERS) {
|
|
63
|
+
const value = firstHeader(headers[name]);
|
|
64
|
+
if (value)
|
|
65
|
+
return value;
|
|
66
|
+
}
|
|
67
|
+
return null;
|
|
68
|
+
}
|
|
69
|
+
/**
|
|
70
|
+
* Проверяет HMAC-подпись. Принимает `sha256=<hex>` и «голый» hex;
|
|
71
|
+
* алгоритмы кроме SHA-256 намеренно не поддерживаются.
|
|
72
|
+
*/
|
|
73
|
+
export function verifyHookSignature(secret, body, signature) {
|
|
74
|
+
if (!secret || !signature)
|
|
75
|
+
return false;
|
|
76
|
+
const normalized = signature.trim();
|
|
77
|
+
if (!/^sha256=/i.test(normalized) && !/^[a-f0-9]{64}$/i.test(normalized)) {
|
|
78
|
+
return false;
|
|
79
|
+
}
|
|
80
|
+
const provided = normalized.replace(/^sha256=/i, "").trim().toLowerCase();
|
|
81
|
+
if (!/^[a-f0-9]{64}$/.test(provided))
|
|
82
|
+
return false;
|
|
83
|
+
const expected = signHookPayload(secret, body).replace(/^sha256=/, "");
|
|
84
|
+
return timingSafeStringEqual(expected, provided);
|
|
85
|
+
}
|
|
86
|
+
/**
|
|
87
|
+
* Проверяет необязательный timestamp против текущего времени.
|
|
88
|
+
* 0 в настройках — проверка выключена. Без заголовка запрос разрешён.
|
|
89
|
+
*/
|
|
90
|
+
export function verifyHookTimestamp(value, toleranceSeconds, nowMs = Date.now()) {
|
|
91
|
+
if (!value || toleranceSeconds <= 0)
|
|
92
|
+
return { ok: true };
|
|
93
|
+
const trimmed = value.trim();
|
|
94
|
+
if (!/^\d+$/.test(trimmed)) {
|
|
95
|
+
return { ok: false, reason: "Некорректный X-Scheduler-Timestamp." };
|
|
96
|
+
}
|
|
97
|
+
const numeric = Number(trimmed);
|
|
98
|
+
if (!Number.isFinite(numeric)) {
|
|
99
|
+
return { ok: false, reason: "Некорректный X-Scheduler-Timestamp." };
|
|
100
|
+
}
|
|
101
|
+
// Значения больше 1e12 трактуем как миллисекунды, иначе — как секунды.
|
|
102
|
+
const timestampMs = numeric > 1e12 ? numeric : numeric * 1000;
|
|
103
|
+
const skewMs = Math.abs(nowMs - timestampMs);
|
|
104
|
+
if (skewMs > toleranceSeconds * 1000) {
|
|
105
|
+
return {
|
|
106
|
+
ok: false,
|
|
107
|
+
reason: `Timestamp вне допустимого окна (±${toleranceSeconds} с).`,
|
|
108
|
+
};
|
|
109
|
+
}
|
|
110
|
+
return { ok: true };
|
|
111
|
+
}
|
|
112
|
+
/**
|
|
113
|
+
* Полная проверка входящего хука: включён ли канал, токен, HMAC, timestamp.
|
|
114
|
+
* Возвращает понятную ошибку на русском для ответа и логов.
|
|
115
|
+
*/
|
|
116
|
+
export function authenticateHookRequest(input) {
|
|
117
|
+
const { settings } = input;
|
|
118
|
+
if (!settings.enabled) {
|
|
119
|
+
return { ok: false, status: 403, error: "Входящие webhook-триггеры отключены." };
|
|
120
|
+
}
|
|
121
|
+
if (!settings.token) {
|
|
122
|
+
return {
|
|
123
|
+
ok: false,
|
|
124
|
+
status: 403,
|
|
125
|
+
error: "В настройках не задан token для входящих хуков.",
|
|
126
|
+
};
|
|
127
|
+
}
|
|
128
|
+
if (!verifyHookToken(settings.token, input.token)) {
|
|
129
|
+
return { ok: false, status: 401, error: "Неверный token." };
|
|
130
|
+
}
|
|
131
|
+
if (settings.requireSignature) {
|
|
132
|
+
if (!settings.secret) {
|
|
133
|
+
return {
|
|
134
|
+
ok: false,
|
|
135
|
+
status: 403,
|
|
136
|
+
error: "В настройках не задан secret для HMAC-подписи.",
|
|
137
|
+
};
|
|
138
|
+
}
|
|
139
|
+
if (!input.signature) {
|
|
140
|
+
return {
|
|
141
|
+
ok: false,
|
|
142
|
+
status: 401,
|
|
143
|
+
error: "Не передана HMAC-подпись (X-Scheduler-Signature).",
|
|
144
|
+
};
|
|
145
|
+
}
|
|
146
|
+
if (!verifyHookSignature(settings.secret, input.body, input.signature)) {
|
|
147
|
+
return { ok: false, status: 401, error: "Неверная HMAC-подпись." };
|
|
148
|
+
}
|
|
149
|
+
}
|
|
150
|
+
const timestamp = verifyHookTimestamp(input.timestamp, settings.timestampToleranceSeconds, input.nowMs);
|
|
151
|
+
if (!timestamp.ok) {
|
|
152
|
+
return { ok: false, status: 401, error: timestamp.reason };
|
|
153
|
+
}
|
|
154
|
+
return { ok: true, status: 200 };
|
|
155
|
+
}
|
|
156
|
+
/**
|
|
157
|
+
* Читает тело запроса с ограничением размера.
|
|
158
|
+
*
|
|
159
|
+
* Лишние байты не накапливаются в памяти: после превышения лимита поток
|
|
160
|
+
* дочитывается и отбрасывается, чтобы клиент получил внятный 413, а не reset.
|
|
161
|
+
*/
|
|
162
|
+
export function readRequestBody(req, maxBytes) {
|
|
163
|
+
return new Promise((resolve) => {
|
|
164
|
+
const limit = Math.max(1, Math.floor(maxBytes) || 1);
|
|
165
|
+
let size = 0;
|
|
166
|
+
let tooLarge = false;
|
|
167
|
+
let settled = false;
|
|
168
|
+
const chunks = [];
|
|
169
|
+
const finish = (result) => {
|
|
170
|
+
if (settled)
|
|
171
|
+
return;
|
|
172
|
+
settled = true;
|
|
173
|
+
resolve(result);
|
|
174
|
+
};
|
|
175
|
+
req.on("data", (chunk) => {
|
|
176
|
+
size += chunk.length;
|
|
177
|
+
if (tooLarge)
|
|
178
|
+
return;
|
|
179
|
+
if (size > limit) {
|
|
180
|
+
tooLarge = true;
|
|
181
|
+
chunks.length = 0;
|
|
182
|
+
return;
|
|
183
|
+
}
|
|
184
|
+
chunks.push(chunk);
|
|
185
|
+
});
|
|
186
|
+
req.on("end", () => {
|
|
187
|
+
if (tooLarge) {
|
|
188
|
+
finish({
|
|
189
|
+
ok: false,
|
|
190
|
+
status: 413,
|
|
191
|
+
error: `Тело запроса больше ${limit} байт.`,
|
|
192
|
+
});
|
|
193
|
+
return;
|
|
194
|
+
}
|
|
195
|
+
finish({ ok: true, body: Buffer.concat(chunks) });
|
|
196
|
+
});
|
|
197
|
+
req.on("error", (err) => {
|
|
198
|
+
finish({
|
|
199
|
+
ok: false,
|
|
200
|
+
status: 400,
|
|
201
|
+
error: `Не удалось прочитать тело запроса: ${err instanceof Error ? err.message : String(err)}`,
|
|
202
|
+
});
|
|
203
|
+
});
|
|
204
|
+
});
|
|
205
|
+
}
|
package/dist/notifications.d.ts
CHANGED
|
@@ -1,3 +1,5 @@
|
|
|
1
|
+
import { type DigestFrequency, type DigestSettings, type NotificationFilters, type NotificationTemplates } from "./settings.js";
|
|
2
|
+
import { type AnalyticsRecord, type ErrorAnalyticsRow } from "./core/analytics.js";
|
|
1
3
|
/** Статус завершения задачи, который приходит из record-history. */
|
|
2
4
|
export type NotificationStatus = "success" | "error" | "timeout" | string;
|
|
3
5
|
/** Содержимое уведомления. */
|
|
@@ -10,28 +12,132 @@ export interface NotificationPayload {
|
|
|
10
12
|
/** Человекочитаемая длительность: 2300 мс → «2.3s». */
|
|
11
13
|
export declare function formatDuration(durationMs: number): string;
|
|
12
14
|
/**
|
|
13
|
-
*
|
|
15
|
+
* Сопоставление имени задачи с шаблоном: `*` — любая последовательность,
|
|
16
|
+
* регистр не важен. `regen-*` покрывает `regen-api`, `regen-ui`.
|
|
17
|
+
*/
|
|
18
|
+
export declare function wildcardMatch(pattern: string, value: string): boolean;
|
|
19
|
+
/** Проверяет, разрешена ли задача фильтрами include/exclude. */
|
|
20
|
+
export declare function isTaskAllowed(taskName: string, filters?: NotificationFilters): boolean;
|
|
21
|
+
/** Подставляет {key} в шаблон; неизвестные плейсхолдеры остаются как есть. */
|
|
22
|
+
export declare function renderTemplate(template: string, vars: Record<string, string>): string;
|
|
23
|
+
/**
|
|
24
|
+
* Формат сообщения по умолчанию:
|
|
14
25
|
* ✅ Задача "Тест" выполнена (2.3s)
|
|
15
26
|
* ❌ Задача "Тест" упала (2.3s): Quality Gate провален
|
|
16
27
|
*/
|
|
17
|
-
export declare function formatNotificationMessage(payload: NotificationPayload): string;
|
|
28
|
+
export declare function formatNotificationMessage(payload: NotificationPayload, templates?: NotificationTemplates): string;
|
|
29
|
+
/** Информация о завершении матрицы для уведомления. */
|
|
30
|
+
export interface MatrixNotificationInfo {
|
|
31
|
+
parentName: string;
|
|
32
|
+
status: "success" | "error" | "partial";
|
|
33
|
+
total: number;
|
|
34
|
+
success: number;
|
|
35
|
+
error: number;
|
|
36
|
+
message?: string | null;
|
|
37
|
+
}
|
|
38
|
+
/** Текст уведомления о завершении матрицы. */
|
|
39
|
+
export declare function formatMatrixMessage(info: MatrixNotificationInfo): string;
|
|
40
|
+
export interface WebhookOptions {
|
|
41
|
+
/** Таймаут одной попытки в мс (по умолчанию 10 с). */
|
|
42
|
+
timeoutMs?: number;
|
|
43
|
+
/** Сколько раз повторить после неудачи (по умолчанию 0). */
|
|
44
|
+
retryCount?: number;
|
|
45
|
+
/** Базовая задержка backoff в мс (по умолчанию 1000). */
|
|
46
|
+
retryDelayMs?: number;
|
|
47
|
+
/** Подмена sleep для тестов. */
|
|
48
|
+
sleep?: (ms: number) => Promise<void>;
|
|
49
|
+
}
|
|
18
50
|
/**
|
|
19
|
-
* Отправляет POST на webhook.
|
|
51
|
+
* Отправляет POST на webhook с повторами и экспоненциальным backoff.
|
|
20
52
|
*
|
|
21
53
|
* Тело совместимо одновременно с Discord (`content`) и Slack (`text`).
|
|
22
|
-
*
|
|
23
|
-
*
|
|
54
|
+
* Повторяются только сетевые ошибки, таймауты, 5xx и 429; прочие 4xx — сразу
|
|
55
|
+
* ошибка (повтор не поможет). Бросает исключение только для диагностики —
|
|
56
|
+
* вызывающий код обязан перехватить его, чтобы уведомление не ломало задачу.
|
|
24
57
|
*/
|
|
25
|
-
export declare function sendWebhook(url: string, message: string): Promise<void>;
|
|
58
|
+
export declare function sendWebhook(url: string, message: string, options?: WebhookOptions): Promise<void>;
|
|
26
59
|
/**
|
|
27
60
|
* Уведомляет о завершении задачи во все включённые каналы.
|
|
28
61
|
*
|
|
29
62
|
* Правила:
|
|
30
63
|
* - `notifications.enabled === false` — ничего не делает;
|
|
31
64
|
* - `onlyOnError === true` — успешные запуски пропускаются;
|
|
65
|
+
* - фильтры include/exclude отсекают задачи по имени;
|
|
32
66
|
* - ошибки отправки только логируются, наружу не выбрасываются.
|
|
33
67
|
*/
|
|
34
68
|
export declare function notifyTaskCompletion(taskName: string, status: NotificationStatus, durationMs: number, error?: string | null): Promise<void>;
|
|
69
|
+
/**
|
|
70
|
+
* Уведомляет о завершении матрицы (Спринт 20).
|
|
71
|
+
*
|
|
72
|
+
* partial — только при `matrix.onPartial`; полный провал — при
|
|
73
|
+
* `matrix.onAllFailed`; успех — только когда `onlyOnError === false`.
|
|
74
|
+
*/
|
|
75
|
+
export declare function notifyMatrixCompletion(info: MatrixNotificationInfo): Promise<void>;
|
|
76
|
+
/** Запись о незавершённом запуске (для детектора зависших матриц). */
|
|
77
|
+
export interface RunningTaskRecord {
|
|
78
|
+
id: number;
|
|
79
|
+
taskName: string;
|
|
80
|
+
startedAt: string;
|
|
81
|
+
}
|
|
82
|
+
/** Найденный зависший клон матрицы. */
|
|
83
|
+
export interface StuckMatrixClone {
|
|
84
|
+
id: number;
|
|
85
|
+
cloneName: string;
|
|
86
|
+
parentName: string;
|
|
87
|
+
startedAt: string;
|
|
88
|
+
minutes: number;
|
|
89
|
+
}
|
|
90
|
+
/**
|
|
91
|
+
* Ищет клоны матриц, которые выполняются дольше порога.
|
|
92
|
+
* `parentByClone` — соответствие «имя клона → имя родителя» (без регистра).
|
|
93
|
+
*/
|
|
94
|
+
export declare function findStuckMatrixClones(running: RunningTaskRecord[], parentByClone: Map<string, string>, now: Date, thresholdMinutes: number): StuckMatrixClone[];
|
|
95
|
+
/** Текст уведомления о зависшем клоне матрицы. */
|
|
96
|
+
export declare function formatStuckMatrixMessage(stuck: StuckMatrixClone): string;
|
|
97
|
+
/** Отправляет уведомление о зависшем клоне, если матрицы включены. */
|
|
98
|
+
export declare function notifyStuckMatrix(stuck: StuckMatrixClone): Promise<boolean>;
|
|
99
|
+
/** Сводка для дайджеста. */
|
|
100
|
+
export interface DigestSummary {
|
|
101
|
+
period: "daily" | "weekly";
|
|
102
|
+
windowDays: number;
|
|
103
|
+
total: number;
|
|
104
|
+
success: number;
|
|
105
|
+
error: number;
|
|
106
|
+
partial: number;
|
|
107
|
+
successRate: number;
|
|
108
|
+
tokens: number;
|
|
109
|
+
costUsd: number;
|
|
110
|
+
topErrors: ErrorAnalyticsRow[];
|
|
111
|
+
}
|
|
112
|
+
/** Строит сводку дайджеста из записей истории. */
|
|
113
|
+
export declare function buildDigestSummary(records: AnalyticsRecord[], options: {
|
|
114
|
+
frequency: DigestFrequency;
|
|
115
|
+
now?: Date;
|
|
116
|
+
}): DigestSummary;
|
|
117
|
+
/** Текст дайджеста. */
|
|
118
|
+
export declare function formatDigestMessage(summary: DigestSummary, now?: Date): string;
|
|
119
|
+
/**
|
|
120
|
+
* Пора ли отправлять дайджест.
|
|
121
|
+
*
|
|
122
|
+
* daily — раз в сутки после `digest.time`; weekly — по понедельникам после
|
|
123
|
+
* `digest.time`. `lastSentAt` защищает от повторной отправки после перезапуска.
|
|
124
|
+
*/
|
|
125
|
+
export declare function isDigestDue(digest: DigestSettings, now: Date): boolean;
|
|
126
|
+
/**
|
|
127
|
+
* Собирает и отправляет дайджест.
|
|
128
|
+
*
|
|
129
|
+
* `updateLastSentAt` включается только для плановой отправки: ручная кнопка
|
|
130
|
+
* «Отправить сейчас» не должна сдвигать расписание.
|
|
131
|
+
*/
|
|
132
|
+
export declare function sendDigestNow(options?: {
|
|
133
|
+
now?: Date;
|
|
134
|
+
updateLastSentAt?: boolean;
|
|
135
|
+
}): Promise<{
|
|
136
|
+
success: boolean;
|
|
137
|
+
message: string;
|
|
138
|
+
}>;
|
|
139
|
+
/** Плановая проверка дайджеста: отправляет, если пора. Возвращает true при отправке. */
|
|
140
|
+
export declare function maybeSendDigest(now?: Date): Promise<boolean>;
|
|
35
141
|
/**
|
|
36
142
|
* Отправляет тестовое сообщение в webhook (кнопка «🧪 Тестовое уведомление»).
|
|
37
143
|
*
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../src/notifications.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../src/notifications.ts"],"names":[],"mappings":"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"}
|