@pelayo2010/notifications

Motor agnóstico de notificaciones: clasificación de prioridad, decisión de canales, optimización anti-duplicado y despacho a través de puertos.

Paquete del Core de ConfÍA Platform. ESM puro, TypeScript strict, Node >= 20, licencia Apache-2.0 y cero dependencias de terceros.

Instalación

npm install @pelayo2010/notifications

Uso

import * as notifications from "@pelayo2010/notifications";

Reglas del paquete

• Sin semántica de producto: los canales y plantillas los aporta el consumidor.
• Estado del optimizador puro y serializable, apto para edge/Workers.
• Cero dependencias de terceros.

Estructura

• src/dispatch.ts
• src/errors.ts
• src/index.ts
• src/optimizer.ts
• src/ports.ts
• src/result.ts
• src/routing.ts
• src/types.ts

Superficie pública

37 símbolos exportados (16 de runtime, 21 de tipo). La lista congelada vive en core/api/public-api.json y se verifica en CI con npm run api:check.

BuildPayloadOptions, DEFAULT_OPTIMIZER_CONFIG, DispatchReport, EvaluateInput, MEDIUM_DELAY_MS, NotificationChannel, NotificationDebugEvent, NotificationDebugPort, NotificationDeliveryOutcome, NotificationDeliveryPort, NotificationError, NotificationErrorCode, NotificationKind, NotificationLogPort, NotificationPayload, NotificationSourceMessage, NotificationTier, OptimizerConfig, OptimizerDecision, OptimizerDecisionReason, OptimizerState, OptimizerStats, SEEN_MESSAGES_CAP, SeenMessages, buildNotificationPayload, cancelNotification, classifyPriority, createOptimizerState, createSeenMessages, decideChannels, dispatchNotification, evaluateDelivery, isDispatchable, optimizerStats, preemptsPendingMedium, rememberMessage, shouldDeferMedium.

Versionado

Publicación en lockstep con el resto del ecosistema (ADR-007): todos los paquetes comparten versión y release.

• Exports públicos: src/index.ts
• Tests: tests/
• Licencia: Apache-2.0 (LICENSE, NOTICE)