npm - @apidiff/core - Versions diffs - 1.0.0 - Mend

@apidiff/core 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (249) hide show

package/dist/ast/hash.d.ts +2 -0
package/dist/ast/hash.d.ts.map +1 -0
package/dist/ast/index.d.ts +3 -0
package/dist/ast/index.d.ts.map +1 -0
package/dist/ast/traverse.d.ts +13 -0
package/dist/ast/traverse.d.ts.map +1 -0
package/dist/config/index.d.ts +9 -0
package/dist/config/index.d.ts.map +1 -0
package/dist/diff/auth-differ.d.ts +4 -0
package/dist/diff/auth-differ.d.ts.map +1 -0
package/dist/diff/endpoint-differ.d.ts +3 -0
package/dist/diff/endpoint-differ.d.ts.map +1 -0
package/dist/diff/index.d.ts +3 -0
package/dist/diff/index.d.ts.map +1 -0
package/dist/diff/schema-differ.d.ts +3 -0
package/dist/diff/schema-differ.d.ts.map +1 -0
package/dist/diff/server-differ.d.ts +3 -0
package/dist/diff/server-differ.d.ts.map +1 -0
package/dist/index.cjs +2902 -0
package/dist/index.d.ts +15 -0
package/dist/index.d.ts.map +1 -0
package/dist/index.js +2855 -0
package/dist/loader/file-loader.d.ts +5 -0
package/dist/loader/file-loader.d.ts.map +1 -0
package/dist/loader/git-loader.d.ts +5 -0
package/dist/loader/git-loader.d.ts.map +1 -0
package/dist/loader/index.d.ts +7 -0
package/dist/loader/index.d.ts.map +1 -0
package/dist/loader/url-loader.d.ts +5 -0
package/dist/loader/url-loader.d.ts.map +1 -0
package/dist/output/html.d.ts +3 -0
package/dist/output/html.d.ts.map +1 -0
package/dist/output/index.d.ts +3 -0
package/dist/output/index.d.ts.map +1 -0
package/dist/output/json.d.ts +3 -0
package/dist/output/json.d.ts.map +1 -0
package/dist/output/markdown.d.ts +3 -0
package/dist/output/markdown.d.ts.map +1 -0
package/dist/output/terminal.d.ts +3 -0
package/dist/output/terminal.d.ts.map +1 -0
package/dist/parsers/base.d.ts +8 -0
package/dist/parsers/base.d.ts.map +1 -0
package/dist/parsers/graphql/index.d.ts +13 -0
package/dist/parsers/graphql/index.d.ts.map +1 -0
package/dist/parsers/index.d.ts +7 -0
package/dist/parsers/index.d.ts.map +1 -0
package/dist/parsers/openapi2/index.d.ts +9 -0
package/dist/parsers/openapi2/index.d.ts.map +1 -0
package/dist/parsers/openapi3/index.d.ts +9 -0
package/dist/parsers/openapi3/index.d.ts.map +1 -0
package/dist/parsers/openapi3/ref-resolver.d.ts +2 -0
package/dist/parsers/openapi3/ref-resolver.d.ts.map +1 -0
package/dist/parsers/openapi3/schema-normalizer.d.ts +3 -0
package/dist/parsers/openapi3/schema-normalizer.d.ts.map +1 -0
package/dist/parsers/openapi3/security-normalizer.d.ts +3 -0
package/dist/parsers/openapi3/security-normalizer.d.ts.map +1 -0
package/dist/parsers/protobuf/index.d.ts +14 -0
package/dist/parsers/protobuf/index.d.ts.map +1 -0
package/dist/rules/auth/oauth-scope-removed.d.ts +9 -0
package/dist/rules/auth/oauth-scope-removed.d.ts.map +1 -0
package/dist/rules/auth/security-added.d.ts +9 -0
package/dist/rules/auth/security-added.d.ts.map +1 -0
package/dist/rules/auth/security-removed.d.ts +9 -0
package/dist/rules/auth/security-removed.d.ts.map +1 -0
package/dist/rules/auth/security-scheme-type-changed.d.ts +9 -0
package/dist/rules/auth/security-scheme-type-changed.d.ts.map +1 -0
package/dist/rules/base.d.ts +19 -0
package/dist/rules/base.d.ts.map +1 -0
package/dist/rules/endpoint/endpoint-added.d.ts +9 -0
package/dist/rules/endpoint/endpoint-added.d.ts.map +1 -0
package/dist/rules/endpoint/endpoint-deprecated.d.ts +9 -0
package/dist/rules/endpoint/endpoint-deprecated.d.ts.map +1 -0
package/dist/rules/endpoint/endpoint-removed.d.ts +9 -0
package/dist/rules/endpoint/endpoint-removed.d.ts.map +1 -0
package/dist/rules/endpoint/http-method-changed.d.ts +9 -0
package/dist/rules/endpoint/http-method-changed.d.ts.map +1 -0
package/dist/rules/endpoint/path-changed.d.ts +9 -0
package/dist/rules/endpoint/path-changed.d.ts.map +1 -0
package/dist/rules/index.d.ts +4 -0
package/dist/rules/index.d.ts.map +1 -0
package/dist/rules/meta/server-removed.d.ts +9 -0
package/dist/rules/meta/server-removed.d.ts.map +1 -0
package/dist/rules/param/param-added.d.ts +9 -0
package/dist/rules/param/param-added.d.ts.map +1 -0
package/dist/rules/param/param-deprecated.d.ts +9 -0
package/dist/rules/param/param-deprecated.d.ts.map +1 -0
package/dist/rules/param/param-enum-value-added.d.ts +9 -0
package/dist/rules/param/param-enum-value-added.d.ts.map +1 -0
package/dist/rules/param/param-enum-value-removed.d.ts +9 -0
package/dist/rules/param/param-enum-value-removed.d.ts.map +1 -0
package/dist/rules/param/param-location-changed.d.ts +9 -0
package/dist/rules/param/param-location-changed.d.ts.map +1 -0
package/dist/rules/param/param-removed.d.ts +9 -0
package/dist/rules/param/param-removed.d.ts.map +1 -0
package/dist/rules/param/param-required-added.d.ts +9 -0
package/dist/rules/param/param-required-added.d.ts.map +1 -0
package/dist/rules/param/param-required-true-to-false.d.ts +9 -0
package/dist/rules/param/param-required-true-to-false.d.ts.map +1 -0
package/dist/rules/param/param-type-changed.d.ts +9 -0
package/dist/rules/param/param-type-changed.d.ts.map +1 -0
package/dist/rules/request/request-body-added-required.d.ts +9 -0
package/dist/rules/request/request-body-added-required.d.ts.map +1 -0
package/dist/rules/request/request-body-removed.d.ts +9 -0
package/dist/rules/request/request-body-removed.d.ts.map +1 -0
package/dist/rules/request/request-content-type-added.d.ts +9 -0
package/dist/rules/request/request-content-type-added.d.ts.map +1 -0
package/dist/rules/request/request-content-type-removed.d.ts +9 -0
package/dist/rules/request/request-content-type-removed.d.ts.map +1 -0
package/dist/rules/request/request-field-added-required.d.ts +9 -0
package/dist/rules/request/request-field-added-required.d.ts.map +1 -0
package/dist/rules/request/request-field-removed.d.ts +9 -0
package/dist/rules/request/request-field-removed.d.ts.map +1 -0
package/dist/rules/request/request-field-type-changed.d.ts +9 -0
package/dist/rules/request/request-field-type-changed.d.ts.map +1 -0
package/dist/rules/request/request-required-false-to-true.d.ts +9 -0
package/dist/rules/request/request-required-false-to-true.d.ts.map +1 -0
package/dist/rules/response/response-field-added.d.ts +9 -0
package/dist/rules/response/response-field-added.d.ts.map +1 -0
package/dist/rules/response/response-field-removed.d.ts +9 -0
package/dist/rules/response/response-field-removed.d.ts.map +1 -0
package/dist/rules/response/response-field-type-changed.d.ts +9 -0
package/dist/rules/response/response-field-type-changed.d.ts.map +1 -0
package/dist/rules/response/response-header-added-required.d.ts +9 -0
package/dist/rules/response/response-header-added-required.d.ts.map +1 -0
package/dist/rules/response/response-header-removed.d.ts +9 -0
package/dist/rules/response/response-header-removed.d.ts.map +1 -0
package/dist/rules/response/response-media-type-added.d.ts +9 -0
package/dist/rules/response/response-media-type-added.d.ts.map +1 -0
package/dist/rules/response/response-media-type-removed.d.ts +9 -0
package/dist/rules/response/response-media-type-removed.d.ts.map +1 -0
package/dist/rules/response/response-status-added.d.ts +9 -0
package/dist/rules/response/response-status-added.d.ts.map +1 -0
package/dist/rules/response/response-status-removed.d.ts +9 -0
package/dist/rules/response/response-status-removed.d.ts.map +1 -0
package/dist/types/ast.d.ts +140 -0
package/dist/types/ast.d.ts.map +1 -0
package/dist/types/config.d.ts +17 -0
package/dist/types/config.d.ts.map +1 -0
package/dist/types/diff.d.ts +43 -0
package/dist/types/diff.d.ts.map +1 -0
package/dist/types/errors.d.ts +21 -0
package/dist/types/errors.d.ts.map +1 -0
package/dist/types/index.d.ts +6 -0
package/dist/types/index.d.ts.map +1 -0
package/dist/types/semantic.d.ts +45 -0
package/dist/types/semantic.d.ts.map +1 -0
package/package.json +31 -0
package/src/ast/hash.ts +26 -0
package/src/ast/index.ts +2 -0
package/src/ast/traverse.ts +59 -0
package/src/config/index.ts +44 -0
package/src/diff/auth-differ.ts +72 -0
package/src/diff/endpoint-differ.ts +144 -0
package/src/diff/index.ts +13 -0
package/src/diff/schema-differ.ts +70 -0
package/src/diff/server-differ.ts +22 -0
package/src/index.ts +92 -0
package/src/loader/file-loader.ts +19 -0
package/src/loader/git-loader.ts +22 -0
package/src/loader/index.ts +32 -0
package/src/loader/url-loader.ts +25 -0
package/src/output/html.ts +177 -0
package/src/output/index.ts +16 -0
package/src/output/json.ts +5 -0
package/src/output/markdown.ts +29 -0
package/src/output/terminal.ts +37 -0
package/src/parsers/base.ts +8 -0
package/src/parsers/graphql/index.ts +181 -0
package/src/parsers/index.ts +61 -0
package/src/parsers/openapi2/index.ts +218 -0
package/src/parsers/openapi3/index.ts +223 -0
package/src/parsers/openapi3/ref-resolver.ts +101 -0
package/src/parsers/openapi3/schema-normalizer.ts +52 -0
package/src/parsers/openapi3/security-normalizer.ts +18 -0
package/src/parsers/protobuf/index.ts +208 -0
package/src/rules/auth/oauth-scope-removed.ts +34 -0
package/src/rules/auth/security-added.ts +32 -0
package/src/rules/auth/security-removed.ts +47 -0
package/src/rules/auth/security-scheme-type-changed.ts +30 -0
package/src/rules/base.ts +29 -0
package/src/rules/endpoint/endpoint-added.ts +26 -0
package/src/rules/endpoint/endpoint-deprecated.ts +29 -0
package/src/rules/endpoint/endpoint-removed.ts +26 -0
package/src/rules/endpoint/http-method-changed.ts +29 -0
package/src/rules/endpoint/path-changed.ts +29 -0
package/src/rules/index.ts +83 -0
package/src/rules/meta/server-removed.ts +26 -0
package/src/rules/param/param-added.ts +52 -0
package/src/rules/param/param-deprecated.ts +34 -0
package/src/rules/param/param-enum-value-added.ts +32 -0
package/src/rules/param/param-enum-value-removed.ts +32 -0
package/src/rules/param/param-location-changed.ts +43 -0
package/src/rules/param/param-removed.ts +52 -0
package/src/rules/param/param-required-added.ts +34 -0
package/src/rules/param/param-required-true-to-false.ts +34 -0
package/src/rules/param/param-type-changed.ts +32 -0
package/src/rules/request/request-body-added-required.ts +33 -0
package/src/rules/request/request-body-removed.ts +30 -0
package/src/rules/request/request-content-type-added.ts +31 -0
package/src/rules/request/request-content-type-removed.ts +31 -0
package/src/rules/request/request-field-added-required.ts +41 -0
package/src/rules/request/request-field-removed.ts +35 -0
package/src/rules/request/request-field-type-changed.ts +37 -0
package/src/rules/request/request-required-false-to-true.ts +56 -0
package/src/rules/response/response-field-added.ts +34 -0
package/src/rules/response/response-field-removed.ts +34 -0
package/src/rules/response/response-field-type-changed.ts +37 -0
package/src/rules/response/response-header-added-required.ts +47 -0
package/src/rules/response/response-header-removed.ts +32 -0
package/src/rules/response/response-media-type-added.ts +32 -0
package/src/rules/response/response-media-type-removed.ts +32 -0
package/src/rules/response/response-status-added.ts +31 -0
package/src/rules/response/response-status-removed.ts +31 -0
package/src/types/ast.ts +164 -0
package/src/types/config.ts +31 -0
package/src/types/diff.ts +49 -0
package/src/types/errors.ts +26 -0
package/src/types/index.ts +5 -0
package/src/types/semantic.ts +60 -0
package/test/integration/stripe-v1.yaml +36 -0
package/test/integration/stripe-v2.yaml +35 -0
package/tests/ast.test.ts +60 -0
package/tests/config.test.ts +43 -0
package/tests/diff/auth-differ.test.ts +55 -0
package/tests/diff/endpoint-differ.test.ts +42 -0
package/tests/diff/schema-differ.test.ts +46 -0
package/tests/diff/server-differ.test.ts +23 -0
package/tests/diff.test.ts +116 -0
package/tests/fixtures/openapi3/auth-added/v1.yaml +11 -0
package/tests/fixtures/openapi3/auth-added/v2.yaml +18 -0
package/tests/integration.test.ts +21 -0
package/tests/loader-more.test.ts +75 -0
package/tests/loader.test.ts +61 -0
package/tests/output.test.ts +58 -0
package/tests/parsers/openapi3-coverage.test.ts +77 -0
package/tests/parsers/openapi3.test.ts +41 -0
package/tests/parsers/parsers-other.test.ts +135 -0
package/tests/parsers/ref-resolver.test.ts +78 -0
package/tests/parsers/schema-normalizer.test.ts +30 -0
package/tests/rules/auth-meta.test.ts +87 -0
package/tests/rules/base.test.ts +44 -0
package/tests/rules/endpoint.test.ts +122 -0
package/tests/rules/param.test.ts +242 -0
package/tests/rules/request.test.ts +147 -0
package/tests/rules/response.test.ts +161 -0
package/tests/rules/rules-coverage.test.ts +64 -0
package/tests/types-errors.test.ts +22 -0
package/tsconfig.json +8 -0
package/tsconfig.tsbuildinfo +1 -0

