fix: resolve external ref files relative to spec file location

.changeset/fix-external-ref-resolution.md

@@ -0,0 +1,9 @@
+---
+"@asyncapi/cli": patch
+---
+
+fix: resolve external $ref files relative to spec file location
+
+When the CLI was refactored to use GeneratorService, the `path` option passed to `generator.generateFromString()` was accidentally changed from a string file path to a Specification object. This caused relative `$ref` paths to be resolved against CWD instead of the spec file's directory.
+
+This fix passes `asyncapi.getSource()` (which returns the file path string or URL) instead of the Specification object, restoring the correct behavior for resolving external file references.

src/domains/services/generator.service.ts

@@ -17,7 +17,7 @@ import { getErrorMessage } from '@utils/error-handler';
  * Options passed to the generator for code generation.
  */
 interface GeneratorRunOptions {
-  path?: Specification;
+  path?: string;
   [key: string]: unknown;
 }
 
@@ -109,7 +109,7 @@ export class GeneratorService extends BaseService {
     try {
       await generator.generateFromString(asyncapi.text(), {
         ...genOption,
-        path: asyncapi,
+        path: asyncapi.getSource(),
       });
     } catch (err: unknown) {
       s.stop('Generation failed');