@usearazzo/runner 0.0.0-stage → 1.0.1-alpha.11

package/src/assembler/OpenAPI2DocumentAssembler.cjs

@@ -0,0 +1,111 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _apidomCore = require("@speclynx/apidom-core");
+var _apidomDatamodel = require("@speclynx/apidom-datamodel");
+var _apidomJsonPointer = require("@speclynx/apidom-json-pointer");
+var _apidomNsOpenapi = require("@speclynx/apidom-ns-openapi-2");
+var _OpenAPIDocument = _interopRequireDefault(require("../document/OpenAPIDocument.cjs"));
+var _OpenAPIOperationIndex = _interopRequireDefault(require("../document/OpenAPIOperationIndex.cjs"));
+var _AssemblerError = _interopRequireDefault(require("../errors/AssemblerError.cjs"));
+/**
+ * Assembles a standalone OpenAPI 2.0 (Swagger) document from a
+ * normalized operation element.
+ *
+ * The assembled document is a valid Swagger 2.0 specification containing
+ * only the single operation with its host, basePath, schemes, and
+ * referenced security definitions from the source document.
+ * @public
+ */
+class OpenAPI2DocumentAssembler {
+  /**
+   * Assembles a standalone Swagger 2.0 document from a normalized operation.
+   */
+  assemble(operation, document) {
+    const entry = document.parseResult.api;
+    const method = (0, _apidomCore.toValue)(operation.meta.get('http-method'));
+    const path = (0, _apidomCore.toValue)(operation.meta.get('path'));
+    if (typeof method !== 'string' || typeof path !== 'string') {
+      throw new _AssemblerError.default(`Operation is missing valid "http-method" or "path" metadata. Was it produced by OpenAPIOperationExtractor?`, {
+        uri: document.uri,
+        operationId: (0, _apidomCore.toValue)(operation.operationId)
+      });
+    }
+    if (!(0, _apidomNsOpenapi.isSwaggerElement)(entry)) {
+      throw new _AssemblerError.default(`Expected OpenAPI 2.0 document at "${document.uri}"`, {
+        uri: document.uri
+      });
+    }
+
+    // build Swagger 2.0 document
+    const swagger = new _apidomNsOpenapi.SwaggerElement({
+      swagger: entry.swagger
+    }, {
+      classes: ['api']
+    });
+    // prettier-ignore
+    {
+      if ((0, _apidomDatamodel.isElement)(entry.info)) swagger.info = entry.info;
+      if ((0, _apidomDatamodel.isElement)(entry.host)) swagger.host = entry.host;
+      if ((0, _apidomDatamodel.isElement)(entry.basePath)) swagger.basePath = entry.basePath;
+      if ((0, _apidomDatamodel.isElement)(entry.schemes)) swagger.schemes = entry.schemes;
+      if ((0, _apidomDatamodel.isElement)(entry.consumes)) swagger.consumes = entry.consumes;
+      if ((0, _apidomDatamodel.isElement)(entry.produces)) swagger.produces = entry.produces;
+      if ((0, _apidomDatamodel.isElement)(entry.tags)) swagger.tags = entry.tags;
+      if ((0, _apidomDatamodel.isElement)(entry.externalDocs)) swagger.externalDocs = entry.externalDocs;
+    }
+
+    // build paths with single operation
+    const pathItem = new _apidomNsOpenapi.PathItemElement();
+    const paths = new _apidomNsOpenapi.PathsElement();
+    pathItem.set(method, operation);
+    paths.set(path, pathItem);
+    swagger.paths = paths;
+
+    // include only referenced security definitions
+    const securityDefinitions = this.#extractReferencedSecurityDefinitions(operation, entry);
+    if (securityDefinitions.length > 0) {
+      swagger.securityDefinitions = securityDefinitions;
+    }
+
+    // wrap in ParseResultElement and return as OpenAPIDocument
+    const parseResult = new _apidomDatamodel.ParseResultElement([swagger]);
+    const operationIndex = new _OpenAPIOperationIndex.default();
+    const operationId = (0, _apidomCore.toValue)(operation.operationId);
+    if (typeof operationId === 'string' && operationId.length > 0) {
+      operationIndex.set(operationId, (0, _apidomJsonPointer.compile)(['paths', path, method]));
+    }
+    return new _OpenAPIDocument.default(document.uri, parseResult, operationIndex);
+  }
+
+  /**
+   * Extracts only the security definitions referenced by the operation's
+   * security requirements.
+   */
+  #extractReferencedSecurityDefinitions(operation, entry) {
+    const securityDefinitions = new _apidomNsOpenapi.SecurityDefinitionsElement();
+    if (!(0, _apidomDatamodel.isArrayElement)(operation.security)) return securityDefinitions;
+    if (!(0, _apidomNsOpenapi.isSecurityDefinitionsElement)(entry.securityDefinitions)) return securityDefinitions;
+
+    // collect referenced names of Security Definitions
+    const referencedNames = new Set();
+    for (const securityRequirement of operation.security) {
+      if (!(0, _apidomNsOpenapi.isSecurityRequirementElement)(securityRequirement)) continue;
+      securityRequirement.forEach((_value, keyElement) => {
+        referencedNames.add((0, _apidomCore.toValue)(keyElement));
+      });
+    }
+    if (referencedNames.size === 0) return securityDefinitions;
+    for (const name of referencedNames) {
+      const securityScheme = entry.securityDefinitions.get(name);
+      if (!(0, _apidomNsOpenapi.isSecuritySchemeElement)(securityScheme)) continue;
+      securityDefinitions.set(name, securityScheme);
+    }
+    return securityDefinitions;
+  }
+}
+var _default = exports.default = OpenAPI2DocumentAssembler;

