refactor: add summary to http handler options

Author: MickVanDuijn

src/definition/handler/events/http.schema.ts

@@ -6,6 +6,7 @@ export const httpTrigger = $object({
         method: $enum(['get', 'post', 'put', 'delete', 'patch', 'options', 'head']),
         path: $string().describe('The HTTP path for the route. Must start with / and must not end with /.'),
         operationId: $string().optional().describe('The operation ID for the route.'),
+        summary: $string().optional().describe('The summary for the route.'),
 
         authorizer: $object({
             name: $string().describe('The name of the authorizer to use for the route.'),

src/definition/handler/events/http.type.ts

@@ -20,6 +20,10 @@ export interface HttpTrigger {
          * The operation ID for the route.
          */
         operationId?: string | undefined
+        /**
+         * The summary for the route.
+         */
+        summary?: string | undefined
         /**
          * The authorizer to use for the route, this overrides the default authorizer.
          */

src/definition/schemas/star-chart-handler.schema.json

@@ -165,6 +165,10 @@
               "type": "string",
               "description": "The operation ID for the route."
             },
+            "summary": {
+              "type": "string",
+              "description": "The summary for the route."
+            },
             "authorizer": {
               "type": "object",
               "description": "The authorizer to use for the route, this overrides the default authorizer.",