pi-harness-runtime 0.9.4 → 0.9.6

package/packages/nextjs-plugin/src/types.ts

@@ -0,0 +1,36 @@
+/**
+ * Next.js Plugin — Types (RFC-0062)
+ */
+
+export interface NextJsAnalysis {
+	framework: FrameworkInfo;
+	version?: string;
+	usingAppRouter: boolean;
+	usingPagesRouter: boolean;
+	apiRoutes: string[];
+	appRoutes: AppRoute[];
+	middleware?: string;
+	middlewareConfig?: Record<string, unknown>;
+	environmentVars: string[];
+	configs: ConfigFile[];
+}
+
+export interface FrameworkInfo {
+	id: string;
+	name: string;
+	category: string;
+	description: string;
+	tags: string[];
+}
+
+export interface AppRoute {
+	path: string;
+	method: string;
+	isDynamic: boolean;
+	file: string;
+}
+
+export interface ConfigFile {
+	name: string;
+	path: string;
+}

package/packages/nextjs-plugin/test/analyzer.test.ts

@@ -0,0 +1,149 @@
+/**
+ * Next.js Plugin Tests (RFC-0062)
+ */
+
+import { describe, it, expect, afterEach } from "bun:test";
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import * as os from "node:os";
+import { analyzeNextJs } from "../src/analyzer.js";
+
+const roots: string[] = [];
+
+async function mkdtemp(): Promise<string> {
+	const d = await fs.mkdtemp(path.join(os.tmpdir(), "nextjs-plugin-"));
+	roots.push(d);
+	return d;
+}
+
+afterEach(async () => {
+	for (const d of roots) {
+		try {
+			await fs.rm(d, { recursive: true, force: true });
+		} catch {
+			/* ignore */
+		}
+	}
+	roots.length = 0;
+});
+
+describe("analyzeNextJs", () => {
+	it("returns null for non-nextjs workspace", async () => {
+		const dir = await mkdtemp();
+		await fs.writeFile(path.join(dir, "package.json"), "{}", "utf-8");
+		expect(await analyzeNextJs(dir)).toBeNull();
+	});
+
+	it("detects next.js workspace via next.config", async () => {
+		const dir = await mkdtemp();
+		await fs.writeFile(
+			path.join(dir, "next.config.js"),
+			"module.exports = {}",
+			"utf-8",
+		);
+		await fs.writeFile(
+			path.join(dir, "package.json"),
+			JSON.stringify({
+				dependencies: { next: "14.0.0" },
+			}),
+			"utf-8",
+		);
+		const result = await analyzeNextJs(dir);
+		expect(result).not.toBeNull();
+		expect(result!.framework.id).toBe("nextjs");
+		expect(result!.version).toBe("14.0.0");
+	});
+
+	it("detects app router", async () => {
+		const dir = await mkdtemp();
+		await fs.mkdir(path.join(dir, "app"), { recursive: true });
+		await fs.mkdir(path.join(dir, "app", "dashboard"), { recursive: true });
+		await fs.writeFile(
+			path.join(dir, "app", "page.tsx"),
+			"export default function Page() {}",
+			"utf-8",
+		);
+		await fs.writeFile(
+			path.join(dir, "app", "dashboard", "page.tsx"),
+			"export default function Dashboard() {}",
+			"utf-8",
+		);
+		await fs.writeFile(
+			path.join(dir, "next.config.js"),
+			"module.exports = {}",
+			"utf-8",
+		);
+		const result = await analyzeNextJs(dir);
+		expect(result!.usingAppRouter).toBe(true);
+		expect(result!.appRoutes.length).toBeGreaterThanOrEqual(2);
+	});
+
+	it("lists API routes", async () => {
+		const dir = await mkdtemp();
+		await fs.mkdir(path.join(dir, "pages", "api", "posts"), {
+			recursive: true,
+		});
+		await fs.writeFile(
+			path.join(dir, "pages", "api", "users.ts"),
+			"export default function handler(req, res) {}",
+			"utf-8",
+		);
+		await fs.writeFile(
+			path.join(dir, "pages", "api", "posts", "[id].ts"),
+			"export default function handler(req, res) {}",
+			"utf-8",
+		);
+		await fs.writeFile(
+			path.join(dir, "next.config.js"),
+			"module.exports = {}",
+			"utf-8",
+		);
+		const result = await analyzeNextJs(dir);
+		expect(result!.usingPagesRouter).toBe(true);
+		expect(result!.apiRoutes.some((r) => r.includes("users"))).toBe(true);
+	});
+
+	it("extracts environment variables", async () => {
+		const dir = await mkdtemp();
+		await fs.writeFile(
+			path.join(dir, ".env.example"),
+			[
+				"# Database",
+				"DATABASE_URL=postgres://...",
+				"API_KEY=secret",
+				"",
+				"NEXT_PUBLIC_APP_URL=https://example.com",
+			].join("\n"),
+			"utf-8",
+		);
+		await fs.writeFile(
+			path.join(dir, "next.config.js"),
+			"module.exports = {}",
+			"utf-8",
+		);
+		const result = await analyzeNextJs(dir);
+		expect(result!.environmentVars).toContain("DATABASE_URL");
+		expect(result!.environmentVars).toContain("API_KEY");
+		expect(result!.environmentVars).toContain("NEXT_PUBLIC_APP_URL");
+		expect(result!.environmentVars).not.toContain(
+			"DATABASE_URL=postgres://...",
+		);
+	});
+
+	it("finds middleware file", async () => {
+		const dir = await mkdtemp();
+		await fs.writeFile(
+			path.join(dir, "middleware.ts"),
+			"import { NextResponse } from 'next/server'",
+			"utf-8",
+		);
+		await fs.writeFile(
+			path.join(dir, "next.config.js"),
+			"module.exports = {}",
+			"utf-8",
+		);
+		const result = await analyzeNextJs(dir);
+		expect(result!.middleware).toBeDefined();
+		expect(result!.middleware).toContain("middleware.ts");
+	});
+});