package/src/assembler/OpenAPI2DocumentAssembler.mjs

@@ -0,0 +1,104 @@
+import { toValue } from '@speclynx/apidom-core';
+import { isArrayElement, isElement, ParseResultElement } from '@speclynx/apidom-datamodel';
+import { compile } from '@speclynx/apidom-json-pointer';
+import { SwaggerElement, PathsElement, PathItemElement, SecurityDefinitionsElement, isSwaggerElement, isSecurityRequirementElement, isSecurityDefinitionsElement, isSecuritySchemeElement } from '@speclynx/apidom-ns-openapi-2';
+import OpenAPIDocument from "../document/OpenAPIDocument.mjs";
+import OpenAPIOperationIndex from "../document/OpenAPIOperationIndex.mjs";
+import AssemblerError from "../errors/AssemblerError.mjs";
+/**
+ * Assembles a standalone OpenAPI 2.0 (Swagger) document from a
+ * normalized operation element.
+ *
+ * The assembled document is a valid Swagger 2.0 specification containing
+ * only the single operation with its host, basePath, schemes, and
+ * referenced security definitions from the source document.
+ * @public
+ */
+class OpenAPI2DocumentAssembler {
+  /**
+   * Assembles a standalone Swagger 2.0 document from a normalized operation.
+   */
+  assemble(operation, document) {
+    const entry = document.parseResult.api;
+    const method = toValue(operation.meta.get('http-method'));
+    const path = toValue(operation.meta.get('path'));
+    if (typeof method !== 'string' || typeof path !== 'string') {
+      throw new AssemblerError(`Operation is missing valid "http-method" or "path" metadata. Was it produced by OpenAPIOperationExtractor?`, {
+        uri: document.uri,
+        operationId: toValue(operation.operationId)
+      });
+    }
+    if (!isSwaggerElement(entry)) {
+      throw new AssemblerError(`Expected OpenAPI 2.0 document at "${document.uri}"`, {
+        uri: document.uri
+      });
+    }
+
+    // build Swagger 2.0 document
+    const swagger = new SwaggerElement({
+      swagger: entry.swagger
+    }, {
+      classes: ['api']
+    });
+    // prettier-ignore
+    {
+      if (isElement(entry.info)) swagger.info = entry.info;
+      if (isElement(entry.host)) swagger.host = entry.host;
+      if (isElement(entry.basePath)) swagger.basePath = entry.basePath;
+      if (isElement(entry.schemes)) swagger.schemes = entry.schemes;
+      if (isElement(entry.consumes)) swagger.consumes = entry.consumes;
+      if (isElement(entry.produces)) swagger.produces = entry.produces;
+      if (isElement(entry.tags)) swagger.tags = entry.tags;
+      if (isElement(entry.externalDocs)) swagger.externalDocs = entry.externalDocs;
+    }
+
+    // build paths with single operation
+    const pathItem = new PathItemElement();
+    const paths = new PathsElement();
+    pathItem.set(method, operation);
+    paths.set(path, pathItem);
+    swagger.paths = paths;
+
+    // include only referenced security definitions
+    const securityDefinitions = this.#extractReferencedSecurityDefinitions(operation, entry);
+    if (securityDefinitions.length > 0) {
+      swagger.securityDefinitions = securityDefinitions;
+    }
+
+    // wrap in ParseResultElement and return as OpenAPIDocument
+    const parseResult = new ParseResultElement([swagger]);
+    const operationIndex = new OpenAPIOperationIndex();
+    const operationId = toValue(operation.operationId);
+    if (typeof operationId === 'string' && operationId.length > 0) {
+      operationIndex.set(operationId, compile(['paths', path, method]));
+    }
+    return new OpenAPIDocument(document.uri, parseResult, operationIndex);
+  }
+
+  /**
+   * Extracts only the security definitions referenced by the operation's
+   * security requirements.
+   */
+  #extractReferencedSecurityDefinitions(operation, entry) {
+    const securityDefinitions = new SecurityDefinitionsElement();
+    if (!isArrayElement(operation.security)) return securityDefinitions;
+    if (!isSecurityDefinitionsElement(entry.securityDefinitions)) return securityDefinitions;
+
+    // collect referenced names of Security Definitions
+    const referencedNames = new Set();
+    for (const securityRequirement of operation.security) {
+      if (!isSecurityRequirementElement(securityRequirement)) continue;
+      securityRequirement.forEach((_value, keyElement) => {
+        referencedNames.add(toValue(keyElement));
+      });
+    }
+    if (referencedNames.size === 0) return securityDefinitions;
+    for (const name of referencedNames) {
+      const securityScheme = entry.securityDefinitions.get(name);
+      if (!isSecuritySchemeElement(securityScheme)) continue;
+      securityDefinitions.set(name, securityScheme);
+    }
+    return securityDefinitions;
+  }
+}
+export default OpenAPI2DocumentAssembler;

