@storyshelf/notify-git 0.0.0-stage → 0.7.0

package/dist/github-status.mjs

@@ -0,0 +1,44 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { githubHeaders, repoPath } from "./github-api.mjs";
+import { mapState } from "./github-mapper.mjs";
+import { httpJson } from "@storyshelf/core/utils";
+//#region src/github-status.ts
+/**
+* Post a commit status to GitHub under the full `context` name the caller chose
+* (`<prefix>/testing`); the provider adds no prefix of its own. Posting the same
+* `(sha, context)` again replaces the state, so it is idempotent and latest wins.
+*/
+async function postCommitStatus(repo, input) {
+	const state = mapState(input.state);
+	repo.logger?.debug({
+		context: input.context,
+		sha: input.sha,
+		state
+	}, "posting commit status");
+	try {
+		await httpJson(repoPath(repo.owner, repo.repo, `/statuses/${encodeURIComponent(input.sha)}`), {
+			method: "POST",
+			headers: githubHeaders(repo.token),
+			json: {
+				state,
+				...input.url === void 0 ? {} : { target_url: input.url },
+				description: input.description,
+				context: input.context
+			},
+			logger: repo.logger
+		});
+	} catch (error) {
+		repo.logger?.error({
+			err: error,
+			context: input.context,
+			sha: input.sha
+		}, "failed to post commit status");
+		throw error;
+	}
+}
+//#endregion
+export { postCommitStatus };
+
+//# sourceMappingURL=github-status.mjs.map

package/dist/github-status.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-status.mjs","names":[],"sources":["../src/github-status.ts"],"sourcesContent":["import type { NotifierState } from \"@storyshelf/core/adapter/notifier\";\nimport type { Logger } from \"@storyshelf/core/logger\";\nimport { httpJson } from \"@storyshelf/core/utils\";\nimport { githubHeaders, repoPath } from \"./github-api.ts\";\nimport { mapState } from \"./github-mapper.ts\";\n\n/** Coordinates and credential of one GitHub repository. */\nexport interface GitHubRepo {\n  token: string;\n  owner: string;\n  repo: string;\n  logger?: Logger | undefined;\n}\n\n/**\n * Post a commit status to GitHub under the full `context` name the caller chose\n * (`<prefix>/testing`); the provider adds no prefix of its own. Posting the same\n * `(sha, context)` again replaces the state, so it is idempotent and latest wins.\n */\nexport async function postCommitStatus(\n  repo: GitHubRepo,\n  input: {\n    sha: string;\n    context: string;\n    state: NotifierState;\n    description: string;\n    /** Absent while no public origin is known. */\n    url?: string | undefined;\n  },\n): Promise<void> {\n  const state = mapState(input.state);\n  repo.logger?.debug({ context: input.context, sha: input.sha, state }, \"posting commit status\");\n  try {\n    await httpJson(repoPath(repo.owner, repo.repo, `/statuses/${encodeURIComponent(input.sha)}`), {\n      method: \"POST\",\n      headers: githubHeaders(repo.token),\n      json: {\n        state,\n        ...(input.url === undefined ? {} : { target_url: input.url }),\n        description: input.description,\n        context: input.context,\n      },\n      logger: repo.logger,\n    });\n  } catch (error) {\n    repo.logger?.error(\n      { err: error, context: input.context, sha: input.sha },\n      \"failed to post commit status\",\n    );\n    throw error;\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAmBA,eAAsB,iBACpB,MACA,OAQe;CACf,MAAM,QAAQ,SAAS,MAAM,KAAK;CAClC,KAAK,QAAQ,MAAM;EAAE,SAAS,MAAM;EAAS,KAAK,MAAM;EAAK;CAAM,GAAG,uBAAuB;CAC7F,IAAI;EACF,MAAM,SAAS,SAAS,KAAK,OAAO,KAAK,MAAM,aAAa,mBAAmB,MAAM,GAAG,GAAG,GAAG;GAC5F,QAAQ;GACR,SAAS,cAAc,KAAK,KAAK;GACjC,MAAM;IACJ;IACA,GAAI,MAAM,QAAQ,KAAA,IAAY,CAAC,IAAI,EAAE,YAAY,MAAM,IAAI;IAC3D,aAAa,MAAM;IACnB,SAAS,MAAM;GACjB;GACA,QAAQ,KAAK;EACf,CAAC;CACH,SAAS,OAAO;EACd,KAAK,QAAQ,MACX;GAAE,KAAK;GAAO,SAAS,MAAM;GAAS,KAAK,MAAM;EAAI,GACrD,8BACF;EACA,MAAM;CACR;AACF"}

package/dist/github.d.mts

@@ -0,0 +1,13 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { StateNotifierProvider } from "@storyshelf/core/adapter/notifier";
+//#region src/github.d.ts
+/**
+ * GitHub provider (`state` delivery). In `statuses` mode (default) it posts commit statuses with
+ * the channel's token; in `checks` mode it posts check runs as the channel's GitHub App. Either
+ * way it also keeps the pull-request comment.
+ */
+declare const gitHubNotifier: StateNotifierProvider;
+//#endregion
+export { gitHubNotifier };
+//# sourceMappingURL=github.d.mts.map

package/dist/github.mjs

