@cursor/bdk 0.2.9 → 0.2.11

package/dist/internal/cli-bitbucket.js

@@ -9,15 +9,6 @@
  * payloads with `X-Hub-Signature` computed from `--secret` /
  * `BITBUCKET_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,293 +51,274 @@ Prerequisites:
     access token; or set BITBUCKET_API_BASE_URL to the REST base).
   - The agent already serving (\`${CLI} serve --dir . --dev\`).
 `;
-export function cmdBitbucket(subcommand, options) {
-    return __awaiter(this, void 0, void 0, function* () {
-        switch (subcommand) {
-            case undefined:
-            case "help":
-            case "--help":
-            case "-h":
-                process.stdout.write(BITBUCKET_HELP);
-                return subcommand === undefined ? 1 : 0;
-            case "replay":
-                return cmdBitbucketReplay(options);
-            case "events":
-                return cmdBitbucketEvents(options);
-            case "forward":
-                return cmdBitbucketForward(options);
-            default:
-                process.stderr.write(`Unknown bitbucket subcommand: ${subcommand}\n`);
-                process.stdout.write(BITBUCKET_HELP);
-                return 1;
-        }
-    });
+export async function cmdBitbucket(subcommand, options) {
+    switch (subcommand) {
+        case undefined:
+        case "help":
+        case "--help":
+        case "-h":
+            process.stdout.write(BITBUCKET_HELP);
+            return subcommand === undefined ? 1 : 0;
+        case "replay":
+            return cmdBitbucketReplay(options);
+        case "events":
+            return cmdBitbucketEvents(options);
+        case "forward":
+            return cmdBitbucketForward(options);
+        default:
+            process.stderr.write(`Unknown bitbucket subcommand: ${subcommand}\n`);
+            process.stdout.write(BITBUCKET_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 = findBitbucketChannelTargets(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/bitbucket.ts");
-            process.stderr.write(`no Bitbucket channel found. Author ${channelPath} with bitbucketChannel(), 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 = findBitbucketChannelTargets(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/bitbucket.ts");
+        process.stderr.write(`no Bitbucket channel found. Author ${channelPath} with bitbucketChannel(), 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 cmdBitbucketReplay(options) {
-    return __awaiter(this, void 0, void 0, function* () {
-        var _a;
-        const prUrl = options.prUrl;
-        if (prUrl === undefined || prUrl === "") {
-            process.stderr.write("bitbucket replay needs a PR URL or workspace/repo#N\n");
-            return 1;
+async function cmdBitbucketReplay(options) {
+    const prUrl = options.prUrl;
+    if (prUrl === undefined || prUrl === "") {
+        process.stderr.write("bitbucket replay needs a PR URL or workspace/repo#N\n");
+        return 1;
+    }
+    const ref = parseBitbucketPrRef(prUrl);
+    if (ref === undefined) {
+        process.stderr.write(`could not parse pull request ref: ${prUrl}\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 } = selectBitbucketReplayEvents(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 PR in the host's dialect — read access is enough.
+    const apiBaseUrl = bitbucketApiBaseUrl({
+        dialect: ref.dialect,
+        repoHtmlUrl: ref.repository.htmlUrl,
+    });
+    let pullRequest;
+    try {
+        const client = createBitbucketClient({ apiBaseUrl });
+        pullRequest = await createBitbucketApi(client, ref.repository).getPullRequest(ref.id);
+    }
+    catch (error) {
+        process.stderr.write(`failed to read ${ref.label} via ${apiBaseUrl ?? "(no API base)"}: ${error instanceof Error ? error.message : String(error)}\n`);
+        return 1;
+    }
+    const synthesized = [];
+    for (const event of events) {
+        const result = synthesizeBitbucketEvent({
+            event,
+            ref,
+            pullRequest,
+            comment: options.comment,
+        });
+        if ("error" in result) {
+            process.stderr.write(`[bdk] skipping ${event}: ${result.error}\n`);
+            continue;
         }
-        const ref = parseBitbucketPrRef(prUrl);
-        if (ref === undefined) {
-            process.stderr.write(`could not parse pull request ref: ${prUrl}\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.BITBUCKET_WEBHOOK_SECRET;
+    process.stderr.write(`[bdk] replaying ${ref.label} (${ref.dialect}; ${synthesized
+        .map(event => event.eventType)
+        .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-event-key": event.header,
+            "x-request-uuid": randomUUID(),
+        };
+        if (secret !== undefined && secret !== "") {
+            headers["x-hub-signature"] = signBitbucketWebhookBody(body, 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`);
+        }
+        if (options.dryRun === true) {
+            report.push({ ...eventReport(event), payload: event.payload });
+            if (options.json !== true) {
+                process.stdout.write(`--- ${event.header} ---\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 } = selectBitbucketReplayEvents(requested, declared);
-        if (unsupported.length > 0) {
-            process.stderr.write(`[bdk] cannot synthesize (skipped): ${unsupported.join(", ")}\n`);
+        const deliveries = await deliverReplayEvent(body, headers, event.eventType, 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]   ${event.header} → ${summary}\n`);
         }
-        // Read the PR in the host's dialect — read access is enough.
-        const apiBaseUrl = bitbucketApiBaseUrl({
+    }
+    if (options.json === true) {
+        process.stdout.write(`${JSON.stringify({
+            pr: ref.label,
             dialect: ref.dialect,
-            repoHtmlUrl: ref.repository.htmlUrl,
-        });
-        let pullRequest;
+            dryRun: options.dryRun === true,
+            events: report,
+        }, null, 2)}\n`);
+    }
+    return anyRejected ? 1 : 0;
+}
+async function deliverReplayEvent(body, headers, eventType, targets) {
+    const recipients = targets.filter(target => target.events.length === 0 || target.events.includes(eventType));
+    return Promise.all(recipients.map(async (target) => {
+        const label = target.slug === "" ? target.channelId : `${target.slug}/${target.channelId}`;
         try {
-            const client = createBitbucketClient({ apiBaseUrl });
-            pullRequest = yield createBitbucketApi(client, ref.repository).getPullRequest(ref.id);
-        }
-        catch (error) {
-            process.stderr.write(`failed to read ${ref.label} via ${apiBaseUrl !== null && apiBaseUrl !== void 0 ? apiBaseUrl : "(no API base)"}: ${error instanceof Error ? error.message : String(error)}\n`);
-            return 1;
-        }
-        const synthesized = [];
-        for (const event of events) {
-            const result = synthesizeBitbucketEvent({
-                event,
-                ref,
-                pullRequest,
-                comment: options.comment,
+            const response = await fetch(target.url, {
+                method: "POST",
+                headers,
+                body,
             });
-            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;
+            await response.text().catch(() => undefined);
+            return { label, status: response.status, ok: response.ok };
         }
-        const secret = (_a = options.secret) !== null && _a !== void 0 ? _a : process.env.BITBUCKET_WEBHOOK_SECRET;
-        process.stderr.write(`[bdk] replaying ${ref.label} (${ref.dialect}; ${synthesized
-            .map(event => event.eventType)
-            .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-event-key": event.header,
-                "x-request-uuid": randomUUID(),
+        catch (error) {
+            return {
+                label,
+                status: 0,
+                ok: false,
+                error: error instanceof Error ? error.message : String(error),
             };
-            if (secret !== undefined && secret !== "") {
-                headers["x-hub-signature"] = signBitbucketWebhookBody(body, secret);
-            }
-            if (options.out !== undefined) {
-                const file = yield writeReplayFixture(options.out, event);
-                process.stderr.write(`[bdk] wrote ${file}\n`);
-            }
-            if (options.dryRun === true) {
-                report.push(Object.assign(Object.assign({}, eventReport(event)), { payload: event.payload }));
-                if (options.json !== true) {
-                    process.stdout.write(`--- ${event.header} ---\n${JSON.stringify(event.payload, null, 2)}\n`);
-                }
-                continue;
-            }
-            const deliveries = yield deliverReplayEvent(body, headers, event.eventType, 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]   ${event.header} → ${summary}\n`);
-            }
         }
-        if (options.json === true) {
-            process.stdout.write(`${JSON.stringify({
-                pr: ref.label,
-                dialect: ref.dialect,
-                dryRun: options.dryRun === true,
-                events: report,
-            }, null, 2)}\n`);
-        }
-        return anyRejected ? 1 : 0;
-    });
-}
-function deliverReplayEvent(body, headers, eventType, targets) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const recipients = targets.filter(target => target.events.length === 0 || target.events.includes(eventType));
-        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 eventReport(event) {
     return { event: event.eventType, header: event.header };
 }
-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, `bitbucket-${event.header.replace(/[^\w.-]+/g, "-")}.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, `bitbucket-${event.header.replace(/[^\w.-]+/g, "-")}.json`);
+    await writeFile(file, `${JSON.stringify(event.payload, null, 2)}\n`);
+    return file;
 }
-function cmdBitbucketEvents(options) {
-    return __awaiter(this, void 0, void 0, function* () {
-        var _a, _b;
-        const dir = resolvePath(options.dir);
-        const channels = findBitbucketChannelTargets(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 cmdBitbucketEvents(options) {
+    const dir = resolvePath(options.dir);
+    const channels = findBitbucketChannelTargets(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 Bitbucket 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 cmdBitbucketForward(options) {
-    return __awaiter(this, void 0, void 0, function* () {
-        var _a, _b;
-        const dir = resolvePath(options.dir);
-        const channels = findBitbucketChannelTargets(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/bitbucket.ts");
-            process.stderr.write(`no Bitbucket channel found. Author ${channelPath} with bitbucketChannel().\n`);
-            return 1;
-        }
-        const lines = [
-            "Bitbucket repository 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 Bitbucket → Repository settings → Webhooks, add one hook per channel",
-            "     (Cloud triggers use the keys below; Data Center shows the pr:* names):",
-        ];
-        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(`       Triggers: ${c.events.join(", ")}`);
-            lines.push("       Secret:   the value of BITBUCKET_WEBHOOK_SECRET (or webhookSecret)");
-        }
-        lines.push("", "  3. Serve with the secret set so X-Hub-Signature is verified:", `     BITBUCKET_WEBHOOK_SECRET=… ${CLI} serve --dir . --dev`, "", `Without a tunnel, \`${CLI} bitbucket replay <pr_url>\` exercises the same channel locally.`, "");
-        process.stdout.write(lines.join("\n"));
+    }
+    if (rows.length === 0) {
+        process.stdout.write("no Bitbucket 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 cmdBitbucketForward(options) {
+    const dir = resolvePath(options.dir);
+    const channels = findBitbucketChannelTargets(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/bitbucket.ts");
+        process.stderr.write(`no Bitbucket channel found. Author ${channelPath} with bitbucketChannel().\n`);
+        return 1;
+    }
+    const lines = [
+        "Bitbucket repository 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 Bitbucket → Repository settings → Webhooks, add one hook per channel",
+        "     (Cloud triggers use the keys below; Data Center shows the pr:* names):",
+    ];
+    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(`       Triggers: ${c.events.join(", ")}`);
+        lines.push("       Secret:   the value of BITBUCKET_WEBHOOK_SECRET (or webhookSecret)");
+    }
+    lines.push("", "  3. Serve with the secret set so X-Hub-Signature is verified:", `     BITBUCKET_WEBHOOK_SECRET=… ${CLI} serve --dir . --dev`, "", `Without a tunnel, \`${CLI} bitbucket replay <pr_url>\` exercises the same channel locally.`, "");
+    process.stdout.write(lines.join("\n"));
+    return 0;
 }
 function parseEventList(value) {
     if (value === undefined) {