@buildinternet/uploads 0.16.1 → 0.17.0

package/dist/client.d.ts

@@ -236,6 +236,13 @@ export interface GithubHealthResult {
     events: string[] | null;
     missingEvents: string[];
     requiredEvents: string[];
+    /**
+     * Recommended-but-non-gating events, e.g. `issue_comment` (issue #333).
+     * Optional: older servers' health payload predates this field — treat a
+     * missing field as "no recommendations", not an error.
+     */
+    recommendedEvents?: string[];
+    missingRecommendedEvents?: string[];
     hint?: string;
 }
 export interface UsageResult {

package/dist/commands.js

@@ -1755,6 +1755,16 @@ Examples:
   uploads github unlink --repo buildinternet/uploads
   uploads github doctor
 `;
+/** Older servers' health payload predates recommendedEvents/missingRecommendedEvents — treat as no recommendations rather than crashing. */
+function missingRecommendedEventsOf(result) {
+    return Array.isArray(result.missingRecommendedEvents) ? result.missingRecommendedEvents : [];
+}
+function recommendedNoteLine(result) {
+    const missing = missingRecommendedEventsOf(result);
+    if (missing.length === 0)
+        return "";
+    return `note: not subscribed to ${missing.join(", ")} (recommended) — enables bot-comment self-healing; subscribe under the App's Permissions & events\n`;
+}
 function formatGithubDoctor(result) {
     if (!result.configured) {
         return `github app: not configured on this server${result.hint ? ` — ${result.hint}` : ""}\n`;
@@ -1763,10 +1773,12 @@ function formatGithubDoctor(result) {
         return `github app: configured, but health check failed${result.hint ? ` — ${result.hint}` : ""}\n`;
     }
     if (result.ok) {
-        return `github app: ok — subscribed to ${result.requiredEvents.join(", ")}\n`;
+        return (`github app: ok — subscribed to ${result.requiredEvents.join(", ")}\n` +
+            recommendedNoteLine(result));
     }
     return (`github app: missing webhook event subscription(s): ${result.missingEvents.join(", ")}\n` +
-        (result.hint ? `  ${result.hint}\n` : ""));
+        (result.hint ? `  ${result.hint}\n` : "") +
+        recommendedNoteLine(result));
 }
 function formatGithubLink(repo, result) {
     return result.workspace

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buildinternet/uploads",
-  "version": "0.16.1",
+  "version": "0.17.0",
   "description": "CLI and client for uploads.sh — workspace-scoped image hosting for GitHub embeds",
   "type": "module",
   "sideEffects": false,