@almadar/integrations 2.30.0 → 2.31.0

package/dist/integrations/github/index.d.ts

@@ -1,4 +1,4 @@
-import { g as IntegrationParams, B as BaseIntegration, a as IntegrationConfig, h as IntegrationResult } from '../../BaseIntegration-C_5q54DM.js';
+import { g as IntegrationParams, B as BaseIntegration, a as IntegrationConfig, h as IntegrationResult } from '../../BaseIntegration-BYlbMFlf.js';
 import '@almadar/core';
 
 /**
@@ -184,8 +184,8 @@ interface GitHubListIssuesParams extends IntegrationParams {
     state?: 'open' | 'closed' | 'all';
     /** Labels to filter by */
     labels?: string[];
-    /** Maximum number of issues to return */
-    limit?: number;
+    /** Page size for the GitHub API request */
+    per_page?: number;
 }
 /**
  * GitHub get issue parameters
@@ -194,6 +194,79 @@ interface GitHubGetIssueParams extends IntegrationParams {
     /** Issue number */
     issueNumber: number;
 }
+/**
+ * GitHub get file contents parameters
+ */
+interface GitHubGetFileParams extends IntegrationParams {
+    /** Repository owner */
+    owner: string;
+    /** Repository name */
+    repo: string;
+    /** File path within the repository */
+    path: string;
+    /** Branch, tag, or commit SHA (defaults to the repo's default branch) */
+    ref?: string;
+}
+/**
+ * GitHub file contents response
+ */
+interface GitHubFileContent {
+    /** File path within the repository */
+    path: string;
+    /** Decoded file content */
+    content: string;
+    /** Blob SHA */
+    sha: string;
+    /** File size in bytes */
+    size: number;
+}
+/**
+ * GitHub list commits parameters
+ */
+interface GitHubListCommitsParams extends IntegrationParams {
+    /** Repository owner */
+    owner: string;
+    /** Repository name */
+    repo: string;
+    /** Restrict to commits touching this path */
+    path?: string;
+    /** Branch, tag, or commit SHA to start listing from */
+    ref?: string;
+    /** Results per page (GitHub default 30, max 100) */
+    per_page?: number;
+}
+/**
+ * GitHub commit summary, as returned by the `listCommits` action.
+ */
+interface GitHubCommitSummary {
+    sha: string;
+    message: string;
+    author: string;
+    date: string;
+}
+/**
+ * GitHub create issue parameters
+ */
+interface GitHubCreateIssueParams extends IntegrationParams {
+    /** Repository owner */
+    owner: string;
+    /** Repository name */
+    repo: string;
+    /** Issue title */
+    title: string;
+    /** Issue body */
+    body?: string;
+    /** Labels to apply */
+    labels?: string[];
+}
+/**
+ * GitHub create issue response
+ */
+interface GitHubIssueCreated {
+    number: number;
+    title: string;
+    url: string;
+}
 /**
  * GitHub pull request response
  */
