Pull Requests API

// GET /trpc/pulls.list
{
  repoId: string;        // UUID of the repository
  state?: 'open' | 'closed' | 'merged';
  authorId?: string;     // Filter by author UUID
  limit?: number;        // 1-100, default 20
  offset?: number;       // Default 0
}

Array<{
  id: string;
  number: number;
  title: string;
  body?: string;
  state: 'open' | 'closed' | 'merged';
  sourceBranch: string;
  targetBranch: string;
  headSha: string;
  baseSha: string;
  authorId: string;
  author: { id: string; username: string; name?: string } | null;
  labels: Array<{ id: string; name: string; color: string }>;
  isDraft: boolean;
  createdAt: string;
  updatedAt: string;
  mergedAt?: string;
  closedAt?: string;
}>

// GET /trpc/pulls.get
{
  repoId: string;
  number: number;
}

{
  ...pr,
  author: User | null;
  labels: Label[];
  stack?: {
    id: string;
    name: string;
    baseBranch: string;
    branches: Array<{
      branchName: string;
      position: number;
      pr: { id: string; number: number; title: string; state: string } | null;
      isCurrent: boolean;
    }>;
  };
}

// POST /trpc/pulls.create
{
  repoId: string;
  title: string;          // 1-256 characters
  body?: string;
  sourceBranch: string;
  targetBranch: string;
  headSha: string;
  baseSha: string;
  isDraft?: boolean;      // Default false
  sourceRepoId?: string;  // For cross-repo PRs (forks)
}

// POST /trpc/pulls.update
{
  prId: string;
  title?: string;
  body?: string;
  isDraft?: boolean;
}

// GET /trpc/pulls.checkMergeability
{
  prId: string;
}

{
  canMerge: boolean;
  conflicts: string[];    // List of conflicting file paths
  behindBy: number;       // Commits behind target
  aheadBy: number;        // Commits ahead of target
  error?: string;
}

// POST /trpc/pulls.merge
{
  prId: string;
  strategy?: 'merge' | 'squash' | 'rebase';  // Default: merge
  message?: string;       // Custom merge commit message
}

{
  ...mergedPr,
  mergeSha: string;       // SHA of the merge commit
}

// POST /trpc/pulls.close
{ prId: string }

// POST /trpc/pulls.reopen
{ prId: string }

// POST /trpc/pulls.addReview
{
  prId: string;
  state: 'approved' | 'changes_requested' | 'commented';
  body?: string;
  commitSha: string;      // SHA being reviewed
}

// GET /trpc/pulls.reviews
{ prId: string }

// POST /trpc/pulls.addComment
{
  prId: string;
  body: string;
  path?: string;          // File path for inline comments
  line?: number;          // Line number
  side?: 'LEFT' | 'RIGHT';
  startLine?: number;     // For multi-line selection
  endLine?: number;
  commitSha?: string;
  reviewId?: string;
  replyToId?: string;     // For threaded replies
}

// GET /trpc/pulls.comments
{ prId: string }

// GET /trpc/pulls.getFileComments
{
  prId: string;
  path: string;
}

// POST /trpc/pulls.updateComment
{ commentId: string; body: string }

// POST /trpc/pulls.deleteComment
{ commentId: string }

// POST /trpc/pulls.resolveComment
{ commentId: string }

// POST /trpc/pulls.unresolveComment
{ commentId: string }

// POST /trpc/pulls.addSuggestion
{
  prId: string;
  body: string;           // Comment explaining the suggestion
  suggestion: string;     // The suggested code
  path: string;
  line: number;
  side?: 'LEFT' | 'RIGHT';
  startLine?: number;
  endLine?: number;
  commitSha?: string;
  reviewId?: string;
}

// POST /trpc/pulls.applySuggestion
{ commentId: string }

{
  success: boolean;
  commitSha: string;
  message: string;
}

// GET /trpc/pulls.labels
{ prId: string }

// POST /trpc/pulls.addLabel
{ prId: string; labelId: string }

// POST /trpc/pulls.removeLabel
{ prId: string; labelId: string }

// POST /trpc/pulls.requestReview
{
  prId: string;
  reviewerId: string;
}

// POST /trpc/pulls.removeReviewRequest
{
  prId: string;
  reviewerId: string;
}

// GET /trpc/pulls.reviewers
{ prId: string }

// GET /trpc/pulls.inboxSummary
{ repoId?: string }

{
  awaitingReview: number;
  myPrs: number;
  participated: number;
}

// GET /trpc/pulls.inboxAwaitingReview
{
  limit?: number;
  offset?: number;
  repoId?: string;
}

// GET /trpc/pulls.inboxMyPrs
{
  limit?: number;
  offset?: number;
  repoId?: string;
}

// GET /trpc/pulls.inboxParticipated
{
  limit?: number;
  offset?: number;
  state?: 'open' | 'closed' | 'all';
  repoId?: string;
}

// GET /trpc/pulls.getDiff
{ prId: string }

{
  files: Array<{
    oldPath: string;
    newPath: string;
    status: 'added' | 'deleted' | 'modified' | 'renamed';
    additions: number;
    deletions: number;
    hunks: Array<{
      oldStart: number;
      oldLines: number;
      newStart: number;
      newLines: number;
      lines: Array<{
        type: 'context' | 'add' | 'delete';
        content: string;
      }>;
    }>;
  }>;
  totalAdditions: number;
  totalDeletions: number;
  totalFiles: number;
}

// GET /trpc/pulls.getCommits
{ prId: string }

{
  commits: Array<{
    sha: string;
    message: string;
    author: string;
    authorEmail: string;
    date: string;
  }>;
  totalCommits: number;
}

// GET /trpc/pulls.getAIReview
{ prId: string }

{
  id: string;
  type: 'review' | 'comment';
  body: string;
  state?: 'approved' | 'changes_requested' | 'commented';
  createdAt: string;
} | null

// POST /trpc/pulls.triggerAIReview
{ prId: string }

// GET /trpc/pulls.getConflicts
{ prId: string }

{
  hasConflicts: boolean;
  files: Array<{
    path: string;
    ours: string;      // Your version
    theirs: string;    // Their version
    base: string;      // Common ancestor
  }>;
}

import { createTRPCClient } from '@trpc/client';
import type { AppRouter } from './api';

const client = createTRPCClient<AppRouter>({
  url: 'http://localhost:3000/trpc',
});

// List open PRs
const prs = await client.pulls.list.query({
  repoId: 'repo-uuid',
  state: 'open',
});

// Create a PR
const newPr = await client.pulls.create.mutate({
  repoId: 'repo-uuid',
  title: 'Add new feature',
  body: 'This PR adds...',
  sourceBranch: 'feature/new-feature',
  targetBranch: 'main',
  headSha: 'abc123...',
  baseSha: 'def456...',
});

// Add a review
await client.pulls.addReview.mutate({
  prId: newPr.id,
  state: 'approved',
  body: 'LGTM!',
  commitSha: 'abc123...',
});

// Merge the PR
const merged = await client.pulls.merge.mutate({
  prId: newPr.id,
  strategy: 'squash',
});