@agent-relay/github-primitive 4.0.9 → 5.0.0

package/dist/actions/branches.d.ts

@@ -0,0 +1,13 @@
+import type { BranchInfo, CreateBranchParams } from '../types.js';
+import { type GitHubActionAdapter } from './utils.js';
+/**
+ * List branches for a repository.
+ */
+export declare function listBranches(adapter: GitHubActionAdapter, owner: string, repo: string): Promise<BranchInfo[]>;
+/**
+ * Create a branch from another branch, or from the repository default branch.
+ */
+export declare function createBranch(adapter: GitHubActionAdapter, params: CreateBranchParams): Promise<void>;
+export declare function getBranch(adapter: GitHubActionAdapter, owner: string, repo: string, branch: string): Promise<BranchInfo>;
+export declare function mapBranch(value: unknown): BranchInfo;
+//# sourceMappingURL=branches.d.ts.map

package/dist/actions/branches.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branches.d.ts","sourceRoot":"","sources":["../../src/actions/branches.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAiB,MAAM,aAAa,CAAC;AACjF,OAAO,EAWL,KAAK,mBAAmB,EACzB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,UAAU,EAAE,CAAC,CAMvB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB1G;AAED,wBAAsB,SAAS,CAC7B,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,UAAU,CAAC,CAGrB;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAYpD"}

package/dist/actions/branches.js

@@ -0,0 +1,59 @@
+import { asArray, asRecord, assertNonEmptyString, assertOwnerRepo, booleanValue, branchEndpoint, numberValue, repoEndpoint, stringValue, withActionError, } from './utils.js';
+/**
+ * List branches for a repository.
+ */
+export async function listBranches(adapter, owner, repo) {
+    return withActionError(`list GitHub branches for ${owner}/${repo}`, async () => {
+        assertOwnerRepo(owner, repo);
+        const response = await adapter.request('GET', repoEndpoint(owner, repo, '/branches'));
+        return asArray(response, 'branches').map(mapBranch);
+    });
+}
+/**
+ * Create a branch from another branch, or from the repository default branch.
+ */
+export async function createBranch(adapter, params) {
+    const { owner, repo } = params;
+    return withActionError(`create GitHub branch ${params.branch} in ${owner}/${repo}`, async () => {
+        assertOwnerRepo(owner, repo);
+        const branch = assertNonEmptyString(params.branch, 'branch');
+        const sourceBranch = params.fromBranch ?? (await getDefaultBranch(adapter, params));
+        const source = await getBranch(adapter, owner, repo, sourceBranch);
+        const sha = assertNonEmptyString(source.commit.sha, 'source branch sha');
+        await adapter.request('POST', repoEndpoint(owner, repo, '/git/refs'), {
+            body: {
+                ref: `refs/heads/${branch}`,
+                sha,
+            },
+        });
+    });
+}
+export async function getBranch(adapter, owner, repo, branch) {
+    const response = await adapter.request('GET', branchEndpoint(owner, repo, branch));
+    return mapBranch(response);
+}
+export function mapBranch(value) {
+    const branch = asRecord(value, 'branch');
+    const commit = asRecord(branch.commit, 'branch commit');
+    return {
+        name: stringValue(branch.name),
+        commit: {
+            sha: stringValue(commit.sha),
+            url: stringValue(commit.url),
+        },
+        protected: booleanValue(branch.protected),
+    };
+}
+async function getDefaultBranch(adapter, params) {
+    const response = await adapter.request('GET', repoEndpoint(params.owner, params.repo));
+    const repository = asRecord(response, 'repository');
+    const branch = stringValue(repository.default_branch);
+    if (!branch) {
+        const id = numberValue(repository.id);
+        throw new Error(id
+            ? `Repository ${params.owner}/${params.repo} did not include a default branch.`
+            : `Repository ${params.owner}/${params.repo} was not a valid repository response.`);
+    }
+    return branch;
+}
+//# sourceMappingURL=branches.js.map

