Method #errorResponse

packages/openapi/src/openapi-generator.ts:547–607

(
    ref: OpenAPI.OperationObject,
    def: AnyContractProcedure['~orpc'],
    baseSchemaConvertOptions: Pick<SchemaConvertOptions, 'components'>,
    undefinedErrorSchema: JSONSchema,
    customErrorResponseBodySchema: OpenAPIGeneratorGenerateOptions['customErrorResponseBodySchema'],
  )

  }

  async #errorResponse(
    ref: OpenAPI.OperationObject,
    def: AnyContractProcedure['~orpc'],
    baseSchemaConvertOptions: Pick<SchemaConvertOptions, 'components'>,
    undefinedErrorSchema: JSONSchema,
    customErrorResponseBodySchema: OpenAPIGeneratorGenerateOptions['customErrorResponseBodySchema'],
  ): Promise<void> {
    const errorMap = def.errorMap as ErrorMap

    const errorResponsesByStatus: Record<string, {
      status: number
      errorSchemaVariants: JSONSchema[]
      definedErrorDefinitions: [code: string, defaultMessage: string, required: boolean, schema: JSONSchema][]
    }> = {}

    for (const code in errorMap) {
      const config = errorMap[code]

      if (!config) {
        continue
      }

      const status = fallbackORPCErrorStatus(code, config.status)
      const defaultMessage = fallbackORPCErrorMessage(code, config.message)

      errorResponsesByStatus[status] ??= { status, definedErrorDefinitions: [], errorSchemaVariants: [] }

      const [dataRequired, dataSchema] = await this.converter.convert(config.data, { ...baseSchemaConvertOptions, strategy: 'output' })

      errorResponsesByStatus[status].definedErrorDefinitions.push([code, defaultMessage, dataRequired, dataSchema])
      errorResponsesByStatus[status].errorSchemaVariants.push({
        type: 'object',
        properties: {
          defined: { const: true },
          code: { const: code },
          status: { const: status },
          message: { type: 'string', default: defaultMessage },
          data: dataSchema,
        },
        required: dataRequired ? ['defined', 'code', 'status', 'message', 'data'] : ['defined', 'code', 'status', 'message'],
      })
    }

    ref.responses ??= {}

    for (const statusString in errorResponsesByStatus) {
      const errorResponse = errorResponsesByStatus[statusString]!

      const customBodySchema = value(customErrorResponseBodySchema, errorResponse.definedErrorDefinitions, errorResponse.status)

      ref.responses[statusString] = {
        description: statusString,
        content: toOpenAPIContent(customBodySchema ?? {
          oneOf: [
            ...errorResponse.errorSchemaVariants,
            undefinedErrorSchema,
          ],
        }),