@junando/webhook 0.15.1 → 0.16.1

package/dist/handler.cjs

@@ -19666,6 +19666,12 @@ let RuleEvaluationPhase = /* @__PURE__ */ function(RuleEvaluationPhase) {
 	RuleEvaluationPhase["PostLlm"] = "post-llm";
 	return RuleEvaluationPhase;
 }({});
+/** Notifier backend a logical channel resolves to */
+let ChannelType = /* @__PURE__ */ function(ChannelType) {
+	ChannelType["Slack"] = "slack";
+	ChannelType["Teams"] = "teams";
+	return ChannelType;
+}({});
 const AlertCountSchema = object({
 	min: number$1().optional(),
 	max: number$1().optional()
@@ -19715,9 +19721,19 @@ const RuleSchema = object({
 	requiresRollback: boolean$1().optional()
 });
 const RuleSectionSchema = object({ rules: array(RuleSchema).default([]) });
+const SLACK_CHANNEL_SCHEMA = object({
+	type: literal("slack"),
+	channel: string$1().startsWith("#")
+});
+const TEAMS_CHANNEL_SCHEMA = object({
+	type: literal("teams"),
+	webhookUrlEnv: string$1().min(1)
+});
+const ChannelConfigSchema = discriminatedUnion("type", [SLACK_CHANNEL_SCHEMA, TEAMS_CHANNEL_SCHEMA]);
 const RuleConfigurationSchema = object({
 	["pre-llm"]: RuleSectionSchema,
-	["post-llm"]: RuleSectionSchema
+	["post-llm"]: RuleSectionSchema,
+	channels: record(string$1(), ChannelConfigSchema).default({})
 });
 
 //#endregion
@@ -65714,6 +65730,7 @@ function sanitizeEndpointPath(endpointPath) {
 	if (!endpointPath) return "unknown";
 	return endpointPath.replaceAll("`", "").slice(0, 200);
 }
+const ROLLBACK_PROBABLE_CAUSE_MAX_LEN = 500;
 var SlackNotifier = class {
 	botToken;
 	channel;
@@ -65829,7 +65846,8 @@ var SlackNotifier = class {
 						serviceName: cluster.serviceName,
 						endpointPath: cluster.endpointPath,
 						alertType: cluster.alertType,
-						urgencyLevel: analysis.urgency_level
+						urgencyLevel: analysis.urgency_level,
+						probableCause: analysis.probable_cause.slice(0, ROLLBACK_PROBABLE_CAUSE_MAX_LEN)
 					}),
 					confirm: {
 						title: {
@@ -73526,15 +73544,52 @@ function buildNotifierRegistry(config) {
 	return registry;
 }
 /**
+* Builds the notifier for a single named channel entry from the rules YAML's
+* `channels:` section.
+*
+* @throws {Error} if the channel's backend cannot actually be reached (e.g.
+*   `type: slack` with no SLACK_BOT_TOKEN configured, or `type: teams` whose
+*   `webhookUrlEnv` is unset) — fails fast at startup rather than at delivery
+*   time, mid-incident.
+*/
+function buildChannelNotifier(name, channelConfig, config) {
+	if (channelConfig.type === "slack") {
+		if (!config.slackBotToken) {
+			throw new Error(`Channel "${name}" (type: slack) requires SLACK_BOT_TOKEN to be set`);
+		}
+		return new SlackNotifier(config.slackBotToken, channelConfig.channel);
+	}
+	const webhookUrl = process.env[channelConfig.webhookUrlEnv];
+	if (!webhookUrl) {
+		throw new Error(`Channel "${name}" (type: teams) references env var "${channelConfig.webhookUrlEnv}", which is not set`);
+	}
+	let parsedUrl;
+	try {
+		parsedUrl = new URL(webhookUrl);
+	} catch {
+		throw new Error(`Channel "${name}": ${channelConfig.webhookUrlEnv} is not a valid URL`);
+	}
+	if (!parsedUrl.searchParams.has("api-version")) {
+		throw new Error(`Channel "${name}": ${channelConfig.webhookUrlEnv} must include api-version= as a query parameter`);
+	}
+	return new TeamsNotifier(webhookUrl);
+}
+/**
 * Creates the notifier for the application.
 *
 * When `config.rulesConfigPath` is set:
 *   - Reads and validates the rules YAML config
-*   - Creates a ChannelRegistry with the default notifier as fallback
+*   - Builds a ChannelRegistry from its `channels:` section, with the default
+*     notifier as fallback
 *   - Wraps the default notifier with a RoutingNotifier for multi-channel dispatch
 *
 * When `config.rulesConfigPath` is NOT set:
 *   - Returns the default notifier directly (backward-compatible)
+*
+* @throws {Error} at startup if a rule's route/escalate action references a
+*   channel with no matching entry under `channels:` — an operator must fix
+*   the rules config rather than have the alert silently fall back to the
+*   default channel mid-incident.
 */
 function createNotifier(config) {
 	const registry = buildNotifierRegistry(config);
@@ -73543,21 +73598,24 @@ function createNotifier(config) {
 		logger$3.debug("RULES_CONFIG_PATH not set — rule engine disabled, using default notifier");
 		return defaultNotifier;
 	}
+	const yamlContent = (0, node_fs.readFileSync)(config.rulesConfigPath, "utf-8");
+	const ruleConfig = parseRuleConfig(yamlContent);
 	const channelRegistry = new ChannelRegistry();
 	channelRegistry.setDefault(defaultNotifier);
+	for (const [name, channelConfig] of Object.entries(ruleConfig.channels)) {
+		channelRegistry.register(name, buildChannelNotifier(name, channelConfig, config));
+	}
 	const unresolved = collectUnresolvedChannels(config, channelRegistry);
 	if (unresolved.length > 0) {
-		logger$3.warn({
-			channels: unresolved,
-			rulesConfigPath: config.rulesConfigPath
-		}, "Rules reference channels with no registered notifier — these will be delivered to the default channel");
+		throw new Error(`Rules reference undefined channels: ${unresolved.join(", ")}. Define them under ` + `"channels:" in ${config.rulesConfigPath}, or remove the reference.`);
 	}
 	return new RoutingNotifier(channelRegistry, defaultNotifier);
 }
 /**
 * Collect the channel names referenced by Route/Escalate actions in the rules
-* config that have no notifier registered, and would therefore fall back to the
-* default channel.
+* config that have no notifier registered against `registry` — i.e. no
+* matching entry under the rules YAML's `channels:` section. `createNotifier`
+* treats a non-empty result as a fail-fast startup error.
 *
 * Returns an empty list when no rules config is set.
 */
@@ -73568,7 +73626,7 @@ function collectUnresolvedChannels(config, registry) {
 	const yamlContent = (0, node_fs.readFileSync)(config.rulesConfigPath, "utf-8");
 	const ruleConfig = parseRuleConfig(yamlContent);
 	const referenced = new Set();
-	for (const section of Object.values(ruleConfig)) {
+	for (const section of [ruleConfig["pre-llm"], ruleConfig["post-llm"]]) {
 		for (const rule of section.rules) {
 			for (const action of rule.actions) {
 				if ("channel" in action) {
@@ -73612,6 +73670,7 @@ var NoopRollbackActionHandler = class {
 			endpointPath: request.endpointPath,
 			alertType: request.alertType,
 			urgencyLevel: request.urgencyLevel,
+			probableCause: request.probableCause,
 			triggeredBy: request.triggeredBy,
 			correlationId: request.correlationId,
 			messageTs: request.messageTs
@@ -95154,6 +95213,7 @@ var src_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({
 	AlertType: () => AlertType,
 	AlertmanagerPayloadSchema: () => AlertmanagerPayloadSchema,
 	CIRCUIT_BREAKER: () => CIRCUIT_BREAKER,
+	ChannelConfigSchema: () => ChannelConfigSchema,
 	DEDUP_TTL_MS_MULTIPLIER: () => DEDUP_TTL_MS_MULTIPLIER,
 	DEV_SERVER_PORT: () => DEV_SERVER_PORT,
 	HOUR_MS: () => HOUR_MS,
@@ -95250,7 +95310,8 @@ const RollbackButtonValueSchema = object({
 	serviceName: string$1().min(1),
 	endpointPath: string$1().min(1),
 	alertType: nativeEnum(AlertType),
-	urgencyLevel: _enum(URGENCY_LEVELS)
+	urgencyLevel: _enum(URGENCY_LEVELS),
+	probableCause: string$1().optional()
 });
 /**
 * Parses and validates the JSON value encoded in the Slack rollback button.
@@ -95279,6 +95340,7 @@ function buildRollbackActionRequest(parsed, payload, correlationId) {
 		endpointPath: parsed.endpointPath,
 		alertType: parsed.alertType,
 		urgencyLevel: parsed.urgencyLevel,
+		...parsed.probableCause !== undefined && { probableCause: parsed.probableCause },
 		triggeredBy: {
 			...payload.user?.id !== undefined && { id: payload.user.id },
 			...payload.user?.username !== undefined && { username: payload.user.username },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@junando/webhook",
-  "version": "0.15.1",
+  "version": "0.16.1",
   "description": "AWS Lambda webhook handler — receives and enqueues external alert payloads for Junando",
   "license": "Apache-2.0",
   "type": "module",
@@ -20,7 +20,7 @@
   "dependencies": {
     "@aws-sdk/client-sqs": "^3.1127.0",
     "zod": "^4.5.4",
-    "@junando/core": "0.15.1"
+    "@junando/core": "0.16.1"
   },
   "devDependencies": {
     "@types/aws-lambda": "^8.10.163",