package/src/output/html.ts ADDED Viewed

@@ -0,0 +1,177 @@
+import type { SemanticChange } from '../types/index.js';
+export function formatHtml(changes: SemanticChange[]): string {
+  const breaking = changes.filter(c => c.severity === 'breaking');
+  const warning = changes.filter(c => c.severity === 'warning');
+  const info = changes.filter(c => c.severity === 'info');
+  return `
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>Semantic API Diff Report</title>
+<style>
+  body {
+    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
+    line-height: 1.6;
+    color: #333;
+    max-width: 900px;
+    margin: 0 auto;
+    padding: 2rem;
+    background: #f9f9f9;
+  }
+  h1 {
+    color: #222;
+    border-bottom: 2px solid #eaeaea;
+    padding-bottom: 0.5rem;
+  }
+  .summary {
+    display: flex;
+    gap: 1rem;
+    margin: 2rem 0;
+  }
+  .stat-card {
+    background: white;
+    padding: 1.5rem;
+    border-radius: 8px;
+    box-shadow: 0 2px 5px rgba(0,0,0,0.05);
+    flex: 1;
+    text-align: center;
+    border-top: 4px solid #ccc;
+  }
+  .stat-card.breaking { border-top-color: #e53e3e; }
+  .stat-card.warning { border-top-color: #d69e2e; }
+  .stat-card.info { border-top-color: #3182ce; }
+  .stat-card .value {
+    font-size: 2rem;
+    font-weight: bold;
+    margin: 0.5rem 0;
+  }
+  .stat-card .label {
+    text-transform: uppercase;
+    font-size: 0.8rem;
+    letter-spacing: 0.05em;
+    color: #666;
+  }
+  .change-list {
+    list-style: none;
+    padding: 0;
+  }
+  .change-item {
+    background: white;
+    margin-bottom: 1rem;
+    border-radius: 6px;
+    box-shadow: 0 1px 3px rgba(0,0,0,0.1);
+    overflow: hidden;
+  }
+  .change-header {
+    padding: 1rem;
+    cursor: pointer;
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+    background: #fff;
+    border-left: 4px solid #ccc;
+  }
+  .change-item.breaking .change-header { border-left-color: #e53e3e; }
+  .change-item.warning .change-header { border-left-color: #d69e2e; }
+  .change-item.info .change-header { border-left-color: #3182ce; }
+  .change-title {
+    font-weight: 600;
+  }
+  .change-body {
+    padding: 1rem;
+    border-top: 1px solid #eaeaea;
+    background: #fafafa;
+    display: none;
+  }
+  .open .change-body {
+    display: block;
+  }
+  .badge {
+    padding: 0.25rem 0.5rem;
+    border-radius: 9999px;
+    font-size: 0.75rem;
+    font-weight: bold;
+    background: #eee;
+  }
+  .badge.breaking { background: #fee2e2; color: #991b1b; }
+  .badge.warning { background: #fef3c7; color: #92400e; }
+  .badge.info { background: #dbeafe; color: #1e40af; }
+  .detail-row {
+    margin-bottom: 0.5rem;
+  }
+  .detail-label {
+    font-weight: 600;
+    color: #555;
+    width: 100px;
+    display: inline-block;
+  }
+  code {
+    background: #edf2f7;
+    padding: 0.1rem 0.3rem;
+    border-radius: 3px;
+    font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;
+    font-size: 0.9em;
+  }
+</style>
+<script>
+  function toggleChange(el) {
+    el.parentElement.classList.toggle('open');
+  }
+</script>
+</head>
+<body>
+<h1>API Diff Report</h1>
+<div class="summary">
+  <div class="stat-card breaking">
+    <div class="label">Breaking</div>
+    <div class="value">${breaking.length}</div>
+  </div>
+  <div class="stat-card warning">
+    <div class="label">Warnings</div>
+    <div class="value">${warning.length}</div>
+  </div>
+  <div class="stat-card info">
+    <div class="label">Info</div>
+    <div class="value">${info.length}</div>
+  </div>
+</div>
+<h2>All Changes</h2>
+<ul class="change-list">
+  ${changes.map(renderChange).join('\n')}
+</ul>
+</body>
+</html>
+  `.trim();
+}
+function renderChange(c: SemanticChange): string {
+  let locStr = `<code>${c.location.method} ${c.location.path}</code>`;
+  if (c.location.paramName) locStr += ` (param: <code>${c.location.paramName}</code>)`;
+  if (c.location.field) locStr += ` (field: <code>${c.location.field}</code>)`;
+  return `
+  <li class="change-item ${c.severity}">
+    <div class="change-header" onclick="toggleChange(this)">
+      <div class="change-title">${c.message}</div>
+      <span class="badge ${c.severity}">${c.severity}</span>
+    </div>
+    <div class="change-body">
+      <div class="detail-row"><span class="detail-label">Location:</span> ${locStr}</div>
+      <div class="detail-row"><span class="detail-label">Category:</span> ${c.category}</div>
+      <div class="detail-row"><span class="detail-label">Rule:</span> <code>${c.ruleId}</code></div>
+      ${c.consequence ? `<div class="detail-row"><span class="detail-label">Impact:</span> ${c.consequence}</div>` : ''}
+      ${c.migration ? `<div class="detail-row"><span class="detail-label">Migration:</span> ${c.migration}</div>` : ''}
+    </div>
+  </li>
+  `;
+}

