Generator API

import { generateFiles } from 'fumadocs-openapi';

await generateFiles({
  input: server,
  output: './content/docs',
  per: 'operation',
  groupBy: 'tag',
});

import { generateFilesOnly } from 'fumadocs-openapi';

const files = await generateFilesOnly({
  input: server,
  per: 'operation',
});

// files: OutputFile[]
// { path: string, content: string }[]

import { fromSchema } from 'fumadocs-openapi/utils/pages/builder';
import { createAutoPreset } from 'fumadocs-openapi/utils/pages/preset-auto';

const entries = fromSchema(
  'schema-id',
  processedDocument,
  createAutoPreset({ per: 'operation' })
);

import { createAutoPreset } from 'fumadocs-openapi/utils/pages/preset-auto';

const preset = createAutoPreset({
  per: 'operation',
  groupBy: 'tag',
  slugify: (name) => name.toLowerCase(),
});

interface IndexConfig {
  items: IndexItem[] | ((ctx: BeforeWriteContext) => IndexItem[]);
  url:
    | ((filePath: string) => string)
    | {
        baseUrl: string;
        contentDir: string;
      };
}

interface IndexItem {
  path: string;
  title?: string;
  description?: string;
  only?: string[];
}

interface OperationOutput {
  type: 'operation';
  path: string;
  schemaId: string;
  item: OperationItem;
  info: {
    title: string;
    description?: string;
  };
}

interface WebhookOutput {
  type: 'webhook';
  path: string;
  schemaId: string;
  item: WebhookItem;
  info: {
    title: string;
    description?: string;
  };
}

interface TagOutput {
  type: 'tag';
  path: string;
  schemaId: string;
  tag: string;
  rawTag: TagObject;
  operations: OperationItem[];
  webhooks: WebhookItem[];
  info: {
    title: string;
    description?: string;
  };
}

interface OutputGroup {
  type: 'group';
  path: string;
  schemaId: string;
  operations: OperationItem[];
  webhooks: WebhookItem[];
  info: {
    title: string;
    description?: string;
  };
}

import { generateFiles } from 'fumadocs-openapi';
import { createOpenAPI } from 'fumadocs-openapi/server';

const server = createOpenAPI({
  input: ['./openapi.yaml'],
});

await generateFiles({
  input: server,
  output: './content/docs/api',
  per: 'operation',
  groupBy: 'tag',
  name: {
    algorithm: 'v2',
  },
  index: {
    items: [
      {
        path: 'index',
        title: 'API Reference',
        description: 'REST API endpoints',
      },
    ],
    url: {
      baseUrl: '/docs',
      contentDir: './content/docs',
    },
  },
  beforeWrite(files) {
    console.log(`Generated ${files.length} files`);
  },
});

await generateFiles({
  input: server,
  output: './content/docs',
  per: 'operation',
  name(output, document) {
    if (output.type === 'operation') {
      const operation = document.paths![output.item.path]![output.item.method]!;
      return operation.operationId || `${output.item.method}-${output.item.path}`;
    }
    return 'default';
  },
});

await generateFiles({
  input: server,
  output: './content/docs',
  per: 'operation',
  groupBy: (entry) => {
    // Group by API version from path
    if (entry.type === 'operation') {
      const match = entry.item.path.match(/^\/v(\d+)/);
      return match ? `v${match[1]}` : 'general';
    }
    return 'general';
  },
});