Use OpenAPI Operation block (#732)

Use and expose OpenAPI Operation block

Author: gregberge

.changeset/tall-dodos-trade.md

@@ -0,0 +1,6 @@
+---
+'@gitbook/integration-openapi': patch
+'@gitbook/document': patch
+---
+
+Add support for openapi-operation block

integrations/openapi/src/parser/group.test.ts

@@ -50,7 +50,7 @@ describe('#getGroupDocument', () => {
             },
             isVoid: true,
             object: 'block',
-            type: 'swagger',
+            type: 'openapi-operation',
         });
     });
 
@@ -118,7 +118,7 @@ describe('#getGroupDocument', () => {
             },
             isVoid: true,
             object: 'block',
-            type: 'swagger',
+            type: 'openapi-operation',
         });
     });
 });

integrations/openapi/src/parser/group.ts

@@ -17,7 +17,7 @@ export function getGroupDocument(args: {
     return doc.document([
         ...(group.tag ? getTagDescriptionNodes(group.tag) : []),
         ...operations.map((operation) => {
-            return doc.openapi({
+            return doc.openapiOperation({
                 ref: { kind: 'openapi', spec: specContent.slug },
                 method: operation.method,
                 path: operation.path,

packages/document/src/index.ts

@@ -38,6 +38,8 @@ export const images = blockFactory<api.DocumentBlockImages>('images');
 export const divider = voidBlockFactory<api.DocumentBlockDivider>('divider');
 export const file = voidBlockFactory<api.DocumentBlockFile>('file');
 export const openapi = voidBlockFactory<api.DocumentBlockOpenAPI>('swagger');
+export const openapiOperation =
+    voidBlockFactory<api.DocumentBlockOpenAPIOperation>('openapi-operation');
 
 /**
  * Code blocks.