package/src/assembler/OpenAPI30DocumentAssembler.cjs

@@ -0,0 +1,110 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _apidomCore = require("@speclynx/apidom-core");
+var _apidomDatamodel = require("@speclynx/apidom-datamodel");
+var _apidomJsonPointer = require("@speclynx/apidom-json-pointer");
+var _apidomNsOpenapi = require("@speclynx/apidom-ns-openapi-3-0");
+var _OpenAPIDocument = _interopRequireDefault(require("../document/OpenAPIDocument.cjs"));
+var _OpenAPIOperationIndex = _interopRequireDefault(require("../document/OpenAPIOperationIndex.cjs"));
+var _AssemblerError = _interopRequireDefault(require("../errors/AssemblerError.cjs"));
+/**
+ * Assembles a standalone OpenAPI 3.0 document from a
+ * normalized operation element.
+ *
+ * The assembled document is a valid OpenAPI 3.0 specification containing
+ * only the single operation with its servers, and referenced security
+ * schemes from the source document's components.
+ * @public
+ */
+class OpenAPI30DocumentAssembler {
+  /**
+   * Assembles a standalone OpenAPI 3.0 document from a normalized operation.
+   */
+  assemble(operation, document) {
+    const entry = document.parseResult.api;
+    const method = (0, _apidomCore.toValue)(operation.meta.get('http-method'));
+    const path = (0, _apidomCore.toValue)(operation.meta.get('path'));
+    if (typeof method !== 'string' || typeof path !== 'string') {
+      throw new _AssemblerError.default(`Operation is missing valid "http-method" or "path" metadata. Was it produced by OpenAPIOperationExtractor?`, {
+        uri: document.uri,
+        operationId: (0, _apidomCore.toValue)(operation.operationId)
+      });
+    }
+    if (!(0, _apidomNsOpenapi.isOpenApi3_0Element)(entry)) {
+      throw new _AssemblerError.default(`Expected OpenAPI 3.0 document at "${document.uri}"`, {
+        uri: document.uri,
+        operationId: (0, _apidomCore.toValue)(operation.operationId)
+      });
+    }
+
+    // build OpenAPI 3.0 document
+    const openapi = new _apidomNsOpenapi.OpenApi3_0Element({
+      openapi: entry.openapi
+    }, {
+      classes: ['api']
+    });
+    // prettier-ignore
+    {
+      if ((0, _apidomDatamodel.isElement)(entry.info)) openapi.info = entry.info;
+      if ((0, _apidomDatamodel.isElement)(entry.tags)) openapi.tags = entry.tags;
+      if ((0, _apidomDatamodel.isElement)(entry.externalDocs)) openapi.externalDocs = entry.externalDocs;
+    }
+
+    // build paths with single operation
+    const pathItem = new _apidomNsOpenapi.PathItemElement();
+    const paths = new _apidomNsOpenapi.PathsElement();
+    pathItem.set(method, operation);
+    paths.set(path, pathItem);
+    openapi.paths = paths;
+
+    // include only referenced security schemes in components
+    const securitySchemes = this.#extractReferencedSecuritySchemes(operation, entry);
+    if (securitySchemes.length > 0) {
+      const components = new _apidomNsOpenapi.ComponentsElement();
+      components.securitySchemes = securitySchemes;
+      openapi.components = components;
+    }
+
+    // wrap in ParseResultElement and return as OpenAPIDocument
+    const parseResult = new _apidomDatamodel.ParseResultElement([openapi]);
+    const operationIndex = new _OpenAPIOperationIndex.default();
+    const operationId = (0, _apidomCore.toValue)(operation.operationId);
+    if (typeof operationId === 'string' && operationId.length > 0) {
+      operationIndex.set(operationId, (0, _apidomJsonPointer.compile)(['paths', path, method]));
+    }
+    return new _OpenAPIDocument.default(document.uri, parseResult, operationIndex);
+  }
+
+  /**
+   * Extracts only the security schemes referenced by the operation's
+   * security requirements.
+   */
+  #extractReferencedSecuritySchemes(operation, entry) {
+    const securitySchemes = new _apidomDatamodel.ObjectElement();
+    if (!(0, _apidomDatamodel.isArrayElement)(operation.security)) return securitySchemes;
+    if (entry.components === undefined) return securitySchemes;
+    if (entry.components.securitySchemes === undefined) return securitySchemes;
+
+    // collect referenced names of security schemes
+    const referencedNames = new Set();
+    for (const securityRequirement of operation.security) {
+      if (!(0, _apidomNsOpenapi.isSecurityRequirementElement)(securityRequirement)) continue;
+      securityRequirement.forEach((_value, keyElement) => {
+        referencedNames.add((0, _apidomCore.toValue)(keyElement));
+      });
+    }
+    if (referencedNames.size === 0) return securitySchemes;
+    for (const name of referencedNames) {
+      const securityScheme = entry.components.securitySchemes.get(name);
+      if (!(0, _apidomNsOpenapi.isSecuritySchemeElement)(securityScheme)) continue;
+      securitySchemes.set(name, securityScheme);
+    }
+    return securitySchemes;
+  }
+}
+var _default = exports.default = OpenAPI30DocumentAssembler;

