@documentation-robotics/cli 0.1.0 → 0.1.7

package/dist/import/archimate-importer.js

@@ -0,0 +1,166 @@
+import { isTelemetryEnabled, startSpan, endSpan } from "../telemetry/index.js";
+import { getErrorMessage } from "../utils/errors.js";
+import { DOMParser } from "@xmldom/xmldom";
+class ArchiMateImporter {
+  name = "ArchiMate";
+  supportedFormats = ["xml"];
+  async import(data, model, _options = {}) {
+    const span = isTelemetryEnabled ? startSpan("import.format.archimate") : null, result = {
+      success: !1,
+      nodesAdded: 0,
+      edgesAdded: 0,
+      errorsCount: 0,
+      errors: []
+    };
+    try {
+      if (_options.mergeStrategy && _options.mergeStrategy !== "add")
+        return result.errors.push({
+          message: `ArchiMate importer only supports 'add' merge strategy. Requested: '${_options.mergeStrategy}'.`
+        }), result.errorsCount++, result;
+      const xmlDoc = new DOMParser().parseFromString(data, "application/xml");
+      if (xmlDoc.getElementsByTagName("parsererror").length > 0)
+        return result.errors.push({ message: "Failed to parse XML: Invalid XML structure" }), result.errorsCount++, result;
+      const modelElement = xmlDoc.documentElement;
+      if (modelElement.tagName !== "model")
+        return result.errors.push({ message: "Root element must be 'model'" }), result.errorsCount++, result;
+      const elementsElement = modelElement.getElementsByTagName("elements")[0];
+      if (!elementsElement)
+        return result.errors.push({ message: "No elements section found" }), result.errorsCount++, result;
+      const elementNodes = elementsElement.getElementsByTagName("element"), layerMap = /* @__PURE__ */ new Map();
+      for (let i = 0; i < elementNodes.length; i++) {
+        const elem = elementNodes[i], id = elem.getAttribute("identifier"), type = elem.getAttribute("xsi:type") || "Element", name = elem.getElementsByTagName("name")[0]?.textContent || id || "Unnamed", description = elem.getElementsByTagName("documentation")[0]?.textContent || void 0;
+        if (!id) {
+          result.errors.push({ message: "Element missing identifier attribute" }), result.errorsCount++;
+          continue;
+        }
+        const layer = this.inferLayerFromType(type);
+        if (!layer) {
+          result.errors.push({
+            message: `Unable to infer layer for ArchiMate type: ${type}`,
+            element: id
+          }), result.errorsCount++;
+          continue;
+        }
+        const properties = {}, propsElement = elem.getElementsByTagName("properties")[0];
+        if (propsElement) {
+          const propElements = propsElement.getElementsByTagName("property");
+          for (let j = 0; j < propElements.length; j++) {
+            const prop = propElements[j], key = prop.getAttribute("key"), value = prop.getAttribute("value");
+            key && value !== null && (properties[key] = value);
+          }
+        }
+        const graphNode = {
+          id,
+          layer,
+          type: this.mapArchiMateTypeToElementType(type, layer),
+          name,
+          description,
+          properties
+        };
+        model.graph.addNode(graphNode), layerMap.set(id, layer), result.nodesAdded++;
+      }
+      const relationshipsElement = modelElement.getElementsByTagName("relationships")[0];
+      if (relationshipsElement) {
+        const relElements = relationshipsElement.getElementsByTagName("relationship");
+        for (let i = 0; i < relElements.length; i++) {
+          const rel = relElements[i], id = rel.getAttribute("identifier"), source = rel.getAttribute("source"), target = rel.getAttribute("target"), predicate = rel.getElementsByTagName("name")[0]?.textContent || "Association";
+          if (!id || !source || !target) {
+            result.errors.push({
+              message: "Relationship missing required attributes (identifier, source, target)"
+            }), result.errorsCount++;
+            continue;
+          }
+          if (!model.graph.getNode(source) || !model.graph.getNode(target)) {
+            result.errors.push({
+              message: `Relationship references non-existent nodes: ${source} -> ${target}`,
+              element: id
+            }), result.errorsCount++;
+            continue;
+          }
+          const graphEdge = {
+            id,
+            source,
+            destination: target,
+            predicate,
+            properties: {}
+          };
+          model.graph.addEdge(graphEdge), result.edgesAdded++;
+        }
+      }
+      return result.success = result.errorsCount === 0, isTelemetryEnabled && span && (span.setAttribute("import.nodesAdded", result.nodesAdded), span.setAttribute("import.edgesAdded", result.edgesAdded), span.setAttribute("import.errors", result.errorsCount), span.setStatus({ code: result.success ? 0 : 1 })), result;
+    } catch (error) {
+      return result.errors.push({
+        message: getErrorMessage(error)
+      }), result.errorsCount++, isTelemetryEnabled && span && (span.recordException(error), span.setStatus({ code: 2, message: String(error) })), result;
+    } finally {
+      endSpan(span);
+    }
+  }
+  /**
+   * Infer layer from ArchiMate element type
+   */
+  inferLayerFromType(archimateType) {
+    if ([
+      "Stakeholder",
+      "Driver",
+      "Assessment",
+      "Goal",
+      "Outcome",
+      "Principle",
+      "Requirement",
+      "Constraint"
+    ].includes(archimateType))
+      return "motivation";
+    if ([
+      "BusinessActor",
+      "BusinessRole",
+      "BusinessCollaboration",
+      "BusinessInterface",
+      "BusinessProcess",
+      "BusinessFunction",
+      "BusinessInteraction",
+      "BusinessEvent",
+      "BusinessService",
+      "BusinessObject"
+    ].includes(archimateType))
+      return "business";
+    if ([
+      "ApplicationComponent",
+      "ApplicationCollaboration",
+      "ApplicationInterface",
+      "ApplicationFunction",
+      "ApplicationInteraction",
+      "ApplicationProcess",
+      "ApplicationEvent",
+      "ApplicationService",
+      "DataObject"
+    ].includes(archimateType))
+      return "application";
+    if ([
+      "Node",
+      "Device",
+      "SystemSoftware",
+      "TechnologyCollaboration",
+      "TechnologyInterface",
+      "Path",
+      "CommunicationNetwork",
+      "TechnologyFunction",
+      "TechnologyProcess",
+      "TechnologyInteraction",
+      "TechnologyEvent",
+      "TechnologyService",
+      "Artifact"
+    ].includes(archimateType))
+      return "technology";
+  }
+  /**
+   * Map ArchiMate type to element type (lowercase format)
+   */
+  mapArchiMateTypeToElementType(archimateType, _layer) {
+    return archimateType.replace(/([A-Z])/g, "-$1").toLowerCase().replace(/^-/, "");
+  }
+}
+export {
+  ArchiMateImporter
+};
+//# sourceMappingURL=archimate-importer.js.map

