@sweny-ai/providers 0.2.0

package/dist/messaging/teams.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod";
+import type { MessagingProvider } from "./types.js";
+import type { Logger } from "../logger.js";
+export declare const teamsConfigSchema: z.ZodObject<{
+    tenantId: z.ZodString;
+    clientId: z.ZodString;
+    clientSecret: z.ZodString;
+    logger: z.ZodOptional<z.ZodType<Logger, z.ZodTypeDef, Logger>>;
+}, "strip", z.ZodTypeAny, {
+    tenantId: string;
+    clientId: string;
+    clientSecret: string;
+    logger?: Logger | undefined;
+}, {
+    tenantId: string;
+    clientId: string;
+    clientSecret: string;
+    logger?: Logger | undefined;
+}>;
+export type TeamsMessagingConfig = z.infer<typeof teamsConfigSchema>;
+export declare function teams(config: TeamsMessagingConfig): MessagingProvider;
+//# sourceMappingURL=teams.d.ts.map

package/dist/messaging/teams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"teams.d.ts","sourceRoot":"","sources":["../../src/messaging/teams.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAe,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAI3C,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;EAK5B,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAOrE,wBAAgB,KAAK,CAAC,MAAM,EAAE,oBAAoB,GAAG,iBAAiB,CA2IrE"}

package/dist/messaging/teams.js

