@sweny-ai/providers 0.2.0

package/dist/notification/slack-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 slackWebhookConfigSchema: 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 SlackWebhookConfig = z.infer<typeof slackWebhookConfigSchema>;
+export declare function slackWebhook(config: SlackWebhookConfig): NotificationProvider;
+//# sourceMappingURL=slack-webhook.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"slack-webhook.d.ts","sourceRoot":"","sources":["../../src/notification/slack-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,wBAAwB;;;;;;;;;EAGnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,wBAAgB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,oBAAoB,CAG7E"}

package/dist/notification/slack-webhook.js

@@ -0,0 +1,123 @@
+import { z } from "zod";
+import { consoleLogger } from "../logger.js";
+import { ProviderApiError } from "../errors.js";
+export const slackWebhookConfigSchema = z.object({
+    webhookUrl: z.string().url("Slack webhook URL is required"),
+    logger: z.custom().optional(),
+});
+export function slackWebhook(config) {
+    const parsed = slackWebhookConfigSchema.parse(config);
+    return new SlackWebhookProvider(parsed);
+}
+// ---------------------------------------------------------------------------
+// Block Kit helpers
+// ---------------------------------------------------------------------------
+const STATUS_EMOJI = {
+    success: "✅",
+    error: "❌",
+    warning: "⚠️",
+    info: "ℹ️",
+    skipped: "⏭️",
+};
+/** Build the fallback `text` field (used for notifications and screen readers). */
+function buildFallbackText(payload) {
+    if (payload.title && payload.summary)
+        return `*${payload.title}*\n${payload.summary}`;
+    if (payload.title)
+        return `*${payload.title}*\n${payload.body?.slice(0, 150) || ""}`;
+    return payload.body?.slice(0, 150) || "";
+}
+/** Build Slack Block Kit blocks from the structured payload. */
+function buildBlocks(payload) {
+    const blocks = [];
+    // 1. Header block
+    if (payload.title) {
+        blocks.push({
+            type: "header",
+            text: { type: "plain_text", text: payload.title, emoji: true },
+        });
+    }
+    // 2. Status + summary section
+    if (payload.status || payload.summary) {
+        const emoji = payload.status ? STATUS_EMOJI[payload.status] : "📋";
+        const text = payload.summary ? `${emoji} *${payload.summary}*` : emoji;
+        blocks.push({
+            type: "section",
+            text: { type: "mrkdwn", text },
+        });
+    }
+    // 3. Metadata fields grid (max 10 fields per section block — Slack limit)
+    if (payload.fields?.length) {
+        for (let i = 0; i < payload.fields.length; i += 10) {
+            const chunk = payload.fields.slice(i, i + 10);
+            blocks.push({
+                type: "section",
+                fields: chunk.map((f) => ({
+                    type: "mrkdwn",
+                    text: `*${f.label}*\n${f.value}`,
+                })),
+            });
+        }
+    }
+    // 4. If no structured content at all, fall back to body as a mrkdwn section
+    if (!payload.fields?.length && !payload.status && !payload.summary) {
+        const text = payload.body?.slice(0, 3000) || "";
+        if (text) {
+            blocks.push({
+                type: "section",
+                text: { type: "mrkdwn", text },
+            });
+        }
+    }
+    // 5. Action links as buttons
+    if (payload.links?.length) {
+        blocks.push({
+            type: "actions",
+            elements: payload.links.map((l, i) => ({
+                type: "button",
+                text: { type: "plain_text", text: l.label, emoji: true },
+                url: l.url,
+                action_id: `notify_link_${i}`,
+            })),
+        });
+    }
+    // 6. Content sections (investigation log, issues report, etc.)
+    for (const section of payload.sections ?? []) {
+        blocks.push({ type: "divider" });
+        const header = section.title ? `*${section.title}*\n` : "";
+        const text = `${header}${section.content}`;
+        blocks.push({
+            type: "section",
+            text: { type: "mrkdwn", text: text.slice(0, 3000) },
+        });
+    }
+    return blocks;
+}
+// ---------------------------------------------------------------------------
+// Provider
+// ---------------------------------------------------------------------------
+class SlackWebhookProvider {
+    webhookUrl;
+    log;
+    constructor(config) {
+        this.webhookUrl = config.webhookUrl;
+        this.log = config.logger ?? consoleLogger;
+    }
+    async send(payload) {
+        const body = JSON.stringify({
+            text: buildFallbackText(payload),
+            blocks: buildBlocks(payload),
+        });
+        const response = await fetch(this.webhookUrl, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body,
+        });
+        if (!response.ok) {
+            const responseBody = await response.text().catch(() => "");
+            throw new ProviderApiError("Slack", response.status, response.statusText, responseBody);
+        }
+        this.log.info("Slack notification sent");
+    }
+}
+//# sourceMappingURL=slack-webhook.js.map

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

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

