@appbuildersph/notifications 0.0.1

package/README.md

@@ -0,0 +1,39 @@
+# @appbuildersph/notifications
+
+Notification center for the App Builders PH SDK — one call fans out to every
+configured channel, with per-type routing and in-memory history for the dashboard.
+
+## Types
+
+`success`, `information`, `warning`, `critical`, `security`, `performance`,
+`deployment`, `incident`, `ai-recommendation` — each has a convenience method
+(`center.security(...)`) alongside the generic `notify(type, title, message, context?)`.
+
+## Channels
+
+- `WebhookChannel` — posts the raw notification as JSON
+- `SlackChannel` / `DiscordChannel` / `TeamsChannel` / `TelegramChannel` — formatted for each platform's webhook/bot API
+- `ToastChannel` — in-process pub/sub (no network I/O) for the badge/dashboard UI to subscribe to
+
+## Usage
+
+```ts
+import { NotificationCenter, SlackChannel, ToastChannel } from "@appbuildersph/notifications";
+
+const toast = new ToastChannel();
+const center = new NotificationCenter({
+  channels: [toast, new SlackChannel({ webhookUrl: process.env.SLACK_WEBHOOK_URL! })],
+  routing: {
+    security: [new SlackChannel({ webhookUrl: process.env.SECURITY_SLACK_WEBHOOK_URL! })],
+  },
+  onError: (error, channel) => logger.error(`notification delivery failed via ${channel.name}`, { error }),
+});
+
+toast.subscribe((notification) => renderToast(notification));
+
+await center.incident("Payment webhook failing", "5 consecutive 500s from /webhooks/stripe");
+center.getHistory("incident");
+```
+
+Wire `Watcher`'s `onIncident` hook into `center.incident(...)` to get automatic
+crash/incident alerts across every configured channel.

package/dist/index.cjs