@@ -0,0 +1,66 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { installationToken } from "./github-app.mjs";
+import { postCheckRun } from "./github-check.mjs";
+import { upsertPrComment } from "./github-comment.mjs";
+import { githubConfigSchema } from "./github-config.mjs";
+import { postCommitStatus } from "./github-status.mjs";
+import { createStateAdapter, requireToken } from "./state-adapter.mjs";
+import { packageVersion } from "./version.mjs";
+//#region src/github.ts
+/**
+* GitHub provider (`state` delivery). In `statuses` mode (default) it posts commit statuses with
+* the channel's token; in `checks` mode it posts check runs as the channel's GitHub App. Either
+* way it also keeps the pull-request comment.
+*/
+const gitHubNotifier = {
+	metadata: getMetadata(),
+	create(opts) {
+		const cfg = githubConfigSchema.parse(opts.config);
+		const logger = opts.logger?.child({ component: "notify-git-github" });
+		const token = tokenSource(cfg, requireToken(opts.secret, "GitHub", cfg.mode === "checks" ? "a private key" : "a token"));
+		const repo = async () => ({
+			token: await token(),
+			owner: cfg.owner,
+			repo: cfg.repo,
+			logger
+		});
+		return createStateAdapter(getMetadata(), {
+			status: async (input) => {
+				await (cfg.mode === "checks" ? postCheckRun(await repo(), input) : postCommitStatus(await repo(), input));
+			},
+			comment: async (input) => await upsertPrComment(await repo(), {
+				...input,
+				logger
+			})
+		}, logger);
+	}
+};
+/** The token every request uses: the channel's token, or the App's installation token. */
+function tokenSource(cfg, secret) {
+	if (cfg.mode !== "checks" || cfg.appId === void 0 || cfg.installationId === void 0) return async () => await Promise.resolve(secret);
+	const creds = {
+		appId: cfg.appId,
+		installationId: cfg.installationId,
+		privateKey: secret
+	};
+	return async () => await installationToken(creds);
+}
+/** Describe the GitHub provider (name, version, config schema). */
+function getMetadata() {
+	return {
+		name: "GitHub",
+		version: packageVersion(),
+		description: "Commit statuses or GitHub App check runs, and pull-request comments, via the GitHub REST API",
+		kind: "github",
+		category: "notifier",
+		delivery: "state",
+		logo: "github",
+		schema: githubConfigSchema
+	};
+}
+//#endregion
+export { getMetadata, gitHubNotifier };
+
+//# sourceMappingURL=github.mjs.map

package/dist/github.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.mjs","names":[],"sources":["../src/github.ts"],"sourcesContent":["import type { StateNotifierProvider } from \"@storyshelf/core/adapter/notifier\";\nimport type { Logger } from \"@storyshelf/core/logger\";\nimport { installationToken } from \"./github-app.ts\";\nimport { postCheckRun } from \"./github-check.ts\";\nimport { upsertPrComment } from \"./github-comment.ts\";\nimport { githubConfigSchema, type GitHubConfig } from \"./github-config.ts\";\nimport { postCommitStatus, type GitHubRepo } from \"./github-status.ts\";\nimport { createStateAdapter, requireToken, type StateWriter } from \"./state-adapter.ts\";\nimport { packageVersion } from \"./version.ts\";\n\n/**\n * GitHub provider (`state` delivery). In `statuses` mode (default) it posts commit statuses with\n * the channel's token; in `checks` mode it posts check runs as the channel's GitHub App. Either\n * way it also keeps the pull-request comment.\n */\nexport const gitHubNotifier: StateNotifierProvider = {\n  metadata: getMetadata(),\n  create(opts: { config: unknown; secret?: string; logger?: Logger }) {\n    const cfg = githubConfigSchema.parse(opts.config);\n    const logger = opts.logger?.child({ component: \"notify-git-github\" });\n    const secret = requireToken(\n      opts.secret,\n      \"GitHub\",\n      cfg.mode === \"checks\" ? \"a private key\" : \"a token\",\n    );\n    const token = tokenSource(cfg, secret);\n    const repo = async (): Promise<GitHubRepo> => ({\n      token: await token(),\n      owner: cfg.owner,\n      repo: cfg.repo,\n      logger,\n    });\n    const writer: StateWriter = {\n      status: async (input) => {\n        await (cfg.mode === \"checks\"\n          ? postCheckRun(await repo(), input)\n          : postCommitStatus(await repo(), input));\n      },\n      comment: async (input) => await upsertPrComment(await repo(), { ...input, logger }),\n    };\n    return createStateAdapter(getMetadata(), writer, logger);\n  },\n};\n\n/** The token every request uses: the channel's token, or the App's installation token. */\nfunction tokenSource(cfg: GitHubConfig, secret: string): () => Promise<string> {\n  if (cfg.mode !== \"checks\" || cfg.appId === undefined || cfg.installationId === undefined) {\n    return async () => await Promise.resolve(secret);\n  }\n  const creds = { appId: cfg.appId, installationId: cfg.installationId, privateKey: secret };\n  return async () => await installationToken(creds);\n}\n\n/** Describe the GitHub provider (name, version, config schema). */\nexport function getMetadata(): StateNotifierProvider[\"metadata\"] {\n  return {\n    name: \"GitHub\",\n    version: packageVersion(),\n    description:\n      \"Commit statuses or GitHub App check runs, and pull-request comments, via the GitHub REST API\",\n    kind: \"github\",\n    category: \"notifier\",\n    delivery: \"state\",\n    logo: \"github\",\n    schema: githubConfigSchema,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAeA,MAAa,iBAAwC;CACnD,UAAU,YAAY;CACtB,OAAO,MAA6D;EAClE,MAAM,MAAM,mBAAmB,MAAM,KAAK,MAAM;EAChD,MAAM,SAAS,KAAK,QAAQ,MAAM,EAAE,WAAW,oBAAoB,CAAC;EAMpE,MAAM,QAAQ,YAAY,KALX,aACb,KAAK,QACL,UACA,IAAI,SAAS,WAAW,kBAAkB,SAER,CAAC;EACrC,MAAM,OAAO,aAAkC;GAC7C,OAAO,MAAM,MAAM;GACnB,OAAO,IAAI;GACX,MAAM,IAAI;GACV;EACF;EASA,OAAO,mBAAmB,YAAY,GAAG;GAPvC,QAAQ,OAAO,UAAU;IACvB,OAAO,IAAI,SAAS,WAChB,aAAa,MAAM,KAAK,GAAG,KAAK,IAChC,iBAAiB,MAAM,KAAK,GAAG,KAAK;GAC1C;GACA,SAAS,OAAO,UAAU,MAAM,gBAAgB,MAAM,KAAK,GAAG;IAAE,GAAG;IAAO;GAAO,CAAC;EAEtC,GAAG,MAAM;CACzD;AACF;;AAGA,SAAS,YAAY,KAAmB,QAAuC;CAC7E,IAAI,IAAI,SAAS,YAAY,IAAI,UAAU,KAAA,KAAa,IAAI,mBAAmB,KAAA,GAC7E,OAAO,YAAY,MAAM,QAAQ,QAAQ,MAAM;CAEjD,MAAM,QAAQ;EAAE,OAAO,IAAI;EAAO,gBAAgB,IAAI;EAAgB,YAAY;CAAO;CACzF,OAAO,YAAY,MAAM,kBAAkB,KAAK;AAClD;;AAGA,SAAgB,cAAiD;CAC/D,OAAO;EACL,MAAM;EACN,SAAS,eAAe;EACxB,aACE;EACF,MAAM;EACN,UAAU;EACV,UAAU;EACV,MAAM;EACN,QAAQ;CACV;AACF"}

