@intentius/sql-yodeler 0.7.0 → 0.8.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.
Files changed (58) hide show
  1. package/dist/apply-steps/index.d.ts +73 -21
  2. package/dist/apply-steps/index.js +171 -49
  3. package/dist/apply-steps/index.js.map +1 -1
  4. package/dist/ci/render.d.ts +7 -2
  5. package/dist/ci/render.js +12 -2
  6. package/dist/ci/render.js.map +1 -1
  7. package/dist/commands/apply.js +173 -64
  8. package/dist/commands/apply.js.map +1 -1
  9. package/dist/commands/drift.js +8 -8
  10. package/dist/commands/drift.js.map +1 -1
  11. package/dist/commands/override.js +46 -22
  12. package/dist/commands/override.js.map +1 -1
  13. package/dist/commands/plan.js +19 -19
  14. package/dist/commands/plan.js.map +1 -1
  15. package/dist/commands/revert.js +3 -2
  16. package/dist/commands/revert.js.map +1 -1
  17. package/dist/config/define.d.ts +5 -5
  18. package/dist/mcp/tools.d.ts +1 -1
  19. package/dist/mcp/tools.js +6 -4
  20. package/dist/mcp/tools.js.map +1 -1
  21. package/dist/notify/index.d.ts +30 -97
  22. package/dist/notify/index.js +50 -154
  23. package/dist/notify/index.js.map +1 -1
  24. package/dist/notify/verify.d.ts +17 -31
  25. package/dist/notify/verify.js +16 -47
  26. package/dist/notify/verify.js.map +1 -1
  27. package/dist/pr/forge.d.ts +33 -38
  28. package/dist/pr/forge.js +74 -97
  29. package/dist/pr/forge.js.map +1 -1
  30. package/dist/pr/issue.d.ts +16 -33
  31. package/dist/pr/issue.js +17 -88
  32. package/dist/pr/issue.js.map +1 -1
  33. package/dist/pr/model.js +7 -2
  34. package/dist/pr/model.js.map +1 -1
  35. package/dist/pr/render.js +2 -2
  36. package/dist/pr/render.js.map +1 -1
  37. package/dist/release/index.d.ts +63 -0
  38. package/dist/release/index.js +122 -0
  39. package/dist/release/index.js.map +1 -0
  40. package/dist/report/audit.d.ts +18 -19
  41. package/dist/report/audit.js +57 -27
  42. package/dist/report/audit.js.map +1 -1
  43. package/dist/report/model.js +18 -5
  44. package/dist/report/model.js.map +1 -1
  45. package/dist/tenants/wave.d.ts +6 -2
  46. package/dist/tenants/wave.js +1 -3
  47. package/dist/tenants/wave.js.map +1 -1
  48. package/dist/versioned/policy.d.ts +44 -24
  49. package/dist/versioned/policy.js +70 -37
  50. package/dist/versioned/policy.js.map +1 -1
  51. package/dist/waves/index.d.ts +4 -10
  52. package/dist/waves/index.js +8 -33
  53. package/dist/waves/index.js.map +1 -1
  54. package/package.json +7 -7
  55. package/schemas/event.schema.json +218 -26
  56. package/dist/pr/comment.d.ts +0 -32
  57. package/dist/pr/comment.js +0 -99
  58. package/dist/pr/comment.js.map +0 -1
@@ -1,68 +1,27 @@
1
1
  /**
2
- * Webhook events (#61). `notify` in yodel.config.ts names the environment
3
- * variables that hold a webhook's URL and its signing key (never the values
4
- * themselves); `yodel apply`, `yodel plan` and `yodel drift` post an event
5
- * when an environment is waiting for approval, when a run was refused or
6
- * failed, and when drift is found:
2
+ * Webhook events (#61), sent through chant's notify (#211). `notify` in
3
+ * yodel.config.ts names the environment variables that hold a webhook's URL
4
+ * and its signing key (never the values themselves); `yodel apply`,
5
+ * `yodel plan` and `yodel drift` post an event when an environment is
6
+ * waiting for approval, when a run was refused or failed, and when drift is
7
+ * found:
7
8
  *
8
9
  * ```ts
9
10
  * notify: { webhook: "YODEL_WEBHOOK_URL", key: "YODEL_WEBHOOK_KEY", slack: "SLACK_WEBHOOK_URL" }
10
11
  * ```
11
12
  *
12
- * The webhook gets the event as JSON, signed (`./verify.ts`); a Slack
13
- * incoming webhook, when `slack` names one, gets a line of text. A delivery
14
- * that fails is reported on stderr and never changes the command's exit
15
- * code: the event is news about the run, not part of it.
13
+ * The event is chant's `chant.notify/v1`; yodel decides when to send one and
14
+ * what it says. The webhook gets it as JSON, signed under yodel's header
15
+ * names (`./verify.ts`); Slack and Teams incoming webhooks get chant's
16
+ * message. A delivery that fails is reported on stderr and never changes the
17
+ * command's exit code: the event is news about the run, not part of it.
16
18
  */
