relay-runtime 10.0.1 → 10.1.3

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 (82) hide show
  1. package/handlers/RelayDefaultHandlerProvider.js.flow +6 -0
  2. package/handlers/connection/MutationHandlers.js.flow +152 -20
  3. package/index.js +1 -1
  4. package/index.js.flow +17 -1
  5. package/lib/handlers/RelayDefaultHandlerProvider.js +9 -0
  6. package/lib/handlers/connection/MutationHandlers.js +185 -21
  7. package/lib/index.js +7 -0
  8. package/lib/mutations/RelayDeclarativeMutationConfig.js +5 -7
  9. package/lib/mutations/commitMutation.js +1 -4
  10. package/lib/mutations/validateMutation.js +28 -12
  11. package/lib/network/RelayQueryResponseCache.js +3 -7
  12. package/lib/query/GraphQLTag.js +2 -1
  13. package/lib/query/fetchQuery.js +2 -3
  14. package/lib/query/fetchQueryInternal.js +2 -3
  15. package/lib/store/DataChecker.js +85 -10
  16. package/lib/store/RelayConcreteVariables.js +2 -6
  17. package/lib/store/RelayModernEnvironment.js +81 -72
  18. package/lib/store/RelayModernFragmentSpecResolver.js +14 -7
  19. package/lib/store/RelayModernOperationDescriptor.js +6 -5
  20. package/lib/store/RelayModernQueryExecutor.js +46 -33
  21. package/lib/store/RelayModernRecord.js +3 -7
  22. package/lib/store/RelayModernStore.js +39 -137
  23. package/lib/store/RelayOperationTracker.js +7 -9
  24. package/lib/store/RelayOptimisticRecordSource.js +2 -6
  25. package/lib/store/RelayPublishQueue.js +1 -1
  26. package/lib/store/RelayReader.js +196 -33
  27. package/lib/store/RelayRecordSourceMapImpl.js +3 -5
  28. package/lib/store/RelayReferenceMarker.js +87 -5
  29. package/lib/store/RelayResponseNormalizer.js +115 -19
  30. package/lib/store/RelayStoreReactFlightUtils.js +47 -0
  31. package/lib/store/RelayStoreSubscriptions.js +162 -0
  32. package/lib/store/RelayStoreSubscriptionsUsingMapByID.js +258 -0
  33. package/lib/store/StoreInspector.js +2 -6
  34. package/lib/store/createRelayContext.js +5 -0
  35. package/lib/store/defaultRequiredFieldLogger.js +18 -0
  36. package/lib/store/normalizeRelayPayload.js +2 -6
  37. package/lib/subscription/requestSubscription.js +2 -3
  38. package/lib/util/NormalizationNode.js +1 -5
  39. package/lib/util/RelayConcreteNode.js +2 -0
  40. package/lib/util/RelayFeatureFlags.js +7 -2
  41. package/lib/util/createPayloadFor3DField.js +2 -7
  42. package/lib/util/getFragmentIdentifier.js +12 -3
  43. package/lib/util/getOperation.js +33 -0
  44. package/lib/util/isEmptyObject.js +25 -0
  45. package/lib/util/recycleNodesInto.js +4 -1
  46. package/lib/util/reportMissingRequiredFields.js +48 -0
  47. package/mutations/commitMutation.js.flow +1 -2
  48. package/mutations/validateMutation.js.flow +34 -5
  49. package/network/RelayNetworkTypes.js.flow +22 -0
  50. package/package.json +2 -2
  51. package/query/GraphQLTag.js.flow +3 -1
  52. package/query/fetchQuery.js.flow +2 -2
  53. package/query/fetchQueryInternal.js.flow +0 -5
  54. package/relay-runtime.js +2 -2
  55. package/relay-runtime.min.js +2 -2
  56. package/store/DataChecker.js.flow +68 -2
  57. package/store/RelayModernEnvironment.js.flow +107 -87
  58. package/store/RelayModernFragmentSpecResolver.js.flow +13 -1
  59. package/store/RelayModernOperationDescriptor.js.flow +5 -1
  60. package/store/RelayModernQueryExecutor.js.flow +47 -23
  61. package/store/RelayModernStore.js.flow +33 -107
  62. package/store/RelayPublishQueue.js.flow +1 -1
  63. package/store/RelayReader.js.flow +180 -15
  64. package/store/RelayReferenceMarker.js.flow +72 -5
  65. package/store/RelayResponseNormalizer.js.flow +130 -19
  66. package/store/RelayStoreReactFlightUtils.js.flow +64 -0
  67. package/store/RelayStoreSubscriptions.js.flow +168 -0
  68. package/store/RelayStoreSubscriptionsUsingMapByID.js.flow +259 -0
  69. package/store/RelayStoreTypes.js.flow +130 -37
  70. package/store/createRelayContext.js.flow +3 -0
  71. package/store/defaultRequiredFieldLogger.js.flow +23 -0
  72. package/subscription/requestSubscription.js.flow +5 -2
  73. package/util/NormalizationNode.js.flow +17 -2
  74. package/util/ReaderNode.js.flow +20 -1
  75. package/util/RelayConcreteNode.js.flow +6 -0
  76. package/util/RelayFeatureFlags.js.flow +12 -1
  77. package/util/getFragmentIdentifier.js.flow +33 -9
  78. package/util/getOperation.js.flow +40 -0
  79. package/util/getRequestIdentifier.js.flow +1 -1
  80. package/util/isEmptyObject.js.flow +25 -0
  81. package/util/recycleNodesInto.js.flow +11 -0
  82. package/util/reportMissingRequiredFields.js.flow +51 -0