package/dist/gitlab-api.mjs

@@ -0,0 +1,23 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+//#region src/gitlab-api.ts
+/** URL-encode an `owner/repo` pair as a GitLab project ID. */
+function projectId(owner, repo) {
+	return encodeURIComponent(`${owner}/${repo}`);
+}
+/** Normalize a GitLab host URL (defaults to gitlab.com, no trailing slash). */
+function apiBase(host = "https://gitlab.com") {
+	return host.replace(/\/+$/u, "");
+}
+/** Build the auth headers for GitLab API requests. */
+function gitlabHeaders(token) {
+	return {
+		"PRIVATE-TOKEN": token,
+		"content-type": "application/json"
+	};
+}
+//#endregion
+export { apiBase, gitlabHeaders, projectId };
+
+//# sourceMappingURL=gitlab-api.mjs.map

package/dist/gitlab-api.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitlab-api.mjs","names":[],"sources":["../src/gitlab-api.ts"],"sourcesContent":["/** URL-encode an `owner/repo` pair as a GitLab project ID. */\nexport function projectId(owner: string, repo: string): string {\n  return encodeURIComponent(`${owner}/${repo}`);\n}\n\n/** Normalize a GitLab host URL (defaults to gitlab.com, no trailing slash). */\nexport function apiBase(host = \"https://gitlab.com\"): string {\n  return host.replace(/\\/+$/u, \"\");\n}\n\n/** Build the auth headers for GitLab API requests. */\nexport function gitlabHeaders(token: string): Record<string, string> {\n  return {\n    \"PRIVATE-TOKEN\": token,\n    \"content-type\": \"application/json\",\n  };\n}\n"],"mappings":";;;;;AACA,SAAgB,UAAU,OAAe,MAAsB;CAC7D,OAAO,mBAAmB,GAAG,MAAM,GAAG,MAAM;AAC9C;;AAGA,SAAgB,QAAQ,OAAO,sBAA8B;CAC3D,OAAO,KAAK,QAAQ,SAAS,EAAE;AACjC;;AAGA,SAAgB,cAAc,OAAuC;CACnE,OAAO;EACL,iBAAiB;EACjB,gBAAgB;CAClB;AACF"}

package/dist/gitlab-comment.mjs

@@ -0,0 +1,65 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { upsertReviewComment } from "./review-comment.mjs";
+import { apiBase, gitlabHeaders, projectId } from "./gitlab-api.mjs";
+import { findMrIid } from "./gitlab-pr.mjs";
+import { httpJson } from "@storyshelf/core/utils";
+//#region src/gitlab-comment.ts
+/** Fetch-backed review thread (notes) for a merge request. */
+function createThread(base, pid, iid, headers) {
+	const threadUrl = `${base}/api/v4/projects/${pid}/merge_requests/${iid}/notes`;
+	return {
+		list: async () => {
+			try {
+				return (await httpJson(`${threadUrl}?per_page=100`, { headers })).map((note) => ({
+					id: note.id,
+					body: note.body ?? ""
+				}));
+			} catch {
+				return [];
+			}
+		},
+		update: async (id, body) => {
+			const updated = await httpJson(`${threadUrl}/${String(id)}`, {
+				method: "PUT",
+				headers,
+				json: { body }
+			});
+			return String(updated.id);
+		},
+		create: async (body) => {
+			const created = await httpJson(threadUrl, {
+				method: "POST",
+				headers,
+				json: { body }
+			});
+			return String(created.id);
+		}
+	};
+}
+/** Create or update the StoryShelf review note on the merge request of a commit. */
+async function upsertMrNote(project, input) {
+	const { host, owner, repo, token } = project;
+	const base = apiBase(host);
+	const pid = projectId(owner, repo);
+	const headers = gitlabHeaders(token);
+	return await upsertReviewComment({
+		url: input.url,
+		markdown: input.markdown,
+		sha: input.sha,
+		logger: input.logger,
+		resolveNumber: async () => await findMrIid({
+			host,
+			owner,
+			repo,
+			token,
+			sha: input.sha
+		}),
+		thread: (iid) => createThread(base, pid, iid, headers)
+	});
+}
+//#endregion
+export { upsertMrNote };
+
+//# sourceMappingURL=gitlab-comment.mjs.map

