@forge-glance/sdk 0.1.1 → 0.2.1

package/src/GitProvider.ts

@@ -2,11 +2,13 @@ import type {
   BranchProtectionRule,
   CreatePullRequestInput,
   Discussion,
+  MergePullRequestInput,
   MRDetail,
+  ProviderCapabilities,
   PullRequest,
   UpdatePullRequestInput,
-  UserRef,
-} from "./types.ts";
+  UserRef
+} from './types.ts';
 
 /**
  * Provider-agnostic interface for a Git hosting service.
@@ -39,7 +41,7 @@ export interface GitProvider {
   fetchSingleMR(
     projectPath: string,
     mrIid: number,
-    currentUserNumericId: number | null,
+    currentUserNumericId: number | null
   ): Promise<PullRequest | null>;
 
   /**
@@ -48,7 +50,7 @@ export interface GitProvider {
    */
   fetchPullRequestByBranch(
     projectPath: string,
-    sourceBranch: string,
+    sourceBranch: string
   ): Promise<PullRequest | null>;
 
   /**
@@ -64,7 +66,7 @@ export interface GitProvider {
   updatePullRequest(
     projectPath: string,
     mrIid: number,
-    input: UpdatePullRequestInput,
+    input: UpdatePullRequestInput
   ): Promise<PullRequest>;
 
   /**
@@ -72,26 +74,120 @@ export interface GitProvider {
    * Returns an array of rules (one per protected branch/pattern).
    */
   fetchBranchProtectionRules(
-    projectPath: string,
+    projectPath: string
   ): Promise<BranchProtectionRule[]>;
 
   /**
    * Delete a branch from the repository.
    * @throws if the branch doesn't exist or is protected.
    */
-  deleteBranch(
-    projectPath: string,
-    branch: string,
-  ): Promise<void>;
+  deleteBranch(projectPath: string, branch: string): Promise<void>;
 
   /**
    * Fetch discussions (comments, threads) for a specific MR/PR.
    * Returns the MRDetail with discussions populated.
    */
-  fetchMRDiscussions(
-    repositoryId: string,
+  fetchMRDiscussions(repositoryId: string, mrIid: number): Promise<MRDetail>;
+
+  // ── Mutation capabilities ───────────────────────────────────────────────
+
+  /**
+   * Reports which mutation operations this provider supports.
+   * Callers should check these flags to conditionally show/hide UI
+   * affordances without knowing which provider they're talking to.
+   */
+  readonly capabilities: ProviderCapabilities;
+
+  // ── MR lifecycle mutations ──────────────────────────────────────────────
+
+  /**
+   * Merge (accept) a pull request / merge request.
+   * All input fields are optional — omitting them defers to the project's
+   * configured defaults (merge method, squash policy, delete-source-branch).
+   */
+  mergePullRequest(
+    projectPath: string,
+    mrIid: number,
+    input?: MergePullRequestInput
+  ): Promise<PullRequest>;
+
+  /**
+   * Approve a pull request / merge request.
+   * On GitLab: POST /merge_requests/:iid/approve
+   * On GitHub: POST /pulls/:number/reviews with event "APPROVE"
+   */
+  approvePullRequest(projectPath: string, mrIid: number): Promise<void>;
+
+  /**
+   * Revoke an existing approval.
+   * GitLab-only — GitHub does not support unapproving via API.
+   * Check `capabilities.canUnapprove` before calling.
+   */
+  unapprovePullRequest(projectPath: string, mrIid: number): Promise<void>;
+
+  /**
+   * Rebase the MR source branch onto the target branch.
+   * GitLab-only — GitHub does not have a native rebase API.
+   * Check `capabilities.canRebase` before calling.
+   */
+  rebasePullRequest(projectPath: string, mrIid: number): Promise<void>;
+
+  /**
+   * Enable auto-merge: the MR will be merged automatically when the
+   * pipeline succeeds and all approval rules are met.
+   * GitLab-only — check `capabilities.canAutoMerge` before calling.
+   */
+  setAutoMerge(projectPath: string, mrIid: number): Promise<void>;
+
+  /**
+   * Cancel a previously enabled auto-merge.
+   * GitLab-only — check `capabilities.canAutoMerge` before calling.
+   */
+  cancelAutoMerge(projectPath: string, mrIid: number): Promise<void>;
+
+  // ── Discussion mutations ────────────────────────────────────────────────
+
+  /**
+   * Resolve a discussion thread on an MR.
+   * GitLab-only — check `capabilities.canResolveDiscussions` before calling.
+   */
+  resolveDiscussion(
+    projectPath: string,
+    mrIid: number,
+    discussionId: string
+  ): Promise<void>;
+
+  /**
+   * Unresolve a previously resolved discussion thread.
+   * GitLab-only — check `capabilities.canResolveDiscussions` before calling.
+   */
+  unresolveDiscussion(
+    projectPath: string,
     mrIid: number,
-  ): Promise<MRDetail>;
+    discussionId: string
+  ): Promise<void>;
+
+  // ── Pipeline mutations ──────────────────────────────────────────────────
+
+  /**
+   * Retry a failed or canceled pipeline.
+   * On GitLab: POST /pipelines/:id/retry
+   * On GitHub: POST re-run for the workflow run.
+   */
+  retryPipeline(projectPath: string, pipelineId: number): Promise<void>;
+
+  // ── Review mutations ────────────────────────────────────────────────────
+
+  /**
+   * Re-request review attention on an MR from its reviewers.
+   * If `reviewerUsernames` is provided, only those reviewers are pinged;
+   * otherwise all current reviewers are re-requested.
+   */
+  requestReReview(
+    projectPath: string,
+    mrIid: number,
+    reviewerUsernames?: string[]
+  ): Promise<void>;
 
   // ── REST pass-through (used by note mutations, job traces, etc.) ────────
 