package/src/output/index.ts ADDED Viewed

@@ -0,0 +1,16 @@
+import type { SemanticChange, ApidiffConfig } from '../types/index.js';
+import { formatTerminal } from './terminal.js';
+import { formatJson } from './json.js';
+import { formatMarkdown } from './markdown.js';
+import { formatHtml } from './html.js';
+export function formatOutput(changes: SemanticChange[], format: ApidiffConfig['output']['format']): string {
+  switch (format) {
+    case 'json': return formatJson(changes);
+    case 'markdown': return formatMarkdown(changes);
+    case 'html': return formatHtml(changes);
+    case 'terminal':
+    default:
+      return formatTerminal(changes);
+  }
+}

package/src/output/json.ts ADDED Viewed

@@ -0,0 +1,5 @@
+import type { SemanticChange } from '../types/index.js';
+export function formatJson(changes: SemanticChange[]): string {
+  return JSON.stringify({ changes }, null, 2);
+}

package/src/output/markdown.ts ADDED Viewed

@@ -0,0 +1,29 @@
+import type { SemanticChange } from '../types/index.js';
+const SEVERITY_EMOJI = {
+  breaking: '❌',
+  warning: '⚠️',
+  info: 'ℹ️'
+};
+export function formatMarkdown(changes: SemanticChange[]): string {
+  if (changes.length === 0) {
+    return 'No changes detected.\n';
+  }
+  let md = '## API Changes\n\n';
+  for (const c of changes) {
+    const emoji = SEVERITY_EMOJI[c.severity] || SEVERITY_EMOJI.info;
+    let locStr = `**${c.location.method}** \`${c.location.path}\``;
+    if (c.location.paramName) locStr += ` (param: \`${c.location.paramName}\`)`;
+    if (c.location.field) locStr += ` (field: \`${c.location.field}\`)`;
+    md += `### ${emoji} ${c.message}\n`;
+    md += `- **Location:** ${locStr}\n`;
+    md += `- **Consequence:** ${c.consequence}\n`;
+    md += `- **Migration:** ${c.migration}\n\n`;
+  }
+  return md;
+}

