fix: support reading AsyncAPI documents from stdin (-)

scripts/fetch-asyncapi-example.js

@@ -24,6 +24,26 @@
 const SPEC_EXAMPLES_ZIP_URL = 'https://github.com/asyncapi/spec/archive/refs/heads/master.zip';
 const EXAMPLE_DIRECTORY = path.join(__dirname, '../assets/examples');
 const TEMP_ZIP_NAME = 'spec-examples.zip';
+const EXAMPLES_JSON_PATH = path.join(EXAMPLE_DIRECTORY, 'examples.json');
+
+const shouldFetchExamples = (force = false) => {
+  if (force) {
+    console.log('Force flag detected, fetching examples...');
+    return true;
+  }
+  if (!fs.existsSync(EXAMPLE_DIRECTORY)) {
+    return true;
+  }
+  if (!fs.existsSync(EXAMPLES_JSON_PATH)) {
+    return true;
+  }
+  const content = fs.readFileSync(EXAMPLES_JSON_PATH, { encoding: 'utf-8' });
+  if (!content || content.trim() === '') {
+    return true;
+  }
+  console.log('Examples already exist, skipping fetch. Use --force to refresh.');
+  return false;
+};
 
 const fetchAsyncAPIExamplesFromExternalURL = () => {
   try {
@@ -119,6 +139,13 @@
 };
 
 (async () => {
+  const args = process.argv.slice(2);
+  const force = args.includes('--force') || args.includes('-f');
+
+  if (!shouldFetchExamples(force)) {
+    return;
+  }
+
   await fetchAsyncAPIExamplesFromExternalURL();
   await unzipAsyncAPIExamples();
   await buildCLIListFromExamples();

src/apps/cli/commands/generate/fromTemplate.ts

@@ -1,7 +1,6 @@
 import { Args } from '@oclif/core';
 import { BaseGeneratorCommand } from '@cli/internal/base/BaseGeneratorCommand';
 import { load, Specification } from '@models/SpecificationFile';
-import { ValidationError } from '@errors/validation-error';
 import { GeneratorError } from '@errors/generator-error';
 import { intro } from '@clack/prompts';
 import { inverse } from 'picocolors';
@@ -65,19 +64,7 @@
     const watchTemplate = flags['watch'];
     const genOption = this.buildGenOption(flags, parsedFlags);
 
-    let specification: Specification;
-    try {
-      specification = await load(asyncapi);
-    } catch {
-      return this.error(
-        new ValidationError({
-
-          type: 'invalid-file',
-          filepath: asyncapi,
-        }),
-        { exit: 1 },
-      );
-    }
+    const specification = asyncapiInput;
 
     const result = await this.generatorService.generate(
       specification,

src/domains/models/SpecificationFile.ts

@@ -1,4 +1,5 @@
 import { promises as fs } from 'fs';
+import * as readline from 'readline';
 import path from 'path';
 import { URL } from 'url';
 import yaml from 'js-yaml';
@@ -18,6 +19,7 @@
 const TYPE_CONTEXT_NAME = 'context-name';
 const TYPE_FILE_PATH = 'file-path';
 const TYPE_URL = 'url-path';
+const TYPE_STDIN = 'stdin';
 
 export class Specification {
   private readonly spec: string;
@@ -134,6 +136,33 @@
       fileURL: targetUrl,
     });
   }
+
+  static async fromStdin(): Promise<Specification> {
+    return new Promise((resolve, reject) => {
+      const chunks: string[] = [];
+      const rl = readline.createInterface({
+        input: process.stdin,
+        crlfDelay: Infinity,
+      });
+
+      rl.on('line', (line) => {
+        chunks.push(line);
+      });
+
+      rl.on('close', () => {
+        const spec = chunks.join('\n');
+        if (!spec.trim()) {
+          reject(new Error('No input received from stdin'));
+          return;
+        }
+        resolve(new Specification(spec));
+      });
+
+      rl.on('error', (err) => {
+        reject(new ErrorLoadingSpec('stdin', '-'));
+      });
+    });
+  }
 }
 
 export default class SpecificationFile {
@@ -166,6 +195,11 @@
   // NOSONAR
   try {
     if (filePathOrContextName) {
+      // Handle stdin
+      if (filePathOrContextName === '-') {
+        return Specification.fromStdin();
+      }
+
       if (loadType?.file) {
         return Specification.fromFile(filePathOrContextName);
       }

src/errors/specification-file.ts

@@ -31,7 +31,7 @@ export class SpecificationURLNotFound extends SpecificationFileError {
   }
 }
 
-type From = 'file' | 'url' | 'context' | 'invalid file';
+type From = 'file' | 'url' | 'context' | 'invalid file' | 'stdin';
 
 export class ErrorLoadingSpec extends Error {
   private readonly errorMessages = {
@@ -55,6 +55,10 @@ export class ErrorLoadingSpec extends Error {
       this.name = 'Invalid AsyncAPI file type';
       this.message = 'cli only supports yml ,yaml ,json extension';
     }
+    if (from === 'stdin') {
+      this.name = 'error loading AsyncAPI document from stdin';
+      this.message = 'Reading from stdin (-) is not supported.';
+    }
 
     if (!from) {
       this.name = 'error locating AsyncAPI document';

src/utils/generate/registry.ts

@@ -8,12 +8,26 @@
 
 export async function registryValidation(registryUrl?: string, registryAuth?: string, registryToken?: string) {
   if (!registryUrl) { return; }
+  const TIMEOUT_MS = 5000;
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), TIMEOUT_MS);
+
   try {
-    const response = await fetch(registryUrl as string);
+    const response = await fetch(registryUrl as string, {
+      method: 'HEAD',
+      signal: controller.signal,
+    });
+    clearTimeout(timeoutId);
+
     if (response.status === 401 && !registryAuth && !registryToken) {
       throw new Error('You Need to pass either registryAuth in username:password encoded in Base64 or need to pass registryToken');
     }
-  } catch {
-    throw new Error(`Can't fetch registryURL: ${registryUrl}`);
+  } catch (err: any) {
+    clearTimeout(timeoutId);
+    if (err.name === 'AbortError') {
+      throw new Error(`Registry URL timed out after ${TIMEOUT_MS}ms: ${registryUrl}`);
+    }
+    const cause = err.cause ? `\nCaused by: ${err.cause}` : '';
+    throw new Error(`Can't fetch registryURL: ${registryUrl}${cause}`);
   }
 }