@@ -102,11 +198,7 @@ export interface GitProvider {
    *
    * Implementations translate the path to the provider's API URL format.
    */
-  restRequest(
-    method: string,
-    path: string,
-    body?: unknown,
-  ): Promise<Response>;
+  restRequest(method: string, path: string, body?: unknown): Promise<Response>;
 }
 
 /**
@@ -114,8 +206,8 @@ export interface GitProvider {
  * e.g. "gitlab:42" → 42, "github:12345" → 12345
  */
 export function parseRepoId(repositoryId: string): number {
-  const parts = repositoryId.split(":");
-  return parseInt(parts.at(-1) ?? "0", 10);
+  const parts = repositoryId.split(':');
+  return parseInt(parts.at(-1) ?? '0', 10);
 }
 
 /**
@@ -123,5 +215,5 @@ export function parseRepoId(repositoryId: string): number {
  * e.g. "gitlab:42" → "gitlab", "github:12345" → "github"
  */
 export function repoIdProvider(repositoryId: string): string {
-  return repositoryId.split(":")[0] ?? "unknown";
+  return repositoryId.split(':')[0] ?? 'unknown';
 }

package/src/index.ts

@@ -18,6 +18,9 @@ export type {
   PullRequestsSnapshot,
   CreatePullRequestInput,
   UpdatePullRequestInput,
+  MergePullRequestInput,
+  MergeMethod,
+  ProviderCapabilities,
   BranchProtectionRule,
   Pipeline,
   PipelineJob,
@@ -30,28 +33,32 @@ export type {
   MRDetail,
   FeedEvent,
   FeedSnapshot,
-  ServerNotification,
-} from "./types.ts";
+  ServerNotification
+} from './types.ts';
 
 // ── Provider interface ────────────────────────────────────────────────────────
-export type { GitProvider } from "./GitProvider.ts";
-export { parseRepoId, repoIdProvider } from "./GitProvider.ts";
+export type { GitProvider } from './GitProvider.ts';
+export { parseRepoId, repoIdProvider } from './GitProvider.ts';
 
 // ── Logger ────────────────────────────────────────────────────────────────────
-export type { ForgeLogger } from "./logger.ts";
-export { noopLogger } from "./logger.ts";
+export type { ForgeLogger } from './logger.ts';
+export { noopLogger } from './logger.ts';
 
 // ── Providers ─────────────────────────────────────────────────────────────────
-export { GitLabProvider, parseGitLabRepoId, MR_DASHBOARD_FRAGMENT } from "./GitLabProvider.ts";
-export { GitHubProvider } from "./GitHubProvider.ts";
-export { createProvider, SUPPORTED_PROVIDERS } from "./providers.ts";
-export type { ProviderSlug } from "./providers.ts";
+export {
+  GitLabProvider,
+  parseGitLabRepoId,
+  MR_DASHBOARD_FRAGMENT
+} from './GitLabProvider.ts';
+export { GitHubProvider } from './GitHubProvider.ts';
+export { createProvider, SUPPORTED_PROVIDERS } from './providers.ts';
+export type { ProviderSlug } from './providers.ts';
 
 // ── GitLab real-time ──────────────────────────────────────────────────────────
