pkg

TechAppForce/TAF.MetaData.SDKv10.0.2

.NET 8.0

Professional HTTP-based SDK for TAF Metadata Service. v10.0.0: Clean release - no caching dependencies. Features Clean Architecture, SOLID principles, explicit BusContext parameter support, comprehensive error handling, screen management, batch relations support, and GUID-based lookups.

License

MIT

Deps

12

Install Size

—

Vulns

✓ 0

Published

Feb 24, 2026

Get Started

$ dotnet add package TAF.MetaData.SDK

Readme

TAF Metadata Client SDK

A professional, HTTP-based SDK for consuming TAF Metadata Service APIs. This SDK follows Clean Architecture and SOLID principles, providing enterprise-grade metadata retrieval capabilities with automatic context resolution.

🆕 New in v6.0.0

Connection Management - Get database connections by environment or application
Self-Contained Package - All required DLLs bundled (no external dependencies)
Removed SDK.Contracts - Now uses bundled Contracts/Domain types directly
Breaking Change - Consumers using TAF.MetaData.SDK.Contracts namespace must update to TAF.MetaData.Contracts or TAF.MetaData.Domain

🏗️ Architecture & Design Principles

✅ Clean Architecture - Proper separation of layers: Client, Infrastructure, Services, Interfaces, Core
✅ SOLID Principles - Single responsibility, dependency inversion, interface segregation
✅ Industry Standards - Follows AWS, Azure, Stripe SDK naming conventions
✅ HTTP-First - Lightweight, direct API communication
✅ Auto Context Resolution - Automatic TenantId/AppId extraction from headers
✅ Comprehensive Error Handling - Proper exception mapping and status codes
✅ Dependency Injection - Seamless .NET DI integration with validation

📦 Installation

dotnet add package TAF.MetaData.SDK

🚀 Quick Start

1. Configuration

{
  "MetadataService": {
    "BaseUrl": "https://your-metadata-service.com",
    "Timeout": 30
  }
}

using TAF.MetaData.SDK.Extensions;

var builder = WebApplication.CreateBuilder(args);

// One-line registration with appsettings
builder.Services.AddMetadataClient(builder.Configuration);

var app = builder.Build();

// Custom configuration
builder.Services.AddMetadataClient(options =>
{
    options.BaseUrl = "https://metadata-api.production.com";
    options.TimeoutSeconds = 45;
});

public class MyService
{
    private readonly IMetadataClient _metadataClient;
    
    public MyService(IMetadataClient metadataClient)
    {
        _metadataClient = metadataClient;
    }
    
    public async Task<AppObjectResponse?> GetUserProfile()
    {
        // Context (TenantId, AppId) automatically resolved from HTTP headers
        return await _metadataClient.GetAppObjectAsync(
            appObjectName: "UserProfile", 
            version: "1.2.0" // optional
        );
    }
}

GET /api/myendpoint
TenantId: 123e4567-e89b-12d3-a456-426614174000
AppId: 987fcdeb-51a2-43d1-9f12-345678901234
CorrelationId: req-12345-67890 (optional)

Task<AppObjectResponse?> GetAppObjectAsync(
    string appObjectName,
    string? version = null,
    CancellationToken cancellationToken = default)

Task<OperationResult<IEnumerable<ConnectionDto>>> GetConnectionsByEnvironmentAsync(
    Guid appEnvironmentId,
    BusContext context,
    CancellationToken cancellationToken = default)

Task<OperationResult<IEnumerable<ConnectionDto>>> GetConnectionsByAppAsync(
    Guid appId,
    BusContext context,
    CancellationToken cancellationToken = default)

public class AppObjectResponse
{
    public Guid Id { get; set; }
    public Guid TenantId { get; set; }
    public Guid AppId { get; set; }
    public Guid AppObjectId { get; set; }
    public string AppObjectName { get; set; }
    public string AppObjectJson { get; set; }
    public string? Version { get; set; }
    public bool IsCustom { get; set; }
    public DateTime CreatedAt { get; set; }
    public DateTime UpdatedAt { get; set; }
}

TAF.Metadata.SDK/
├── Client/              # Consumer-facing implementations
│   └── HttpMetadataClient.cs
├── Infrastructure/      # External dependencies (HTTP context)
│   └── HttpContextProvider.cs
├── Services/           # Internal business services
│   ├── MetadataUrlBuilder.cs
│   ├── MetadataHttpRequestFactory.cs
│   └── MetadataResponseProcessor.cs
├── Interfaces/         # Contracts/abstractions
│   ├── IMetadataClient.cs
│   ├── IContextProvider.cs
│   └── ...
├── Core/              # Domain objects
│   └── MetadataContext.cs
├── Configuration/     # Options pattern
│   └── MetadataServiceOptions.cs
└── Extensions/        # DI registration
    └── ServiceCollectionExtensions.cs

// No manual context needed - extracted automatically!
var appObject = await _metadataClient.GetAppObjectAsync("UserProfile");

// Behind the scenes:
// 1. HttpContextProvider reads Request.Headers["TenantId"]
// 2. HttpContextProvider reads Request.Headers["AppId"] 
// 3. HttpContextProvider reads Request.Headers["CorrelationId"] (optional)
// 4. Context passed to metadata service automatically

try
{
    var userProfile = await _metadataClient.GetAppObjectAsync("UserProfile");
    if (userProfile == null)
    {
        // Object not found (404)
        Console.WriteLine("UserProfile not found");
    }
}
catch (InvalidOperationException ex)
{
    // Missing required headers
    Console.WriteLine($"Missing context: {ex.Message}");
}
catch (MetadataServiceException ex)
{
    // Service errors (network, timeout, API errors)
    Console.WriteLine($"Service error: {ex.Message}, Status: {ex.StatusCode}");
}

public class MetadataServiceOptions
{
    public string BaseUrl { get; set; } = string.Empty;
    public int TimeoutSeconds { get; set; } = 30;
}