package/dist/notification/teams-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 teamsWebhookConfigSchema: 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 TeamsWebhookConfig = z.infer<typeof teamsWebhookConfigSchema>;
+export declare function teamsWebhook(config: TeamsWebhookConfig): NotificationProvider;
+//# sourceMappingURL=teams-webhook.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"teams-webhook.d.ts","sourceRoot":"","sources":["../../src/notification/teams-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,wBAAwB;;;;;;;;;EAGnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,wBAAgB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,oBAAoB,CAG7E"}

package/dist/notification/teams-webhook.js

@@ -0,0 +1,125 @@
+import { z } from "zod";
+import { consoleLogger } from "../logger.js";
+import { ProviderApiError } from "../errors.js";
+export const teamsWebhookConfigSchema = z.object({
+    webhookUrl: z.string().url("Teams webhook URL is required"),
+    logger: z.custom().optional(),
+});
+export function teamsWebhook(config) {
+    const parsed = teamsWebhookConfigSchema.parse(config);
+    return new TeamsWebhookProvider(parsed);
+}
+// ---------------------------------------------------------------------------
+// Adaptive Card helpers
+// ---------------------------------------------------------------------------
+const STATUS_EMOJI = {
+    success: "✅",
+    error: "❌",
+    warning: "⚠️",
+    info: "ℹ️",
+    skipped: "⏭️",
+};
+function buildAdaptiveCard(payload) {
+    const body = [];
+    const actions = [];
+    // Title
+    if (payload.title) {
+        body.push({
+            type: "TextBlock",
+            text: payload.title,
+            weight: "Bolder",
+            size: "Medium",
+        });
+    }
+    // Status summary
+    if (payload.status || payload.summary) {
+        const emoji = payload.status ? STATUS_EMOJI[payload.status] : "📋";
+        const text = payload.summary ? `${emoji} ${payload.summary}` : emoji;
+        body.push({
+            type: "TextBlock",
+            text,
+            wrap: true,
+            color: payload.status === "success"
+                ? "Good"
+                : payload.status === "error"
+                    ? "Attention"
+                    : payload.status === "warning"
+                        ? "Warning"
+                        : "Default",
+        });
+    }
+    // Metadata as FactSet
+    if (payload.fields?.length) {
+        body.push({
+            type: "FactSet",
+            facts: payload.fields.map((f) => ({ title: f.label, value: f.value })),
+        });
+    }
+    // Content sections
+    for (const section of payload.sections ?? []) {
+        body.push({
+            type: "Container",
+            separator: true,
+            items: [
+                ...(section.title ? [{ type: "TextBlock", text: section.title, weight: "Bolder", wrap: true }] : []),
+                { type: "TextBlock", text: section.content.slice(0, 3000), wrap: true },
+            ],
+        });
+    }
+    // If no structured content, fall back to body TextBlock
+    if (!payload.fields?.length && !payload.status && !payload.summary && !payload.sections?.length) {
+        body.push({
+            type: "TextBlock",
+            text: payload.body,
+            wrap: true,
+        });
+    }
+    // Action links
+    for (const link of payload.links ?? []) {
+        actions.push({
+            type: "Action.OpenUrl",
+            title: link.label,
+            url: link.url,
+        });
+    }
+    return {
+        $schema: "http://adaptivecards.io/schemas/adaptive-card.json",
+        type: "AdaptiveCard",
+        version: "1.4",
+        body,
+        ...(actions.length ? { actions } : {}),
+    };
+}
+// ---------------------------------------------------------------------------
+// Provider
+// ---------------------------------------------------------------------------
+class TeamsWebhookProvider {
+    webhookUrl;
+    log;
+    constructor(config) {
+        this.webhookUrl = config.webhookUrl;
+        this.log = config.logger ?? consoleLogger;
+    }
+    async send(payload) {
+        const card = {
+            type: "message",
+            attachments: [
+                {
+                    contentType: "application/vnd.microsoft.card.adaptive",
+                    content: buildAdaptiveCard(payload),
+                },
+            ],
+        };
+        const response = await fetch(this.webhookUrl, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(card),
+        });
+        if (!response.ok) {
+            const body = await response.text().catch(() => "");
+            throw new ProviderApiError("Teams", response.status, response.statusText, body);
+        }
+        this.log.info("Teams notification sent");
+    }
+}
+//# sourceMappingURL=teams-webhook.js.map

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

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