package/src/assembler/OpenAPI30DocumentAssembler.mjs

@@ -0,0 +1,103 @@
+import { toValue } from '@speclynx/apidom-core';
+import { isArrayElement, isElement, ObjectElement, ParseResultElement } from '@speclynx/apidom-datamodel';
+import { compile } from '@speclynx/apidom-json-pointer';
+import { OpenApi3_0Element, ComponentsElement, PathsElement, PathItemElement, isOpenApi3_0Element, isSecurityRequirementElement, isSecuritySchemeElement } from '@speclynx/apidom-ns-openapi-3-0';
+import OpenAPIDocument from "../document/OpenAPIDocument.mjs";
+import OpenAPIOperationIndex from "../document/OpenAPIOperationIndex.mjs";
+import AssemblerError from "../errors/AssemblerError.mjs";
+/**
+ * Assembles a standalone OpenAPI 3.0 document from a
+ * normalized operation element.
+ *
+ * The assembled document is a valid OpenAPI 3.0 specification containing
+ * only the single operation with its servers, and referenced security
+ * schemes from the source document's components.
+ * @public
+ */
+class OpenAPI30DocumentAssembler {
+  /**
+   * Assembles a standalone OpenAPI 3.0 document from a normalized operation.
+   */
+  assemble(operation, document) {
+    const entry = document.parseResult.api;
+    const method = toValue(operation.meta.get('http-method'));
+    const path = toValue(operation.meta.get('path'));
+    if (typeof method !== 'string' || typeof path !== 'string') {
+      throw new AssemblerError(`Operation is missing valid "http-method" or "path" metadata. Was it produced by OpenAPIOperationExtractor?`, {
+        uri: document.uri,
+        operationId: toValue(operation.operationId)
+      });
+    }
+    if (!isOpenApi3_0Element(entry)) {
+      throw new AssemblerError(`Expected OpenAPI 3.0 document at "${document.uri}"`, {
+        uri: document.uri,
+        operationId: toValue(operation.operationId)
+      });
+    }
+
+    // build OpenAPI 3.0 document
+    const openapi = new OpenApi3_0Element({
+      openapi: entry.openapi
+    }, {
+      classes: ['api']
+    });
+    // prettier-ignore
+    {
+      if (isElement(entry.info)) openapi.info = entry.info;
+      if (isElement(entry.tags)) openapi.tags = entry.tags;
+      if (isElement(entry.externalDocs)) openapi.externalDocs = entry.externalDocs;
+    }
+
+    // build paths with single operation
+    const pathItem = new PathItemElement();
+    const paths = new PathsElement();
+    pathItem.set(method, operation);
+    paths.set(path, pathItem);
+    openapi.paths = paths;
+
+    // include only referenced security schemes in components
+    const securitySchemes = this.#extractReferencedSecuritySchemes(operation, entry);
+    if (securitySchemes.length > 0) {
+      const components = new ComponentsElement();
+      components.securitySchemes = securitySchemes;
+      openapi.components = components;
+    }
+
+    // wrap in ParseResultElement and return as OpenAPIDocument
+    const parseResult = new ParseResultElement([openapi]);
+    const operationIndex = new OpenAPIOperationIndex();
+    const operationId = toValue(operation.operationId);
+    if (typeof operationId === 'string' && operationId.length > 0) {
+      operationIndex.set(operationId, compile(['paths', path, method]));
+    }
+    return new OpenAPIDocument(document.uri, parseResult, operationIndex);
+  }
+
+  /**
+   * Extracts only the security schemes referenced by the operation's
+   * security requirements.
+   */
+  #extractReferencedSecuritySchemes(operation, entry) {
+    const securitySchemes = new ObjectElement();
+    if (!isArrayElement(operation.security)) return securitySchemes;
+    if (entry.components === undefined) return securitySchemes;
+    if (entry.components.securitySchemes === undefined) return securitySchemes;
+
+    // collect referenced names of security schemes
+    const referencedNames = new Set();
+    for (const securityRequirement of operation.security) {
+      if (!isSecurityRequirementElement(securityRequirement)) continue;
+      securityRequirement.forEach((_value, keyElement) => {
+        referencedNames.add(toValue(keyElement));
+      });
+    }
+    if (referencedNames.size === 0) return securitySchemes;
+    for (const name of referencedNames) {
+      const securityScheme = entry.components.securitySchemes.get(name);
+      if (!isSecuritySchemeElement(securityScheme)) continue;
+      securitySchemes.set(name, securityScheme);
+    }
+    return securitySchemes;
+  }
+}
+export default OpenAPI30DocumentAssembler;

