Files
zeekay 0c2f028a8c Generate the Swift client, which this copy did not carry
The forge tree held the package scaffolding and none of the generated sources —
2,435 files of APIs, Models and Infrastructure, including BaseAPI, were simply
absent, so anything depending on this copy had a package that compiled to
nothing usable.

Generated from the current API document rather than reconciled with the other
copy: a client is a function of the spec, so regenerating answers "which history
wins" without anyone having to choose. .spec-lock records which document, so the
next reader can tell.
2026-08-23 10:04:41 -07:00

162 lines
6.1 KiB
Swift

// Validation.swift
//
// Generated by openapi-generator
// https://openapi-generator.tech
//
import Foundation
public struct StringRule: Sendable {
public var minLength: Int?
public var maxLength: Int?
public var pattern: String?
}
public struct NumericRule<T: Comparable & Numeric> {
public var minimum: T?
public var exclusiveMinimum = false
public var maximum: T?
public var exclusiveMaximum = false
public var multipleOf: T?
}
extension NumericRule: Sendable where T: Sendable {}
public struct ArrayRule: Sendable {
public var minItems: Int?
public var maxItems: Int?
public var uniqueItems: Bool
}
public enum StringValidationErrorKind: Error {
case minLength, maxLength, pattern
}
public enum NumericValidationErrorKind: Error {
case minimum, maximum, multipleOf
}
public enum ArrayValidationErrorKind: Error {
case minItems, maxItems, uniqueItems
}
public struct ValidationError<T: Error & Hashable>: Error {
public fileprivate(set) var kinds: Set<T>
}
public struct Validator {
/// Validate a string against a rule.
/// - Parameter string: The String you wish to validate.
/// - Parameter rule: The StringRule you wish to use for validation.
/// - Returns: A validated string.
/// - Throws: `ValidationError<StringValidationErrorKind>` if the string is invalid against the rule or if the rule.pattern is invalid.
public static func validate(_ string: String, against rule: StringRule) throws(ValidationError<StringValidationErrorKind>) -> String {
var error = ValidationError<StringValidationErrorKind>(kinds: [])
if let minLength = rule.minLength, !(minLength <= string.count) {
error.kinds.insert(.minLength)
}
if let maxLength = rule.maxLength, !(string.count <= maxLength) {
error.kinds.insert(.maxLength)
}
if let pattern = rule.pattern {
let matches = try? NSRegularExpression(pattern: pattern, options: .caseInsensitive)
.matches(in: string, range: .init(location: 0, length: string.utf16.count))
if matches?.isEmpty != false {
error.kinds.insert(.pattern)
}
}
guard error.kinds.isEmpty else {
throw error
}
return string
}
/// Validate a integer against a rule.
/// - Parameter numeric: The integer you wish to validate.
/// - Parameter rule: The NumericRule you wish to use for validation.
/// - Returns: A validated integer.
/// - Throws: `ValidationError<NumericValidationErrorKind>` if the numeric is invalid against the rule.
public static func validate<T: Comparable & BinaryInteger>(_ numeric: T, against rule: NumericRule<T>) throws(ValidationError<NumericValidationErrorKind>) -> T {
var error = ValidationError<NumericValidationErrorKind>(kinds: [])
if let minimum = rule.minimum {
if !rule.exclusiveMinimum, minimum > numeric {
error.kinds.insert(.minimum)
}
if rule.exclusiveMinimum, minimum >= numeric {
error.kinds.insert(.minimum)
}
}
if let maximum = rule.maximum {
if !rule.exclusiveMaximum, numeric > maximum {
error.kinds.insert(.maximum)
}
if rule.exclusiveMaximum, numeric >= maximum {
error.kinds.insert(.maximum)
}
}
if let multipleOf = rule.multipleOf, !numeric.isMultiple(of: multipleOf) {
error.kinds.insert(.multipleOf)
}
guard error.kinds.isEmpty else {
throw error
}
return numeric
}
/// Validate a fractional number against a rule.
/// - Parameter numeric: The fractional number you wish to validate.
/// - Parameter rule: The NumericRule you wish to use for validation.
/// - Returns: A validated fractional number.
/// - Throws: `ValidationError<NumericValidationErrorKind>` if the numeric is invalid against the rule.
public static func validate<T: Comparable & FloatingPoint>(_ numeric: T, against rule: NumericRule<T>) throws(ValidationError<NumericValidationErrorKind>) -> T {
var error = ValidationError<NumericValidationErrorKind>(kinds: [])
if let minimum = rule.minimum {
if !rule.exclusiveMinimum, minimum > numeric {
error.kinds.insert(.minimum)
}
if rule.exclusiveMinimum, minimum >= numeric {
error.kinds.insert(.minimum)
}
}
if let maximum = rule.maximum {
if !rule.exclusiveMaximum, numeric > maximum {
error.kinds.insert(.maximum)
}
if rule.exclusiveMaximum, numeric >= maximum {
error.kinds.insert(.maximum)
}
}
if let multipleOf = rule.multipleOf, numeric.remainder(dividingBy: multipleOf) != 0 {
error.kinds.insert(.multipleOf)
}
guard error.kinds.isEmpty else {
throw error
}
return numeric
}
/// Validate a array against a rule.
/// - Parameter array: The Array you wish to validate.
/// - Parameter rule: The ArrayRule you wish to use for validation.
/// - Returns: A validated array.
/// - Throws: `ValidationError<ArrayValidationErrorKind>` if the string is invalid against the rule.
public static func validate(_ array: Array<AnyHashable>, against rule: ArrayRule) throws(ValidationError<ArrayValidationErrorKind>) -> Array<AnyHashable> {
var error = ValidationError<ArrayValidationErrorKind>(kinds: [])
if let minItems = rule.minItems, !(minItems <= array.count) {
error.kinds.insert(.minItems)
}
if let maxItems = rule.maxItems, !(array.count <= maxItems) {
error.kinds.insert(.maxItems)
}
if rule.uniqueItems {
let unique = Set(array)
if unique.count != array.count {
error.kinds.insert(.uniqueItems)
}
}
guard error.kinds.isEmpty else {
throw error
}
return array
}
}