package/dist/import/archimate-importer.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/import/archimate-importer.ts"],
+  "sourcesContent": ["import type { Model } from \"../core/model.js\";\nimport type { Importer, ImportOptions, ImportResult } from \"./types.js\";\nimport type { Span } from \"@opentelemetry/api\";\nimport { isTelemetryEnabled, startSpan, endSpan } from \"../telemetry/index.js\";\nimport { getErrorMessage } from \"../utils/errors.js\";\nimport { DOMParser } from \"@xmldom/xmldom\";\n\n/**\n * ArchiMate XML Importer for layers 1, 2, 4, 5\n * Parses ArchiMate 3.2 XML and creates graph nodes/edges\n */\nexport class ArchiMateImporter implements Importer {\n  name = \"ArchiMate\";\n  supportedFormats = [\"xml\"];\n\n  async import(data: string, model: Model, _options: ImportOptions = {}): Promise<ImportResult> {\n    const span: Span | null = isTelemetryEnabled ? startSpan(\"import.format.archimate\") : null;\n    const result: ImportResult = {\n      success: false,\n      nodesAdded: 0,\n      edgesAdded: 0,\n      errorsCount: 0,\n      errors: [],\n    };\n\n    try {\n      // Validate merge strategy - only 'add' is supported\n      if (_options.mergeStrategy && _options.mergeStrategy !== 'add') {\n        result.errors.push({\n          message: `ArchiMate importer only supports 'add' merge strategy. Requested: '${_options.mergeStrategy}'.`\n        });\n        result.errorsCount++;\n        return result;\n      }\n\n      // Parse XML using @xmldom/xmldom (server-side DOM parser)\n      const parser = new DOMParser();\n      const xmlDoc = parser.parseFromString(data, \"application/xml\");\n\n      if (xmlDoc.getElementsByTagName(\"parsererror\").length > 0) {\n        result.errors.push({ message: \"Failed to parse XML: Invalid XML structure\" });\n        result.errorsCount++;\n        return result;\n      }\n\n      const modelElement = xmlDoc.documentElement;\n      if (modelElement.tagName !== \"model\") {\n        result.errors.push({ message: \"Root element must be 'model'\" });\n        result.errorsCount++;\n        return result;\n      }\n\n      // Parse elements\n      const elementsElement = modelElement.getElementsByTagName(\"elements\")[0];\n      if (!elementsElement) {\n        result.errors.push({ message: \"No elements section found\" });\n        result.errorsCount++;\n        return result;\n      }\n\n      const elementNodes = elementsElement.getElementsByTagName(\"element\");\n      const layerMap = new Map<string, string>(); // id -> layer mapping\n\n      for (let i = 0; i < elementNodes.length; i++) {\n        const elem = elementNodes[i];\n        const id = elem.getAttribute(\"identifier\");\n        const type = elem.getAttribute(\"xsi:type\") || \"Element\";\n        const nameElement = elem.getElementsByTagName(\"name\")[0];\n        const name = nameElement?.textContent || id || \"Unnamed\";\n        const docElement = elem.getElementsByTagName(\"documentation\")[0];\n        const description = docElement?.textContent || undefined;\n\n        if (!id) {\n          result.errors.push({ message: \"Element missing identifier attribute\" });\n          result.errorsCount++;\n          continue;\n        }\n\n        // Infer layer from ArchiMate type\n        const layer = this.inferLayerFromType(type);\n        if (!layer) {\n          result.errors.push({\n            message: `Unable to infer layer for ArchiMate type: ${type}`,\n            element: id,\n          });\n          result.errorsCount++;\n          continue;\n        }\n\n        // Extract properties\n        const properties: Record<string, unknown> = {};\n        const propsElement = elem.getElementsByTagName(\"properties\")[0];\n        if (propsElement) {\n          const propElements = propsElement.getElementsByTagName(\"property\");\n          for (let j = 0; j < propElements.length; j++) {\n            const prop = propElements[j];\n            const key = prop.getAttribute(\"key\");\n            const value = prop.getAttribute(\"value\");\n            if (key && value !== null) {\n              properties[key] = value;\n            }\n          }\n        }\n\n        // Create graph node\n        const graphNode = {\n          id,\n          layer,\n          type: this.mapArchiMateTypeToElementType(type, layer),\n          name,\n          description,\n          properties,\n        };\n\n        model.graph.addNode(graphNode);\n        layerMap.set(id, layer);\n        result.nodesAdded++;\n      }\n\n      // Parse relationships\n      const relationshipsElement = modelElement.getElementsByTagName(\"relationships\")[0];\n      if (relationshipsElement) {\n        const relElements = relationshipsElement.getElementsByTagName(\"relationship\");\n\n        for (let i = 0; i < relElements.length; i++) {\n          const rel = relElements[i];\n          const id = rel.getAttribute(\"identifier\");\n          const source = rel.getAttribute(\"source\");\n          const target = rel.getAttribute(\"target\");\n          const nameElement = rel.getElementsByTagName(\"name\")[0];\n          const predicate = nameElement?.textContent || \"Association\";\n\n          if (!id || !source || !target) {\n            result.errors.push({\n              message: \"Relationship missing required attributes (identifier, source, target)\",\n            });\n            result.errorsCount++;\n            continue;\n          }\n\n          // Verify both nodes exist\n          if (!model.graph.getNode(source) || !model.graph.getNode(target)) {\n            result.errors.push({\n              message: `Relationship references non-existent nodes: ${source} -> ${target}`,\n              element: id,\n            });\n            result.errorsCount++;\n            continue;\n          }\n\n          // Create graph edge\n          const graphEdge = {\n            id,\n            source,\n            destination: target,\n            predicate,\n            properties: {},\n          };\n\n          model.graph.addEdge(graphEdge);\n          result.edgesAdded++;\n        }\n      }\n\n      result.success = result.errorsCount === 0;\n\n      if (isTelemetryEnabled && span) {\n        span.setAttribute(\"import.nodesAdded\", result.nodesAdded);\n        span.setAttribute(\"import.edgesAdded\", result.edgesAdded);\n        span.setAttribute(\"import.errors\", result.errorsCount);\n        span.setStatus({ code: result.success ? 0 : 1 });\n      }\n\n      return result;\n    } catch (error) {\n      result.errors.push({\n        message: getErrorMessage(error),\n      });\n      result.errorsCount++;\n\n      if (isTelemetryEnabled && span) {\n        span.recordException(error as Error);\n        span.setStatus({ code: 2, message: String(error) });\n      }\n\n      return result;\n    } finally {\n      endSpan(span);\n    }\n  }\n\n  /**\n   * Infer layer from ArchiMate element type\n   */\n  private inferLayerFromType(archimateType: string): string | undefined {\n    // Motivation layer types\n    const motivationTypes = [\n      \"Stakeholder\",\n      \"Driver\",\n      \"Assessment\",\n      \"Goal\",\n      \"Outcome\",\n      \"Principle\",\n      \"Requirement\",\n      \"Constraint\",\n    ];\n    if (motivationTypes.includes(archimateType)) return \"motivation\";\n\n    // Business layer types\n    const businessTypes = [\n      \"BusinessActor\",\n      \"BusinessRole\",\n      \"BusinessCollaboration\",\n      \"BusinessInterface\",\n      \"BusinessProcess\",\n      \"BusinessFunction\",\n      \"BusinessInteraction\",\n      \"BusinessEvent\",\n      \"BusinessService\",\n      \"BusinessObject\",\n    ];\n    if (businessTypes.includes(archimateType)) return \"business\";\n\n    // Application layer types\n    const applicationTypes = [\n      \"ApplicationComponent\",\n      \"ApplicationCollaboration\",\n      \"ApplicationInterface\",\n      \"ApplicationFunction\",\n      \"ApplicationInteraction\",\n      \"ApplicationProcess\",\n      \"ApplicationEvent\",\n      \"ApplicationService\",\n      \"DataObject\",\n    ];\n    if (applicationTypes.includes(archimateType)) return \"application\";\n\n    // Technology layer types\n    const technologyTypes = [\n      \"Node\",\n      \"Device\",\n      \"SystemSoftware\",\n      \"TechnologyCollaboration\",\n      \"TechnologyInterface\",\n      \"Path\",\n      \"CommunicationNetwork\",\n      \"TechnologyFunction\",\n      \"TechnologyProcess\",\n      \"TechnologyInteraction\",\n      \"TechnologyEvent\",\n      \"TechnologyService\",\n      \"Artifact\",\n    ];\n    if (technologyTypes.includes(archimateType)) return \"technology\";\n\n    return undefined;\n  }\n\n  /**\n   * Map ArchiMate type to element type (lowercase format)\n   */\n  private mapArchiMateTypeToElementType(archimateType: string, _layer: string): string {\n    // Convert PascalCase to kebab-case\n    const kebabCase = archimateType\n      .replace(/([A-Z])/g, \"-$1\")\n      .toLowerCase()\n      .replace(/^-/, \"\");\n\n    return kebabCase;\n  }\n}\n"],
+  "mappings": "AAGA,SAAS,oBAAoB,WAAW,eAAe;AACvD,SAAS,uBAAuB;AAChC,SAAS,iBAAiB;AAMpB,MAAO,kBAAiB;EAC5B,OAAO;EACP,mBAAmB,CAAC,KAAK;EAEzB,MAAM,OAAO,MAAc,OAAc,WAA0B,CAAA,GAAE;AACnE,UAAM,OAAoB,qBAAqB,UAAU,yBAAyB,IAAI,MAChF,SAAuB;MAC3B,SAAS;MACT,YAAY;MACZ,YAAY;MACZ,aAAa;MACb,QAAQ,CAAA;;AAGV,QAAI;AAEF,UAAI,SAAS,iBAAiB,SAAS,kBAAkB;AACvD,sBAAO,OAAO,KAAK;UACjB,SAAS,sEAAsE,SAAS,aAAa;SACtG,GACD,OAAO,eACA;AAKT,YAAM,SADS,IAAI,UAAS,EACN,gBAAgB,MAAM,iBAAiB;AAE7D,UAAI,OAAO,qBAAqB,aAAa,EAAE,SAAS;AACtD,sBAAO,OAAO,KAAK,EAAE,SAAS,6CAA4C,CAAE,GAC5E,OAAO,eACA;AAGT,YAAM,eAAe,OAAO;AAC5B,UAAI,aAAa,YAAY;AAC3B,sBAAO,OAAO,KAAK,EAAE,SAAS,+BAA8B,CAAE,GAC9D,OAAO,eACA;AAIT,YAAM,kBAAkB,aAAa,qBAAqB,UAAU,EAAE,CAAC;AACvE,UAAI,CAAC;AACH,sBAAO,OAAO,KAAK,EAAE,SAAS,4BAA2B,CAAE,GAC3D,OAAO,eACA;AAGT,YAAM,eAAe,gBAAgB,qBAAqB,SAAS,GAC7D,WAAW,oBAAI,IAAG;AAExB,eAAS,IAAI,GAAG,IAAI,aAAa,QAAQ,KAAK;AAC5C,cAAM,OAAO,aAAa,CAAC,GACrB,KAAK,KAAK,aAAa,YAAY,GACnC,OAAO,KAAK,aAAa,UAAU,KAAK,WAExC,OADc,KAAK,qBAAqB,MAAM,EAAE,CAAC,GAC7B,eAAe,MAAM,WAEzC,cADa,KAAK,qBAAqB,eAAe,EAAE,CAAC,GAC/B,eAAe;AAE/C,YAAI,CAAC,IAAI;AACP,iBAAO,OAAO,KAAK,EAAE,SAAS,uCAAsC,CAAE,GACtE,OAAO;AACP;QACF;AAGA,cAAM,QAAQ,KAAK,mBAAmB,IAAI;AAC1C,YAAI,CAAC,OAAO;AACV,iBAAO,OAAO,KAAK;YACjB,SAAS,6CAA6C,IAAI;YAC1D,SAAS;WACV,GACD,OAAO;AACP;QACF;AAGA,cAAM,aAAsC,CAAA,GACtC,eAAe,KAAK,qBAAqB,YAAY,EAAE,CAAC;AAC9D,YAAI,cAAc;AAChB,gBAAM,eAAe,aAAa,qBAAqB,UAAU;AACjE,mBAAS,IAAI,GAAG,IAAI,aAAa,QAAQ,KAAK;AAC5C,kBAAM,OAAO,aAAa,CAAC,GACrB,MAAM,KAAK,aAAa,KAAK,GAC7B,QAAQ,KAAK,aAAa,OAAO;AACvC,YAAI,OAAO,UAAU,SACnB,WAAW,GAAG,IAAI;UAEtB;QACF;AAGA,cAAM,YAAY;UAChB;UACA;UACA,MAAM,KAAK,8BAA8B,MAAM,KAAK;UACpD;UACA;UACA;;AAGF,cAAM,MAAM,QAAQ,SAAS,GAC7B,SAAS,IAAI,IAAI,KAAK,GACtB,OAAO;MACT;AAGA,YAAM,uBAAuB,aAAa,qBAAqB,eAAe,EAAE,CAAC;AACjF,UAAI,sBAAsB;AACxB,cAAM,cAAc,qBAAqB,qBAAqB,cAAc;AAE5E,iBAAS,IAAI,GAAG,IAAI,YAAY,QAAQ,KAAK;AAC3C,gBAAM,MAAM,YAAY,CAAC,GACnB,KAAK,IAAI,aAAa,YAAY,GAClC,SAAS,IAAI,aAAa,QAAQ,GAClC,SAAS,IAAI,aAAa,QAAQ,GAElC,YADc,IAAI,qBAAqB,MAAM,EAAE,CAAC,GACvB,eAAe;AAE9C,cAAI,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ;AAC7B,mBAAO,OAAO,KAAK;cACjB,SAAS;aACV,GACD,OAAO;AACP;UACF;AAGA,cAAI,CAAC,MAAM,MAAM,QAAQ,MAAM,KAAK,CAAC,MAAM,MAAM,QAAQ,MAAM,GAAG;AAChE,mBAAO,OAAO,KAAK;cACjB,SAAS,+CAA+C,MAAM,OAAO,MAAM;cAC3E,SAAS;aACV,GACD,OAAO;AACP;UACF;AAGA,gBAAM,YAAY;YAChB;YACA;YACA,aAAa;YACb;YACA,YAAY,CAAA;;AAGd,gBAAM,MAAM,QAAQ,SAAS,GAC7B,OAAO;QACT;MACF;AAEA,oBAAO,UAAU,OAAO,gBAAgB,GAEpC,sBAAsB,SACxB,KAAK,aAAa,qBAAqB,OAAO,UAAU,GACxD,KAAK,aAAa,qBAAqB,OAAO,UAAU,GACxD,KAAK,aAAa,iBAAiB,OAAO,WAAW,GACrD,KAAK,UAAU,EAAE,MAAM,OAAO,UAAU,IAAI,EAAC,CAAE,IAG1C;IACT,SAAS,OAAO;AACd,oBAAO,OAAO,KAAK;QACjB,SAAS,gBAAgB,KAAK;OAC/B,GACD,OAAO,eAEH,sBAAsB,SACxB,KAAK,gBAAgB,KAAc,GACnC,KAAK,UAAU,EAAE,MAAM,GAAG,SAAS,OAAO,KAAK,EAAC,CAAE,IAG7C;IACT;AACE,cAAQ,IAAI;IACd;EACF;;;;EAKQ,mBAAmB,eAAqB;AAY9C,QAVwB;MACtB;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MAEkB,SAAS,aAAa;AAAG,aAAO;AAepD,QAZsB;MACpB;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MAEgB,SAAS,aAAa;AAAG,aAAO;AAclD,QAXyB;MACvB;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MAEmB,SAAS,aAAa;AAAG,aAAO;AAkBrD,QAfwB;MACtB;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MAEkB,SAAS,aAAa;AAAG,aAAO;EAGtD;;;;EAKQ,8BAA8B,eAAuB,QAAc;AAOzE,WALkB,cACf,QAAQ,YAAY,KAAK,EACzB,YAAW,EACX,QAAQ,MAAM,EAAE;EAGrB;;",
+  "names": []
+}

