graphql 1.9.18 → 1.13.24

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (353) hide show
  1. checksums.yaml +4 -4
  2. data/lib/generators/graphql/core.rb +21 -10
  3. data/lib/generators/graphql/enum_generator.rb +4 -10
  4. data/lib/generators/graphql/field_extractor.rb +31 -0
  5. data/lib/generators/graphql/input_generator.rb +50 -0
  6. data/lib/generators/graphql/install/mutation_root_generator.rb +34 -0
  7. data/lib/generators/graphql/{templates → install/templates}/base_mutation.erb +2 -0
  8. data/lib/generators/graphql/{templates → install/templates}/mutation_type.erb +2 -0
  9. data/lib/generators/graphql/install_generator.rb +44 -7
  10. data/lib/generators/graphql/interface_generator.rb +7 -7
  11. data/lib/generators/graphql/loader_generator.rb +1 -0
  12. data/lib/generators/graphql/mutation_create_generator.rb +22 -0
  13. data/lib/generators/graphql/mutation_delete_generator.rb +22 -0
  14. data/lib/generators/graphql/mutation_generator.rb +6 -30
  15. data/lib/generators/graphql/mutation_update_generator.rb +22 -0
  16. data/lib/generators/graphql/object_generator.rb +28 -12
  17. data/lib/generators/graphql/orm_mutations_base.rb +40 -0
  18. data/lib/generators/graphql/relay.rb +63 -0
  19. data/lib/generators/graphql/relay_generator.rb +21 -0
  20. data/lib/generators/graphql/scalar_generator.rb +4 -2
  21. data/lib/generators/graphql/templates/base_argument.erb +2 -0
  22. data/lib/generators/graphql/templates/base_connection.erb +8 -0
  23. data/lib/generators/graphql/templates/base_edge.erb +8 -0
  24. data/lib/generators/graphql/templates/base_enum.erb +2 -0
  25. data/lib/generators/graphql/templates/base_field.erb +2 -0
  26. data/lib/generators/graphql/templates/base_input_object.erb +2 -0
  27. data/lib/generators/graphql/templates/base_interface.erb +2 -0
  28. data/lib/generators/graphql/templates/base_object.erb +2 -0
  29. data/lib/generators/graphql/templates/base_scalar.erb +2 -0
  30. data/lib/generators/graphql/templates/base_union.erb +2 -0
  31. data/lib/generators/graphql/templates/enum.erb +7 -1
  32. data/lib/generators/graphql/templates/graphql_controller.erb +16 -12
  33. data/lib/generators/graphql/templates/input.erb +9 -0
  34. data/lib/generators/graphql/templates/interface.erb +6 -2
  35. data/lib/generators/graphql/templates/loader.erb +2 -0
  36. data/lib/generators/graphql/templates/mutation.erb +3 -1
  37. data/lib/generators/graphql/templates/mutation_create.erb +20 -0
  38. data/lib/generators/graphql/templates/mutation_delete.erb +20 -0
  39. data/lib/generators/graphql/templates/mutation_update.erb +21 -0
  40. data/lib/generators/graphql/templates/node_type.erb +9 -0
  41. data/lib/generators/graphql/templates/object.erb +7 -3
  42. data/lib/generators/graphql/templates/query_type.erb +3 -3
  43. data/lib/generators/graphql/templates/scalar.erb +5 -1
  44. data/lib/generators/graphql/templates/schema.erb +22 -27
  45. data/lib/generators/graphql/templates/union.erb +6 -2
  46. data/lib/generators/graphql/type_generator.rb +47 -10
  47. data/lib/generators/graphql/union_generator.rb +5 -5
  48. data/lib/graphql/analysis/analyze_query.rb +7 -0
  49. data/lib/graphql/analysis/ast/field_usage.rb +29 -2
  50. data/lib/graphql/analysis/ast/query_complexity.rb +174 -67
  51. data/lib/graphql/analysis/ast/visitor.rb +16 -7
  52. data/lib/graphql/analysis/ast.rb +21 -11
  53. data/lib/graphql/argument.rb +8 -36
  54. data/lib/graphql/backtrace/inspect_result.rb +0 -1
  55. data/lib/graphql/backtrace/legacy_tracer.rb +56 -0
  56. data/lib/graphql/backtrace/table.rb +44 -5
  57. data/lib/graphql/backtrace/traced_error.rb +0 -1
  58. data/lib/graphql/backtrace/tracer.rb +40 -9
  59. data/lib/graphql/backtrace.rb +28 -19
  60. data/lib/graphql/backwards_compatibility.rb +2 -1
  61. data/lib/graphql/base_type.rb +10 -4
  62. data/lib/graphql/boolean_type.rb +1 -1
  63. data/lib/graphql/compatibility/execution_specification/specification_schema.rb +2 -2
  64. data/lib/graphql/compatibility/execution_specification.rb +1 -0
  65. data/lib/graphql/compatibility/lazy_execution_specification.rb +2 -0
  66. data/lib/graphql/compatibility/query_parser_specification/parse_error_specification.rb +5 -9
  67. data/lib/graphql/compatibility/query_parser_specification.rb +2 -0
  68. data/lib/graphql/compatibility/schema_parser_specification.rb +2 -0
  69. data/lib/graphql/dataloader/null_dataloader.rb +22 -0
  70. data/lib/graphql/dataloader/request.rb +19 -0
  71. data/lib/graphql/dataloader/request_all.rb +19 -0
  72. data/lib/graphql/dataloader/source.rb +155 -0
  73. data/lib/graphql/dataloader.rb +308 -0
  74. data/lib/graphql/date_encoding_error.rb +16 -0
  75. data/lib/graphql/define/assign_enum_value.rb +1 -1
  76. data/lib/graphql/define/assign_global_id_field.rb +2 -2
  77. data/lib/graphql/define/assign_object_field.rb +1 -1
  78. data/lib/graphql/define/defined_object_proxy.rb +5 -8
  79. data/lib/graphql/define/instance_definable.rb +60 -110
  80. data/lib/graphql/define/type_definer.rb +5 -5
  81. data/lib/graphql/deprecated_dsl.rb +18 -5
  82. data/lib/graphql/deprecation.rb +9 -0
  83. data/lib/graphql/directive/deprecated_directive.rb +1 -12
  84. data/lib/graphql/directive/include_directive.rb +1 -1
  85. data/lib/graphql/directive/skip_directive.rb +1 -1
  86. data/lib/graphql/directive.rb +9 -6
  87. data/lib/graphql/enum_type.rb +14 -74
  88. data/lib/graphql/execution/directive_checks.rb +2 -2
  89. data/lib/graphql/execution/errors.rb +110 -8
  90. data/lib/graphql/execution/execute.rb +8 -1
  91. data/lib/graphql/execution/instrumentation.rb +1 -1
  92. data/lib/graphql/execution/interpreter/argument_value.rb +28 -0
  93. data/lib/graphql/execution/interpreter/arguments.rb +88 -0
  94. data/lib/graphql/execution/interpreter/arguments_cache.rb +105 -0
  95. data/lib/graphql/execution/interpreter/handles_raw_value.rb +18 -0
  96. data/lib/graphql/execution/interpreter/resolve.rb +37 -25
  97. data/lib/graphql/execution/interpreter/runtime.rb +721 -386
  98. data/lib/graphql/execution/interpreter.rb +42 -19
  99. data/lib/graphql/execution/lazy/lazy_method_map.rb +4 -0
  100. data/lib/graphql/execution/lazy.rb +5 -1
  101. data/lib/graphql/execution/lookahead.rb +39 -114
  102. data/lib/graphql/execution/multiplex.rb +50 -25
  103. data/lib/graphql/field.rb +15 -119
  104. data/lib/graphql/filter.rb +1 -1
  105. data/lib/graphql/float_type.rb +1 -1
  106. data/lib/graphql/function.rb +5 -30
  107. data/lib/graphql/id_type.rb +1 -1
  108. data/lib/graphql/input_object_type.rb +9 -25
  109. data/lib/graphql/int_type.rb +1 -1
  110. data/lib/graphql/integer_decoding_error.rb +17 -0
  111. data/lib/graphql/integer_encoding_error.rb +18 -2
  112. data/lib/graphql/interface_type.rb +10 -24
  113. data/lib/graphql/internal_representation/document.rb +2 -2
  114. data/lib/graphql/internal_representation/rewrite.rb +1 -1
  115. data/lib/graphql/internal_representation/scope.rb +2 -2
  116. data/lib/graphql/internal_representation/visit.rb +2 -2
  117. data/lib/graphql/introspection/base_object.rb +2 -5
  118. data/lib/graphql/introspection/directive_location_enum.rb +2 -2
  119. data/lib/graphql/introspection/directive_type.rb +12 -6
  120. data/lib/graphql/introspection/entry_points.rb +9 -9
  121. data/lib/graphql/introspection/enum_value_type.rb +2 -2
  122. data/lib/graphql/introspection/field_type.rb +9 -5
  123. data/lib/graphql/introspection/input_value_type.rb +41 -11
  124. data/lib/graphql/introspection/introspection_query.rb +6 -92
  125. data/lib/graphql/introspection/schema_type.rb +12 -12
  126. data/lib/graphql/introspection/type_type.rb +27 -17
  127. data/lib/graphql/introspection.rb +99 -0
  128. data/lib/graphql/invalid_null_error.rb +18 -0
  129. data/lib/graphql/language/block_string.rb +20 -5
  130. data/lib/graphql/language/cache.rb +37 -0
  131. data/lib/graphql/language/definition_slice.rb +21 -10
  132. data/lib/graphql/language/document_from_schema_definition.rb +116 -63
  133. data/lib/graphql/language/lexer.rb +53 -27
  134. data/lib/graphql/language/lexer.rl +5 -3
  135. data/lib/graphql/language/nodes.rb +67 -93
  136. data/lib/graphql/language/parser.rb +929 -896
  137. data/lib/graphql/language/parser.y +125 -102
  138. data/lib/graphql/language/printer.rb +11 -2
  139. data/lib/graphql/language/sanitized_printer.rb +222 -0
  140. data/lib/graphql/language/token.rb +0 -4
  141. data/lib/graphql/language/visitor.rb +2 -2
  142. data/lib/graphql/language.rb +3 -1
  143. data/lib/graphql/name_validator.rb +2 -7
  144. data/lib/graphql/non_null_type.rb +0 -10
  145. data/lib/graphql/object_type.rb +47 -58
  146. data/lib/graphql/pagination/active_record_relation_connection.rb +85 -0
  147. data/lib/graphql/pagination/array_connection.rb +77 -0
  148. data/lib/graphql/pagination/connection.rb +226 -0
  149. data/lib/graphql/pagination/connections.rb +160 -0
  150. data/lib/graphql/pagination/mongoid_relation_connection.rb +25 -0
  151. data/lib/graphql/pagination/relation_connection.rb +226 -0
  152. data/lib/graphql/pagination/sequel_dataset_connection.rb +28 -0
  153. data/lib/graphql/pagination.rb +6 -0
  154. data/lib/graphql/parse_error.rb +0 -1
  155. data/lib/graphql/query/arguments.rb +6 -4
  156. data/lib/graphql/query/arguments_cache.rb +1 -2
  157. data/lib/graphql/query/context.rb +52 -7
  158. data/lib/graphql/query/executor.rb +0 -1
  159. data/lib/graphql/query/fingerprint.rb +26 -0
  160. data/lib/graphql/query/input_validation_result.rb +32 -6
  161. data/lib/graphql/query/literal_input.rb +31 -11
  162. data/lib/graphql/query/null_context.rb +24 -8
  163. data/lib/graphql/query/serial_execution/field_resolution.rb +1 -1
  164. data/lib/graphql/query/serial_execution.rb +1 -0
  165. data/lib/graphql/query/validation_pipeline.rb +6 -4
  166. data/lib/graphql/query/variable_validation_error.rb +3 -3
  167. data/lib/graphql/query/variables.rb +50 -10
  168. data/lib/graphql/query.rb +77 -18
  169. data/lib/graphql/railtie.rb +9 -1
  170. data/lib/graphql/rake_task/validate.rb +3 -0
  171. data/lib/graphql/rake_task.rb +12 -9
  172. data/lib/graphql/relay/array_connection.rb +10 -12
  173. data/lib/graphql/relay/base_connection.rb +30 -13
  174. data/lib/graphql/relay/connection_instrumentation.rb +4 -4
  175. data/lib/graphql/relay/connection_type.rb +18 -4
  176. data/lib/graphql/relay/edge_type.rb +1 -0
  177. data/lib/graphql/relay/edges_instrumentation.rb +1 -2
  178. data/lib/graphql/relay/global_id_resolve.rb +1 -2
  179. data/lib/graphql/relay/mutation.rb +3 -87
  180. data/lib/graphql/relay/node.rb +3 -0
  181. data/lib/graphql/relay/page_info.rb +1 -1
  182. data/lib/graphql/relay/range_add.rb +27 -9
  183. data/lib/graphql/relay/relation_connection.rb +8 -10
  184. data/lib/graphql/relay/type_extensions.rb +2 -0
  185. data/lib/graphql/rubocop/graphql/base_cop.rb +36 -0
  186. data/lib/graphql/rubocop/graphql/default_null_true.rb +43 -0
  187. data/lib/graphql/rubocop/graphql/default_required_true.rb +43 -0
  188. data/lib/graphql/rubocop.rb +4 -0
  189. data/lib/graphql/scalar_type.rb +18 -60
  190. data/lib/graphql/schema/addition.rb +247 -0
  191. data/lib/graphql/schema/argument.rb +274 -18
  192. data/lib/graphql/schema/base_64_encoder.rb +2 -0
  193. data/lib/graphql/schema/build_from_definition/resolve_map/default_resolve.rb +1 -1
  194. data/lib/graphql/schema/build_from_definition/resolve_map.rb +13 -5
  195. data/lib/graphql/schema/build_from_definition.rb +320 -219
  196. data/lib/graphql/schema/built_in_types.rb +5 -5
  197. data/lib/graphql/schema/default_type_error.rb +2 -0
  198. data/lib/graphql/schema/directive/deprecated.rb +18 -0
  199. data/lib/graphql/schema/directive/feature.rb +1 -1
  200. data/lib/graphql/schema/directive/flagged.rb +57 -0
  201. data/lib/graphql/schema/directive/include.rb +2 -2
  202. data/lib/graphql/schema/directive/skip.rb +2 -2
  203. data/lib/graphql/schema/directive/transform.rb +14 -2
  204. data/lib/graphql/schema/directive.rb +130 -6
  205. data/lib/graphql/schema/enum.rb +121 -12
  206. data/lib/graphql/schema/enum_value.rb +24 -7
  207. data/lib/graphql/schema/field/connection_extension.rb +46 -20
  208. data/lib/graphql/schema/field/scope_extension.rb +1 -1
  209. data/lib/graphql/schema/field.rb +465 -181
  210. data/lib/graphql/schema/field_extension.rb +89 -2
  211. data/lib/graphql/schema/find_inherited_value.rb +17 -1
  212. data/lib/graphql/schema/finder.rb +16 -14
  213. data/lib/graphql/schema/input_object.rb +172 -37
  214. data/lib/graphql/schema/interface.rb +39 -25
  215. data/lib/graphql/schema/introspection_system.rb +106 -38
  216. data/lib/graphql/schema/late_bound_type.rb +3 -2
  217. data/lib/graphql/schema/list.rb +65 -1
  218. data/lib/graphql/schema/loader.rb +145 -102
  219. data/lib/graphql/schema/member/accepts_definition.rb +15 -3
  220. data/lib/graphql/schema/member/base_dsl_methods.rb +34 -28
  221. data/lib/graphql/schema/member/build_type.rb +19 -8
  222. data/lib/graphql/schema/member/cached_graphql_definition.rb +34 -2
  223. data/lib/graphql/schema/member/has_arguments.rb +206 -13
  224. data/lib/graphql/schema/member/has_ast_node.rb +20 -0
  225. data/lib/graphql/schema/member/has_deprecation_reason.rb +25 -0
  226. data/lib/graphql/schema/member/has_directives.rb +98 -0
  227. data/lib/graphql/schema/member/has_fields.rb +97 -32
  228. data/lib/graphql/schema/member/has_interfaces.rb +100 -0
  229. data/lib/graphql/schema/member/has_unresolved_type_error.rb +15 -0
  230. data/lib/graphql/schema/member/has_validators.rb +31 -0
  231. data/lib/graphql/schema/member/instrumentation.rb +0 -1
  232. data/lib/graphql/schema/member/type_system_helpers.rb +3 -3
  233. data/lib/graphql/schema/member/validates_input.rb +33 -0
  234. data/lib/graphql/schema/member.rb +11 -0
  235. data/lib/graphql/schema/middleware_chain.rb +1 -1
  236. data/lib/graphql/schema/mutation.rb +4 -0
  237. data/lib/graphql/schema/non_null.rb +37 -1
  238. data/lib/graphql/schema/object.rb +51 -38
  239. data/lib/graphql/schema/possible_types.rb +9 -4
  240. data/lib/graphql/schema/printer.rb +16 -35
  241. data/lib/graphql/schema/relay_classic_mutation.rb +40 -4
  242. data/lib/graphql/schema/resolver/has_payload_type.rb +34 -4
  243. data/lib/graphql/schema/resolver.rb +133 -79
  244. data/lib/graphql/schema/scalar.rb +43 -3
  245. data/lib/graphql/schema/subscription.rb +57 -21
  246. data/lib/graphql/schema/timeout.rb +29 -15
  247. data/lib/graphql/schema/timeout_middleware.rb +3 -1
  248. data/lib/graphql/schema/traversal.rb +2 -2
  249. data/lib/graphql/schema/type_expression.rb +21 -13
  250. data/lib/graphql/schema/type_membership.rb +19 -5
  251. data/lib/graphql/schema/union.rb +44 -3
  252. data/lib/graphql/schema/unique_within_type.rb +1 -2
  253. data/lib/graphql/schema/validation.rb +14 -4
  254. data/lib/graphql/schema/validator/allow_blank_validator.rb +29 -0
  255. data/lib/graphql/schema/validator/allow_null_validator.rb +26 -0
  256. data/lib/graphql/schema/validator/exclusion_validator.rb +33 -0
  257. data/lib/graphql/schema/validator/format_validator.rb +48 -0
  258. data/lib/graphql/schema/validator/inclusion_validator.rb +35 -0
  259. data/lib/graphql/schema/validator/length_validator.rb +59 -0
  260. data/lib/graphql/schema/validator/numericality_validator.rb +82 -0
  261. data/lib/graphql/schema/validator/required_validator.rb +82 -0
  262. data/lib/graphql/schema/validator.rb +171 -0
  263. data/lib/graphql/schema/warden.rb +193 -34
  264. data/lib/graphql/schema.rb +882 -247
  265. data/lib/graphql/static_validation/all_rules.rb +2 -0
  266. data/lib/graphql/static_validation/base_visitor.rb +17 -10
  267. data/lib/graphql/static_validation/definition_dependencies.rb +0 -1
  268. data/lib/graphql/static_validation/error.rb +3 -1
  269. data/lib/graphql/static_validation/literal_validator.rb +51 -26
  270. data/lib/graphql/static_validation/rules/argument_literals_are_compatible.rb +45 -83
  271. data/lib/graphql/static_validation/rules/argument_literals_are_compatible_error.rb +22 -6
  272. data/lib/graphql/static_validation/rules/arguments_are_defined.rb +35 -26
  273. data/lib/graphql/static_validation/rules/arguments_are_defined_error.rb +4 -2
  274. data/lib/graphql/static_validation/rules/directives_are_defined.rb +1 -1
  275. data/lib/graphql/static_validation/rules/directives_are_in_valid_locations.rb +2 -2
  276. data/lib/graphql/static_validation/rules/fields_are_defined_on_type.rb +4 -4
  277. data/lib/graphql/static_validation/rules/fields_have_appropriate_selections.rb +5 -5
  278. data/lib/graphql/static_validation/rules/fields_will_merge.rb +94 -51
  279. data/lib/graphql/static_validation/rules/fields_will_merge_error.rb +25 -4
  280. data/lib/graphql/static_validation/rules/fragment_spreads_are_possible.rb +3 -3
  281. data/lib/graphql/static_validation/rules/fragments_are_finite.rb +2 -2
  282. data/lib/graphql/static_validation/rules/input_object_names_are_unique.rb +30 -0
  283. data/lib/graphql/static_validation/rules/input_object_names_are_unique_error.rb +30 -0
  284. data/lib/graphql/static_validation/rules/query_root_exists.rb +17 -0
  285. data/lib/graphql/static_validation/rules/query_root_exists_error.rb +26 -0
  286. data/lib/graphql/static_validation/rules/required_arguments_are_present.rb +4 -2
  287. data/lib/graphql/static_validation/rules/required_input_object_attributes_are_present.rb +9 -10
  288. data/lib/graphql/static_validation/rules/unique_directives_per_location.rb +1 -1
  289. data/lib/graphql/static_validation/rules/variable_default_values_are_correctly_typed.rb +12 -13
  290. data/lib/graphql/static_validation/rules/variable_usages_are_allowed.rb +19 -14
  291. data/lib/graphql/static_validation/rules/variables_are_input_types.rb +1 -1
  292. data/lib/graphql/static_validation/rules/variables_are_used_and_defined.rb +5 -3
  293. data/lib/graphql/static_validation/type_stack.rb +2 -2
  294. data/lib/graphql/static_validation/validation_context.rb +13 -3
  295. data/lib/graphql/static_validation/validation_timeout_error.rb +25 -0
  296. data/lib/graphql/static_validation/validator.rb +43 -9
  297. data/lib/graphql/static_validation.rb +1 -0
  298. data/lib/graphql/string_encoding_error.rb +13 -3
  299. data/lib/graphql/string_type.rb +1 -1
  300. data/lib/graphql/subscriptions/action_cable_subscriptions.rb +123 -22
  301. data/lib/graphql/subscriptions/broadcast_analyzer.rb +81 -0
  302. data/lib/graphql/subscriptions/default_subscription_resolve_extension.rb +21 -0
  303. data/lib/graphql/subscriptions/event.rb +84 -30
  304. data/lib/graphql/subscriptions/instrumentation.rb +10 -6
  305. data/lib/graphql/subscriptions/serialize.rb +53 -6
  306. data/lib/graphql/subscriptions/subscription_root.rb +15 -5
  307. data/lib/graphql/subscriptions.rb +117 -49
  308. data/lib/graphql/tracing/active_support_notifications_tracing.rb +8 -17
  309. data/lib/graphql/tracing/appoptics_tracing.rb +173 -0
  310. data/lib/graphql/tracing/appsignal_tracing.rb +23 -0
  311. data/lib/graphql/tracing/data_dog_tracing.rb +32 -15
  312. data/lib/graphql/tracing/new_relic_tracing.rb +9 -12
  313. data/lib/graphql/tracing/notifications_tracing.rb +59 -0
  314. data/lib/graphql/tracing/platform_tracing.rb +66 -10
  315. data/lib/graphql/tracing/prometheus_tracing/graphql_collector.rb +4 -1
  316. data/lib/graphql/tracing/prometheus_tracing.rb +8 -0
  317. data/lib/graphql/tracing/scout_tracing.rb +19 -0
  318. data/lib/graphql/tracing/skylight_tracing.rb +9 -1
  319. data/lib/graphql/tracing/statsd_tracing.rb +42 -0
  320. data/lib/graphql/tracing.rb +15 -35
  321. data/lib/graphql/types/big_int.rb +5 -1
  322. data/lib/graphql/types/int.rb +10 -3
  323. data/lib/graphql/types/iso_8601_date.rb +16 -8
  324. data/lib/graphql/types/iso_8601_date_time.rb +32 -10
  325. data/lib/graphql/types/relay/base_connection.rb +6 -88
  326. data/lib/graphql/types/relay/base_edge.rb +2 -34
  327. data/lib/graphql/types/relay/connection_behaviors.rb +174 -0
  328. data/lib/graphql/types/relay/default_relay.rb +31 -0
  329. data/lib/graphql/types/relay/edge_behaviors.rb +64 -0
  330. data/lib/graphql/types/relay/has_node_field.rb +41 -0
  331. data/lib/graphql/types/relay/has_nodes_field.rb +41 -0
  332. data/lib/graphql/types/relay/node.rb +2 -4
  333. data/lib/graphql/types/relay/node_behaviors.rb +15 -0
  334. data/lib/graphql/types/relay/node_field.rb +3 -22
  335. data/lib/graphql/types/relay/nodes_field.rb +16 -18
  336. data/lib/graphql/types/relay/page_info.rb +2 -14
  337. data/lib/graphql/types/relay/page_info_behaviors.rb +25 -0
  338. data/lib/graphql/types/relay.rb +11 -3
  339. data/lib/graphql/types/string.rb +8 -2
  340. data/lib/graphql/unauthorized_error.rb +2 -2
  341. data/lib/graphql/union_type.rb +5 -25
  342. data/lib/graphql/unresolved_type_error.rb +2 -2
  343. data/lib/graphql/upgrader/member.rb +1 -0
  344. data/lib/graphql/upgrader/schema.rb +1 -0
  345. data/lib/graphql/version.rb +1 -1
  346. data/lib/graphql.rb +87 -31
  347. data/readme.md +3 -6
  348. metadata +126 -124
  349. data/lib/graphql/execution/interpreter/hash_response.rb +0 -46
  350. data/lib/graphql/literal_validation_error.rb +0 -6
  351. data/lib/graphql/types/relay/base_field.rb +0 -22
  352. data/lib/graphql/types/relay/base_interface.rb +0 -29
  353. data/lib/graphql/types/relay/base_object.rb +0 -26
