master-manifest.ts

import type {DownloadableOpenAPI, ManifestInfo} from '@opensdks/cli'
import {
  getJson,
  parseDownloadableOasListFromReadmeIo,
  snakeCase,
} from '@opensdks/cli'

export default {
  coda: {
    download: 'https://coda.io/apis/v1/openapi.json',
  },
  dropbox: {
    download:
      // [Dropbox itself](https://www.dropbox.com/developers/documentation/http/documentation) does not provider OpenAPI spec, but there is a community one
      // https://gist.github.com/levibostian/86248f2dfdb7601ec378bb77b0d45e34#file-foo-yaml
      'https://gist.githubusercontent.com/levibostian/86248f2dfdb7601ec378bb77b0d45e34/raw/142e78a76b2d0193e99f9b388ca83c23d154d45d/foo.yaml',
  },
  google: {
    download: async () => {
      // TODO: This doesn't work yet as data is not in OpenAPI format...
      // @see https://github.com/stackql/google-discovery-to-openapi?tab=readme-ov-file
      // So for now we are gonna just use apis.guru instead
      const guru = true
      if (guru) {
        return [
          {
            name: 'google_drive_v3',
            url: 'https://api.apis.guru/v2/specs/googleapis.com/drive/v3/openapi.json',
          },
          {
            name: 'google_drive_v2',
            url: 'https://api.apis.guru/v2/specs/googleapis.com/drive/v2/openapi.json',
          },
          {
            name: 'google_sheets_v4',
            url: 'https://api.apis.guru/v2/specs/googleapis.com/sheets/v4/openapi.json',
          },
          {
            name: 'google_calendar_v3',
            url: 'https://api.apis.guru/v2/specs/googleapis.com/calendar/v3/openapi.json',
          },
          {
            name: 'google_gmail_v1',
            url: 'https://api.apis.guru/v2/specs/googleapis.com/gmail/v1/openapi.json',
          },
        ]
      }
      return getJson<{
        kind: string
        discoveryVersion: string
        items: Array<{
          kind: string
          id: string
          name: string
          version: string
          title: string
          description: string
          discoveryRestUrl: string
          icons: {
            x16: string
            x32: string
          }
          documentationLink?: string
          preferred: boolean
          discoveryLink?: string
        }>
      }>('https://www.googleapis.com/discovery/v1/apis/').then((data) =>
        data.items
          // Only include a couple popular ones for now to limit the scope
          .filter(
            (item) =>
              item.name.startsWith('drive') ||
              item.name.includes('calendar') ||
              item.name.includes('gmail') ||
              item.name.includes('youtube') ||
              item.name.includes('indexing'),
          )
          .map(
            (item): DownloadableOpenAPI => ({
              name: snakeCase(item.id),
              url: item.discoveryRestUrl,
            }),
          ),
      )
    },
  },
  vercel: {
    download: 'https://openapi.vercel.sh/',
  },
  onebrick: {
    download: () =>
      parseDownloadableOasListFromReadmeIo('https://docs.onebrick.io/', {
        name: 'onebrick',
      }),
  },
  notion: {
    download: () =>
      parseDownloadableOasListFromReadmeIo('https://developers.notion.com/', {
        name: 'notion',
      }),
  },
  mercury: {
    download: () =>
      parseDownloadableOasListFromReadmeIo('https://docs.mercury.com/', {
        name: 'mercury',
      }).then((items) =>
        items.map((item) => ({
          ...item,
          name: item.name
            .replace('mercury_api_', '')
            .replace('o_auth2', 'oauth2'),
        })),
      ),
  },
  yodlee: {
    download:
      'https://raw.githubusercontent.com/Yodlee/OpenAPI/main/swagger.yaml',
    headersTemplate: `
      {
        authorization?: \`Bearer \${string}\`
        'x-account-token'?: string
        'api-version'?: '1.1'
        [k: string]: string | undefined
      }
      `,
  },
  clerk: {
    // eslint-disable-next-line arrow-body-style, @typescript-eslint/require-await
    download: async () => {
      return [
        {
          name: 'clerk_backend',
          url: 'https://raw.githubusercontent.com/clerk/openapi-specs/refs/heads/main/bapi/2024-10-01.yml',
        },
        {
          name: 'clerk_frontend',
          url: 'https://raw.githubusercontent.com/clerk/openapi-specs/refs/heads/main/fapi/2024-10-01.yml',
        },
      ]
      // const htmlText = await fetch(
      //   'https://clerk.com/docs/reference/backend-api',
      // ).then((r) => r.text())
      // // Some crazy redoc stuff. Seriously can they make this any harder...
      // const jsPath = htmlText.match(/"([a-zA-Z0-9\/-]+redocly-state.+?)"/)?.[1]
      // if (!jsPath) {
      //   throw new Error('Error finding openapi spec for Clerk')
      // }
      // const jsUrl = `https://clerk.com${jsPath}`
      // const jsText = await fetch(jsUrl).then((r) => r.text())
      // const jsonText = jsText.match(/JSON.parse\((["'].+["'])\);?/)?.[1]
      // try {
      //   // Doubly nested json... crazy stuff
      //   // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-non-null-assertion, @typescript-eslint/no-unsafe-argument
      //   const jsonState = JSON.parse(JSON.parse(jsonText!))
      //   // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access
      //   const oas = jsonState.definition.data
      //   // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
      //   if (!oas.openapi) {
      //     throw new Error('Missing openapi field in Clerk OpenAPI spec')
      //   }
      //   return [
      //     {name: 'clerk', type: 'raw', data: JSON.stringify(oas, null, 2)},
      //   ]
      // } catch (err) {
      //   throw err
      // }
    },
  },
  chargepoint: {
    download: () =>
      import('./manifests/chargepoint.oas.js').then(
        ({naOas: na, ssoOas: sso}) => [
          // a bit annoying names has to be fully formed like this...
          {
            name: 'chargepoint_na',
            type: 'raw',
            data: JSON.stringify(na, null, 2),
          },
          {
            name: 'chargepoint_sso',
            type: 'raw',
            data: JSON.stringify(sso, null, 2),
          },
        ],
      ),
  },
  msgraph: {
    download:
      'https://raw.githubusercontent.com/microsoftgraph/msgraph-sdk-powershell/refs/heads/dev/openApiDocs/v1.0/Files.yml',
  },
} satisfies Record<string, ManifestInfo>