package/src/output/terminal.ts ADDED Viewed

@@ -0,0 +1,37 @@
+import chalk from 'chalk';
+import type { SemanticChange } from '../types/index.js';
+const SEVERITY_ICONS = {
+  breaking: chalk.red('❌'),
+  warning: chalk.yellow('⚠️ '),
+  info: chalk.blue('ℹ '),
+};
+const SEVERITY_COLORS = {
+  breaking: chalk.red,
+  warning: chalk.yellow,
+  info: chalk.blue,
+};
+export function formatTerminal(changes: SemanticChange[]): string {
+  if (changes.length === 0) {
+    return chalk.green('No changes detected.\n');
+  }
+  let output = '';
+  for (const c of changes) {
+    const icon = SEVERITY_ICONS[c.severity] || SEVERITY_ICONS.info;
+    const color = SEVERITY_COLORS[c.severity] || SEVERITY_COLORS.info;
+    let locStr = `${c.location.method} ${c.location.path}`;
+    if (c.location.paramName) locStr += ` (param: ${c.location.paramName})`;
+    if (c.location.field) locStr += ` (field: ${c.location.field})`;
+    output += `${icon} ${color(c.message)}\n`;
+    output += `   Location: ${locStr}\n`;
+    output += `   Consequence: ${c.consequence}\n`;
+    output += `   Migration: ${c.migration}\n\n`;
+  }
+  return output;
+}

