@cursor/bdk 0.2.9 → 0.2.10

package/dist/internal/cli-gitlab.js

@@ -9,15 +9,6 @@
  * GitLab-shaped payloads with `X-Gitlab-Token` set from `--secret` /
  * `GITLAB_WEBHOOK_SECRET`.
  */
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
 import { randomUUID } from "node:crypto";
 import { mkdir, writeFile } from "node:fs/promises";
 import { join, resolve as resolvePath } from "node:path";
@@ -60,226 +51,214 @@ Prerequisites:
 
 See also: docs/guides/gitlab.md
 `;
-export function cmdGitlab(subcommand, options) {
-    return __awaiter(this, void 0, void 0, function* () {
-        switch (subcommand) {
-            case undefined:
-            case "help":
-            case "--help":
-            case "-h":
-                process.stdout.write(GITLAB_HELP);
-                return subcommand === undefined ? 1 : 0;
-            case "replay":
-                return cmdGitlabReplay(options);
-            case "events":
-                return cmdGitlabEvents(options);
-            case "forward":
-                return cmdGitlabForward(options);
-            default:
-                process.stderr.write(`Unknown gitlab subcommand: ${subcommand}\n`);
-                process.stdout.write(GITLAB_HELP);
-                return 1;
-        }
-    });
+export async function cmdGitlab(subcommand, options) {
+    switch (subcommand) {
+        case undefined:
+        case "help":
+        case "--help":
+        case "-h":
+            process.stdout.write(GITLAB_HELP);
+            return subcommand === undefined ? 1 : 0;
+        case "replay":
+            return cmdGitlabReplay(options);
+        case "events":
+            return cmdGitlabEvents(options);
+        case "forward":
+            return cmdGitlabForward(options);
+        default:
+            process.stderr.write(`Unknown gitlab subcommand: ${subcommand}\n`);
+            process.stdout.write(GITLAB_HELP);
+            return 1;
+    }
 }
-function resolveTargets(options) {
-    return __awaiter(this, void 0, void 0, function* () {
-        var _a, _b, _c;
-        var _d, _e, _f, _g, _h;
-        const dir = resolvePath(options.dir);
-        const channels = findGitLabChannelTargets(yield resolveAgentMounts(dir));
-        const host = (_d = options.host) !== null && _d !== void 0 ? _d : DEFAULT_HOST;
-        const port = (_e = options.port) !== null && _e !== void 0 ? _e : DEFAULT_PORT;
-        let candidates = channels;
-        if (options.slug !== undefined) {
-            candidates = candidates.filter(c => c.slug === options.slug);
-        }
-        if (options.channel !== undefined) {
-            candidates = candidates.filter(c => c.channelId === options.channel);
-        }
-        if (options.url !== undefined && candidates.length > 1) {
-            process.stderr.write("--url targets a single channel; narrow with --slug/--channel\n");
-            return undefined;
-        }
-        if (candidates.length === 0 && options.url === undefined) {
-            const channelPath = projectPath(resolveProjectRoot(dir), "channels/gitlab.ts");
-            process.stderr.write(`no GitLab channel found. Author ${channelPath} with gitlabChannel(), or pass --url.\n`);
-            return undefined;
-        }
-        if (options.url !== undefined) {
-            return [
-                {
-                    slug: (_f = (_a = candidates[0]) === null || _a === void 0 ? void 0 : _a.slug) !== null && _f !== void 0 ? _f : "",
-                    channelId: (_g = (_b = candidates[0]) === null || _b === void 0 ? void 0 : _b.channelId) !== null && _g !== void 0 ? _g : "",
-                    url: options.url,
-                    events: (_h = (_c = candidates[0]) === null || _c === void 0 ? void 0 : _c.events) !== null && _h !== void 0 ? _h : [],
-                },
-            ];
-        }
-        return candidates.map(c => ({
+async function resolveTargets(options) {
+    const dir = resolvePath(options.dir);
+    const channels = findGitLabChannelTargets(await resolveAgentMounts(dir));
+    const host = options.host ?? DEFAULT_HOST;
+    const port = options.port ?? DEFAULT_PORT;
+    let candidates = channels;
+    if (options.slug !== undefined) {
+        candidates = candidates.filter(c => c.slug === options.slug);
+    }
+    if (options.channel !== undefined) {
+        candidates = candidates.filter(c => c.channelId === options.channel);
+    }
+    if (options.url !== undefined && candidates.length > 1) {
+        process.stderr.write("--url targets a single channel; narrow with --slug/--channel\n");
+        return undefined;
+    }
+    if (candidates.length === 0 && options.url === undefined) {
+        const channelPath = projectPath(resolveProjectRoot(dir), "channels/gitlab.ts");
+        process.stderr.write(`no GitLab channel found. Author ${channelPath} with gitlabChannel(), or pass --url.\n`);
+        return undefined;
+    }
+    if (options.url !== undefined) {
+        return [
+            {
+                slug: candidates[0]?.slug ?? "",
+                channelId: candidates[0]?.channelId ?? "",
+                url: options.url,
+                events: candidates[0]?.events ?? [],
+            },
+        ];
+    }
+    return candidates.map(c => ({
+        slug: c.slug,
+        channelId: c.channelId,
+        url: channelForwardUrl({
+            host,
+            port,
             slug: c.slug,
             channelId: c.channelId,
-            url: channelForwardUrl({
-                host,
-                port,
-                slug: c.slug,
-                channelId: c.channelId,
-                routePath: c.routePath,
-            }),
-            events: c.events,
-        }));
-    });
+            routePath: c.routePath,
+        }),
+        events: c.events,
+    }));
 }
-function cmdGitlabReplay(options) {
-    return __awaiter(this, void 0, void 0, function* () {
-        var _a;
-        var _b;
-        const mrUrl = options.mrUrl;
-        if (mrUrl === undefined || mrUrl === "") {
-            process.stderr.write("gitlab replay needs an MR URL or group/project!N\n");
-            return 1;
+async function cmdGitlabReplay(options) {
+    const mrUrl = options.mrUrl;
+    if (mrUrl === undefined || mrUrl === "") {
+        process.stderr.write("gitlab replay needs an MR URL or group/project!N\n");
+        return 1;
+    }
+    const ref = parseGitLabMrRef(mrUrl);
+    if (ref === undefined) {
+        process.stderr.write(`could not parse merge request ref: ${mrUrl}\n`);
+        return 1;
+    }
+    const targets = await resolveTargets(options);
+    if (targets === undefined) {
+        return 1;
+    }
+    const requested = parseEventList(options.events);
+    const declared = [...new Set(targets.flatMap(target => target.events))];
+    const { events, unsupported } = selectGitLabReplayEvents(requested, declared);
+    if (unsupported.length > 0) {
+        process.stderr.write(`[bdk] cannot synthesize (skipped): ${unsupported.join(", ")}\n`);
+    }
+    if (events.length === 0) {
+        process.stderr.write("no synthesizable events selected\n");
+        return 1;
+    }
+    // Read the MR — Reporter access is enough.
+    const gitlab = createGitLabClient({
+        apiBaseUrl: process.env.GITLAB_API_BASE_URL?.trim() || `${ref.origin}/api/v4`,
+    });
+    const projectSegment = gitlabProjectPathSegment(ref.projectPath);
+    let project;
+    let mergeRequest;
+    try {
+        project = await gitlab.request({
+            method: "GET",
+            path: `/projects/${projectSegment}`,
+        });
+        mergeRequest = await gitlab.request({
+            method: "GET",
+            path: `/projects/${projectSegment}/merge_requests/${ref.iid}`,
+        });
+    }
+    catch (error) {
+        process.stderr.write(`failed to read ${ref.label} via ${gitlab.apiBaseUrl}: ${error instanceof Error ? error.message : String(error)}\n`);
+        return 1;
+    }
+    let pipeline;
+    if (events.includes("pipeline")) {
+        pipeline = await gitlab
+            .request({
+            method: "GET",
+            path: `/projects/${projectSegment}/merge_requests/${ref.iid}/pipelines`,
+        })
+            .then(list => list[0])
+            .catch(() => undefined);
+    }
+    const synthesized = [];
+    for (const event of events) {
+        const result = synthesizeGitLabEvent({
+            event,
+            project,
+            mergeRequest,
+            action: options.action,
+            comment: options.comment,
+            status: options.conclusion,
+            pipeline,
+        });
+        if ("error" in result) {
+            process.stderr.write(`[bdk] skipping ${event}: ${result.error}\n`);
+            continue;
         }
-        const ref = parseGitLabMrRef(mrUrl);
-        if (ref === undefined) {
-            process.stderr.write(`could not parse merge request ref: ${mrUrl}\n`);
-            return 1;
+        synthesized.push(result);
+    }
+    if (synthesized.length === 0) {
+        process.stderr.write("nothing to replay after synthesis\n");
+        return 1;
+    }
+    const secret = options.secret ?? process.env.GITLAB_WEBHOOK_SECRET;
+    process.stderr.write(`[bdk] replaying ${ref.label} (${synthesized
+        .map(eventLabel)
+        .join(", ")}) → ${targets.length} channel${targets.length === 1 ? "" : "s"}\n`);
+    const report = [];
+    let anyRejected = false;
+    for (const event of synthesized) {
+        const body = JSON.stringify(event.payload);
+        const headers = {
+            "content-type": "application/json",
+            "x-gitlab-event": event.header,
+            "x-gitlab-event-uuid": randomUUID(),
+        };
+        if (secret !== undefined && secret !== "") {
+            headers["x-gitlab-token"] = secret;
         }
-        const targets = yield resolveTargets(options);
-        if (targets === undefined) {
-            return 1;
+        if (options.out !== undefined) {
+            const file = await writeReplayFixture(options.out, event);
+            process.stderr.write(`[bdk] wrote ${file}\n`);
+        }
+        const label = eventLabel(event);
+        if (options.dryRun === true) {
+            report.push({ ...eventReport(event), payload: event.payload });
+            if (options.json !== true) {
+                process.stdout.write(`--- ${label} ---\n${JSON.stringify(event.payload, null, 2)}\n`);
+            }
+            continue;
         }
-        const requested = parseEventList(options.events);
-        const declared = [...new Set(targets.flatMap(target => target.events))];
-        const { events, unsupported } = selectGitLabReplayEvents(requested, declared);
-        if (unsupported.length > 0) {
-            process.stderr.write(`[bdk] cannot synthesize (skipped): ${unsupported.join(", ")}\n`);
+        const deliveries = await deliverReplayEvent(body, headers, event.eventName, targets);
+        if (deliveries.length === 0 || deliveries.some(d => !d.ok)) {
+            anyRejected = true;
         }
-        if (events.length === 0) {
-            process.stderr.write("no synthesizable events selected\n");
-            return 1;
+        report.push({ ...eventReport(event), deliveries });
+        if (options.json !== true) {
+            const summary = deliveries
+                .map(d => `${d.label} ${d.status || "ERR"}${d.ok ? "" : " (rejected)"}`)
+                .join(", ") || "(no matching channel)";
+            process.stderr.write(`[bdk]   ${label} → ${summary}\n`);
         }
-        // Read the MR — Reporter access is enough.
-        const gitlab = createGitLabClient({
-            apiBaseUrl: ((_a = process.env.GITLAB_API_BASE_URL) === null || _a === void 0 ? void 0 : _a.trim()) || `${ref.origin}/api/v4`,
-        });
-        const projectSegment = gitlabProjectPathSegment(ref.projectPath);
-        let project;
-        let mergeRequest;
+    }
+    if (options.json === true) {
+        process.stdout.write(`${JSON.stringify({ mr: ref.label, dryRun: options.dryRun === true, events: report }, null, 2)}\n`);
+    }
+    return anyRejected ? 1 : 0;
+}
+async function deliverReplayEvent(body, headers, eventName, targets) {
+    const recipients = targets.filter(target => target.events.length === 0 || target.events.includes(eventName));
+    return Promise.all(recipients.map(async (target) => {
+        const label = target.slug === "" ? target.channelId : `${target.slug}/${target.channelId}`;
         try {
-            project = yield gitlab.request({
-                method: "GET",
-                path: `/projects/${projectSegment}`,
-            });
-            mergeRequest = yield gitlab.request({
-                method: "GET",
-                path: `/projects/${projectSegment}/merge_requests/${ref.iid}`,
+            const response = await fetch(target.url, {
+                method: "POST",
+                headers,
+                body,
             });
+            await response.text().catch(() => undefined);
+            return { label, status: response.status, ok: response.ok };
         }
         catch (error) {
-            process.stderr.write(`failed to read ${ref.label} via ${gitlab.apiBaseUrl}: ${error instanceof Error ? error.message : String(error)}\n`);
-            return 1;
-        }
-        let pipeline;
-        if (events.includes("pipeline")) {
-            pipeline = yield gitlab
-                .request({
-                method: "GET",
-                path: `/projects/${projectSegment}/merge_requests/${ref.iid}/pipelines`,
-            })
-                .then(list => list[0])
-                .catch(() => undefined);
-        }
-        const synthesized = [];
-        for (const event of events) {
-            const result = synthesizeGitLabEvent({
-                event,
-                project,
-                mergeRequest,
-                action: options.action,
-                comment: options.comment,
-                status: options.conclusion,
-                pipeline,
-            });
-            if ("error" in result) {
-                process.stderr.write(`[bdk] skipping ${event}: ${result.error}\n`);
-                continue;
-            }
-            synthesized.push(result);
-        }
-        if (synthesized.length === 0) {
-            process.stderr.write("nothing to replay after synthesis\n");
-            return 1;
-        }
-        const secret = (_b = options.secret) !== null && _b !== void 0 ? _b : process.env.GITLAB_WEBHOOK_SECRET;
-        process.stderr.write(`[bdk] replaying ${ref.label} (${synthesized
-            .map(eventLabel)
-            .join(", ")}) → ${targets.length} channel${targets.length === 1 ? "" : "s"}\n`);
-        const report = [];
-        let anyRejected = false;
-        for (const event of synthesized) {
-            const body = JSON.stringify(event.payload);
-            const headers = {
-                "content-type": "application/json",
-                "x-gitlab-event": event.header,
-                "x-gitlab-event-uuid": randomUUID(),
+            return {
+                label,
+                status: 0,
+                ok: false,
+                error: error instanceof Error ? error.message : String(error),
             };
-            if (secret !== undefined && secret !== "") {
-                headers["x-gitlab-token"] = secret;
-            }
-            if (options.out !== undefined) {
-                const file = yield writeReplayFixture(options.out, event);
-                process.stderr.write(`[bdk] wrote ${file}\n`);
-            }
-            const label = eventLabel(event);
-            if (options.dryRun === true) {
-                report.push(Object.assign(Object.assign({}, eventReport(event)), { payload: event.payload }));
-                if (options.json !== true) {
-                    process.stdout.write(`--- ${label} ---\n${JSON.stringify(event.payload, null, 2)}\n`);
-                }
-                continue;
-            }
-            const deliveries = yield deliverReplayEvent(body, headers, event.eventName, targets);
-            if (deliveries.length === 0 || deliveries.some(d => !d.ok)) {
-                anyRejected = true;
-            }
-            report.push(Object.assign(Object.assign({}, eventReport(event)), { deliveries }));
-            if (options.json !== true) {
-                const summary = deliveries
-                    .map(d => `${d.label} ${d.status || "ERR"}${d.ok ? "" : " (rejected)"}`)
-                    .join(", ") || "(no matching channel)";
-                process.stderr.write(`[bdk]   ${label} → ${summary}\n`);
-            }
-        }
-        if (options.json === true) {
-            process.stdout.write(`${JSON.stringify({ mr: ref.label, dryRun: options.dryRun === true, events: report }, null, 2)}\n`);
         }
-        return anyRejected ? 1 : 0;
-    });
-}
-function deliverReplayEvent(body, headers, eventName, targets) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const recipients = targets.filter(target => target.events.length === 0 || target.events.includes(eventName));
-        return Promise.all(recipients.map((target) => __awaiter(this, void 0, void 0, function* () {
-            const label = target.slug === "" ? target.channelId : `${target.slug}/${target.channelId}`;
-            try {
-                const response = yield fetch(target.url, {
-                    method: "POST",
-                    headers,
-                    body,
-                });
-                yield response.text().catch(() => undefined);
-                return { label, status: response.status, ok: response.ok };
-            }
-            catch (error) {
-                return {
-                    label,
-                    status: 0,
-                    ok: false,
-                    error: error instanceof Error ? error.message : String(error),
-                };
-            }
-        })));
-    });
+    }));
 }
 function eventLabel(event) {
     return event.action === undefined ? event.eventName : `${event.eventName}.${event.action}`;
@@ -287,85 +266,77 @@ function eventLabel(event) {
 function eventReport(event) {
     return { event: event.eventName, action: event.action };
 }
-function writeReplayFixture(outDir, event) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const dir = resolvePath(outDir);
-        yield mkdir(dir, { recursive: true });
-        const file = join(dir, `gitlab-${eventLabel(event)}.json`);
-        yield writeFile(file, `${JSON.stringify(event.payload, null, 2)}\n`);
-        return file;
-    });
+async function writeReplayFixture(outDir, event) {
+    const dir = resolvePath(outDir);
+    await mkdir(dir, { recursive: true });
+    const file = join(dir, `gitlab-${eventLabel(event)}.json`);
+    await writeFile(file, `${JSON.stringify(event.payload, null, 2)}\n`);
+    return file;
 }
-function cmdGitlabEvents(options) {
-    return __awaiter(this, void 0, void 0, function* () {
-        var _a, _b;
-        const dir = resolvePath(options.dir);
-        const channels = findGitLabChannelTargets(yield resolveAgentMounts(dir));
-        const host = (_a = options.host) !== null && _a !== void 0 ? _a : DEFAULT_HOST;
-        const port = (_b = options.port) !== null && _b !== void 0 ? _b : DEFAULT_PORT;
-        const rows = channels.map(c => ({
+async function cmdGitlabEvents(options) {
+    const dir = resolvePath(options.dir);
+    const channels = findGitLabChannelTargets(await resolveAgentMounts(dir));
+    const host = options.host ?? DEFAULT_HOST;
+    const port = options.port ?? DEFAULT_PORT;
+    const rows = channels.map(c => ({
+        slug: c.slug,
+        channelId: c.channelId,
+        url: channelForwardUrl({
+            host,
+            port,
             slug: c.slug,
             channelId: c.channelId,
-            url: channelForwardUrl({
-                host,
-                port,
-                slug: c.slug,
-                channelId: c.channelId,
-                routePath: c.routePath,
-            }),
-            events: c.events,
-        }));
-        if (options.json === true) {
-            process.stdout.write(`${JSON.stringify({ channels: rows }, null, 2)}\n`);
-            return 0;
-        }
-        if (rows.length === 0) {
-            process.stdout.write("no GitLab channels found\n");
-            return 0;
-        }
-        for (const row of rows) {
-            const label = row.slug === "" ? row.channelId : `${row.slug}/${row.channelId}`;
-            process.stdout.write(`${label}\n  ${row.url}\n  ${row.events.join(", ")}\n`);
-        }
+            routePath: c.routePath,
+        }),
+        events: c.events,
+    }));
+    if (options.json === true) {
+        process.stdout.write(`${JSON.stringify({ channels: rows }, null, 2)}\n`);
         return 0;
-    });
-}
-function cmdGitlabForward(options) {
-    return __awaiter(this, void 0, void 0, function* () {
-        var _a, _b;
-        const dir = resolvePath(options.dir);
-        const channels = findGitLabChannelTargets(yield resolveAgentMounts(dir));
-        const host = (_a = options.host) !== null && _a !== void 0 ? _a : DEFAULT_HOST;
-        const port = (_b = options.port) !== null && _b !== void 0 ? _b : DEFAULT_PORT;
-        if (channels.length === 0) {
-            const channelPath = projectPath(resolveProjectRoot(dir), "channels/gitlab.ts");
-            process.stderr.write(`no GitLab channel found. Author ${channelPath} with gitlabChannel().\n`);
-            return 1;
-        }
-        const lines = [
-            "GitLab project hooks deliver to a public URL; there is no local relay.",
-            "To receive live deliveries:",
-            "",
-            `  1. Expose the agent: e.g. \`cloudflared tunnel --url http://${host}:${port}\``,
-            "     (or ngrok / any HTTPS tunnel) and note the public base URL.",
-            "  2. In GitLab → Project → Settings → Webhooks, add one hook per channel:",
-        ];
-        for (const c of channels) {
-            const path = channelForwardUrl({
-                host,
-                port,
-                slug: c.slug,
-                channelId: c.channelId,
-                routePath: c.routePath,
-            }).replace(`http://${host}:${port}`, "<tunnel>");
-            lines.push(`       URL:     ${path}`);
-            lines.push(`       Trigger: ${c.events.join(", ")}`);
-            lines.push("       Secret token: the value of GITLAB_WEBHOOK_SECRET (or webhookSecret)");
-        }
-        lines.push("", `  3. Serve with the secret set so X-Gitlab-Token is verified:`, `     GITLAB_WEBHOOK_SECRET=… ${CLI} serve --dir . --dev`, "", `Without a tunnel, \`${CLI} gitlab replay <mr_url>\` exercises the same channel locally.`, "");
-        process.stdout.write(lines.join("\n"));
+    }
+    if (rows.length === 0) {
+        process.stdout.write("no GitLab channels found\n");
         return 0;
-    });
+    }
+    for (const row of rows) {
+        const label = row.slug === "" ? row.channelId : `${row.slug}/${row.channelId}`;
+        process.stdout.write(`${label}\n  ${row.url}\n  ${row.events.join(", ")}\n`);
+    }
+    return 0;
+}
+async function cmdGitlabForward(options) {
+    const dir = resolvePath(options.dir);
+    const channels = findGitLabChannelTargets(await resolveAgentMounts(dir));
+    const host = options.host ?? DEFAULT_HOST;
+    const port = options.port ?? DEFAULT_PORT;
+    if (channels.length === 0) {
+        const channelPath = projectPath(resolveProjectRoot(dir), "channels/gitlab.ts");
+        process.stderr.write(`no GitLab channel found. Author ${channelPath} with gitlabChannel().\n`);
+        return 1;
+    }
+    const lines = [
+        "GitLab project hooks deliver to a public URL; there is no local relay.",
+        "To receive live deliveries:",
+        "",
+        `  1. Expose the agent: e.g. \`cloudflared tunnel --url http://${host}:${port}\``,
+        "     (or ngrok / any HTTPS tunnel) and note the public base URL.",
+        "  2. In GitLab → Project → Settings → Webhooks, add one hook per channel:",
+    ];
+    for (const c of channels) {
+        const path = channelForwardUrl({
+            host,
+            port,
+            slug: c.slug,
+            channelId: c.channelId,
+            routePath: c.routePath,
+        }).replace(`http://${host}:${port}`, "<tunnel>");
+        lines.push(`       URL:     ${path}`);
+        lines.push(`       Trigger: ${c.events.join(", ")}`);
+        lines.push("       Secret token: the value of GITLAB_WEBHOOK_SECRET (or webhookSecret)");
+    }
+    lines.push("", `  3. Serve with the secret set so X-Gitlab-Token is verified:`, `     GITLAB_WEBHOOK_SECRET=… ${CLI} serve --dir . --dev`, "", `Without a tunnel, \`${CLI} gitlab replay <mr_url>\` exercises the same channel locally.`, "");
+    process.stdout.write(lines.join("\n"));
+    return 0;
 }
 function parseEventList(value) {
     if (value === undefined) {