Lacuna.Cloudhub 1.0.0

<div align="center"> <img src="assets/nuget-icon.png" alt="Lacuna Cloudhub .NET SDK" width="112" /> <h1>Lacuna Cloudhub .NET SDK</h1> <p><strong>Cloud certificate discovery, authentication, and signing through a strongly typed .NET client.</strong></p> <p>Use the Lacuna Cloudhub API without hand-written HTTP requests, with generated models, async methods, source-generated JSON serialization, and <code>X-Api-Key</code> authentication.</p>

</div>

Features

• Complete v1 Swagger coverage — service discovery, availability, session creation, certificate retrieval, hash signing, and custom state.
• Strongly typed contracts — request/response models and enums generated from Cloudhub's official OpenAPI document.
• API key authentication — every operation sends the credential in the X-Api-Key header.
• Modern .NET — async APIs, nullable annotations, source-generated System.Text.Json, trimming analysis, assembly signing, and reproducible packages.
• Reproducible generation — the pinned AutoSDK version plus deterministic OpenAPI overrides produce stable operation names and authentication metadata.

Requirements

• .NET 10 SDK or later to build
• A Lacuna Cloudhub API key

Install

dotnet add package Lacuna.Cloudhub

Quick start

Keep the credential outside source control:

export LACUNA_CLOUDHUB_API_KEY="your-cloudhub-api-key"

Then discover available trust services for a CPF:

using Loud.Technology.Lacuna.Cloudhub.Sdk;

using var client = CloudhubClient.CreateFromEnvironment();

var services = await client.GetServicesAsync(
    identifier: "12345678901",
    identifierType: IdentifierTypes.Cpf);

foreach (var service in services)
{
    Console.WriteLine($"{service.ServiceName} — {service.Provider}");
}

Create a single-signature session:

var session = await client.CreateSessionAsync(
    redirectUri: "https://app.example.com/cloudhub/callback",
    identifierType: IdentifierTypes.Cpf,
    identifier: "12345678901",
    type: TrustServiceSessionTypes.SingleSignature,
    lifetimeInSeconds: 300,
    customState: "order-42",
    discover: true);

var authorizationUrl = session.Services?.FirstOrDefault()?.AuthUrl;

Configure the client

Explicit credential

using var client = new CloudhubClient("your-cloudhub-api-key");

Custom endpoint and application-managed HttpClient

using var httpClient = new HttpClient { Timeout = TimeSpan.FromSeconds(30) };
using var client = new CloudhubClient(
    apiKey: Environment.GetEnvironmentVariable("LACUNA_CLOUDHUB_API_KEY")!,
    httpClient: httpClient,
    baseUri: new Uri("https://cloudhub.lacunasoftware.com"),
    disposeHttpClient: false);

Never commit API keys. Use environment variables, .NET user secrets, or a cloud secret manager.

API surface

Every method accepts a CancellationToken. Methods ending in AsResponseAsync expose status and headers. Non-success responses throw ApiException; generated typed subclasses include authentication, authorization, validation, rate-limit, and server exceptions.

Regenerate

cd src/libs/Cloudhub
./generate.sh

The script downloads the official Swagger document, applies deterministic fixes for missing operation IDs and global security, and replaces Generated/ using AutoSDK 0.30.2-dev.152.

Build and test

dotnet restore Loud.Technology.Lacuna.Cloudhub.Sdk.slnx
dotnet build Loud.Technology.Lacuna.Cloudhub.Sdk.slnx --configuration Release --no-restore
dotnet test Loud.Technology.Lacuna.Cloudhub.Sdk.slnx --configuration Release --no-build

Network-free contract tests verify the default URL, X-Api-Key header, routes, enum/query serialization, typed responses, byte-array handling, and model validation.

License

Licensed under the MIT License.

Acknowledgments

This project is supported by JetBrains through the Open Source Support Program.