Merge pull request #1 from octogonz/octogonz/better-ts-file-error

Provide a way to suppress the error

Author: zelliott

apps/api-extractor/src/api/ExtractorMessageId.ts

@@ -95,7 +95,13 @@ export const enum ExtractorMessageId {
   /**
    * "The property ___ has a setter but no getter."
    */
-  MissingGetter = 'ae-missing-getter'
+  MissingGetter = 'ae-missing-getter',
+
+  /**
+   * "Incorrect file type; API Extractor expects to analyze compiler outputs with the .d.ts file extension.
+   * Troubleshooting tips: `https://api-extractor.com/link/dts-error`"
+   */
+  NotDtsFileExtension = 'ae-wrong-input-file-type'
 }
 
 export const allExtractorMessageIds: Set<string> = new Set<string>([
@@ -114,5 +120,6 @@ export const allExtractorMessageIds: Set<string> = new Set<string>([
   'ae-cyclic-inherit-doc',
   'ae-unresolved-link',
   'ae-setter-with-docs',
-  'ae-missing-getter'
+  'ae-missing-getter',
+  'ae-wrong-input-file-type'
 ]);

apps/api-extractor/src/collector/Collector.ts

@@ -206,14 +206,17 @@ export class Collector {
 
     // We can throw this error earlier in CompilerState.ts, but intentionally wait until after we've logged the
     // associated diagnostic message above to make debugging easier for developers.
-    const badSourceFile: boolean = sourceFiles.some(
+    // Typically there will be many such files -- to avoid too much noise, only report the first one.
+    const badSourceFile: ts.SourceFile | undefined = sourceFiles.find(
       ({ fileName }) => !ExtractorConfig.hasDtsFileExtension(fileName)
     );
     if (badSourceFile) {
-      throw new Error(
-        'API Extractor expects to only process .d.ts files, but encountered non-.d.ts file(s).\n' +
-          'Run with the "--diagnostics" flag and inspect the "Files analyzed by compiler" to find the unexpected ' +
-          'file(s).'
+      this.messageRouter.addAnalyzerIssueForPosition(
+        ExtractorMessageId.NotDtsFileExtension,
+        'Incorrect file type; API Extractor expects to analyze compiler outputs with the .d.ts file extension. ' +
+          'Troubleshooting tips: https://api-extractor.com/link/dts-error',
+        badSourceFile,
+        0
       );
     }
 

apps/api-extractor/src/schemas/api-extractor-defaults.json

@@ -71,6 +71,9 @@
       "ae-unresolved-inheritdoc-base": {
         "logLevel": "warning",
         "addToApiReportFile": true
+      },
+      "ae-wrong-input-file-type": {
+        "logLevel": "error"
       }
     },
     "tsdocMessageReporting": {

common/reviews/api/api-extractor.api.md

@@ -135,6 +135,7 @@ export const enum ExtractorMessageId {
     MisplacedPackageTag = "ae-misplaced-package-tag",
     MissingGetter = "ae-missing-getter",
     MissingReleaseTag = "ae-missing-release-tag",
+    NotDtsFileExtension = "ae-wrong-input-file-type",
     PreapprovedBadReleaseTag = "ae-preapproved-bad-release-tag",
     PreapprovedUnsupportedType = "ae-preapproved-unsupported-type",
     SetterWithDocs = "ae-setter-with-docs",
@@ -265,5 +266,4 @@ export interface IExtractorMessagesConfig {
     tsdocMessageReporting?: IConfigMessageReportingTable;
 }
 
-
 ```