package/dist/notification/types.d.ts

@@ -0,0 +1,47 @@
+/** Overall status level for a notification. */
+export type NotificationStatus = "success" | "error" | "warning" | "info" | "skipped";
+/** A key-value metadata field. */
+export interface NotificationField {
+    label: string;
+    value: string;
+    /** Hint to render inline/side-by-side when the channel supports it. */
+    short?: boolean;
+}
+/** A named content section (e.g. investigation log, issues report). */
+export interface NotificationSection {
+    title?: string;
+    content: string;
+}
+/** An actionable link rendered as a button or hyperlink. */
+export interface NotificationLink {
+    label: string;
+    url: string;
+}
+/** Payload for sending a notification. */
+export interface NotificationPayload {
+    /** Optional notification title. */
+    title?: string;
+    /** Notification body content — flat markdown fallback for all providers. */
+    body: string;
+    /** Content format (defaults to provider-specific default). */
+    format?: "markdown" | "html" | "text";
+    /** Overall outcome — drives status indicators, colors, and emoji. */
+    status?: NotificationStatus;
+    /** One-line human-readable status summary (e.g. "Success: PR #42 created"). */
+    summary?: string;
+    /** Key-value metadata fields (e.g. Service Filter, Time Range). */
+    fields?: NotificationField[];
+    /** Named content sections appended after the metadata (e.g. investigation log). */
+    sections?: NotificationSection[];
+    /** Actionable links rendered as buttons or hyperlinks. */
+    links?: NotificationLink[];
+}
+/** Provider interface for sending notifications. */
+export interface NotificationProvider {
+    /**
+     * Send a notification.
+     * @param payload - The notification content to send.
+     */
+    send(payload: NotificationPayload): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/notification/types.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;AAEtF,kCAAkC;AAClC,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,uEAAuE;AACvE,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,4DAA4D;AAC5D,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,0CAA0C;AAC1C,MAAM,WAAW,mBAAmB;IAClC,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;IAQtC,qEAAqE;IACrE,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,MAAM,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC7B,mFAAmF;IACnF,QAAQ,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACjC,0DAA0D;IAC1D,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AAED,oDAAoD;AACpD,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD"}

package/dist/notification/types.js

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

package/dist/notification/types.js.map

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

package/dist/notification/webhook.d.ts

@@ -0,0 +1,28 @@
+import { z } from "zod";
+import type { Logger } from "../logger.js";
+import type { NotificationProvider } from "./types.js";
+export declare const webhookConfigSchema: z.ZodObject<{
+    url: z.ZodString;
+    /** Extra headers merged into the request (e.g., Authorization). */
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    /** HTTP method — defaults to POST. */
+    method: z.ZodDefault<z.ZodEnum<["POST", "PUT"]>>;
+    /** Optional HMAC secret for signing the payload (X-Signature-256 header). */
+    signingSecret: z.ZodOptional<z.ZodString>;
+    logger: z.ZodOptional<z.ZodType<Logger, z.ZodTypeDef, Logger>>;
+}, "strip", z.ZodTypeAny, {
+    method: "POST" | "PUT";
+    url: string;
+    logger?: Logger | undefined;
+    headers?: Record<string, string> | undefined;
+    signingSecret?: string | undefined;
+}, {
+    url: string;
+    logger?: Logger | undefined;
+    method?: "POST" | "PUT" | undefined;
+    headers?: Record<string, string> | undefined;
+    signingSecret?: string | undefined;
+}>;
+export type WebhookConfig = z.input<typeof webhookConfigSchema>;
+export declare function webhook(config: WebhookConfig): NotificationProvider;
+//# sourceMappingURL=webhook.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../../src/notification/webhook.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C,OAAO,KAAK,EAAE,oBAAoB,EAAuB,MAAM,YAAY,CAAC;AAE5E,eAAO,MAAM,mBAAmB;;IAE9B,mEAAmE;;IAEnE,sCAAsC;;IAEtC,6EAA6E;;;;;;;;;;;;;;;EAG7E,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,wBAAgB,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,oBAAoB,CAGnE"}

package/dist/notification/webhook.js

@@ -0,0 +1,64 @@
+import { createHmac } from "node:crypto";
+import { z } from "zod";
+import { consoleLogger } from "../logger.js";
+import { ProviderApiError } from "../errors.js";
+export const webhookConfigSchema = z.object({
+    url: z.string().url("Webhook URL is required"),
+    /** Extra headers merged into the request (e.g., Authorization). */
+    headers: z.record(z.string()).optional(),
+    /** HTTP method — defaults to POST. */
+    method: z.enum(["POST", "PUT"]).default("POST"),
+    /** Optional HMAC secret for signing the payload (X-Signature-256 header). */
+    signingSecret: z.string().optional(),
+    logger: z.custom().optional(),
+});
+export function webhook(config) {
+    const parsed = webhookConfigSchema.parse(config);
+    return new WebhookProvider(parsed);
+}
+class WebhookProvider {
+    url;
+    headers;
+    method;
+    signingSecret;
+    log;
+    constructor(config) {
+        this.url = config.url;
+        this.headers = config.headers ?? {};
+        this.method = config.method;
+        this.signingSecret = config.signingSecret;
+        this.log = config.logger ?? consoleLogger;
+    }
+    async send(payload) {
+        const jsonBody = JSON.stringify({
+            title: payload.title,
+            body: payload.body,
+            format: payload.format,
+            status: payload.status,
+            summary: payload.summary,
+            fields: payload.fields,
+            sections: payload.sections,
+            links: payload.links,
+            timestamp: new Date().toISOString(),
+        });
+        const headers = {
+            "Content-Type": "application/json",
+            ...this.headers,
+        };
+        if (this.signingSecret) {
+            const signature = createHmac("sha256", this.signingSecret).update(jsonBody).digest("hex");
+            headers["X-Signature-256"] = `sha256=${signature}`;
+        }
+        const response = await fetch(this.url, {
+            method: this.method,
+            headers,
+            body: jsonBody,
+        });
+        if (!response.ok) {
+            const body = await response.text().catch(() => undefined);
+            throw new ProviderApiError("webhook", response.status, response.statusText, body);
+        }
+        this.log.info(`Webhook notification sent to ${this.url}`);
+    }
+}
+//# sourceMappingURL=webhook.js.map

package/dist/notification/webhook.js.map

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

package/dist/observability/cloudwatch.d.ts

@@ -0,0 +1,19 @@
+import { z } from "zod";
+import type { Logger } from "../logger.js";
+import type { ObservabilityProvider } from "./types.js";
+export declare const cloudwatchConfigSchema: z.ZodObject<{
+    region: z.ZodDefault<z.ZodString>;
+    logGroupPrefix: z.ZodString;
+    logger: z.ZodOptional<z.ZodType<Logger, z.ZodTypeDef, Logger>>;
+}, "strip", z.ZodTypeAny, {
+    region: string;
+    logGroupPrefix: string;
+    logger?: Logger | undefined;
+}, {
+    logGroupPrefix: string;
+    logger?: Logger | undefined;
+    region?: string | undefined;
+}>;
+export type CloudWatchConfig = z.infer<typeof cloudwatchConfigSchema>;
+export declare function cloudwatch(config: CloudWatchConfig): ObservabilityProvider;
+//# sourceMappingURL=cloudwatch.d.ts.map

package/dist/observability/cloudwatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudwatch.d.ts","sourceRoot":"","sources":["../../src/observability/cloudwatch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C,OAAO,KAAK,EAAE,qBAAqB,EAA8C,MAAM,YAAY,CAAC;AAEpG,eAAO,MAAM,sBAAsB;;;;;;;;;;;;EAIjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,wBAAgB,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,qBAAqB,CAG1E"}