package/dist/import/index.js

@@ -0,0 +1,47 @@
+import { ArchiMateImporter } from "./archimate-importer.js";
+import { OpenAPIImporter } from "./openapi-importer.js";
+import { ArchiMateImporter as ArchiMateImporter2 } from "./archimate-importer.js";
+import { OpenAPIImporter as OpenAPIImporter2 } from "./openapi-importer.js";
+class ImportManager {
+  importers = /* @__PURE__ */ new Map();
+  constructor() {
+    this.registerImporter(new ArchiMateImporter2()), this.registerImporter(new OpenAPIImporter2());
+  }
+  /**
+   * Register an importer
+   */
+  registerImporter(importer) {
+    this.importers.set(importer.name.toLowerCase(), importer);
+  }
+  /**
+   * Get an importer by name
+   */
+  getImporter(name) {
+    return this.importers.get(name.toLowerCase());
+  }
+  /**
+   * Get all registered importers
+   */
+  getImporters() {
+    return Array.from(this.importers.values());
+  }
+  /**
+   * Import data using a specific format
+   */
+  async import(format, data, model, options = {}) {
+    const importer = this.getImporter(format);
+    return importer ? importer.import(data, model, options) : {
+      success: !1,
+      nodesAdded: 0,
+      edgesAdded: 0,
+      errorsCount: 1,
+      errors: [{ message: `No importer found for format: ${format}` }]
+    };
+  }
+}
+export {
+  ArchiMateImporter,
+  ImportManager,
+  OpenAPIImporter
+};
+//# sourceMappingURL=index.js.map

