@cursor/july 0.1.102 → 0.1.104

package/dist/channels/bitbucket/api.d.ts

@@ -0,0 +1,176 @@
+/**
+ * Bitbucket REST client for the Bitbucket channel — the `createGitLabClient`
+ * analogue, with one `BitbucketApi` facade implemented twice: Cloud 2.0
+ * (`https://api.bitbucket.org/2.0/repositories/{workspace}/{slug}/…`) and
+ * Data Center 1.0 (`<host>/rest/api/1.0/projects/{KEY}/repos/{slug}/…`).
+ * The dialect comes from the delivery payload shape, never a round trip.
+ *
+ * Two transports:
+ *
+ * - **Direct**: `Authorization: Bearer` with a repository / workspace /
+ *   HTTP access token from options or `BITBUCKET_TOKEN`. The base defaults
+ *   to `BITBUCKET_API_BASE_URL`, else api.bitbucket.org (Cloud). Data Center
+ *   deploys must configure one; `ctx.bitbucket` never derives the host from
+ *   the webhook payload — only the replay CLI passes a user-supplied repo URL.
+ * - **Proxy** (`--cursor-scm-proxy` with `cursorAccount`): the backend
+ *   forwarder at `/v0/bitbucket-proxy`. Calls carry the Cursor API key as
+ *   the bearer plus `x-cursor-bitbucket-repos` naming the repo the call is
+ *   scoped to; the backend swaps in the tenant's Bitbucket credential and
+ *   picks the upstream (Cloud 2.0 or the DC host's 1.0) per tenant.
+ */
+import type { BitbucketDialect, BitbucketRepositoryRef } from "./types.js";
+export declare const DEFAULT_BITBUCKET_CLOUD_API_BASE_URL = "https://api.bitbucket.org/2.0";
+/** Header the SCM proxy reads to scope a Bitbucket call to one repo. */
+export declare const CURSOR_BITBUCKET_REPOS_HEADER = "x-cursor-bitbucket-repos";
+export type BitbucketApiMethod = "DELETE" | "GET" | "PATCH" | "POST" | "PUT";
+/** Normalized Bitbucket REST failure — the `GitLabApiError` analogue. */
+export declare class BitbucketApiError extends Error {
+    readonly body: unknown;
+    readonly method: string;
+    readonly path: string;
+    readonly status: number;
+    constructor(input: {
+        body: unknown;
+        method: string;
+        path: string;
+        status: number;
+    });
+}
+export type BitbucketTokenProvider = () => Promise<string> | string;
+/** Backend SCM-proxy transport bound by the serve host in proxy mode. */
+export interface BitbucketProxyTransport {
+    /** `/v0/bitbucket-proxy` base, see `resolveCursorBitbucketProxyUrl`. */
+    apiBaseUrl: string;
+    /** Cursor API key sent as the bearer; the proxy swaps in the Bitbucket token. */
+    getApiKey: () => Promise<string>;
+    /** Static headers added to every call (repo scope when declared). */
+    headers?: Readonly<Record<string, string>>;
+}
+export interface BitbucketClientOptions {
+    /**
+     * REST base, e.g. `https://bitbucket.example.com/rest/api/1.0`. Falls back
+     * to `BITBUCKET_API_BASE_URL`.
+     */
+    apiBaseUrl?: string;
+    /** Access token or provider for direct calls. Falls back to `BITBUCKET_TOKEN`. */
+    token?: string | BitbucketTokenProvider;
+    /** Route through the Cursor SCM proxy instead of calling Bitbucket directly. */
+    proxy?: BitbucketProxyTransport;
+    /**
+     * Repo (`workspace/slug` or `PROJECT/slug`) every call is scoped to.
+     * Proxy mode sends it as `x-cursor-bitbucket-repos` when no static header
+     * names one.
+     */
+    repo?: string;
+    /** Injectable fetch for tests. */
+    fetch?: typeof fetch;
+}
+export interface BitbucketRequestInput {
+    method: BitbucketApiMethod;
+    /** Path under the API base, e.g. `/repositories/acme/widgets/pullrequests/7`. */
+    path: string;
+    query?: Record<string, string | number | boolean | undefined>;
+    body?: unknown;
+    /**
+     * `Accept` header. `application/json` (default) parses the body; anything
+     * else (`text/plain` for diffs and raw files) returns the body text.
+     */
+    accept?: string;
+}
+/** Minimal authenticated Bitbucket REST client. */
+export interface BitbucketClient {
+    readonly apiBaseUrl: string;
+    /** Call a Bitbucket REST path. Throws {@link BitbucketApiError} on non-2xx. */
+    request<T = unknown>(input: BitbucketRequestInput): Promise<T>;
+}
+/** `BITBUCKET_TOKEN` when set. */
+export declare function envBitbucketToken(env?: NodeJS.ProcessEnv): string | undefined;
+/**
+ * REST base for direct calls: `BITBUCKET_API_BASE_URL`, else api.bitbucket.org
+ * 2.0 for Cloud, else `/rest/api/1.0` on `repoHtmlUrl`'s origin. Callers must
+ * only pass a `repoHtmlUrl` the operator supplied (the replay CLI), never one
+ * read from a delivery payload.
+ */
+export declare function bitbucketApiBaseUrl(input: {
+    dialect: BitbucketDialect;
+    repoHtmlUrl?: string;
+    env?: NodeJS.ProcessEnv;
+}): string | undefined;
+export declare function createBitbucketClient(options?: BitbucketClientOptions): BitbucketClient;
+/** Build-status states shared by both dialects (DC `STOPPED` → `CANCELLED`). */
+export type BitbucketBuildStatusState = "INPROGRESS" | "SUCCESSFUL" | "FAILED" | "STOPPED";
+export interface BitbucketBuildStatusInput {
+    sha: string;
+    /** Stable key per status row (`cursor/security-review`). */
+    key: string;
+    state: BitbucketBuildStatusState;
+    /** Display name; defaults to {@link key}. */
+    name?: string;
+    /** "Details" link. Both dialects require one; falls back to the repo URL. */
+    url?: string;
+    description?: string;
+}
+export interface BitbucketPullRequestCommentInput {
+    body: string;
+    /**
+     * Anchor the comment to a file line. Cloud posts `inline`; Data Center
+     * posts an `anchor` on the destination side. Omit for a top-level comment.
+     */
+    inline?: {
+        path: string;
+        line?: number;
+    };
+}
+/** Comment as returned by either dialect, minimally normalized. */
+export interface BitbucketApiComment {
+    id: number;
+    body: string;
+    authorId?: string;
+    path?: string;
+    line?: number;
+    raw: unknown;
+}
+/** Pull request as returned by either dialect, minimally normalized. */
+export interface BitbucketApiPullRequest {
+    id: number;
+    title?: string;
+    description?: string;
+    state?: string;
+    sourceBranch?: string;
+    targetBranch?: string;
+    headSha?: string;
+    baseSha?: string;
+    htmlUrl?: string;
+    raw: unknown;
+}
+/**
+ * The handful of operations review products need, implemented once per
+ * dialect. `ctx.bitbucket.api` is the repo-bound instance.
+ */
+export interface BitbucketApi {
+    readonly dialect: BitbucketDialect;
+    readonly repository: BitbucketRepositoryRef;
+    getPullRequest(id: number): Promise<BitbucketApiPullRequest>;
+    /** Unified diff of the pull request (`text/plain`). */
+    getPullRequestDiff(id: number): Promise<string>;
+    listPullRequestComments(id: number): Promise<BitbucketApiComment[]>;
+    postPullRequestComment(id: number, input: BitbucketPullRequestCommentInput): Promise<BitbucketApiComment>;
+    setBuildStatus(input: BitbucketBuildStatusInput): Promise<unknown>;
+    /** Raw file contents at `ref` (branch, tag, or SHA). */
+    getFileAtRef(path: string, ref: string): Promise<string>;
+}
+/** `/repositories/{workspace}/{slug}` — Bitbucket Cloud 2.0. */
+export declare function bitbucketCloudRepoPath(repository: {
+    owner: string;
+    slug: string;
+}): string;
+/** `/projects/{KEY}/repos/{slug}` — Bitbucket Data Center 1.0. */
+export declare function bitbucketDataCenterRepoPath(repository: {
+    owner: string;
+    slug: string;
+}): string;
+export declare function cloudBitbucketApi(client: BitbucketClient, repository: BitbucketRepositoryRef): BitbucketApi;
+export declare function dcBitbucketApi(client: BitbucketClient, repository: BitbucketRepositoryRef): BitbucketApi;
+/** Pick the dialect implementation for `repository.dialect`. */
+export declare function createBitbucketApi(client: BitbucketClient, repository: BitbucketRepositoryRef): BitbucketApi;
+//# sourceMappingURL=api.d.ts.map