package/src/parsers/base.ts ADDED Viewed

@@ -0,0 +1,8 @@
+import type { NormalizedAST, SpecFormat } from '../types/index.js';
+import type { RawSpec } from '../loader/index.js';
+export interface ISpecParser {
+  readonly format: SpecFormat;
+  canParse(raw: RawSpec): boolean;
+  parse(raw: RawSpec): Promise<NormalizedAST>;
+}

package/src/parsers/graphql/index.ts ADDED Viewed

@@ -0,0 +1,181 @@
+import { parse as parseGraphql, DocumentNode, ObjectTypeDefinitionNode, FieldDefinitionNode, InputObjectTypeDefinitionNode, TypeNode, EnumTypeDefinitionNode } from 'graphql';
+import type { NormalizedAST, Endpoint, Parameter, RequestBody, ResponseDef, ComponentMap, Schema } from '../../types/index.js';
+import type { RawSpec } from '../../loader/index.js';
+import type { ISpecParser } from '../base.js';
+import { ParseError } from '../../types/errors.js';
+export class GraphqlParser implements ISpecParser {
+  readonly format = 'graphql';
+  canParse(raw: RawSpec): boolean {
+    return raw.format === 'graphql' || raw.content.includes('type Query') || raw.content.includes('type Mutation');
+  }
+  async parse(raw: RawSpec): Promise<NormalizedAST> {
+    let ast: DocumentNode;
+    try {
+      ast = parseGraphql(raw.content);
+    } catch (err: any) {
+      throw new ParseError('Failed to parse GraphQL spec', err.locations?.[0]?.line, err.locations?.[0]?.column, raw.sourcePath, err);
+    }
+    const meta = {
+      title: 'GraphQL API',
+      version: '1.0.0',
+      format: 'graphql' as const,
+      rawVersion: '1'
+    };
+    const components: ComponentMap = {
+      schemas: {},
+      securitySchemes: {},
+      parameters: {},
+      responses: {},
+      headers: {},
+      requestBodies: {}
+    };
+    const endpoints: Endpoint[] = [];
+    // First pass: extract schemas
+    for (const def of ast.definitions) {
+      if (def.kind === 'ObjectTypeDefinition' || def.kind === 'InputObjectTypeDefinition' || def.kind === 'InterfaceTypeDefinition') {
+        components.schemas[def.name.value] = this.typeDefToSchema(def as any);
+      } else if (def.kind === 'EnumTypeDefinition') {
+        components.schemas[def.name.value] = this.enumDefToSchema(def);
+      }
+    }
+    // Second pass: extract endpoints from Query, Mutation, Subscription
+    for (const def of ast.definitions) {
+      if (def.kind === 'ObjectTypeDefinition' && ['Query', 'Mutation', 'Subscription'].includes(def.name.value)) {
+        const typeName = def.name.value;
+        if (def.fields) {
+          for (const field of def.fields) {
+            endpoints.push(this.fieldToEndpoint(field, typeName));
+          }
+        }
+      }
+    }
+    return {
+      meta,
+      servers: [],
+      endpoints,
+      components,
+      security: []
+    };
+  }
+  private typeDefToSchema(def: ObjectTypeDefinitionNode | InputObjectTypeDefinitionNode): Schema {
+    const properties: Record<string, Schema> = {};
+    const required: string[] = [];
+    if (def.fields) {
+      for (const field of def.fields) {
+        const fieldName = field.name.value;
+        properties[fieldName] = this.resolveTypeNode(field.type);
+        if (field.type.kind === 'NonNullType') {
+          required.push(fieldName);
+        }
+      }
+    }
+    const schema: Schema = {
+      type: 'object',
+      properties
+    };
+    if (required.length > 0) {
+      schema.required = required;
+    }
+    return schema;
+  }
+  private enumDefToSchema(def: EnumTypeDefinitionNode): Schema {
+    const values = def.values?.map(v => v.name.value) || [];
+    return {
+      type: 'string',
+      enum: values
+    };
+  }
+  private resolveTypeNode(typeNode: TypeNode): Schema {
+    if (typeNode.kind === 'NonNullType') {
+      return this.resolveTypeNode(typeNode.type);
+    }
+    if (typeNode.kind === 'ListType') {
+      return {
+        type: 'array',
+        items: this.resolveTypeNode(typeNode.type)
+      };
+    }
+    // NamedType
+    const typeName = typeNode.name.value;
+    switch (typeName) {
+      case 'Int':
+        return { type: 'integer' };
+      case 'Float':
+        return { type: 'number' };
+      case 'String':
+      case 'ID':
+        return { type: 'string' };
+      case 'Boolean':
+        return { type: 'boolean' };
+      default:
+        // Reference to another schema
+        return {
+          type: 'object',
+          $ref: `#/components/schemas/${typeName}`
+        } as any;
+    }
+  }
+  private fieldToEndpoint(field: FieldDefinitionNode, parentType: string): Endpoint {
+    const path = `${parentType}.${field.name.value}`;
+    const id = `POST:${path.toLowerCase()}`;
+    const parameters: Parameter[] = [];
+    if (field.arguments) {
+      for (const arg of field.arguments) {
+        parameters.push({
+          name: arg.name.value,
+          in: 'query', // Map GraphQL args to 'query'
+          required: arg.type.kind === 'NonNullType',
+          deprecated: !!arg.directives?.some(d => d.name.value === 'deprecated'),
+          description: arg.description?.value,
+          schema: this.resolveTypeNode(arg.type)
+        });
+      }
+    }
+    const responses: ResponseDef[] = [
+      {
+        statusCode: '200',
+        description: 'Successful response',
+        content: {
+          'application/graphql': {
+            schema: this.resolveTypeNode(field.type)
+          }
+        },
+        headers: {}
+      }
+    ];
+    return {
+      id,
+      path,
+      method: 'POST',
+      summary: field.description?.value,
+      tags: [parentType],
+      deprecated: !!field.directives?.some(d => d.name.value === 'deprecated'),
+      security: [],
+      parameters,
+      responses,
+      extensions: {}
+    };
+  }
+}

