Other Functions

QuartermasterCreateData and QuartermasterContentData both carry an optional location field with the same bounds; this fn exists to ensure they validate it the same way. Returns a list of validation failure strings–if it returns an empty array the location is valid (or absent, which is allowed).

QuartermasterCreateData and QuartermasterContentData both require location to be present when hideOwnerName is true, since it becomes the only way for other users to identify the item; this fn exists to ensure they enforce that the same way.

Three differernt POST structs contain username fields; this fn exists to ensure they all validate the username the same way. This fn is designed to return a list of validation failure strings–if it returns an empty array the username is valid.

Parses an ISO 8601 internet date-time, with or without fractional seconds. Swiftarr always emits fractional seconds but accepts timestamps that omit them.

Writes a durable log entry for a notification event that’s about to be (or was just) pushed to live sockets–see GET /api/v3/notification/log. One NotificationLogEntry row is created for the event itself, plus one NotificationRecipient row per user in recipients, so a broadcast notification sent to many users doesn’t duplicate its content once per recipient.

The log is a convenience history, not the source of truth for notification delivery, so a failure here is logged and swallowed rather than thrown–it should never prevent the actual notification from going out.

Returns the file system path for the given image filename. Makes sure all image directories in the path exist.

Currently, this fn returns paths in the form: /images///.jpg where “xx” is the first 2 characters of the filename.

Returns true when the image data is a format that can carry animation (GIF or WebP).

Detects the file extension for image data. Returns “jpg” for unrecognized formats.

Loads an image from data, auto-detecting format and applying EXIF rotation. Alpha is preserved — flattening only happens at JPEG export sites, since PNG/GIF/WebP outputs can carry transparency.

Resizes an image to thumbnail size and encodes it in the requested format. Returns nil if resize fails. JPEG output flattens any alpha onto a white background; PNG/GIF/WebP outputs preserve transparency.

Creates a thumbnail from an image and writes it to disk in the specified format. Silently skips thumbnail creation if resize fails, matching the original behavior.

Validates, processes and stores one image: full-size and thumbnail versions, in the image store. Returns the stored filename.

This is the single place image processing happens, shared by uploads (processImage) and anything that needs to store an image without a Request, such as migrations that seed records with images. The format is detected from the data’s contents, not any filename. PNG/GIF/WebP are kept in their own format when unmodified; everything else (JPEG, HEIC, AVIF, …) and anything we had to resize or crop is re-encoded as a JPEG, so the stored bytes always match the stored filename’s extension.

This is synchronous and does blocking file and image work, so request handlers should call it from a thread pool.

Register your application’s routes here.