@radzor/notification-hub

Fan-out notifications to multiple channels including email (SMTP/SendGrid), SMS (Twilio), push (FCM), and Slack webhooks. Register channels dynamically and track delivery status.

Messagingv0.1.0typescriptpythonServernotificationemailsmspushslackfan-outmulti-channelby Radzor

Install

View source on GitHub →

$npx radzor@latest add notification-hub

⚠ Constraints: Each channel type requires its own credentials in the config parameter: email needs SMTP host/port/user/pass or SendGrid API key; sms needs Twilio SID/token/from; push needs FCM server key; slack needs webhook URL. No external dependencies — all transports use raw fetch.

Inputs

Name	Type	Default	Description
defaultChannels	string[]		Default channel names to send to when none specified (e.g. ["email", "slack"]).
retryAttempts	number	2	Number of retry attempts on delivery failure (default: 2).

defaultChannelsstring[]

Default channel names to send to when none specified (e.g. ["email", "slack"]).

default:

retryAttemptsnumber

Number of retry attempts on delivery failure (default: 2).

default: 2

Outputs

Name	Type	Description

{ "llm": { "constraints": "Each channel type requires its own credentials in the config parameter: email needs SMTP host/port/user/pass or SendGrid API key; sms needs Twilio SID/token/from; push needs FCM server key; slack needs webhook URL. No external dependencies — all transports use raw fetch.", "usageExamples": "llm/examples.md", "integrationPrompt": "llm/integration.md" }, "name": "@radzor/notification-hub", "tags": [ "notification", "email", "sms", "push", "slack", "fan-out", "multi-channel" ], "events": [ { "name": "onDelivered", "payload": { "messageId": "string", "recipient": "string", "channelName": "string" }, "description": "Fired when a notification is successfully delivered to a channel." }, { "name": "onFailed", "payload": { "error": "string", "attempts": "number", "recipient": "string", "channelName": "string" }, "description": "Fired when delivery fails after all retry attempts." } ], "inputs": [ { "name": "defaultChannels", "type": "string[]", "default": [], "required": false, "description": "Default channel names to send to when none specified (e.g. [\"email\", \"slack\"])." }, { "name": "retryAttempts", "type": "number", "default": 2, "required": false, "description": "Number of retry attempts on delivery failure (default: 2)." } ], "radzor": "1.0.0", "actions": [ { "name": "send", "params": [ { "name": "title", "type": "string", "description": "Notification title / subject." }, { "name": "body", "type": "string", "description": "Notification body / message." }, { "name": "recipient", "type": "string", "description": "Recipient identifier (email, phone, device token, or channel ID depending on channel type)." }, { "name": "channels", "type": "string[]", "required": false, "description": "Channel names to send to. Uses defaultChannels if omitted." }, { "name": "metadata", "type": "Record<string, string>", "required": false, "description": "Arbitrary key-value metadata passed to channel handlers." } ], "returns": "Promise<{ results: Array<{ channel: string; success: boolean; messageId?: string; error?: string }> }>", "description": "Send a notification to one or more channels." }, { "name": "registerChannel", "params": [ { "name": "name", "type": "string", "description": "Unique channel name (e.g. \"email\", \"slack-ops\")." }, { "name": "type", "type": "\"email\" | \"sms\" | \"push\" | \"slack\" | \"webhook\"", "description": "Channel transport type." }, { "name": "config", "type": "Record<string, string>", "description": "Channel-specific configuration (API keys, URLs, etc.)." } ], "returns": "void", "description": "Register a notification channel with its transport configuration." }, { "name": "removeChannel", "params": [ { "name": "name", "type": "string", "description": "Channel name to remove." } ], "returns": "boolean", "description": "Remove a registered channel. Returns true if it existed." } ], "outputs": [ { "name": "deliveryReport", "type": "{ channelName: string; success: boolean; messageId: string; error?: string }", "fields": [ { "name": "channelName", "type": "string", "description": "Channel that processed the notification." }, { "name": "success", "type": "boolean", "description": "Whether delivery succeeded." }, { "name": "messageId", "type": "string", "description": "Channel-specific message identifier." }, { "name": "error", "type": "string", "required": false, "description": "Error message if delivery failed." } ], "description": "Per-channel delivery report." } ], "runtime": "server", "version": "0.1.0", "category": "messaging", "languages": [ "typescript", "python" ], "description": "Fan-out notifications to multiple channels including email (SMTP/SendGrid), SMS (Twilio), push (FCM), and Slack webhooks. Register channels dynamically and track delivery status.", "dependencies": { "radzor": [], "packages": {} }, "composability": { "connectsTo": [ { "event": "onFailed", "description": "Track failed notification deliveries", "compatibleWith": [ "@radzor/error-tracker.action.captureMessage.message", "@radzor/log-aggregator.action.error.message" ] }, { "output": "deliveryReport", "mapField": "channelName", "compatibleWith": [ "@radzor/event-tracker.action.track.eventName", "@radzor/log-aggregator.action.info.message" ] } ] } }

@radzor/notification-hub

Install

Inputs

Outputs

Actions

Events

Composability

radzor.manifest.json