@@ -2,47 +2,46 @@
2
2
  module GraphQL
3
3
  class Schema
4
4
  class IntrospectionSystem
5
- attr_reader :schema_type, :type_type, :typename_field
5
+ attr_reader :types, :possible_types
6
6
 
7
7
  def initialize(schema)
8
8
  @schema = schema
9
+ @class_based = !!@schema.is_a?(Class)
9
10
  @built_in_namespace = GraphQL::Introspection
10
- @custom_namespace = schema.introspection_namespace || @built_in_namespace
11
-
12
- # Use to-graphql to avoid sharing with any previous instantiations
13
- @schema_type = load_constant(:SchemaType).to_graphql
14
- @type_type = load_constant(:TypeType).to_graphql
15
- @field_type = load_constant(:FieldType).to_graphql
16
- @directive_type = load_constant(:DirectiveType).to_graphql
17
- @enum_value_type = load_constant(:EnumValueType).to_graphql
18
- @input_value_type = load_constant(:InputValueType).to_graphql
19
- @type_kind_enum = load_constant(:TypeKindEnum).to_graphql
20
- @directive_location_enum = load_constant(:DirectiveLocationEnum).to_graphql
11
+ @custom_namespace = if @class_based
12
+ schema.introspection || @built_in_namespace
13
+ else
14
+ schema.introspection_namespace || @built_in_namespace
15
+ end
16
+
17
+ type_defns = [
18
+ load_constant(:SchemaType),
19
+ load_constant(:TypeType),
20
+ load_constant(:FieldType),
21
+ load_constant(:DirectiveType),
22
+ load_constant(:EnumValueType),
23
+ load_constant(:InputValueType),
24
+ load_constant(:TypeKindEnum),
25
+ load_constant(:DirectiveLocationEnum)
26
+ ]
27
+ @types = {}
28
+ @possible_types = {}
29
+ type_defns.each do |t|
30
+ @types[t.graphql_name] = t
31
+ @possible_types[t.graphql_name] = [t]
32
+ end
21
33
  @entry_point_fields =