package/packages/nextjs-plugin/tsconfig.json

@@ -0,0 +1,12 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src/**/*"],
+  "references": [
+    { "path": "../framework-plugin-sdk" },
+    { "path": "../framework-detector" }
+  ]
+}

package/packages/notification/dist/adapters/email-adapter.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Email Adapter — RFC-0022
+ *
+ * Sends notifications via SMTP.
+ */
+import type { NotificationPayload, NotificationResult, EmailConfig } from "../types.js";
+import { BaseChannelAdapter } from "../base-adapter.js";
+export declare class EmailAdapter extends BaseChannelAdapter {
+    readonly id = "email";
+    readonly type = "email";
+    constructor(config: EmailConfig);
+    initialize(): Promise<boolean>;
+    send(payload: NotificationPayload): Promise<NotificationResult>;
+    private formatBody;
+    private getEmoji;
+}
+//# sourceMappingURL=email-adapter.d.ts.map

package/packages/notification/dist/adapters/email-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/email-adapter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACX,mBAAmB,EACnB,kBAAkB,EAClB,WAAW,EACX,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AA0BxD,qBAAa,YAAa,SAAQ,kBAAkB;IACnD,QAAQ,CAAC,EAAE,WAAW;IACtB,QAAQ,CAAC,IAAI,WAAW;IAExB,YAAY,MAAM,EAAE,WAAW,EAE9B;IAEK,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,CAWnC;IAEK,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA0BpE;IAED,OAAO,CAAC,UAAU;IAsBlB,OAAO,CAAC,QAAQ;CAiBhB"}

package/packages/notification/dist/adapters/email-adapter.js