@@ -341,6 +414,7 @@ interface GitHubCommit {
  */
 declare function listCommits(config: GitHubAPIConfig, options?: {
     path?: string;
+    ref?: string;
     perPage?: number;
     page?: number;
 }): Promise<GitHubCommit[]>;
@@ -353,6 +427,23 @@ declare function getCommitDiff(config: GitHubAPIConfig, sha: string): Promise<st
  * Returns null if the file doesn't exist at that commit.
  */
 declare function getFileAtCommit(config: GitHubAPIConfig, path: string, sha: string): Promise<string | null>;
+/**
+ * Get a file's content plus metadata (sha, size) — the `getFile` contract
+ * action. Unlike `getFileAtCommit` (raw bytes only, no sha/size), this reads
+ * the JSON contents API to satisfy the declared response shape in one call,
+ * and takes owner/repo per-call rather than from a pre-resolved config.
+ */
+declare function getFile(params: GitHubGetFileParams, token: string): Promise<GitHubFileContent>;
+/**
+ * List commits shaped for the `listCommits` contract action — per-call
+ * owner/repo, and the flattened author-name + date the declared response
+ * requires (the raw API nests author under `commit.author`).
+ */
+declare function listCommitsSummary(params: GitHubListCommitsParams, token: string): Promise<GitHubCommitSummary[]>;
+/**
+ * Create an issue — the `createIssue` contract action.
+ */
+declare function createIssue(params: GitHubCreateIssueParams, token: string): Promise<GitHubIssueCreated>;
 /**
  * Parse repository owner and name from URL
  */
@@ -489,10 +580,23 @@ declare class GitHubIntegration extends BaseIntegration {
      * Get issue details
      */
     private getIssue;
+    /**
+     * Get a file's content plus metadata (owner/repo are per-call, not the
+     * configured default repo)
+     */
+    private getFile;
+    /**
+     * List commits (owner/repo are per-call, not the configured default repo)
+     */
+    private listCommits;
+    /**
+     * Create an issue (owner/repo are per-call, not the configured default repo)
+     */
+    private createIssue;
     /**
      * Get API config for GitHub API calls
      */
     private getAPIConfig;
 }
 
-export { type GitHubAPIConfig, type GitHubAddRemoteParams, type GitHubCloneParams, type GitHubComment, type GitHubCommit, type GitHubCommitParams, type GitHubCreateBranchParams, type GitHubCreatePRParams, type GitHubCreateRepoParams, type GitHubGetIssueParams, type GitHubGetPRCommentsParams, type GitHubInitParams, GitHubIntegration, type GitHubIssue, type GitHubListIssuesParams, type GitHubPullParams, type GitHubPullRequest, type GitHubPullResult, type GitHubPushParams, type GitHubRateLimit, type GitHubRenameBranchParams, type GitHubRepoCreated, type GitHubSetUserConfigParams, addRemote, cloneRepo, commit, createBranch, createPR, createRepo, getCommitDiff, getCurrentBranch, getFileAtCommit, getHeadCommit, getHeadSha, getIssue, getPRComments, getRateLimit, hasUncommittedChanges, init, listCommits, listIssues, listRepoTree, parseRepoUrl, pull, push, readRepoFile, renameCurrentBranch, setUserConfig };
+export { type GitHubAPIConfig, type GitHubAddRemoteParams, type GitHubCloneParams, type GitHubComment, type GitHubCommit, type GitHubCommitParams, type GitHubCommitSummary, type GitHubCreateBranchParams, type GitHubCreateIssueParams, type GitHubCreatePRParams, type GitHubCreateRepoParams, type GitHubFileContent, type GitHubGetFileParams, type GitHubGetIssueParams, type GitHubGetPRCommentsParams, type GitHubInitParams, GitHubIntegration, type GitHubIssue, type GitHubIssueCreated, type GitHubListCommitsParams, type GitHubListIssuesParams, type GitHubPullParams, type GitHubPullRequest, type GitHubPullResult, type GitHubPushParams, type GitHubRateLimit, type GitHubRenameBranchParams, type GitHubRepoCreated, type GitHubSetUserConfigParams, addRemote, cloneRepo, commit, createBranch, createIssue, createPR, createRepo, getCommitDiff, getCurrentBranch, getFile, getFileAtCommit, getHeadCommit, getHeadSha, getIssue, getPRComments, getRateLimit, hasUncommittedChanges, init, listCommits, listCommitsSummary, listIssues, listRepoTree, parseRepoUrl, pull, push, readRepoFile, renameCurrentBranch, setUserConfig };

package/dist/integrations/github/index.js

@@ -23,6 +23,14 @@ var ConsoleLogger = class {
   }
 };
 var RESERVED_ENVELOPE_KEYS = /* @__PURE__ */ new Set(["emit", "onSuccess", "onError", "timeout"]);