22
- if schema.disable_introspection_entry_points
34
+ if schema.disable_introspection_entry_points?
23
35
  {}
24
36
  else
25
37
  entry_point_fields = get_fields_from_class(class_sym: :EntryPoints)
26
- entry_point_fields.delete('__schema') if schema.disable_schema_introspection_entry_point
27
- entry_point_fields.delete('__type') if schema.disable_type_introspection_entry_point
38
+ entry_point_fields.delete('__schema') if schema.disable_schema_introspection_entry_point?
39
+ entry_point_fields.delete('__type') if schema.disable_type_introspection_entry_point?
28
40
  entry_point_fields
29
41
  end
30
42
  @dynamic_fields = get_fields_from_class(class_sym: :DynamicFields)
31
43
  end
32
44
 
33
- def object_types
34
- [
35
- @schema_type,
36
- @type_type,
37
- @field_type,
38
- @directive_type,
39
- @enum_value_type,
40
- @input_value_type,
41
- @type_kind_enum,
42
- @directive_location_enum,
43
- ]
44
- end
45
-
46
45
  def entry_points
47
46
  @entry_point_fields.values
48
47
  end
@@ -59,25 +58,94 @@ module GraphQL
59
58
  @dynamic_fields[name]
60
59
  end
61
60
 
61
+ # The introspection system is prepared with a bunch of LateBoundTypes.
62
+ # Replace those with the objects that they refer to, since LateBoundTypes
63
+ # aren't handled at runtime.
64
+ #
65
+ # @api private
66
+ # @return void
67
+ def resolve_late_bindings
68
+ @types.each do |name, t|
69
+ if t.kind.fields?
70
+ t.fields.each do |_name, field_defn|
71
+ field_defn.type = resolve_late_binding(field_defn.type)
72
+ end
73
+ end
74
+ end
75
+
76
+ @entry_point_fields.each do |name, f|
77
+ f.type = resolve_late_binding(f.type)
78
+ end
79
+
80
+ @dynamic_fields.each do |name, f|
81
+ f.type = resolve_late_binding(f.type)
82
+ end
83
+ nil
84
+ end
85
+
62
86
  private