@@ -0,0 +1,89 @@
+/**
+ * Email Adapter — RFC-0022
+ *
+ * Sends notifications via SMTP.
+ */
+import { BaseChannelAdapter } from "../base-adapter.js";
+// Simple SMTP client using built-in net module
+async function sendSmtpEmail(host, port, user, password, from, to, subject, body, tls = false) {
+    // For a production implementation, you'd use a proper SMTP library
+    // This is a placeholder that logs the email
+    console.log(`[Email] Would send to ${to.join(", ")}`);
+    console.log(`[Email] Subject: ${subject}`);
+    console.log(`[Email] Body: ${body}`);
+    // In practice, you'd use something like:
+    // import { createClient } from "nodemailer";
+    // const transporter = nodemailer.createTransport({ ... });
+    // await transporter.sendMail({ ... });
+}
+export class EmailAdapter extends BaseChannelAdapter {
+    id = "email";
+    type = "email";
+    constructor(config) {
+        super({ id: "email", type: "email", enabled: true, config });
+    }
+    async initialize() {
+        // Verify SMTP connection
+        try {
+            const cfg = this.config.config;
+            // In production, verify SMTP credentials
+            return Boolean(cfg.smtpHost && cfg.smtpUser && cfg.from && cfg.to.length > 0);
+        }
+        catch {
+            return false;
+        }
+    }
+    async send(payload) {
+        try {
+            const cfg = this.config.config;
+            const subject = `${this.getEmoji(payload.event)} ${payload.title}`;
+            const body = this.formatBody(payload);
+            await sendSmtpEmail(cfg.smtpHost, cfg.smtpPort, cfg.smtpUser, cfg.smtpPassword, cfg.from, cfg.to, subject, body, cfg.tls);
+            return { success: true, channel: this.id };
+        }
+        catch (error) {
+            return {
+                success: false,
+                channel: this.id,
+                error: String(error),
+            };
+        }
+    }
+    formatBody(payload) {
+        const lines = [
+            payload.message,
+            "",
+            "---",
+            `Event: ${payload.event}`,
+            `Time: ${payload.timestamp}`,
+        ];
+        if (payload.details?.taskTitle) {
+            lines.push(`Task: ${payload.details.taskTitle}`);
+        }
+        if (payload.details?.jobId) {
+            lines.push(`Job ID: ${payload.details.jobId}`);
+        }
+        if (payload.details?.error) {
+            lines.push("", `Error: ${payload.details.error}`);
+        }
+        return lines.join("\n");
+    }
+    getEmoji(event) {
+        const map = {
+            JobStarted: "[🚀]",
+            TaskCompleted: "[✅]",
+            TaskFailed: "[❌]",
+            QuotaPaused: "[⏸]",
+            ResumeScheduled: "[▶]",
+            ContextCompacted: "[📦]",
+            OutputLimitContinued: "[🔄]",
+            E2EFailed: "[🧪]",
+            HumanReviewNeeded: "[👤]",
+            ReadyForClient: "[🎉]",
+            JobCancelled: "[🚫]",
+            Error: "[⚠]",
+        };
+        return map[event] ?? "[📢]";
+    }
+}
+//# sourceMappingURL=email-adapter.js.map

package/packages/notification/dist/adapters/email-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-adapter.js","sourceRoot":"","sources":["../../src/adapters/email-adapter.ts"],"names":[],"mappings":"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"}

package/packages/notification/dist/adapters/ntfy-adapter.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Ntfy Adapter — RFC-0022
+ *
+ * Sends notifications via ntfy.sh (or self-hosted ntfy server).
+ */
+import type { NotificationPayload, NotificationResult, NtfyConfig } from "../types.js";
+import { BaseChannelAdapter } from "../base-adapter.js";
+export declare class NtfyAdapter extends BaseChannelAdapter {
+    readonly id = "ntfy";
+    readonly type = "ntfy";
+    constructor(config: NtfyConfig);
+    initialize(): Promise<boolean>;
+    send(payload: NotificationPayload): Promise<NotificationResult>;
+    private formatMessage;
+    private getTags;
+}
+//# sourceMappingURL=ntfy-adapter.d.ts.map

package/packages/notification/dist/adapters/ntfy-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ntfy-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/ntfy-adapter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACX,mBAAmB,EACnB,kBAAkB,EAClB,UAAU,EACV,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,qBAAa,WAAY,SAAQ,kBAAkB;IAClD,QAAQ,CAAC,EAAE,UAAU;IACrB,QAAQ,CAAC,IAAI,UAAU;IAEvB,YAAY,MAAM,EAAE,UAAU,EAE7B;IAEK,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,CAGnC;IAEK,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAsCpE;IAED,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,OAAO;CAiBf"}

