102 lines
2.6 KiB
TypeScript
102 lines
2.6 KiB
TypeScript
/**
|
|
* Single source of truth for reading, updating, deleting, and creating "progress comments" —
|
|
* the Gitea comments shockbot uses to surface a run's status.
|
|
*/
|
|
|
|
import type { Gitea } from "./gitea.ts";
|
|
|
|
export type ProgressCommentType = "issue";
|
|
|
|
export type ProgressComment = {
|
|
id: number;
|
|
type: ProgressCommentType;
|
|
};
|
|
|
|
export function parseProgressComment(
|
|
raw: { id: string; type: ProgressCommentType } | null | undefined
|
|
): ProgressComment | undefined {
|
|
if (!raw?.id) return undefined;
|
|
const id = parseInt(raw.id, 10);
|
|
if (Number.isNaN(id) || id <= 0) return undefined;
|
|
return { id, type: raw.type };
|
|
}
|
|
|
|
interface ApiCtx {
|
|
gitea: Gitea;
|
|
owner: string;
|
|
repo: string;
|
|
}
|
|
|
|
export async function getProgressComment(
|
|
ctx: ApiCtx,
|
|
comment: ProgressComment
|
|
): Promise<{ id: number; body: string | undefined; html_url: string }> {
|
|
const result = await ctx.gitea.rest.issue.issueGetComment({
|
|
owner: ctx.owner,
|
|
repo: ctx.repo,
|
|
id: comment.id,
|
|
});
|
|
return { id: result.data.id!, body: result.data.body ?? undefined, html_url: result.data.html_url! };
|
|
}
|
|
|
|
export async function updateProgressComment(
|
|
ctx: ApiCtx,
|
|
comment: ProgressComment,
|
|
body: string
|
|
): Promise<{ id: number; body: string | undefined; html_url: string; node_id: string | undefined }> {
|
|
const result = await ctx.gitea.rest.issue.issueEditComment({
|
|
owner: ctx.owner,
|
|
repo: ctx.repo,
|
|
id: comment.id,
|
|
body: { body },
|
|
});
|
|
return {
|
|
id: result.data.id!,
|
|
body: result.data.body ?? undefined,
|
|
html_url: result.data.html_url!,
|
|
node_id: undefined,
|
|
};
|
|
}
|
|
|
|
export async function deleteProgressCommentApi(
|
|
ctx: ApiCtx,
|
|
comment: ProgressComment
|
|
): Promise<void> {
|
|
await ctx.gitea.rest.issue.issueDeleteComment({
|
|
owner: ctx.owner,
|
|
repo: ctx.repo,
|
|
id: comment.id,
|
|
});
|
|
}
|
|
|
|
export type CreateProgressCommentTarget =
|
|
| { kind: "issue"; issueNumber: number }
|
|
| { kind: "reviewReply"; pullNumber: number; replyToCommentId: number };
|
|
|
|
export interface CreatedProgressComment {
|
|
comment: ProgressComment;
|
|
body: string | undefined;
|
|
html_url: string;
|
|
}
|
|
|
|
export async function createLeapingProgressComment(
|
|
ctx: ApiCtx,
|
|
target: CreateProgressCommentTarget,
|
|
body: string
|
|
): Promise<CreatedProgressComment> {
|
|
const issueNumber =
|
|
target.kind === "issue" ? target.issueNumber : target.pullNumber;
|
|
|
|
const result = await ctx.gitea.rest.issue.issueCreateComment({
|
|
owner: ctx.owner,
|
|
repo: ctx.repo,
|
|
index: issueNumber,
|
|
body: { body },
|
|
});
|
|
return {
|
|
comment: { id: result.data.id!, type: "issue" },
|
|
body: result.data.body ?? undefined,
|
|
html_url: result.data.html_url!,
|
|
};
|
|
}
|