package/dist/gitlab-comment.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitlab-comment.mjs","names":[],"sources":["../src/gitlab-comment.ts"],"sourcesContent":["import type { Logger } from \"@storyshelf/core/logger\";\nimport { httpJson } from \"@storyshelf/core/utils\";\nimport { apiBase, gitlabHeaders, projectId } from \"./gitlab-api.ts\";\nimport { findMrIid } from \"./gitlab-pr.ts\";\nimport type { GitLabProject } from \"./gitlab-status.ts\";\nimport { upsertReviewComment, type ReviewThread } from \"./review-comment.ts\";\n\ninterface MergeRequestNote {\n  id: number;\n  body?: string | null;\n}\n\n/** Fetch-backed review thread (notes) for a merge request. */\nfunction createThread(\n  base: string,\n  pid: string,\n  iid: number,\n  headers: Record<string, string>,\n): ReviewThread {\n  const threadUrl = `${base}/api/v4/projects/${pid}/merge_requests/${iid}/notes`;\n  return {\n    list: async () => {\n      try {\n        const notes = await httpJson<MergeRequestNote[]>(`${threadUrl}?per_page=100`, { headers });\n        return notes.map((note) => ({ id: note.id, body: note.body ?? \"\" }));\n      } catch {\n        return [];\n      }\n    },\n    update: async (id, body) => {\n      const updated = await httpJson<MergeRequestNote>(`${threadUrl}/${String(id)}`, {\n        method: \"PUT\",\n        headers,\n        json: { body },\n      });\n      return String(updated.id);\n    },\n    create: async (body) => {\n      const created = await httpJson<MergeRequestNote>(threadUrl, {\n        method: \"POST\",\n        headers,\n        json: { body },\n      });\n      return String(created.id);\n    },\n  };\n}\n\n/** Create or update the StoryShelf review note on the merge request of a commit. */\nexport async function upsertMrNote(\n  project: GitLabProject,\n  input: { sha: string; url: string; markdown: string; logger?: Logger },\n): Promise<string> {\n  const { host, owner, repo, token } = project;\n  const base = apiBase(host);\n  const pid = projectId(owner, repo);\n  const headers = gitlabHeaders(token);\n  return await upsertReviewComment({\n    url: input.url,\n    markdown: input.markdown,\n    sha: input.sha,\n    logger: input.logger,\n    resolveNumber: async () => await findMrIid({ host, owner, repo, token, sha: input.sha }),\n    thread: (iid) => createThread(base, pid, iid, headers),\n  });\n}\n"],"mappings":";;;;;;;;;AAaA,SAAS,aACP,MACA,KACA,KACA,SACc;CACd,MAAM,YAAY,GAAG,KAAK,mBAAmB,IAAI,kBAAkB,IAAI;CACvE,OAAO;EACL,MAAM,YAAY;GAChB,IAAI;IAEF,QAAO,MADa,SAA6B,GAAG,UAAU,gBAAgB,EAAE,QAAQ,CAAC,EAAA,CAC5E,KAAK,UAAU;KAAE,IAAI,KAAK;KAAI,MAAM,KAAK,QAAQ;IAAG,EAAE;GACrE,QAAQ;IACN,OAAO,CAAC;GACV;EACF;EACA,QAAQ,OAAO,IAAI,SAAS;GAC1B,MAAM,UAAU,MAAM,SAA2B,GAAG,UAAU,GAAG,OAAO,EAAE,KAAK;IAC7E,QAAQ;IACR;IACA,MAAM,EAAE,KAAK;GACf,CAAC;GACD,OAAO,OAAO,QAAQ,EAAE;EAC1B;EACA,QAAQ,OAAO,SAAS;GACtB,MAAM,UAAU,MAAM,SAA2B,WAAW;IAC1D,QAAQ;IACR;IACA,MAAM,EAAE,KAAK;GACf,CAAC;GACD,OAAO,OAAO,QAAQ,EAAE;EAC1B;CACF;AACF;;AAGA,eAAsB,aACpB,SACA,OACiB;CACjB,MAAM,EAAE,MAAM,OAAO,MAAM,UAAU;CACrC,MAAM,OAAO,QAAQ,IAAI;CACzB,MAAM,MAAM,UAAU,OAAO,IAAI;CACjC,MAAM,UAAU,cAAc,KAAK;CACnC,OAAO,MAAM,oBAAoB;EAC/B,KAAK,MAAM;EACX,UAAU,MAAM;EAChB,KAAK,MAAM;EACX,QAAQ,MAAM;EACd,eAAe,YAAY,MAAM,UAAU;GAAE;GAAM;GAAO;GAAM;GAAO,KAAK,MAAM;EAAI,CAAC;EACvF,SAAS,QAAQ,aAAa,MAAM,KAAK,KAAK,OAAO;CACvD,CAAC;AACH"}

package/dist/gitlab-config.d.mts

@@ -0,0 +1,14 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { z } from "zod";
+//#region src/gitlab-config.d.ts
+/** Validation schema for a GitLab channel config (`owner` + `repo`, optional `host` and status `prefix`). */
+declare const gitlabConfigSchema: z.ZodObject<{
+  owner: z.ZodString;
+  repo: z.ZodString;
+  host: z.ZodOptional<z.ZodString>;
+  prefix: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+//#endregion
+export { gitlabConfigSchema };
+//# sourceMappingURL=gitlab-config.d.mts.map

package/dist/gitlab-config.mjs

@@ -0,0 +1,17 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { statusPrefixSchema } from "./prefix.mjs";
+import { z } from "zod";
+//#region src/gitlab-config.ts
+/** Validation schema for a GitLab channel config (`owner` + `repo`, optional `host` and status `prefix`). */
+const gitlabConfigSchema = z.object({
+	owner: z.string().min(1),
+	repo: z.string().min(1),
+	host: z.string().url().optional(),
+	prefix: statusPrefixSchema.optional()
+});
+//#endregion
+export { gitlabConfigSchema };
+
+//# sourceMappingURL=gitlab-config.mjs.map

package/dist/gitlab-config.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitlab-config.mjs","names":[],"sources":["../src/gitlab-config.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { statusPrefixSchema } from \"./prefix.ts\";\n\n/** Validation schema for a GitLab channel config (`owner` + `repo`, optional `host` and status `prefix`). */\nexport const gitlabConfigSchema = z.object({\n  owner: z.string().min(1),\n  repo: z.string().min(1),\n  // oxlint-disable-next-line typescript/no-deprecated -- z.string().url() kept for zod v3 API compat\n  host: z.string().url().optional(),\n  prefix: statusPrefixSchema.optional(),\n});\n"],"mappings":";;;;;;;AAIA,MAAa,qBAAqB,EAAE,OAAO;CACzC,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;CACvB,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;CAEtB,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS;CAChC,QAAQ,mBAAmB,SAAS;AACtC,CAAC"}

package/dist/gitlab-mapper.mjs

@@ -0,0 +1,19 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+//#region src/gitlab-mapper.ts
+/** GitLab's pipeline statuses; a cancelled build is GitLab's own `canceled`. */
+const STATES = {
+	pending: "pending",
+	success: "success",
+	failure: "failed",
+	cancelled: "canceled"
+};
+/** Map a StoryShelf build state to a GitLab pipeline status; an unknown state is `failed`. */
+function mapState(state) {
+	return STATES[state] ?? "failed";
+}
+//#endregion
+export { mapState };
+
+//# sourceMappingURL=gitlab-mapper.mjs.map