package/dist/import/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/import/index.ts"],
+  "sourcesContent": ["export { type ImportOptions, type ImportResult, type Importer } from \"./types.js\";\nexport { ArchiMateImporter } from \"./archimate-importer.js\";\nexport { OpenAPIImporter } from \"./openapi-importer.js\";\n\n/**\n * Import manager for registering and using format importers\n */\nimport type { Model } from \"../core/model.js\";\nimport type { Importer, ImportOptions, ImportResult } from \"./types.js\";\nimport { ArchiMateImporter } from \"./archimate-importer.js\";\nimport { OpenAPIImporter } from \"./openapi-importer.js\";\n\nexport class ImportManager {\n  private importers: Map<string, Importer> = new Map();\n\n  constructor() {\n    this.registerImporter(new ArchiMateImporter());\n    this.registerImporter(new OpenAPIImporter());\n  }\n\n  /**\n   * Register an importer\n   */\n  registerImporter(importer: Importer): void {\n    this.importers.set(importer.name.toLowerCase(), importer);\n  }\n\n  /**\n   * Get an importer by name\n   */\n  getImporter(name: string): Importer | undefined {\n    return this.importers.get(name.toLowerCase());\n  }\n\n  /**\n   * Get all registered importers\n   */\n  getImporters(): Importer[] {\n    return Array.from(this.importers.values());\n  }\n\n  /**\n   * Import data using a specific format\n   */\n  async import(\n    format: string,\n    data: string,\n    model: Model,\n    options: ImportOptions = {}\n  ): Promise<ImportResult> {\n    const importer = this.getImporter(format);\n    if (!importer) {\n      return {\n        success: false,\n        nodesAdded: 0,\n        edgesAdded: 0,\n        errorsCount: 1,\n        errors: [{ message: `No importer found for format: ${format}` }],\n      };\n    }\n\n    return importer.import(data, model, options);\n  }\n}\n"],
+  "mappings": "AACA,SAAS,yBAAyB;AAClC,SAAS,uBAAuB;AAOhC,SAAS,qBAAAA,0BAAyB;AAClC,SAAS,mBAAAC,wBAAuB;AAE1B,MAAO,cAAa;EAChB,YAAmC,oBAAI,IAAG;EAElD,cAAA;AACE,SAAK,iBAAiB,IAAID,mBAAiB,CAAE,GAC7C,KAAK,iBAAiB,IAAIC,iBAAe,CAAE;EAC7C;;;;EAKA,iBAAiB,UAAkB;AACjC,SAAK,UAAU,IAAI,SAAS,KAAK,YAAW,GAAI,QAAQ;EAC1D;;;;EAKA,YAAY,MAAY;AACtB,WAAO,KAAK,UAAU,IAAI,KAAK,YAAW,CAAE;EAC9C;;;;EAKA,eAAY;AACV,WAAO,MAAM,KAAK,KAAK,UAAU,OAAM,CAAE;EAC3C;;;;EAKA,MAAM,OACJ,QACA,MACA,OACA,UAAyB,CAAA,GAAE;AAE3B,UAAM,WAAW,KAAK,YAAY,MAAM;AACxC,WAAK,WAUE,SAAS,OAAO,MAAM,OAAO,OAAO,IATlC;MACL,SAAS;MACT,YAAY;MACZ,YAAY;MACZ,aAAa;MACb,QAAQ,CAAC,EAAE,SAAS,iCAAiC,MAAM,GAAE,CAAE;;EAKrE;;",
+  "names": ["ArchiMateImporter", "OpenAPIImporter"]
+}