63
87
 
88
+ def resolve_late_binding(late_bound_type)
89
+ case late_bound_type
90
+ when GraphQL::Schema::LateBoundType
91
+ @schema.get_type(late_bound_type.name)
92
+ when GraphQL::Schema::List, GraphQL::ListType
93
+ resolve_late_binding(late_bound_type.of_type).to_list_type
94
+ when GraphQL::Schema::NonNull, GraphQL::NonNullType
95
+ resolve_late_binding(late_bound_type.of_type).to_non_null_type
96
+ when Module
97
+ # It's a normal type -- no change required
98
+ late_bound_type
99
+ else
100
+ raise "Invariant: unexpected type: #{late_bound_type} (#{late_bound_type.class})"
101
+ end
102
+ end
103
+
64
104
  def load_constant(class_name)
65
- @custom_namespace.const_get(class_name)
105
+ const = @custom_namespace.const_get(class_name)
106
+ if @class_based
107
+ dup_type_class(const)
108
+ else
109
+ # Use `.to_graphql` to get a freshly-made version, not shared between schemas
110
+ const.deprecated_to_graphql
111
+ end
66
112
  rescue NameError
67
113
  # Dup the built-in so that the cached fields aren't shared
68
- @built_in_namespace.const_get(class_name)
114
+ dup_type_class(@built_in_namespace.const_get(class_name))
69
115
  end