package/src/parsers/index.ts ADDED Viewed

@@ -0,0 +1,61 @@
+import yaml from 'js-yaml';
+import { ParseError, FormatError } from '../types/errors.js';
+import type { NormalizedAST, SpecFormat } from '../types/index.js';
+import type { RawSpec } from '../loader/index.js';
+import type { ISpecParser } from './base.js';
+import { OpenApi3Parser } from './openapi3/index.js';
+import { OpenApi2Parser } from './openapi2/index.js';
+import { ProtobufParser } from './protobuf/index.js';
+import { GraphqlParser } from './graphql/index.js';
+const parsers: ISpecParser[] = [
+  new OpenApi3Parser(),
+  new OpenApi2Parser(),
+  new ProtobufParser(),
+  new GraphqlParser()
+];
+export function registerParser(parser: ISpecParser) {
+  parsers.push(parser);
+}
+export function detectFormat(raw: RawSpec): SpecFormat {
+  if (raw.format) return raw.format;
+  const content = raw.content.trim();
+  if (content.startsWith('syntax = "proto')) return 'protobuf';
+  if (content.includes('type Query') || content.includes('type Mutation')) return 'graphql';
+  let parsed: any;
+  try {
+    parsed = JSON.parse(content);
+  } catch {
+    try {
+      parsed = yaml.load(content);
+    } catch {
+      // not yaml or json
+    }
+  }
+  if (parsed && typeof parsed === 'object') {
+    if (parsed.openapi && typeof parsed.openapi === 'string' && parsed.openapi.startsWith('3.')) {
+      return 'openapi3';
+    }
+    if (parsed.swagger && typeof parsed.swagger === 'string' && parsed.swagger.startsWith('2.')) {
+      return 'openapi2';
+    }
+  }
+  throw new FormatError('Could not detect format. Use --format openapi3|openapi2|protobuf|graphql');
+}
+export async function parseSpec(raw: RawSpec): Promise<NormalizedAST> {
+  const format = detectFormat(raw);
+  const parser = parsers.find(p => p.format === format);
+  if (!parser) {
+    throw new FormatError(`Parser for format '${format}' not implemented yet.`);
+  }
+  return parser.parse(raw);
+}