@mintlify/scraping 4.0.907 → 4.0.909

package/src/sdk/generateSdkReference.ts

@@ -0,0 +1,25 @@
+import { convertDocfx } from './converters/docfx.js';
+import { convertJavadoc } from './converters/javadoc.js';
+import { convertPhpdoc } from './converters/phpdoc.js';
+import { convertSphinx } from './converters/sphinx.js';
+import { convertTypedoc } from './converters/typedoc.js';
+import type { SdkConverter, SdkFormat, SdkReference } from './types.js';
+
+const converters: Record<SdkFormat, SdkConverter> = {
+  typedoc: convertTypedoc,
+  docfx: convertDocfx,
+  javadoc: convertJavadoc,
+  sphinx: convertSphinx,
+  phpdoc: convertPhpdoc,
+};
+
+export async function generateSdkReference(
+  format: SdkFormat,
+  sourcePath: string
+): Promise<SdkReference> {
+  const converter = converters[format];
+  if (!converter) {
+    throw new Error(`Unsupported SDK documentation format: ${format}`);
+  }
+  return converter(sourcePath);
+}

package/src/sdk/types.ts

@@ -0,0 +1,24 @@
+import type { SdkFormat } from '@mintlify/validation';
+
+export type { SdkFormat };
+
+export type SdkPage = {
+  slug: string;
+  title: string;
+  description?: string;
+  tag?: string;
+  icon?: string;
+  content: string;
+};
+
+export type SdkNavGroup = {
+  group: string;
+  pages: string[];
+};
+
+export type SdkReference = {
+  pages: SdkPage[];
+  groups: SdkNavGroup[];
+};
+
+export type SdkConverter = (sourcePath: string) => Promise<SdkReference>;