@@ -0,0 +1,125 @@
+import { z } from "zod";
+import { consoleLogger } from "../logger.js";
+import { ProviderApiError } from "../errors.js";
+export const teamsConfigSchema = z.object({
+    tenantId: z.string().min(1, "Azure AD tenant ID is required"),
+    clientId: z.string().min(1, "Azure AD client ID is required"),
+    clientSecret: z.string().min(1, "Azure AD client secret is required"),
+    logger: z.custom().optional(),
+});
+export function teams(config) {
+    const parsed = teamsConfigSchema.parse(config);
+    const log = parsed.logger ?? consoleLogger;
+    let tokenCache = null;
+    async function getAccessToken() {
+        if (tokenCache && Date.now() < tokenCache.expiresAt) {
+            return tokenCache.accessToken;
+        }
+        const tokenUrl = `https://login.microsoftonline.com/${parsed.tenantId}/oauth2/v2.0/token`;
+        const body = new URLSearchParams({
+            client_id: parsed.clientId,
+            client_secret: parsed.clientSecret,
+            scope: "https://graph.microsoft.com/.default",
+            grant_type: "client_credentials",
+        });
+        const response = await fetch(tokenUrl, {
+            method: "POST",
+            headers: { "Content-Type": "application/x-www-form-urlencoded" },
+            body: body.toString(),
+        });
+        if (!response.ok) {
+            const body = await response.text().catch(() => "");
+            throw new ProviderApiError("Teams", response.status, response.statusText, body);
+        }
+        const data = (await response.json());
+        // Cache the token with a 5-minute safety margin
+        tokenCache = {
+            accessToken: data.access_token,
+            expiresAt: Date.now() + (data.expires_in - 300) * 1000,
+        };
+        log.debug("Acquired new Microsoft Graph access token");
+        return tokenCache.accessToken;
+    }
+    function parseChannelId(channelId) {
+        const separatorIndex = channelId.indexOf("/");
+        if (separatorIndex === -1) {
+            throw new Error(`Invalid channelId format: expected "teamId/channelId", got "${channelId}"`);
+        }
+        return {
+            teamId: channelId.slice(0, separatorIndex),
+            channelId: channelId.slice(separatorIndex + 1),
+        };
+    }
+    return {
+        async sendMessage(msg) {
+            const token = await getAccessToken();
+            const { teamId, channelId } = parseChannelId(msg.channelId);
+            const url = `https://graph.microsoft.com/v1.0/teams/${teamId}/channels/${channelId}/messages`;
+            const contentType = msg.format === "markdown" ? "html" : "text";
+            const payload = {
+                body: {
+                    contentType,
+                    content: msg.text,
+                },
+            };
+            if (msg.threadId) {
+                // Reply to an existing message thread
+                const replyUrl = `${url}/${msg.threadId}/replies`;
+                const response = await fetch(replyUrl, {
+                    method: "POST",
+                    headers: {
+                        Authorization: `Bearer ${token}`,
+                        "Content-Type": "application/json",
+                    },
+                    body: JSON.stringify(payload),
+                });
+                if (!response.ok) {
+                    const body = await response.text().catch(() => "");
+                    throw new ProviderApiError("Teams", response.status, response.statusText, body);
+                }
+                const data = (await response.json());
+                log.debug(`Sent reply to ${msg.channelId} in thread ${msg.threadId}`);
+                return { messageId: data.id };
+            }
+            const response = await fetch(url, {
+                method: "POST",
+                headers: {
+                    Authorization: `Bearer ${token}`,
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify(payload),
+            });
+            if (!response.ok) {
+                const body = await response.text().catch(() => "");
+                throw new ProviderApiError("Teams", response.status, response.statusText, body);
+            }
+            const data = (await response.json());
+            log.debug(`Sent message to ${msg.channelId}`);
+            return { messageId: data.id };
+        },
+        async updateMessage(channelId, messageId, text) {
+            const token = await getAccessToken();
+            const { teamId, channelId: channelPart } = parseChannelId(channelId);
+            const url = `https://graph.microsoft.com/v1.0/teams/${teamId}/channels/${channelPart}/messages/${messageId}`;
+            const response = await fetch(url, {
+                method: "PATCH",
+                headers: {
+                    Authorization: `Bearer ${token}`,
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify({
+                    body: {
+                        contentType: "text",
+                        content: text,
+                    },
+                }),
+            });
+            if (!response.ok) {
+                const body = await response.text().catch(() => "");
+                throw new ProviderApiError("Teams", response.status, response.statusText, body);
+            }
+            log.debug(`Updated message ${messageId} in ${channelId}`);
+        },
+    };
+}
+//# sourceMappingURL=teams.js.map

package/dist/messaging/teams.js.map

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

package/dist/messaging/types.d.ts

@@ -0,0 +1,30 @@
+/** A chat message to send via a messaging provider. */
+export interface ChatMessage {
+    /** Target channel identifier. */
+    channelId: string;
+    /** Thread identifier for threaded replies (omit for top-level messages). */
+    threadId?: string;
+    /** Message text content. */
+    text: string;
+    /** Text format (defaults to provider-specific default). */
+    format?: "markdown" | "text";
+}
+/** Provider interface for sending and updating chat messages. */
+export interface MessagingProvider {
+    /**
+     * Send a message to a channel.
+     * @param msg - The chat message to send.
+     * @returns An object containing the provider-assigned message ID.
+     */
+    sendMessage(msg: ChatMessage): Promise<{
+        messageId: string;
+    }>;
+    /**
+     * Update an existing message.
+     * @param channelId - Channel containing the message.
+     * @param messageId - ID of the message to update.
+     * @param text - New message text content.
+     */
+    updateMessage(channelId: string, messageId: string, text: string): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/messaging/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/messaging/types.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,MAAM,WAAW,WAAW;IAC1B,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;CAC9B;AAED,iEAAiE;AACjE,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,WAAW,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAE9D;;;;;OAKG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClF"}

package/dist/messaging/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/messaging/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/messaging/types.ts"],"names":[],"mappings":""}

package/dist/notification/discord-webhook.d.ts

@@ -0,0 +1,16 @@
+import { z } from "zod";
+import type { Logger } from "../logger.js";
+import type { NotificationProvider } from "./types.js";
+export declare const discordWebhookConfigSchema: z.ZodObject<{
+    webhookUrl: z.ZodString;
+    logger: z.ZodOptional<z.ZodType<Logger, z.ZodTypeDef, Logger>>;
+}, "strip", z.ZodTypeAny, {
+    webhookUrl: string;
+    logger?: Logger | undefined;
+}, {
+    webhookUrl: string;
+    logger?: Logger | undefined;
+}>;
+export type DiscordWebhookConfig = z.infer<typeof discordWebhookConfigSchema>;
+export declare function discordWebhook(config: DiscordWebhookConfig): NotificationProvider;
+//# sourceMappingURL=discord-webhook.d.ts.map

package/dist/notification/discord-webhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discord-webhook.d.ts","sourceRoot":"","sources":["../../src/notification/discord-webhook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C,OAAO,KAAK,EAAE,oBAAoB,EAA2C,MAAM,YAAY,CAAC;AAEhG,eAAO,MAAM,0BAA0B;;;;;;;;;EAGrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,wBAAgB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,oBAAoB,CAGjF"}

package/dist/notification/discord-webhook.js

@@ -0,0 +1,104 @@
+import { z } from "zod";
+import { consoleLogger } from "../logger.js";
+import { ProviderApiError } from "../errors.js";
+export const discordWebhookConfigSchema = z.object({
+    webhookUrl: z.string().url("Discord webhook URL is required"),
+    logger: z.custom().optional(),
+});
+export function discordWebhook(config) {
+    const parsed = discordWebhookConfigSchema.parse(config);
+    return new DiscordWebhookProvider(parsed);
+}
+// ---------------------------------------------------------------------------
+// Embed helpers
+// ---------------------------------------------------------------------------
+// Discord color integers (decimal)
+const STATUS_COLORS = {
+    success: 5763719, // #57F287 green
+    error: 15548997, // #ED4245 red
+    warning: 16705372, // #FEE75C yellow
+    info: 5793266, // #5865F2 blurple
+    skipped: 9807270, // #95A5A6 gray
+};
+const STATUS_EMOJI = {
+    success: "✅",
+    error: "❌",
+    warning: "⚠️",
+    info: "ℹ️",
+    skipped: "⏭️",
+};
+const DISCORD_EMBED_DESC_LIMIT = 4096;
+const DISCORD_FIELD_VALUE_LIMIT = 1024;
+const DISCORD_MAX_FIELDS = 25;
+function buildEmbed(payload) {
+    const embed = {};
+    if (payload.title) {
+        embed.title = payload.title.slice(0, 256);
+    }
+    // Description: status summary or body fallback
+    if (payload.summary) {
+        const emoji = payload.status ? STATUS_EMOJI[payload.status] : "📋";
+        embed.description = `${emoji} ${payload.summary}`.slice(0, DISCORD_EMBED_DESC_LIMIT);
+    }
+    else if (!payload.fields?.length) {
+        embed.description = payload.body.slice(0, DISCORD_EMBED_DESC_LIMIT);
+    }
+    // Color from status
+    if (payload.status) {
+        embed.color = STATUS_COLORS[payload.status];
+    }
+    // Metadata as embed fields (inline)
+    const fields = [];
+    for (const f of payload.fields?.slice(0, DISCORD_MAX_FIELDS) ?? []) {
+        fields.push({
+            name: f.label.slice(0, 256),
+            value: f.value.slice(0, DISCORD_FIELD_VALUE_LIMIT),
+            inline: f.short ?? true,
+        });
+    }
+    if (fields.length) {
+        embed.fields = fields;
+    }
+    // Footer with first section title or run timestamp
+    if (payload.sections?.length || payload.fields?.length) {
+        embed.footer = { text: `SWEny • ${new Date().toUTCString()}` };
+    }
+    return embed;
+}
+// ---------------------------------------------------------------------------
+// Provider
+// ---------------------------------------------------------------------------
+class DiscordWebhookProvider {
+    webhookUrl;
+    log;
+    constructor(config) {
+        this.webhookUrl = config.webhookUrl;
+        this.log = config.logger ?? consoleLogger;
+    }
+    async send(payload) {
+        const embed = buildEmbed(payload);
+        const webhookPayload = { embeds: [embed] };
+        // Discord has a single `content` field — combine sections and links into it.
+        const contentParts = [];
+        if (payload.sections?.length) {
+            contentParts.push(payload.sections.map((s) => `**${s.title ?? "Section"}**\n${s.content}`).join("\n\n"));
+        }
+        if (payload.links?.length) {
+            contentParts.push(payload.links.map((l) => `[${l.label}](${l.url})`).join(" • "));
+        }
+        if (contentParts.length) {
+            webhookPayload.content = contentParts.join("\n\n").slice(0, 2000);
+        }
+        const response = await fetch(this.webhookUrl, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(webhookPayload),
+        });
+        if (!response.ok) {
+            const body = await response.text().catch(() => "");
+            throw new ProviderApiError("Discord", response.status, response.statusText, body);
+        }
+        this.log.info("Discord notification sent");
+    }
+}
+//# sourceMappingURL=discord-webhook.js.map

package/dist/notification/discord-webhook.js.map

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

package/dist/notification/email.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod";
+import type { Logger } from "../logger.js";
+import type { NotificationProvider } from "./types.js";
+export declare const emailConfigSchema: z.ZodObject<{
+    apiKey: z.ZodString;
+    from: z.ZodString;
+    to: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>;
+    logger: z.ZodOptional<z.ZodType<Logger, z.ZodTypeDef, Logger>>;
+}, "strip", z.ZodTypeAny, {
+    apiKey: string;
+    from: string;
+    to: string | string[];
+    logger?: Logger | undefined;
+}, {
+    apiKey: string;
+    from: string;
+    to: string | string[];
+    logger?: Logger | undefined;
+}>;
+export type EmailConfig = z.infer<typeof emailConfigSchema>;
+export declare function email(config: EmailConfig): NotificationProvider;
+//# sourceMappingURL=email.d.ts.map

package/dist/notification/email.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../../src/notification/email.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C,OAAO,KAAK,EAAE,oBAAoB,EAA2C,MAAM,YAAY,CAAC;AAEhG,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;EAK5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAkG5D,wBAAgB,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,oBAAoB,CAG/D"}

package/dist/notification/email.js

@@ -0,0 +1,127 @@
+import { z } from "zod";
+import { consoleLogger } from "../logger.js";
+import { ProviderApiError } from "../errors.js";
+export const emailConfigSchema = z.object({
+    apiKey: z.string().min(1, "SendGrid API key is required"),
+    from: z.string().email("Valid sender email is required"),
+    to: z.union([z.string().email(), z.array(z.string().email()).min(1)]),
+    logger: z.custom().optional(),
+});
+// ---------------------------------------------------------------------------
+// HTML rendering helpers
+// ---------------------------------------------------------------------------
+function escapeHtml(s) {
+    return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+function safeUrl(url) {
+    return /^https?:\/\//i.test(url) ? url : "#";
+}
+const STATUS_COLORS = {
+    success: "#28a745",
+    error: "#dc3545",
+    warning: "#ffc107",
+    info: "#17a2b8",
+    skipped: "#6c757d",
+};
+const STATUS_TEXT_COLORS = {
+    success: "#fff",
+    error: "#fff",
+    warning: "#212529",
+    info: "#fff",
+    skipped: "#fff",
+};
+function buildHtml(payload) {
+    const parts = [
+        `<!DOCTYPE html>`,
+        `<html><body style="font-family:sans-serif;max-width:800px;margin:0 auto;padding:16px">`,
+    ];
+    if (payload.title) {
+        parts.push(`<h2 style="margin-top:0">${escapeHtml(payload.title)}</h2>`);
+    }
+    if (payload.status || payload.summary) {
+        const bg = payload.status ? STATUS_COLORS[payload.status] : "#6c757d";
+        const fg = payload.status ? STATUS_TEXT_COLORS[payload.status] : "#fff";
+        const text = payload.summary ? escapeHtml(payload.summary) : (payload.status ?? "");
+        parts.push(`<div style="background:${bg};color:${fg};padding:8px 12px;border-radius:4px;margin-bottom:12px">${text}</div>`);
+    }
+    if (payload.fields?.length) {
+        parts.push(`<table style="border-collapse:collapse;width:100%;margin-bottom:12px">`);
+        parts.push(`<thead><tr>` +
+            `<th style="text-align:left;padding:6px 8px;border-bottom:2px solid #dee2e6">Field</th>` +
+            `<th style="text-align:left;padding:6px 8px;border-bottom:2px solid #dee2e6">Value</th>` +
+            `</tr></thead><tbody>`);
+        for (const f of payload.fields) {
+            parts.push(`<tr>` +
+                `<td style="padding:4px 8px;border-bottom:1px solid #dee2e6">${escapeHtml(f.label)}</td>` +
+                `<td style="padding:4px 8px;border-bottom:1px solid #dee2e6">${escapeHtml(f.value)}</td>` +
+                `</tr>`);
+        }
+        parts.push(`</tbody></table>`);
+    }
+    if (payload.links?.length) {
+        const buttons = payload.links
+            .map((l) => `<a href="${safeUrl(l.url)}" style="display:inline-block;padding:6px 12px;margin:0 4px 4px 0;` +
+            `background:#0d6efd;color:#fff;text-decoration:none;border-radius:4px">${escapeHtml(l.label)}</a>`)
+            .join("");
+        parts.push(`<div style="margin-bottom:12px">${buttons}</div>`);
+    }
+    for (const section of payload.sections ?? []) {
+        if (section.title) {
+            parts.push(`<h3>${escapeHtml(section.title)}</h3>`);
+        }
+        parts.push(`<pre style="background:#f8f9fa;padding:12px;border-radius:4px;overflow:auto;white-space:pre-wrap">` +
+            `${escapeHtml(section.content)}</pre>`);
+    }
+    // When no structured content was added, fall back to the body text
+    if (!payload.fields?.length && !payload.status && !payload.summary && !payload.sections?.length) {
+        parts.push(`<div>${payload.body}</div>`);
+    }
+    parts.push(`</body></html>`);
+    return parts.join("\n");
+}
+export function email(config) {
+    const parsed = emailConfigSchema.parse(config);
+    return new EmailProvider(parsed);
+}
+class EmailProvider {
+    apiKey;
+    from;
+    to;
+    log;
+    constructor(config) {
+        this.apiKey = config.apiKey;
+        this.from = config.from;
+        this.to = Array.isArray(config.to) ? config.to : [config.to];
+        this.log = config.logger ?? consoleLogger;
+    }
+    async send(payload) {
+        const subject = payload.title ?? "SWEny Notification";
+        const hasStructuredContent = !!(payload.status ||
+            payload.summary ||
+            payload.fields?.length ||
+            payload.sections?.length ||
+            payload.links?.length);
+        const isHtml = payload.format === "html" || hasStructuredContent;
+        const value = hasStructuredContent ? buildHtml(payload) : payload.body;
+        const content = [{ type: isHtml ? "text/html" : "text/plain", value }];
+        const response = await fetch("https://api.sendgrid.com/v3/mail/send", {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${this.apiKey}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({
+                personalizations: [{ to: this.to.map((addr) => ({ email: addr })) }],
+                from: { email: this.from },
+                subject,
+                content,
+            }),
+        });
+        if (!response.ok) {
+            const body = await response.text().catch(() => undefined);
+            throw new ProviderApiError("email", response.status, response.statusText, body);
+        }
+        this.log.info(`Email notification sent to ${this.to.join(", ")}`);
+    }
+}
+//# sourceMappingURL=email.js.map

package/dist/notification/email.js.map

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

package/dist/notification/github-summary.d.ts

@@ -0,0 +1,13 @@
+import { z } from "zod";
+import type { Logger } from "../logger.js";
+import type { NotificationProvider } from "./types.js";
+export declare const githubSummaryConfigSchema: z.ZodObject<{
+    logger: z.ZodOptional<z.ZodType<Logger, z.ZodTypeDef, Logger>>;
+}, "strip", z.ZodTypeAny, {
+    logger?: Logger | undefined;
+}, {
+    logger?: Logger | undefined;
+}>;
+export type GitHubSummaryConfig = z.infer<typeof githubSummaryConfigSchema>;
+export declare function githubSummary(config?: GitHubSummaryConfig): NotificationProvider;
+//# sourceMappingURL=github-summary.d.ts.map

package/dist/notification/github-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-summary.d.ts","sourceRoot":"","sources":["../../src/notification/github-summary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,KAAK,EAAE,oBAAoB,EAA2C,MAAM,YAAY,CAAC;AAEhG,eAAO,MAAM,yBAAyB;;;;;;EAEpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,oBAAoB,CAEhF"}

package/dist/notification/github-summary.js

@@ -0,0 +1,67 @@
+import { z } from "zod";
+import { consoleLogger } from "../logger.js";
+export const githubSummaryConfigSchema = z.object({
+    logger: z.custom().optional(),
+});
+export function githubSummary(config) {
+    return new GitHubSummaryProvider(config?.logger ?? consoleLogger);
+}
+// ---------------------------------------------------------------------------
+// Rendering helpers
+// ---------------------------------------------------------------------------
+const STATUS_EMOJI = {
+    success: "✅",
+    error: "❌",
+    warning: "⚠️",
+    info: "ℹ️",
+    skipped: "⏭️",
+};
+class GitHubSummaryProvider {
+    log;
+    constructor(logger) {
+        this.log = logger;
+    }
+    async send(payload) {
+        const core = await import("@actions/core");
+        const summary = core.summary;
+        // Title
+        if (payload.title) {
+            summary.addHeading(payload.title, 2);
+        }
+        // Status summary
+        if (payload.status || payload.summary) {
+            const emoji = payload.status ? STATUS_EMOJI[payload.status] : "📋";
+            const text = payload.summary ? `${emoji} **${payload.summary}**` : emoji;
+            summary.addRaw(`\n${text}\n\n`);
+        }
+        // Metadata fields as a table
+        if (payload.fields?.length) {
+            summary.addTable([
+                [
+                    { data: "Field", header: true },
+                    { data: "Value", header: true },
+                ],
+                ...payload.fields.map((f) => [f.label, f.value]),
+            ]);
+        }
+        // Action links
+        if (payload.links?.length) {
+            const linkList = payload.links.map((l) => `[${l.label}](${l.url})`).join(" · ");
+            summary.addRaw(`\n${linkList}\n\n`);
+        }
+        // Content sections
+        for (const section of payload.sections ?? []) {
+            if (section.title) {
+                summary.addHeading(section.title, 3);
+            }
+            summary.addRaw(section.content + "\n\n");
+        }
+        // Fallback: if no structured content, write body directly
+        if (!payload.fields?.length && !payload.status && !payload.summary && !payload.sections?.length) {
+            summary.addRaw(payload.body);
+        }
+        await summary.write();
+        this.log.info("GitHub Action summary written");
+    }
+}
+//# sourceMappingURL=github-summary.js.map

package/dist/notification/github-summary.js.map

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

package/dist/notification/index.d.ts

@@ -0,0 +1,8 @@
+export type { NotificationProvider, NotificationPayload, NotificationStatus, NotificationField, NotificationSection, NotificationLink, } from "./types.js";
+export { githubSummary, githubSummaryConfigSchema, type GitHubSummaryConfig } from "./github-summary.js";
+export { slackWebhook, slackWebhookConfigSchema, type SlackWebhookConfig } from "./slack-webhook.js";
+export { teamsWebhook, teamsWebhookConfigSchema, type TeamsWebhookConfig } from "./teams-webhook.js";
+export { discordWebhook, discordWebhookConfigSchema, type DiscordWebhookConfig } from "./discord-webhook.js";
+export { email, emailConfigSchema, type EmailConfig } from "./email.js";
+export { webhook, webhookConfigSchema, type WebhookConfig } from "./webhook.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/notification/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/notification/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,aAAa,EAAE,yBAAyB,EAAE,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACzG,OAAO,EAAE,YAAY,EAAE,wBAAwB,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACrG,OAAO,EAAE,YAAY,EAAE,wBAAwB,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACrG,OAAO,EAAE,cAAc,EAAE,0BAA0B,EAAE,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC7G,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/notification/index.js

@@ -0,0 +1,7 @@
+export { githubSummary, githubSummaryConfigSchema } from "./github-summary.js";
+export { slackWebhook, slackWebhookConfigSchema } from "./slack-webhook.js";
+export { teamsWebhook, teamsWebhookConfigSchema } from "./teams-webhook.js";
+export { discordWebhook, discordWebhookConfigSchema } from "./discord-webhook.js";
+export { email, emailConfigSchema } from "./email.js";
+export { webhook, webhookConfigSchema } from "./webhook.js";
+//# sourceMappingURL=index.js.map

package/dist/notification/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/notification/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,aAAa,EAAE,yBAAyB,EAA4B,MAAM,qBAAqB,CAAC;AACzG,OAAO,EAAE,YAAY,EAAE,wBAAwB,EAA2B,MAAM,oBAAoB,CAAC;AACrG,OAAO,EAAE,YAAY,EAAE,wBAAwB,EAA2B,MAAM,oBAAoB,CAAC;AACrG,OAAO,EAAE,cAAc,EAAE,0BAA0B,EAA6B,MAAM,sBAAsB,CAAC;AAC7G,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAoB,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAsB,MAAM,cAAc,CAAC"}