Files
OpenNest/OpenNest.Server/DrawingSetRequest.cs
T
ajandClaude Opus 5.5 be057bf337 feat(server): store versioned drawing sets
A drawing set is a named list of library drawings with quantities (a kit,
an assembly, a recurring order) that will later be released into one nest
per material. This is the server half: sets get the same revision,
If-Match and archive contract as /api/drawings so the client and tests
follow a known shape.

Schema v7 adds drawing_sets, drawing_set_revisions and
drawing_set_members. Members reference drawings by id and mean each
drawing's current revision, so reads join the current drawing record:
the client can group members by material without one request per drawing,
and the joined record is ignored on save so a read record can be sent
back unchanged. Every change keeps its own member list, and
/api/drawings/{id}/sets answers "used in" from current revisions only.

The drawing query's enum, integer and history-paging parsing is now shared
so both APIs refuse bad input identically.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-20 12:51:56 -04:00

141 lines
4.6 KiB
C#

using System.Text.Json;
using System.Text.Json.Nodes;
using OpenNest.Data;
namespace OpenNest.Server;
/// <summary>
/// Parses drawing set requests with the drawing library's strictness: unknown, repeated
/// or out-of-range values are rejected rather than ignored or clamped, and sort accepts
/// names only.
/// </summary>
internal static class DrawingSetRequest
{
private static readonly string[] QueryKeys =
{
"search", "customer", "includeArchived", "sort", "order", "offset", "limit",
};
private static readonly JsonSerializerOptions SetOptions = new(JsonSerializerDefaults.Web)
{
PropertyNameCaseInsensitive = true,
};
public static bool TryParseQuery(IQueryCollection values, out DrawingSetQuery query, out string error)
{
query = new DrawingSetQuery();
foreach (var key in values.Keys)
{
if (!QueryKeys.Contains(key, StringComparer.OrdinalIgnoreCase))
{
error = $"Unknown query parameter '{key}'.";
return false;
}
if (values[key].Count > 1)
{
error = $"Query parameter '{key}' was given more than once.";
return false;
}
}
var sort = DrawingSetSortField.SavedAt;
if (values.TryGetValue("sort", out var sortText) && !DrawingLibraryRequest.TryEnumName(sortText.ToString(), out sort))
{
error = $"sort must be one of: {string.Join(", ", Enum.GetNames<DrawingSetSortField>().Select(DrawingLibraryRequest.CamelCase))}.";
return false;
}
var descending = true;
if (values.TryGetValue("order", out var orderText))
{
if (string.Equals(orderText, "asc", StringComparison.OrdinalIgnoreCase))
{
descending = false;
}
else if (!string.Equals(orderText, "desc", StringComparison.OrdinalIgnoreCase))
{
error = "order must be asc or desc.";
return false;
}
}
var includeArchived = false;
if (values.TryGetValue("includeArchived", out var archivedText) && !bool.TryParse(archivedText.ToString(), out includeArchived))
{
error = "includeArchived must be true or false.";
return false;
}
var offset = 0;
var limit = DrawingSetQuery.DefaultLimit;
if (!DrawingLibraryRequest.TryInteger(values, "offset", ref offset, out error)
|| !DrawingLibraryRequest.TryInteger(values, "limit", ref limit, out error))
return false;
query = new DrawingSetQuery
{
Search = values["search"].ToString(),
Customer = values["customer"].ToString(),
IncludeArchived = includeArchived,
Sort = sort,
Descending = descending,
Offset = offset,
Limit = limit,
};
error = query.GetValidationError() ?? "";
return error.Length == 0;
}
/// <summary>
/// Reads and validates one set JSON object. <c>members</c> must be present; each
/// member's joined <c>drawing</c> is ignored, so a record read from the server may be
/// sent back as it is.
/// </summary>
public static bool TryReadSet(string? json, out DrawingSetRecord record, out string error)
{
record = new DrawingSetRecord();
if (string.IsNullOrWhiteSpace(json))
{
error = "Missing set.";
return false;
}
try
{
if (JsonNode.Parse(json) is not JsonObject root)
{
error = "The set must be a JSON object.";
return false;
}
var members = root.FirstOrDefault(p => string.Equals(p.Key, "members", StringComparison.OrdinalIgnoreCase));
if (members.Key is null)
{
error = "members is required.";
return false;
}
if (members.Value is JsonArray array)
{
foreach (var member in array.OfType<JsonObject>())
{
foreach (var key in member.Select(p => p.Key)
.Where(k => string.Equals(k, "drawing", StringComparison.OrdinalIgnoreCase)).ToList())
member.Remove(key);
}
}
record = root.Deserialize<DrawingSetRecord>(SetOptions) ?? record;
}
catch (JsonException)
{
error = "Invalid set JSON.";
return false;
}
error = DrawingSetRules.GetError(record) ?? "";
return error.Length == 0;
}
}