package/packages/notification/dist/adapters/ntfy-adapter.js

@@ -0,0 +1,84 @@
+/**
+ * Ntfy Adapter — RFC-0022
+ *
+ * Sends notifications via ntfy.sh (or self-hosted ntfy server).
+ */
+import { BaseChannelAdapter } from "../base-adapter.js";
+export class NtfyAdapter extends BaseChannelAdapter {
+    id = "ntfy";
+    type = "ntfy";
+    constructor(config) {
+        super({ id: "ntfy", type: "ntfy", enabled: true, config });
+    }
+    async initialize() {
+        // Ntfy doesn't require initialization; it's fire-and-forget
+        return true;
+    }
+    async send(payload) {
+        try {
+            const cfg = this.config.config;
+            const message = this.formatMessage(payload);
+            const headers = {
+                "Content-Type": "text/plain",
+                Title: payload.title,
+                Tags: this.getTags(payload.event),
+            };
+            // Add auth if configured
+            if (cfg.authToken) {
+                headers["Authorization"] = `Bearer ${cfg.authToken}`;
+            }
+            const response = await fetch(`${cfg.server}/${cfg.topic}`, {
+                method: "POST",
+                headers,
+                body: message,
+            });
+            if (!response.ok) {
+                const error = await response.text();
+                return {
+                    success: false,
+                    channel: this.id,
+                    error: `Ntfy error: ${error}`,
+                };
+            }
+            return { success: true, channel: this.id };
+        }
+        catch (error) {
+            return {
+                success: false,
+                channel: this.id,
+                error: String(error),
+            };
+        }
+    }
+    formatMessage(payload) {
+        const lines = [payload.message];
+        if (payload.details?.taskTitle) {
+            lines.push(`\nTask: ${payload.details.taskTitle}`);
+        }
+        if (payload.details?.jobId) {
+            lines.push(`Job: ${payload.details.jobId}`);
+        }
+        if (payload.details?.error) {
+            lines.push(`\nError: ${payload.details.error}`);
+        }
+        return lines.join("");
+    }
+    getTags(event) {
+        const map = {
+            JobStarted: "rocket",
+            TaskCompleted: "white_check_mark",
+            TaskFailed: "x",
+            QuotaPaused: "pause_button",
+            ResumeScheduled: "play_button",
+            ContextCompacted: "package",
+            OutputLimitContinued: "repeat",
+            E2EFailed: "test_tube",
+            HumanReviewNeeded: "bust_in_silhouette",
+            ReadyForClient: "tada",
+            JobCancelled: "no_entry",
+            Error: "warning",
+        };
+        return map[event] ?? "bell";
+    }
+}
+//# sourceMappingURL=ntfy-adapter.js.map

package/packages/notification/dist/adapters/ntfy-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ntfy-adapter.js","sourceRoot":"","sources":["../../src/adapters/ntfy-adapter.ts"],"names":[],"mappings":"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"}

package/packages/notification/dist/adapters/telegram-adapter.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Telegram Adapter — RFC-0022
+ *
+ * Sends notifications via Telegram Bot API.
+ */
+import type { NotificationPayload, NotificationResult, TelegramConfig } from "../types.js";
+import { BaseChannelAdapter } from "../base-adapter.js";
+export declare class TelegramAdapter extends BaseChannelAdapter {
+    readonly id = "telegram";
+    readonly type = "telegram";
+    constructor(config: TelegramConfig);
+    initialize(): Promise<boolean>;
+    send(payload: NotificationPayload): Promise<NotificationResult>;
+    private formatMessage;
+    private getEmoji;
+}
+//# sourceMappingURL=telegram-adapter.d.ts.map

package/packages/notification/dist/adapters/telegram-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/telegram-adapter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACX,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,qBAAa,eAAgB,SAAQ,kBAAkB;IACtD,QAAQ,CAAC,EAAE,cAAc;IACzB,QAAQ,CAAC,IAAI,cAAc;IAE3B,YAAY,MAAM,EAAE,cAAc,EAEjC;IAEK,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,CAWnC;IAEK,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAmCpE;IAED,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,QAAQ;CAiBhB"}

