@kud/gh-webhook-replay 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Erwann Mest
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,29 @@
+# @kud/gh-webhook-replay
+
+Replay the latest `pull_request` webhook delivery on a GitHub repo hook — a thin
+CLI over [`@kud/gh`](../gh). Useful for re-firing a Jenkins PR-builder that missed
+an event.
+
+## Install
+
+```sh
+npm install -g @kud/gh-webhook-replay
+```
+
+Requires the [`gh`](https://cli.github.com) CLI, authenticated.
+
+## Usage
+
+```sh
+gh-webhook-replay                        # pick a hook interactively (current repo)
+gh-webhook-replay owner/repo             # …for a specific repo
+gh-webhook-replay --hook ghprbhook       # headless: replay on the matched hook
+gh-webhook-replay owner/repo --hook 42   # match by url substring or hook id
+```
+
+Interactive: `↑↓` move · `↵` replay the selected hook's latest `pull_request`
+delivery · `q` quit.
+
+## Licence
+
+MIT © Erwann Mest

package/dist/index.js

@@ -0,0 +1,143 @@
+#!/usr/bin/env node
+
+// src/index.tsx
+import { useEffect, useState } from "react";
+import { render, Box, Text, useApp, useInput } from "ink";
+import { colors } from "@kud/ink-ui";
+import {
+  fetchHookContexts,
+  fetchHooks,
+  fetchLatestPrDeliveryId,
+  replayDelivery,
+  replayLatestPrDelivery,
+  resolveCurrentRepo
+} from "@kud/gh";
+import { jsx, jsxs } from "react/jsx-runtime";
+var hookLabel = (hook) => {
+  if (hook.contexts.length > 0) return hook.contexts.join(", ");
+  try {
+    return new URL(hook.config.url).pathname.replace(/^\/|\/$/g, "") || hook.name;
+  } catch {
+    return hook.name;
+  }
+};
+var hookHost = (hook) => {
+  try {
+    return new URL(hook.config.url).hostname;
+  } catch {
+    return hook.config.url;
+  }
+};
+var App = ({ repo }) => {
+  const { exit } = useApp();
+  const [phase, setPhase] = useState("loading");
+  const [hooks, setHooks] = useState([]);
+  const [cursor, setCursor] = useState(0);
+  const [msg, setMsg] = useState("");
+  useEffect(() => {
+    fetchHooks(repo).then(async (hs) => {
+      const withContexts = await Promise.all(
+        hs.map(async (h) => ({
+          ...h,
+          contexts: await fetchHookContexts(repo, h.id)
+        }))
+      );
+      setHooks(withContexts);
+      setPhase("pick");
+    }).catch((e) => {
+      setMsg(e.message);
+      setPhase("error");
+    });
+  }, []);
+  useEffect(() => {
+    if (phase !== "done" && phase !== "error") return;
+    const t = setTimeout(exit, 1800);
+    return () => clearTimeout(t);
+  }, [phase]);
+  useInput((input, key) => {
+    if (input === "q") return exit();
+    if (phase !== "pick") return;
+    if (key.upArrow || input === "k") setCursor((c) => Math.max(0, c - 1));
+    if (key.downArrow || input === "j")
+      setCursor((c) => Math.min(hooks.length - 1, c + 1));
+    if (key.return) {
+      const hook = hooks[cursor];
+      setPhase("replaying");
+      fetchLatestPrDeliveryId(repo, hook.id).then(
+        (id) => replayDelivery(repo, hook.id, id).then(() => {
+          setMsg(`delivery ${id}`);
+          setPhase("done");
+        })
+      ).catch((e) => {
+        setMsg(e.message);
+        setPhase("error");
+      });
+    }
+  });
+  if (phase === "loading")
+    return /* @__PURE__ */ jsx(Text, { color: colors.info, children: "Fetching webhooks\u2026" });
+  if (phase === "replaying")
+    return /* @__PURE__ */ jsx(Text, { color: colors.info, children: "Replaying latest pull_request\u2026" });
+  if (phase === "done")
+    return /* @__PURE__ */ jsxs(Text, { color: colors.success, children: [
+      "\u2713 Webhook replayed on ",
+      repo,
+      " \xB7 ",
+      msg
+    ] });
+  if (phase === "error") return /* @__PURE__ */ jsxs(Text, { color: colors.error, children: [
+    "\u2717 ",
+    msg
+  ] });
+  return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsxs(Text, { bold: true, color: colors.accent, children: [
+      repo,
+      " ",
+      /* @__PURE__ */ jsx(Text, { dimColor: true, children: "\xB7 pick a webhook to replay" })
+    ] }),
+    /* @__PURE__ */ jsx(Box, { flexDirection: "column", marginTop: 1, children: hooks.map((hook, i) => {
+      const active = i === cursor;
+      return /* @__PURE__ */ jsxs(Box, { children: [
+        /* @__PURE__ */ jsx(Text, { color: colors.info, children: active ? "\u276F " : "  " }),
+        /* @__PURE__ */ jsxs(Box, { flexDirection: "column", children: [
+          /* @__PURE__ */ jsx(Text, { bold: active, color: active ? colors.accent : void 0, children: hookLabel(hook) }),
+          /* @__PURE__ */ jsxs(Text, { dimColor: true, children: [
+            hookHost(hook),
+            " \xB7 ",
+            hook.events.join(", ")
+          ] })
+        ] })
+      ] }, hook.id);
+    }) }),
+    /* @__PURE__ */ jsx(Box, { marginTop: 1, children: /* @__PURE__ */ jsx(Text, { dimColor: true, children: "\u2191\u2193 move \xB7 \u21B5 replay \xB7 q quit" }) })
+  ] });
+};
+var main = async () => {
+  const args = process.argv.slice(2);
+  const hookIdx = args.indexOf("--hook");
+  const hookPattern = hookIdx >= 0 ? args[hookIdx + 1] : void 0;
+  const positional = args.find(
+    (a, i) => !a.startsWith("-") && i !== hookIdx + 1
+  );
+  const repo = positional ?? await resolveCurrentRepo().catch(() => null);
+  if (!repo) {
+    console.error("\u2717 No repo \u2014 run inside a git repo, or pass owner/repo");
+    process.exit(1);
+  }
+  if (hookPattern) {
+    try {
+      const { hook, deliveryId } = await replayLatestPrDelivery(
+        repo,
+        hookPattern
+      );
+      console.log(`\u2713 Webhook replayed on ${repo}`);
+      console.log(`  ${hook.config.url} \xB7 delivery ${deliveryId}`);
+    } catch (e) {
+      console.error(`\u2717 ${e.message}`);
+      process.exit(1);
+    }
+    return;
+  }
+  render(/* @__PURE__ */ jsx(App, { repo }), { alternateScreen: true });
+};
+void main();

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@kud/gh-webhook-replay",
+  "version": "0.1.0",
+  "description": "Replay the latest pull_request webhook delivery on a GitHub repo hook.",
+  "type": "module",
+  "bin": {
+    "gh-webhook-replay": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "github",
+    "webhook",
+    "ci",
+    "cli",
+    "ink"
+  ],
+  "author": "Erwann Mest <m@kud.io>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kud/gh",
+    "directory": "packages/gh-webhook-replay"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@kud/gh": "0.1.0",
+    "@kud/ink-ui": "0.8.0",
+    "ink": "7.1.0",
+    "react": "19.2.7"
+  },
+  "devDependencies": {
+    "@types/node": "22.20.1",
+    "@types/react": "19.2.17",
+    "tsup": "8.5.1",
+    "typescript": "5.9.3"
+  }
+}