feat(http): surface callbacks webhooks and links (#250)

Author: HavenDV

README.md

@@ -37,6 +37,9 @@ autosdk generate openapi.yaml \
 It will generate the code in the "Generated" subdirectory.  
 It also will include polyfills for .Net Framework/.Net Standard TargetFrameworks.
 
+## HTTP Artifacts
+`autosdk http` emits executable request files for regular OpenAPI path operations. It also surfaces response links and callbacks as commented documentation blocks next to the owning operation, and writes root-level OpenAPI webhooks to `webhooks.http` as inbound contract documentation instead of outbound client calls.
+
 ## Source generator
 - Install the package
 ```bash
@@ -213,4 +216,4 @@ Skill source: [`skills/generating-dotnet-sdks/`](skills/generating-dotnet-sdks/)
 - https://github.com/tryAGI/Replicate
 - https://github.com/tryAGI/DeepInfra
 - https://github.com/tryAGI/Leonardo
-- https://github.com/HavenDV/GitHub.NET
+- https://github.com/HavenDV/GitHub.NET

specs/callbacks-webhooks-links.yaml

@@ -0,0 +1,132 @@
+openapi: 3.1.0
+info:
+  title: Callback Webhook Link Fixture
+  version: 1.0.0
+paths:
+  /subscriptions:
+    post:
+      operationId: createSubscription
+      summary: Create subscription
+      tags:
+        - subscriptions
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required:
+                - callbackUrl
+                - topic
+              properties:
+                callbackUrl:
+                  type: string
+                  format: uri
+                topic:
+                  type: string
+      callbacks:
+        subscriptionStatus:
+          '{$request.body#/callbackUrl}':
+            post:
+              operationId: subscriptionStatusCallback
+              summary: Receive subscription status
+              requestBody:
+                required: true
+                content:
+                  application/json:
+                    schema:
+                      type: object
+                      required:
+                        - subscriptionId
+                        - state
+                      properties:
+                        subscriptionId:
+                          type: string
+                        state:
+                          type: string
+              responses:
+                '200':
+                  description: Callback acknowledged
+      responses:
+        '201':
+          description: Created
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/SubscriptionAccepted'
+          links:
+            subscriptionStatus:
+              operationId: getSubscriptionStatus
+              description: Follow the created subscription status
+              parameters:
+                subscriptionId: '$response.body#/id'
+  /subscriptions/{subscriptionId}:
+    get:
+      operationId: getSubscriptionStatus
+      summary: Get subscription status
+      tags:
+        - subscriptions
+      parameters:
+        - in: path
+          name: subscriptionId
+          required: true
+          schema:
+            type: string
+      responses:
+        '200':
+          description: Current subscription status
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/SubscriptionStatus'
+webhooks:
+  subscription.updated:
+    post:
+      operationId: subscriptionUpdatedWebhook
+      summary: Subscription updated webhook
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required:
+                - event
+                - data
+              properties:
+                event:
+                  type: string
+                data:
+                  type: object
+                  required:
+                    - id
+                    - state
+                  properties:
+                    id:
+                      type: string
+                    state:
+                      type: string
+      responses:
+        '200':
+          description: Webhook acknowledged
+components:
+  schemas:
+    SubscriptionAccepted:
+      type: object
+      required:
+        - id
+      properties:
+        id:
+          type: string
+        status:
+          type: string
+    SubscriptionStatus:
+      type: object
+      required:
+        - id
+        - state
+      properties:
+        id:
+          type: string
+        state:
+          type: string

src/libs/AutoSDK.CLI/Commands/HttpCommand.cs

@@ -104,6 +104,7 @@ private async Task HandleAsync(ParseResult parseResult)
         var openApiDocument = yaml.GetOpenApiDocument(settings);
         var schemas = openApiDocument.GetSchemas(settings);
         var operations = openApiDocument.GetOperations(settings, globalSettings: settings, schemas);
+        var webhookOperations = openApiDocument.GetWebhookOperations(settings, globalSettings: settings, schemas);
 
         // Extract security schemes from document components
         var securitySchemes = (openApiDocument.Components?.SecuritySchemes?.Values ?? [])
@@ -143,6 +144,12 @@ private async Task HandleAsync(ParseResult parseResult)
             }
         }
 
+        var webhooksFile = Sources.WebhooksHttpFile(webhookOperations);
+        if (!webhooksFile.IsEmpty)
+        {
+            httpFiles.Add(webhooksFile);
+        }
+
         Directory.CreateDirectory(output);
 
         if (singleFile)