package/dist/import/openapi-importer.js

@@ -0,0 +1,143 @@
+import { isTelemetryEnabled, startSpan, endSpan } from "../telemetry/index.js";
+import { getErrorMessage } from "../utils/errors.js";
+class OpenAPIImporter {
+  name = "OpenAPI";
+  supportedFormats = ["json"];
+  async import(data, model, _options = {}) {
+    const span = isTelemetryEnabled ? startSpan("import.format.openapi") : null, result = {
+      success: !1,
+      nodesAdded: 0,
+      edgesAdded: 0,
+      errorsCount: 0,
+      errors: []
+    };
+    try {
+      if (_options.mergeStrategy && _options.mergeStrategy !== "add")
+        return result.errors.push({
+          message: `OpenAPI importer only supports 'add' merge strategy. Requested: '${_options.mergeStrategy}'.`
+        }), result.errorsCount++, result;
+      let spec;
+      try {
+        spec = JSON.parse(data);
+      } catch {
+        return result.errors.push({
+          message: "Failed to parse OpenAPI specification: Invalid JSON"
+        }), result.errorsCount++, result;
+      }
+      if (!spec.openapi && !spec.swagger)
+        return result.errors.push({
+          message: "Not a valid OpenAPI specification (missing openapi or swagger field)"
+        }), result.errorsCount++, result;
+      const docNodeId = `api.openapi-document.${(spec.info?.title || "api").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "")}`, docNode = {
+        id: docNodeId,
+        layer: "api",
+        type: "openapi-document",
+        name: spec.info?.title || "OpenAPI Document",
+        description: spec.info?.description,
+        properties: {
+          version: spec.info?.version || "1.0.0",
+          servers: spec.servers || [],
+          info: spec.info || {}
+        }
+      };
+      if (model.graph.addNode(docNode), result.nodesAdded++, spec.paths) {
+        const pathEntries = Object.entries(spec.paths);
+        for (const [pathName, pathSpec] of pathEntries) {
+          const pathSpec_ = pathSpec, methods = Object.keys(pathSpec_).filter((k) => ["get", "post", "put", "delete", "patch", "head", "options"].includes(k));
+          for (const method of methods) {
+            const operation = pathSpec_[method], endpointId = `api.endpoint.${operation.operationId || `${method}-${pathName}`.replace(/[^a-zA-Z0-9-]/g, "-")}`, endpointNode = {
+              id: endpointId,
+              layer: "api",
+              type: "endpoint",
+              name: operation.summary || `${method.toUpperCase()} ${pathName}`,
+              description: operation.description,
+              properties: {
+                method: method.toUpperCase(),
+                path: pathName,
+                tags: operation.tags || [],
+                parameters: operation.parameters || [],
+                requestBody: operation.requestBody,
+                responses: operation.responses || {},
+                security: operation.security,
+                deprecated: operation.deprecated || !1
+              }
+            };
+            model.graph.addNode(endpointNode), result.nodesAdded++;
+            const docEdge = {
+              id: `${docNodeId}-composes-${endpointId}`,
+              source: docNodeId,
+              destination: endpointId,
+              predicate: "composes",
+              properties: {}
+            };
+            model.graph.addEdge(docEdge), result.edgesAdded++;
+          }
+        }
+      }
+      if (spec.components?.schemas) {
+        const schemaEntries = Object.entries(spec.components.schemas);
+        for (const [schemaName, schemaSpec] of schemaEntries) {
+          const schemaId = `api.schema.${schemaName}`, schemaNode = {
+            id: schemaId,
+            layer: "api",
+            type: "schema",
+            name: schemaName,
+            description: schemaSpec.description,
+            properties: {
+              schemaName,
+              schema: schemaSpec
+            }
+          };
+          model.graph.addNode(schemaNode), result.nodesAdded++;
+          const schemaEdge = {
+            id: `${docNodeId}-contains-${schemaId}`,
+            source: docNodeId,
+            destination: schemaId,
+            predicate: "contains",
+            properties: {}
+          };
+          model.graph.addEdge(schemaEdge), result.edgesAdded++;
+        }
+      }
+      if (spec.components?.securitySchemes) {
+        const schemeEntries = Object.entries(spec.components.securitySchemes);
+        for (const [schemeName, schemeSpec] of schemeEntries) {
+          const schemeId = `api.security-scheme.${schemeName}`, schemeSpec_ = schemeSpec, securityNode = {
+            id: schemeId,
+            layer: "api",
+            type: "security-scheme",
+            name: schemeName,
+            description: schemeSpec_.description,
+            properties: {
+              type: schemeSpec_.type,
+              scheme: schemeSpec_.scheme,
+              bearerFormat: schemeSpec_.bearerFormat,
+              flows: schemeSpec_.flows,
+              openIdConnectUrl: schemeSpec_.openIdConnectUrl
+            }
+          };
+          model.graph.addNode(securityNode), result.nodesAdded++;
+          const secEdge = {
+            id: `${docNodeId}-uses-${schemeId}`,
+            source: docNodeId,
+            destination: schemeId,
+            predicate: "uses",
+            properties: {}
+          };
+          model.graph.addEdge(secEdge), result.edgesAdded++;
+        }
+      }
+      return result.success = result.errorsCount === 0, isTelemetryEnabled && span && (span.setAttribute("import.nodesAdded", result.nodesAdded), span.setAttribute("import.edgesAdded", result.edgesAdded), span.setAttribute("import.errors", result.errorsCount), span.setStatus({ code: result.success ? 0 : 1 })), result;
+    } catch (error) {
+      return result.errors.push({
+        message: getErrorMessage(error)
+      }), result.errorsCount++, isTelemetryEnabled && span && (span.recordException(error), span.setStatus({ code: 2, message: String(error) })), result;
+    } finally {
+      endSpan(span);
+    }
+  }
+}
+export {
+  OpenAPIImporter
+};
+//# sourceMappingURL=openapi-importer.js.map

