Kyronex.AutoFix.Sdk 0.1.4

Kyronex AutoFix SDK - .NET

Client SDK for sending application errors and telemetry to Kyronex AutoFix. It is designed to be easy for humans and AI tools to understand and use.

Compatible with netstandard2.0, so it works from .NET Framework 4.8, .NET Core, and modern .NET apps.

What this SDK does

Use this SDK to send error events from your application to the AutoFix API. The SDK is intentionally simple:

• you set the project id
• you set the company API key
• you create an event
• you call TrySendAsync

If the AutoFix API is unavailable, the method returns false and does not block your app with a network exception.

Install

dotnet add package Kyronex.AutoFix.Sdk

Configuration

var client = new AutoFixClient(new HttpClient(), new AutoFixOptions
{
    BaseUrl = "https://autofix.kyronex.com.br",
    IdCompanyProject = Guid.Parse("00000000-0000-0000-0000-000000000000"),
    ApiKey = "YOUR-API-KEY"
});

Required options

• BaseUrl: public URL of the AutoFix API.
• IdCompanyProject: project identifier shown in the Kyronex dashboard.
• ApiKey: company API key created in Kyronex.

Basic example

using Kyronex.AutoFix.Sdk;

var sent = await client.TrySendAsync(new AutoFixEvent(
    AutoFixEventType.Exception,
    AutoFixSeverity.Error,
    "Falha ao salvar pedido",
    "O banco retornou erro de conexao"
));

Example with stack trace, tags, and context

try
{
    await ProcessOrderAsync();
}
catch (Exception ex)
{
    var sent = await client.TrySendAsync(new AutoFixEvent(
        AutoFixEventType.UnhandledException,
        AutoFixSeverity.Critical,
        "Falha ao processar pedido",
        "Uma excecao ocorreu durante o processamento do pedido",
        StackTrace: ex.ToString(),
        Environment: "Production",
        ApplicationVersion: "1.4.2",
        UserIdentifier: "user-123",
        Tags: new Dictionary<string, string>
        {
            ["module"] = "billing",
            ["tenant"] = "kyronex"
        },
        Context: new Dictionary<string, object>
        {
            ["orderId"] = 98765,
            ["retryCount"] = 2,
            ["isTransient"] = true
        }
    ));
}

Field guide

• EventType: what kind of event happened.
• Severity: how serious the event is.
• Title: short summary for list views.
• Message: human explanation of the problem.
• StackTrace: full exception text, usually ex.ToString().
• Environment: app environment such as Development, Staging, or Production.
• ApplicationVersion: version of the application that generated the event.
• UserIdentifier: optional user, session, or account reference.
• Tags: string metadata for search and grouping.
• Context: structured details for debugging and future automation.

Recommended enum usage

• AutoFixEventType.Exception: caught exception in code.

• AutoFixEventType.UnhandledException: unexpected exception that was not handled.

• AutoFixEventType.DependencyFailure: API, database, or external service failure.

• AutoFixEventType.ValidationError: invalid input or business-rule violation.

• AutoFixEventType.Error: generic application error.

• AutoFixEventType.SecurityEvent: suspicious or security-related event.

• AutoFixEventType.PerformanceIssue: slow operation or bottleneck.

• AutoFixEventType.Custom: anything that does not fit the standard categories.

• AutoFixSeverity.Debug: internal debug signal.

• AutoFixSeverity.Information: informational event.

• AutoFixSeverity.Warning: warning that should be monitored.

• AutoFixSeverity.Error: error affecting the normal flow.

• AutoFixSeverity.Critical: urgent issue that needs immediate attention.

Reliability model

The SDK is meant to be safe to call from production code.

• It does not throw network failures back to the host application.
• It returns false when the API cannot be reached or the configuration is invalid.
• It can retry transient failures using MaxRetries.
• It supports a short timeout so it does not block user flows for long.

For AI tools and code assistants

If you ask an AI assistant to integrate this package, it should be able to:

1. create an AutoFixClient
2. fill AutoFixOptions
3. send one AutoFixEvent
4. use ex.ToString() for stack traces
5. keep the call non-blocking for the host app

More examples

See EXAMPLES.md inside the package for extra scenarios.