package/dist/channels/bitbucket/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/channels/bitbucket/api.ts"],"names":[],"mappings":"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"}

package/dist/channels/bitbucket/api.js

@@ -0,0 +1,419 @@
+/**
+ * Bitbucket REST client for the Bitbucket channel — the `createGitLabClient`
+ * analogue, with one `BitbucketApi` facade implemented twice: Cloud 2.0
+ * (`https://api.bitbucket.org/2.0/repositories/{workspace}/{slug}/…`) and
+ * Data Center 1.0 (`<host>/rest/api/1.0/projects/{KEY}/repos/{slug}/…`).
+ * The dialect comes from the delivery payload shape, never a round trip.
+ *
+ * Two transports:
+ *
+ * - **Direct**: `Authorization: Bearer` with a repository / workspace /
+ *   HTTP access token from options or `BITBUCKET_TOKEN`. The base defaults
+ *   to `BITBUCKET_API_BASE_URL`, else api.bitbucket.org (Cloud). Data Center
+ *   deploys must configure one; `ctx.bitbucket` never derives the host from
+ *   the webhook payload — only the replay CLI passes a user-supplied repo URL.
+ * - **Proxy** (`--cursor-scm-proxy` with `cursorAccount`): the backend
+ *   forwarder at `/v0/bitbucket-proxy`. Calls carry the Cursor API key as
+ *   the bearer plus `x-cursor-bitbucket-repos` naming the repo the call is
+ *   scoped to; the backend swaps in the tenant's Bitbucket credential and
+ *   picks the upstream (Cloud 2.0 or the DC host's 1.0) per tenant.
+ */
+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());
+    });
+};
+export const DEFAULT_BITBUCKET_CLOUD_API_BASE_URL = "https://api.bitbucket.org/2.0";
+/** Header the SCM proxy reads to scope a Bitbucket call to one repo. */
+export const CURSOR_BITBUCKET_REPOS_HEADER = "x-cursor-bitbucket-repos";
+/** Normalized Bitbucket REST failure — the `GitLabApiError` analogue. */
+export class BitbucketApiError extends Error {
+    constructor(input) {
+        super(`Bitbucket ${input.method} ${input.path} failed with HTTP ${input.status}.`);
+        this.name = "BitbucketApiError";
+        this.body = input.body;
+        this.method = input.method;
+        this.path = input.path;
+        this.status = input.status;
+    }
+}
+function envValue(value) {
+    const trimmed = value === null || value === void 0 ? void 0 : value.trim();
+    return trimmed === undefined || trimmed === "" ? undefined : trimmed;
+}
+/** `BITBUCKET_TOKEN` when set. */
+export function envBitbucketToken(env = process.env) {
+    return envValue(env.BITBUCKET_TOKEN);
+}
+/**
+ * REST base for direct calls: `BITBUCKET_API_BASE_URL`, else api.bitbucket.org
+ * 2.0 for Cloud, else `/rest/api/1.0` on `repoHtmlUrl`'s origin. Callers must
+ * only pass a `repoHtmlUrl` the operator supplied (the replay CLI), never one
+ * read from a delivery payload.
+ */
+export function bitbucketApiBaseUrl(input) {
+    var _a;
+    const fromEnv = envValue(((_a = input.env) !== null && _a !== void 0 ? _a : process.env).BITBUCKET_API_BASE_URL);
+    if (fromEnv !== undefined) {
+        return fromEnv.replace(/\/+$/, "");
+    }
+    if (input.dialect === "cloud") {
+        return DEFAULT_BITBUCKET_CLOUD_API_BASE_URL;
+    }
+    if (input.repoHtmlUrl !== undefined) {
+        try {
+            return `${new URL(input.repoHtmlUrl).origin}/rest/api/1.0`;
+        }
+        catch (_b) {
+            // no usable host
+        }
+    }
+    return undefined;
+}
+function buildQuery(query) {
+    if (query === undefined) {
+        return "";
+    }
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(query)) {
+        if (value !== undefined) {
+            params.set(key, String(value));
+        }
+    }
+    const encoded = params.toString();
+    return encoded === "" ? "" : `?${encoded}`;
+}
+export function createBitbucketClient(options = {}) {
+    var _a, _b;
+    var _c, _d, _e;
+    const fetchImpl = (_c = options.fetch) !== null && _c !== void 0 ? _c : fetch;
+    const apiBaseUrl = (_e = (_d = (_a = options.proxy) === null || _a === void 0 ? void 0 : _a.apiBaseUrl) !== null && _d !== void 0 ? _d : options.apiBaseUrl) !== null && _e !== void 0 ? _e : envValue(process.env.BITBUCKET_API_BASE_URL);
+    if (apiBaseUrl === undefined || apiBaseUrl.trim() === "") {
+        throw new Error("bitbucketChannel: no Bitbucket API base URL (pass apiBaseUrl, set BITBUCKET_API_BASE_URL, or serve with --cursor-scm-proxy and cursorAccount).");
+    }
+    const base = apiBaseUrl.replace(/\/+$/, "");
+    const repo = (_b = options.repo) === null || _b === void 0 ? void 0 : _b.trim().replace(/^\/+|\/+$/g, "");
+    const authHeaders = () => __awaiter(this, void 0, void 0, function* () {
+        var _a, _b;
+        if (options.proxy !== undefined) {
+            const headers = Object.assign({ authorization: `Bearer ${yield options.proxy.getApiKey()}` }, options.proxy.headers);
+            if (((_a = headers[CURSOR_BITBUCKET_REPOS_HEADER]) !== null && _a !== void 0 ? _a : "").trim() === "" &&
+                repo !== undefined &&
+                repo !== "") {
+                headers[CURSOR_BITBUCKET_REPOS_HEADER] = repo.toLowerCase();
+            }
+            return headers;
+        }
+        const token = typeof options.token === "function"
+            ? yield options.token()
+            : ((_b = options.token) !== null && _b !== void 0 ? _b : envBitbucketToken());
+        if (token === undefined || token === "") {
+            throw new Error("bitbucketChannel: no Bitbucket credential available (pass token, set BITBUCKET_TOKEN, or serve with --cursor-scm-proxy and cursorAccount).");
+        }
+        return { authorization: `Bearer ${token}` };
+    });
+    return {
+        apiBaseUrl: base,
+        request(input) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a;
+                const path = input.path.startsWith("/") ? input.path : `/${input.path}`;
+                const accept = (_a = input.accept) !== null && _a !== void 0 ? _a : "application/json";
+                const response = yield fetchImpl(`${base}${path}${buildQuery(input.query)}`, {
+                    method: input.method,
+                    headers: Object.assign(Object.assign(Object.assign({}, (yield authHeaders())), { accept }), (input.body === undefined
+                        ? {}
+                        : { "content-type": "application/json" })),
+                    body: input.body === undefined ? undefined : JSON.stringify(input.body),
+                });
+                const text = yield response.text();
+                let parsed = text;
+                if (accept === "application/json") {
+                    try {
+                        parsed = text === "" ? undefined : JSON.parse(text);
+                    }
+                    catch (_b) {
+                        parsed = text;
+                    }
+                }
+                if (!response.ok) {
+                    throw new BitbucketApiError({
+                        body: parsed,
+                        method: input.method,
+                        path,
+                        status: response.status,
+                    });
+                }
+                return parsed;
+            });
+        },
+    };
+}
+function asRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function str(value) {
+    return typeof value === "string" && value !== "" ? value : undefined;
+}
+function num(value) {
+    return typeof value === "number" && Number.isFinite(value)
+        ? value
+        : undefined;
+}
+function encodePath(path) {
+    return path
+        .split("/")
+        .filter((segment) => segment !== "")
+        .map((segment) => encodeURIComponent(segment))
+        .join("/");
+}
+function fallbackUrl(repository) {
+    var _a;
+    return ((_a = repository.htmlUrl) !== null && _a !== void 0 ? _a : (repository.dialect === "cloud"
+        ? `https://bitbucket.org/${repository.fullName}`
+        : "https://cursor.com"));
+}
+/** `/repositories/{workspace}/{slug}` — Bitbucket Cloud 2.0. */
+export function bitbucketCloudRepoPath(repository) {
+    return `/repositories/${encodeURIComponent(repository.owner)}/${encodeURIComponent(repository.slug)}`;
+}
+/** `/projects/{KEY}/repos/{slug}` — Bitbucket Data Center 1.0. */
+export function bitbucketDataCenterRepoPath(repository) {
+    return `/projects/${encodeURIComponent(repository.owner)}/repos/${encodeURIComponent(repository.slug)}`;
+}
+export function cloudBitbucketApi(client, repository) {
+    const repo = bitbucketCloudRepoPath(repository);
+    const mapComment = (raw) => {
+        var _a, _b;
+        var _c, _d, _e, _f;
+        const record = (_c = asRecord(raw)) !== null && _c !== void 0 ? _c : {};
+        const inline = asRecord(record.inline);
+        return {
+            id: (_d = num(record.id)) !== null && _d !== void 0 ? _d : 0,
+            body: (_e = str((_a = asRecord(record.content)) === null || _a === void 0 ? void 0 : _a.raw)) !== null && _e !== void 0 ? _e : "",
+            authorId: str((_b = asRecord(record.user)) === null || _b === void 0 ? void 0 : _b.uuid),
+            path: str(inline === null || inline === void 0 ? void 0 : inline.path),
+            line: (_f = num(inline === null || inline === void 0 ? void 0 : inline.to)) !== null && _f !== void 0 ? _f : num(inline === null || inline === void 0 ? void 0 : inline.from),
+            raw,
+        };
+    };
+    return {
+        dialect: "cloud",
+        repository,
+        getPullRequest(id) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c, _d, _e, _f;
+                var _g;
+                const raw = yield client.request({
+                    method: "GET",
+                    path: `${repo}/pullrequests/${id}`,
+                });
+                const source = asRecord(raw.source);
+                const destination = asRecord(raw.destination);
+                return {
+                    id: (_g = num(raw.id)) !== null && _g !== void 0 ? _g : id,
+                    title: str(raw.title),
+                    description: str(raw.description),
+                    state: str(raw.state),
+                    sourceBranch: str((_a = asRecord(source === null || source === void 0 ? void 0 : source.branch)) === null || _a === void 0 ? void 0 : _a.name),
+                    targetBranch: str((_b = asRecord(destination === null || destination === void 0 ? void 0 : destination.branch)) === null || _b === void 0 ? void 0 : _b.name),
+                    headSha: str((_c = asRecord(source === null || source === void 0 ? void 0 : source.commit)) === null || _c === void 0 ? void 0 : _c.hash),
+                    baseSha: str((_d = asRecord(destination === null || destination === void 0 ? void 0 : destination.commit)) === null || _d === void 0 ? void 0 : _d.hash),
+                    htmlUrl: str((_f = asRecord((_e = asRecord(raw.links)) === null || _e === void 0 ? void 0 : _e.html)) === null || _f === void 0 ? void 0 : _f.href),
+                    raw,
+                };
+            });
+        },
+        getPullRequestDiff: (id) => client.request({
+            method: "GET",
+            path: `${repo}/pullrequests/${id}/diff`,
+            accept: "text/plain",
+        }),
+        listPullRequestComments(id) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const comments = [];
+                let page = `${repo}/pullrequests/${id}/comments`;
+                let query = { pagelen: 100 };
+                while (page !== undefined) {
+                    const raw = yield client.request({
+                        method: "GET",
+                        path: page,
+                        query,
+                    });
+                    for (const value of Array.isArray(raw.values) ? raw.values : []) {
+                        comments.push(mapComment(value));
+                    }
+                    const next = str(raw.next);
+                    if (next === undefined) {
+                        break;
+                    }
+                    // `next` is absolute; re-root it under the client base so the proxy
+                    // (which only forwards paths) keeps working.
+                    const nextUrl = new URL(next);
+                    const baseUrl = new URL(`${client.apiBaseUrl}/`);
+                    page = nextUrl.pathname.startsWith(baseUrl.pathname)
+                        ? nextUrl.pathname.slice(baseUrl.pathname.length - 1)
+                        : nextUrl.pathname;
+                    query = Object.fromEntries(nextUrl.searchParams.entries());
+                }
+                return comments;
+            });
+        },
+        postPullRequestComment(id, input) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const raw = yield client.request({
+                    method: "POST",
+                    path: `${repo}/pullrequests/${id}/comments`,
+                    body: Object.assign({ content: { raw: input.body } }, (input.inline === undefined
+                        ? {}
+                        : {
+                            inline: Object.assign({ path: input.inline.path }, (input.inline.line === undefined
+                                ? {}
+                                : { to: input.inline.line })),
+                        })),
+                });
+                return mapComment(raw);
+            });
+        },
+        setBuildStatus: (input) => { var _a, _b; return client.request({
+            method: "POST",
+            path: `${repo}/commit/${encodeURIComponent(input.sha)}/statuses/build`,
+            body: Object.assign({ key: input.key, state: input.state, name: (_a = input.name) !== null && _a !== void 0 ? _a : input.key, url: (_b = input.url) !== null && _b !== void 0 ? _b : fallbackUrl(repository) }, (input.description === undefined
+                ? {}
+                : { description: input.description })),
+        }); },
+        getFileAtRef: (path, ref) => client.request({
+            method: "GET",
+            path: `${repo}/src/${encodeURIComponent(ref)}/${encodePath(path)}`,
+            accept: "text/plain",
+        }),
+    };
+}
+export function dcBitbucketApi(client, repository) {
+    const repo = bitbucketDataCenterRepoPath(repository);
+    const mapComment = (raw) => {
+        var _a;
+        var _b, _c, _d;
+        const record = (_b = asRecord(raw)) !== null && _b !== void 0 ? _b : {};
+        const anchor = asRecord(record.anchor);
+        const authorId = num((_a = asRecord(record.author)) === null || _a === void 0 ? void 0 : _a.id);
+        return {
+            id: (_c = num(record.id)) !== null && _c !== void 0 ? _c : 0,
+            body: (_d = str(record.text)) !== null && _d !== void 0 ? _d : "",
+            authorId: authorId === undefined ? undefined : String(authorId),
+            path: str(anchor === null || anchor === void 0 ? void 0 : anchor.path),
+            line: num(anchor === null || anchor === void 0 ? void 0 : anchor.line),
+            raw,
+        };
+    };
+    return {
+        dialect: "data-center",
+        repository,
+        getPullRequest(id) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b;
+                var _c;
+                const raw = yield client.request({
+                    method: "GET",
+                    path: `${repo}/pull-requests/${id}`,
+                });
+                const fromRef = asRecord(raw.fromRef);
+                const toRef = asRecord(raw.toRef);
+                const self = (_a = asRecord(raw.links)) === null || _a === void 0 ? void 0 : _a.self;
+                return {
+                    id: (_c = num(raw.id)) !== null && _c !== void 0 ? _c : id,
+                    title: str(raw.title),
+                    description: str(raw.description),
+                    state: str(raw.state),
+                    sourceBranch: str(fromRef === null || fromRef === void 0 ? void 0 : fromRef.displayId),
+                    targetBranch: str(toRef === null || toRef === void 0 ? void 0 : toRef.displayId),
+                    headSha: str(fromRef === null || fromRef === void 0 ? void 0 : fromRef.latestCommit),
+                    baseSha: str(toRef === null || toRef === void 0 ? void 0 : toRef.latestCommit),
+                    htmlUrl: Array.isArray(self) ? str((_b = asRecord(self[0])) === null || _b === void 0 ? void 0 : _b.href) : undefined,
+                    raw,
+                };
+            });
+        },
+        // `/pull-requests/{id}.diff` streams the raw unified diff; the sibling
+        // `/pull-requests/{id}/diff` route returns a JSON `RestDiff` instead.
+        getPullRequestDiff: (id) => client.request({
+            method: "GET",
+            path: `${repo}/pull-requests/${id}.diff`,
+            accept: "text/plain",
+        }),
+        listPullRequestComments(id) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const comments = [];
+                let start = 0;
+                for (;;) {
+                    const raw = yield client.request({
+                        method: "GET",
+                        path: `${repo}/pull-requests/${id}/activities`,
+                        query: { limit: 100, start },
+                    });
+                    for (const value of Array.isArray(raw.values) ? raw.values : []) {
+                        const activity = asRecord(value);
+                        if ((activity === null || activity === void 0 ? void 0 : activity.action) === "COMMENTED" &&
+                            activity.comment !== undefined) {
+                            comments.push(mapComment(activity.comment));
+                        }
+                    }
+                    const nextStart = num(raw.nextPageStart);
+                    if (raw.isLastPage !== false || nextStart === undefined) {
+                        break;
+                    }
+                    start = nextStart;
+                }
+                return comments;
+            });
+        },
+        postPullRequestComment(id, input) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const raw = yield client.request({
+                    method: "POST",
+                    path: `${repo}/pull-requests/${id}/comments`,
+                    body: Object.assign({ text: input.body }, (input.inline === undefined
+                        ? {}
+                        : {
+                            anchor: Object.assign({ path: input.inline.path, diffType: "EFFECTIVE" }, (input.inline.line === undefined
+                                ? { fileType: "TO" }
+                                : {
+                                    line: input.inline.line,
+                                    lineType: "CONTEXT",
+                                    fileType: "TO",
+                                })),
+                        })),
+                });
+                return mapComment(raw);
+            });
+        },
+        // Repository-scoped build status (DC 7.14+), which lives under
+        // `rest/api/1.0` so the proxy's single upstream base reaches it; the
+        // older `rest/build-status/1.0/commits/{sha}` sits outside that base.
+        setBuildStatus: (input) => { var _a, _b; return client.request({
+            method: "POST",
+            path: `${repo}/commits/${encodeURIComponent(input.sha)}/builds`,
+            body: Object.assign({ key: input.key, state: input.state === "STOPPED" ? "CANCELLED" : input.state, name: (_a = input.name) !== null && _a !== void 0 ? _a : input.key, url: (_b = input.url) !== null && _b !== void 0 ? _b : fallbackUrl(repository) }, (input.description === undefined
+                ? {}
+                : { description: input.description })),
+        }); },
+        getFileAtRef: (path, ref) => client.request({
+            method: "GET",
+            path: `${repo}/raw/${encodePath(path)}`,
+            query: { at: ref },
+            accept: "text/plain",
+        }),
+    };
+}
+/** Pick the dialect implementation for `repository.dialect`. */
+export function createBitbucketApi(client, repository) {
+    return repository.dialect === "cloud"
+        ? cloudBitbucketApi(client, repository)
+        : dcBitbucketApi(client, repository);
+}