package/dist/gitlab-mapper.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitlab-mapper.mjs","names":[],"sources":["../src/gitlab-mapper.ts"],"sourcesContent":["import type { NotifierState } from \"@storyshelf/core/adapter/notifier\";\n\n/** GitLab's pipeline statuses; a cancelled build is GitLab's own `canceled`. */\nconst STATES: Record<NotifierState, \"pending\" | \"success\" | \"failed\" | \"canceled\"> = {\n  pending: \"pending\",\n  success: \"success\",\n  failure: \"failed\",\n  cancelled: \"canceled\",\n};\n\n/** Map a StoryShelf build state to a GitLab pipeline status; an unknown state is `failed`. */\nexport function mapState(state: NotifierState): \"pending\" | \"success\" | \"failed\" | \"canceled\" {\n  return STATES[state] ?? \"failed\";\n}\n"],"mappings":";;;;;AAGA,MAAM,SAA+E;CACnF,SAAS;CACT,SAAS;CACT,SAAS;CACT,WAAW;AACb;;AAGA,SAAgB,SAAS,OAAqE;CAC5F,OAAO,OAAO,UAAU;AAC1B"}

package/dist/gitlab-pr.mjs

@@ -0,0 +1,19 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { apiBase, gitlabHeaders, projectId } from "./gitlab-api.mjs";
+import { httpJson } from "@storyshelf/core/utils";
+//#region src/gitlab-pr.ts
+/** Find the merge request IID associated with a commit SHA, if any. */
+async function findMrIid(opts) {
+	try {
+		const url = `${apiBase(opts.host)}/api/v4/projects/${projectId(opts.owner, opts.repo)}/repository/commits/${encodeURIComponent(opts.sha)}/merge_requests`;
+		return (await httpJson(url, { headers: gitlabHeaders(opts.token) }))[0]?.iid;
+	} catch {
+		return;
+	}
+}
+//#endregion
+export { findMrIid };
+
+//# sourceMappingURL=gitlab-pr.mjs.map

package/dist/gitlab-pr.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitlab-pr.mjs","names":[],"sources":["../src/gitlab-pr.ts"],"sourcesContent":["import { httpJson } from \"@storyshelf/core/utils\";\nimport { apiBase, gitlabHeaders, projectId } from \"./gitlab-api.ts\";\n\ninterface CommitMergeRequest {\n  iid: number;\n}\n\n/** Find the merge request IID associated with a commit SHA, if any. */\nexport async function findMrIid(opts: {\n  host?: string;\n  owner: string;\n  repo: string;\n  token: string;\n  sha: string;\n}): Promise<number | undefined> {\n  try {\n    const base = apiBase(opts.host);\n    const pid = projectId(opts.owner, opts.repo);\n    const url = `${base}/api/v4/projects/${pid}/repository/commits/${encodeURIComponent(opts.sha)}/merge_requests`;\n    const data = await httpJson<CommitMergeRequest[]>(url, {\n      headers: gitlabHeaders(opts.token),\n    });\n    return data[0]?.iid;\n  } catch {\n    return undefined;\n  }\n}\n"],"mappings":";;;;;;;AAQA,eAAsB,UAAU,MAMA;CAC9B,IAAI;EAGF,MAAM,MAAM,GAFC,QAAQ,KAAK,IAER,EAAE,mBADR,UAAU,KAAK,OAAO,KAAK,IACE,EAAE,sBAAsB,mBAAmB,KAAK,GAAG,EAAE;EAI9F,QAAO,MAHY,SAA+B,KAAK,EACrD,SAAS,cAAc,KAAK,KAAK,EACnC,CAAC,EAAA,CACW,EAAE,EAAE;CAClB,QAAQ;EACN;CACF;AACF"}

package/dist/gitlab-status.mjs

@@ -0,0 +1,47 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { apiBase, gitlabHeaders, projectId } from "./gitlab-api.mjs";
+import { mapState } from "./gitlab-mapper.mjs";
+import { httpJson } from "@storyshelf/core/utils";
+//#region src/gitlab-status.ts
+/**
+* Post a commit status to GitLab under the full `context` name the caller chose
+* (`<prefix>/testing`); the provider adds no prefix of its own. Posting the same
+* `(sha, name)` again replaces the state, so it is idempotent and latest wins.
+*/
+async function postCommitStatus(project, input) {
+	const base = apiBase(project.host);
+	const pid = projectId(project.owner, project.repo);
+	const state = mapState(input.state);
+	project.logger?.debug({
+		context: input.context,
+		sha: input.sha,
+		state
+	}, "posting commit status");
+	try {
+		await httpJson(`${base}/api/v4/projects/${pid}/statuses/${encodeURIComponent(input.sha)}`, {
+			method: "POST",
+			headers: gitlabHeaders(project.token),
+			json: {
+				state,
+				...input.url === void 0 ? {} : { target_url: input.url },
+				description: input.description,
+				name: input.context,
+				context: input.context
+			},
+			logger: project.logger
+		});
+	} catch (error) {
+		project.logger?.error({
+			err: error,
+			context: input.context,
+			sha: input.sha
+		}, "failed to post commit status");
+		throw error;
+	}
+}
+//#endregion
+export { postCommitStatus };
+
+//# sourceMappingURL=gitlab-status.mjs.map

