supabase__supabase/apps/docs/internals/markdown-schema/SharedData.ts

import { createRequire } from 'node:module'

import { getLogFieldReference, resolveSharedDataPath } from '../../components/SharedData.utils'

// tsx's ESM loader can't pick up named exports from the `shared-data` package
// (CJS, no `"type": "module"`). Load via `createRequire` to use CJS interop —
// this file only runs in the build script, never in the Next.js bundle.
const { config, logConstants } = createRequire(import.meta.url)('shared-data')

const sharedData: Record<string, unknown> = { config, logConstants }

const renderLogConstants = (data: typeof logConstants): string =>
  getLogFieldReference(data.schemas)
    .map((schema) =>
      [
        `### ${schema.name}`,
        '',
        `Source: \`${schema.reference}\``,
        '',
        '| Schema path | ClickHouse query field | Source type | Query value type |',
        '| --- | --- | --- | --- |',
        ...schema.fields.map(
          (field) =>
            `| \`${field.path}\` | \`${field.queryField}\` | \`${field.type}\` | \`${field.queryType}\` |`
        ),
      ].join('\n')
    )
    .join('\n\n')

export const SharedData = ({
  props,
  children,
}: {
  props: Record<string, unknown>
  children: string
}): string => {
  const dataset = sharedData[String(props.data ?? '')]
  if (!dataset) return children

  // String-path pattern: `<SharedData data="config">a.b.c</SharedData>`.
  const value = resolveSharedDataPath(dataset, children.trim())
  if (value != null) return String(value)

  // Render-function pattern: `<SharedData data="logConstants">{(d) => …}`.
  // The schema walker strips the MDX expression children before this handler
  // runs, and we can't evaluate the function statically anyway — hardcode the
  // markdown for the only dataset that uses this form today.
  if (props.data === 'logConstants') return renderLogConstants(dataset as typeof logConstants)
  return ''
}