@haystackeditor/cli 0.13.0 → 0.13.2

package/dist/utils/github-api.d.ts

@@ -11,6 +11,7 @@ export interface CreatePROptions {
     base: string;
     body?: string;
     draft?: boolean;
+    token?: string;
 }
 export interface PRResponse {
     number: number;
@@ -29,11 +30,33 @@ export interface LabelInfo {
     color: string;
     description?: string;
 }
+export interface GitHubUser {
+    login: string;
+    id: number;
+}
+export interface RepositoryPermissions {
+    admin?: boolean;
+    maintain?: boolean;
+    push?: boolean;
+    triage?: boolean;
+    pull?: boolean;
+}
+export interface RepositoryAccess {
+    full_name: string;
+    owner: {
+        login: string;
+    };
+    permissions?: RepositoryPermissions;
+}
 export declare const HAYSTACK_LABELS: Record<string, LabelInfo>;
 /**
- * Get stored GitHub token, throw if not authenticated
+ * Get a GitHub token, throw if not authenticated
  */
-export declare function requireGitHubAuth(): Promise<string>;
+export declare function requireGitHubAuth(options?: {
+    preferredLogin?: string;
+    owner?: string;
+    repo?: string;
+}): Promise<string>;
 /**
  * Create a pull request
  */
@@ -41,43 +64,41 @@ export declare function createPullRequest(options: CreatePROptions): Promise<PRR
 /**
  * Check if a PR already exists for a branch
  */
-export declare function findExistingPR(owner: string, repo: string, head: string): Promise<PRResponse | null>;
+export declare function findExistingPR(owner: string, repo: string, head: string, token?: string): Promise<PRResponse | null>;
 /**
  * Add labels to an issue/PR
  */
-export declare function addLabelsToIssue(owner: string, repo: string, issueNumber: number, labels: string[]): Promise<void>;
+export declare function addLabelsToIssue(owner: string, repo: string, issueNumber: number, labels: string[], token?: string): Promise<void>;
 /**
  * Get all labels from an issue/PR
  */
-export declare function getLabelsFromIssue(owner: string, repo: string, issueNumber: number): Promise<string[]>;
+export declare function getLabelsFromIssue(owner: string, repo: string, issueNumber: number, token?: string): Promise<string[]>;
 /**
  * Remove a label from an issue/PR
  */
-export declare function removeLabelFromIssue(owner: string, repo: string, issueNumber: number, labelName: string): Promise<void>;
+export declare function removeLabelFromIssue(owner: string, repo: string, issueNumber: number, labelName: string, token?: string): Promise<void>;
 /**
  * Check if a label exists in the repo
  */
-export declare function labelExists(owner: string, repo: string, labelName: string): Promise<boolean>;
+export declare function labelExists(owner: string, repo: string, labelName: string, token?: string): Promise<boolean>;
 /**
  * Create a label in the repo
  */
-export declare function createLabel(owner: string, repo: string, label: LabelInfo): Promise<void>;
+export declare function createLabel(owner: string, repo: string, label: LabelInfo, token?: string): Promise<void>;
 /**
  * Ensure all required Haystack labels exist in the repo
  */
-export declare function ensureHaystackLabels(owner: string, repo: string, labelNames: string[]): Promise<void>;
+export declare function ensureHaystackLabels(owner: string, repo: string, labelNames: string[], token?: string): Promise<void>;
 /**
  * Request reviewers on a pull request
  */
-export declare function requestReviewers(owner: string, repo: string, prNumber: number, reviewers: string[]): Promise<void>;
+export declare function requestReviewers(owner: string, repo: string, prNumber: number, reviewers: string[], token?: string): Promise<void>;
 /**
  * Get the authenticated user's info
  */
-export declare function getCurrentUser(): Promise<{
-    login: string;
-    id: number;
-}>;
+export declare function getCurrentUser(token?: string): Promise<GitHubUser>;
+export declare function getRepositoryAccess(owner: string, repo: string, token?: string): Promise<RepositoryAccess>;
 /**
  * Check if user has push access to a repo
  */
-export declare function hasPushAccess(owner: string, repo: string): Promise<boolean>;
+export declare function hasPushAccess(owner: string, repo: string, token?: string): Promise<boolean>;

package/dist/utils/github-api.js

@@ -3,7 +3,7 @@
  *
  * Provides functions for creating PRs, managing labels, etc.
  */
-import { loadToken } from '../commands/login.js';
+import { resolveAuthContext } from './auth.js';
 const GITHUB_API_BASE = 'https://api.github.com';
 // Label definitions for Haystack workflow
 export const HAYSTACK_LABELS = {
@@ -27,14 +27,14 @@ export const HAYSTACK_LABELS = {
 // Authentication
 // ============================================================================
 /**
- * Get stored GitHub token, throw if not authenticated
+ * Get a GitHub token, throw if not authenticated
  */
-export async function requireGitHubAuth() {
-    const token = await loadToken();
-    if (!token) {
-        throw new Error('Not logged in. Run `haystack login` first.');
-    }
-    return token;
+export async function requireGitHubAuth(options) {
+    const context = await resolveAuthContext(options);
+    return context.token;
+}
+async function resolveToken(token, options) {
+    return token ?? requireGitHubAuth(options);
 }
 // ============================================================================
 // API helpers
@@ -88,7 +88,10 @@ async function handleApiError(response, context) {
  * Create a pull request
  */
 export async function createPullRequest(options) {
-    const token = await requireGitHubAuth();
+    const token = await resolveToken(options.token, {
+        owner: options.owner,
+        repo: options.repo,
+    });
     const response = await githubApiRequest('POST', `/repos/${options.owner}/${options.repo}/pulls`, token, {
         title: options.title,
         head: options.head,
@@ -139,11 +142,11 @@ async function findMergedPRForBranch(owner, repo, head, token) {
 /**
  * Check if a PR already exists for a branch
  */
-export async function findExistingPR(owner, repo, head) {
-    const token = await requireGitHubAuth();
+export async function findExistingPR(owner, repo, head, token) {
+    const authToken = await resolveToken(token, { owner, repo });
     // head format should be "owner:branch" for cross-repo or just "branch" for same-repo
     const headParam = head.includes(':') ? head : `${owner}:${head}`;
-    const response = await githubApiRequest('GET', `/repos/${owner}/${repo}/pulls?head=${encodeURIComponent(headParam)}&state=open`, token);
+    const response = await githubApiRequest('GET', `/repos/${owner}/${repo}/pulls?head=${encodeURIComponent(headParam)}&state=open`, authToken);
     if (!response.ok) {
         if (response.status === 404)
             return null;
@@ -158,9 +161,9 @@ export async function findExistingPR(owner, repo, head) {
 /**
  * Add labels to an issue/PR
  */
-export async function addLabelsToIssue(owner, repo, issueNumber, labels) {
-    const token = await requireGitHubAuth();
-    const response = await githubApiRequest('POST', `/repos/${owner}/${repo}/issues/${issueNumber}/labels`, token, { labels });
+export async function addLabelsToIssue(owner, repo, issueNumber, labels, token) {
+    const authToken = await resolveToken(token, { owner, repo });
+    const response = await githubApiRequest('POST', `/repos/${owner}/${repo}/issues/${issueNumber}/labels`, authToken, { labels });
     if (!response.ok) {
         await handleApiError(response, `adding labels to PR #${issueNumber}`);
     }
@@ -168,9 +171,9 @@ export async function addLabelsToIssue(owner, repo, issueNumber, labels) {
 /**
  * Get all labels from an issue/PR
  */
-export async function getLabelsFromIssue(owner, repo, issueNumber) {
-    const token = await requireGitHubAuth();
-    const response = await githubApiRequest('GET', `/repos/${owner}/${repo}/issues/${issueNumber}/labels`, token);
+export async function getLabelsFromIssue(owner, repo, issueNumber, token) {
+    const authToken = await resolveToken(token, { owner, repo });
+    const response = await githubApiRequest('GET', `/repos/${owner}/${repo}/issues/${issueNumber}/labels`, authToken);
     if (!response.ok) {
         await handleApiError(response, `getting labels from PR #${issueNumber}`);
     }
@@ -180,9 +183,9 @@ export async function getLabelsFromIssue(owner, repo, issueNumber) {
 /**
  * Remove a label from an issue/PR
  */
-export async function removeLabelFromIssue(owner, repo, issueNumber, labelName) {
-    const token = await requireGitHubAuth();
-    const response = await githubApiRequest('DELETE', `/repos/${owner}/${repo}/issues/${issueNumber}/labels/${encodeURIComponent(labelName)}`, token);
+export async function removeLabelFromIssue(owner, repo, issueNumber, labelName, token) {
+    const authToken = await resolveToken(token, { owner, repo });
+    const response = await githubApiRequest('DELETE', `/repos/${owner}/${repo}/issues/${issueNumber}/labels/${encodeURIComponent(labelName)}`, authToken);
     // 404 is fine - label wasn't on the issue
     if (!response.ok && response.status !== 404) {
         await handleApiError(response, `removing label '${labelName}' from PR #${issueNumber}`);
@@ -191,17 +194,17 @@ export async function removeLabelFromIssue(owner, repo, issueNumber, labelName)
 /**
  * Check if a label exists in the repo
  */
-export async function labelExists(owner, repo, labelName) {
-    const token = await requireGitHubAuth();
-    const response = await githubApiRequest('GET', `/repos/${owner}/${repo}/labels/${encodeURIComponent(labelName)}`, token);
+export async function labelExists(owner, repo, labelName, token) {
+    const authToken = await resolveToken(token, { owner, repo });
+    const response = await githubApiRequest('GET', `/repos/${owner}/${repo}/labels/${encodeURIComponent(labelName)}`, authToken);
     return response.ok;
 }
 /**
  * Create a label in the repo
  */
-export async function createLabel(owner, repo, label) {
-    const token = await requireGitHubAuth();
-    const response = await githubApiRequest('POST', `/repos/${owner}/${repo}/labels`, token, {
+export async function createLabel(owner, repo, label, token) {
+    const authToken = await resolveToken(token, { owner, repo });
+    const response = await githubApiRequest('POST', `/repos/${owner}/${repo}/labels`, authToken, {
         name: label.name,
         color: label.color,
         description: label.description,
@@ -214,14 +217,14 @@ export async function createLabel(owner, repo, label) {
 /**
  * Ensure all required Haystack labels exist in the repo
  */
-export async function ensureHaystackLabels(owner, repo, labelNames) {
+export async function ensureHaystackLabels(owner, repo, labelNames, token) {
     for (const name of labelNames) {
         const labelInfo = HAYSTACK_LABELS[name];
         if (!labelInfo)
             continue;
-        const exists = await labelExists(owner, repo, name);
+        const exists = await labelExists(owner, repo, name, token);
         if (!exists) {
-            await createLabel(owner, repo, labelInfo);
+            await createLabel(owner, repo, labelInfo, token);
         }
     }
 }
@@ -231,9 +234,9 @@ export async function ensureHaystackLabels(owner, repo, labelNames) {
 /**
  * Request reviewers on a pull request
  */
-export async function requestReviewers(owner, repo, prNumber, reviewers) {
-    const token = await requireGitHubAuth();
-    const response = await githubApiRequest('POST', `/repos/${owner}/${repo}/pulls/${prNumber}/requested_reviewers`, token, { reviewers });
+export async function requestReviewers(owner, repo, prNumber, reviewers, token) {
+    const authToken = await resolveToken(token, { owner, repo });
+    const response = await githubApiRequest('POST', `/repos/${owner}/${repo}/pulls/${prNumber}/requested_reviewers`, authToken, { reviewers });
     if (!response.ok) {
         await handleApiError(response, `requesting reviewers on PR #${prNumber}`);
     }
@@ -244,23 +247,28 @@ export async function requestReviewers(owner, repo, prNumber, reviewers) {
 /**
  * Get the authenticated user's info
  */
-export async function getCurrentUser() {
-    const token = await requireGitHubAuth();
-    const response = await githubApiRequest('GET', '/user', token);
+export async function getCurrentUser(token) {
+    const authToken = await resolveToken(token);
+    const response = await githubApiRequest('GET', '/user', authToken);
     if (!response.ok) {
         await handleApiError(response, 'getting current user');
     }
     return response.json();
 }
+export async function getRepositoryAccess(owner, repo, token) {
+    const authToken = await resolveToken(token, { owner, repo });
+    const response = await githubApiRequest('GET', `/repos/${owner}/${repo}`, authToken);
+    if (!response.ok) {
+        await handleApiError(response, `getting repository access for ${owner}/${repo}`);
+    }
+    return response.json();
+}
 /**
  * Check if user has push access to a repo
  */
-export async function hasPushAccess(owner, repo) {
-    const token = await requireGitHubAuth();
-    const response = await githubApiRequest('GET', `/repos/${owner}/${repo}`, token);
-    if (!response.ok) {
-        return false;
-    }
-    const data = await response.json();
-    return data.permissions?.push === true;
+export async function hasPushAccess(owner, repo, token) {
+    const data = await getRepositoryAccess(owner, repo, token);
+    return data.permissions?.admin === true
+        || data.permissions?.maintain === true
+        || data.permissions?.push === true;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@haystackeditor/cli",
-  "version": "0.13.0",
+  "version": "0.13.2",
   "description": "Set up Haystack for your project — automated PR review, triage, and merge queue",
   "type": "module",
   "bin": {