package/dist/gitlab-status.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitlab-status.mjs","names":[],"sources":["../src/gitlab-status.ts"],"sourcesContent":["import type { NotifierState } from \"@storyshelf/core/adapter/notifier\";\nimport type { Logger } from \"@storyshelf/core/logger\";\nimport { httpJson } from \"@storyshelf/core/utils\";\nimport { apiBase, gitlabHeaders, projectId } from \"./gitlab-api.ts\";\nimport { mapState } from \"./gitlab-mapper.ts\";\n\n/** Coordinates and credential of one GitLab project. */\nexport interface GitLabProject {\n  token: string;\n  owner: string;\n  repo: string;\n  /** GitLab host URL; `https://gitlab.com` when undefined. */\n  host: string | undefined;\n  logger?: Logger | undefined;\n}\n\n/**\n * Post a commit status to GitLab under the full `context` name the caller chose\n * (`<prefix>/testing`); the provider adds no prefix of its own. Posting the same\n * `(sha, name)` again replaces the state, so it is idempotent and latest wins.\n */\nexport async function postCommitStatus(\n  project: GitLabProject,\n  input: {\n    sha: string;\n    context: string;\n    state: NotifierState;\n    description: string;\n    /** Absent while no public origin is known. */\n    url?: string | undefined;\n  },\n): Promise<void> {\n  const base = apiBase(project.host);\n  const pid = projectId(project.owner, project.repo);\n  const state = mapState(input.state);\n  project.logger?.debug({ context: input.context, sha: input.sha, state }, \"posting commit status\");\n  try {\n    await httpJson(`${base}/api/v4/projects/${pid}/statuses/${encodeURIComponent(input.sha)}`, {\n      method: \"POST\",\n      headers: gitlabHeaders(project.token),\n      json: {\n        state,\n        ...(input.url === undefined ? {} : { target_url: input.url }),\n        description: input.description,\n        name: input.context,\n        context: input.context,\n      },\n      logger: project.logger,\n    });\n  } catch (error) {\n    project.logger?.error(\n      { err: error, context: input.context, sha: input.sha },\n      \"failed to post commit status\",\n    );\n    throw error;\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAqBA,eAAsB,iBACpB,SACA,OAQe;CACf,MAAM,OAAO,QAAQ,QAAQ,IAAI;CACjC,MAAM,MAAM,UAAU,QAAQ,OAAO,QAAQ,IAAI;CACjD,MAAM,QAAQ,SAAS,MAAM,KAAK;CAClC,QAAQ,QAAQ,MAAM;EAAE,SAAS,MAAM;EAAS,KAAK,MAAM;EAAK;CAAM,GAAG,uBAAuB;CAChG,IAAI;EACF,MAAM,SAAS,GAAG,KAAK,mBAAmB,IAAI,YAAY,mBAAmB,MAAM,GAAG,KAAK;GACzF,QAAQ;GACR,SAAS,cAAc,QAAQ,KAAK;GACpC,MAAM;IACJ;IACA,GAAI,MAAM,QAAQ,KAAA,IAAY,CAAC,IAAI,EAAE,YAAY,MAAM,IAAI;IAC3D,aAAa,MAAM;IACnB,MAAM,MAAM;IACZ,SAAS,MAAM;GACjB;GACA,QAAQ,QAAQ;EAClB,CAAC;CACH,SAAS,OAAO;EACd,QAAQ,QAAQ,MACd;GAAE,KAAK;GAAO,SAAS,MAAM;GAAS,KAAK,MAAM;EAAI,GACrD,8BACF;EACA,MAAM;CACR;AACF"}

package/dist/gitlab.d.mts

@@ -0,0 +1,9 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { StateNotifierProvider } from "@storyshelf/core/adapter/notifier";
+//#region src/gitlab.d.ts
+/** GitLab commit status and merge-request note provider (`state` delivery). */
+declare const gitLabNotifier: StateNotifierProvider;
+//#endregion
+export { gitLabNotifier };
+//# sourceMappingURL=gitlab.d.mts.map

package/dist/gitlab.mjs

@@ -0,0 +1,50 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { createStateAdapter, requireToken } from "./state-adapter.mjs";
+import { packageVersion } from "./version.mjs";
+import { upsertMrNote } from "./gitlab-comment.mjs";
+import { gitlabConfigSchema } from "./gitlab-config.mjs";
+import { postCommitStatus } from "./gitlab-status.mjs";
+//#region src/gitlab.ts
+/** GitLab commit status and merge-request note provider (`state` delivery). */
+const gitLabNotifier = {
+	metadata: getMetadata(),
+	create(opts) {
+		const cfg = gitlabConfigSchema.parse(opts.config);
+		const logger = opts.logger?.child({ component: "notify-git-gitlab" });
+		const project = {
+			token: requireToken(opts.secret, "GitLab"),
+			owner: cfg.owner,
+			repo: cfg.repo,
+			host: cfg.host,
+			logger
+		};
+		return createStateAdapter(getMetadata(), {
+			status: async (input) => {
+				await postCommitStatus(project, input);
+			},
+			comment: async (input) => await upsertMrNote(project, {
+				...input,
+				logger
+			})
+		}, logger);
+	}
+};
+/** Describe the GitLab provider (name, version, config schema). */
+function getMetadata() {
+	return {
+		name: "GitLab",
+		version: packageVersion(),
+		description: "Commit statuses and merge-request notes via the GitLab API",
+		kind: "gitlab",
+		category: "notifier",
+		delivery: "state",
+		logo: "gitlab",
+		schema: gitlabConfigSchema
+	};
+}
+//#endregion
+export { getMetadata, gitLabNotifier };
+
+//# sourceMappingURL=gitlab.mjs.map