70
116
 
71
117
  def get_fields_from_class(class_sym:)
72
- object_class = load_constant(class_sym)
73
- object_type_defn = object_class.to_graphql
74
- extracted_field_defns = {}
75
- object_type_defn.all_fields.each do |field_defn|
76
- inner_resolve = field_defn.resolve_proc
77
- resolve_with_instantiate = PerFieldProxyResolve.new(object_class: object_class, inner_resolve: inner_resolve)
78
- extracted_field_defns[field_defn.name] = field_defn.redefine(resolve: resolve_with_instantiate)
118
+ object_type_defn = load_constant(class_sym)
119
+
120
+ if object_type_defn.is_a?(Module)
121
+ object_type_defn.fields
122
+ else
123
+ extracted_field_defns = {}
124
+ object_class = object_type_defn.metadata[:type_class]
125
+ object_type_defn.all_fields.each do |field_defn|
126
+ inner_resolve = field_defn.resolve_proc
127
+ resolve_with_instantiate = PerFieldProxyResolve.new(object_class: object_class, inner_resolve: inner_resolve)
128
+ extracted_field_defns[field_defn.name] = field_defn.redefine(resolve: resolve_with_instantiate)
129
+ end
130
+ extracted_field_defns
131
+ end
132
+ end
133
+
134
+ # This is probably not 100% robust -- but it has to be good enough to avoid modifying the built-in introspection types
135
+ def dup_type_class(type_class)
136
+ type_name = type_class.graphql_name
137
+ Class.new(type_class) do
138
+ # This won't be inherited like other things will
139
+ graphql_name(type_name)
140
+
141
+ if type_class.kind.fields?
142
+ type_class.fields.each do |_name, field_defn|
143
+ dup_field = field_defn.dup
144
+ dup_field.owner = self
145
+ add_field(dup_field)
146
+ end
147
+ end
79
148
  end
