Attach namespace extensions to the root of the doc (#3890)

This PR seeks to update the emitter by adding the extensions defined on a namespace to the root of the OpenApi document. Fixes #3837 --------- Co-authored-by: Timothee Guerin <[email protected]>
microsoft · Jul 18, 2024 · 8d8e454 · 8d8e454
1 parent 61807aa
commit 8d8e454
Show file tree

Hide file tree

Showing 3 changed files with 19 additions and 0 deletions.
diff --git a/.chronus/changes/mk-set-root-extensions-2024-6-18-19-20-36.md b/.chronus/changes/mk-set-root-extensions-2024-6-18-19-20-36.md
@@ -0,0 +1,7 @@
+---
+changeKind: feature
+packages:
+  - "@typespec/openapi3"
+---
+
+`@extension` used on the service namespace will set extension at the root of the document
diff --git a/packages/openapi3/src/openapi.ts b/packages/openapi3/src/openapi.ts
@@ -347,6 +347,7 @@ function createOAPIEmitter(
       root.servers = resolveServers(servers);
     }
 
+    attachExtensions(program, service.type, root);
     serviceNamespaceName = getNamespaceFullName(service.type);
     currentPath = root.paths;
 

diff --git a/packages/openapi3/test/openapi-output.test.ts b/packages/openapi3/test/openapi-output.test.ts
@@ -249,6 +249,17 @@ describe("openapi3: extension decorator", () => {
     strictEqual(oapi.components.parameters.PetId["x-parameter-extension"], "foobaz");
   });
 
+  it("adds an extension to a namespace", async () => {
+    const oapi = await openApiFor(
+      `
+      @extension("x-namespace-extension", "foobar")
+      @service namespace Service {};
+      `
+    );
+
+    strictEqual(oapi["x-namespace-extension"], "foobar");
+  });
+
   it("check format and pattern decorator on model", async () => {
     const oapi = await openApiFor(
       `