package/dist/actions/branches.js.map

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

package/dist/actions/commits.d.ts

@@ -0,0 +1,15 @@
+import type { CommitInfo, CreateCommitParams, ListCommitsParams } from '../types.js';
+import { type GitHubActionAdapter } from './utils.js';
+/**
+ * List commits for a repository.
+ */
+export declare function listCommits(adapter: GitHubActionAdapter, params: ListCommitsParams): Promise<CommitInfo[]>;
+/**
+ * Create a Git commit object.
+ *
+ * This creates the commit object only. Updating a branch ref is intentionally a
+ * separate operation so callers can decide when to move refs.
+ */
+export declare function createCommit(adapter: GitHubActionAdapter, params: CreateCommitParams): Promise<CommitInfo>;
+export declare function mapCommit(value: unknown): CommitInfo;
+//# sourceMappingURL=commits.d.ts.map

package/dist/actions/commits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commits.d.ts","sourceRoot":"","sources":["../../src/actions/commits.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,kBAAkB,EAGlB,iBAAiB,EAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EAYL,KAAK,mBAAmB,EACzB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,mBAAmB,EAC5B,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,UAAU,EAAE,CAAC,CAoBvB;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,mBAAmB,EAC5B,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,UAAU,CAAC,CAwBrB;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAcpD"}

package/dist/actions/commits.js

@@ -0,0 +1,71 @@
+import { asArray, asRecord, assertNonEmptyString, assertOwnerRepo, normalizePerPage, optionalRecord, optionalString, removeUndefinedValues, repoEndpoint, stringValue, withActionError, } from './utils.js';
+/**
+ * List commits for a repository.
+ */
+export async function listCommits(adapter, params) {
+    const { owner, repo } = params;
+    return withActionError(`list GitHub commits for ${owner}/${repo}`, async () => {
+        assertOwnerRepo(owner, repo);
+        const query = {
+            sha: params.sha,
+            path: params.path,
+            author: params.author,
+            since: params.since,
+            until: params.until,
+            per_page: normalizePerPage(params.perPage),
+        };
+        const response = await adapter.request('GET', repoEndpoint(owner, repo, '/commits'), {
+            query,
+        });
+        return asArray(response, 'commits').map(mapCommit);
+    });
+}
+/**
+ * Create a Git commit object.
+ *
+ * This creates the commit object only. Updating a branch ref is intentionally a
+ * separate operation so callers can decide when to move refs.
+ */
+export async function createCommit(adapter, params) {
+    const { owner, repo } = params;
+    return withActionError(`create GitHub commit in ${owner}/${repo}`, async () => {
+        assertOwnerRepo(owner, repo);
+        const message = assertNonEmptyString(params.message, 'commit message');
+        const tree = assertNonEmptyString(params.tree, 'commit tree');
+        if (!Array.isArray(params.parents)) {
+            throw new Error('GitHub commit parents must be an array of parent SHAs.');
+        }
+        const response = await adapter.request('POST', repoEndpoint(owner, repo, '/git/commits'), {
+            body: removeUndefinedValues({
+                message,
+                tree,
+                parents: params.parents.map((parent) => assertNonEmptyString(parent, 'parent sha')),
+                author: params.author,
+                committer: params.committer,
+            }),
+        });
+        return mapCommit(response);
+    });
+}
+export function mapCommit(value) {
+    const topLevel = asRecord(value, 'commit');
+    const nestedCommit = optionalRecord(topLevel.commit);
+    const author = optionalRecord(nestedCommit?.author ?? topLevel.author);
+    const committer = optionalRecord(nestedCommit?.committer ?? topLevel.committer);
+    return {
+        sha: stringValue(topLevel.sha),
+        url: optionalString(topLevel.url),
+        htmlUrl: optionalString(topLevel.html_url),
+        message: optionalString(nestedCommit?.message ?? topLevel.message),
+        author: author ? mapCommitAuthor(author) : undefined,
+        committer: committer ? mapCommitAuthor(committer) : undefined,
+    };
+}
+function mapCommitAuthor(value) {
+    return {
+        name: stringValue(value.name),
+        email: stringValue(value.email),
+        date: optionalString(value.date),
+    };
+}
+//# sourceMappingURL=commits.js.map

