Infrastructure Services Reference for Dragon Guard WMS

public class SessionService
{
    // ── Events ────────────────────────────────────────────────────────────────
    public event Action? SessionChanged;

    // ── State flags ───────────────────────────────────────────────────────────
    public bool IsAuthenticated             { get; }   // Token is non-empty
    public bool HasAmbiguousCompanyContext  { get; }   // Companies.Count > 1
    public bool HasValidOperationalContext  { get; }   // IsAuthenticated && ActiveCompanyId.HasValue && !HasAmbiguousCompanyContext

    // ── Identity properties ───────────────────────────────────────────────────
    public string                           Token           { get; }
    public string                           Email           { get; }
    public string                           FullName        { get; }
    public Guid?                            ActiveCompanyId { get; }
    public IReadOnlyList<AuthCompanyAccessDto> Companies   { get; }
    public string                           ActiveRoleCode  { get; }  // derived from Companies

    // ── Lifecycle ─────────────────────────────────────────────────────────────
    public async Task InitializeAsync();
    public async Task SignInAsync(AuthSessionResponseDto session);
    public async Task SignOutAsync();
    public async Task SetActiveCompanyAsync(Guid companyId);
}

public sealed class NavigationService
{
    // Push a page — aborts and redirects to login if session is not authenticated
    public async Task PushAsync(Page page);

    // Push a page without authentication check (used for login/setup flows)
    public async Task PushUnprotectedAsync(Page page);

    // Pop the top page; no-op if NavigationStack.Count ≤ 1
    public async Task PopAsync();
}

public sealed class ApiSettingsService
{
    public event Action? Changed;

    public string CurrentBaseUrl { get; }

    // Returns the platform default URL (Android vs desktop)
    public string GetDefaultBaseUrl();

    // Normalizes a URL string, prepending http:// if scheme is absent
    public bool TryNormalize(string? value, out string normalized);

    // Returns normalized URL or the platform default if value is invalid
    public string NormalizeOrDefault(string? value);

    // Persists a new base URL; enforces AllowConnectionOverride guard
    public bool Save(string? value, out string normalized, out string errorMessage);

    // Resolves a relative or absolute path against CurrentBaseUrl
    public Uri BuildUri(string relativeOrAbsolute);

    // Fires a live HTTP probe against registration-options (8 s timeout)
    public async Task<(bool Success, string Message)> TestConnectionAsync(
        string? candidate = null,
        CancellationToken cancellationToken = default);
}

public sealed class AppExperienceService
{
    public bool ShowConnectionSettings { get; }   // true in DEBUG, false in RELEASE
    public bool AllowConnectionOverride { get; }  // true in DEBUG, false in RELEASE
    public string ExperienceMode { get; }         // "TEST" | "OFFICIAL"
}

public sealed class DeviceIdentityService
{
    public string DeviceId   { get; }   // WiFi MAC → ANDROID_ID → stored GUID
    public string DeviceName { get; }   // DeviceInfo.Name → Manufacturer + Model
}

public class AuthenticatedHttpMessageHandler : DelegatingHandler
{
    // Injected automatically by DI
    public AuthenticatedHttpMessageHandler(SessionService sessionService);

    // Overrides DelegatingHandler.SendAsync
    protected override Task<HttpResponseMessage> SendAsync(
        HttpRequestMessage request,
        CancellationToken cancellationToken);
}

public sealed class DynamicBaseUrlMessageHandler : DelegatingHandler
{
    public DynamicBaseUrlMessageHandler(ApiSettingsService apiSettingsService);

    protected override Task<HttpResponseMessage> SendAsync(
        HttpRequestMessage request,
        CancellationToken cancellationToken);
}

public static class ApiErrorMapper
{
    // Maps a raw error string to a localized user message
    public static string ToUserMessage(string rawError, string fallback);
}

public sealed class FlexibleGuidJsonConverter : JsonConverter<Guid>
{
    // Returns Guid.Empty for null tokens or strings that fail Guid.TryParse
    public override Guid Read(
        ref Utf8JsonReader reader,
        Type typeToConvert,
        JsonSerializerOptions options);

    // Writes the Guid as a standard string value
    public override void Write(
        Utf8JsonWriter writer,
        Guid value,
        JsonSerializerOptions options);
}

public class BinService
{
    public BinService(HttpClient http);

    // GET api/bins?activeOnly=true&pageNumber=1&pageSize={pageSize}
    public async Task<List<BinDto>> GetActiveBinsAsync(int pageSize = 100);
}

public class CompanyService
{
    public CompanyService(HttpClient httpClient);

    // POST api/companies
    public async Task<CompanyResponse> CreateCompanyAsync(CreateCompanyRequest request);
}

public class TransferService
{
    public TransferService(HttpClient http);

    // GET api/transferheaders?pageNumber={n}&pageSize={n}
    public async Task<List<TransferHeaderDto>> GetTransferHeadersAsync(
        int pageNumber = 1, int pageSize = 50);

    // POST api/transferheaders/post
    public async Task PostTransferResultAsync(PostTransferDto dto);
}

public abstract class BaseViewModel : INotifyPropertyChanged
{
    public bool   IsLoading    { get; set; }   // raises IsEmpty + IsNotLoading
    public bool   IsNotLoading { get; }        // computed: !IsLoading
    public bool   HasError     { get; set; }   // raises IsEmpty
    public string ErrorMessage { get; set; }

    public virtual bool IsEmpty { get; }       // override in subclasses

    public event PropertyChangedEventHandler? PropertyChanged;

    protected void OnPropertyChanged([CallerMemberName] string? propertyName = null);

    protected bool SetProperty<T>(
        ref T backingStore,
        T value,
        [CallerMemberName] string? propertyName = null);
}