-export { ActionCableClient } from "./ActionCableClient.ts";
-export type { ActionCableCallbacks } from "./ActionCableClient.ts";
+export { ActionCableClient } from './ActionCableClient.ts';
+export type { ActionCableCallbacks } from './ActionCableClient.ts';
 
 // ── GitLab detail + mutations ─────────────────────────────────────────────────
-export { MRDetailFetcher } from "./MRDetailFetcher.ts";
-export { NoteMutator } from "./NoteMutator.ts";
-export type { CreatedNote } from "./NoteMutator.ts";
+export { MRDetailFetcher } from './MRDetailFetcher.ts';
+export { NoteMutator } from './NoteMutator.ts';
+export type { CreatedNote } from './NoteMutator.ts';

package/src/types.ts

@@ -82,6 +82,17 @@ export interface PullRequest {
    * "not_approved", "discussions_not_resolved". Null for non-GitLab providers.
    */
   detailedMergeStatus: string | null;
+
+  // ── Auto-merge status ────────────────────────────────────────────────
+
+  /** Whether auto-merge (merge when pipeline succeeds) is currently enabled. */
+  autoMergeEnabled: boolean;
+  /** The merge strategy that will be used when auto-merge fires, e.g. "merge", "squash", "rebase_merge". */
+  autoMergeStrategy: string | null;
+  /** The user who merged or enabled auto-merge. */
+  mergeUser: UserRef | null;
+  /** ISO timestamp after which the MR is eligible to merge (scheduled merge). */
+  mergeAfter: string | null;
 }
 
 // ── MR/PR mutation inputs ─────────────────────────────────────────────────────
@@ -118,7 +129,65 @@ export interface UpdatePullRequestInput {
   /** Labels (replaces current set). */
   labels?: string[];
   /** Set MR state: "close" or "reopen". */
-  stateEvent?: "close" | "reopen";
+  stateEvent?: 'close' | 'reopen';
+}
+
+/**
+ * Merge strategy override.
+ * - "merge"  — Standard merge commit.
+ * - "squash" — Squash all commits into one before merging.
+ * - "rebase" — Rebase the source branch onto the target (fast-forward).
+ *
+ * When omitted, the provider uses the project's configured default merge method.
+ */
+export type MergeMethod = 'merge' | 'squash' | 'rebase';
+
+/**
+ * Input for merging (accepting) a pull request / merge request.
+ *
+ * All fields are **optional**. Omitting them defers to the project-level
+ * settings configured in the forge UI (merge method, squash policy,
+ * delete-source-branch, etc.). This matches how the web UI works.
+ */
+export interface MergePullRequestInput {
+  /** Merge commit message. Omit to use the provider/project default. */
+  commitMessage?: string;
+  /** Squash commit message (when merge method is "squash"). */
+  squashCommitMessage?: string;
+  /** Whether to squash commits. Omit to use the MR / project default. */
+  squash?: boolean;
+  /** Merge strategy override. Omit to use the project's default merge method. */
+  mergeMethod?: MergeMethod;
+  /** Delete source branch after merge. Omit to use project default. */
+  shouldRemoveSourceBranch?: boolean;
+  /** SHA that HEAD must match for the merge to proceed (optimistic locking). */
+  sha?: string;
+}
+
+/**
+ * Reports which mutation operations a provider supports.
+ *
+ * Callers should check these flags before invoking vendor-specific methods
+ * so they can conditionally show/hide UI affordances without
+ * knowing which provider they're talking to.
+ */
+export interface ProviderCapabilities {
+  /** Can merge / accept a pull request. */
+  canMerge: boolean;
+  /** Can approve a pull request. */
+  canApprove: boolean;
+  /** Can revoke an existing approval. */
+  canUnapprove: boolean;
+  /** Can rebase the source branch onto the target. */
+  canRebase: boolean;
+  /** Can enable automatic merge when pipeline succeeds. */
+  canAutoMerge: boolean;
+  /** Can resolve / unresolve discussion threads. */
+  canResolveDiscussions: boolean;
+  /** Can retry a pipeline. */
+  canRetryPipeline: boolean;
+  /** Can re-request review attention from reviewers. */
+  canRequestReReview: boolean;
 }
 
 /** Branch protection rule (provider-agnostic). */