package/dist/actions/commits.js.map

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

package/dist/actions/files.d.ts

@@ -0,0 +1,40 @@
+import type { CreateFileParams, DeleteFileParams, GitHubFile, ListFilesParams, UpdateFileParams } from '../types.js';
+import { type GitHubActionAdapter } from './utils.js';
+export type ListFileOptions = Omit<ListFilesParams, 'owner' | 'repo' | 'path'>;
+export type CreateFileOptions = Omit<CreateFileParams, 'owner' | 'repo' | 'path' | 'content' | 'message'>;
+export type UpdateFileOptions = Omit<UpdateFileParams, 'owner' | 'repo' | 'path' | 'content' | 'message' | 'sha'>;
+export type DeleteFileOptions = Omit<DeleteFileParams, 'owner' | 'repo' | 'path' | 'sha' | 'message'>;
+/**
+ * List files or directories at a repository path.
+ *
+ * Directory responses are returned as a file list. If the path points at a
+ * single file, the file is returned as a one-item list.
+ */
+export declare function listFiles(adapter: GitHubActionAdapter, owner: string, repo: string, path?: string, options?: ListFileOptions): Promise<GitHubFile[]>;
+/**
+ * Read a repository file and return decoded UTF-8 content.
+ *
+ * The GitHub contents API returns base64 encoded file data; this action decodes
+ * the payload before returning it to callers.
+ */
+export declare function readFile(adapter: GitHubActionAdapter, owner: string, repo: string, path: string, ref?: string): Promise<string>;
+/**
+ * Create a file in a repository.
+ *
+ * Content is encoded as base64 and committed with the supplied message. The
+ * action resolves when GitHub accepts the create request.
+ */
+export declare function createFile(adapter: GitHubActionAdapter, owner: string, repo: string, path: string, content: string, message: string, options?: CreateFileOptions): Promise<void>;
+/**
+ * Update an existing repository file.
+ *
+ * The file SHA is required by the GitHub contents API to avoid overwriting an
+ * unexpected version.
+ */
+export declare function updateFile(adapter: GitHubActionAdapter, owner: string, repo: string, path: string, content: string, message: string, sha: string, options?: UpdateFileOptions): Promise<GitHubFile>;
+/**
+ * Delete a repository file with a commit message.
+ */
+export declare function deleteFile(adapter: GitHubActionAdapter, owner: string, repo: string, path: string, sha: string, message: string, options?: DeleteFileOptions): Promise<void>;
+export declare function mapFile(value: unknown): GitHubFile;
+//# sourceMappingURL=files.d.ts.map

package/dist/actions/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/actions/files.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,gBAAgB,EACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAYL,KAAK,mBAAmB,EACzB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;AAC/E,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC,CAAC;AAC1G,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAClC,gBAAgB,EAChB,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,KAAK,CAC1D,CAAC;AACF,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC,CAAC;AAEtG;;;;;GAKG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,SAAK,EACT,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,UAAU,EAAE,CAAC,CAavB;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,CAyBjB;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,UAAU,CAAC,CAoBrB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAkBlD"}

package/dist/actions/files.js

