relay-compiler 11.0.2 → 13.0.0-rc.2

Sign up to get free protection for your applications and to get access to all the features.
Files changed (261) hide show
  1. package/README.md +108 -0
  2. package/cli.js +23 -0
  3. package/index.js +22 -4
  4. package/linux-x64/relay +0 -0
  5. package/macos-arm64/relay +0 -0
  6. package/macos-x64/relay +0 -0
  7. package/package.json +2 -26
  8. package/win-x64/relay.exe +0 -0
  9. package/bin/RelayCompilerBin.js.flow +0 -169
  10. package/bin/RelayCompilerMain.js.flow +0 -515
  11. package/bin/__fixtures__/plugin-module.js.flow +0 -17
  12. package/bin/relay-compiler +0 -19008
  13. package/codegen/CodegenDirectory.js.flow +0 -375
  14. package/codegen/CodegenRunner.js.flow +0 -432
  15. package/codegen/CodegenTypes.js.flow +0 -28
  16. package/codegen/CodegenWatcher.js.flow +0 -254
  17. package/codegen/NormalizationCodeGenerator.js.flow +0 -571
  18. package/codegen/ReaderCodeGenerator.js.flow +0 -512
  19. package/codegen/RelayCodeGenerator.js.flow +0 -85
  20. package/codegen/RelayFileWriter.js.flow +0 -367
  21. package/codegen/SourceControl.js.flow +0 -58
  22. package/codegen/compileRelayArtifacts.js.flow +0 -182
  23. package/codegen/createPrintRequireModuleDependency.js.flow +0 -21
  24. package/codegen/sortObjectByKey.js.flow +0 -25
  25. package/codegen/writeRelayGeneratedFile.js.flow +0 -239
  26. package/core/ASTCache.js.flow +0 -74
  27. package/core/ASTConvert.js.flow +0 -233
  28. package/core/CompilerContext.js.flow +0 -191
  29. package/core/CompilerError.js.flow +0 -255
  30. package/core/DotGraphQLParser.js.flow +0 -39
  31. package/core/GraphQLCompilerProfiler.js.flow +0 -341
  32. package/core/GraphQLDerivedFromMetadata.js.flow +0 -36
  33. package/core/GraphQLWatchmanClient.js.flow +0 -111
  34. package/core/IR.js.flow +0 -326
  35. package/core/IRPrinter.js.flow +0 -478
  36. package/core/IRTransformer.js.flow +0 -377
  37. package/core/IRValidator.js.flow +0 -260
  38. package/core/IRVisitor.js.flow +0 -150
  39. package/core/JSModuleParser.js.flow +0 -24
  40. package/core/RelayCompilerScope.js.flow +0 -199
  41. package/core/RelayFindGraphQLTags.js.flow +0 -119
  42. package/core/RelayGraphQLEnumsGenerator.js.flow +0 -55
  43. package/core/RelayIRTransforms.js.flow +0 -138
  44. package/core/RelayParser.js.flow +0 -1734
  45. package/core/RelaySourceModuleParser.js.flow +0 -135
  46. package/core/Schema.js.flow +0 -2037
  47. package/core/SchemaUtils.js.flow +0 -120
  48. package/core/filterContextForNode.js.flow +0 -50
  49. package/core/getFieldDefinition.js.flow +0 -156
  50. package/core/getIdentifierForArgumentValue.js.flow +0 -49
  51. package/core/getIdentifierForSelection.js.flow +0 -69
  52. package/core/getLiteralArgumentValues.js.flow +0 -32
  53. package/core/getNormalizationOperationName.js.flow +0 -19
  54. package/core/inferRootArgumentDefinitions.js.flow +0 -323
  55. package/index.js.flow +0 -200
  56. package/language/RelayLanguagePluginInterface.js.flow +0 -283
  57. package/language/javascript/FindGraphQLTags.js.flow +0 -137
  58. package/language/javascript/RelayFlowBabelFactories.js.flow +0 -176
  59. package/language/javascript/RelayFlowGenerator.js.flow +0 -1100
  60. package/language/javascript/RelayFlowTypeTransformers.js.flow +0 -184
  61. package/language/javascript/RelayLanguagePluginJavaScript.js.flow +0 -34
  62. package/language/javascript/formatGeneratedModule.js.flow +0 -65
  63. package/lib/bin/RelayCompilerBin.js +0 -143
  64. package/lib/bin/RelayCompilerMain.js +0 -486
  65. package/lib/bin/__fixtures__/plugin-module.js +0 -16
  66. package/lib/codegen/CodegenDirectory.js +0 -336
  67. package/lib/codegen/CodegenRunner.js +0 -433
  68. package/lib/codegen/CodegenTypes.js +0 -11
  69. package/lib/codegen/CodegenWatcher.js +0 -271
  70. package/lib/codegen/NormalizationCodeGenerator.js +0 -481
  71. package/lib/codegen/ReaderCodeGenerator.js +0 -472
  72. package/lib/codegen/RelayCodeGenerator.js +0 -68
  73. package/lib/codegen/RelayFileWriter.js +0 -270
  74. package/lib/codegen/SourceControl.js +0 -60
  75. package/lib/codegen/compileRelayArtifacts.js +0 -157
  76. package/lib/codegen/createPrintRequireModuleDependency.js +0 -19
  77. package/lib/codegen/sortObjectByKey.js +0 -41
  78. package/lib/codegen/writeRelayGeneratedFile.js +0 -208
  79. package/lib/core/ASTCache.js +0 -70
  80. package/lib/core/ASTConvert.js +0 -198
  81. package/lib/core/CompilerContext.js +0 -165
  82. package/lib/core/CompilerError.js +0 -251
  83. package/lib/core/DotGraphQLParser.js +0 -40
  84. package/lib/core/GraphQLCompilerProfiler.js +0 -299
  85. package/lib/core/GraphQLDerivedFromMetadata.js +0 -31
  86. package/lib/core/GraphQLWatchmanClient.js +0 -150
  87. package/lib/core/IR.js +0 -11
  88. package/lib/core/IRPrinter.js +0 -389
  89. package/lib/core/IRTransformer.js +0 -345
  90. package/lib/core/IRValidator.js +0 -226
  91. package/lib/core/IRVisitor.js +0 -45
  92. package/lib/core/JSModuleParser.js +0 -18
  93. package/lib/core/RelayCompilerScope.js +0 -149
  94. package/lib/core/RelayFindGraphQLTags.js +0 -79
  95. package/lib/core/RelayGraphQLEnumsGenerator.js +0 -50
  96. package/lib/core/RelayIRTransforms.js +0 -109
  97. package/lib/core/RelayParser.js +0 -1382
  98. package/lib/core/RelaySourceModuleParser.js +0 -104
  99. package/lib/core/Schema.js +0 -1877
  100. package/lib/core/SchemaUtils.js +0 -98
  101. package/lib/core/filterContextForNode.js +0 -49
  102. package/lib/core/getFieldDefinition.js +0 -145
  103. package/lib/core/getIdentifierForArgumentValue.js +0 -53
  104. package/lib/core/getIdentifierForSelection.js +0 -48
  105. package/lib/core/getLiteralArgumentValues.js +0 -26
  106. package/lib/core/getNormalizationOperationName.js +0 -17
  107. package/lib/core/inferRootArgumentDefinitions.js +0 -351
  108. package/lib/index.js +0 -178
  109. package/lib/language/RelayLanguagePluginInterface.js +0 -14
  110. package/lib/language/javascript/FindGraphQLTags.js +0 -126
  111. package/lib/language/javascript/RelayFlowBabelFactories.js +0 -160
  112. package/lib/language/javascript/RelayFlowGenerator.js +0 -857
  113. package/lib/language/javascript/RelayFlowTypeTransformers.js +0 -119
  114. package/lib/language/javascript/RelayLanguagePluginJavaScript.js +0 -30
  115. package/lib/language/javascript/formatGeneratedModule.js +0 -36
  116. package/lib/reporters/ConsoleReporter.js +0 -61
  117. package/lib/reporters/MultiReporter.js +0 -45
  118. package/lib/reporters/Reporter.js +0 -11
  119. package/lib/runner/Artifacts.js +0 -323
  120. package/lib/runner/BufferedFilesystem.js +0 -261
  121. package/lib/runner/GraphQLASTNodeGroup.js +0 -256
  122. package/lib/runner/GraphQLASTUtils.js +0 -23
  123. package/lib/runner/GraphQLNodeMap.js +0 -81
  124. package/lib/runner/Sources.js +0 -271
  125. package/lib/runner/StrictMap.js +0 -134
  126. package/lib/runner/compileArtifacts.js +0 -39
  127. package/lib/runner/extractAST.js +0 -77
  128. package/lib/runner/getChangedNodeNames.js +0 -82
  129. package/lib/runner/getSchemaInstance.js +0 -30
  130. package/lib/runner/types.js +0 -12
  131. package/lib/transforms/ApplyFragmentArgumentTransform.js +0 -393
  132. package/lib/transforms/ClientExtensionsTransform.js +0 -221
  133. package/lib/transforms/ConnectionTransform.js +0 -639
  134. package/lib/transforms/DeclarativeConnectionMutationTransform.js +0 -218
  135. package/lib/transforms/DeferStreamTransform.js +0 -246
  136. package/lib/transforms/DisallowIdAsAlias.js +0 -40
  137. package/lib/transforms/DisallowTypenameOnRoot.js +0 -53
  138. package/lib/transforms/FieldHandleTransform.js +0 -79
  139. package/lib/transforms/FilterCompilerDirectivesTransform.js +0 -29
  140. package/lib/transforms/FilterDirectivesTransform.js +0 -41
  141. package/lib/transforms/FlattenTransform.js +0 -306
  142. package/lib/transforms/GenerateIDFieldTransform.js +0 -135
  143. package/lib/transforms/GenerateTypeNameTransform.js +0 -149
  144. package/lib/transforms/InlineDataFragmentTransform.js +0 -100
  145. package/lib/transforms/InlineFragmentsTransform.js +0 -61
  146. package/lib/transforms/MaskTransform.js +0 -117
  147. package/lib/transforms/MatchTransform.js +0 -434
  148. package/lib/transforms/ReactFlightComponentTransform.js +0 -158
  149. package/lib/transforms/RefetchableFragmentTransform.js +0 -249
  150. package/lib/transforms/RelayDirectiveTransform.js +0 -83
  151. package/lib/transforms/RequiredFieldTransform.js +0 -369
  152. package/lib/transforms/SkipClientExtensionsTransform.js +0 -46
  153. package/lib/transforms/SkipHandleFieldTransform.js +0 -44
  154. package/lib/transforms/SkipRedundantNodesTransform.js +0 -254
  155. package/lib/transforms/SkipSplitOperationTransform.js +0 -32
  156. package/lib/transforms/SkipUnreachableNodeTransform.js +0 -158
  157. package/lib/transforms/SkipUnusedVariablesTransform.js +0 -74
  158. package/lib/transforms/SplitModuleImportTransform.js +0 -82
  159. package/lib/transforms/TestOperationTransform.js +0 -144
  160. package/lib/transforms/TransformUtils.js +0 -21
  161. package/lib/transforms/ValidateGlobalVariablesTransform.js +0 -91
  162. package/lib/transforms/ValidateRequiredArgumentsTransform.js +0 -114
  163. package/lib/transforms/ValidateServerOnlyDirectivesTransform.js +0 -108
  164. package/lib/transforms/ValidateUnusedVariablesTransform.js +0 -96
  165. package/lib/transforms/query-generators/FetchableQueryGenerator.js +0 -157
  166. package/lib/transforms/query-generators/NodeQueryGenerator.js +0 -166
  167. package/lib/transforms/query-generators/QueryQueryGenerator.js +0 -48
  168. package/lib/transforms/query-generators/ViewerQueryGenerator.js +0 -77
  169. package/lib/transforms/query-generators/index.js +0 -60
  170. package/lib/transforms/query-generators/utils.js +0 -92
  171. package/lib/util/CodeMarker.js +0 -80
  172. package/lib/util/DefaultHandleKey.js +0 -15
  173. package/lib/util/RelayCompilerCache.js +0 -98
  174. package/lib/util/Rollout.js +0 -40
  175. package/lib/util/TimeReporter.js +0 -83
  176. package/lib/util/areEqualArgValues.js +0 -134
  177. package/lib/util/argumentContainsVariables.js +0 -37
  178. package/lib/util/dedupeJSONStringify.js +0 -160
  179. package/lib/util/generateAbstractTypeRefinementKey.js +0 -24
  180. package/lib/util/getDefinitionNodeHash.js +0 -22
  181. package/lib/util/getModuleName.js +0 -32
  182. package/lib/util/joinArgumentDefinitions.js +0 -66
  183. package/lib/util/md5.js +0 -17
  184. package/lib/util/murmurHash.js +0 -86
  185. package/lib/util/nullthrowsOSS.js +0 -23
  186. package/lib/util/orList.js +0 -36
  187. package/lib/util/partitionArray.js +0 -35
  188. package/relay-compiler.js +0 -17
  189. package/relay-compiler.min.js +0 -22
  190. package/reporters/ConsoleReporter.js.flow +0 -81
  191. package/reporters/MultiReporter.js.flow +0 -43
  192. package/reporters/Reporter.js.flow +0 -19
  193. package/runner/Artifacts.js.flow +0 -219
  194. package/runner/BufferedFilesystem.js.flow +0 -194
  195. package/runner/GraphQLASTNodeGroup.js.flow +0 -176
  196. package/runner/GraphQLASTUtils.js.flow +0 -26
  197. package/runner/GraphQLNodeMap.js.flow +0 -55
  198. package/runner/Sources.js.flow +0 -228
  199. package/runner/StrictMap.js.flow +0 -96
  200. package/runner/compileArtifacts.js.flow +0 -76
  201. package/runner/extractAST.js.flow +0 -100
  202. package/runner/getChangedNodeNames.js.flow +0 -48
  203. package/runner/getSchemaInstance.js.flow +0 -36
  204. package/runner/types.js.flow +0 -37
  205. package/transforms/ApplyFragmentArgumentTransform.js.flow +0 -526
  206. package/transforms/ClientExtensionsTransform.js.flow +0 -225
  207. package/transforms/ConnectionTransform.js.flow +0 -855
  208. package/transforms/DeclarativeConnectionMutationTransform.js.flow +0 -247
  209. package/transforms/DeferStreamTransform.js.flow +0 -265
  210. package/transforms/DisallowIdAsAlias.js.flow +0 -47
  211. package/transforms/DisallowTypenameOnRoot.js.flow +0 -45
  212. package/transforms/FieldHandleTransform.js.flow +0 -79
  213. package/transforms/FilterCompilerDirectivesTransform.js.flow +0 -33
  214. package/transforms/FilterDirectivesTransform.js.flow +0 -45
  215. package/transforms/FlattenTransform.js.flow +0 -460
  216. package/transforms/GenerateIDFieldTransform.js.flow +0 -152
  217. package/transforms/GenerateTypeNameTransform.js.flow +0 -161
  218. package/transforms/InlineDataFragmentTransform.js.flow +0 -125
  219. package/transforms/InlineFragmentsTransform.js.flow +0 -71
  220. package/transforms/MaskTransform.js.flow +0 -126
  221. package/transforms/MatchTransform.js.flow +0 -589
  222. package/transforms/ReactFlightComponentTransform.js.flow +0 -195
  223. package/transforms/RefetchableFragmentTransform.js.flow +0 -272
  224. package/transforms/RelayDirectiveTransform.js.flow +0 -97
  225. package/transforms/RequiredFieldTransform.js.flow +0 -415
  226. package/transforms/SkipClientExtensionsTransform.js.flow +0 -54
  227. package/transforms/SkipHandleFieldTransform.js.flow +0 -44
  228. package/transforms/SkipRedundantNodesTransform.js.flow +0 -258
  229. package/transforms/SkipSplitOperationTransform.js.flow +0 -37
  230. package/transforms/SkipUnreachableNodeTransform.js.flow +0 -149
  231. package/transforms/SkipUnusedVariablesTransform.js.flow +0 -59
  232. package/transforms/SplitModuleImportTransform.js.flow +0 -98
  233. package/transforms/TestOperationTransform.js.flow +0 -142
  234. package/transforms/TransformUtils.js.flow +0 -26
  235. package/transforms/ValidateGlobalVariablesTransform.js.flow +0 -81
  236. package/transforms/ValidateRequiredArgumentsTransform.js.flow +0 -127
  237. package/transforms/ValidateServerOnlyDirectivesTransform.js.flow +0 -112
  238. package/transforms/ValidateUnusedVariablesTransform.js.flow +0 -89
  239. package/transforms/query-generators/FetchableQueryGenerator.js.flow +0 -189
  240. package/transforms/query-generators/NodeQueryGenerator.js.flow +0 -219
  241. package/transforms/query-generators/QueryQueryGenerator.js.flow +0 -57
  242. package/transforms/query-generators/ViewerQueryGenerator.js.flow +0 -97
  243. package/transforms/query-generators/index.js.flow +0 -90
  244. package/transforms/query-generators/utils.js.flow +0 -76
  245. package/util/CodeMarker.js.flow +0 -79
  246. package/util/DefaultHandleKey.js.flow +0 -17
  247. package/util/RelayCompilerCache.js.flow +0 -88
  248. package/util/Rollout.js.flow +0 -39
  249. package/util/TimeReporter.js.flow +0 -79
  250. package/util/areEqualArgValues.js.flow +0 -125
  251. package/util/argumentContainsVariables.js.flow +0 -38
  252. package/util/dedupeJSONStringify.js.flow +0 -152
  253. package/util/generateAbstractTypeRefinementKey.js.flow +0 -29
  254. package/util/getDefinitionNodeHash.js.flow +0 -25
  255. package/util/getModuleName.js.flow +0 -39
  256. package/util/joinArgumentDefinitions.js.flow +0 -105
  257. package/util/md5.js.flow +0 -22
  258. package/util/murmurHash.js.flow +0 -94
  259. package/util/nullthrowsOSS.js.flow +0 -25
  260. package/util/orList.js.flow +0 -37
  261. package/util/partitionArray.js.flow +0 -37
