// Prisma 客户端 TypeScript 生成器
generator mygen {
  provider = "prisma-client-js"
}

// Prisma 客户端 文档生成器
generator gen {
  provider = "node node_modules/prisma-docs-generator"
}

// 官方 Prisma 客户端 Go 生成器
generator db {
  provider = "go run github.com/prisma/prisma-client-go"
}

{"jsonrpc":"2.0","method":"getManifest","params":{},"id":1}\n

{"jsonrpc":"2.0","method":"getManifest","params":{...},"id":1}\n

{"jsonrpc":"2.0","result":{"manifest":{...}},"id":1}\n

/**
 * `GeneratorConfig` 是解析 `generator` 块的AST
 * 在数据模型中，由用户提供
**/
export interface GeneratorConfig {
  name: string // 生成器的名称, 例如. "mygen"
  output: string | null // 自定义输出路径
  isCustomOutput?: boolean
  provider: string // 提供商, 例如. "prisma-client-js"
  config: Dictionary<string> // 块中定义的所有其他字段都放在这里
  binaryTargets: string[] // 自定义二进制目标
  previewFeatures: string[] // 预览功能列表
}

export type EngineType =
  | 'queryEngine'
  | 'libqueryEngineNapi'
  | 'migrationEngine'
  | 'introspectionEngine'
  | 'prismaFmt'

/**
 * `GeneratorManifest` 是 当生成器被SDK请求时给的回复。
 * 它指定生成器的名称和或许有的需求。
 * 所有东西都在它的可选项中，尽管我们推荐至少提供`prettyName`，正如每个 `prisma generate` 命令展示的那样
**/
export type GeneratorManifest = {
  // Name printed in `prisma generate`
  prettyName?: string

  // 如果没有提供输出时，应该输出到哪里？（默认输出地址）
  defaultOutput?: string

  // 是否有需要禁用的模型或字段名
  denylists?: {
    models?: string[]
    fields?: string[]
  }

  // 一些生成器依赖`prisma-client-js`先生成一次
  requiresGenerators?: string[]

  // 这些生成器依赖特定的引擎，例如 "queryEngine（查询引擎）"? 
  requiresEngines?: EngineType[]

  // What's the version of this generator?
  // 生成器的版本？
  version?: string

  // 如果生成器需要特定引擎，引擎版本是哪个？
  requiresEngineVersion?: string
}

/**
 * 在每个 `generate` 命令，有一些参数要传给生成器
**/
export type GeneratorOptions = {
  // 生成器的 AST 配置，见上文
  generator: GeneratorConfig

  // 其他生成器的AST 配置
  otherGenerators: GeneratorConfig[]

  // `schema.prisma`  文件的位置
  schemaPath: string

  // 数据模型元格式(the Datamodel Meta Format (DMMF))的AS
  // 这个包含生成的 API Schema，以及解析的数据模型
  dmmf: DMMF.Document

  // 在数据模型中定义的数据源列表
  datasources: DataSource[]

  // 字符串格式的数据模型
  datamodel: string

  // 如果在自述中`requiresEngines`属性需要某些引擎，引擎的二进制在这里
  binaryPaths?: BinaryPaths

  // 二进制文件的版本
  version: string 
}

import { getGenerators } from '@prisma/sdk'

const generators = await getGenerators({ schemaPath: './prisma/schema.prisma' })

for (const generator of generators) {
  console.log(`Generating ${generator.manifest.prettyName}`)
  await generator.generate()
}

import Debug from '@prisma/debug'
import { enginesVersion } from '@prisma/engines-version'
// 引入帮助库
import { generatorHandler } from '@prisma/generator-helper'
import { generateClient } from './generation/generateClient'
import { getDMMF } from './generation/getDMMF'
import { externalToInternalDmmf } from './runtime/externalToInternalDmmf'
const debug = Debug('prisma:client:generator')

const pkg = require('../package.json')
const clientVersion = pkg.version

// 在回调中写具体的逻辑
generatorHandler({
// 回复自述调用
  onManifest(config) {
    const requiredEngine =
      config?.previewFeatures?.includes('napi') ||
      process.env.PRISMA_FORCE_NAPI === 'true'
        ? 'libqueryEngineNapi'
        : 'queryEngine'
    debug(`requiredEngine: ${requiredEngine}`)
    return {
      defaultOutput: '@prisma/client',
      prettyName: 'Prisma Client',
      requiresEngines: [requiredEngine],
      version: clientVersion,
      requiresEngineVersion: enginesVersion,
    }
  },
  // 调用生成时的逻辑
  async onGenerate(options) {
    return generateClient({
      datamodel: options.datamodel,
      datamodelPath: options.schemaPath,
      binaryPaths: options.binaryPaths!,
      datasources: options.datasources,
      outputDir: options.generator.output!,
      copyRuntime: Boolean(options.generator.config.copyRuntime),
      dmmf: options.dmmf,
      generator: options.generator,
      engineVersion: options.version,
      clientVersion,
      transpile: true,
      activeProvider: options.datasources[0]?.activeProvider,
    })
  },
})

export { getDMMF, externalToInternalDmmf }