155 lines
7.3 KiB
C#
155 lines
7.3 KiB
C#
using System.Text.Json;
|
||
|
||
namespace MoShiro.Backend.Api;
|
||
|
||
/// <summary><c>return_session</c>：跨域的前端用——不设 Cookie，把会话令牌放在响应里，之后用 <c>Authorization: Bearer</c> 带上。</summary>
|
||
public sealed record LoginRequest(string Username, string Password, bool? ReturnSession);
|
||
|
||
public sealed record LoginResponse(string UserId, string Username, string CsrfToken, DateTimeOffset ExpiresAt, string? SessionToken);
|
||
|
||
public sealed record MeDto(string Kind, string Scope, string? UserId, string? Username, string? CsrfToken);
|
||
|
||
public sealed record LocalLimitsDto(double MaxTotalMbps, long MaxTotalPps, IReadOnlyList<string> AllowedTargetCidrs, int MaxConcurrentTests);
|
||
|
||
public sealed record RejectedDto(string Id, string Reason);
|
||
|
||
public sealed record HeartbeatDto(int Sessions, long PpsIn, long PpsOut, long DroppedInvalid, long DroppedRateLimited, long QueueBytes, DateTimeOffset At);
|
||
|
||
public sealed record AgentDto(
|
||
string Id,
|
||
string Name,
|
||
string Status,
|
||
bool Online,
|
||
bool ProbeConnected,
|
||
IReadOnlyList<ConnectedProbeDto> Probes,
|
||
HostDto? Host,
|
||
string PublicHost,
|
||
int ProbeTcpPort,
|
||
IReadOnlyList<int> ProbeUdpPorts,
|
||
IReadOnlyList<string> Labels,
|
||
bool PublicVisible,
|
||
IReadOnlyList<string> Kinds,
|
||
string? AgentVersion,
|
||
LocalLimitsDto? LocalLimits,
|
||
long TaskVersion,
|
||
long AppliedTaskVersion,
|
||
IReadOnlyList<RejectedDto> Rejected,
|
||
HeartbeatDto? Heartbeat,
|
||
int EndpointChanges,
|
||
DateTimeOffset CreatedAt,
|
||
DateTimeOffset? LastSeenAt,
|
||
string Ipv6Host = "",
|
||
bool Ipv6Supported = false,
|
||
Ipv6DiagnosticDto? Ipv6 = null);
|
||
|
||
public sealed record Ipv6DiagnosticDto(bool? AddressConfigured, bool SocketSupported, bool? Listening, bool? HasGlobalAddress, bool? HasDefaultRoute, string State,
|
||
string NetworkScope = "unknown", bool? HostHasGlobalAddress = null, bool? HostHasDefaultRoute = null);
|
||
|
||
/// <summary>merge-patch：缺省或为 null 的字段不修改。</summary>
|
||
public sealed record AgentPatchRequest(string? Name, IReadOnlyList<string>? Labels, string? PublicHost, bool? PublicVisible, string? Ipv6Host = null);
|
||
|
||
public sealed record JoinTokenDto(string Id, string? Note, IReadOnlyList<string> Labels, bool AutoApprove, int MaxUses, int Uses, DateTimeOffset ExpiresAt, DateTimeOffset? RevokedAt, DateTimeOffset CreatedAt);
|
||
|
||
public sealed record CreateJoinTokenRequest(string? Note, IReadOnlyList<string>? Labels, bool? AutoApprove, int? MaxUses, int? ExpiresInHours);
|
||
|
||
/// <summary>令牌明文只在创建的响应里出现一次。</summary>
|
||
public sealed record InstallCommandsDto(string Linux, string Macos, string Windows);
|
||
|
||
public sealed record CreatedJoinTokenDto(JoinTokenDto Token, string Plaintext, InstallCommandsDto InstallCommands);
|
||
|
||
/// <summary>Agent 眼中连着的一个 Probe（Agent 上报）。</summary>
|
||
public sealed record ConnectedProbeDto(string ProbeId, string? Version, string? Remote, DateTimeOffset ConnectedSince, string IpVersion = "ipv4");
|
||
|
||
/// <summary>某个 Probe 现在连着的一个 Agent。</summary>
|
||
public sealed record ProbeConnectionDto(string AgentId, string AgentName, bool AgentOnline, string? Version, string? Remote, DateTimeOffset ConnectedSince, string IpVersion = "ipv4");
|
||
|
||
public sealed record ProbeDto(string Id, string Name, DateTimeOffset CreatedAt, DateTimeOffset? RevokedAt, bool Revoked, bool Online, IReadOnlyList<ProbeConnectionDto> Connections, Ipv6DiagnosticDto? Ipv6 = null);
|
||
|
||
/// <summary>一对（Probe，Agent）的线路开关：<c>linked</c> 是最终结果，<c>override</c> 是手动设置（<c>null</c> = 跟随自动连接），<c>connected</c> 是现在有没有连着。</summary>
|
||
public sealed record LinkDto(string ProbeId, string ProbeName, string AgentId, string AgentName, bool Linked, bool? Override, bool Connected);
|
||
|
||
public sealed record LinkMatrixDto(bool AutoLink, IReadOnlyList<LinkDto> Items);
|
||
|
||
public sealed record SetLinkRequest(bool? Enabled);
|
||
|
||
public sealed record ProbeLimitsDto(double MaxTestMbps, long MaxTotalPps);
|
||
|
||
/// <summary><c>probe.json</c>：含私钥，只在生成时返回一次。</summary>
|
||
public sealed record ProbeIdentityDto(string ProbeId, string PrivateKey, string Server, ProbeLimitsDto Limits);
|
||
|
||
public sealed record CreateProbeRequest(string? Name);
|
||
|
||
public sealed record PatchProbeRequest(string? Name);
|
||
|
||
public sealed record TaskDto(
|
||
string Id,
|
||
string Scope,
|
||
string? AgentId,
|
||
string? BaseTaskId,
|
||
string Kind,
|
||
string? Target,
|
||
IReadOnlyDictionary<string, JsonElement> Params,
|
||
string Schedule,
|
||
bool Enabled,
|
||
DateTimeOffset UpdatedAt);
|
||
|
||
public sealed record CreateTaskRequest(
|
||
string Scope,
|
||
string Kind,
|
||
string? Target,
|
||
Dictionary<string, JsonElement>? Params,
|
||
string? Schedule,
|
||
bool? Enabled,
|
||
string? AgentId,
|
||
string? BaseTaskId);
|
||
|
||
public sealed record PatchTaskRequest(Dictionary<string, JsonElement>? Params, string? Schedule, bool? Enabled, string? Target);
|
||
|
||
public sealed record StartTestRequestDto(string Plan, Dictionary<string, JsonElement>? Params);
|
||
|
||
public sealed record RawChunkMetaDto(
|
||
string ChunkId,
|
||
string AgentId,
|
||
string Series,
|
||
string Kind,
|
||
string? TaskId,
|
||
string? TestId,
|
||
int? Phase,
|
||
DateTimeOffset Start,
|
||
int DurationMs,
|
||
bool Partial,
|
||
int Bytes);
|
||
|
||
public sealed record ApiTokenDto(string Id, string Name, string Scope, DateTimeOffset CreatedAt, DateTimeOffset? LastUsedAt, DateTimeOffset? RevokedAt);
|
||
|
||
public sealed record CreateApiTokenRequest(string Name, string Scope);
|
||
|
||
public sealed record CreatedApiTokenDto(ApiTokenDto Token, string Plaintext);
|
||
|
||
public sealed record SettingDto(string Key, string Type, string Value, string Default, string Description);
|
||
|
||
public sealed record UserDto(string Id, string Username, DateTimeOffset CreatedAt);
|
||
|
||
public sealed record CreateUserRequest(string Username, string Password);
|
||
|
||
public sealed record ChangePasswordRequest(string Password);
|
||
|
||
public sealed record RecomputeDto(string State, IReadOnlyList<string> Metrics, long WindowsDone, long WindowsTotal, DateTimeOffset? From, DateTimeOffset? To, int QueueLength);
|
||
|
||
/// <summary>管理端看的构建信息：每个节点自报的版本、tag、提交和构建时间，以及系统。</summary>
|
||
public sealed record NodeBuildDto(string Id, string Kind, string? Os, string? OsName, string? Arch, string? Version, string? Tag, string? Commit, string? BuiltAt, NodeUpdateDto? Update = null);
|
||
|
||
/// <summary>节点宿主机上的更新器报告的状态（<c>up_to_date</c>、<c>available</c>、<c>applying</c>、<c>failed</c>、<c>rolled_back</c>、<c>invalid</c>）；没装更新器的节点没有这个字段。</summary>
|
||
public sealed record NodeUpdateDto(string State, string? CurrentDigest, string? AvailableTag, string? AvailableVersion, string? Error, DateTimeOffset? At);
|
||
|
||
/// <summary>面板登记的最新发布清单（CI 签名的；验签在节点上）。</summary>
|
||
public sealed record ReleaseDto(string Component, long Seq, string Tag, string Version, string Digest, string Channel = "release");
|
||
|
||
public sealed record PublishReleaseRequest(string? Manifest, string? Signature);
|
||
|
||
public sealed record BackendUpdateDto(string Channel, bool Enabled, string State, string? CurrentTag, string? CurrentDigest, ReleaseDto? Available, string? Error);
|
||
|
||
public sealed record ConfirmBackendUpdateRequest(long Seq);
|
||
|
||
public sealed record BuildInfoDto(BuildDto Backend, IReadOnlyList<NodeBuildDto> Nodes, BackendUpdateDto? BackendUpdate = null);
|