@@ -26,10 +26,16 @@ function RelayDefaultHandlerProvider(handle: string): Handler {
26
26
  return ConnectionHandler;
27
27
  case 'deleteRecord':
28
28
  return MutationHandlers.DeleteRecordHandler;
29
+ case 'deleteEdge':
30
+ return MutationHandlers.DeleteEdgeHandler;
29
31
  case 'appendEdge':
30
32
  return MutationHandlers.AppendEdgeHandler;
31
33
  case 'prependEdge':
32
34
  return MutationHandlers.PrependEdgeHandler;
35
+ case 'appendNode':
36
+ return MutationHandlers.AppendNodeHandler;
37
+ case 'prependNode':
38
+ return MutationHandlers.PrependNodeHandler;
33
39
  }
34
40
  invariant(
35
41
  false,
@@ -27,15 +27,54 @@ import type {
27
27
  const DeleteRecordHandler = {
28
28
  update: (store: RecordSourceProxy, payload: HandleFieldPayload) => {
29
29
  const record = store.get(payload.dataID);
30
+
30
31
  if (record != null) {
31
- const id = record.getValue(payload.fieldKey);
32
- if (typeof id === 'string') {
33
- store.delete(id);
32
+ const idOrIds = record.getValue(payload.fieldKey);
33
+
34
+ if (typeof idOrIds === 'string') {
35
+ store.delete(idOrIds);
36
+ } else if (Array.isArray(idOrIds)) {
37
+ idOrIds.forEach(id => {
38
+ if (typeof id === 'string') {
39
+ store.delete(id);
40
+ }
41
+ });
34
42
  }
35
43
  }
36
44
  },
37
45
  };
38
46
 
47
+ const DeleteEdgeHandler = {
48
+ update: (store: RecordSourceProxy, payload: HandleFieldPayload) => {
49
+ const record = store.get(payload.dataID);
50
+ if (record == null) {
51
+ return;
52
+ }
53
+ const {connections} = payload.handleArgs;
54
+ invariant(
55
+ connections != null,
56
+ 'MutationHandlers: Expected connection IDs to be specified.',
57
+ );
58
+ const idOrIds = record.getValue(payload.fieldKey);
59
+ const idList = Array.isArray(idOrIds) ? idOrIds : [idOrIds];
60
+ idList.forEach(id => {
61
+ if (typeof id === 'string') {
62
+ for (const connectionID of connections) {
63
+ const connection = store.get(connectionID);
64
+ if (connection == null) {
65
+ warning(
66
+ false,
67
+ `[Relay][Mutation] The connection with id '${connectionID}' doesn't exist.`,
68
+ );
69
+ continue;
70
+ }
71
+ ConnectionHandler.deleteNode(connection, id);
72
+ }
73
+ }
74
+ });
75
+ },
76
+ };
77
+
39
78
  const AppendEdgeHandler: Handler = {
40
79
  update: edgeUpdater(ConnectionHandler.insertEdgeAfter),
41
80
  };
@@ -44,6 +83,14 @@ const PrependEdgeHandler: Handler = {
44
83
  update: edgeUpdater(ConnectionHandler.insertEdgeBefore),
45
84
  };
46
85
 
86
+ const AppendNodeHandler: Handler = {
87
+ update: nodeUpdater(ConnectionHandler.insertEdgeAfter),
88
+ };
89
+
90
+ const PrependNodeHandler: Handler = {
91
+ update: nodeUpdater(ConnectionHandler.insertEdgeBefore),
92
+ };
93
+
47
94
  function edgeUpdater(
48
95
  insertFn: (RecordProxy, RecordProxy, ?string) => void,
49
96
  ): (RecordSourceProxy, HandleFieldPayload) => void {
@@ -57,26 +104,108 @@ function edgeUpdater(
57
104
  connections != null,
58
105
  'MutationHandlers: Expected connection IDs to be specified.',
59
106
  );
60
- const serverEdge = record.getLinkedRecord(payload.fieldKey, payload.args);
61
- for (const connectionID of connections) {
62
- const connection = store.get(connectionID);
63
- if (connection == null) {
64
- warning(
65
- false,
66
- `[Relay][Mutation] The connection with id '${connectionID}' doesn't exist.`,
107
+ let singleServerEdge, serverEdges;
108
+ try {
109
+ singleServerEdge = record.getLinkedRecord(payload.fieldKey, payload.args);
110
+ } catch {}
111
+ if (!singleServerEdge) {
112
+ try {
113
+ serverEdges = record.getLinkedRecords(payload.fieldKey, payload.args);
114
+ } catch {}
115
+ }
116
+ if (singleServerEdge == null && serverEdges == null) {
117
+ warning(
118
+ false,
119
+ 'MutationHandlers: Expected the server edge to be non-null.',
120
+ );
121
+ return;
122
+ }
123
+ const serverEdgeList = serverEdges ?? [singleServerEdge];
124
+ for (const serverEdge of serverEdgeList) {
125
+ if (serverEdge == null) {
126
+ continue;
127
+ }
128
+ for (const connectionID of connections) {
129
+ const connection = store.get(connectionID);
130
+ if (connection == null) {
131
+ warning(
132
+ false,
133
+ `[Relay][Mutation] The connection with id '${connectionID}' doesn't exist.`,
134
+ );
135
+ continue;
136
+ }
137
+ const clientEdge = ConnectionHandler.buildConnectionEdge(
138
+ store,
139
+ connection,
140
+ serverEdge,
67
141
  );
142
+ invariant(
143
+ clientEdge != null,
144
+ 'MutationHandlers: Failed to build the edge.',
145
+ );
146
+ insertFn(connection, clientEdge);
147
+ }
148
+ }
149
+ };
150
+ }
151
+
152
+ function nodeUpdater(
153
+ insertFn: (RecordProxy, RecordProxy, ?string) => void,
154
+ ): (RecordSourceProxy, HandleFieldPayload) => void {
155
+ return (store: RecordSourceProxy, payload: HandleFieldPayload) => {
156
+ const record = store.get(payload.dataID);
157
+ if (record == null) {
158
+ return;
159
+ }
160
+ const {connections, edgeTypeName} = payload.handleArgs;
161
+ invariant(
162
+ connections != null,
163
+ 'MutationHandlers: Expected connection IDs to be specified.',
164
+ );
165
+ invariant(
166
+ edgeTypeName != null,
167
+ 'MutationHandlers: Expected edge typename to be specified.',
168
+ );
169
+ let singleServerNode;
170
+ let serverNodes;
171
+ try {
172
+ singleServerNode = record.getLinkedRecord(payload.fieldKey, payload.args);
173
+ } catch {}
174
+ if (!singleServerNode) {
175
+ try {
176
+ serverNodes = record.getLinkedRecords(payload.fieldKey, payload.args);
177
+ } catch {}
178
+ }
179
+ if (singleServerNode == null && serverNodes == null) {
180
+ warning(false, 'MutationHandlers: Expected target node to exist.');
181
+ return;
182
+ }
183
+ const serverNodeList = serverNodes ?? [singleServerNode];
184
+ for (const serverNode of serverNodeList) {
185
+ if (serverNode == null) {
68
186
  continue;
69
187
  }
70
- const clientEdge = ConnectionHandler.buildConnectionEdge(
71
- store,
72
- connection,
73
- serverEdge,
74
- );
75
- invariant(
76
- clientEdge != null,
77
- 'MutationHandlers: Failed to build the edge.',
78
- );
79
- insertFn(connection, clientEdge);
188
+ for (const connectionID of connections) {
189
+ const connection = store.get(connectionID);
190
+ if (connection == null) {
191
+ warning(
192
+ false,
193
+ `[Relay][Mutation] The connection with id '${connectionID}' doesn't exist.`,
194
+ );
195
+ continue;
196
+ }
197
+ const clientEdge = ConnectionHandler.createEdge(
198
+ store,
199
+ connection,
200
+ serverNode,
201
+ edgeTypeName,
202
+ );
203
+ invariant(
204
+ clientEdge != null,
205
+ 'MutationHandlers: Failed to build the edge.',
206
+ );
207
+ insertFn(connection, clientEdge);
208
+ }
80
209
  }
81
210
  };
82
211
  }
@@ -85,4 +214,7 @@ module.exports = {
85
214
  AppendEdgeHandler,
86
215
  DeleteRecordHandler,
87
216
  PrependEdgeHandler,
217
+ AppendNodeHandler,
218
+ PrependNodeHandler,
219
+ DeleteEdgeHandler,
88
220
  };
package/index.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * Relay v10.0.1
2
+ * Relay v10.1.3
3
3
  *
4
4
  * Copyright (c) Facebook, Inc. and its affiliates.
5
5
  *
package/index.js.flow CHANGED
@@ -56,6 +56,7 @@ const isRelayModernEnvironment = require('./store/isRelayModernEnvironment');
56
56
  const isScalarAndEqual = require('./util/isScalarAndEqual');
57
57
  const readInlineData = require('./store/readInlineData');
58
58
  const recycleNodesInto = require('./util/recycleNodesInto');
59
+ const reportMissingRequiredFields = require('./util/reportMissingRequiredFields');
59
60
  const requestSubscription = require('./subscription/requestSubscription');
60
61
  const stableCopy = require('./util/stableCopy');
61
62
 
@@ -93,6 +94,9 @@ export type {
93
94
  LogRequestInfoFunction,
94
95
  PayloadData,
95
96
  PayloadError,
97
+ ReactFlightPayloadData,
98
+ ReactFlightPayloadQuery,
99
+ ReactFlightServerTree,
96
100
  SubscribeFunction,
97
101
  Uploadable,
98
102
  UploadableMap,
@@ -109,7 +113,6 @@ export type {TaskScheduler} from './store/RelayModernQueryExecutor';
109
113
  export type {RecordState} from './store/RelayRecordState';
110
114
  export type {
111
115
  FragmentMap,
112
- FragmentPointer,
113
116
  FragmentReference,
114
117
  FragmentSpecResolver,
115
118
  HandleFieldPayload,
@@ -118,6 +121,7 @@ export type {
118
121
  LogEvent,
119
122
  LogFunction,
120
123
  MissingFieldHandler,
124
+ MissingRequiredFields,
121
125
  ModuleImportPointer,
122
126
  NormalizationSelector,
123
127
  OperationAvailability,
@@ -130,6 +134,8 @@ export type {
130
134
  PluralReaderSelector,
131
135
  Props,
132
136
  PublishQueue,
137
+ ReactFlightPayloadDeserializer,
138
+ ReactFlightClientResponse,
133
139
  ReaderSelector,
134
140
  ReadOnlyRecordProxy,
135
141
  RecordProxy,
@@ -149,6 +155,7 @@ export type {
149
155
  NormalizationArgument,
150
156
  NormalizationDefer,
151
157
  NormalizationField,
158
+ NormalizationFlightField,
152
159
  NormalizationLinkedField,
153
160
  NormalizationLinkedHandle,
154
161
  NormalizationLocalArgumentDefinition,
@@ -164,6 +171,7 @@ export type {
164
171
  ReaderArgument,
165
172
  ReaderArgumentDefinition,
166
173
  ReaderField,
174
+ ReaderFlightField,
167
175
  ReaderFragment,
168
176
  ReaderInlineDataFragment,
169
177
  ReaderInlineDataFragmentSpread,
@@ -172,8 +180,10 @@ export type {
172
180
  ReaderPaginationMetadata,
173
181
  ReaderRefetchableFragment,
174
182
  ReaderRefetchMetadata,
183
+ ReaderRequiredField,
175
184
  ReaderScalarField,
176
185
  ReaderSelection,
186
+ RequiredFieldAction,
177
187
  } from './util/ReaderNode';
178
188
  export type {
179
189
  ConcreteRequest,
@@ -192,6 +202,7 @@ export type {
192
202
  VariablesOf,
193
203
  } from './util/RelayRuntimeTypes';
194
204
  export type {Local3DPayload} from './util/createPayloadFor3DField';
205
+ export type {RequestIdentifier} from './util/getRequestIdentifier';
195
206
 
196
207
  // As early as possible, check for the existence of the JavaScript globals which
197
208
  // Relay Runtime relies upon, and produce a clear message if they do not exist.
@@ -234,6 +245,7 @@ module.exports = {
234
245
  RelayModernOperationDescriptor.createRequestDescriptor,
235
246
  getDataIDsFromFragment: RelayModernSelector.getDataIDsFromFragment,
236
247
  getDataIDsFromObject: RelayModernSelector.getDataIDsFromObject,
248
+ getNode: GraphQLTag.getNode,
237
249
  getFragment: GraphQLTag.getFragment,
238
250
  getInlineDataFragment: GraphQLTag.getInlineDataFragment,
239
251
  getModuleComponentKey: RelayStoreUtils.getModuleComponentKey,
@@ -253,7 +265,11 @@ module.exports = {
253
265
  RelayModernSelector.getVariablesFromPluralFragment,
254
266
  getVariablesFromSingularFragment:
255
267
  RelayModernSelector.getVariablesFromSingularFragment,
268
+ reportMissingRequiredFields,
256
269
  graphql: GraphQLTag.graphql,
270
+ isFragment: GraphQLTag.isFragment,
271
+ isInlineDataFragment: GraphQLTag.isInlineDataFragment,
272
+ isRequest: GraphQLTag.isRequest,
257
273
  readInlineData,
258
274
 
259
275
  // Declarative mutation API
@@ -24,11 +24,20 @@ function RelayDefaultHandlerProvider(handle) {
24
24
  case 'deleteRecord':
25
25
  return MutationHandlers.DeleteRecordHandler;
26
26
 
27
+ case 'deleteEdge':
28
+ return MutationHandlers.DeleteEdgeHandler;
29
+
27
30
  case 'appendEdge':
28
31
  return MutationHandlers.AppendEdgeHandler;
29
32
 
30
33
  case 'prependEdge':
31
34
  return MutationHandlers.PrependEdgeHandler;
35
+
36
+ case 'appendNode':
37
+ return MutationHandlers.AppendNodeHandler;
38
+
39
+ case 'prependNode':
40
+ return MutationHandlers.PrependNodeHandler;
32
41
  }
33
42
 
34
43
  !false ? process.env.NODE_ENV !== "production" ? invariant(false, 'RelayDefaultHandlerProvider: No handler provided for `%s`.', handle) : invariant(false) : void 0;
@@ -10,11 +10,9 @@
10
10
  // flowlint ambiguous-object-type:error
11
11
  'use strict';
12
12
 
13
- function _createForOfIteratorHelper(o) { if (typeof Symbol === "undefined" || o[Symbol.iterator] == null) { if (Array.isArray(o) || (o = _unsupportedIterableToArray(o))) { var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var it, normalCompletion = true, didErr = false, err; return { s: function s() { it = o[Symbol.iterator](); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it["return"] != null) it["return"](); } finally { if (didErr) throw err; } } }; }
13
+ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
14
14
 
15
- function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(n); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
16
-
17
- function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
15
+ var _createForOfIteratorHelper2 = _interopRequireDefault(require("@babel/runtime/helpers/createForOfIteratorHelper"));
18
16
 
19
17
  var ConnectionHandler = require('./ConnectionHandler');
20
18
 
@@ -27,12 +25,56 @@ var DeleteRecordHandler = {
27
25
  var record = store.get(payload.dataID);
28
26
 
29
27
  if (record != null) {
30
- var id = record.getValue(payload.fieldKey);
28
+ var idOrIds = record.getValue(payload.fieldKey);
29
+
30
+ if (typeof idOrIds === 'string') {
31
+ store["delete"](idOrIds);
32
+ } else if (Array.isArray(idOrIds)) {
33
+ idOrIds.forEach(function (id) {
34
+ if (typeof id === 'string') {
35
+ store["delete"](id);
36
+ }
37
+ });
38
+ }
39
+ }
40
+ }
41
+ };
42
+ var DeleteEdgeHandler = {
43
+ update: function update(store, payload) {
44
+ var record = store.get(payload.dataID);
31
45
 
46
+ if (record == null) {
47
+ return;
48
+ }
49
+
50
+ var connections = payload.handleArgs.connections;
51
+ !(connections != null) ? process.env.NODE_ENV !== "production" ? invariant(false, 'MutationHandlers: Expected connection IDs to be specified.') : invariant(false) : void 0;
52
+ var idOrIds = record.getValue(payload.fieldKey);
53
+ var idList = Array.isArray(idOrIds) ? idOrIds : [idOrIds];
54
+ idList.forEach(function (id) {
32
55
  if (typeof id === 'string') {
33
- store["delete"](id);
56
+ var _iterator = (0, _createForOfIteratorHelper2["default"])(connections),
57
+ _step;
58
+
59
+ try {
60
+ for (_iterator.s(); !(_step = _iterator.n()).done;) {
61
+ var connectionID = _step.value;
62
+ var connection = store.get(connectionID);
63
+
64
+ if (connection == null) {
65
+ process.env.NODE_ENV !== "production" ? warning(false, "[Relay][Mutation] The connection with id '".concat(connectionID, "' doesn't exist.")) : void 0;
66
+ continue;
67
+ }
68
+
69
+ ConnectionHandler.deleteNode(connection, id);
70
+ }
71
+ } catch (err) {
72
+ _iterator.e(err);
73
+ } finally {
74
+ _iterator.f();
75
+ }
34
76
  }
35
- }
77
+ });
36
78
  }
37
79
  };
38
80
  var AppendEdgeHandler = {
@@ -41,9 +83,17 @@ var AppendEdgeHandler = {
41
83
  var PrependEdgeHandler = {
42
84
  update: edgeUpdater(ConnectionHandler.insertEdgeBefore)
43
85
  };
86
+ var AppendNodeHandler = {
87
+ update: nodeUpdater(ConnectionHandler.insertEdgeAfter)
88
+ };
89
+ var PrependNodeHandler = {
90
+ update: nodeUpdater(ConnectionHandler.insertEdgeBefore)
91
+ };
44
92
 
45
93
  function edgeUpdater(insertFn) {
46
94
  return function (store, payload) {
95
+ var _serverEdges;
96
+
47
97
  var record = store.get(payload.dataID);
48
98
 
49
99
  if (record == null) {
@@ -52,29 +102,140 @@ function edgeUpdater(insertFn) {
52
102
 
53
103
  var connections = payload.handleArgs.connections;
54
104
  !(connections != null) ? process.env.NODE_ENV !== "production" ? invariant(false, 'MutationHandlers: Expected connection IDs to be specified.') : invariant(false) : void 0;
55
- var serverEdge = record.getLinkedRecord(payload.fieldKey, payload.args);
105
+ var singleServerEdge, serverEdges;
106
+
107
+ try {
108
+ singleServerEdge = record.getLinkedRecord(payload.fieldKey, payload.args);
109
+ } catch (_unused) {}
56
110
 
57
- var _iterator = _createForOfIteratorHelper(connections),
58
- _step;
111
+ if (!singleServerEdge) {
112
+ try {
113
+ serverEdges = record.getLinkedRecords(payload.fieldKey, payload.args);
114
+ } catch (_unused2) {}
115
+ }
116
+
117
+ if (singleServerEdge == null && serverEdges == null) {
118
+ process.env.NODE_ENV !== "production" ? warning(false, 'MutationHandlers: Expected the server edge to be non-null.') : void 0;
119
+ return;
120
+ }
121
+
122
+ var serverEdgeList = (_serverEdges = serverEdges) !== null && _serverEdges !== void 0 ? _serverEdges : [singleServerEdge];
123
+
124
+ var _iterator2 = (0, _createForOfIteratorHelper2["default"])(serverEdgeList),
125
+ _step2;
59
126
 
60
127
  try {
61
- for (_iterator.s(); !(_step = _iterator.n()).done;) {
62
- var connectionID = _step.value;
63
- var connection = store.get(connectionID);
128
+ for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
129
+ var serverEdge = _step2.value;
64
130
 
65
- if (connection == null) {
66
- process.env.NODE_ENV !== "production" ? warning(false, "[Relay][Mutation] The connection with id '".concat(connectionID, "' doesn't exist.")) : void 0;
131
+ if (serverEdge == null) {
67
132
  continue;
68
133
  }
69
134
 
70
- var clientEdge = ConnectionHandler.buildConnectionEdge(store, connection, serverEdge);
71
- !(clientEdge != null) ? process.env.NODE_ENV !== "production" ? invariant(false, 'MutationHandlers: Failed to build the edge.') : invariant(false) : void 0;
72
- insertFn(connection, clientEdge);
135
+ var _iterator3 = (0, _createForOfIteratorHelper2["default"])(connections),
136
+ _step3;
137
+
138
+ try {
139
+ for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
140
+ var connectionID = _step3.value;
141
+ var connection = store.get(connectionID);
142
+
143
+ if (connection == null) {
144
+ process.env.NODE_ENV !== "production" ? warning(false, "[Relay][Mutation] The connection with id '".concat(connectionID, "' doesn't exist.")) : void 0;
145
+ continue;
146
+ }
147
+
148
+ var clientEdge = ConnectionHandler.buildConnectionEdge(store, connection, serverEdge);
149
+ !(clientEdge != null) ? process.env.NODE_ENV !== "production" ? invariant(false, 'MutationHandlers: Failed to build the edge.') : invariant(false) : void 0;
150
+ insertFn(connection, clientEdge);
151
+ }
152
+ } catch (err) {
153
+ _iterator3.e(err);
154
+ } finally {
155
+ _iterator3.f();
156
+ }
157
+ }
158
+ } catch (err) {
159
+ _iterator2.e(err);
160
+ } finally {
161
+ _iterator2.f();
162
+ }
163
+ };
164
+ }
165
+
166
+ function nodeUpdater(insertFn) {
167
+ return function (store, payload) {
168
+ var _serverNodes;
169
+
170
+ var record = store.get(payload.dataID);
171
+
172
+ if (record == null) {
173
+ return;
174
+ }
175
+
176
+ var _payload$handleArgs = payload.handleArgs,
177
+ connections = _payload$handleArgs.connections,
178
+ edgeTypeName = _payload$handleArgs.edgeTypeName;
179
+ !(connections != null) ? process.env.NODE_ENV !== "production" ? invariant(false, 'MutationHandlers: Expected connection IDs to be specified.') : invariant(false) : void 0;
180
+ !(edgeTypeName != null) ? process.env.NODE_ENV !== "production" ? invariant(false, 'MutationHandlers: Expected edge typename to be specified.') : invariant(false) : void 0;
181
+ var singleServerNode;
182
+ var serverNodes;
183
+
184
+ try {
185
+ singleServerNode = record.getLinkedRecord(payload.fieldKey, payload.args);
186
+ } catch (_unused3) {}
187
+
188
+ if (!singleServerNode) {
189
+ try {
190
+ serverNodes = record.getLinkedRecords(payload.fieldKey, payload.args);
191
+ } catch (_unused4) {}
192
+ }
193
+
194
+ if (singleServerNode == null && serverNodes == null) {
195
+ process.env.NODE_ENV !== "production" ? warning(false, 'MutationHandlers: Expected target node to exist.') : void 0;
196
+ return;
197
+ }
198
+
199
+ var serverNodeList = (_serverNodes = serverNodes) !== null && _serverNodes !== void 0 ? _serverNodes : [singleServerNode];
200
+
201
+ var _iterator4 = (0, _createForOfIteratorHelper2["default"])(serverNodeList),
202
+ _step4;
203
+
204
+ try {
205
+ for (_iterator4.s(); !(_step4 = _iterator4.n()).done;) {
206
+ var serverNode = _step4.value;
207
+
208
+ if (serverNode == null) {
209
+ continue;
210
+ }
211
+
212
+ var _iterator5 = (0, _createForOfIteratorHelper2["default"])(connections),
213
+ _step5;
214
+
215
+ try {
216
+ for (_iterator5.s(); !(_step5 = _iterator5.n()).done;) {
217
+ var connectionID = _step5.value;
218
+ var connection = store.get(connectionID);
219
+
220
+ if (connection == null) {
221
+ process.env.NODE_ENV !== "production" ? warning(false, "[Relay][Mutation] The connection with id '".concat(connectionID, "' doesn't exist.")) : void 0;
222
+ continue;
223
+ }
224
+
225
+ var clientEdge = ConnectionHandler.createEdge(store, connection, serverNode, edgeTypeName);
226
+ !(clientEdge != null) ? process.env.NODE_ENV !== "production" ? invariant(false, 'MutationHandlers: Failed to build the edge.') : invariant(false) : void 0;
227
+ insertFn(connection, clientEdge);
228
+ }
229
+ } catch (err) {
230
+ _iterator5.e(err);
231
+ } finally {
232
+ _iterator5.f();
233
+ }
73
234
  }
74
235
  } catch (err) {
75
- _iterator.e(err);
236
+ _iterator4.e(err);
76
237
  } finally {
77
- _iterator.f();
238
+ _iterator4.f();
78
239
  }
79
240
  };
80
241
  }
@@ -82,5 +243,8 @@ function edgeUpdater(insertFn) {
82
243
  module.exports = {
83
244
  AppendEdgeHandler: AppendEdgeHandler,
84
245
  DeleteRecordHandler: DeleteRecordHandler,
85
- PrependEdgeHandler: PrependEdgeHandler
246
+ PrependEdgeHandler: PrependEdgeHandler,
247
+ AppendNodeHandler: AppendNodeHandler,
248
+ PrependNodeHandler: PrependNodeHandler,
249
+ DeleteEdgeHandler: DeleteEdgeHandler
86
250
  };
package/lib/index.js CHANGED
@@ -96,6 +96,8 @@ var readInlineData = require('./store/readInlineData');
96
96
 
97
97
  var recycleNodesInto = require('./util/recycleNodesInto');
98
98
 
99
+ var reportMissingRequiredFields = require('./util/reportMissingRequiredFields');
100
+
99
101
  var requestSubscription = require('./subscription/requestSubscription');
100
102
 
101
103
  var stableCopy = require('./util/stableCopy');
@@ -140,6 +142,7 @@ module.exports = {
140
142
  createRequestDescriptor: RelayModernOperationDescriptor.createRequestDescriptor,
141
143
  getDataIDsFromFragment: RelayModernSelector.getDataIDsFromFragment,
142
144
  getDataIDsFromObject: RelayModernSelector.getDataIDsFromObject,
145
+ getNode: GraphQLTag.getNode,
143
146
  getFragment: GraphQLTag.getFragment,
144
147
  getInlineDataFragment: GraphQLTag.getInlineDataFragment,
145
148
  getModuleComponentKey: RelayStoreUtils.getModuleComponentKey,
@@ -157,7 +160,11 @@ module.exports = {
157
160
  getVariablesFromObject: RelayModernSelector.getVariablesFromObject,
158
161
  getVariablesFromPluralFragment: RelayModernSelector.getVariablesFromPluralFragment,
159
162
  getVariablesFromSingularFragment: RelayModernSelector.getVariablesFromSingularFragment,
163
+ reportMissingRequiredFields: reportMissingRequiredFields,
160
164
  graphql: GraphQLTag.graphql,
165
+ isFragment: GraphQLTag.isFragment,
166
+ isInlineDataFragment: GraphQLTag.isInlineDataFragment,
167
+ isRequest: GraphQLTag.isRequest,
161
168
  readInlineData: readInlineData,
162
169
  // Declarative mutation API
163
170
  MutationTypes: RelayDeclarativeMutationConfig.MutationTypes,
@@ -10,11 +10,9 @@
10
10
  // flowlint ambiguous-object-type:error
11
11
  'use strict';
12
12
 
13
- function _createForOfIteratorHelper(o) { if (typeof Symbol === "undefined" || o[Symbol.iterator] == null) { if (Array.isArray(o) || (o = _unsupportedIterableToArray(o))) { var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var it, normalCompletion = true, didErr = false, err; return { s: function s() { it = o[Symbol.iterator](); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it["return"] != null) it["return"](); } finally { if (didErr) throw err; } } }; }
13
+ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
14
14
 
15
- function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(n); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
16
-
17
- function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
15
+ var _createForOfIteratorHelper2 = _interopRequireDefault(require("@babel/runtime/helpers/createForOfIteratorHelper"));
18
16
 
19
17
  var ConnectionHandler = require('../handlers/connection/ConnectionHandler');
20
18
 
@@ -136,7 +134,7 @@ function rangeAdd(config, request) {
136
134
 
137
135
  var serverEdge = payload.getLinkedRecord(edgeName);
138
136
 
139
- var _iterator = _createForOfIteratorHelper(connectionInfo),
137
+ var _iterator = (0, _createForOfIteratorHelper2["default"])(connectionInfo),
140
138
  _step;
141
139
 
142
140
  try {
@@ -207,7 +205,7 @@ function rangeDelete(config, request) {
207
205
  var deletedIDField = data[rootField];
208
206
 
209
207
  if (deletedIDField && Array.isArray(deletedIDFieldName)) {
210
- var _iterator2 = _createForOfIteratorHelper(deletedIDFieldName),
208
+ var _iterator2 = (0, _createForOfIteratorHelper2["default"])(deletedIDFieldName),
211
209
  _step2;
212
210
 
213
211
  try {
@@ -278,7 +276,7 @@ function deleteNode(parentID, connectionKeys, pathToConnection, store, deleteIDs
278
276
  return;
279
277
  }
280
278
 
281
- var _iterator3 = _createForOfIteratorHelper(connectionKeys),
279
+ var _iterator3 = (0, _createForOfIteratorHelper2["default"])(connectionKeys),
282
280
  _step3;
283
281
 
284
282
  try {