package/dist/gitlab.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitlab.mjs","names":[],"sources":["../src/gitlab.ts"],"sourcesContent":["import type { StateNotifierProvider } from \"@storyshelf/core/adapter/notifier\";\nimport type { Logger } from \"@storyshelf/core/logger\";\nimport { upsertMrNote } from \"./gitlab-comment.ts\";\nimport { gitlabConfigSchema } from \"./gitlab-config.ts\";\nimport { postCommitStatus, type GitLabProject } from \"./gitlab-status.ts\";\nimport { createStateAdapter, requireToken } from \"./state-adapter.ts\";\nimport { packageVersion } from \"./version.ts\";\n\n/** GitLab commit status and merge-request note provider (`state` delivery). */\nexport const gitLabNotifier: StateNotifierProvider = {\n  metadata: getMetadata(),\n  create(opts: { config: unknown; secret?: string; logger?: Logger }) {\n    const cfg = gitlabConfigSchema.parse(opts.config);\n    const logger = opts.logger?.child({ component: \"notify-git-gitlab\" });\n    const project: GitLabProject = {\n      token: requireToken(opts.secret, \"GitLab\"),\n      owner: cfg.owner,\n      repo: cfg.repo,\n      host: cfg.host,\n      logger,\n    };\n    return createStateAdapter(\n      getMetadata(),\n      {\n        status: async (input) => {\n          await postCommitStatus(project, input);\n        },\n        comment: async (input) => await upsertMrNote(project, { ...input, logger }),\n      },\n      logger,\n    );\n  },\n};\n\n/** Describe the GitLab provider (name, version, config schema). */\nexport function getMetadata(): StateNotifierProvider[\"metadata\"] {\n  return {\n    name: \"GitLab\",\n    version: packageVersion(),\n    description: \"Commit statuses and merge-request notes via the GitLab API\",\n    kind: \"gitlab\",\n    category: \"notifier\",\n    delivery: \"state\",\n    logo: \"gitlab\",\n    schema: gitlabConfigSchema,\n  };\n}\n"],"mappings":";;;;;;;;;;AASA,MAAa,iBAAwC;CACnD,UAAU,YAAY;CACtB,OAAO,MAA6D;EAClE,MAAM,MAAM,mBAAmB,MAAM,KAAK,MAAM;EAChD,MAAM,SAAS,KAAK,QAAQ,MAAM,EAAE,WAAW,oBAAoB,CAAC;EACpE,MAAM,UAAyB;GAC7B,OAAO,aAAa,KAAK,QAAQ,QAAQ;GACzC,OAAO,IAAI;GACX,MAAM,IAAI;GACV,MAAM,IAAI;GACV;EACF;EACA,OAAO,mBACL,YAAY,GACZ;GACE,QAAQ,OAAO,UAAU;IACvB,MAAM,iBAAiB,SAAS,KAAK;GACvC;GACA,SAAS,OAAO,UAAU,MAAM,aAAa,SAAS;IAAE,GAAG;IAAO;GAAO,CAAC;EAC5E,GACA,MACF;CACF;AACF;;AAGA,SAAgB,cAAiD;CAC/D,OAAO;EACL,MAAM;EACN,SAAS,eAAe;EACxB,aAAa;EACb,MAAM;EACN,UAAU;EACV,UAAU;EACV,MAAM;EACN,QAAQ;CACV;AACF"}

package/dist/index.d.mts

@@ -0,0 +1,13 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { gitHubNotifier } from "./github.mjs";
+import { gitLabNotifier } from "./gitlab.mjs";
+import { gitLogNotifier, logConfigSchema } from "./log.mjs";
+import { githubConfigSchema } from "./github-config.mjs";
+import { gitlabConfigSchema } from "./gitlab-config.mjs";
+//#region src/index.d.ts
+/** All git providers in one list for `ShelfOptions.notifications.notifiers`. */
+declare const gitNotifiers: import("@storyshelf/core/adapter/notifier").StateNotifierProvider[];
+//#endregion
+export { gitHubNotifier, gitLabNotifier, gitLogNotifier, gitNotifiers, githubConfigSchema, gitlabConfigSchema, logConfigSchema };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -0,0 +1,23 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { githubConfigSchema } from "./github-config.mjs";
+import { gitHubNotifier } from "./github.mjs";
+import { gitlabConfigSchema } from "./gitlab-config.mjs";
+import { gitLabNotifier } from "./gitlab.mjs";
+import { gitLogNotifier, logConfigSchema } from "./log.mjs";
+//#region src/index.ts
+/**
+* Git notification providers: `state` channels that make GitHub or GitLab show a build's
+* current commit status and pull-request comment (plus a log provider for tests/dev).
+*/
+/** All git providers in one list for `ShelfOptions.notifications.notifiers`. */
+const gitNotifiers = [
+	gitHubNotifier,
+	gitLabNotifier,
+	gitLogNotifier
+];
+//#endregion
+export { gitHubNotifier, gitLabNotifier, gitLogNotifier, gitNotifiers, githubConfigSchema, gitlabConfigSchema, logConfigSchema };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * Git notification providers: `state` channels that make GitHub or GitLab show a build's\n * current commit status and pull-request comment (plus a log provider for tests/dev).\n */\nimport { gitHubNotifier } from \"./github.ts\";\nimport { gitLabNotifier } from \"./gitlab.ts\";\nimport { gitLogNotifier } from \"./log.ts\";\n\n/** GitHub commit status + pull-request comment provider (`github`). */\nexport { gitHubNotifier };\n/** GitLab commit status + merge-request note provider (`gitlab`). */\nexport { gitLabNotifier };\n/** Log-only provider for tests, dev, and unconfigured servers (`git-log`). */\nexport { gitLogNotifier };\n\n/** All git providers in one list for `ShelfOptions.notifications.notifiers`. */\nexport const gitNotifiers = [gitHubNotifier, gitLabNotifier, gitLogNotifier];\n\nexport { githubConfigSchema } from \"./github-config.ts\";\nexport { gitlabConfigSchema } from \"./gitlab-config.ts\";\nexport { logConfigSchema } from \"./log.ts\";\n"],"mappings":";;;;;;;;;;;;;;AAgBA,MAAa,eAAe;CAAC;CAAgB;CAAgB;AAAc"}

package/dist/log.d.mts

@@ -0,0 +1,12 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { z } from "zod";
+import { StateNotifierProvider } from "@storyshelf/core/adapter/notifier";
+//#region src/log.d.ts
+/** Validation schema for the log provider config (accepts anything). */
+declare const logConfigSchema: z.ZodObject<{}, z.core.$loose>;
+/** Log-only git provider for tests, dev, and unconfigured servers (`git-log`). */
+declare const gitLogNotifier: StateNotifierProvider;
+//#endregion
+export { gitLogNotifier, logConfigSchema };
+//# sourceMappingURL=log.d.mts.map

package/dist/log.mjs

@@ -0,0 +1,42 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { packageVersion } from "./version.mjs";
+import { z } from "zod";
+//#region src/log.ts
+/** Validation schema for the log provider config (accepts anything). */
+const logConfigSchema = z.object({}).loose();
+/** Log-only git provider for tests, dev, and unconfigured servers (`git-log`). */
+const gitLogNotifier = {
+	metadata: getMetadata(),
+	create(opts) {
+		logConfigSchema.parse(opts.config);
+		const logger = opts.logger?.child({ component: "notify-git-log" }) ?? opts.logger;
+		return {
+			metadata: getMetadata(),
+			async setState(input) {
+				logger?.info({
+					channelId: input.channel.id,
+					target: input.target,
+					state: input.state
+				}, "git state (log)");
+			}
+		};
+	}
+};
+/** Describe the log provider (name, version, config schema). */
+function getMetadata() {
+	return {
+		name: "Git log",
+		version: packageVersion(),
+		description: "Git statuses and comments to the server log (tests and dev)",
+		kind: "git-log",
+		category: "notifier",
+		delivery: "state",
+		schema: logConfigSchema
+	};
+}
+//#endregion
+export { getMetadata, gitLogNotifier, logConfigSchema };
+
+//# sourceMappingURL=log.mjs.map