+var UnknownActionError = class extends Error {
+  constructor(integration, action) {
+    super(`Unknown ${integration} action: ${action}`);
+    this.name = "UnknownActionError";
+    this.integration = integration;
+    this.action = action;
+  }
+};
 function validateParams(integration, action, params) {
   const typedRegistry = integratorsRegistry;
   const registry = typedRegistry.integrators[integration];
@@ -666,10 +674,10 @@ async function getPRComments(params, config) {
   return data;
 }
 async function listIssues(params, config) {
-  const { state = "open", labels = [], limit = 30 } = params;
+  const { state = "open", labels = [], per_page = 30 } = params;
   const queryParams = new URLSearchParams({
     state,
-    per_page: Math.min(limit, 100).toString()
+    per_page: Math.min(per_page, 100).toString()
   });
   if (labels.length > 0) {
     queryParams.append("labels", labels.join(","));
@@ -694,6 +702,7 @@ async function getRateLimit(config) {
 async function listCommits(config, options) {
   const params = new URLSearchParams();
   if (options?.path) params.set("path", options.path);
+  if (options?.ref) params.set("sha", options.ref);
   if (options?.perPage) params.set("per_page", options.perPage.toString());
   if (options?.page) params.set("page", options.page.toString());
   const queryStr = params.toString();
@@ -748,6 +757,36 @@ async function getFileAtCommit(config, path, sha) {
     );
   }
 }
+async function getFile(params, token) {
+  const { owner, repo, path, ref } = params;
+  const config = { token};
+  const query = ref ? `?ref=${encodeURIComponent(ref)}` : "";
+  const endpoint = `/repos/${owner}/${repo}/contents/${path}${query}`;
+  const { data } = await githubFetch(endpoint, config);
+  const content = data.encoding === "base64" ? Buffer.from(data.content, "base64").toString("utf-8") : data.content;
+  return { path: data.path, content, sha: data.sha, size: data.size };
+}
+async function listCommitsSummary(params, token) {
+  const { owner, repo, path, ref, per_page } = params;
+  const config = { token, owner, repo };
+  const commits = await listCommits(config, { path, ref, perPage: per_page });
+  return commits.map((commit2) => ({
+    sha: commit2.sha,
+    message: commit2.message,
+    author: commit2.author.name,
+    date: commit2.author.date
+  }));
+}
+async function createIssue(params, token) {
+  const { owner, repo, title, body, labels } = params;
+  const config = { token};
+  const endpoint = `/repos/${owner}/${repo}/issues`;
+  const { data } = await githubFetch(endpoint, config, {
+    method: "POST",
+    body: JSON.stringify({ title, body, labels })
+  });
+  return { number: data.number, title: data.title, url: data.url };
+}
 function parseRepoUrl(repoUrl) {
   try {
     const url = new URL(repoUrl);
@@ -845,8 +884,23 @@ var GitHubIntegration = class extends BaseIntegration {
             () => this.getIssue(params)
           );
           break;
+        case "getFile":
+          data = await this.executeWithRetry(
+            () => this.getFile(params)
+          );
+          break;
+        case "listCommits":
+          data = await this.executeWithRetry(
+            () => this.listCommits(params)
+          );
+          break;
+        case "createIssue":
+          data = await this.executeWithRetry(
+            () => this.createIssue(params)
+          );
+          break;
         default:
-          throw new Error(`Unknown GitHub action: ${action}`);
+          throw new UnknownActionError(this.config.name, action);
       }
       return {
         success: true,
@@ -925,7 +979,7 @@ var GitHubIntegration = class extends BaseIntegration {
    * List issues
    */
   async listIssues(params) {
-    this.logger.debug("Listing issues", { state: params.state, labels: params.labels?.join(", "), limit: params.limit });
+    this.logger.debug("Listing issues", { state: params.state, labels: params.labels?.join(", "), per_page: params.per_page });
     const apiConfig = this.getAPIConfig();
     const issues = await listIssues(params, apiConfig);
     return { issues };
@@ -939,6 +993,29 @@ var GitHubIntegration = class extends BaseIntegration {
     const result = await getIssue(params, apiConfig);
     return result;
   }
+  /**
+   * Get a file's content plus metadata (owner/repo are per-call, not the
+   * configured default repo)
+   */
+  async getFile(params) {
+    this.logger.debug("Getting file", { owner: params.owner, repo: params.repo, path: params.path });
+    return getFile(params, this.token);
+  }
+  /**
+   * List commits (owner/repo are per-call, not the configured default repo)
+   */
+  async listCommits(params) {
+    this.logger.debug("Listing commits", { owner: params.owner, repo: params.repo, path: params.path });
+    const commits = await listCommitsSummary(params, this.token);
+    return { commits };
+  }
+  /**
+   * Create an issue (owner/repo are per-call, not the configured default repo)
+   */
+  async createIssue(params) {
+    this.logger.debug("Creating issue", { owner: params.owner, repo: params.repo, title: params.title });
+    return createIssue(params, this.token);
+  }
   /**
    * Get API config for GitHub API calls
    */
@@ -956,6 +1033,6 @@ var GitHubIntegration = class extends BaseIntegration {
   }
 };
 
-export { GitHubIntegration, addRemote, cloneRepo, commit, createBranch, createPR, createRepo, getCommitDiff, getCurrentBranch, getFileAtCommit, getHeadCommit, getHeadSha, getIssue, getPRComments, getRateLimit, hasUncommittedChanges, init, listCommits, listIssues, listRepoTree, parseRepoUrl, pull, push, readRepoFile, renameCurrentBranch, setUserConfig };
+export { GitHubIntegration, addRemote, cloneRepo, commit, createBranch, createIssue, createPR, createRepo, getCommitDiff, getCurrentBranch, getFile, getFileAtCommit, getHeadCommit, getHeadSha, getIssue, getPRComments, getRateLimit, hasUncommittedChanges, init, listCommits, listCommitsSummary, listIssues, listRepoTree, parseRepoUrl, pull, push, readRepoFile, renameCurrentBranch, setUserConfig };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map