Bullgate Access

builder.Services.AddBullgateAccess(options =>
{
    options.BaseAddress = new Uri(
        builder.Configuration["Bullgate:Access:BaseUrl"]!);
    options.IntegrationCredential =
        builder.Configuration["Bullgate:Access:IntegrationCredential"]!;
});

builder.Services
    .AddAuthentication(BullgateAccessDefaults.AuthenticationScheme)
    .AddBullgateSession();
builder.Services.AddAuthorization();

// Implementações específicas do seu produto.
builder.Services.AddScoped<IBullgatePrincipalResolver, ProductPrincipalResolver>();
builder.Services.AddScoped<
    IBullgateAccessApplication<ProductRegistration, ProductProfile>,
    ProductAccessApplication>();

// A ordem é significativa.
app.UseBullgateAccessFailures();
app.UseAuthentication();
app.UseAuthorization();

app.MapBullgateAccess<ProductRegistration, ProductProfile>();

public sealed record ProductRegistration(string Name);
public sealed record ProductProfile(Guid Id, string Name);

public sealed class ProductAccessApplication(ProductDb db)
    : IBullgateAccessApplication<ProductRegistration, ProductProfile>
{
    public async ValueTask<BullgateApplicationProvisionResult<ProductProfile>>
        ProvisionAsync(
            BullgateSession session,
            ProductRegistration registration,
            CancellationToken cancellationToken)
    {
        // UNIQUE(BullgateIdentityId) torna o retry seguro.
        var profile = await db.GetOrCreateByBullgateIdentityIdAsync(
            session.IdentityId,
            registration.Name,
            cancellationToken);

        return new(profile);
    }

    public ValueTask<ProductProfile?> ResolveAsync(
        BullgateSession session,
        CancellationToken cancellationToken) =>
        db.FindByBullgateIdentityIdAsync(session.IdentityId, cancellationToken);
}

{
  "state": "authenticated",
  "identityId": "0198f1d0-…",
  "email": "[email protected]",
  "sessionExpiresAt": "2026-10-04T12:00:00Z",
  "application": {
    "id": "8d5e…",
    "name": "Ana"
  }
}

import {
  createBullgateAccessClient,
  createBullgateFetchTransport,
  BullgateAccessError,
} from "@bullgate/react-native";

const transport = createBullgateFetchTransport({
  baseUrl: () => apiBaseUrl,
});

const access = createBullgateAccessClient<
  ProductRegistration,
  ProductProfile
>(transport);

const session = await access.login({ email, password });
if (session.state === "authenticated") {
  openApplication(session.application);
} else {
  openRegistrationJourney();
}

let current = await access.startRegistrationFlow({
  nativeClientId,
});

while (current.flow.status === "active") {
  const flow = current.flow;

  if (flow.step?.type === "collectPhone") {
    current = await access.actOnFlow(
      flow,
      "requestPhoneVerification",
      { phone: "+5511999999999" },
    );
    continue;
  }

  if (flow.step?.type === "verifyPhone") {
    current = await access.actOnFlow(
      flow,
      "confirmPhoneVerification",
      { code: "123456" },
    );
    continue;
  }

  // Nunca invente uma ação que não está em flow.actions.
  renderStep(flow);
  break;
}

if (current.session?.state === "authenticated") {
  openApplication(current.session.application);
}