80
- extracted_field_defns
81
149
  end
82
150
 
83
151
  class PerFieldProxyResolve
@@ -6,6 +6,7 @@ module GraphQL
6
6
  # @api Private
7
7
  class LateBoundType
8
8
  attr_reader :name
9
+ alias :graphql_name :name
9
10
  def initialize(local_name)
10
11
  @name = local_name
11
12
  end
@@ -15,11 +16,11 @@ module GraphQL
15
16
  end
16
17
 
17
18
  def to_non_null_type
18
- GraphQL::NonNullType.new(of_type: self)
19
+ @to_non_null_type ||= GraphQL::NonNullType.new(of_type: self)
19
20
  end
20
21
 
21
22
  def to_list_type
22
- GraphQL::ListType.new(of_type: self)
23
+ @to_list_type ||= GraphQL::ListType.new(of_type: self)
23
24
  end
24
25
 
25
26
  def inspect
@@ -6,8 +6,12 @@ module GraphQL
6
6
  # Wraps a {Schema::Member} as a list type.
7
7
  # @see {Schema::Member::TypeSystemHelpers#to_list_type}
8
8
  class List < GraphQL::Schema::Wrapper
9
+ include Schema::Member::ValidatesInput
10
+
11
+ prepend Schema::Member::CachedGraphQLDefinition::DeprecatedToGraphQL
12
+
9
13
  def to_graphql
10
- @of_type.graphql_definition.to_list_type
14
+ @of_type.graphql_definition(silence_deprecation_warning: true).to_list_type
11
15
  end
12
16
 
13
17
  # @return [GraphQL::TypeKinds::LIST]
@@ -23,6 +27,66 @@ module GraphQL
23
27
  def to_type_signature
24
28
  "[#{@of_type.to_type_signature}]"
25
29
  end
30
+
31
+ # This is for introspection, where it's expected the name will be `null`
32
+ def graphql_name
33
+ nil
34
+ end
35
+
36
+ # Also for implementing introspection
37
+ def description
38
+ nil
39
+ end
40
+
41
+ def coerce_result(value, ctx)
42
+ value.map { |i| i.nil? ? nil : of_type.coerce_result(i, ctx) }
43
+ end
44
+
45
+ def coerce_input(value, ctx)
46
+ if value.nil?
47
+ nil
48
+ else
49
+ coerced = ensure_array(value).map { |item| item.nil? ? item : of_type.coerce_input(item, ctx) }
50
+ ctx.schema.after_any_lazies(coerced, &:itself)
51
+ end
52
+ end
53
+
54
+ def validate_non_null_input(value, ctx, max_errors: nil)
55
+ result = GraphQL::Query::InputValidationResult.new
56
+ ensure_array(value).each_with_index do |item, index|
57
+ item_result = of_type.validate_input(item, ctx)
58
+ unless item_result.valid?
59
+ if max_errors
60
+ if max_errors == 0
61
+ add_max_errros_reached_message(result)
62
+ break
63
+ end
64
+
65
+ max_errors -= 1
66
+ end
67
+
68
+ result.merge_result!(index, item_result)
69
+ end
70
+ end
71
+ result.valid? ? nil : result
72
+ end
73
+
74
+ private
75
+
76
+ def ensure_array(value)
77
+ # `Array({ a: 1 })` makes `[[:a, 1]]`, so do it manually
78
+ if value.is_a?(Array)
79
+ value
80
+ else
81
+ [value]
82
+ end
83
+ end
84
+
85
+ def add_max_errros_reached_message(result)
86
+ message = "Too many errors processing list variable, max validation error limit reached. Execution aborted"
87
+ item_result = GraphQL::Query::InputValidationResult.from_problem(message)
88
+ result.merge_result!(nil, item_result)
89
+ end
26
90
  end
27
91
  end
28
92
  end
@@ -5,37 +5,50 @@ module GraphQL
5
5
  # to make a schema. This schema is missing some important details like
6
6
  # `resolve` functions, but it does include the full type system,
7
7
  # so you can use it to validate queries.
8
+ #
9
+ # @see GraphQL::Schema.from_introspection for a public API
8
10
  module Loader
9
11
  extend self
10
12
 
11
13
  # Create schema with the result of an introspection query.
12
14
  # @param introspection_result [Hash] A response from {GraphQL::Introspection::INTROSPECTION_QUERY}