@@ -0,0 +1,133 @@
+import { Buffer } from 'node:buffer';
+import { asArray, asRecord, assertNonEmptyString, assertOwnerRepo, contentsEndpoint, normalizeRepoPath, numberValue, optionalString, removeUndefinedValues, stringValue, withActionError, } from './utils.js';
+/**
+ * List files or directories at a repository path.
+ *
+ * Directory responses are returned as a file list. If the path points at a
+ * single file, the file is returned as a one-item list.
+ */
+export async function listFiles(adapter, owner, repo, path = '', options = {}) {
+    return withActionError(`list GitHub files at ${owner}/${repo}/${path}`, async () => {
+        assertOwnerRepo(owner, repo);
+        const response = await adapter.request('GET', contentsEndpoint(owner, repo, path), {
+            query: {
+                ref: options.ref,
+            },
+        });
+        return Array.isArray(response)
+            ? asArray(response, 'repository contents').map(mapFile)
+            : [mapFile(response)];
+    });
+}
+/**
+ * Read a repository file and return decoded UTF-8 content.
+ *
+ * The GitHub contents API returns base64 encoded file data; this action decodes
+ * the payload before returning it to callers.
+ */
+export async function readFile(adapter, owner, repo, path, ref) {
+    return withActionError(`read GitHub file ${owner}/${repo}/${path}`, async () => {
+        assertOwnerRepo(owner, repo);
+        assertNonEmptyString(normalizeRepoPath(path), 'file path');
+        const response = await adapter.request('GET', contentsEndpoint(owner, repo, path), {
+            query: {
+                ref,
+            },
+        });
+        const file = mapFile(response);
+        if (file.type !== 'file') {
+            throw new Error(`GitHub path "${path}" is not a file.`);
+        }
+        if (!file.content) {
+            throw new Error(`GitHub file "${path}" did not include content in the API response.`);
+        }
+        if (file.encoding && file.encoding !== 'base64') {
+            throw new Error(`GitHub file "${path}" used unsupported encoding "${file.encoding}".`);
+        }
+        return Buffer.from(file.content.replace(/\s/g, ''), 'base64').toString('utf8');
+    });
+}
+/**
+ * Create a file in a repository.
+ *
+ * Content is encoded as base64 and committed with the supplied message. The
+ * action resolves when GitHub accepts the create request.
+ */
+export async function createFile(adapter, owner, repo, path, content, message, options = {}) {
+    return withActionError(`create GitHub file ${owner}/${repo}/${path}`, async () => {
+        assertOwnerRepo(owner, repo);
+        const normalizedPath = assertNonEmptyString(normalizeRepoPath(path), 'file path');
+        const commitMessage = assertNonEmptyString(message, 'commit message');
+        await adapter.request('PUT', contentsEndpoint(owner, repo, normalizedPath), {
+            body: removeUndefinedValues({
+                message: commitMessage,
+                content: Buffer.from(content, 'utf8').toString('base64'),
+                branch: options.branch,
+                author: options.author,
+            }),
+        });
+    });
+}
+/**
+ * Update an existing repository file.
+ *
+ * The file SHA is required by the GitHub contents API to avoid overwriting an
+ * unexpected version.
+ */
+export async function updateFile(adapter, owner, repo, path, content, message, sha, options = {}) {
+    return withActionError(`update GitHub file ${owner}/${repo}/${path}`, async () => {
+        assertOwnerRepo(owner, repo);
+        const normalizedPath = assertNonEmptyString(normalizeRepoPath(path), 'file path');
+        const commitMessage = assertNonEmptyString(message, 'commit message');
+        const fileSha = assertNonEmptyString(sha, 'file sha');
+        const response = await adapter.request('PUT', contentsEndpoint(owner, repo, normalizedPath), {
+            body: removeUndefinedValues({
+                message: commitMessage,
+                content: Buffer.from(content, 'utf8').toString('base64'),
+                sha: fileSha,
+                branch: options.branch,
+                author: options.author,
+            }),
+        });
+        const contentRecord = asRecord(response, 'update file response').content;
+        return mapFile(contentRecord);
+    });
+}
+/**
+ * Delete a repository file with a commit message.
+ */
+export async function deleteFile(adapter, owner, repo, path, sha, message, options = {}) {
+    return withActionError(`delete GitHub file ${owner}/${repo}/${path}`, async () => {
+        assertOwnerRepo(owner, repo);
+        const normalizedPath = assertNonEmptyString(normalizeRepoPath(path), 'file path');
+        const fileSha = assertNonEmptyString(sha, 'file sha');
+        const commitMessage = assertNonEmptyString(message, 'commit message');
+        await adapter.request('DELETE', contentsEndpoint(owner, repo, normalizedPath), {
+            body: removeUndefinedValues({
+                message: commitMessage,
+                sha: fileSha,
+                branch: options.branch,
+                author: options.author,
+            }),
+        });
+    });
+}
+export function mapFile(value) {
+    const file = asRecord(value, 'repository content');
+    const type = stringValue(file.type) === 'dir' ? 'dir' : 'file';
+    return {
+        name: stringValue(file.name),
+        path: stringValue(file.path),
+        sha: stringValue(file.sha),
+        size: numberValue(file.size),
+        url: stringValue(file.url),
+        htmlUrl: stringValue(file.html_url),
+        gitUrl: stringValue(file.git_url),
+        downloadUrl: optionalString(file.download_url),
+        type,
+        content: optionalString(file.content),
+        encoding: optionalString(file.encoding),
+        target: optionalString(file.target),
+    };
+}
+//# sourceMappingURL=files.js.map