package/dist/import/openapi-importer.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/import/openapi-importer.ts"],
+  "sourcesContent": ["import type { Model } from \"../core/model.js\";\nimport type { Importer, ImportOptions, ImportResult } from \"./types.js\";\nimport type { Span } from \"@opentelemetry/api\";\nimport { isTelemetryEnabled, startSpan, endSpan } from \"../telemetry/index.js\";\nimport { getErrorMessage } from \"../utils/errors.js\";\n\n/**\n * OpenAPI 3.0 Importer for layer 6 (API)\n * Parses OpenAPI JSON specifications and creates graph nodes/edges\n */\nexport class OpenAPIImporter implements Importer {\n  name = \"OpenAPI\";\n  supportedFormats = [\"json\"];\n\n  async import(data: string, model: Model, _options: ImportOptions = {}): Promise<ImportResult> {\n    const span: Span | null = isTelemetryEnabled ? startSpan(\"import.format.openapi\") : null;\n    const result: ImportResult = {\n      success: false,\n      nodesAdded: 0,\n      edgesAdded: 0,\n      errorsCount: 0,\n      errors: [],\n    };\n\n    try {\n      // Validate merge strategy - only 'add' is supported\n      if (_options.mergeStrategy && _options.mergeStrategy !== 'add') {\n        result.errors.push({\n          message: `OpenAPI importer only supports 'add' merge strategy. Requested: '${_options.mergeStrategy}'.`\n        });\n        result.errorsCount++;\n        return result;\n      }\n\n      // Parse JSON specification\n      let spec: any;\n      try {\n        spec = JSON.parse(data);\n      } catch (e) {\n        result.errors.push({\n          message: \"Failed to parse OpenAPI specification: Invalid JSON\",\n        });\n        result.errorsCount++;\n        return result;\n      }\n\n      if (!spec.openapi && !spec.swagger) {\n        result.errors.push({\n          message: \"Not a valid OpenAPI specification (missing openapi or swagger field)\",\n        });\n        result.errorsCount++;\n        return result;\n      }\n\n      // Create root document node with unique ID based on spec title\n      const titlePart = (spec.info?.title || \"api\")\n        .toLowerCase()\n        .replace(/[^a-z0-9]+/g, \"-\")\n        .replace(/^-|-$/g, \"\");\n      const docNodeId = `api.openapi-document.${titlePart}`;\n      const docNode = {\n        id: docNodeId,\n        layer: \"api\",\n        type: \"openapi-document\",\n        name: spec.info?.title || \"OpenAPI Document\",\n        description: spec.info?.description,\n        properties: {\n          version: spec.info?.version || \"1.0.0\",\n          servers: spec.servers || [],\n          info: spec.info || {},\n        },\n      };\n\n      model.graph.addNode(docNode);\n      result.nodesAdded++;\n\n      // Create endpoint nodes from paths\n      if (spec.paths) {\n        const pathEntries = Object.entries(spec.paths);\n        for (const [pathName, pathSpec] of pathEntries) {\n          const pathSpec_ = pathSpec as Record<string, any>;\n          const methods = Object.keys(pathSpec_).filter((k) =>\n            [\"get\", \"post\", \"put\", \"delete\", \"patch\", \"head\", \"options\"].includes(k)\n          );\n\n          for (const method of methods) {\n            const operation = pathSpec_[method];\n            const operationId =\n              operation.operationId || `${method}-${pathName}`.replace(/[^a-zA-Z0-9-]/g, \"-\");\n            const endpointId = `api.endpoint.${operationId}`;\n\n            // Create endpoint node\n            const endpointNode = {\n              id: endpointId,\n              layer: \"api\",\n              type: \"endpoint\",\n              name: operation.summary || `${method.toUpperCase()} ${pathName}`,\n              description: operation.description,\n              properties: {\n                method: method.toUpperCase(),\n                path: pathName,\n                tags: operation.tags || [],\n                parameters: operation.parameters || [],\n                requestBody: operation.requestBody,\n                responses: operation.responses || {},\n                security: operation.security,\n                deprecated: operation.deprecated || false,\n              },\n            };\n\n            model.graph.addNode(endpointNode);\n            result.nodesAdded++;\n\n            // Create edge from document to endpoint\n            const docEdge = {\n              id: `${docNodeId}-composes-${endpointId}`,\n              source: docNodeId,\n              destination: endpointId,\n              predicate: \"composes\",\n              properties: {},\n            };\n\n            model.graph.addEdge(docEdge);\n            result.edgesAdded++;\n          }\n        }\n      }\n\n      // Create schema nodes from components.schemas\n      if (spec.components?.schemas) {\n        const schemaEntries = Object.entries(spec.components.schemas);\n        for (const [schemaName, schemaSpec] of schemaEntries) {\n          const schemaId = `api.schema.${schemaName}`;\n\n          const schemaNode = {\n            id: schemaId,\n            layer: \"api\",\n            type: \"schema\",\n            name: schemaName,\n            description: (schemaSpec as Record<string, any>).description,\n            properties: {\n              schemaName,\n              schema: schemaSpec,\n            },\n          };\n\n          model.graph.addNode(schemaNode);\n          result.nodesAdded++;\n\n          // Create edge from document to schema\n          const schemaEdge = {\n            id: `${docNodeId}-contains-${schemaId}`,\n            source: docNodeId,\n            destination: schemaId,\n            predicate: \"contains\",\n            properties: {},\n          };\n\n          model.graph.addEdge(schemaEdge);\n          result.edgesAdded++;\n        }\n      }\n\n      // Create security scheme nodes from components.securitySchemes\n      if (spec.components?.securitySchemes) {\n        const schemeEntries = Object.entries(spec.components.securitySchemes);\n        for (const [schemeName, schemeSpec] of schemeEntries) {\n          const schemeId = `api.security-scheme.${schemeName}`;\n          const schemeSpec_ = schemeSpec as Record<string, any>;\n\n          const securityNode = {\n            id: schemeId,\n            layer: \"api\",\n            type: \"security-scheme\",\n            name: schemeName,\n            description: schemeSpec_.description,\n            properties: {\n              type: schemeSpec_.type,\n              scheme: schemeSpec_.scheme,\n              bearerFormat: schemeSpec_.bearerFormat,\n              flows: schemeSpec_.flows,\n              openIdConnectUrl: schemeSpec_.openIdConnectUrl,\n            },\n          };\n\n          model.graph.addNode(securityNode);\n          result.nodesAdded++;\n\n          // Create edge from document to security scheme\n          const secEdge = {\n            id: `${docNodeId}-uses-${schemeId}`,\n            source: docNodeId,\n            destination: schemeId,\n            predicate: \"uses\",\n            properties: {},\n          };\n\n          model.graph.addEdge(secEdge);\n          result.edgesAdded++;\n        }\n      }\n\n      result.success = result.errorsCount === 0;\n\n      if (isTelemetryEnabled && span) {\n        span.setAttribute(\"import.nodesAdded\", result.nodesAdded);\n        span.setAttribute(\"import.edgesAdded\", result.edgesAdded);\n        span.setAttribute(\"import.errors\", result.errorsCount);\n        span.setStatus({ code: result.success ? 0 : 1 });\n      }\n\n      return result;\n    } catch (error) {\n      result.errors.push({\n        message: getErrorMessage(error),\n      });\n      result.errorsCount++;\n\n      if (isTelemetryEnabled && span) {\n        span.recordException(error as Error);\n        span.setStatus({ code: 2, message: String(error) });\n      }\n\n      return result;\n    } finally {\n      endSpan(span);\n    }\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/import/types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=types.js.map

package/dist/import/types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}