package/dist/channels/bitbucket/binding.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Repository / pull-request binding parsed from a Bitbucket webhook payload,
+ * normalized across the two dialects.
+ *
+ * Cloud: top-level `repository` (`full_name`, `uuid`, `links.html.href`),
+ * `pullrequest` (`source.branch.name`, `source.commit.hash`, `links.html`),
+ * `comment.content.raw`, `push.changes[].new.target.hash`.
+ *
+ * Data Center: `pullRequest` (`fromRef.displayId`, `fromRef.latestCommit`,
+ * repo under `toRef.repository` as `project.key` + `slug`), `comment.text`,
+ * top-level `changes[].toHash` on `repo:refs_changed`, and `previousFromHash`
+ * on `pr:from_ref_updated`.
+ */
+import { type BitbucketApi, type BitbucketBuildStatusInput, type BitbucketProxyTransport, type BitbucketRequestInput, type BitbucketTokenProvider } from "./api.js";
+import { type BitbucketCheck, type BitbucketCheckCreateInput } from "./checks.js";
+import type { BitbucketDialect, BitbucketPullRequestComment, BitbucketPullRequestEvent, BitbucketPush, BitbucketRepositoryRef, BitbucketUser } from "./types.js";
+/** Bitbucket operations exposed to hooks (`ctx.bitbucket`), bound to the repo. */
+export interface BitbucketHandle {
+    repository: BitbucketRepositoryRef;
+    /** Dialect-specific REST facade (PR, diff, comments, build status, files). */
+    readonly api: BitbucketApi;
+    /** Call a raw REST path under the dialect's base. Throws `BitbucketApiError`. */
+    request<T = unknown>(input: BitbucketRequestInput): Promise<T>;
+    /** Post a build status on the bound repo. */
+    setBuildStatus(input: BitbucketBuildStatusInput): Promise<unknown>;
+    /** Open a build status through the shared check lifecycle. */
+    createCheck(input: Omit<BitbucketCheckCreateInput, "bitbucket">): Promise<BitbucketCheck>;
+}
+/**
+ * Build `ctx.bitbucket` for one delivery. Lazy: no credential is resolved
+ * until the first call, so channels without outbound Bitbucket access still
+ * dispatch. Proxy mode (`cursorAccount` + `--cursor-scm-proxy`) wins when
+ * the host bound a transport; otherwise direct access with `token` /
+ * `BITBUCKET_TOKEN` against the dialect's API base.
+ */
+export declare function buildBitbucketBinding(input: {
+    repository: BitbucketRepositoryRef;
+    proxy?: BitbucketProxyTransport;
+    token?: string | BitbucketTokenProvider;
+    apiBaseUrl?: string;
+    fetch?: typeof fetch;
+}): BitbucketHandle;
+export declare function asRecord(value: unknown): Record<string, unknown> | undefined;
+export declare function asNonEmptyString(value: unknown): string | undefined;
+export declare function asPositiveInt(value: unknown): number | undefined;
+/** The pull-request record under either dialect's key. */
+export declare function bitbucketPullRequestRecord(payload: Record<string, unknown>): Record<string, unknown> | undefined;
+/**
+ * Cloud bodies carry `pullrequest` / `repository.full_name`; Data Center
+ * bodies carry `pullRequest` / `repository.project.key`. Unknown shapes
+ * default to Cloud, the dialect the hosted ingress normalizes toward.
+ */
+export declare function bitbucketDialectOf(payload: Record<string, unknown>): BitbucketDialect;
+/**
+ * Repository the delivery is about. Top-level `repository` (Cloud always;
+ * DC on `repo:*`), else the DC pull request's `toRef.repository`.
+ */
+export declare function bitbucketRepositoryFromPayload(payload: Record<string, unknown>): BitbucketRepositoryRef | undefined;
+/** Cloud `{uuid, display_name, nickname}` or DC `{id, name, displayName}`. */
+export declare function bitbucketUser(value: unknown): BitbucketUser | undefined;
+export declare function bitbucketPullRequestUrl(repository: BitbucketRepositoryRef, id: number, explicit?: string): string;
+/**
+ * Normalize the pull request from either dialect. `action` is the suffix of
+ * the Cloud-normalized event key (`pullrequest:created` → `created`).
+ */
+export declare function bitbucketPullRequestFromPayload(repository: BitbucketRepositoryRef, payload: Record<string, unknown>, action: string): BitbucketPullRequestEvent | undefined;
+/** Cloud `comment.content.raw` / DC `comment.text`. */
+export declare function bitbucketCommentFromPayload(payload: Record<string, unknown>): BitbucketPullRequestComment | undefined;
+/** Cloud `push.changes[]` (`new`/`old` targets) or DC `changes[]` (`toHash`/`fromHash`). */
+export declare function bitbucketPushFromPayload(payload: Record<string, unknown>): BitbucketPush | undefined;
+//# sourceMappingURL=binding.d.ts.map