package/packages/notification/dist/adapters/telegram-adapter.js

@@ -0,0 +1,88 @@
+/**
+ * Telegram Adapter — RFC-0022
+ *
+ * Sends notifications via Telegram Bot API.
+ */
+import { BaseChannelAdapter } from "../base-adapter.js";
+export class TelegramAdapter extends BaseChannelAdapter {
+    id = "telegram";
+    type = "telegram";
+    constructor(config) {
+        super({ id: "telegram", type: "telegram", enabled: true, config });
+    }
+    async initialize() {
+        try {
+            const cfg = this.config.config;
+            // Verify bot token by calling getMe
+            const response = await fetch(`https://api.telegram.org/bot${cfg.botToken}/getMe`);
+            return response.ok;
+        }
+        catch {
+            return false;
+        }
+    }
+    async send(payload) {
+        try {
+            const cfg = this.config.config;
+            const message = this.formatMessage(payload);
+            const response = await fetch(`https://api.telegram.org/bot${cfg.botToken}/sendMessage`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({
+                    chat_id: cfg.chatId,
+                    text: message,
+                    parse_mode: cfg.parseMode ?? "MarkdownV2",
+                }),
+            });
+            if (!response.ok) {
+                const error = await response.text();
+                return {
+                    success: false,
+                    channel: this.id,
+                    error: `Telegram API error: ${error}`,
+                };
+            }
+            return { success: true, channel: this.id };
+        }
+        catch (error) {
+            return {
+                success: false,
+                channel: this.id,
+                error: String(error),
+            };
+        }
+    }
+    formatMessage(payload) {
+        const emoji = this.getEmoji(payload.event);
+        const title = `${emoji} ${payload.title}`;
+        const lines = [title, "", payload.message];
+        if (payload.details?.taskTitle) {
+            lines.push("", `Task: ${payload.details.taskTitle}`);
+        }
+        if (payload.details?.jobId) {
+            lines.push(`Job: ${payload.details.jobId}`);
+        }
+        if (payload.details?.error) {
+            lines.push("", `Error: ${payload.details.error}`);
+        }
+        return lines.filter(Boolean).join("\n");
+    }
+    getEmoji(event) {
+        const map = {
+            JobStarted: "🚀",
+            TaskCompleted: "✅",
+            TaskFailed: "❌",
+            QuotaPaused: "⏸️",
+            ResumeScheduled: "▶️",
+            ContextCompacted: "📦",
+            OutputLimitContinued: "🔄",
+            E2EFailed: "🧪",
+            HumanReviewNeeded: "👤",
+            ReadyForClient: "🎉",
+            JobCancelled: "🚫",
+            Error: "⚠️",
+        };
+        return map[event] ?? "📢";
+    }
+}
+//# sourceMappingURL=telegram-adapter.js.map

package/packages/notification/dist/adapters/telegram-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-adapter.js","sourceRoot":"","sources":["../../src/adapters/telegram-adapter.ts"],"names":[],"mappings":"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"}

package/packages/notification/dist/adapters/webhook-adapter.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Webhook Adapter — RFC-0022
+ *
+ * Sends notifications to a generic webhook endpoint.
+ */
+import type { NotificationPayload, NotificationResult, WebhookConfig } from "../types.js";
+import { BaseChannelAdapter } from "../base-adapter.js";
+export declare class WebhookAdapter extends BaseChannelAdapter {
+    readonly id = "webhook";
+    readonly type = "webhook";
+    constructor(config: WebhookConfig);
+    initialize(): Promise<boolean>;
+    send(payload: NotificationPayload): Promise<NotificationResult>;
+}
+//# sourceMappingURL=webhook-adapter.d.ts.map

package/packages/notification/dist/adapters/webhook-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/webhook-adapter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACX,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,qBAAa,cAAe,SAAQ,kBAAkB;IACrD,QAAQ,CAAC,EAAE,aAAa;IACxB,QAAQ,CAAC,IAAI,aAAa;IAE1B,YAAY,MAAM,EAAE,aAAa,EAEhC;IAEK,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,CAOnC;IAEK,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA2CpE;CACD"}