17
- import { randomUUID } from "node:crypto";
18
- import { DELIVERY_HEADER, EVENT_HEADER, SIGNATURE_HEADER, TIMESTAMP_HEADER, signWebhook } from "./verify.js";
19
+ import { makeNotifyEvent, sendNotify } from "@intentius/chant/notify";
20
+ import { HEADER_PREFIX } from "./verify.js";
19
21
  export * from "./verify.js";
20
- export const NOTIFY_EVENTS = ["waiting", "refused", "failed", "drift"];
21
- const NAME = /^[A-Za-z_][A-Za-z0-9_]*$/;
22
- /** Checks `notify` in yodel.config.ts; returns a message for the first problem, or undefined. */
23
- export function notifyConfigProblem(value) {
24
- if (typeof value !== "object" || value === null || Array.isArray(value))
25
- return "notify: expected { webhook, key, slack?, events? }";
26
- const v = value;
27
- for (const k of Object.keys(v))
28
- if (!["webhook", "key", "slack", "events"].includes(k))
29
- return `notify.${k}: unknown setting (expected webhook, key, slack, events)`;
30
- for (const k of ["webhook", "key", "slack"]) {
31
- const n = v[k];
32
- if (n === undefined)
33
- continue;
34
- if (typeof n !== "string" || n.includes("://") || !NAME.test(n)) {
35
- return `notify.${k}: the name of the environment variable that holds the ${k === "key" ? "signing key" : "URL"} (such as ${k === "key" ? "YODEL_WEBHOOK_KEY" : k === "slack" ? "SLACK_WEBHOOK_URL" : "YODEL_WEBHOOK_URL"}), never the ${k === "key" ? "key" : "URL"} itself`;
36
- }
37
- }
38
- if (v.webhook !== undefined && v.key === undefined)
39
- return "notify.key: a webhook needs a signing key; name the variable that holds it";
40
- if (v.key !== undefined && v.webhook === undefined)
41
- return "notify.webhook: a key is for a webhook; name the variable that holds its URL";
42
- if (v.webhook === undefined && v.slack === undefined)
43
- return "notify: name a webhook (with its key) or a slack URL variable";
44
- if (v.events !== undefined && !(Array.isArray(v.events) && v.events.every((e) => NOTIFY_EVENTS.includes(e)))) {
45
- return `notify.events: a list of ${NOTIFY_EVENTS.join(", ")}`;
46
- }
47
- return undefined;
48
- }
49
- /** Where the CI run is, when yodel runs in one. */
50
- export function ciContext(env) {
51
- const out = {};
52
- if (env.GITHUB_SERVER_URL && env.GITHUB_REPOSITORY && env.GITHUB_RUN_ID)
53
- out.runUrl = `${env.GITHUB_SERVER_URL}/${env.GITHUB_REPOSITORY}/actions/runs/${env.GITHUB_RUN_ID}`;
54
- else if (env.CI_JOB_URL)
55
- out.runUrl = env.CI_JOB_URL;
56
- else if (env.CI_PIPELINE_URL)
57
- out.runUrl = env.CI_PIPELINE_URL;
58
- const repository = env.GITHUB_REPOSITORY ?? env.CI_PROJECT_PATH;
59
- if (repository)
60
- out.repository = repository;
61
- const commit = env.GITHUB_SHA ?? env.CI_COMMIT_SHA;
62
- if (commit)
63
- out.commit = commit;
64
- return out;
65
- }
22
+ export { NOTIFY_EVENTS, makeNotifyEvent, notifyConfigProblem, slackMessage, webhookRequest } from "@intentius/chant/notify";
23
+ /** The product name events carry in `source`. */
24
+ export const SOURCE = "sql-yodeler";
66
25
  const ids = (list) => (Array.isArray(list) ? list.flatMap((p) => (typeof p === "object" && p !== null && typeof p.id === "string" ? [p.id] : [])) : []);