13
- # @return [GraphQL::Schema] the schema described by `input`
14
- # @deprecated Use {GraphQL::Schema.from_introspection} instead
15
+ # @return [Class] the schema described by `input`
15
16
  def load(introspection_result)
16
17
  schema = introspection_result.fetch("data").fetch("__schema")
17
18
 
18
19
  types = {}
19
- type_resolver = ->(type) { -> { resolve_type(types, type) } }
20
+ type_resolver = ->(type) { resolve_type(types, type) }
20
21
 
21
22
  schema.fetch("types").each do |type|
22
23
  next if type.fetch("name").start_with?("__")
23
24
  type_object = define_type(type, type_resolver)
24
- types[type_object.name] = type_object
25
+ types[type["name"]] = type_object
25
26
  end
26
27
 
27
- kargs = { orphan_types: types.values, resolve_type: NullResolveType }
28
- [:query, :mutation, :subscription].each do |root|
29
- type = schema["#{root}Type"]
30
- kargs[root] = types.fetch(type.fetch("name")) if type
28
+ directives = []
29
+ schema.fetch("directives", []).each do |directive|
30
+ next if GraphQL::Schema.default_directives.include?(directive.fetch("name"))
31
+ directives << define_directive(directive, type_resolver)
31
32
  end
32
33
 
33
- Schema.define(**kargs, raise_definition_error: true)
34
- end
34
+ Class.new(GraphQL::Schema) do
35
+ orphan_types(types.values)
36
+ directives(directives)
37
+ description(schema["description"])
38
+
39
+ def self.resolve_type(*)
40
+ raise(GraphQL::RequiredImplementationMissingError, "This schema was loaded from string, so it can't resolve types for objects")
41
+ end
35
42
 
36
- NullResolveType = ->(type, obj, ctx) {
37
- raise(GraphQL::RequiredImplementationMissingError, "This schema was loaded from string, so it can't resolve types for objects")
38
- }
43
+ [:query, :mutation, :subscription].each do |root|
44
+ type = schema["#{root}Type"]
45
+ if type
46
+ type_defn = types.fetch(type.fetch("name"))
47
+ self.public_send(root, type_defn)
48
+ end
49
+ end
50
+ end
51
+ end
39
52
 
40
53
  NullScalarCoerce = ->(val, _ctx) { val }
41
54
 
@@ -45,11 +58,17 @@ module GraphQL
45
58
  def resolve_type(types, type)
46
59
  case kind = type.fetch("kind")
47
60
  when "ENUM", "INTERFACE", "INPUT_OBJECT", "OBJECT", "SCALAR", "UNION"
48
- types.fetch(type.fetch("name"))
61
+ type_name = type.fetch("name")
62
+ type = types[type_name] || Schema::BUILT_IN_TYPES[type_name]
63
+ if type.nil?
64
+ GraphQL::Schema::LateBoundType.new(type_name)
65
+ else
66
+ type
67
+ end
49
68
  when "LIST"
50
- ListType.new(of_type: resolve_type(types, type.fetch("ofType")))
69
+ Schema::List.new(resolve_type(types, type.fetch("ofType")))
51
70
  when "NON_NULL"
52
- NonNullType.new(of_type: resolve_type(types, type.fetch("ofType")))
71
+ Schema::NonNull.new(resolve_type(types, type.fetch("ofType")))
53
72
  else
54
73
  fail GraphQL::RequiredImplementationMissingError, "#{kind} not implemented"
55
74
  end
@@ -77,109 +96,133 @@ module GraphQL
77
96
  end
78
97
 
79
98
  def define_type(type, type_resolver)
99
+ loader = self
80
100
  case type.fetch("kind")
81
101
  when "ENUM"