package/src/assembler/OpenAPI31DocumentAssembler.cjs

@@ -0,0 +1,111 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _apidomCore = require("@speclynx/apidom-core");
+var _apidomDatamodel = require("@speclynx/apidom-datamodel");
+var _apidomJsonPointer = require("@speclynx/apidom-json-pointer");
+var _apidomNsOpenapi = require("@speclynx/apidom-ns-openapi-3-1");
+var _OpenAPIDocument = _interopRequireDefault(require("../document/OpenAPIDocument.cjs"));
+var _OpenAPIOperationIndex = _interopRequireDefault(require("../document/OpenAPIOperationIndex.cjs"));
+var _AssemblerError = _interopRequireDefault(require("../errors/AssemblerError.cjs"));
+/**
+ * Assembles a standalone OpenAPI 3.1 document from a
+ * normalized operation element.
+ *
+ * The assembled document is a valid OpenAPI 3.1 specification containing
+ * only the single operation with its servers, and referenced security
+ * schemes from the source document's components.
+ * @public
+ */
+class OpenAPI31DocumentAssembler {
+  /**
+   * Assembles a standalone OpenAPI 3.1 document from a normalized operation.
+   */
+  assemble(operation, document) {
+    const entry = document.parseResult.api;
+    const method = (0, _apidomCore.toValue)(operation.meta.get('http-method'));
+    const path = (0, _apidomCore.toValue)(operation.meta.get('path'));
+    if (typeof method !== 'string' || typeof path !== 'string') {
+      throw new _AssemblerError.default(`Operation is missing valid "http-method" or "path" metadata. Was it produced by OpenAPIOperationExtractor?`, {
+        uri: document.uri,
+        operationId: (0, _apidomCore.toValue)(operation.operationId)
+      });
+    }
+    if (!(0, _apidomNsOpenapi.isOpenApi3_1Element)(entry)) {
+      throw new _AssemblerError.default(`Expected OpenAPI 3.1 document at "${document.uri}"`, {
+        uri: document.uri,
+        operationId: (0, _apidomCore.toValue)(operation.operationId)
+      });
+    }
+
+    // build OpenAPI 3.1 document
+    const openapi = new _apidomNsOpenapi.OpenApi3_1Element({
+      openapi: entry.openapi
+    }, {
+      classes: ['api']
+    });
+    // prettier-ignore
+    {
+      if ((0, _apidomDatamodel.isElement)(entry.info)) openapi.info = entry.info;
+      if ((0, _apidomDatamodel.isElement)(entry.tags)) openapi.tags = entry.tags;
+      if ((0, _apidomDatamodel.isElement)(entry.externalDocs)) openapi.externalDocs = entry.externalDocs;
+      if ((0, _apidomDatamodel.isElement)(entry.jsonSchemaDialect)) openapi.jsonSchemaDialect = entry.jsonSchemaDialect;
+    }
+
+    // build paths with single operation
+    const pathItem = new _apidomNsOpenapi.PathItemElement();
+    const paths = new _apidomNsOpenapi.PathsElement();
+    pathItem.set(method, operation);
+    paths.set(path, pathItem);
+    openapi.paths = paths;
+
+    // include only referenced security schemes in components
+    const securitySchemes = this.#extractReferencedSecuritySchemes(operation, entry);
+    if (securitySchemes.length > 0) {
+      const components = new _apidomNsOpenapi.ComponentsElement();
+      components.securitySchemes = securitySchemes;
+      openapi.components = components;
+    }
+
+    // wrap in ParseResultElement and return as OpenAPIDocument
+    const parseResult = new _apidomDatamodel.ParseResultElement([openapi]);
+    const operationIndex = new _OpenAPIOperationIndex.default();
+    const operationId = (0, _apidomCore.toValue)(operation.operationId);
+    if (typeof operationId === 'string' && operationId.length > 0) {
+      operationIndex.set(operationId, (0, _apidomJsonPointer.compile)(['paths', path, method]));
+    }
+    return new _OpenAPIDocument.default(document.uri, parseResult, operationIndex);
+  }
+
+  /**
+   * Extracts only the security schemes referenced by the operation's
+   * security requirements.
+   */
+  #extractReferencedSecuritySchemes(operation, entry) {
+    const securitySchemes = new _apidomDatamodel.ObjectElement();
+    if (!(0, _apidomDatamodel.isArrayElement)(operation.security)) return securitySchemes;
+    if (entry.components === undefined) return securitySchemes;
+    if (entry.components.securitySchemes === undefined) return securitySchemes;
+
+    // collect referenced names of security schemes
+    const referencedNames = new Set();
+    for (const securityRequirement of operation.security) {
+      if (!(0, _apidomNsOpenapi.isSecurityRequirementElement)(securityRequirement)) continue;
+      securityRequirement.forEach((_value, keyElement) => {
+        referencedNames.add((0, _apidomCore.toValue)(keyElement));
+      });
+    }
+    if (referencedNames.size === 0) return securitySchemes;
+    for (const name of referencedNames) {
+      const securityScheme = entry.components.securitySchemes.get(name);
+      if (!(0, _apidomNsOpenapi.isSecuritySchemeElement)(securityScheme)) continue;
+      securitySchemes.set(name, securityScheme);
+    }
+    return securitySchemes;
+  }
+}
+var _default = exports.default = OpenAPI31DocumentAssembler;

