Asterisk.Core.Events 1.0.0

Asterisk.Core.Events

El paquete Asterisk.Core.Events proporciona clases de argumentos tipadas y fuertemente estructuradas para representar eventos asíncronos recibidos del Protocolo de Interfaz de Administrador (AMI) de Asterisk.

Este paquete se centra en la limpieza, inmutabilidad y fácil acceso a los datos de los eventos AMI, aprovechando la herencia (DialplanEventArgsBase) y las utilidades de parsing (DialplanParserHelper) que hemos desarrollado.

Características Principales

• Tipificación Fuerte: Todos los eventos AMI se representan mediante clases EventArgs específicas (ej. NewextenEventArgs, HangupEventArgs, VarSetEventArgs).
• Herencia y Reutilización: Utiliza la clase base DialplanEventArgsBase para gestionar el parsing y las propiedades comunes de todos los eventos relacionados con el flujo de llamadas y el dialplan (Channel, Uniqueid, Context, etc.).
• Inmutabilidad: Todas las clases de eventos están diseñadas para ser inmutables, lo que mejora la seguridad en entornos multihilo.
• Separación de Lógica: Utiliza la composición (DialplanInfo) y helpers estáticos para separar la lógica de parsing compleja (ej. campo Channel, campos prefijados como DestChannel) de las clases de eventos.

Instalación

Instala el paquete a través del Administrador de Paquetes NuGet:

dotnet add package Asterisk.Core.Events

O desde la Consola del Administrador de Paquetes:

Install-Package Asterisk.Core.Events

Clases de Eventos Modeladas

Las siguientes son algunas de las clases de eventos clave proporcionadas en este paquete:

Ejemplo de Uso

Una vez que tengas un listener (escuchador) de eventos AMI configurado, puedes manejar los eventos con seguridad de tipo (type-safety):

// Suponiendo que 'manager' es una instancia de AsteriskManager
manager.EventReceived += (sender, eventArgs) => 
{
    var message = e.Message;

    Console.WriteLine($"Procesando mensaje de evento: {message.Replace("\r", "\\r").Replace("\n", "\\n")}");

    // 1. Análisis: Convierte el mensaje en un diccionario de clave-valor
    var lines = message
        // Usa TerminatorChars, que es una propiedad de ManagerState.
        .Split(TerminatorChars, StringSplitOptions.RemoveEmptyEntries)
        .Select(l => l.Split(new[] { ':' }, 2))
        .Where(kvp => kvp.Length == 2)
        .ToDictionary(kvp => kvp[0].Trim(), kvp => kvp[1].Trim(), StringComparer.OrdinalIgnoreCase);

    // 2. Extracción del tipo de evento
    if (!lines.TryGetValue("Event", out var eventType))
    {
        Console.WriteLine("Advertencia: Mensaje sin campo 'Event'. Disparando evento genérico.");
        return;
    }

    // 3. Despacho/Fábrica: Llama a un método que se encargará de crear y disparar el evento tipado.
};

Ejemplo de Uso (Con Eventos Específicos)

En lugar de suscribirse a un evento genérico que requiere un 'cast' manual, se recomienda suscribirse directamente a los eventos tipados proporcionados por AsteriskManager (siguiendo la estructura del paquete Asterisk.Core.Events).

// Suponiendo que 'manager' es una instancia de AsteriskManager
manager.HangupReceived += OnHangup;
manager.DialEndReceived += OnDialEnd;
manager.VarSetReceived += OnVarSet;

private static void OnHangup(object? sender, HangupEventArgs hangup)
{
    Console.WriteLine($"📞 Colgado: {hangup.ChannelInfo.UniqueId}");
    Console.WriteLine($"Causa: {hangup.Cause} - {hangup.CauseTxt}");
}

private static void OnDialEnd(object? sender, DialEndEventArgs dialEnd)
{
    Console.WriteLine($"🏁 Marcación Finalizada con estado: {dialEnd.DialStatus}");
    Console.WriteLine($"Canal Destino: {dialEnd.DestChannelInfo.ChannelDetails.Technology}");
}

private static void OnVarSet(object? sender, VarSetEventArgs varSet)
{
    Console.WriteLine($"⚙️ Variable establecida: {varSet.Variable} = {varSet.Value}");
}

Licencia

Distribuido bajo la licencia MIT.