docs: rewrite api-docs generation using ts-morph (#2628)

1 files changed, 40 insertions, 0 deletions

diff --git a/scripts/apidocs/processing/error.ts b/scripts/apidocs/processing/error.ts
new file mode 100644
index 00000000..f171d6b4
--- /dev/null
+++ b/scripts/apidocs/processing/error.ts
@@ -0,0 +1,40 @@
+import { FakerError } from '../../../src/errors/faker-error';
+import type { SourceableNode } from './source';
+import { getSourcePath } from './source';
+
+export class FakerApiDocsProcessingError extends FakerError {
+  constructor(options: {
+    type: string;
+    name: string;
+    source: string | SourceableNode;
+    cause: unknown;
+  }) {
+    const { type, name, source, cause } = options;
+    const sourceText =
+      typeof source === 'string' ? source : getSourcePathText(source);
+    const causeText = cause instanceof Error ? cause.message : '';
+    super(`Failed to process ${type} ${name} at ${sourceText} : ${causeText}`, {
+      cause,
+    });
+  }
+}
+
+export function newProcessingError(options: {
+  type: string;
+  name: string;
+  source: string | SourceableNode;
+  cause: unknown;
+}): FakerApiDocsProcessingError {
+  const { cause } = options;
+
+  if (cause instanceof FakerApiDocsProcessingError) {
+    return cause;
+  }
+
+  return new FakerApiDocsProcessingError(options);
+}
+
+function getSourcePathText(source: SourceableNode): string {
+  const { filePath, line, column } = getSourcePath(source);
+  return `${filePath}:${line}:${column}`;
+}