package/dist/actions/files.js.map

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

package/dist/actions/issues.d.ts

@@ -0,0 +1,29 @@
+import type { CreateIssueParams, Issue, ListIssuesParams, UpdateIssueParams } from '../types.js';
+import { type GitHubActionAdapter } from './utils.js';
+export type ListIssueOptions = Omit<ListIssuesParams, 'owner' | 'repo'>;
+export type CreateIssueOptions = Omit<CreateIssueParams, 'owner' | 'repo' | 'title' | 'body'>;
+export type IssueUpdates = Omit<UpdateIssueParams, 'owner' | 'repo' | 'issueNumber'>;
+/**
+ * List repository issues.
+ *
+ * Pull requests are excluded from the repository issues endpoint response so
+ * callers receive only true issues. Local and cloud runtimes are handled by the
+ * provided adapter.
+ */
+export declare function listIssues(adapter: GitHubActionAdapter, owner: string, repo: string, options?: ListIssueOptions): Promise<Issue[]>;
+/**
+ * Create an issue in a repository.
+ *
+ * The request body is sent through the adapter request layer, allowing the
+ * local `gh api` runtime and the cloud proxy runtime to share the same action.
+ */
+export declare function createIssue(adapter: GitHubActionAdapter, owner: string, repo: string, title: string, body?: string, options?: CreateIssueOptions): Promise<Issue>;
+/**
+ * Update an existing issue.
+ *
+ * At least one update field must be supplied. Supported updates include title,
+ * body, state, assignee, and labels.
+ */
+export declare function updateIssue(adapter: GitHubActionAdapter, owner: string, repo: string, number: number, updates: IssueUpdates): Promise<Issue>;
+export declare function mapIssue(value: unknown): Issue;
+//# sourceMappingURL=issues.d.ts.map

package/dist/actions/issues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issues.d.ts","sourceRoot":"","sources":["../../src/actions/issues.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACjG,OAAO,EAoBL,KAAK,mBAAmB,EACzB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC;AACxE,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,iBAAiB,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC,CAAC;AAC9F,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,iBAAiB,EAAE,OAAO,GAAG,MAAM,GAAG,aAAa,CAAC,CAAC;AAErF;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,KAAK,EAAE,CAAC,CAmBlB;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,EACb,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,KAAK,CAAC,CAgBhB;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,KAAK,CAAC,CAqBhB;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CA+B9C"}

package/dist/actions/issues.js

