@h-rig/notifications-plugin 0.0.6-alpha.156

package/README.md

@@ -0,0 +1 @@
+# @h-rig/notifications-plugin

package/dist/src/index.d.ts

@@ -0,0 +1,2 @@
+export type { RigEvent, NotificationTarget, NotificationConfig, } from "./notifications";
+export { loadNotificationConfig, dispatchEventToTargets, buildTargetPayload, resolveNotifyTimeoutMs, } from "./notifications";

package/dist/src/index.js

@@ -0,0 +1,74 @@
+// @bun
+// packages/notifications-plugin/src/notifications.ts
+async function loadNotificationConfig(path) {
+  try {
+    const parsed = await Bun.file(path).json();
+    return {
+      targets: (parsed.targets || []).filter((target) => !!target && !!target.id && !!target.url)
+    };
+  } catch {
+    return { targets: [] };
+  }
+}
+async function dispatchEventToTargets(event, targets, deps = {}) {
+  const fetchFn = deps.fetch ?? globalThis.fetch;
+  const timeoutMs = resolveNotifyTimeoutMs();
+  let sent = 0;
+  for (const target of targets) {
+    if (target.enabled === false) {
+      continue;
+    }
+    if (target.events && target.events.length > 0 && !target.events.includes(event.type)) {
+      continue;
+    }
+    const payload = buildTargetPayload(target, event);
+    const controller = new AbortController;
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+      const response = await fetchFn(target.url, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          ...target.headers || {}
+        },
+        body: JSON.stringify(payload),
+        signal: controller.signal
+      });
+      if (response.ok) {
+        sent += 1;
+      } else {
+        console.error(`[runtime] failed to dispatch event ${event.type} to ${target.id}: ${response.status} ${response.statusText}`);
+      }
+    } catch (error) {
+      console.error(`[runtime] failed to dispatch event ${event.type} to ${target.id}`, error);
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+  return sent;
+}
+function buildTargetPayload(target, event) {
+  if (target.type === "slack-webhook") {
+    return {
+      text: `[Rig] ${event.type} ${event.runId ? `(run ${event.runId})` : ""}`.trim(),
+      event
+    };
+  }
+  return {
+    source: "project-rig",
+    target: target.id,
+    summary: `${event.type}${event.runId ? `:${event.runId}` : ""}`,
+    event
+  };
+}
+function resolveNotifyTimeoutMs() {
+  const raw = process.env.RIG_NOTIFY_TIMEOUT_MS;
+  const parsed = raw ? Number.parseInt(raw, 10) : NaN;
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : 1e4;
+}
+export {
+  resolveNotifyTimeoutMs,
+  loadNotificationConfig,
+  dispatchEventToTargets,
+  buildTargetPayload
+};

package/dist/src/notifications.d.ts

@@ -0,0 +1,31 @@
+export type RigEvent = {
+    id?: string;
+    runId?: string;
+    timestamp?: string;
+    type: string;
+    payload?: Record<string, unknown>;
+};
+export type NotificationTarget = {
+    id: string;
+    type: "slack-webhook" | "linear-webhook" | "notion-webhook" | "generic-webhook";
+    url: string;
+    enabled?: boolean;
+    events?: string[];
+    headers?: Record<string, string>;
+};
+export type NotificationConfig = {
+    targets: NotificationTarget[];
+};
+type NotificationFetchResponse = {
+    ok: boolean;
+    status?: number;
+    statusText?: string;
+};
+type NotificationFetch = (input: string, init: RequestInit) => Promise<NotificationFetchResponse>;
+export declare function loadNotificationConfig(path: string): Promise<NotificationConfig>;
+export declare function dispatchEventToTargets(event: RigEvent, targets: NotificationTarget[], deps?: {
+    fetch?: NotificationFetch;
+}): Promise<number>;
+export declare function buildTargetPayload(target: NotificationTarget, event: RigEvent): Record<string, unknown>;
+export declare function resolveNotifyTimeoutMs(): number;
+export {};

package/dist/src/notifications.js

@@ -0,0 +1,74 @@
+// @bun
+// packages/notifications-plugin/src/notifications.ts
+async function loadNotificationConfig(path) {
+  try {
+    const parsed = await Bun.file(path).json();
+    return {
+      targets: (parsed.targets || []).filter((target) => !!target && !!target.id && !!target.url)
+    };
+  } catch {
+    return { targets: [] };
+  }
+}
+async function dispatchEventToTargets(event, targets, deps = {}) {
+  const fetchFn = deps.fetch ?? globalThis.fetch;
+  const timeoutMs = resolveNotifyTimeoutMs();
+  let sent = 0;
+  for (const target of targets) {
+    if (target.enabled === false) {
+      continue;
+    }
+    if (target.events && target.events.length > 0 && !target.events.includes(event.type)) {
+      continue;
+    }
+    const payload = buildTargetPayload(target, event);
+    const controller = new AbortController;
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+      const response = await fetchFn(target.url, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          ...target.headers || {}
+        },
+        body: JSON.stringify(payload),
+        signal: controller.signal
+      });
+      if (response.ok) {
+        sent += 1;
+      } else {
+        console.error(`[runtime] failed to dispatch event ${event.type} to ${target.id}: ${response.status} ${response.statusText}`);
+      }
+    } catch (error) {
+      console.error(`[runtime] failed to dispatch event ${event.type} to ${target.id}`, error);
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+  return sent;
+}
+function buildTargetPayload(target, event) {
+  if (target.type === "slack-webhook") {
+    return {
+      text: `[Rig] ${event.type} ${event.runId ? `(run ${event.runId})` : ""}`.trim(),
+      event
+    };
+  }
+  return {
+    source: "project-rig",
+    target: target.id,
+    summary: `${event.type}${event.runId ? `:${event.runId}` : ""}`,
+    event
+  };
+}
+function resolveNotifyTimeoutMs() {
+  const raw = process.env.RIG_NOTIFY_TIMEOUT_MS;
+  const parsed = raw ? Number.parseInt(raw, 10) : NaN;
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : 1e4;
+}
+export {
+  resolveNotifyTimeoutMs,
+  loadNotificationConfig,
+  dispatchEventToTargets,
+  buildTargetPayload
+};

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@h-rig/notifications-plugin",
+  "version": "0.0.6-alpha.156",
+  "type": "module",
+  "description": "First-party notification policy/channels capability plugin for Rig.",
+  "license": "UNLICENSED",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    },
+    "./notifications": {
+      "types": "./dist/src/notifications.d.ts",
+      "import": "./dist/src/notifications.js"
+    }
+  },
+  "engines": {
+    "bun": ">=1.3.11"
+  },
+  "main": "./dist/src/index.js",
+  "module": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts"
+}