package/packages/notification/dist/adapters/webhook-adapter.js

@@ -0,0 +1,64 @@
+/**
+ * Webhook Adapter — RFC-0022
+ *
+ * Sends notifications to a generic webhook endpoint.
+ */
+import { BaseChannelAdapter } from "../base-adapter.js";
+export class WebhookAdapter extends BaseChannelAdapter {
+    id = "webhook";
+    type = "webhook";
+    constructor(config) {
+        super({ id: "webhook", type: "webhook", enabled: true, config });
+    }
+    async initialize() {
+        try {
+            const cfg = this.config.config;
+            return Boolean(cfg.url && cfg.url.startsWith("http"));
+        }
+        catch {
+            return false;
+        }
+    }
+    async send(payload) {
+        try {
+            const cfg = this.config.config;
+            const headers = {
+                "Content-Type": "application/json",
+                ...(cfg.headers ?? {}),
+            };
+            // Add auth token if configured
+            if (cfg.authToken) {
+                headers["Authorization"] = `Bearer ${cfg.authToken}`;
+            }
+            const response = await fetch(cfg.url, {
+                method: cfg.method ?? "POST",
+                headers,
+                body: JSON.stringify({
+                    event: payload.event,
+                    jobId: payload.jobId,
+                    timestamp: payload.timestamp,
+                    title: payload.title,
+                    message: payload.message,
+                    details: payload.details,
+                }),
+            });
+            if (!response.ok) {
+                const error = await response.text();
+                return {
+                    success: false,
+                    channel: this.id,
+                    error: `Webhook error ${response.status}: ${error}`,
+                };
+            }
+            return { success: true, channel: this.id };
+        }
+        catch (error) {
+            return {
+                success: false,
+                channel: this.id,
+                error: String(error),
+            };
+        }
+    }
+}
+//# sourceMappingURL=webhook-adapter.js.map

package/packages/notification/dist/adapters/webhook-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-adapter.js","sourceRoot":"","sources":["../../src/adapters/webhook-adapter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,OAAO,cAAe,SAAQ,kBAAkB;IAC5C,EAAE,GAAG,SAAS,CAAC;IACf,IAAI,GAAG,SAAS,CAAC;IAE1B,YAAY,MAAqB;QAChC,KAAK,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,UAAU;QACf,IAAI,CAAC;YACJ,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,MAAuB,CAAC;YAChD,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;QACvD,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,KAAK,CAAC;QACd,CAAC;IACF,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAA4B;QACtC,IAAI,CAAC;YACJ,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,MAAuB,CAAC;YAChD,MAAM,OAAO,GAA2B;gBACvC,cAAc,EAAE,kBAAkB;gBAClC,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;aACtB,CAAC;YAEF,+BAA+B;YAC/B,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;gBACnB,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,GAAG,CAAC,SAAS,EAAE,CAAC;YACtD,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE;gBACrC,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,MAAM;gBAC5B,OAAO;gBACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACpB,KAAK,EAAE,OAAO,CAAC,KAAK;oBACpB,KAAK,EAAE,OAAO,CAAC,KAAK;oBACpB,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,KAAK,EAAE,OAAO,CAAC,KAAK;oBACpB,OAAO,EAAE,OAAO,CAAC,OAAO;oBACxB,OAAO,EAAE,OAAO,CAAC,OAAO;iBACxB,CAAC;aACF,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBAClB,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACpC,OAAO;oBACN,OAAO,EAAE,KAAK;oBACd,OAAO,EAAE,IAAI,CAAC,EAAE;oBAChB,KAAK,EAAE,iBAAiB,QAAQ,CAAC,MAAM,KAAK,KAAK,EAAE;iBACnD,CAAC;YACH,CAAC;YAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;QAC5C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,OAAO;gBACN,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,IAAI,CAAC,EAAE;gBAChB,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;aACpB,CAAC;QACH,CAAC;IACF,CAAC;CACD"}