@kwirthmagnify/kwirth-sender-tee 0.1.12 → 0.1.14

package/README.md

@@ -0,0 +1,79 @@
+# Tee Sender
+
+Sender intermedio que recibe un mensaje y lo reenvía en paralelo a múltiples senders de destino configurados, sin hacer ningún envío final él mismo. Funciona como el comando Unix `tee`: lo que entra, sale por todos los canales a la vez.
+
+## Cuándo usarlo
+
+- Enviar la misma alerta simultáneamente a consola y a fichero.
+- Construir pipelines de notificación: un único punto de entrada que abanica hacia varios destinos.
+- Encadenar tees para topologías más complejas (un tee apuntando a otro tee).
+
+## Configuración
+
+Cada config tiene un campo `targets`: lista de pares `(senderId, configName)` que identifican el sender y la config de destino.
+
+| Campo     | Tipo                              | Requerido | Descripción                                    |
+|-----------|-----------------------------------|-----------|------------------------------------------------|
+| `name`    | `string`                          | Sí        | Nombre de esta config                          |
+| `targets` | `Array<{senderId, configName}>`   | Sí        | Lista de senders de destino                    |
+
+### Estructura de un target
+
+```json
+{
+  "senderId":   "console",       // id del sender destino (ej: "console", "file", "tee")
+  "configName": "mi-console"     // nombre de la config ya registrada en ese sender
+}
+```
+
+## Ejemplos
+
+### Fan-out a consola y fichero
+
+Prerequisito: tener configurados un `ConsoleSender` con config `"alerts-console"` y un `FileSender` con config `"alerts-file"`.
+
+```json
+{
+  "name": "alerts-tee",
+  "targets": [
+    { "senderId": "console", "configName": "alerts-console" },
+    { "senderId": "file",    "configName": "alerts-file" }
+  ]
+}
+```
+
+Invocar:
+```ts
+senderAccess.send('tee', 'alerts-tee', {
+  level: 'error',
+  subject: 'Pod crash',
+  body: 'nginx-7d4f crashed in namespace prod'
+})
+```
+
+El mensaje llega al mismo tiempo a stdout y al fichero de log.
+
+### Cadena de tees
+
+```
+tee-main
+  ├─ tee-ops    →  console + file
+  └─ tee-biz    →  kafka + slack
+```
+
+Config `tee-main`:
+```json
+{
+  "name": "tee-main",
+  "targets": [
+    { "senderId": "tee", "configName": "tee-ops" },
+    { "senderId": "tee", "configName": "tee-biz" }
+  ]
+}
+```
+
+## Comportamiento
+
+- Los envíos a todos los targets se hacen en **paralelo** (`Promise.all`).
+- Si un target falla, el error se propaga (el `Promise.all` rechaza). Los targets completados antes del fallo **no se revierten**.
+- El `ISenderAccess` se inyecta en `startSender()` — el tee no funciona antes de que el sistema lo inicialice.

package/front.js