package/src/assembler/OpenAPI31DocumentAssembler.mjs

@@ -0,0 +1,104 @@
+import { toValue } from '@speclynx/apidom-core';
+import { isArrayElement, isElement, ObjectElement, ParseResultElement } from '@speclynx/apidom-datamodel';
+import { compile } from '@speclynx/apidom-json-pointer';
+import { OpenApi3_1Element, ComponentsElement, PathsElement, PathItemElement, isOpenApi3_1Element, isSecurityRequirementElement, isSecuritySchemeElement } from '@speclynx/apidom-ns-openapi-3-1';
+import OpenAPIDocument from "../document/OpenAPIDocument.mjs";
+import OpenAPIOperationIndex from "../document/OpenAPIOperationIndex.mjs";
+import AssemblerError from "../errors/AssemblerError.mjs";
+/**
+ * Assembles a standalone OpenAPI 3.1 document from a
+ * normalized operation element.
+ *
+ * The assembled document is a valid OpenAPI 3.1 specification containing
+ * only the single operation with its servers, and referenced security
+ * schemes from the source document's components.
+ * @public
+ */
+class OpenAPI31DocumentAssembler {
+  /**
+   * Assembles a standalone OpenAPI 3.1 document from a normalized operation.
+   */
+  assemble(operation, document) {
+    const entry = document.parseResult.api;
+    const method = toValue(operation.meta.get('http-method'));
+    const path = toValue(operation.meta.get('path'));
+    if (typeof method !== 'string' || typeof path !== 'string') {
+      throw new AssemblerError(`Operation is missing valid "http-method" or "path" metadata. Was it produced by OpenAPIOperationExtractor?`, {
+        uri: document.uri,
+        operationId: toValue(operation.operationId)
+      });
+    }
+    if (!isOpenApi3_1Element(entry)) {
+      throw new AssemblerError(`Expected OpenAPI 3.1 document at "${document.uri}"`, {
+        uri: document.uri,
+        operationId: toValue(operation.operationId)
+      });
+    }
+
+    // build OpenAPI 3.1 document
+    const openapi = new OpenApi3_1Element({
+      openapi: entry.openapi
+    }, {
+      classes: ['api']
+    });
+    // prettier-ignore
+    {
+      if (isElement(entry.info)) openapi.info = entry.info;
+      if (isElement(entry.tags)) openapi.tags = entry.tags;
+      if (isElement(entry.externalDocs)) openapi.externalDocs = entry.externalDocs;
+      if (isElement(entry.jsonSchemaDialect)) openapi.jsonSchemaDialect = entry.jsonSchemaDialect;
+    }
+
+    // build paths with single operation
+    const pathItem = new PathItemElement();
+    const paths = new PathsElement();
+    pathItem.set(method, operation);
+    paths.set(path, pathItem);
+    openapi.paths = paths;
+
+    // include only referenced security schemes in components
+    const securitySchemes = this.#extractReferencedSecuritySchemes(operation, entry);
+    if (securitySchemes.length > 0) {
+      const components = new ComponentsElement();
+      components.securitySchemes = securitySchemes;
+      openapi.components = components;
+    }
+
+    // wrap in ParseResultElement and return as OpenAPIDocument
+    const parseResult = new ParseResultElement([openapi]);
+    const operationIndex = new OpenAPIOperationIndex();
+    const operationId = toValue(operation.operationId);
+    if (typeof operationId === 'string' && operationId.length > 0) {
+      operationIndex.set(operationId, compile(['paths', path, method]));
+    }
+    return new OpenAPIDocument(document.uri, parseResult, operationIndex);
+  }
+
+  /**
+   * Extracts only the security schemes referenced by the operation's
+   * security requirements.
+   */
+  #extractReferencedSecuritySchemes(operation, entry) {
+    const securitySchemes = new ObjectElement();
+    if (!isArrayElement(operation.security)) return securitySchemes;
+    if (entry.components === undefined) return securitySchemes;
+    if (entry.components.securitySchemes === undefined) return securitySchemes;
+
+    // collect referenced names of security schemes
+    const referencedNames = new Set();
+    for (const securityRequirement of operation.security) {
+      if (!isSecurityRequirementElement(securityRequirement)) continue;
+      securityRequirement.forEach((_value, keyElement) => {
+        referencedNames.add(toValue(keyElement));
+      });
+    }
+    if (referencedNames.size === 0) return securitySchemes;
+    for (const name of referencedNames) {
+      const securityScheme = entry.components.securitySchemes.get(name);
+      if (!isSecuritySchemeElement(securityScheme)) continue;
+      securitySchemes.set(name, securityScheme);
+    }
+    return securitySchemes;
+  }
+}
+export default OpenAPI31DocumentAssembler;