82
- EnumType.define(
83
- name: type["name"],
84
- description: type["description"],
85
- values: type["enumValues"].map { |enum|
86
- EnumType::EnumValue.define(
87
- name: enum["name"],
88
- description: enum["description"],
89
- deprecation_reason: enum["deprecationReason"],
90
- value: enum["name"]
102
+ Class.new(GraphQL::Schema::Enum) do
103
+ graphql_name(type["name"])
104
+ description(type["description"])
105
+ type["enumValues"].each do |enum_value|
106
+ value(
107
+ enum_value["name"],
108
+ description: enum_value["description"],
109
+ deprecation_reason: enum_value["deprecationReason"],
91
110
  )
92
- })
111
+ end
112
+ end
93
113
  when "INTERFACE"
94
- InterfaceType.define(
95
- name: type["name"],
96
- description: type["description"],
97
- fields: Hash[(type["fields"] || []).map { |field|
98
- [field["name"], define_type(field.merge("kind" => "FIELD"), type_resolver)]
99
- }]
100
- )
114
+ Module.new do
115
+ include GraphQL::Schema::Interface
116
+ graphql_name(type["name"])
117
+ description(type["description"])
118
+ loader.build_fields(self, type["fields"] || [], type_resolver)
119
+ end
101
120
  when "INPUT_OBJECT"
102
- InputObjectType.define(
103
- name: type["name"],
104
- description: type["description"],
105
- arguments: Hash[type["inputFields"].map { |arg|
106
- [arg["name"], define_type(arg.merge("kind" => "ARGUMENT"), type_resolver)]
107
- }]
108
- )
109
- when "OBJECT"
110
- ObjectType.define(
111
- name: type["name"],
112
- description: type["description"],
113
- interfaces: (type["interfaces"] || []).map { |interface|
114
- type_resolver.call(interface)
115
- },
116
- fields: Hash[type["fields"].map { |field|
117
- [field["name"], define_type(field.merge("kind" => "FIELD"), type_resolver)]
118
- }]
119
- )
120
- when "FIELD"
121
- defns = {
122
- name: type["name"],
123
- type: type_resolver.call(type["type"]),
124
- description: type["description"],
125
- }
126
-
127
- # Avoid passing an empty hash, which warns on Ruby 2.7
128
- if type["args"].any?
129
- defns[:arguments] = Hash[type["args"].map { |arg|
130
- [arg["name"], define_type(arg.merge("kind" => "ARGUMENT"), type_resolver)]
131
- }]
121
+ Class.new(GraphQL::Schema::InputObject) do
122
+ graphql_name(type["name"])
123
+ description(type["description"])
124
+ loader.build_arguments(self, type["inputFields"], type_resolver)
132
125
  end
133
-
134
- GraphQL::Field.define(**defns)
135
- when "ARGUMENT"
136
- kwargs = {}
137
- if type["defaultValue"]
138
- kwargs[:default_value] = begin
139
- default_value_str = type["defaultValue"]
140
-
141
- dummy_query_str = "query getStuff($var: InputObj = #{default_value_str}) { __typename }"
142
-
143
- # Returns a `GraphQL::Language::Nodes::Document`:
144
- dummy_query_ast = GraphQL.parse(dummy_query_str)
145
-
146
- # Reach into the AST for the default value:
147
- input_value_ast = dummy_query_ast.definitions.first.variables.first.default_value
148
-
149
- extract_default_value(default_value_str, input_value_ast)
126
+ when "OBJECT"
127
+ Class.new(GraphQL::Schema::Object) do
128
+ graphql_name(type["name"])
129
+ description(type["description"])
130
+ if type["interfaces"]
131
+ type["interfaces"].each do |interface_type|
132
+ implements(type_resolver.call(interface_type))
133
+ end
150
134
  end
135
+ loader.build_fields(self, type["fields"], type_resolver)
151
136
  end
152
-
153
- GraphQL::Argument.define(
154
- name: type["name"],
155
- type: type_resolver.call(type["type"]),
156
- description: type["description"],
157
- method_access: false,
158
- **kwargs
159
- )
160
137
  when "SCALAR"
161
138
  type_name = type.fetch("name")
162
- if GraphQL::Schema::BUILT_IN_TYPES[type_name]
163
- GraphQL::Schema::BUILT_IN_TYPES[type_name]
139
+ if (builtin = GraphQL::Schema::BUILT_IN_TYPES[type_name])
140
+ builtin
164
141
  else
165
- ScalarType.define(
166
- name: type["name"],
167
- description: type["description"],
168
- coerce: NullScalarCoerce,
169
- )
142
+ Class.new(GraphQL::Schema::Scalar) do
143
+ graphql_name(type["name"])
144
+ description(type["description"])
145
+ specified_by_url(type["specifiedByUrl"])
146
+ end
170
147
  end
171
148
  when "UNION"
172
- UnionType.define(
173
- name: type["name"],
174
- description: type["description"],
175
- possible_types: type["possibleTypes"].map { |possible_type|
176
- type_resolver.call(possible_type)
177
- }
178
- )
149
+ Class.new(GraphQL::Schema::Union) do
150
+ graphql_name(type["name"])
151
+ description(type["description"])
152
+ possible_types(*(type["possibleTypes"].map { |pt| type_resolver.call(pt) }))
153
+ end
179
154
  else
180
155
  fail GraphQL::RequiredImplementationMissingError, "#{type["kind"]} not implemented"
181
156
  end
182
157
  end
158
+
159
+ def define_directive(directive, type_resolver)
160
+ loader = self
161
+ Class.new(GraphQL::Schema::Directive) do
162
+ graphql_name(directive["name"])
163
+ description(directive["description"])
164
+ locations(*directive["locations"].map(&:to_sym))
165
+ repeatable(directive["isRepeatable"])
166
+ loader.build_arguments(self, directive["args"], type_resolver)
167
+ end
168
+ end
169
+
170
+ public
171
+
172
+ def build_fields(type_defn, fields, type_resolver)
173
+ loader = self
174
+ fields.each do |field_hash|
175
+ unwrapped_field_hash = field_hash
176
+ while (of_type = unwrapped_field_hash["ofType"])
177
+ unwrapped_field_hash = of_type
178
+ end
179
+ type_name = unwrapped_field_hash["name"]
180
+
181
+ type_defn.field(
182
+ field_hash["name"],
183
+ type: type_resolver.call(field_hash["type"]),
184
+ description: field_hash["description"],
185
+ deprecation_reason: field_hash["deprecationReason"],
186
+ null: true,
187
+ camelize: false,
188
+ connection_extension: nil,
189
+ connection: type_name.end_with?("Connection"),
190
+ ) do
191
+ if field_hash["args"].any?
192
+ loader.build_arguments(self, field_hash["args"], type_resolver)
193
+ end
194
+ end
195
+ end
196
+ end
197
+
198
+ def build_arguments(arg_owner, args, type_resolver)
199
+ args.each do |arg|
200
+ kwargs = {
201
+ type: type_resolver.call(arg["type"]),
202
+ description: arg["description"],
203
+ deprecation_reason: arg["deprecationReason"],
204
+ required: false,
205
+ method_access: false,
206
+ camelize: false,
207
+ }
208
+
209
+ if arg["defaultValue"]
210
+ default_value_str = arg["defaultValue"]
211
+
212
+ dummy_query_str = "query getStuff($var: InputObj = #{default_value_str}) { __typename }"
213
+
214
+ # Returns a `GraphQL::Language::Nodes::Document`:
215
+ dummy_query_ast = GraphQL.parse(dummy_query_str)
216
+
217
+ # Reach into the AST for the default value:
218
+ input_value_ast = dummy_query_ast.definitions.first.variables.first.default_value
219
+
220
+ kwargs[:default_value] = extract_default_value(default_value_str, input_value_ast)
221
+ end
222
+
223
+ arg_owner.argument(arg["name"], **kwargs)
224
+ end
225
+ end
183
226
  end
184
227
  end
185
228
  end
@@ -85,8 +85,15 @@ module GraphQL
85
85
  define_method(name) do |*args|
86
86
  if args.any?
87
87
  instance_variable_set(ivar_name, args)
88
+ else
89
+ if (v = instance_variable_get(ivar_name))
90
+ v
91
+ elsif (ancestor = ancestors.find { |i| i.respond_to?(name) && i != self })
92
+ ancestor.public_send(name)
93
+ else
94
+ nil
95
+ end
88
96
  end
89
- instance_variable_get(ivar_name) || ((int = interfaces.first { |i| i.respond_to?()}) && int.public_send(name))
90
97
  end
91
98
  end
92
99
  end
@@ -116,8 +123,13 @@ module GraphQL
116
123
  end
117
124
 
118
125
  module ToGraphQLExtension
119
- def to_graphql
120
- defn = super
126
+ def to_graphql(*args, **kwargs)
127
+
128
+ defn = if args.empty? && kwargs.empty?
129
+ super()
130
+ else
131
+ super
132
+ end
121
133
  accepts_definition_methods.each do |method_name|
122
134
  value = public_send(method_name)
123
135
  if !value.nil?