@@ -199,7 +199,7 @@
     ), /* @__PURE__ */ import_react.default.createElement(import_material.Typography, { variant: "caption", color: "text.secondary", fontWeight: "bold" }, "Targets"), /* @__PURE__ */ import_react.default.createElement(import_material.Box, { sx: { flex: 1, border: 1, borderColor: "divider", borderRadius: 1, overflowY: "auto" } }, targets.length === 0 ? /* @__PURE__ */ import_react.default.createElement(import_material.Typography, { variant: "caption", color: "text.disabled", sx: { p: 1, display: "block" } }, "No targets yet.") : targets.map((t, i) => /* @__PURE__ */ import_react.default.createElement(import_material.Box, { key: i, sx: { display: "flex", alignItems: "center", gap: 1, px: 1, py: 0.5, borderBottom: 1, borderColor: "divider" } }, /* @__PURE__ */ import_react.default.createElement(import_material.Typography, { variant: "body2", sx: { flex: 1, minWidth: 0, overflow: "hidden", textOverflow: "ellipsis", whiteSpace: "nowrap" } }, t.senderId), /* @__PURE__ */ import_react.default.createElement(import_material.Typography, { variant: "body2", color: "text.secondary", sx: { flex: 1, minWidth: 0, overflow: "hidden", textOverflow: "ellipsis", whiteSpace: "nowrap" } }, t.configName), /* @__PURE__ */ import_react.default.createElement(import_material.IconButton, { size: "small", color: "error", onClick: () => setTargets((prev) => prev.filter((_, idx) => idx !== i)) }, /* @__PURE__ */ import_react.default.createElement(import_icons_material.Delete, { sx: { fontSize: 14 } }))))), /* @__PURE__ */ import_react.default.createElement(import_material.Stack, { direction: "row", spacing: 1, alignItems: "center" }, /* @__PURE__ */ import_react.default.createElement(import_material.FormControl, { size: "small", sx: { flex: 1 } }, /* @__PURE__ */ import_react.default.createElement(import_material.InputLabel, null, "Sender"), /* @__PURE__ */ import_react.default.createElement(import_material.Select, { label: "Sender", value: newSenderId, onChange: (e) => {
       setNewSenderId(e.target.value);
       setNewConfigName("");
-    } }, senders.map((s) => /* @__PURE__ */ import_react.default.createElement(import_material.MenuItem, { key: s.id, value: s.id }, s.displayName || s.id)))), /* @__PURE__ */ import_react.default.createElement(import_material.FormControl, { size: "small", sx: { flex: 1 }, disabled: !newSenderId }, /* @__PURE__ */ import_react.default.createElement(import_material.InputLabel, null, "Config"), /* @__PURE__ */ import_react.default.createElement(import_material.Select, { label: "Config", value: newConfigName, onChange: (e) => setNewConfigName(e.target.value) }, newSenderConfigs.map((c) => /* @__PURE__ */ import_react.default.createElement(import_material.MenuItem, { key: c, value: c }, c)))), /* @__PURE__ */ import_react.default.createElement(import_material.Tooltip, { title: "Add target" }, /* @__PURE__ */ import_react.default.createElement("span", null, /* @__PURE__ */ import_react.default.createElement(import_material.IconButton, { size: "small", color: "primary", disabled: !newSenderId || !newConfigName, onClick: addTarget }, /* @__PURE__ */ import_react.default.createElement(import_icons_material.Add, null))))), /* @__PURE__ */ import_react.default.createElement(import_material.Stack, { direction: "row", justifyContent: "flex-end", alignItems: "center", spacing: 1 }, error && /* @__PURE__ */ import_react.default.createElement(import_material.Typography, { variant: "caption", color: "error", sx: { flex: 1 } }, error), /* @__PURE__ */ import_react.default.createElement(import_material.Button, { size: "small", variant: "contained", disabled: saving || !editName.trim(), onClick: save }, saving ? /* @__PURE__ */ import_react.default.createElement(import_material.CircularProgress, { size: 14 }) : selectedName ? "Update" : "Add")))), /* @__PURE__ */ import_react.default.createElement(import_material.DialogActions, null, /* @__PURE__ */ import_react.default.createElement(import_material.Button, { size: "small", onClick: onClose }, "Close")));
+    } }, senders.map((s) => /* @__PURE__ */ import_react.default.createElement(import_material.MenuItem, { key: s.id, value: s.id }, s.displayName || s.id)))), /* @__PURE__ */ import_react.default.createElement(import_material.FormControl, { size: "small", sx: { flex: 1 }, disabled: !newSenderId }, /* @__PURE__ */ import_react.default.createElement(import_material.InputLabel, null, "Config"), /* @__PURE__ */ import_react.default.createElement(import_material.Select, { label: "Config", value: newConfigName, onChange: (e) => setNewConfigName(e.target.value) }, newSenderConfigs.map((c) => /* @__PURE__ */ import_react.default.createElement(import_material.MenuItem, { key: c, value: c }, c)))), /* @__PURE__ */ import_react.default.createElement(import_material.Tooltip, { title: "Add target" }, /* @__PURE__ */ import_react.default.createElement("span", null, /* @__PURE__ */ import_react.default.createElement(import_material.IconButton, { size: "small", color: "primary", disabled: !newSenderId || !newConfigName, onClick: addTarget }, /* @__PURE__ */ import_react.default.createElement(import_icons_material.Add, null))))), /* @__PURE__ */ import_react.default.createElement(import_material.Stack, { direction: "row", justifyContent: "flex-end", alignItems: "center", spacing: 1 }, error && /* @__PURE__ */ import_react.default.createElement(import_material.Typography, { variant: "caption", color: "error", sx: { flex: 1 } }, error), /* @__PURE__ */ import_react.default.createElement(import_material.Button, { size: "small", variant: "contained", disabled: saving || !editName.trim(), onClick: save }, saving ? /* @__PURE__ */ import_react.default.createElement(import_material.CircularProgress, { size: 14 }) : selectedName ? "Update" : "Add")))), /* @__PURE__ */ import_react.default.createElement(import_material.DialogActions, null, /* @__PURE__ */ import_react.default.createElement(import_material.Button, { onClick: onClose }, "Close")));
   };
   var TeeSenderDialog_default = TeeSenderDialog;
 

package/package.json

@@ -4,7 +4,7 @@
   "id": "tee",
   "name": "@kwirthmagnify/kwirth-sender-tee",
   "displayName": "Tee Sender",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "description": "Tee sender plugin for Kwirth — fans out an incoming message to multiple downstream senders simultaneously, acting as an intermediate pipeline node",
   "requiresRestart": false,
   "requiresExtension": []