@@ -0,0 +1,120 @@
+import { asArray, asRecord, assertNonEmptyString, assertOwnerRepo, assertPositiveInteger, booleanValue, hasDefinedValue, mapGitHubOwner, mapLogin, mapLogins, numberValue, optionalRecord, optionalString, queryWithPerPage, removeUndefinedValues, repoEndpoint, stateValue, stringValue, withActionError, } from './utils.js';
+/**
+ * List repository issues.
+ *
+ * Pull requests are excluded from the repository issues endpoint response so
+ * callers receive only true issues. Local and cloud runtimes are handled by the
+ * provided adapter.
+ */
+export async function listIssues(adapter, owner, repo, options = {}) {
+    return withActionError(`list GitHub issues for ${owner}/${repo}`, async () => {
+        assertOwnerRepo(owner, repo);
+        const query = queryWithPerPage({
+            state: options.state,
+            assignee: options.assignee,
+            labels: options.labels,
+            sort: options.sort,
+            direction: options.direction,
+        }, options.perPage);
+        const response = await adapter.request('GET', repoEndpoint(owner, repo, '/issues'), {
+            query,
+        });
+        return asArray(response, 'issues').filter(isIssueResponse).map(mapIssue);
+    });
+}
+/**
+ * Create an issue in a repository.
+ *
+ * The request body is sent through the adapter request layer, allowing the
+ * local `gh api` runtime and the cloud proxy runtime to share the same action.
+ */
+export async function createIssue(adapter, owner, repo, title, body, options = {}) {
+    return withActionError(`create GitHub issue in ${owner}/${repo}`, async () => {
+        assertOwnerRepo(owner, repo);
+        const issueTitle = assertNonEmptyString(title, 'issue title');
+        const response = await adapter.request('POST', repoEndpoint(owner, repo, '/issues'), {
+            body: removeUndefinedValues({
+                title: issueTitle,
+                body,
+                assignees: options.assignee ? [options.assignee] : undefined,
+                labels: options.labels,
+                milestone: options.milestone,
+            }),
+        });
+        return mapIssue(response);
+    });
+}
+/**
+ * Update an existing issue.
+ *
+ * At least one update field must be supplied. Supported updates include title,
+ * body, state, assignee, and labels.
+ */
+export async function updateIssue(adapter, owner, repo, number, updates) {
+    return withActionError(`update GitHub issue #${number} in ${owner}/${repo}`, async () => {
+        assertOwnerRepo(owner, repo);
+        assertPositiveInteger(number, 'issue number');
+        if (!hasDefinedValue(updates)) {
+            throw new Error('At least one issue update field must be provided.');
+        }
+        const response = await adapter.request('PATCH', repoEndpoint(owner, repo, `/issues/${number}`), {
+            body: removeUndefinedValues({
+                title: updates.title,
+                body: updates.body,
+                state: updates.state,
+                assignees: updates.assignee ? [updates.assignee] : undefined,
+                labels: updates.labels,
+            }),
+        });
+        return mapIssue(response);
+    });
+}
+export function mapIssue(value) {
+    const issue = asRecord(value, 'issue');
+    const milestone = optionalRecord(issue.milestone);
+    const reactions = optionalRecord(issue.reactions);
+    return {
+        number: numberValue(issue.number),
+        id: numberValue(issue.id),
+        title: stringValue(issue.title),
+        body: optionalString(issue.body),
+        user: mapGitHubOwner(issue.user),
+        labels: Array.isArray(issue.labels) ? issue.labels.map(mapIssueLabel) : [],
+        state: stateValue(issue.state),
+        locked: booleanValue(issue.locked),
+        assignee: issue.assignee ? mapLogin(issue.assignee) : undefined,
+        assignees: mapLogins(issue.assignees),
+        milestone: milestone
+            ? {
+                number: numberValue(milestone.number),
+                title: stringValue(milestone.title),
+            }
+            : undefined,
+        commentsCount: numberValue(issue.comments),
+        createdAt: stringValue(issue.created_at),
+        updatedAt: stringValue(issue.updated_at),
+        closedAt: optionalString(issue.closed_at),
+        authorAssociation: stringValue(issue.author_association),
+        reactions: {
+            totalCount: numberValue(reactions?.total_count),
+        },
+    };
+}
+function mapIssueLabel(value) {
+    if (typeof value === 'string') {
+        return {
+            name: value,
+            color: '',
+        };
+    }
+    const label = asRecord(value, 'issue label');
+    return {
+        name: stringValue(label.name),
+        color: stringValue(label.color),
+        description: optionalString(label.description),
+    };
+}
+function isIssueResponse(value) {
+    return !('pull_request' in asRecord(value, 'issue'));
+}
+//# sourceMappingURL=issues.js.map

