Frayit.Sdk 1.0.2

Frayit .NET SDK (Frayit.Sdk)

Production-grade SDK for Frayit chat moderation evaluation API, designed for Unity and standard .NET applications.

Installation

dotnet add package Frayit.Sdk

SDK Usage

1) Initialize client

using Frayit.Sdk;

var options = new FrayitOptions
{
    ClientId = "<your-client-id>",
    ClientSecret = "<your-client-secret>",
    BaseUrl = "https://<your-frayit-api-base-url>/",
    ChatTimeoutMilliseconds = 100
};

using var client = new FrayitClient(options);
await client.InitializeAsync();

2) Evaluate chat message

using Frayit.Sdk.Models;

var request = new ChatEvaluationRequest
{
    Message = "you are trash",
    PlayerId = "player-123",
    SessionId = "session-1",
    ChannelId = "global"
};

ChatEvaluationResponse response = await client.EvaluateChatAsync(request);

3) Handle decision + fallback

if (response.FailOpen)
{
    // Service unavailable/timeout path: SDK safely allows chat
    Console.WriteLine("Fail-open: " + response.FailOpenReason);
}

if (response.Allowed)
{
    Console.WriteLine("Allowed message");
}
else
{
    Console.WriteLine("Blocked");
    Console.WriteLine("Reasons: " + string.Join(",", response.BlockReasonCodes));
    Console.WriteLine("Redacted: " + (response.RedactedMessage ?? "***"));
}

4) Optional logging hooks

using Frayit.Sdk.Logging;

public sealed class ConsoleFrayitLogger : IFrayitLogger
{
    public void OnTokenRefreshStarted() => Console.WriteLine("[token] refresh started");
    public void OnTokenRefreshSucceeded(DateTimeOffset expiresAtUtc) => Console.WriteLine("[token] expires " + expiresAtUtc);
    public void OnTokenRefreshFailed(Exception exception) => Console.WriteLine("[token] refresh failed: " + exception.Message);
    public void OnSdkError(string operation, Exception exception) => Console.WriteLine("[sdk] " + operation + ": " + exception.Message);
    public void OnCircuitBreakerStateChanged(string previousState, string nextState, string reason) =>
        Console.WriteLine("[cb] " + previousState + " -> " + nextState + " (" + reason + ")");
}

Use it when creating the client:

using var client = new FrayitClient(options, logger: new ConsoleFrayitLogger());

Notes

• Keep ClientSecret on server-side in production.
• SDK applies fail-open behavior if moderation service cannot be reached.
• For multiplayer demos, call SDK from backend and expose only your own API to game clients.