Add new querystring parameter location

Author: mattpolzin

Sources/OpenAPIKit/Parameter/Parameter.swift

@@ -254,6 +254,9 @@ extension OpenAPI.Parameter: Encodable {
         case .cookie(required: let req):
             required = req
             location = .cookie
+        case .querystring(required: let req):
+            required = req
+            location = .querystring
         }
         try container.encode(location, forKey: .parameterLocation)
 
@@ -307,6 +310,8 @@ extension OpenAPI.Parameter: Decodable {
             context = .path
         case .cookie:
             context = .cookie(required: required)
+        case .querystring:
+            context = .querystring(required: required)
         }
 
         let maybeContent = try container.decodeIfPresent(OpenAPI.Content.Map.self, forKey: .content)
@@ -318,6 +323,14 @@ extension OpenAPI.Parameter: Decodable {
             maybeSchema = nil
         }
 
+        if location == .querystring && maybeSchema != nil {
+            throw GenericError(
+                subjectName: name,
+                details: "`schema` and `style` are disallowed for `querystring` parameters",
+                codingPath: decoder.codingPath
+            )
+        }
+
         switch (maybeContent, maybeSchema) {
         case (let content?, nil):
             schemaOrContent = .init(content)

Sources/OpenAPIKit/Parameter/ParameterContext.swift

@@ -21,6 +21,7 @@ extension OpenAPI.Parameter {
         case header(required: Bool)
         case path
         case cookie(required: Bool)
+        case querystring(required: Bool)
 
         public static func query(required: Bool) -> Context { return .query(required: required, allowEmptyValue: false) }
 
@@ -36,6 +37,9 @@ extension OpenAPI.Parameter {
         /// An optional cookie parameter.
         public static var cookie: Context { return .cookie(required: false) }
 
+        /// An optional querystring parameter.
+        public static var querystring: Context { return .querystring(required: false) }
+
         public var inQuery: Bool {
             guard case .query = self else {
                 return false
@@ -59,11 +63,19 @@ extension OpenAPI.Parameter {
             return true
         }
 
+        public var inQuerystring: Bool {
+            guard case .querystring = self else {
+                return false
+            }
+            return true
+        }
+
         public var required: Bool {
             switch self {
             case .query(required: let required, allowEmptyValue: _),
                  .header(required: let required),
-                 .cookie(required: let required):
+                 .cookie(required: let required),
+                 .querystring(required: let required):
                 return required
             case .path:
                 return true
@@ -83,6 +95,8 @@ extension OpenAPI.Parameter.Context {
             return .path
         case .cookie:
             return .cookie
+        case .querystring:
+            return .querystring
         }
     }
 }

Sources/OpenAPIKit/Parameter/ParameterContextLocation.swift

@@ -0,0 +1,20 @@
+//
+//  ParameterContextLocation.swift
+//  
+//
+//  Created by Mathew Polzin on 12/24/22.
+//
+
+import OpenAPIKitCore
+
+extension OpenAPI.Parameter.Context {
+    public enum Location: String, CaseIterable, Codable {
+        case query
+        case header
+        case path
+        case cookie
+        case querystring
+    }
+}
+
+extension OpenAPI.Parameter.Context.Location: Validatable {}

Sources/OpenAPIKit/Parameter/ParameterSchemaContext.swift

@@ -143,6 +143,8 @@ extension OpenAPI.Parameter.SchemaContext.Style {
             return .simple
         case .header:
             return .simple
+        case .querystring:
+            return .simple
         }
     }
 

Sources/OpenAPIKit/_CoreReExport.swift

@@ -31,10 +31,6 @@ public extension OpenAPI.SecurityScheme {
     typealias Location = OpenAPIKitCore.Shared.SecuritySchemeLocation
 }
 
-public extension OpenAPI.Parameter.Context {
-    typealias Location = OpenAPIKitCore.Shared.ParameterContextLocation
-}
-
 public extension OpenAPI.Parameter.SchemaContext {
     typealias Style = OpenAPIKitCore.Shared.ParameterSchemaContextStyle
 }

Sources/OpenAPIKit30/Parameter/ParameterContextLocation.swift

@@ -0,0 +1,19 @@
+//
+//  ParameterContextLocation.swift
+//  
+//
+//  Created by Mathew Polzin on 12/24/22.
+//
+
+import OpenAPIKitCore
+
+extension OpenAPI.Parameter.Context {
+    public enum Location: String, CaseIterable, Codable {
+        case query
+        case header
+        case path
+        case cookie
+    }
+}
+
+extension OpenAPI.Parameter.Context.Location: Validatable {}

Sources/OpenAPIKit30/_CoreReExport.swift

@@ -31,10 +31,6 @@ public extension OpenAPI.SecurityScheme {
     typealias Location = OpenAPIKitCore.Shared.SecuritySchemeLocation
 }
 
-public extension OpenAPI.Parameter.Context {
-    typealias Location = OpenAPIKitCore.Shared.ParameterContextLocation
-}
-
 public extension OpenAPI.Parameter.SchemaContext {
     typealias Style = OpenAPIKitCore.Shared.ParameterSchemaContextStyle
 }