package/dist/actions/issues.js.map

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

package/dist/actions/pulls.d.ts

@@ -0,0 +1,40 @@
+import type { CreatePRParams, ListPRsParams, MergePRParams, PR, UpdatePRParams } from '../types.js';
+import { type GitHubActionAdapter } from './utils.js';
+export type ListPROptions = Omit<ListPRsParams, 'owner' | 'repo'>;
+export type CreatePROptions = Omit<CreatePRParams, 'owner' | 'repo' | 'title' | 'body' | 'base' | 'head'>;
+export type PullRequestUpdates = Omit<UpdatePRParams, 'owner' | 'repo' | 'pullNumber'>;
+/**
+ * List pull requests for a repository.
+ *
+ * Query options are mapped to GitHub REST parameters and the adapter determines
+ * whether the call is executed through `gh api` or the configured cloud proxy.
+ */
+export declare function listPRs(adapter: GitHubActionAdapter, owner: string, repo: string, options?: ListPROptions): Promise<PR[]>;
+/**
+ * Fetch a single pull request by number.
+ */
+export declare function getPR(adapter: GitHubActionAdapter, owner: string, repo: string, number: number): Promise<PR>;
+/**
+ * Create a pull request.
+ *
+ * The supplied base and head refs are passed directly to the GitHub REST API,
+ * supporting same-repository branches and owner-qualified fork refs.
+ */
+export declare function createPR(adapter: GitHubActionAdapter, owner: string, repo: string, title: string, body: string | undefined, base: string, head: string, options?: CreatePROptions): Promise<PR>;
+/**
+ * Update an existing pull request.
+ *
+ * At least one update field must be provided. GitHub accepts base branch
+ * changes and maintainer edit permissions through the same endpoint.
+ */
+export declare function updatePR(adapter: GitHubActionAdapter, owner: string, repo: string, number: number, updates: PullRequestUpdates): Promise<PR>;
+/**
+ * Merge a pull request and return the fresh pull request representation.
+ *
+ * GitHub's merge endpoint returns a small confirmation payload, so this action
+ * fetches the pull request after a successful merge to preserve the typed PR
+ * return value used by the primitive.
+ */
+export declare function mergePR(adapter: GitHubActionAdapter, owner: string, repo: string, number: number, options?: Omit<MergePRParams, 'owner' | 'repo' | 'pullNumber'>): Promise<PR>;
+export declare function mapPR(value: unknown): PR;
+//# sourceMappingURL=pulls.d.ts.map

package/dist/actions/pulls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pulls.d.ts","sourceRoot":"","sources":["../../src/actions/pulls.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,EAAE,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACpG,OAAO,EAoBL,KAAK,mBAAmB,EACzB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC;AAClE,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,cAAc,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;AAC1G,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,cAAc,EAAE,OAAO,GAAG,MAAM,GAAG,YAAY,CAAC,CAAC;AAEvF;;;;;GAKG;AACH,wBAAsB,OAAO,CAC3B,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,EAAE,EAAE,CAAC,CAmBf;AAED;;GAEG;AACH,wBAAsB,KAAK,CACzB,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,EAAE,CAAC,CAQb;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,EAAE,CAAC,CAmBb;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,EAAE,CAAC,CAqBb;AAED;;;;;;GAMG;AACH,wBAAsB,OAAO,CAC3B,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,IAAI,CAAC,aAAa,EAAE,OAAO,GAAG,MAAM,GAAG,YAAY,CAAM,GACjE,OAAO,CAAC,EAAE,CAAC,CAeb;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,EAAE,CAkDxC"}