@@ -0,0 +1,228 @@
+'use strict';
+
+var crypto = require('crypto');
+
+// src/notification-center.ts
+var NotificationCenter = class {
+  channels;
+  historySize;
+  routing;
+  onError;
+  history = [];
+  constructor(options = {}) {
+    this.channels = options.channels ?? [];
+    this.historySize = options.historySize ?? 500;
+    this.routing = options.routing ?? {};
+    this.onError = options.onError;
+  }
+  addChannel(channel) {
+    this.channels.push(channel);
+  }
+  async notify(type, title, message, context) {
+    const notification = {
+      id: crypto.randomUUID(),
+      type,
+      title,
+      message,
+      context,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    this.history.push(notification);
+    if (this.history.length > this.historySize) this.history.shift();
+    const targets = this.routing[type] ?? this.channels;
+    await Promise.all(
+      targets.map(async (channel) => {
+        try {
+          await channel.send(notification);
+        } catch (error) {
+          this.onError?.(error, channel, notification);
+        }
+      })
+    );
+    return notification;
+  }
+  success(title, message, context) {
+    return this.notify("success", title, message, context);
+  }
+  information(title, message, context) {
+    return this.notify("information", title, message, context);
+  }
+  warning(title, message, context) {
+    return this.notify("warning", title, message, context);
+  }
+  critical(title, message, context) {
+    return this.notify("critical", title, message, context);
+  }
+  security(title, message, context) {
+    return this.notify("security", title, message, context);
+  }
+  performance(title, message, context) {
+    return this.notify("performance", title, message, context);
+  }
+  deployment(title, message, context) {
+    return this.notify("deployment", title, message, context);
+  }
+  incident(title, message, context) {
+    return this.notify("incident", title, message, context);
+  }
+  aiRecommendation(title, message, context) {
+    return this.notify("ai-recommendation", title, message, context);
+  }
+  getHistory(type) {
+    return type ? this.history.filter((n) => n.type === type) : [...this.history];
+  }
+  clearHistory() {
+    this.history = [];
+  }
+};
+
+// src/http.ts
+async function postJson(url, body) {
+  const response = await fetch(url, {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify(body)
+  });
+  if (!response.ok) {
+    throw new Error(`Notification delivery to ${url} failed with status ${response.status}`);
+  }
+}
+
+// src/channels/webhook.ts
+var WebhookChannel = class {
+  constructor(options) {
+    this.options = options;
+  }
+  options;
+  name = "webhook";
+  async send(notification) {
+    await postJson(this.options.url, notification);
+  }
+};
+
+// src/format.ts
+var EMOJI = {
+  success: "\u2705",
+  information: "\u2139\uFE0F",
+  warning: "\u26A0\uFE0F",
+  critical: "\u{1F6A8}",
+  security: "\u{1F6E1}\uFE0F",
+  performance: "\u26A1",
+  deployment: "\u{1F680}",
+  incident: "\u{1F525}",
+  "ai-recommendation": "\u{1F916}"
+};
+var COLOR_HEX = {
+  success: "2ECC71",
+  information: "3498DB",
+  warning: "F39C12",
+  critical: "E74C3C",
+  security: "9B59B6",
+  performance: "1ABC9C",
+  deployment: "2980B9",
+  incident: "C0392B",
+  "ai-recommendation": "8E44AD"
+};
+function emojiFor(type) {
+  return EMOJI[type];
+}
+function colorHexFor(type) {
+  return COLOR_HEX[type];
+}
+function colorIntFor(type) {
+  return parseInt(COLOR_HEX[type], 16);
+}
+
+// src/channels/slack.ts
+var SlackChannel = class {
+  constructor(options) {
+    this.options = options;
+  }
+  options;
+  name = "slack";
+  async send(notification) {
+    await postJson(this.options.webhookUrl, {
+      text: `${emojiFor(notification.type)} *${notification.title}*
+${notification.message}`
+    });
+  }
+};
+
+// src/channels/discord.ts
+var DiscordChannel = class {
+  constructor(options) {
+    this.options = options;
+  }
+  options;
+  name = "discord";
+  async send(notification) {
+    await postJson(this.options.webhookUrl, {
+      embeds: [
+        {
+          title: `${emojiFor(notification.type)} ${notification.title}`,
+          description: notification.message,
+          color: colorIntFor(notification.type),
+          timestamp: notification.timestamp
+        }
+      ]
+    });
+  }
+};
+
+// src/channels/teams.ts
+var TeamsChannel = class {
+  constructor(options) {
+    this.options = options;
+  }
+  options;
+  name = "teams";
+  async send(notification) {
+    await postJson(this.options.webhookUrl, {
+      "@type": "MessageCard",
+      "@context": "http://schema.org/extensions",
+      themeColor: colorHexFor(notification.type),
+      title: `${emojiFor(notification.type)} ${notification.title}`,
+      text: notification.message
+    });
+  }
+};
+
+// src/channels/telegram.ts
+var TelegramChannel = class {
+  constructor(options) {
+    this.options = options;
+  }
+  options;
+  name = "telegram";
+  async send(notification) {
+    const url = `https://api.telegram.org/bot${this.options.botToken}/sendMessage`;
+    await postJson(url, {
+      chat_id: this.options.chatId,
+      text: `${emojiFor(notification.type)} ${notification.title}
+${notification.message}`
+    });
+  }
+};
+
+// src/channels/toast.ts
+var ToastChannel = class {
+  name = "toast";
+  listeners = /* @__PURE__ */ new Set();
+  subscribe(listener) {
+    this.listeners.add(listener);
+    return () => this.listeners.delete(listener);
+  }
+  send(notification) {
+    for (const listener of this.listeners) listener(notification);
+  }
+};
+
+exports.DiscordChannel = DiscordChannel;
+exports.NotificationCenter = NotificationCenter;
+exports.SlackChannel = SlackChannel;
+exports.TeamsChannel = TeamsChannel;
+exports.TelegramChannel = TelegramChannel;
+exports.ToastChannel = ToastChannel;
+exports.WebhookChannel = WebhookChannel;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/notification-center.ts","../src/http.ts","../src/channels/webhook.ts","../src/format.ts","../src/channels/slack.ts","../src/channels/discord.ts","../src/channels/teams.ts","../src/channels/telegram.ts","../src/channels/toast.ts"],"names":["randomUUID"],"mappings":"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","file":"index.cjs","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport type { Channel, Notification, NotificationType } from \"./types.js\";\n\nexport interface NotificationCenterOptions {\n  channels?: Channel[];\n  /** Number of notifications kept in memory for the dashboard/history query. Default 500. */\n  historySize?: number;\n  /** Only these types are dispatched to channels. Default: all types. */\n  routing?: Partial<Record<NotificationType, Channel[]>>;\n  onError?: (error: unknown, channel: Channel, notification: Notification) => void;\n}\n\nexport class NotificationCenter {\n  private readonly channels: Channel[];\n  private readonly historySize: number;\n  private readonly routing: Partial<Record<NotificationType, Channel[]>>;\n  private readonly onError?: NotificationCenterOptions[\"onError\"];\n  private history: Notification[] = [];\n\n  constructor(options: NotificationCenterOptions = {}) {\n    this.channels = options.channels ?? [];\n    this.historySize = options.historySize ?? 500;\n    this.routing = options.routing ?? {};\n    this.onError = options.onError;\n  }\n\n  addChannel(channel: Channel): void {\n    this.channels.push(channel);\n  }\n\n  async notify(\n    type: NotificationType,\n    title: string,\n    message: string,\n    context?: Record<string, unknown>,\n  ): Promise<Notification> {\n    const notification: Notification = {\n      id: randomUUID(),\n      type,\n      title,\n      message,\n      context,\n      timestamp: new Date().toISOString(),\n    };\n\n    this.history.push(notification);\n    if (this.history.length > this.historySize) this.history.shift();\n\n    const targets = this.routing[type] ?? this.channels;\n    await Promise.all(\n      targets.map(async (channel) => {\n        try {\n          await channel.send(notification);\n        } catch (error) {\n          this.onError?.(error, channel, notification);\n        }\n      }),\n    );\n\n    return notification;\n  }\n\n  success(title: string, message: string, context?: Record<string, unknown>) {\n    return this.notify(\"success\", title, message, context);\n  }\n  information(title: string, message: string, context?: Record<string, unknown>) {\n    return this.notify(\"information\", title, message, context);\n  }\n  warning(title: string, message: string, context?: Record<string, unknown>) {\n    return this.notify(\"warning\", title, message, context);\n  }\n  critical(title: string, message: string, context?: Record<string, unknown>) {\n    return this.notify(\"critical\", title, message, context);\n  }\n  security(title: string, message: string, context?: Record<string, unknown>) {\n    return this.notify(\"security\", title, message, context);\n  }\n  performance(title: string, message: string, context?: Record<string, unknown>) {\n    return this.notify(\"performance\", title, message, context);\n  }\n  deployment(title: string, message: string, context?: Record<string, unknown>) {\n    return this.notify(\"deployment\", title, message, context);\n  }\n  incident(title: string, message: string, context?: Record<string, unknown>) {\n    return this.notify(\"incident\", title, message, context);\n  }\n  aiRecommendation(title: string, message: string, context?: Record<string, unknown>) {\n    return this.notify(\"ai-recommendation\", title, message, context);\n  }\n\n  getHistory(type?: NotificationType): Notification[] {\n    return type ? this.history.filter((n) => n.type === type) : [...this.history];\n  }\n\n  clearHistory(): void {\n    this.history = [];\n  }\n}\n","export async function postJson(url: string, body: unknown): Promise<void> {\n  const response = await fetch(url, {\n    method: \"POST\",\n    headers: { \"content-type\": \"application/json\" },\n    body: JSON.stringify(body),\n  });\n\n  if (!response.ok) {\n    throw new Error(`Notification delivery to ${url} failed with status ${response.status}`);\n  }\n}\n","import { postJson } from \"../http.js\";\nimport type { Channel, Notification } from \"../types.js\";\n\nexport interface WebhookChannelOptions {\n  url: string;\n}\n\n/** Posts the raw notification payload as JSON — for custom/internal receivers. */\nexport class WebhookChannel implements Channel {\n  readonly name = \"webhook\";\n  constructor(private readonly options: WebhookChannelOptions) {}\n\n  async send(notification: Notification): Promise<void> {\n    await postJson(this.options.url, notification);\n  }\n}\n","import type { NotificationType } from \"./types.js\";\n\nconst EMOJI: Record<NotificationType, string> = {\n  success: \"✅\",\n  information: \"ℹ️\",\n  warning: \"⚠️\",\n  critical: \"🚨\",\n  security: \"🛡️\",\n  performance: \"⚡\",\n  deployment: \"🚀\",\n  incident: \"🔥\",\n  \"ai-recommendation\": \"🤖\",\n};\n\nconst COLOR_HEX: Record<NotificationType, string> = {\n  success: \"2ECC71\",\n  information: \"3498DB\",\n  warning: \"F39C12\",\n  critical: \"E74C3C\",\n  security: \"9B59B6\",\n  performance: \"1ABC9C\",\n  deployment: \"2980B9\",\n  incident: \"C0392B\",\n  \"ai-recommendation\": \"8E44AD\",\n};\n\nexport function emojiFor(type: NotificationType): string {\n  return EMOJI[type];\n}\n\nexport function colorHexFor(type: NotificationType): string {\n  return COLOR_HEX[type];\n}\n\nexport function colorIntFor(type: NotificationType): number {\n  return parseInt(COLOR_HEX[type], 16);\n}\n","import { emojiFor } from \"../format.js\";\nimport { postJson } from \"../http.js\";\nimport type { Channel, Notification } from \"../types.js\";\n\nexport interface SlackChannelOptions {\n  webhookUrl: string;\n}\n\nexport class SlackChannel implements Channel {\n  readonly name = \"slack\";\n  constructor(private readonly options: SlackChannelOptions) {}\n\n  async send(notification: Notification): Promise<void> {\n    await postJson(this.options.webhookUrl, {\n      text: `${emojiFor(notification.type)} *${notification.title}*\\n${notification.message}`,\n    });\n  }\n}\n","import { colorIntFor, emojiFor } from \"../format.js\";\nimport { postJson } from \"../http.js\";\nimport type { Channel, Notification } from \"../types.js\";\n\nexport interface DiscordChannelOptions {\n  webhookUrl: string;\n}\n\nexport class DiscordChannel implements Channel {\n  readonly name = \"discord\";\n  constructor(private readonly options: DiscordChannelOptions) {}\n\n  async send(notification: Notification): Promise<void> {\n    await postJson(this.options.webhookUrl, {\n      embeds: [\n        {\n          title: `${emojiFor(notification.type)} ${notification.title}`,\n          description: notification.message,\n          color: colorIntFor(notification.type),\n          timestamp: notification.timestamp,\n        },\n      ],\n    });\n  }\n}\n","import { colorHexFor, emojiFor } from \"../format.js\";\nimport { postJson } from \"../http.js\";\nimport type { Channel, Notification } from \"../types.js\";\n\nexport interface TeamsChannelOptions {\n  webhookUrl: string;\n}\n\nexport class TeamsChannel implements Channel {\n  readonly name = \"teams\";\n  constructor(private readonly options: TeamsChannelOptions) {}\n\n  async send(notification: Notification): Promise<void> {\n    await postJson(this.options.webhookUrl, {\n      \"@type\": \"MessageCard\",\n      \"@context\": \"http://schema.org/extensions\",\n      themeColor: colorHexFor(notification.type),\n      title: `${emojiFor(notification.type)} ${notification.title}`,\n      text: notification.message,\n    });\n  }\n}\n","import { emojiFor } from \"../format.js\";\nimport { postJson } from \"../http.js\";\nimport type { Channel, Notification } from \"../types.js\";\n\nexport interface TelegramChannelOptions {\n  botToken: string;\n  chatId: string;\n}\n\nexport class TelegramChannel implements Channel {\n  readonly name = \"telegram\";\n  constructor(private readonly options: TelegramChannelOptions) {}\n\n  async send(notification: Notification): Promise<void> {\n    const url = `https://api.telegram.org/bot${this.options.botToken}/sendMessage`;\n    await postJson(url, {\n      chat_id: this.options.chatId,\n      text: `${emojiFor(notification.type)} ${notification.title}\\n${notification.message}`,\n    });\n  }\n}\n","import type { Channel, Notification } from \"../types.js\";\n\nexport type ToastListener = (notification: Notification) => void;\n\n/**\n * In-process channel for UI surfaces (badge/dashboard) to subscribe to and render\n * as toasts. No network I/O — just an in-memory pub/sub.\n */\nexport class ToastChannel implements Channel {\n  readonly name = \"toast\";\n  private readonly listeners = new Set<ToastListener>();\n\n  subscribe(listener: ToastListener): () => void {\n    this.listeners.add(listener);\n    return () => this.listeners.delete(listener);\n  }\n\n  send(notification: Notification): void {\n    for (const listener of this.listeners) listener(notification);\n  }\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,109 @@
+type NotificationType = "success" | "information" | "warning" | "critical" | "security" | "performance" | "deployment" | "incident" | "ai-recommendation";
+interface Notification {
+    id: string;
+    type: NotificationType;
+    title: string;
+    message: string;
+    timestamp: string;
+    context?: Record<string, unknown>;
+}
+interface Channel {
+    name: string;
+    send(notification: Notification): void | Promise<void>;
+}
+
+interface NotificationCenterOptions {
+    channels?: Channel[];
+    /** Number of notifications kept in memory for the dashboard/history query. Default 500. */
+    historySize?: number;
+    /** Only these types are dispatched to channels. Default: all types. */
+    routing?: Partial<Record<NotificationType, Channel[]>>;
+    onError?: (error: unknown, channel: Channel, notification: Notification) => void;
+}
+declare class NotificationCenter {
+    private readonly channels;
+    private readonly historySize;
+    private readonly routing;
+    private readonly onError?;
+    private history;
+    constructor(options?: NotificationCenterOptions);
+    addChannel(channel: Channel): void;
+    notify(type: NotificationType, title: string, message: string, context?: Record<string, unknown>): Promise<Notification>;
+    success(title: string, message: string, context?: Record<string, unknown>): Promise<Notification>;
+    information(title: string, message: string, context?: Record<string, unknown>): Promise<Notification>;
+    warning(title: string, message: string, context?: Record<string, unknown>): Promise<Notification>;
+    critical(title: string, message: string, context?: Record<string, unknown>): Promise<Notification>;
+    security(title: string, message: string, context?: Record<string, unknown>): Promise<Notification>;
+    performance(title: string, message: string, context?: Record<string, unknown>): Promise<Notification>;
+    deployment(title: string, message: string, context?: Record<string, unknown>): Promise<Notification>;
+    incident(title: string, message: string, context?: Record<string, unknown>): Promise<Notification>;
+    aiRecommendation(title: string, message: string, context?: Record<string, unknown>): Promise<Notification>;
+    getHistory(type?: NotificationType): Notification[];
+    clearHistory(): void;
+}
+
+interface WebhookChannelOptions {
+    url: string;
+}
+/** Posts the raw notification payload as JSON — for custom/internal receivers. */
+declare class WebhookChannel implements Channel {
+    private readonly options;
+    readonly name = "webhook";
+    constructor(options: WebhookChannelOptions);
+    send(notification: Notification): Promise<void>;
+}
+
+interface SlackChannelOptions {
+    webhookUrl: string;
+}
+declare class SlackChannel implements Channel {
+    private readonly options;
+    readonly name = "slack";
+    constructor(options: SlackChannelOptions);
+    send(notification: Notification): Promise<void>;
+}
+
+interface DiscordChannelOptions {
+    webhookUrl: string;
+}
+declare class DiscordChannel implements Channel {
+    private readonly options;
+    readonly name = "discord";
+    constructor(options: DiscordChannelOptions);
+    send(notification: Notification): Promise<void>;
+}
+
+interface TeamsChannelOptions {
+    webhookUrl: string;
+}
+declare class TeamsChannel implements Channel {
+    private readonly options;
+    readonly name = "teams";
+    constructor(options: TeamsChannelOptions);
+    send(notification: Notification): Promise<void>;
+}
+
+interface TelegramChannelOptions {
+    botToken: string;
+    chatId: string;
+}
+declare class TelegramChannel implements Channel {
+    private readonly options;
+    readonly name = "telegram";
+    constructor(options: TelegramChannelOptions);
+    send(notification: Notification): Promise<void>;
+}
+
+type ToastListener = (notification: Notification) => void;
+/**
+ * In-process channel for UI surfaces (badge/dashboard) to subscribe to and render
+ * as toasts. No network I/O — just an in-memory pub/sub.
+ */
+declare class ToastChannel implements Channel {
+    readonly name = "toast";
+    private readonly listeners;
+    subscribe(listener: ToastListener): () => void;
+    send(notification: Notification): void;
+}
+
+export { type Channel, DiscordChannel, type Notification, NotificationCenter, type NotificationCenterOptions, type NotificationType, SlackChannel, TeamsChannel, TelegramChannel, ToastChannel, type ToastListener, WebhookChannel };

package/dist/index.d.ts

@@ -0,0 +1,109 @@
+type NotificationType = "success" | "information" | "warning" | "critical" | "security" | "performance" | "deployment" | "incident" | "ai-recommendation";
+interface Notification {
+    id: string;
+    type: NotificationType;
+    title: string;
+    message: string;
+    timestamp: string;
+    context?: Record<string, unknown>;
+}
+interface Channel {
+    name: string;
+    send(notification: Notification): void | Promise<void>;
+}
+
+interface NotificationCenterOptions {
+    channels?: Channel[];
+    /** Number of notifications kept in memory for the dashboard/history query. Default 500. */
+    historySize?: number;
+    /** Only these types are dispatched to channels. Default: all types. */
+    routing?: Partial<Record<NotificationType, Channel[]>>;
+    onError?: (error: unknown, channel: Channel, notification: Notification) => void;
+}
+declare class NotificationCenter {
+    private readonly channels;
+    private readonly historySize;
+    private readonly routing;
+    private readonly onError?;
+    private history;
+    constructor(options?: NotificationCenterOptions);
+    addChannel(channel: Channel): void;
+    notify(type: NotificationType, title: string, message: string, context?: Record<string, unknown>): Promise<Notification>;
+    success(title: string, message: string, context?: Record<string, unknown>): Promise<Notification>;
+    information(title: string, message: string, context?: Record<string, unknown>): Promise<Notification>;
+    warning(title: string, message: string, context?: Record<string, unknown>): Promise<Notification>;
+    critical(title: string, message: string, context?: Record<string, unknown>): Promise<Notification>;
+    security(title: string, message: string, context?: Record<string, unknown>): Promise<Notification>;
+    performance(title: string, message: string, context?: Record<string, unknown>): Promise<Notification>;
+    deployment(title: string, message: string, context?: Record<string, unknown>): Promise<Notification>;
+    incident(title: string, message: string, context?: Record<string, unknown>): Promise<Notification>;
+    aiRecommendation(title: string, message: string, context?: Record<string, unknown>): Promise<Notification>;
+    getHistory(type?: NotificationType): Notification[];
+    clearHistory(): void;
+}
+
+interface WebhookChannelOptions {
+    url: string;
+}
+/** Posts the raw notification payload as JSON — for custom/internal receivers. */
+declare class WebhookChannel implements Channel {
+    private readonly options;
+    readonly name = "webhook";
+    constructor(options: WebhookChannelOptions);
+    send(notification: Notification): Promise<void>;
+}
+
+interface SlackChannelOptions {
+    webhookUrl: string;
+}
+declare class SlackChannel implements Channel {
+    private readonly options;
+    readonly name = "slack";
+    constructor(options: SlackChannelOptions);
+    send(notification: Notification): Promise<void>;
+}
+
+interface DiscordChannelOptions {
+    webhookUrl: string;
+}
+declare class DiscordChannel implements Channel {
+    private readonly options;
+    readonly name = "discord";
+    constructor(options: DiscordChannelOptions);
+    send(notification: Notification): Promise<void>;
+}
+
+interface TeamsChannelOptions {
+    webhookUrl: string;
+}
+declare class TeamsChannel implements Channel {
+    private readonly options;
+    readonly name = "teams";
+    constructor(options: TeamsChannelOptions);
+    send(notification: Notification): Promise<void>;
+}
+
+interface TelegramChannelOptions {
+    botToken: string;
+    chatId: string;
+}
+declare class TelegramChannel implements Channel {
+    private readonly options;
+    readonly name = "telegram";
+    constructor(options: TelegramChannelOptions);
+    send(notification: Notification): Promise<void>;
+}
+
+type ToastListener = (notification: Notification) => void;
+/**
+ * In-process channel for UI surfaces (badge/dashboard) to subscribe to and render
+ * as toasts. No network I/O — just an in-memory pub/sub.
+ */
+declare class ToastChannel implements Channel {
+    readonly name = "toast";
+    private readonly listeners;
+    subscribe(listener: ToastListener): () => void;
+    send(notification: Notification): void;
+}
+
+export { type Channel, DiscordChannel, type Notification, NotificationCenter, type NotificationCenterOptions, type NotificationType, SlackChannel, TeamsChannel, TelegramChannel, ToastChannel, type ToastListener, WebhookChannel };

package/dist/index.js

@@ -0,0 +1,220 @@
+import { randomUUID } from 'crypto';
+
+// src/notification-center.ts
+var NotificationCenter = class {
+  channels;
+  historySize;
+  routing;
+  onError;
+  history = [];
+  constructor(options = {}) {
+    this.channels = options.channels ?? [];
+    this.historySize = options.historySize ?? 500;
+    this.routing = options.routing ?? {};
+    this.onError = options.onError;
+  }
+  addChannel(channel) {
+    this.channels.push(channel);
+  }
+  async notify(type, title, message, context) {
+    const notification = {
+      id: randomUUID(),
+      type,
+      title,
+      message,
+      context,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    this.history.push(notification);
+    if (this.history.length > this.historySize) this.history.shift();
+    const targets = this.routing[type] ?? this.channels;
+    await Promise.all(
+      targets.map(async (channel) => {
+        try {
+          await channel.send(notification);
+        } catch (error) {
+          this.onError?.(error, channel, notification);
+        }
+      })
+    );
+    return notification;
+  }
+  success(title, message, context) {
+    return this.notify("success", title, message, context);
+  }
+  information(title, message, context) {
+    return this.notify("information", title, message, context);
+  }
+  warning(title, message, context) {
+    return this.notify("warning", title, message, context);
+  }
+  critical(title, message, context) {
+    return this.notify("critical", title, message, context);
+  }
+  security(title, message, context) {
+    return this.notify("security", title, message, context);
+  }
+  performance(title, message, context) {
+    return this.notify("performance", title, message, context);
+  }
+  deployment(title, message, context) {
+    return this.notify("deployment", title, message, context);
+  }
+  incident(title, message, context) {
+    return this.notify("incident", title, message, context);
+  }
+  aiRecommendation(title, message, context) {
+    return this.notify("ai-recommendation", title, message, context);
+  }
+  getHistory(type) {
+    return type ? this.history.filter((n) => n.type === type) : [...this.history];
+  }
+  clearHistory() {
+    this.history = [];
+  }
+};
+
+// src/http.ts
+async function postJson(url, body) {
+  const response = await fetch(url, {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify(body)
+  });
+  if (!response.ok) {
+    throw new Error(`Notification delivery to ${url} failed with status ${response.status}`);
+  }
+}
+
+// src/channels/webhook.ts
+var WebhookChannel = class {
+  constructor(options) {
+    this.options = options;
+  }
+  options;
+  name = "webhook";
+  async send(notification) {
+    await postJson(this.options.url, notification);
+  }
+};
+
+// src/format.ts
+var EMOJI = {
+  success: "\u2705",
+  information: "\u2139\uFE0F",
+  warning: "\u26A0\uFE0F",
+  critical: "\u{1F6A8}",
+  security: "\u{1F6E1}\uFE0F",
+  performance: "\u26A1",
+  deployment: "\u{1F680}",
+  incident: "\u{1F525}",
+  "ai-recommendation": "\u{1F916}"
+};
+var COLOR_HEX = {
+  success: "2ECC71",
+  information: "3498DB",
+  warning: "F39C12",
+  critical: "E74C3C",
+  security: "9B59B6",
+  performance: "1ABC9C",
+  deployment: "2980B9",
+  incident: "C0392B",
+  "ai-recommendation": "8E44AD"
+};
+function emojiFor(type) {
+  return EMOJI[type];
+}
+function colorHexFor(type) {
+  return COLOR_HEX[type];
+}
+function colorIntFor(type) {
+  return parseInt(COLOR_HEX[type], 16);
+}
+
+// src/channels/slack.ts
+var SlackChannel = class {
+  constructor(options) {
+    this.options = options;
+  }
+  options;
+  name = "slack";
+  async send(notification) {
+    await postJson(this.options.webhookUrl, {
+      text: `${emojiFor(notification.type)} *${notification.title}*
+${notification.message}`
+    });
+  }
+};
+
+// src/channels/discord.ts
+var DiscordChannel = class {
+  constructor(options) {
+    this.options = options;
+  }
+  options;
+  name = "discord";
+  async send(notification) {
+    await postJson(this.options.webhookUrl, {
+      embeds: [
+        {
+          title: `${emojiFor(notification.type)} ${notification.title}`,
+          description: notification.message,
+          color: colorIntFor(notification.type),
+          timestamp: notification.timestamp
+        }
+      ]
+    });
+  }
+};
+
+// src/channels/teams.ts
+var TeamsChannel = class {
+  constructor(options) {
+    this.options = options;
+  }
+  options;
+  name = "teams";
+  async send(notification) {
+    await postJson(this.options.webhookUrl, {
+      "@type": "MessageCard",
+      "@context": "http://schema.org/extensions",
+      themeColor: colorHexFor(notification.type),
+      title: `${emojiFor(notification.type)} ${notification.title}`,
+      text: notification.message
+    });
+  }
+};
+
+// src/channels/telegram.ts
+var TelegramChannel = class {
+  constructor(options) {
+    this.options = options;
+  }
+  options;
+  name = "telegram";
+  async send(notification) {
+    const url = `https://api.telegram.org/bot${this.options.botToken}/sendMessage`;
+    await postJson(url, {
+      chat_id: this.options.chatId,
+      text: `${emojiFor(notification.type)} ${notification.title}
+${notification.message}`
+    });
+  }
+};
+
+// src/channels/toast.ts
+var ToastChannel = class {
+  name = "toast";
+  listeners = /* @__PURE__ */ new Set();
+  subscribe(listener) {
+    this.listeners.add(listener);
+    return () => this.listeners.delete(listener);
+  }
+  send(notification) {
+    for (const listener of this.listeners) listener(notification);
+  }
+};
+
+export { DiscordChannel, NotificationCenter, SlackChannel, TeamsChannel, TelegramChannel, ToastChannel, WebhookChannel };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/notification-center.ts","../src/http.ts","../src/channels/webhook.ts","../src/format.ts","../src/channels/slack.ts","../src/channels/discord.ts","../src/channels/teams.ts","../src/channels/telegram.ts","../src/channels/toast.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport type { Channel, Notification, NotificationType } from \"./types.js\";\n\nexport interface NotificationCenterOptions {\n  channels?: Channel[];\n  /** Number of notifications kept in memory for the dashboard/history query. Default 500. */\n  historySize?: number;\n  /** Only these types are dispatched to channels. Default: all types. */\n  routing?: Partial<Record<NotificationType, Channel[]>>;\n  onError?: (error: unknown, channel: Channel, notification: Notification) => void;\n}\n\nexport class NotificationCenter {\n  private readonly channels: Channel[];\n  private readonly historySize: number;\n  private readonly routing: Partial<Record<NotificationType, Channel[]>>;\n  private readonly onError?: NotificationCenterOptions[\"onError\"];\n  private history: Notification[] = [];\n\n  constructor(options: NotificationCenterOptions = {}) {\n    this.channels = options.channels ?? [];\n    this.historySize = options.historySize ?? 500;\n    this.routing = options.routing ?? {};\n    this.onError = options.onError;\n  }\n\n  addChannel(channel: Channel): void {\n    this.channels.push(channel);\n  }\n\n  async notify(\n    type: NotificationType,\n    title: string,\n    message: string,\n    context?: Record<string, unknown>,\n  ): Promise<Notification> {\n    const notification: Notification = {\n      id: randomUUID(),\n      type,\n      title,\n      message,\n      context,\n      timestamp: new Date().toISOString(),\n    };\n\n    this.history.push(notification);\n    if (this.history.length > this.historySize) this.history.shift();\n\n    const targets = this.routing[type] ?? this.channels;\n    await Promise.all(\n      targets.map(async (channel) => {\n        try {\n          await channel.send(notification);\n        } catch (error) {\n          this.onError?.(error, channel, notification);\n        }\n      }),\n    );\n\n    return notification;\n  }\n\n  success(title: string, message: string, context?: Record<string, unknown>) {\n    return this.notify(\"success\", title, message, context);\n  }\n  information(title: string, message: string, context?: Record<string, unknown>) {\n    return this.notify(\"information\", title, message, context);\n  }\n  warning(title: string, message: string, context?: Record<string, unknown>) {\n    return this.notify(\"warning\", title, message, context);\n  }\n  critical(title: string, message: string, context?: Record<string, unknown>) {\n    return this.notify(\"critical\", title, message, context);\n  }\n  security(title: string, message: string, context?: Record<string, unknown>) {\n    return this.notify(\"security\", title, message, context);\n  }\n  performance(title: string, message: string, context?: Record<string, unknown>) {\n    return this.notify(\"performance\", title, message, context);\n  }\n  deployment(title: string, message: string, context?: Record<string, unknown>) {\n    return this.notify(\"deployment\", title, message, context);\n  }\n  incident(title: string, message: string, context?: Record<string, unknown>) {\n    return this.notify(\"incident\", title, message, context);\n  }\n  aiRecommendation(title: string, message: string, context?: Record<string, unknown>) {\n    return this.notify(\"ai-recommendation\", title, message, context);\n  }\n\n  getHistory(type?: NotificationType): Notification[] {\n    return type ? this.history.filter((n) => n.type === type) : [...this.history];\n  }\n\n  clearHistory(): void {\n    this.history = [];\n  }\n}\n","export async function postJson(url: string, body: unknown): Promise<void> {\n  const response = await fetch(url, {\n    method: \"POST\",\n    headers: { \"content-type\": \"application/json\" },\n    body: JSON.stringify(body),\n  });\n\n  if (!response.ok) {\n    throw new Error(`Notification delivery to ${url} failed with status ${response.status}`);\n  }\n}\n","import { postJson } from \"../http.js\";\nimport type { Channel, Notification } from \"../types.js\";\n\nexport interface WebhookChannelOptions {\n  url: string;\n}\n\n/** Posts the raw notification payload as JSON — for custom/internal receivers. */\nexport class WebhookChannel implements Channel {\n  readonly name = \"webhook\";\n  constructor(private readonly options: WebhookChannelOptions) {}\n\n  async send(notification: Notification): Promise<void> {\n    await postJson(this.options.url, notification);\n  }\n}\n","import type { NotificationType } from \"./types.js\";\n\nconst EMOJI: Record<NotificationType, string> = {\n  success: \"✅\",\n  information: \"ℹ️\",\n  warning: \"⚠️\",\n  critical: \"🚨\",\n  security: \"🛡️\",\n  performance: \"⚡\",\n  deployment: \"🚀\",\n  incident: \"🔥\",\n  \"ai-recommendation\": \"🤖\",\n};\n\nconst COLOR_HEX: Record<NotificationType, string> = {\n  success: \"2ECC71\",\n  information: \"3498DB\",\n  warning: \"F39C12\",\n  critical: \"E74C3C\",\n  security: \"9B59B6\",\n  performance: \"1ABC9C\",\n  deployment: \"2980B9\",\n  incident: \"C0392B\",\n  \"ai-recommendation\": \"8E44AD\",\n};\n\nexport function emojiFor(type: NotificationType): string {\n  return EMOJI[type];\n}\n\nexport function colorHexFor(type: NotificationType): string {\n  return COLOR_HEX[type];\n}\n\nexport function colorIntFor(type: NotificationType): number {\n  return parseInt(COLOR_HEX[type], 16);\n}\n","import { emojiFor } from \"../format.js\";\nimport { postJson } from \"../http.js\";\nimport type { Channel, Notification } from \"../types.js\";\n\nexport interface SlackChannelOptions {\n  webhookUrl: string;\n}\n\nexport class SlackChannel implements Channel {\n  readonly name = \"slack\";\n  constructor(private readonly options: SlackChannelOptions) {}\n\n  async send(notification: Notification): Promise<void> {\n    await postJson(this.options.webhookUrl, {\n      text: `${emojiFor(notification.type)} *${notification.title}*\\n${notification.message}`,\n    });\n  }\n}\n","import { colorIntFor, emojiFor } from \"../format.js\";\nimport { postJson } from \"../http.js\";\nimport type { Channel, Notification } from \"../types.js\";\n\nexport interface DiscordChannelOptions {\n  webhookUrl: string;\n}\n\nexport class DiscordChannel implements Channel {\n  readonly name = \"discord\";\n  constructor(private readonly options: DiscordChannelOptions) {}\n\n  async send(notification: Notification): Promise<void> {\n    await postJson(this.options.webhookUrl, {\n      embeds: [\n        {\n          title: `${emojiFor(notification.type)} ${notification.title}`,\n          description: notification.message,\n          color: colorIntFor(notification.type),\n          timestamp: notification.timestamp,\n        },\n      ],\n    });\n  }\n}\n","import { colorHexFor, emojiFor } from \"../format.js\";\nimport { postJson } from \"../http.js\";\nimport type { Channel, Notification } from \"../types.js\";\n\nexport interface TeamsChannelOptions {\n  webhookUrl: string;\n}\n\nexport class TeamsChannel implements Channel {\n  readonly name = \"teams\";\n  constructor(private readonly options: TeamsChannelOptions) {}\n\n  async send(notification: Notification): Promise<void> {\n    await postJson(this.options.webhookUrl, {\n      \"@type\": \"MessageCard\",\n      \"@context\": \"http://schema.org/extensions\",\n      themeColor: colorHexFor(notification.type),\n      title: `${emojiFor(notification.type)} ${notification.title}`,\n      text: notification.message,\n    });\n  }\n}\n","import { emojiFor } from \"../format.js\";\nimport { postJson } from \"../http.js\";\nimport type { Channel, Notification } from \"../types.js\";\n\nexport interface TelegramChannelOptions {\n  botToken: string;\n  chatId: string;\n}\n\nexport class TelegramChannel implements Channel {\n  readonly name = \"telegram\";\n  constructor(private readonly options: TelegramChannelOptions) {}\n\n  async send(notification: Notification): Promise<void> {\n    const url = `https://api.telegram.org/bot${this.options.botToken}/sendMessage`;\n    await postJson(url, {\n      chat_id: this.options.chatId,\n      text: `${emojiFor(notification.type)} ${notification.title}\\n${notification.message}`,\n    });\n  }\n}\n","import type { Channel, Notification } from \"../types.js\";\n\nexport type ToastListener = (notification: Notification) => void;\n\n/**\n * In-process channel for UI surfaces (badge/dashboard) to subscribe to and render\n * as toasts. No network I/O — just an in-memory pub/sub.\n */\nexport class ToastChannel implements Channel {\n  readonly name = \"toast\";\n  private readonly listeners = new Set<ToastListener>();\n\n  subscribe(listener: ToastListener): () => void {\n    this.listeners.add(listener);\n    return () => this.listeners.delete(listener);\n  }\n\n  send(notification: Notification): void {\n    for (const listener of this.listeners) listener(notification);\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@appbuildersph/notifications",
+  "version": "0.0.1",
+  "description": "Notification center for the App Builders PH SDK — multi-channel dispatch for alerts, incidents, and AI recommendations.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@appbuildersph/shared": "0.0.1"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.4"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}