@@ -1,639 +0,0 @@
1
- /**
2
- * Copyright (c) Facebook, Inc. and its affiliates.
3
- *
4
- * This source code is licensed under the MIT license found in the
5
- * LICENSE file in the root directory of this source tree.
6
- *
7
- *
8
- * @format
9
- */
10
- // flowlint ambiguous-object-type:error
11
- 'use strict';
12
-
13
- var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
14
-
15
- var _objectSpread2 = _interopRequireDefault(require("@babel/runtime/helpers/objectSpread2"));
16
-
17
- var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
18
-
19
- var IRTransformer = require('../core/IRTransformer');
20
-
21
- var RelayParser = require('../core/RelayParser');
22
-
23
- var SchemaUtils = require('../core/SchemaUtils');
24
-
25
- var getLiteralArgumentValues = require('../core/getLiteralArgumentValues');
26
-
27
- var _require = require('../core/CompilerError'),
28
- createCompilerError = _require.createCompilerError,
29
- createUserError = _require.createUserError;
30
-
31
- var _require2 = require('graphql'),
32
- parse = _require2.parse;
33
-
34
- var _require3 = require('relay-runtime'),
35
- ConnectionInterface = _require3.ConnectionInterface,
36
- RelayFeatureFlags = _require3.RelayFeatureFlags;
37
-
38
- var AFTER = 'after';
39
- var BEFORE = 'before';
40
- var FIRST = 'first';
41
- var KEY = 'key';
42
- var LAST = 'last';
43
- var CONNECTION = 'connection';
44
- var STREAM_CONNECTION = 'stream_connection';
45
- var HANDLER = 'handler';
46
- /**
47
- * @public
48
- *
49
- * Transforms fields with the `@connection` directive:
50
- * - Verifies that the field type is connection-like.
51
- * - Adds a `handle` property to the field, either the user-provided `handle`
52
- * argument or the default value "connection".
53
- * - Inserts a sub-fragment on the field to ensure that standard connection
54
- * fields are fetched (e.g. cursors, node ids, page info).
55
- */
56
-
57
- function connectionTransform(context) {
58
- return IRTransformer.transform(context, {
59
- Fragment: visitFragmentOrRoot,
60
- LinkedField: visitLinkedField,
61
- Root: visitFragmentOrRoot
62
- }, function (node) {
63
- return {
64
- documentName: node.name,
65
- path: [],
66
- connectionMetadata: []
67
- };
68
- });
69
- }
70
-
71
- var SCHEMA_EXTENSION = "\n directive @connection(\n key: String!\n filters: [String]\n handler: String\n dynamicKey_UNSTABLE: String\n ) on FIELD\n\n directive @stream_connection(\n key: String!\n filters: [String]\n handler: String\n initial_count: Int!\n if: Boolean = true\n use_customized_batch: Boolean = false\n dynamicKey_UNSTABLE: String\n ) on FIELD\n";
72
- /**
73
- * @internal
74
- */
75
-
76
- function visitFragmentOrRoot(node, options) {
77
- var transformedNode = this.traverse(node, options);
78
- var connectionMetadata = options.connectionMetadata;
79
-
80
- if (connectionMetadata.length) {
81
- return (0, _objectSpread2["default"])((0, _objectSpread2["default"])({}, transformedNode), {}, {
82
- metadata: (0, _objectSpread2["default"])((0, _objectSpread2["default"])({}, transformedNode.metadata), {}, {
83
- connection: connectionMetadata
84
- })
85
- });
86
- }
87
-
88
- return transformedNode;
89
- }
90
- /**
91
- * @internal
92
- */
93
-
94
-
95
- function visitLinkedField(field, options) {
96
- var _connectionArguments$;
97
-
98
- var context = this.getContext();
99
- var schema = context.getSchema();
100
- var nullableType = schema.getNullableType(field.type);
101
- var isPlural = schema.isList(nullableType);
102
- var path = options.path.concat(isPlural ? null : field.alias || field.name);
103
- var transformedField = this.traverse(field, (0, _objectSpread2["default"])((0, _objectSpread2["default"])({}, options), {}, {
104
- path: path
105
- }));
106
- var connectionDirective = field.directives.find(function (directive) {
107
- return directive.name === CONNECTION || directive.name === STREAM_CONNECTION;
108
- });
109
-
110
- if (!connectionDirective) {
111
- return transformedField;
112
- }
113
-
114
- if (!schema.isObject(nullableType) && !schema.isInterface(nullableType)) {
115
- throw new createUserError("@".concat(connectionDirective.name, " used on invalid field '").concat(field.name, "'. ") + 'Expected the return type to be a non-plural interface or object, ' + "got '".concat(schema.getTypeString(field.type), "'."), [transformedField.loc]);
116
- }
117
-
118
- validateConnectionSelection(transformedField);
119
- validateConnectionType(schema, transformedField, schema.assertCompositeType(nullableType), connectionDirective);
120
- var connectionArguments = buildConnectionArguments(transformedField, connectionDirective);
121
- var connectionMetadata = buildConnectionMetadata(transformedField, path, connectionArguments.stream != null);
122
- options.connectionMetadata.push(connectionMetadata);
123
- var handle = {
124
- name: (_connectionArguments$ = connectionArguments.handler) !== null && _connectionArguments$ !== void 0 ? _connectionArguments$ : CONNECTION,
125
- key: connectionArguments.key,
126
- dynamicKey: connectionArguments.dynamicKey,
127
- filters: connectionArguments.filters
128
- };
129
- var direction = connectionMetadata.direction;
130
-
131
- if (direction != null) {
132
- var selections = transformConnectionSelections(this.getContext(), transformedField, schema.assertCompositeType(nullableType), direction, connectionArguments, connectionDirective.loc, options.documentName);
133
- transformedField = (0, _objectSpread2["default"])((0, _objectSpread2["default"])({}, transformedField), {}, {
134
- selections: selections
135
- });
136
- }
137
-
138
- return (0, _objectSpread2["default"])((0, _objectSpread2["default"])({}, transformedField), {}, {
139
- directives: transformedField.directives.filter(function (directive) {
140
- return directive !== connectionDirective;
141
- }),
142
- connection: true,
143
- handles: transformedField.handles ? [].concat((0, _toConsumableArray2["default"])(transformedField.handles), [handle]) : [handle]
144
- });
145
- }
146
-
147
- function buildConnectionArguments(field, connectionDirective) {
148
- var _getLiteralArgumentVa = getLiteralArgumentValues(connectionDirective.args),
149
- handler = _getLiteralArgumentVa.handler,
150
- key = _getLiteralArgumentVa.key,
151
- label = _getLiteralArgumentVa.label,
152
- literalFilters = _getLiteralArgumentVa.filters;
153
-
154
- if (handler != null && typeof handler !== 'string') {
155
- var _handleArg$value$loc, _handleArg$value;
156
-
157
- var handleArg = connectionDirective.args.find(function (arg) {
158
- return arg.name === 'handler';
159
- });
160
- throw createUserError("Expected the ".concat(HANDLER, " argument to @").concat(connectionDirective.name, " to ") + "be a string literal for field ".concat(field.name, "."), [(_handleArg$value$loc = handleArg === null || handleArg === void 0 ? void 0 : (_handleArg$value = handleArg.value) === null || _handleArg$value === void 0 ? void 0 : _handleArg$value.loc) !== null && _handleArg$value$loc !== void 0 ? _handleArg$value$loc : connectionDirective.loc]);
161
- }
162
-
163
- if (typeof key !== 'string') {
164
- var _keyArg$value$loc, _keyArg$value;
165
-
166
- var keyArg = connectionDirective.args.find(function (arg) {
167
- return arg.name === 'key';
168
- });
169
- throw createUserError("Expected the ".concat(KEY, " argument to @").concat(connectionDirective.name, " to be a ") + "string literal for field ".concat(field.name, "."), [(_keyArg$value$loc = keyArg === null || keyArg === void 0 ? void 0 : (_keyArg$value = keyArg.value) === null || _keyArg$value === void 0 ? void 0 : _keyArg$value.loc) !== null && _keyArg$value$loc !== void 0 ? _keyArg$value$loc : connectionDirective.loc]);
170
- }
171
-
172
- var postfix = field.alias || field.name;
173
-
174
- if (!key.endsWith('_' + postfix)) {
175
- var _keyArg$value$loc2, _keyArg$value2;
176
-
177
- var _keyArg = connectionDirective.args.find(function (arg) {
178
- return arg.name === 'key';
179
- });
180
-
181
- throw createUserError("Expected the ".concat(KEY, " argument to @").concat(connectionDirective.name, " to be of ") + "form <SomeName>_".concat(postfix, ", got '").concat(key, "'. ") + 'For a detailed explanation, check out ' + 'https://relay.dev/docs/en/pagination-container#connection', [(_keyArg$value$loc2 = _keyArg === null || _keyArg === void 0 ? void 0 : (_keyArg$value2 = _keyArg.value) === null || _keyArg$value2 === void 0 ? void 0 : _keyArg$value2.loc) !== null && _keyArg$value$loc2 !== void 0 ? _keyArg$value$loc2 : connectionDirective.loc]);
182
- }
183
-
184
- if (literalFilters != null && (!Array.isArray(literalFilters) || literalFilters.some(function (filter) {
185
- return typeof filter !== 'string';
186
- }))) {
187
- var _filtersArg$value$loc, _filtersArg$value;
188
-
189
- var filtersArg = connectionDirective.args.find(function (arg) {
190
- return arg.name === 'filters';
191
- });
192
- throw createUserError("Expected the 'filters' argument to @".concat(connectionDirective.name, " to be ") + 'a string literal.', [(_filtersArg$value$loc = filtersArg === null || filtersArg === void 0 ? void 0 : (_filtersArg$value = filtersArg.value) === null || _filtersArg$value === void 0 ? void 0 : _filtersArg$value.loc) !== null && _filtersArg$value$loc !== void 0 ? _filtersArg$value$loc : connectionDirective.loc]);
193
- }
194
-
195
- var filters = literalFilters;
196
-
197
- if (filters == null) {
198
- var generatedFilters = field.args.filter(function (arg) {
199
- return !ConnectionInterface.isConnectionCall({
200
- name: arg.name,
201
- value: null
202
- });
203
- }).map(function (arg) {
204
- return arg.name;
205
- });
206
- filters = generatedFilters.length !== 0 ? generatedFilters : null;
207
- }
208
-
209
- var stream = null;
210
-
211
- if (connectionDirective.name === STREAM_CONNECTION) {
212
- var initialCountArg = connectionDirective.args.find(function (arg) {
213
- return arg.name === 'initial_count';
214
- });
215
- var useCustomizedBatchArg = connectionDirective.args.find(function (arg) {
216
- return arg.name === 'use_customized_batch';
217
- });
218
- var ifArg = connectionDirective.args.find(function (arg) {
219
- return arg.name === 'if';
220
- });
221
- stream = {
222
- "if": ifArg,
223
- initialCount: initialCountArg,
224
- useCustomizedBatch: useCustomizedBatchArg,
225
- label: key
226
- };
227
- }
228
-
229
- var dynamicKeyArg = connectionDirective.args.find(function (arg) {
230
- return arg.name === 'dynamicKey_UNSTABLE';
231
- });
232
- var dynamicKey = null;
233
-
234
- if (dynamicKeyArg != null) {
235
- if (RelayFeatureFlags.ENABLE_VARIABLE_CONNECTION_KEY && dynamicKeyArg.value.kind === 'Variable') {
236
- dynamicKey = dynamicKeyArg.value;
237
- } else {
238
- throw createUserError("Unsupported 'dynamicKey_UNSTABLE' argument to @".concat(connectionDirective.name, ". This argument is only valid when the feature flag is enabled and ") + 'the variable must be a variable', [connectionDirective.loc]);
239
- }
240
- }
241
-
242
- return {
243
- handler: handler,
244
- key: key,
245
- dynamicKey: dynamicKey,
246
- filters: filters,
247
- stream: stream
248
- };
249
- }
250
-
251
- function buildConnectionMetadata(field, path, stream) {
252
- var pathHasPlural = path.includes(null);
253
- var firstArg = findArg(field, FIRST);
254
- var lastArg = findArg(field, LAST);
255
- var direction = null;
256
- var countArg = null;
257
- var cursorArg = null;
258
-
259
- if (firstArg && !lastArg) {
260
- direction = 'forward';
261
- countArg = firstArg;
262
- cursorArg = findArg(field, AFTER);
263
- } else if (lastArg && !firstArg) {
264
- direction = 'backward';
265
- countArg = lastArg;
266
- cursorArg = findArg(field, BEFORE);
267
- } else if (lastArg && firstArg) {
268
- direction = 'bidirectional'; // TODO(T26511885) Maybe add connection metadata to this case
269
- }
270
-
271
- var countVariable = countArg && countArg.value.kind === 'Variable' ? countArg.value.variableName : null;
272
- var cursorVariable = cursorArg && cursorArg.value.kind === 'Variable' ? cursorArg.value.variableName : null;
273
-
274
- if (stream) {
275
- return {
276
- count: countVariable,
277
- cursor: cursorVariable,
278
- direction: direction,
279
- path: pathHasPlural ? null : path,
280
- stream: true
281
- };
282
- }
283
-
284
- return {
285
- count: countVariable,
286
- cursor: cursorVariable,
287
- direction: direction,
288
- path: pathHasPlural ? null : path
289
- };
290
- }
291
- /**
292
- * @internal
293
- *
294
- * Transforms the selections on a connection field, generating fields necessary
295
- * for pagination (edges.cursor, pageInfo, etc) and adding/merging them with
296
- * existing selections.
297
- */
298
-
299
-
300
- function transformConnectionSelections(context, field, nullableType, direction, connectionArguments, directiveLocation, documentName) {
301
- var schema = context.getSchema();
302
- var derivedFieldLocation = {
303
- kind: 'Derived',
304
- source: field.loc
305
- };
306
- var derivedDirectiveLocation = {
307
- kind: 'Derived',
308
- source: directiveLocation
309
- };
310
-
311
- var _ConnectionInterface$ = ConnectionInterface.get(),
312
- CURSOR = _ConnectionInterface$.CURSOR,
313
- EDGES = _ConnectionInterface$.EDGES,
314
- END_CURSOR = _ConnectionInterface$.END_CURSOR,
315
- HAS_NEXT_PAGE = _ConnectionInterface$.HAS_NEXT_PAGE,
316
- HAS_PREV_PAGE = _ConnectionInterface$.HAS_PREV_PAGE,
317
- NODE = _ConnectionInterface$.NODE,
318
- PAGE_INFO = _ConnectionInterface$.PAGE_INFO,
319
- START_CURSOR = _ConnectionInterface$.START_CURSOR; // Find existing edges/pageInfo selections
320
-
321
-
322
- var edgesSelection;
323
- var pageInfoSelection;
324
- field.selections.forEach(function (selection) {
325
- if (selection.kind === 'LinkedField') {
326
- if (selection.name === EDGES) {
327
- if (edgesSelection != null) {
328
- throw createCompilerError("ConnectionTransform: Unexpected duplicate field '".concat(EDGES, "'."), [edgesSelection.loc, selection.loc]);
329
- }
330
-
331
- edgesSelection = selection;
332
- return;
333
- } else if (selection.name === PAGE_INFO) {
334
- if (pageInfoSelection != null) {
335
- throw createCompilerError("ConnectionTransform: Unexpected duplicate field '".concat(PAGE_INFO, "'."), [pageInfoSelection.loc, selection.loc]);
336
- }
337
-
338
- pageInfoSelection = selection;
339
- return;
340
- }
341
- }
342
- }); // If streaming is enabled, construct directives to apply to the edges/
343
- // pageInfo fields
344
-
345
- var streamDirective;
346
- var stream = connectionArguments.stream;
347
-
348
- if (stream != null) {
349
- streamDirective = {
350
- args: [stream["if"], stream.initialCount, stream.useCustomizedBatch, {
351
- kind: 'Argument',
352
- loc: derivedDirectiveLocation,
353
- name: 'label',
354
- type: SchemaUtils.getNullableStringInput(schema),
355
- value: {
356
- kind: 'Literal',
357
- loc: derivedDirectiveLocation,
358
- value: stream.label
359
- }
360
- }].filter(Boolean),
361
- kind: 'Directive',
362
- loc: derivedDirectiveLocation,
363
- name: 'stream'
364
- };
365
- } // For backwards compatibility with earlier versions of this transform,
366
- // edges/pageInfo have to be generated as non-aliased fields (since product
367
- // code may be accessing the non-aliased response keys). But for streaming
368
- // mode we need to generate @stream/@defer directives on these fields *and*
369
- // we prefer to avoid generating extra selections (we want one payload per
370
- // item, not two as could happen with separate @stream directives on the
371
- // aliased and non-aliased edges fields). So we keep things simple by
372
- // disallowing aliases on edges/pageInfo in streaming mode.
373
-
374
-
375
- if (edgesSelection && edgesSelection.alias !== edgesSelection.name) {
376
- if (stream) {
377
- throw createUserError("@stream_connection does not support aliasing the '".concat(EDGES, "' field."), [edgesSelection.loc]);
378
- }
379
-
380
- edgesSelection = null;
381
- }
382
-
383
- if (pageInfoSelection && pageInfoSelection.alias !== pageInfoSelection.name) {
384
- if (stream) {
385
- throw createUserError("@stream_connection does not support aliasing the '".concat(PAGE_INFO, "' field."), [pageInfoSelection.loc]);
386
- }
387
-
388
- pageInfoSelection = null;
389
- } // Separately create transformed versions of edges/pageInfo so that we can
390
- // later replace the originals at the same point within the selection array
391
-
392
-
393
- var transformedEdgesSelection = edgesSelection;
394
- var transformedPageInfoSelection = pageInfoSelection;
395
- var edgesType = schema.getFieldConfig(schema.expectField(nullableType, EDGES)).type;
396
- var pageInfoType = schema.getFieldConfig(schema.expectField(nullableType, PAGE_INFO)).type;
397
-
398
- if (transformedEdgesSelection == null) {
399
- transformedEdgesSelection = {
400
- alias: EDGES,
401
- args: [],
402
- connection: false,
403
- directives: [],
404
- handles: null,
405
- kind: 'LinkedField',
406
- loc: derivedFieldLocation,
407
- metadata: null,
408
- name: EDGES,
409
- selections: [],
410
- type: schema.assertLinkedFieldType(edgesType)
411
- };
412
- }
413
-
414
- if (transformedPageInfoSelection == null) {
415
- transformedPageInfoSelection = {
416
- alias: PAGE_INFO,
417
- args: [],
418
- connection: false,
419
- directives: [],
420
- handles: null,
421
- kind: 'LinkedField',
422
- loc: derivedFieldLocation,
423
- metadata: null,
424
- name: PAGE_INFO,
425
- selections: [],
426
- type: schema.assertLinkedFieldType(pageInfoType)
427
- };
428
- } // Generate (additional) fields on pageInfo and add to the transformed
429
- // pageInfo field
430
-
431
-
432
- var pageInfoRawType = schema.getRawType(pageInfoType);
433
- var pageInfoText;
434
-
435
- if (direction === 'forward') {
436
- pageInfoText = "fragment PageInfo on ".concat(schema.getTypeString(pageInfoRawType), " {\n ").concat(END_CURSOR, "\n ").concat(HAS_NEXT_PAGE, "\n }");
437
- } else if (direction === 'backward') {
438
- pageInfoText = "fragment PageInfo on ".concat(schema.getTypeString(pageInfoRawType), " {\n ").concat(HAS_PREV_PAGE, "\n ").concat(START_CURSOR, "\n }");
439
- } else {
440
- pageInfoText = "fragment PageInfo on ".concat(schema.getTypeString(pageInfoRawType), " {\n ").concat(END_CURSOR, "\n ").concat(HAS_NEXT_PAGE, "\n ").concat(HAS_PREV_PAGE, "\n ").concat(START_CURSOR, "\n }");
441
- }
442
-
443
- var pageInfoAst = parse(pageInfoText);
444
- var pageInfoFragment = RelayParser.transform(schema, [pageInfoAst.definitions[0]])[0];
445
-
446
- if (transformedPageInfoSelection.kind !== 'LinkedField') {
447
- throw createCompilerError('ConnectionTransform: Expected generated pageInfo selection to be ' + 'a LinkedField', [field.loc]);
448
- }
449
-
450
- transformedPageInfoSelection = (0, _objectSpread2["default"])((0, _objectSpread2["default"])({}, transformedPageInfoSelection), {}, {
451
- selections: [].concat((0, _toConsumableArray2["default"])(transformedPageInfoSelection.selections), [{
452
- directives: [],
453
- kind: 'InlineFragment',
454
- loc: derivedFieldLocation,
455
- metadata: null,
456
- selections: pageInfoFragment.selections,
457
- typeCondition: pageInfoFragment.type
458
- }])
459
- }); // When streaming the pageInfo field has to be deferred
460
-
461
- if (stream != null) {
462
- var _stream$if$value, _stream$if;
463
-
464
- transformedPageInfoSelection = {
465
- "if": (_stream$if$value = (_stream$if = stream["if"]) === null || _stream$if === void 0 ? void 0 : _stream$if.value) !== null && _stream$if$value !== void 0 ? _stream$if$value : null,
466
- label: "".concat(documentName, "$defer$").concat(stream.label, "$").concat(PAGE_INFO),
467
- kind: 'Defer',
468
- loc: derivedFieldLocation,
469
- selections: [transformedPageInfoSelection]
470
- };
471
- } // Generate additional fields on edges and append to the transformed edges
472
- // selection
473
-
474
-
475
- var edgeText = "\n fragment Edges on ".concat(schema.getTypeString(schema.getRawType(edgesType)), " {\n ").concat(CURSOR, "\n ").concat(NODE, " {\n __typename # rely on GenerateRequisiteFieldTransform to add \"id\"\n }\n }\n ");
476
- var edgeAst = parse(edgeText);
477
- var edgeFragment = RelayParser.transform(schema, [edgeAst.definitions[0]])[0]; // When streaming the edges field needs @stream
478
-
479
- transformedEdgesSelection = (0, _objectSpread2["default"])((0, _objectSpread2["default"])({}, transformedEdgesSelection), {}, {
480
- directives: streamDirective != null ? [].concat((0, _toConsumableArray2["default"])(transformedEdgesSelection.directives), [streamDirective]) : transformedEdgesSelection.directives,
481
- selections: [].concat((0, _toConsumableArray2["default"])(transformedEdgesSelection.selections), [{
482
- directives: [],
483
- kind: 'InlineFragment',
484
- loc: derivedFieldLocation,
485
- metadata: null,
486
- selections: edgeFragment.selections,
487
- typeCondition: edgeFragment.type
488
- }])
489
- }); // Copy the original selections, replacing edges/pageInfo (if present)
490
- // with the generated locations. This is to maintain the original field
491
- // ordering.
492
-
493
- var selections = field.selections.map(function (selection) {
494
- if (transformedEdgesSelection != null && edgesSelection != null && selection === edgesSelection) {
495
- return transformedEdgesSelection;
496
- } else if (transformedPageInfoSelection != null && pageInfoSelection != null && selection === pageInfoSelection) {
497
- return transformedPageInfoSelection;
498
- } else {
499
- return selection;
500
- }
501
- }); // If edges/pageInfo were missing, append the generated versions instead.
502
-
503
- if (edgesSelection == null && transformedEdgesSelection != null) {
504
- selections.push(transformedEdgesSelection);
505
- }
506
-
507
- if (pageInfoSelection == null && transformedPageInfoSelection != null) {
508
- selections.push(transformedPageInfoSelection);
509
- }
510
-
511
- return selections;
512
- }
513
-
514
- function findArg(field, argName) {
515
- return field.args && field.args.find(function (arg) {
516
- return arg.name === argName;
517
- });
518
- }
519
- /**
520
- * @internal
521
- *
522
- * Validates that the selection is a valid connection:
523
- * - Specifies a first or last argument to prevent accidental, unconstrained
524
- * data access.
525
- * - Has an `edges` selection, otherwise there is nothing to paginate.
526
- *
527
- * TODO: This implementation requires the edges field to be a direct selection
528
- * and not contained within an inline fragment or fragment spread. It's
529
- * technically possible to remove this restriction if this pattern becomes
530
- * common/necessary.
531
- */
532
-
533
-
534
- function validateConnectionSelection(field) {
535
- var _ConnectionInterface$2 = ConnectionInterface.get(),
536
- EDGES = _ConnectionInterface$2.EDGES;
537
-
538
- if (!findArg(field, FIRST) && !findArg(field, LAST)) {
539
- throw createUserError("Expected field '".concat(field.name, "' to have a '").concat(FIRST, "' or '").concat(LAST, "' ") + 'argument.', [field.loc]);
540
- }
541
-
542
- if (!field.selections.some(function (selection) {
543
- return selection.kind === 'LinkedField' && selection.name === EDGES;
544
- })) {
545
- throw createUserError("Expected field '".concat(field.name, "' to have an '").concat(EDGES, "' selection."), [field.loc]);
546
- }
547
- }
548
- /**
549
- * @internal
550
- *
551
- * Validates that the type satisfies the Connection specification:
552
- * - The type has an edges field, and edges have scalar `cursor` and object
553
- * `node` fields.
554
- * - The type has a page info field which is an object with the correct
555
- * subfields.
556
- */
557
-
558
-
559
- function validateConnectionType(schema, field, nullableType, connectionDirective) {
560
- var directiveName = connectionDirective.name;
561
-
562
- var _ConnectionInterface$3 = ConnectionInterface.get(),
563
- CURSOR = _ConnectionInterface$3.CURSOR,
564
- EDGES = _ConnectionInterface$3.EDGES,
565
- END_CURSOR = _ConnectionInterface$3.END_CURSOR,
566
- HAS_NEXT_PAGE = _ConnectionInterface$3.HAS_NEXT_PAGE,
567
- HAS_PREV_PAGE = _ConnectionInterface$3.HAS_PREV_PAGE,
568
- NODE = _ConnectionInterface$3.NODE,
569
- PAGE_INFO = _ConnectionInterface$3.PAGE_INFO,
570
- START_CURSOR = _ConnectionInterface$3.START_CURSOR;
571
-
572
- var typeName = schema.getTypeString(nullableType);
573
-
574
- if (!schema.hasField(nullableType, EDGES)) {
575
- throw createUserError("@".concat(directiveName, " used on invalid field '").concat(field.name, "'. Expected the ") + "field type '".concat(typeName, "' to have an '").concat(EDGES, "' field"), [field.loc]);
576
- }
577
-
578
- var edges = schema.getFieldConfig(schema.expectField(nullableType, EDGES));
579
- var edgesType = schema.getNullableType(edges.type);
580
-
581
- if (!schema.isList(edgesType)) {
582
- throw createUserError("@".concat(directiveName, " used on invalid field '").concat(field.name, "'. Expected the ") + "field type '".concat(typeName, "' to have an '").concat(EDGES, "' field that returns ") + 'a list of objects.', [field.loc]);
583
- }
584
-
585
- var edgeType = schema.getNullableType(schema.getListItemType(edgesType));
586
-
587
- if (!schema.isObject(edgeType) && !schema.isInterface(edgeType)) {
588
- throw createUserError("@".concat(directiveName, " used on invalid field '").concat(field.name, "'. Expected the ") + "field type '".concat(typeName, "' to have an '").concat(EDGES, "' field that returns ") + 'a list of objects.', [field.loc]);
589
- }
590
-
591
- edgeType = schema.assertCompositeType(edgeType);
592
-
593
- if (!schema.hasField(edgeType, NODE)) {
594
- throw createUserError("@".concat(directiveName, " used on invalid field '").concat(field.name, "'. Expected the ") + "field type '".concat(typeName, "' to have an '").concat(EDGES, " { ").concat(NODE, " }' field ") + 'that returns an object, interface, or union.', [field.loc]);
595
- }
596
-
597
- var node = schema.getFieldConfig(schema.expectField(edgeType, NODE));
598
- var nodeType = schema.getNullableType(node.type);
599
-
600
- if (!(schema.isAbstractType(nodeType) || schema.isObject(nodeType))) {
601
- throw createUserError("@".concat(directiveName, " used on invalid field '").concat(field.name, "'. Expected the ") + "field type '".concat(typeName, "' to have an '").concat(EDGES, " { ").concat(NODE, " }' field ") + 'that returns an object, interface, or union.', [field.loc]);
602
- }
603
-
604
- if (!schema.hasField(edgeType, CURSOR)) {
605
- throw createUserError("@".concat(directiveName, " used on invalid field '").concat(field.name, "'. Expected the ") + "field type '".concat(typeName, "' to have an '").concat(EDGES, " { ").concat(CURSOR, " }' field ") + 'that returns a scalar value.', [field.loc]);
606
- }
607
-
608
- var cursor = schema.getFieldConfig(schema.expectField(edgeType, CURSOR));
609
-
610
- if (!schema.isScalar(schema.getNullableType(cursor.type))) {
611
- throw createUserError("@".concat(directiveName, " used on invalid field '").concat(field.name, "'. Expected the ") + "field type '".concat(typeName, "' to have an '").concat(EDGES, " { ").concat(CURSOR, " }' field ") + 'that returns a scalar value.', [field.loc]);
612
- }
613
-
614
- if (!schema.hasField(nullableType, PAGE_INFO)) {
615
- throw createUserError("@".concat(directiveName, " used on invalid field '").concat(field.name, "'. Expected the ") + "field type '".concat(typeName, "' to have a '").concat(PAGE_INFO, "' field that returns ") + 'an object.', [field.loc]);
616
- }
617
-
618
- var pageInfo = schema.getFieldConfig(schema.expectField(nullableType, PAGE_INFO));
619
- var pageInfoType = schema.getNullableType(pageInfo.type);
620
-
621
- if (!schema.isObject(pageInfoType)) {
622
- throw createUserError("@".concat(directiveName, " used on invalid field '").concat(field.name, "'. Expected the ") + "field type '".concat(typeName, "' to have a '").concat(PAGE_INFO, "' field that ") + 'returns an object.', [field.loc]);
623
- }
624
-
625
- [END_CURSOR, HAS_NEXT_PAGE, HAS_PREV_PAGE, START_CURSOR].forEach(function (fieldName) {
626
- var pageInfoField = schema.getFieldConfig(schema.expectField(schema.assertObjectType(pageInfoType), fieldName));
627
-
628
- if (!schema.isScalar(schema.getNullableType(pageInfoField.type))) {
629
- throw createUserError("@".concat(directiveName, " used on invalid field '").concat(field.name, "'. Expected ") + "the field type '".concat(typeName, "' to have a '").concat(PAGE_INFO, " { ").concat(fieldName, " }' ") + 'field returns a scalar.', [field.loc]);
630
- }
631
- });
632
- }
633
-
634
- module.exports = {
635
- buildConnectionMetadata: buildConnectionMetadata,
636
- CONNECTION: CONNECTION,
637
- SCHEMA_EXTENSION: SCHEMA_EXTENSION,
638
- transform: connectionTransform
639
- };