Filter out ignored entities

.changeset/tricky-rules-act.md

@@ -0,0 +1,5 @@
+---
+'@gitbook/integration-openapi': patch
+---
+
+Filter out ignored tags and operations

integrations/openapi/package.json

@@ -12,7 +12,7 @@
         "@gitbook/api": "*",
         "@gitbook/runtime": "*",
         "@gitbook/document": "*",
-        "@gitbook/openapi-parser": "^2.0.0"
+        "@gitbook/openapi-parser": "^2.0.1"
     },
     "devDependencies": {
         "@gitbook/cli": "workspace:*",

integrations/openapi/src/parser/spec.ts

@@ -1,7 +1,6 @@
 import { ExposableError } from '@gitbook/runtime';
-import { dereference, type OpenAPIV3 } from '@gitbook/openapi-parser';
-import { GitBookAPI, OpenAPISpec } from '@gitbook/api';
-import { assert } from '../utils';
+import { dereference, type OpenAPIV3, shouldIgnoreEntity } from '@gitbook/openapi-parser';
+import { GitBookAPI } from '@gitbook/api';
 
 type HttpMethod = 'get' | 'post' | 'put' | 'delete' | 'options' | 'head' | 'patch' | 'trace';
 
@@ -122,6 +121,11 @@ export function divideOpenAPISpecSchema(schema: OpenAPIV3.Document): OpenAPIGrou
                 return;
             }
 
+            // Ignore operations marked as ignored in the spec.
+            if (shouldIgnoreEntity(operation)) {
+                return;
+            }
+
             const firstExistingTag = operation.tags?.find((tag) =>
                 schema.tags?.some((t) => t.name === tag),
             );
@@ -134,6 +138,10 @@ export function divideOpenAPISpecSchema(schema: OpenAPIV3.Document): OpenAPIGrou
     // If the schema has tags, use this order to sort the groups.
     if (schema.tags) {
         return schema.tags.reduce<OpenAPIGroup[]>((tagGroups, tag) => {
+            // Ignore tags marked as ignored in the spec.
+            if (shouldIgnoreEntity(tag)) {
+                return tagGroups;
+            }
             const group = groups.find((group) => group.id === tag.name);
             if (group) {
                 tagGroups.push(group);