Noie.Nds.Api 3.0.6

Noie.Nds - .NET SDK for NoieDigitalSystem

Protocol SDK for NDS-API (NoieDigitalSystem) on .NET.

• Protocol spec: ../spec/proto/
• Repo docs index: ../docs/README.md

Installation

dotnet add package Noie.Nds.Api

Or for just the abstractions:

dotnet add package Noie.Nds.Api.Abstractions

Features

• Protocol types: Identity / Asset / Event / Transaction / Result / Context
• Governance & audit hooks: Policy (Noie.Nds.Api.Policy) and Audit/Rationale (Noie.Nds.Api.Audit)
• Type safety: nullable reference types enabled
• Proto compatibility: matches the NDS Protocol Buffers specification
• AOT-friendly: trimming analyzers enabled

Quick Start

Identity

using Noie.Nds.Api.Identity;

// Create player identity
var player = NdsIdentity.Of("550e8400-e29b-41d4-a716-446655440000", IdentityType.Player);

// Parse from string
var identity = NdsIdentity.FromString("PLAYER:550e8400-e29b-41d4-a716-446655440000");

Asset

using Noie.Nds.Api.Asset;

// Create asset IDs
var coins = AssetId.Player("coins");
var bossHp = AssetId.Server("world_boss_hp");

// Parse from string
var asset = AssetId.FromString("player:gold");

Result Pattern

using Noie.Nds.Api.Result;

// Create results
var success = NdsResult<int>.Success(100);
var failure = NdsResult<int>.Failure("INSUFFICIENT_BALANCE", "Not enough coins");

// Functional chaining
var result = success
    .Map(x => x * 2)
    .OnSuccess(x => Console.WriteLine($"Value: {x}"))
    .OnFailure(e => Console.WriteLine($"Error: {e.Message}"));

// Pattern matching
var message = result.Match(
    onSuccess: x => $"Got {x}",
    onFailure: e => $"Failed: {e.Code}"
);

Context

using Noie.Nds.Api.Context;

// Create context for tracing
var context = NdsContext.Create();
Console.WriteLine($"TraceId: {context.TraceId}");

// Add metadata
var enriched = context.WithMeta("user", "player123");

Policy + Rationale

using Noie.Nds.Api.Policy;
using Noie.Nds.Api.Audit;

var policy = NdsPolicy.Of("shop-default-policy-v1", "quota");
var rationale = NdsRationale.Of(
    source: "human_admin",
    thoughtPath: new[] { "manual_review", "approved" }
);

Packages

Compatibility

• .NET 10 (net10.0)

Related Projects

• nds-api - Protocol + SDKs monorepo

License

Apache License 2.0