package/dist/log.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.mjs","names":[],"sources":["../src/log.ts"],"sourcesContent":["import type { StateNotifierProvider } from \"@storyshelf/core/adapter/notifier\";\nimport type { Logger } from \"@storyshelf/core/logger\";\nimport { z } from \"zod\";\nimport { packageVersion } from \"./version.ts\";\n\n/** Validation schema for the log provider config (accepts anything). */\nexport const logConfigSchema = z.object({}).loose();\n\n/** Log-only git provider for tests, dev, and unconfigured servers (`git-log`). */\nexport const gitLogNotifier: StateNotifierProvider = {\n  metadata: getMetadata(),\n  create(opts: { config: unknown; secret?: string; logger?: Logger }) {\n    logConfigSchema.parse(opts.config);\n    const logger = opts.logger?.child({ component: \"notify-git-log\" }) ?? opts.logger;\n    return {\n      metadata: getMetadata(),\n      // oxlint-disable-next-line eslint/require-await -- setState is async by contract\n      async setState(input): Promise<void> {\n        logger?.info(\n          { channelId: input.channel.id, target: input.target, state: input.state },\n          \"git state (log)\",\n        );\n      },\n    };\n  },\n};\n\n/** Describe the log provider (name, version, config schema). */\nexport function getMetadata(): StateNotifierProvider[\"metadata\"] {\n  return {\n    name: \"Git log\",\n    version: packageVersion(),\n    description: \"Git statuses and comments to the server log (tests and dev)\",\n    kind: \"git-log\",\n    category: \"notifier\",\n    delivery: \"state\",\n    schema: logConfigSchema,\n  };\n}\n"],"mappings":";;;;;;;AAMA,MAAa,kBAAkB,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM;;AAGlD,MAAa,iBAAwC;CACnD,UAAU,YAAY;CACtB,OAAO,MAA6D;EAClE,gBAAgB,MAAM,KAAK,MAAM;EACjC,MAAM,SAAS,KAAK,QAAQ,MAAM,EAAE,WAAW,iBAAiB,CAAC,KAAK,KAAK;EAC3E,OAAO;GACL,UAAU,YAAY;GAEtB,MAAM,SAAS,OAAsB;IACnC,QAAQ,KACN;KAAE,WAAW,MAAM,QAAQ;KAAI,QAAQ,MAAM;KAAQ,OAAO,MAAM;IAAM,GACxE,iBACF;GACF;EACF;CACF;AACF;;AAGA,SAAgB,cAAiD;CAC/D,OAAO;EACL,MAAM;EACN,SAAS,eAAe;EACxB,aAAa;EACb,MAAM;EACN,UAAU;EACV,UAAU;EACV,QAAQ;CACV;AACF"}

package/dist/prefix.mjs

@@ -0,0 +1,14 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { z } from "zod";
+//#region src/prefix.ts
+/**
+* Status-name prefix of a git channel (`<prefix>/testing`). It forms part of the status
+* context on the host, so it is limited to characters both hosts accept in a name.
+*/
+const statusPrefixSchema = z.string().min(1).max(64).regex(/^[\w.-]+$/u, "Use letters, digits, dots, dashes and underscores");
+//#endregion
+export { statusPrefixSchema };
+
+//# sourceMappingURL=prefix.mjs.map

package/dist/prefix.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefix.mjs","names":[],"sources":["../src/prefix.ts"],"sourcesContent":["import { z } from \"zod\";\n\n/**\n * Status-name prefix of a git channel (`<prefix>/testing`). It forms part of the status\n * context on the host, so it is limited to characters both hosts accept in a name.\n */\nexport const statusPrefixSchema = z\n  .string()\n  .min(1)\n  .max(64)\n  .regex(/^[\\w.-]+$/u, \"Use letters, digits, dots, dashes and underscores\");\n"],"mappings":";;;;;;;;;AAMA,MAAa,qBAAqB,EAC/B,OAAO,CAAC,CACR,IAAI,CAAC,CAAC,CACN,IAAI,EAAE,CAAC,CACP,MAAM,cAAc,mDAAmD"}

package/dist/review-comment.mjs

@@ -0,0 +1,54 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { commentMarker } from "./describe.mjs";
+//#region src/review-comment.ts
+/** Resolve the thread number, preferring the explicit value. */
+async function resolveThreadNumber(opts) {
+	return opts.prNumber ?? await opts.resolveNumber();
+}
+/** Update the marked comment if present, else create it. */
+async function findOrCreateComment(thread, marker, body, prNumber, logger) {
+	const existing = (await thread.list()).find((comment) => comment.body.includes(marker));
+	if (existing) {
+		const id = await thread.update(existing.id, body);
+		logger?.info({
+			prNumber,
+			commentId: id
+		}, "review comment updated");
+		return id;
+	}
+	const id = await thread.create(body);
+	logger?.info({
+		prNumber,
+		commentId: id
+	}, "review comment created");
+	return id;
+}
+/**
+* Create or update the single StoryShelf review comment for a build,
+* idempotent via the url marker. Returns the comment id, or `""` when no
+* review thread exists for the commit.
+*/
+async function upsertReviewComment(opts) {
+	const marker = commentMarker(opts.url);
+	const body = `${marker}\n${opts.markdown}`;
+	const number = await resolveThreadNumber(opts);
+	if (number === void 0) {
+		opts.logger?.debug({ sha: opts.sha }, "no review thread found for comment, skipping");
+		return "";
+	}
+	try {
+		return await findOrCreateComment(opts.thread(number), marker, body, number, opts.logger);
+	} catch (error) {
+		opts.logger?.error({
+			err: error,
+			prNumber: number
+		}, "failed to upsert review comment");
+		throw error;
+	}
+}
+//#endregion
+export { upsertReviewComment };
+
+//# sourceMappingURL=review-comment.mjs.map