67
26
  const str = (v) => (typeof v === "string" && v !== "" ? v : undefined);
68
27
  const firstLine = (s) => s.split("\n")[0] ?? s;
@@ -73,15 +32,21 @@ const firstLine = (s) => s.split("\n")[0] ?? s;
73
32
  export function eventFromRun(command, doc) {
74
33
  const status = str(doc.status) ?? (doc.refusal ? "refused" : undefined);
75
34
  const environment = str(doc.environment) ?? "";
76
- const migrations = ids(doc.pending);
35
+ const targets = ids(doc.pending);
77
36
  const digest = str(doc.gatePlanDigest) ?? str(doc.planDigest);
78
- const base = { environment, command, migrations, ...(digest ? { digest } : {}) };
37
+ const base = { source: SOURCE, environment, targets, detail: { command }, ...(digest ? { digest } : {}) };
79
38
  const refusal = doc.refusal?.message;
80
39
  const deniedRules = Array.isArray(doc.policy) ? doc.policy.filter((r) => r.outcome === "denied").map((r) => r.id ?? "") : [];
81
40
  if (status === "gated") {
82
41
  const approve = str(doc.approve);
83
- const chantApprove = str(doc.chantApprove);
84
- return { ...base, event: "waiting", status, summary: `${environment} is waiting for approval of ${digest ?? "its plan"} (${String(migrations.length)} migration${migrations.length === 1 ? "" : "s"})`, ...(approve ? { approve } : {}), ...(chantApprove ? { chantApprove } : {}) };
42
+ const chant = str(doc.chantApprove);
43
+ return {
44
+ ...base,
45
+ event: "waiting",
46
+ status,
47
+ summary: `${environment} is waiting for approval of ${digest ?? "its plan"} (${String(targets.length)} migration${targets.length === 1 ? "" : "s"})`,
48
+ ...(approve ? { approve: { command: approve, ...(chant ? { chant } : {}) } } : {}),
49
+ };
85
50
  }
86
51
  if (status === "refused" || status === "denied" || (command === "plan" && (refusal !== undefined || deniedRules.length > 0))) {
87
52
  const reason = typeof refusal === "string" ? refusal : deniedRules.length > 0 ? `policy rule ${deniedRules.join(", ")} denies the plan` : status === "refused" ? "refused" : "denied by policy";
@@ -90,7 +55,14 @@ export function eventFromRun(command, doc) {
90
55
  if (status === "failed" || status === "incomplete") {
91
56
  const code = typeof doc.exitCode === "number" ? doc.exitCode : undefined;
92
57
  const reason = `${command} ${status}${code !== undefined ? ` (exit ${String(code)})` : ""}`;
93
- return { ...base, event: "failed", status, summary: `${command} in ${environment} ${status}${code !== undefined ? ` with exit ${String(code)}` : ""}`, reason };
58
+ return {
59
+ ...base,
60
+ event: "failed",
61
+ status,
62
+ summary: `${command} in ${environment} ${status}${code !== undefined ? ` with exit ${String(code)}` : ""}`,
63
+ reason,
64
+ ...(code !== undefined ? { exitCode: code } : {}),
65
+ };
94
66
  }
95
67
  return undefined;
96
68
  }
@@ -102,110 +74,34 @@ export function eventFromDrift(doc) {
102
74
  const missing = doc.missing ?? [];
103
75
  const environment = doc.environment ?? "";
104
76
  return {
77
+ source: SOURCE,
105
78
  event: "drift",
106
79
  environment,
107
- command: "drift",
108
80
  status: "drifted",
109
- migrations: [],
81
+ detail: { command: "drift" },
110
82
  summary: `${environment} drifted: ${[changed.length > 0 ? `${changed.join(", ")} changed` : "", missing.length > 0 ? `${missing.join(", ")} missing` : ""].filter(Boolean).join("; ")}`,
111
83
  drift: { changed, missing, ...(doc.fingerprint ? { fingerprint: doc.fingerprint } : {}) },
112
84
  };
113
85
  }
114
- /** A whole event: the fields, with its id, time and the CI run. */
115
- export function makeEvent(fields, env = process.env, now = new Date()) {
116
- return { version: 1, id: randomUUID(), at: now.toISOString(), ...fields, ...ciContext(env) };
117
- }
118
- /** The Slack message for an event: one line of text, with the approve command and the run on `waiting`. */
119
- export function slackMessage(e) {
120
- const lines = [`yodel ${e.event}: ${e.summary}`];
121
- if (e.approve)
122
- lines.push(`Approve with: \`${e.approve}\``);
123
- if (e.runUrl)
124
- lines.push(`Run: ${e.runUrl}`);
125
- return { text: lines.join("\n") };
126
- }
127
- /** The request that delivers `event` to the webhook, signed with `key`. */
128
- export function webhookRequest(event, key, now = Math.floor(Date.now() / 1000)) {
129
- const body = JSON.stringify(event);
130
- return {
131
- body,
132
- headers: {
133
- "content-type": "application/json",
134
- "user-agent": "sql-yodeler",
135
- [EVENT_HEADER]: event.event,
136
- [DELIVERY_HEADER]: event.id,
137
- [TIMESTAMP_HEADER]: String(now),
138
- [SIGNATURE_HEADER]: signWebhook(key, now, body),
139
- },
140
- };
141
- }
142
- async function post(fetchFn, url, request, attempts) {
143
- let last = "";
144
- for (let i = 0; i < attempts; i++) {
145
- if (i > 0)
146
- await new Promise((r) => setTimeout(r, 500 * i));
147
- try {
148
- const res = await fetchFn(url, { method: "POST", ...request, signal: AbortSignal.timeout(10_000) });
149
- if (res.ok)
150
- return undefined;
151
- last = `HTTP ${String(res.status)}`;
152
- // A 4xx will not change on a retry: the receiver refused the event (a signature it does not accept, say).
153
- if (res.status < 500)
154
- return last;
155
- }
156
- catch (e) {
157
- last = e instanceof Error ? e.message : String(e);
158
- }
159
- }
160
- return last;
161
- }
162
86
  /**
163
- * Sends the event to what `config` names. Reads the URLs and the key from
164
- * `env` at send time. Never throws: each delivery's outcome is returned and
165
- * a failed one is written to `io.err`.
87
+ * Sends the event to what `config` names, through chant's notify under
88
+ * yodel's header names. Reads the URLs and the key from `env` at send time.
89
+ * Never throws: each delivery's outcome is returned and a failed one is
90
+ * written to `io.err`.
166
91
  */
167
92
  export async function sendEvent(config, fields, options) {
168
93
  if (!config || !fields)
169
94
  return [];
170
- if (config.events && !config.events.includes(fields.event))
171
- return [];
172
95
  const env = options.env ?? process.env;
173
- const fetchFn = options.fetch ?? globalThis.fetch;
174
- const attempts = options.attempts ?? 3;
175
- const event = makeEvent(fields, env);
176
- const out = [];
177
- const warn = (d) => {
178
- options.io.err(`yodel ${options.verb}: notify: the ${fields.event} event was not delivered to the ${d.target}: ${d.detail}\n`);
179
- };
180
- if (config.webhook) {
181
- const url = env[config.webhook];
182
- const key = config.key ? env[config.key] : undefined;
183
- let d;
184
- if (!url)
185
- d = { target: "webhook", ok: false, detail: `${config.webhook} is not set` };
186
- else if (!key)
187
- d = { target: "webhook", ok: false, detail: `${config.key ?? "the key variable"} is not set, and yodel does not send an unsigned event` };
188
- else {
189
- const failed = await post(fetchFn, url, webhookRequest(event, key), attempts);
190
- d = { target: "webhook", ok: failed === undefined, detail: failed ?? "delivered" };
191
- }
192
- if (!d.ok)
193
- warn(d);
194
- out.push(d);
195
- }
196
- if (config.slack) {
197
- const url = env[config.slack];
198
- let d;
199
- if (!url)
200
- d = { target: "slack", ok: false, detail: `${config.slack} is not set` };
201
- else {
202
- const failed = await post(fetchFn, url, { headers: { "content-type": "application/json" }, body: JSON.stringify(slackMessage(event)) }, attempts);
203
- d = { target: "slack", ok: failed === undefined, detail: failed ?? "delivered" };
204
- }
205
- if (!d.ok)
206
- warn(d);
207
- out.push(d);
208
- }
209
- return out;
96
+ return sendNotify(config, makeNotifyEvent(fields, { env }), {
97
+ env,
98
+ prefix: HEADER_PREFIX,
99
+ userAgent: SOURCE,
100
+ log: (line) => {
101
+ options.io.err(`yodel ${options.verb}: ${line}\n`);
102
+ },
103
+ ...(options.fetch ? { fetch: options.fetch } : {}),
104
+ ...(options.attempts !== undefined ? { attempts: options.attempts } : {}),
105
+ });
210
106
  }
211
107
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/notify/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/notify/index.ts"],"names":[],"mappings":"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"}
@@ -1,6 +1,7 @@
1
1
  /**
2
- * Signing and checking a yodel webhook event (#61). This module needs only
3
- * node:crypto, so a receiver can import it alone:
2
+ * Checking a yodel webhook event (#61), over chant's notify-verify (#211).
3
+ * It needs only node:crypto and chant's compiled notify-verify, so a
4
+ * receiver can import it alone, in plain Node:
4
5
  *
5
6
  * ```ts
6
7
  * import { verifyWebhook } from "@intentius/sql-yodeler/webhook";
@@ -15,36 +16,21 @@
15
16
  * epoch), a dot, and the request body exactly as sent. It travels as
16
17
  * `x-yodel-signature: sha256=<hex>`. Signing the timestamp with the body
17
18
  * lets a receiver refuse a delivery replayed later; {@link verifyWebhook}
18
- * refuses one older than five minutes by default.
19
+ * refuses one more than five minutes from now by default. This is chant's
20
+ * scheme under yodel's header names, so a receiver written for an earlier
21
+ * release keeps verifying.
19
22
  */
20
- export declare const SIGNATURE_HEADER = "x-yodel-signature";
21
- export declare const TIMESTAMP_HEADER = "x-yodel-timestamp";
22
- export declare const EVENT_HEADER = "x-yodel-event";
23
- export declare const DELIVERY_HEADER = "x-yodel-delivery";
24
- /** How old a delivery {@link verifyWebhook} still accepts, in seconds. */
25
- export declare const DEFAULT_TOLERANCE_SECONDS = 300;
26
- /** `sha256=<hex>` of `<timestamp>.<body>`, keyed with `key`. */
27
- export declare function signWebhook(key: string, timestamp: number | string, body: string): string;
28
- export type WebhookHeaders = Record<string, string | readonly string[] | undefined> | Headers;
29
- export interface VerifyInput {
30
- /** The request body exactly as received, before any JSON parsing. */
31
- body: string | Uint8Array;
32
- /** The request's headers; names are matched without regard to case. */
33
- headers: WebhookHeaders;
34
- /** The shared secret. An empty or missing key never verifies. */
35
- key: string | undefined;
36
- /** Now, in seconds since the epoch. Default: the clock. */
37
- now?: number;
38
- /** How old a delivery may be, in seconds. Default {@link DEFAULT_TOLERANCE_SECONDS}. */
39
- toleranceSeconds?: number;
40
- }
41
- export type VerifyResult = {
42
- ok: true;
43
- event: unknown;
44
- } | {
45
- ok: false;
46
- reason: string;
47
- };
23
+ import { type VerifyWebhookInput, type VerifyWebhookResult } from "@intentius/chant/notify-verify";
24
+ export { DEFAULT_TOLERANCE_SECONDS, signWebhook } from "@intentius/chant/notify-verify";
25
+ export type { WebhookHeaders } from "@intentius/chant/notify-verify";
26
+ /** The prefix of yodel's webhook header names. */
27
+ export declare const HEADER_PREFIX = "x-yodel";
28
+ export declare const SIGNATURE_HEADER: string;
29
+ export declare const TIMESTAMP_HEADER: string;
30
+ export declare const EVENT_HEADER: string;
31
+ export declare const DELIVERY_HEADER: string;
32
+ export type VerifyInput = Omit<VerifyWebhookInput, "prefix">;
33
+ export type VerifyResult = VerifyWebhookResult;
48
34
  /**
49
35
  * Whether a delivery was signed with `key` and is recent: the signature
50
36
  * header matches (compared in constant time) and the timestamp is within the
@@ -1,6 +1,7 @@
1
1
  /**
2
- * Signing and checking a yodel webhook event (#61). This module needs only
3
- * node:crypto, so a receiver can import it alone:
2
+ * Checking a yodel webhook event (#61), over chant's notify-verify (#211).
3
+ * It needs only node:crypto and chant's compiled notify-verify, so a
4
+ * receiver can import it alone, in plain Node:
4
5
  *
5
6
  * ```ts
6
7
  * import { verifyWebhook } from "@intentius/sql-yodeler/webhook";
@@ -15,57 +16,25 @@
15
16
  * epoch), a dot, and the request body exactly as sent. It travels as
16
17
  * `x-yodel-signature: sha256=<hex>`. Signing the timestamp with the body
17
18
  * lets a receiver refuse a delivery replayed later; {@link verifyWebhook}
18
- * refuses one older than five minutes by default.
19
+ * refuses one more than five minutes from now by default. This is chant's
20
+ * scheme under yodel's header names, so a receiver written for an earlier
21
+ * release keeps verifying.
19
22
  */
20
- import { createHmac, timingSafeEqual } from "node:crypto";
21
- export const SIGNATURE_HEADER = "x-yodel-signature";
22
- export const TIMESTAMP_HEADER = "x-yodel-timestamp";
23
- export const EVENT_HEADER = "x-yodel-event";
24
- export const DELIVERY_HEADER = "x-yodel-delivery";
25
- /** How old a delivery {@link verifyWebhook} still accepts, in seconds. */
26
- export const DEFAULT_TOLERANCE_SECONDS = 300;
27
- /** `sha256=<hex>` of `<timestamp>.<body>`, keyed with `key`. */
28
- export function signWebhook(key, timestamp, body) {
29
- return `sha256=${createHmac("sha256", key).update(`${String(timestamp)}.${body}`, "utf8").digest("hex")}`;
30
- }
31
- function header(headers, name) {
32
- if (typeof headers.get === "function")
33
- return headers.get(name) ?? undefined;
34
- for (const [k, v] of Object.entries(headers)) {
35
- if (k.toLowerCase() !== name)
36
- continue;
37
- return Array.isArray(v) ? v[0] : v;
38
- }
39
- return undefined;
40
- }
23
+ import { verifyWebhook as chantVerify, webhookHeaderNames } from "@intentius/chant/notify-verify";
24
+ export { DEFAULT_TOLERANCE_SECONDS, signWebhook } from "@intentius/chant/notify-verify";
25
+ /** The prefix of yodel's webhook header names. */
26
+ export const HEADER_PREFIX = "x-yodel";
27
+ const names = webhookHeaderNames(HEADER_PREFIX);
28
+ export const SIGNATURE_HEADER = names.signature;
29
+ export const TIMESTAMP_HEADER = names.timestamp;
30
+ export const EVENT_HEADER = names.event;
31
+ export const DELIVERY_HEADER = names.delivery;
41
32
  /**
42
33
  * Whether a delivery was signed with `key` and is recent: the signature
43
34
  * header matches (compared in constant time) and the timestamp is within the
44
35
  * tolerance either side of now. On success, the parsed event.
45
36
  */
46
37
  export function verifyWebhook(input) {
47
- if (!input.key)
48
- return { ok: false, reason: "no key to verify with" };
49
- const body = typeof input.body === "string" ? input.body : Buffer.from(input.body).toString("utf8");
50
- const signature = header(input.headers, SIGNATURE_HEADER);
51
- const timestamp = header(input.headers, TIMESTAMP_HEADER);
52
- if (!signature)
53
- return { ok: false, reason: `no ${SIGNATURE_HEADER} header` };
54
- if (!timestamp || !/^\d+$/.test(timestamp))
55
- return { ok: false, reason: `no ${TIMESTAMP_HEADER} header, or not a number of seconds` };
56
- const expected = Buffer.from(signWebhook(input.key, timestamp, body));
57
- const given = Buffer.from(signature);
58
- if (given.length !== expected.length || !timingSafeEqual(given, expected))
59
- return { ok: false, reason: "the signature does not match" };
60
- const now = input.now ?? Math.floor(Date.now() / 1000);
61
- const tolerance = input.toleranceSeconds ?? DEFAULT_TOLERANCE_SECONDS;
62
- if (Math.abs(now - Number(timestamp)) > tolerance)
63
- return { ok: false, reason: `the timestamp is more than ${String(tolerance)}s from now` };
64
- try {
65
- return { ok: true, event: JSON.parse(body) };
66
- }
67
- catch {
68
- return { ok: false, reason: "the body is not JSON" };
69
- }
38
+ return chantVerify({ ...input, prefix: HEADER_PREFIX });
70
39
  }
71
40
  //# sourceMappingURL=verify.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"verify.js","sourceRoot":"","sources":["../../src/notify/verify.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"verify.js","sourceRoot":"","sources":["../../src/notify/verify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,aAAa,IAAI,WAAW,EAAE,kBAAkB,EAAqD,MAAM,gCAAgC,CAAC;AAErJ,OAAO,EAAE,yBAAyB,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAGxF,kDAAkD;AAClD,MAAM,CAAC,MAAM,aAAa,GAAG,SAAS,CAAC;AAEvC,MAAM,KAAK,GAAG,kBAAkB,CAAC,aAAa,CAAC,CAAC;AAChD,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,CAAC,SAAS,CAAC;AAChD,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,CAAC,SAAS,CAAC;AAChD,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC;AACxC,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC,QAAQ,CAAC;AAK9C;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAAkB;IAC9C,OAAO,WAAW,CAAC,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;AAC1D,CAAC"}
@@ -1,40 +1,32 @@
1
1
  /**
2
- * Where `yodel plan <env> --comment` posts: the forge, the repository, the
3
- * pull (merge) request and the token, from the CI job's environment, each
4
- * overridden by a flag.
2
+ * Where `yodel plan <env> --comment` and `yodel drift <env> --issue` post:
3
+ * chant's forge client (`@intentius/chant/pr-forge`, #210) for the CI job's
4
+ * forge, repository, pull (merge) request and token, each overridden by a
5
+ * flag. chant reads the job's environment and makes every REST call; yodel
6
+ * keeps the flags and the bodies.
5
7
  *
6
8
  * - GitHub Actions: `GITHUB_ACTIONS=true`. `GITHUB_REPOSITORY`, the PR number
7
- * from the event payload (`GITHUB_EVENT_PATH`: `pull_request.number`, or
8
- * `refs/pull/<n>/merge` in `GITHUB_REF`), `GITHUB_API_URL` (default
9
- * https://api.github.com), token `GITHUB_TOKEN`.
9
+ * from the event payload (`GITHUB_EVENT_PATH`) or `refs/pull/<n>/merge` in
10
+ * `GITHUB_REF`, `GITHUB_API_URL` (default https://api.github.com).
10
11
  * - GitLab CI: `GITLAB_CI=true`. `CI_API_V4_URL`, `CI_PROJECT_ID`,
11
- * `CI_MERGE_REQUEST_IID` (a merge request pipeline), token `GITLAB_TOKEN`
12
- * (a project or personal access token with `api` scope: `CI_JOB_TOKEN`
13
- * cannot write merge request notes).
12
+ * `CI_MERGE_REQUEST_IID` (a merge request pipeline).
14
13
  * - Forgejo Actions: `FORGEJO_ACTIONS=true` (runner 7 and later), or
15
14
  * `GITEA_ACTIONS=true`, or a GitHub-style job whose API URL ends in
16
- * `/api/v1`. `FORGEJO_REPOSITORY` / `GITHUB_REPOSITORY`, the PR number from
17
- * `FORGEJO_EVENT_PATH` / `GITHUB_EVENT_PATH` or the ref, `FORGEJO_API_URL` /
18
- * `GITHUB_API_URL` (else `<server>/api/v1`), token `FORGEJO_TOKEN` /
19
- * `GITHUB_TOKEN`.
15
+ * `/api/v1`. The `FORGEJO_*` variables before the `GITHUB_*` ones, and
16
+ * `<server>/api/v1` when no API URL is set.
20
17
  *
21
- * `--token-env <NAME>` names the variable the token is read from; the token
22
- * itself is never a flag, never printed and never put in an error.
18
+ * The token is the first set of chant's `FORGE_TOKEN_ORDER`:
19
+ * `CHANT_GITHUB_TOKEN`, `GH_TOKEN`, `GITHUB_TOKEN` on GitHub;
20
+ * `CHANT_FORGEJO_TOKEN`, `FORGEJO_TOKEN`, `GH_TOKEN`, `GITHUB_TOKEN` on
21
+ * Forgejo; `CHANT_GITLAB_TOKEN`, `GITLAB_TOKEN`, `CI_JOB_TOKEN` on GitLab
22
+ * (`CI_JOB_TOKEN` cannot write merge request notes or issues: name a project
23
+ * access token with `api` scope). `--token-env <NAME>` names the one
24
+ * variable to read instead; the token itself is never a flag, never printed
25
+ * and never put in an error.
23
26
  */
24
- export type ForgeKind = "github" | "gitlab" | "forgejo";
27
+ import type { ForgeFetch, ForgeKind, ForgeTarget, PrForge } from "@intentius/chant/pr-forge";
28
+ export type { ForgeKind, ForgeTarget, PrForge };
25
29
  export declare const FORGES: readonly ForgeKind[];
26
- export interface ForgeTarget {
27
- forge: ForgeKind;
28
- /** `owner/name` (GitHub, Forgejo), or the project id or path (GitLab). */
29
- repo: string;
30
- /** The PR number (GitHub, Forgejo) or MR iid (GitLab). */
31
- pr: number;
32
- /** The REST API's base, e.g. https://api.github.com, https://gitlab.com/api/v4, https://codeberg.org/api/v1. */
33
- apiUrl: string;
34
- token: string;
35
- /** The variable the token came from, for messages. */
36
- tokenEnv: string;
37
- }
38
30
  export interface ForgeFlags {
39
31
  forge?: string | undefined;
40
32
  repo?: string | undefined;
@@ -42,13 +34,16 @@ export interface ForgeFlags {
42
34
  apiUrl?: string | undefined;
43
35
  tokenEnv?: string | undefined;
44
36
  }
45
- /** Which forge the job runs on, from its environment; `undefined` outside a known CI. */
46
- export declare function detectForge(env: NodeJS.ProcessEnv): ForgeKind | undefined;
47
- /** The PR number from a GitHub-style event payload, or from the ref. */
48
- export declare function prFromEvent(eventPath: string | undefined, ref: string | undefined): number | undefined;
49
- /** Where a job writes on its forge, without a pull request: the repository, the API and the token. */
50
- export type ForgeRepo = Omit<ForgeTarget, "pr">;
51
- /** Resolves the target from flags and the environment, or says what is missing. */
52
- export declare function resolveForgeTarget(flags: ForgeFlags, env: NodeJS.ProcessEnv): ForgeTarget;
53
- /** The repository a job writes to (`yodel drift --issue`), from flags and the environment, or says what is missing. */
54
- export declare function resolveForgeRepo(flags: Omit<ForgeFlags, "pr">, env: NodeJS.ProcessEnv, what?: string): ForgeRepo;
37
+ /** A forge to post to: chant's client, and the target it was made for. */
38
+ export interface Forge {
39
+ target: ForgeTarget;
40
+ client: PrForge;
41
+ }
42
+ /**
43
+ * chant's forge client for `--comment` (`withPr`: the pull request too) or
44
+ * `--issue`, from flags and the environment, or a YodelError saying what is
45
+ * missing. `what` names the option, for messages.
46
+ */
47
+ export declare function resolveForge(flags: ForgeFlags, env: NodeJS.ProcessEnv, what: "--comment" | "--issue", fetchImpl?: ForgeFetch): Promise<Forge>;
48
+ /** `github acme/db`, for messages. */
49
+ export declare const describeForge: (t: ForgeTarget) => string;