feat(specs): add cURL snippets

Author: shortcuts

scripts/package.json

@@ -50,6 +50,7 @@
     "js-yaml": "4.1.0",
     "knip": "5.30.4",
     "micromatch": "4.0.8",
+    "openapi-snippet": "^0.14.0",
     "semver": "7.6.3",
     "spinnies": "0.5.1",
     "typescript": "5.6.2",

scripts/specs/format.ts

@@ -1,6 +1,7 @@
 import fsp from 'fs/promises';
 
 import yaml from 'js-yaml';
+import OpenAPISnippet from 'openapi-snippet';
 
 import { Cache } from '../cache.js';
 import { GENERATORS, exists, run, toAbsolutePath } from '../common.js';
@@ -100,6 +101,21 @@ export async function transformBundle({
         }
       }
 
+      try {
+        const results = OpenAPISnippet.getEndpointSnippets(bundledSpec, pathKey, method, ['shell_curl']);
+
+        if (results.snippets.length > 0) {
+          specMethod['x-codeSamples'].push({
+            lang: 'cURL',
+            label: 'curl',
+            source: results.snippets[0].content,
+          });
+        }
+      } catch (err) {
+        // eslint-disable-next-line no-console
+        console.error(`unable to generate cURL snippet for path ${pathKey}.${method}: `, err);
+      }
+
       if (!bundledSpec.paths[pathKey][method].tags) {
         continue;
       }