@ldo/subscribable-dataset 1.0.0-alpha.3 → 1.0.0-alpha.31

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 (89) hide show
  1. package/Readme.md +2 -2
  2. package/dist/{SubscribableDataset.js → cjs/SubscribableDataset.cjs} +139 -6
  3. package/dist/cjs/SubscribableDataset.js.map +1 -0
  4. package/dist/{SubscribableDatasetFactory.js → cjs/SubscribableDatasetFactory.cjs} +5 -2
  5. package/dist/cjs/SubscribableDatasetFactory.js.map +1 -0
  6. package/dist/{TransactionDataset.js → cjs/TransactionDataset.cjs} +92 -7
  7. package/dist/cjs/TransactionDataset.js.map +1 -0
  8. package/dist/{TransactionDatasetFactory.js → cjs/TransactionDatasetFactory.cjs} +2 -2
  9. package/dist/cjs/TransactionDatasetFactory.js.map +1 -0
  10. package/dist/cjs/createSubscribableDataset.cjs +37 -0
  11. package/dist/cjs/createSubscribableDataset.js.map +1 -0
  12. package/dist/cjs/createSubscribableDatasetFromSerializedInput.cjs +21 -0
  13. package/dist/cjs/createSubscribableDatasetFromSerializedInput.js.map +1 -0
  14. package/dist/{index.js → cjs/index.cjs} +10 -10
  15. package/dist/cjs/index.js.map +1 -0
  16. package/dist/{mergeDatasetChanges.js → cjs/mergeDatasetChanges.cjs} +11 -2
  17. package/dist/cjs/mergeDatasetChanges.js.map +1 -0
  18. package/dist/cjs/types.js.map +1 -0
  19. package/dist/{util.js → cjs/util.cjs} +7 -2
  20. package/dist/cjs/util.js.map +1 -0
  21. package/dist/esm/SubscribableDataset.js +309 -0
  22. package/dist/esm/SubscribableDataset.js.map +1 -0
  23. package/dist/esm/SubscribableDatasetFactory.js +14 -0
  24. package/dist/esm/SubscribableDatasetFactory.js.map +1 -0
  25. package/dist/esm/TransactionDataset.js +205 -0
  26. package/dist/esm/TransactionDataset.js.map +1 -0
  27. package/dist/esm/TransactionDatasetFactory.js +11 -0
  28. package/dist/esm/TransactionDatasetFactory.js.map +1 -0
  29. package/dist/esm/createSubscribableDataset.js +32 -0
  30. package/dist/esm/createSubscribableDataset.js.map +1 -0
  31. package/dist/esm/createSubscribableDatasetFromSerializedInput.js +18 -0
  32. package/dist/esm/createSubscribableDatasetFromSerializedInput.js.map +1 -0
  33. package/dist/esm/index.js +10 -0
  34. package/dist/esm/index.js.map +1 -0
  35. package/dist/esm/mergeDatasetChanges.js +45 -0
  36. package/dist/esm/mergeDatasetChanges.js.map +1 -0
  37. package/dist/esm/types.js +2 -0
  38. package/dist/esm/types.js.map +1 -0
  39. package/dist/esm/util.js +22 -0
  40. package/dist/esm/util.js.map +1 -0
  41. package/dist/types/SubscribableDataset.d.ts +166 -0
  42. package/dist/types/SubscribableDataset.d.ts.map +1 -0
  43. package/dist/{SubscribableDatasetFactory.d.ts → types/SubscribableDatasetFactory.d.ts} +6 -2
  44. package/dist/types/SubscribableDatasetFactory.d.ts.map +1 -0
  45. package/dist/types/TransactionDataset.d.ts +122 -0
  46. package/dist/types/TransactionDataset.d.ts.map +1 -0
  47. package/dist/{TransactionDatasetFactory.d.ts → types/TransactionDatasetFactory.d.ts} +3 -2
  48. package/dist/types/TransactionDatasetFactory.d.ts.map +1 -0
  49. package/dist/types/createSubscribableDataset.d.ts +19 -0
  50. package/dist/types/createSubscribableDataset.d.ts.map +1 -0
  51. package/dist/types/createSubscribableDatasetFromSerializedInput.d.ts +16 -0
  52. package/dist/types/createSubscribableDatasetFromSerializedInput.d.ts.map +1 -0
  53. package/dist/types/index.d.ts +10 -0
  54. package/dist/types/index.d.ts.map +1 -0
  55. package/dist/{mergeDatasetChanges.d.ts → types/mergeDatasetChanges.d.ts} +6 -0
  56. package/dist/types/mergeDatasetChanges.d.ts.map +1 -0
  57. package/dist/types/types.d.ts +118 -0
  58. package/dist/types/types.d.ts.map +1 -0
  59. package/dist/{util.d.ts → types/util.d.ts} +6 -0
  60. package/dist/types/util.d.ts.map +1 -0
  61. package/package.json +27 -13
  62. package/src/SubscribableDataset.ts +25 -10
  63. package/src/SubscribableDatasetFactory.ts +2 -2
  64. package/src/TransactionDataset.ts +13 -7
  65. package/src/TransactionDatasetFactory.ts +2 -2
  66. package/src/createSubscribableDataset.ts +3 -3
  67. package/src/createSubscribableDatasetFromSerializedInput.ts +2 -2
  68. package/src/index.ts +9 -9
  69. package/src/types.ts +2 -0
  70. package/src/util.ts +1 -1
  71. package/dist/SubscribableDataset.d.ts +0 -37
  72. package/dist/SubscribableDataset.js.map +0 -1
  73. package/dist/SubscribableDatasetFactory.js.map +0 -1
  74. package/dist/TransactionDataset.d.ts +0 -25
  75. package/dist/TransactionDataset.js.map +0 -1
  76. package/dist/TransactionDatasetFactory.js.map +0 -1
  77. package/dist/createSubscribableDataset.d.ts +0 -5
  78. package/dist/createSubscribableDataset.js +0 -25
  79. package/dist/createSubscribableDataset.js.map +0 -1
  80. package/dist/createSubscribableDatasetFromSerializedInput.d.ts +0 -4
  81. package/dist/createSubscribableDatasetFromSerializedInput.js +0 -11
  82. package/dist/createSubscribableDatasetFromSerializedInput.js.map +0 -1
  83. package/dist/index.d.ts +0 -9
  84. package/dist/index.js.map +0 -1
  85. package/dist/mergeDatasetChanges.js.map +0 -1
  86. package/dist/types.d.ts +0 -35
  87. package/dist/types.js.map +0 -1
  88. package/dist/util.js.map +0 -1
  89. /package/dist/{types.js → cjs/types.cjs} +0 -0
@@ -1,7 +1,13 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.mergeDatasetChanges = void 0;
3
+ exports.mergeDatasetChanges = mergeDatasetChanges;
4
+ /**
5
+ * Merges a new change into an original change
6
+ * @param originalChange
7
+ * @param newChange
8
+ */
4
9
  function mergeDatasetChanges(originalChange, newChange) {
10
+ // Add added
5
11
  if (newChange.added) {
6
12
  if (originalChange.added) {
7
13
  originalChange.added.addAll(newChange.added);
@@ -9,12 +15,14 @@ function mergeDatasetChanges(originalChange, newChange) {
9
15
  else {
10
16
  originalChange.added = newChange.added;
11
17
  }
18
+ // Delete from removed if present
12
19
  const changesIntersection = originalChange.removed?.intersection(newChange.added);
13
20
  if (changesIntersection && changesIntersection.size > 0) {
14
21
  originalChange.removed =
15
22
  originalChange.removed?.difference(changesIntersection);
16
23
  }
17
24
  }
25
+ // Add removed
18
26
  if (newChange.removed) {
19
27
  if (originalChange.removed) {
20
28
  originalChange.removed.addAll(newChange.removed);
@@ -22,12 +30,14 @@ function mergeDatasetChanges(originalChange, newChange) {
22
30
  else {
23
31
  originalChange.removed = newChange.removed;
24
32
  }
33
+ // Delete from added if present
25
34
  const changesIntersection = originalChange.added?.intersection(newChange.removed);
26
35
  if (changesIntersection && changesIntersection.size > 0) {
27
36
  originalChange.added =
28
37
  originalChange.added?.difference(changesIntersection);
29
38
  }
30
39
  }
40
+ // Make undefined if size is zero
31
41
  if (originalChange.added && originalChange.added.size === 0) {
32
42
  originalChange.added = undefined;
33
43
  }
@@ -35,5 +45,4 @@ function mergeDatasetChanges(originalChange, newChange) {
35
45
  originalChange.removed = undefined;
36
46
  }
37
47
  }
38
- exports.mergeDatasetChanges = mergeDatasetChanges;
39
48
  //# sourceMappingURL=mergeDatasetChanges.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mergeDatasetChanges.js","sourceRoot":"","sources":["../../src/mergeDatasetChanges.ts"],"names":[],"mappings":";;AAQA,kDA4CC;AAjDD;;;;GAIG;AACH,SAAgB,mBAAmB,CACjC,cAA4C,EAC5C,SAAuC;IAEvC,YAAY;IACZ,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;QACpB,IAAI,cAAc,CAAC,KAAK,EAAE,CAAC;YACzB,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC/C,CAAC;aAAM,CAAC;YACN,cAAc,CAAC,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC;QACzC,CAAC;QACD,iCAAiC;QACjC,MAAM,mBAAmB,GAAG,cAAc,CAAC,OAAO,EAAE,YAAY,CAC9D,SAAS,CAAC,KAAK,CAChB,CAAC;QACF,IAAI,mBAAmB,IAAI,mBAAmB,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YACxD,cAAc,CAAC,OAAO;gBACpB,cAAc,CAAC,OAAO,EAAE,UAAU,CAAC,mBAAmB,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IACD,cAAc;IACd,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;QACtB,IAAI,cAAc,CAAC,OAAO,EAAE,CAAC;YAC3B,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,cAAc,CAAC,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC;QAC7C,CAAC;QACD,+BAA+B;QAC/B,MAAM,mBAAmB,GAAG,cAAc,CAAC,KAAK,EAAE,YAAY,CAC5D,SAAS,CAAC,OAAO,CAClB,CAAC;QACF,IAAI,mBAAmB,IAAI,mBAAmB,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YACxD,cAAc,CAAC,KAAK;gBAClB,cAAc,CAAC,KAAK,EAAE,UAAU,CAAC,mBAAmB,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,iCAAiC;IACjC,IAAI,cAAc,CAAC,KAAK,IAAI,cAAc,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QAC5D,cAAc,CAAC,KAAK,GAAG,SAAS,CAAC;IACnC,CAAC;IACD,IAAI,cAAc,CAAC,OAAO,IAAI,cAAc,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QAChE,cAAc,CAAC,OAAO,GAAG,SAAS,CAAC;IACrC,CAAC;AACH,CAAC"}
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}
@@ -1,7 +1,13 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.updateDatasetInBulk = void 0;
3
+ exports.updateDatasetInBulk = updateDatasetInBulk;
4
+ /**
5
+ * Performs a bulk update for a dataset even if it doesn't have a bulk method.
6
+ * @param dataset - the input dataset
7
+ * @param datasetChanges - changes to be applied
8
+ */
4
9
  function updateDatasetInBulk(dataset, datasetChanges) {
10
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
5
11
  if (dataset.bulk) {
6
12
  dataset.bulk(datasetChanges);
7
13
  }
@@ -16,5 +22,4 @@ function updateDatasetInBulk(dataset, datasetChanges) {
16
22
  }
17
23
  }
18
24
  }
19
- exports.updateDatasetInBulk = updateDatasetInBulk;
20
25
  //# sourceMappingURL=util.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"util.js","sourceRoot":"","sources":["../../src/util.ts"],"names":[],"mappings":";;AASA,kDAiBC;AAtBD;;;;GAIG;AACH,SAAgB,mBAAmB,CACjC,OAA8B,EAC9B,cAA4C;IAE5C,8DAA8D;IAC9D,IAAK,OAAe,CAAC,IAAI,EAAE,CAAC;QACzB,OAA8C,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACvE,CAAC;SAAM,CAAC;QACN,IAAI,cAAc,CAAC,KAAK,EAAE,CAAC;YACzB,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QACvC,CAAC;QACD,IAAI,cAAc,CAAC,OAAO,EAAE,CAAC;YAC3B,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;gBACzC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC1B,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC"}
@@ -0,0 +1,309 @@
1
+ import { EventEmitter } from "events";
2
+ import { quadMatchToString, stringToQuadMatch } from "@ldo/rdf-utils";
3
+ import { ExtendedDataset } from "@ldo/dataset";
4
+ import { v4 } from "uuid";
5
+ /**
6
+ * A wrapper for a dataset that allows subscriptions to be made on nodes to
7
+ * be triggered whenever a quad containing that added or removed.
8
+ */
9
+ export class SubscribableDataset extends ExtendedDataset {
10
+ /**
11
+ * @param datasetFactory A RDF/JS Dataset Factory
12
+ * @param initialDataset An RDF/JS Dataset with initial Quads
13
+ */
14
+ constructor(datasetFactory, transactionDatasetFactory, initialDataset) {
15
+ super(initialDataset || datasetFactory.dataset(), datasetFactory);
16
+ /**
17
+ * Helps find all the events for a given listener
18
+ */
19
+ this.listenerHashMap = new Map();
20
+ this.transactionDatasetFactory = transactionDatasetFactory;
21
+ this.eventEmitter = new EventEmitter();
22
+ this.datasetFactory = datasetFactory;
23
+ }
24
+ /**
25
+ * ==================================================================
26
+ * DATASET METHODS
27
+ * ==================================================================
28
+ */
29
+ /**
30
+ * A helper method that mimics what the super of addAll would be
31
+ */
32
+ superAddAll(quads) {
33
+ for (const quad of quads) {
34
+ super.add(quad);
35
+ }
36
+ return this;
37
+ }
38
+ /**
39
+ * Imports the quads into this dataset.
40
+ * This method differs from Dataset.union in that it adds all quads to the current instance, rather than combining quads and the current instance to create a new instance.
41
+ * @param quads
42
+ * @returns the dataset instance it was called on.
43
+ */
44
+ addAll(quads) {
45
+ this.superAddAll(quads);
46
+ this.triggerSubscriptionForQuads({
47
+ added: this.datasetFactory.dataset(quads),
48
+ });
49
+ return this;
50
+ }
51
+ /**
52
+ * Bulk add and remove triples
53
+ * @param changed
54
+ */
55
+ bulk(changed) {
56
+ if (changed.added) {
57
+ this.superAddAll(changed.added);
58
+ }
59
+ if (changed.removed) {
60
+ changed.removed.forEach((quad) => {
61
+ super.delete(quad);
62
+ });
63
+ }
64
+ this.triggerSubscriptionForQuads(changed);
65
+ return this;
66
+ }
67
+ /**
68
+ * This method removes the quads in the current instance that match the given arguments. The logic described in Quad Matching is applied for each quad in this dataset to select the quads which will be deleted.
69
+ * @param subject
70
+ * @param predicate
71
+ * @param object
72
+ * @param graph
73
+ * @returns the dataset instance it was called on.
74
+ */
75
+ deleteMatches(subject, predicate, object, graph) {
76
+ const matching = super.match(subject, predicate, object, graph);
77
+ for (const quad of matching) {
78
+ super.delete(quad);
79
+ }
80
+ this.triggerSubscriptionForQuads({ removed: matching });
81
+ return this;
82
+ }
83
+ /**
84
+ * Adds the specified quad to the dataset.
85
+ * Existing quads, as defined in Quad.equals, will be ignored.
86
+ * @param quad
87
+ * @returns the dataset instance it was called on.
88
+ */
89
+ add(quad) {
90
+ super.add(quad);
91
+ this.triggerSubscriptionForQuads({
92
+ added: this.datasetFactory.dataset([quad]),
93
+ });
94
+ return this;
95
+ }
96
+ /**
97
+ * Removes the specified quad from the dataset.
98
+ * This method returns the dataset instance it was called on.
99
+ * @param quad
100
+ */
101
+ delete(quad) {
102
+ super.delete(quad);
103
+ this.triggerSubscriptionForQuads({
104
+ removed: this.datasetFactory.dataset([quad]),
105
+ });
106
+ return this;
107
+ }
108
+ /**
109
+ * ==================================================================
110
+ * EVENTEMITTER METHODS
111
+ * ==================================================================
112
+ */
113
+ /**
114
+ * Triggers all subscriptions based on an updated quads
115
+ * @param changed The changed triples of the transaction
116
+ */
117
+ triggerSubscriptionForQuads(changed) {
118
+ // A mapping of serialized QuadMatches to the changed quads
119
+ const matchingDatasetChanges = {};
120
+ // Population MatchingDatasetChanges
121
+ const populateMatchingDatasetChanges = (changeType) => {
122
+ const changedQuads = changed[changeType];
123
+ changedQuads?.forEach((changedQuad) => {
124
+ // Cast the input because RDFJS types assume RDF 1.2 where a Subject can
125
+ // be a Quad
126
+ const quad = changedQuad;
127
+ // All possible matches that could match with this triple
128
+ const quadMatches = [
129
+ [null, null, null, null],
130
+ [quad.subject, null, null, null],
131
+ [quad.subject, quad.predicate, null, null],
132
+ [quad.subject, null, quad.object, null],
133
+ [null, quad.predicate, null, null],
134
+ [null, quad.predicate, quad.object, null],
135
+ [null, null, quad.object, null],
136
+ [quad.subject, quad.predicate, quad.object, null],
137
+ [null, null, null, quad.graph],
138
+ [quad.subject, null, null, quad.graph],
139
+ [quad.subject, quad.predicate, null, quad.graph],
140
+ [quad.subject, null, quad.object, quad.graph],
141
+ [null, quad.predicate, null, quad.graph],
142
+ [null, quad.predicate, quad.object, quad.graph],
143
+ [null, null, quad.object, quad.graph],
144
+ [quad.subject, quad.predicate, quad.object, quad.graph],
145
+ ];
146
+ quadMatches.forEach((quadMatch) => {
147
+ const eventName = quadMatchToString(quadMatch);
148
+ // Only add to the map if there's actually a listener for this
149
+ if (this.eventEmitter.listenerCount(eventName) > 0) {
150
+ // Set matchingDatasetChanges to include data to emit
151
+ if (!matchingDatasetChanges[eventName]) {
152
+ matchingDatasetChanges[eventName] = {
153
+ triggerQuadMatch: quadMatch,
154
+ changes: {},
155
+ };
156
+ }
157
+ if (!matchingDatasetChanges[eventName].changes[changeType]) {
158
+ matchingDatasetChanges[eventName].changes[changeType] =
159
+ this.datasetFactory.dataset();
160
+ }
161
+ matchingDatasetChanges[eventName].changes[changeType]?.add(changedQuad);
162
+ }
163
+ });
164
+ });
165
+ };
166
+ populateMatchingDatasetChanges("added");
167
+ populateMatchingDatasetChanges("removed");
168
+ const transactionId = v4();
169
+ // Alert all listeners
170
+ Object.entries(matchingDatasetChanges).forEach(([quadMatchString, info]) => {
171
+ this.eventEmitter.emit(quadMatchString, info.changes, transactionId, info.triggerQuadMatch);
172
+ });
173
+ }
174
+ /**
175
+ * Alias for emitter.on(eventName, listener).
176
+ * @param eventName
177
+ * @param listener
178
+ * @returns
179
+ */
180
+ addListener(eventName, listener) {
181
+ return this.on(eventName, listener);
182
+ }
183
+ /**
184
+ * Synchronously calls each of the listeners registered for the event named eventName, in the order they were registered, passing the supplied arguments to each.
185
+ * @param eventName
186
+ * @param dataset
187
+ * @param datasetChanges
188
+ * @returns true if the event had listeners, false otherwise.
189
+ */
190
+ emit(eventName, changes) {
191
+ return this.eventEmitter.emit(quadMatchToString(eventName), changes);
192
+ }
193
+ /**
194
+ * Returns an array listing the events for which the emitter has registered listeners. The values in the array are strings or Symbols.
195
+ */
196
+ eventNames() {
197
+ return this.eventEmitter
198
+ .eventNames()
199
+ .map((eventName) => stringToQuadMatch(eventName));
200
+ }
201
+ /**
202
+ * Returns the current max listener value for the EventEmitter which is either set by emitter.setMaxListeners(n) or defaults to events.defaultMaxListeners.
203
+ */
204
+ getMaxListeners() {
205
+ return this.eventEmitter.getMaxListeners();
206
+ }
207
+ /**
208
+ * Returns the number of listeners listening to the event named eventName.
209
+ */
210
+ listenerCount(eventName) {
211
+ return this.eventEmitter.listenerCount(quadMatchToString(eventName));
212
+ }
213
+ /**
214
+ * Returns a copy of the array of listeners for the event named eventName.
215
+ */
216
+ listeners(eventName) {
217
+ return this.eventEmitter.listeners(quadMatchToString(eventName));
218
+ }
219
+ /**
220
+ * Alias for emitter.removeListener()
221
+ */
222
+ off(eventName, listener) {
223
+ this.removeListener(eventName, listener);
224
+ }
225
+ /**
226
+ * Adds the listener function to the end of the listeners array for the event named eventName. No checks are made to see if the listener has already been added. Multiple calls passing the same combination of eventName and listener will result in the listener being added, and called, multiple times.
227
+ */
228
+ on(eventName, listener) {
229
+ const eventString = quadMatchToString(eventName);
230
+ if (!this.listenerHashMap.has(listener)) {
231
+ this.listenerHashMap.set(listener, new Set());
232
+ }
233
+ this.listenerHashMap.get(listener)?.add(eventString);
234
+ this.eventEmitter.on(eventString, listener);
235
+ return this;
236
+ }
237
+ /**
238
+ * Adds a one-time listener function for the event named eventName. The next time eventName is triggered, this listener is removed and then invoked.
239
+ */
240
+ once(eventName, listener) {
241
+ this.eventEmitter.once(quadMatchToString(eventName), listener);
242
+ return this;
243
+ }
244
+ /**
245
+ * Adds the listener function to the beginning of the listeners array for the event named eventName. No checks are made to see if the listener has already been added. Multiple calls passing the same combination of eventName and listener will result in the listener being added, and called, multiple times.
246
+ */
247
+ prependListener(eventName, listener) {
248
+ this.eventEmitter.prependListener(quadMatchToString(eventName), listener);
249
+ return this;
250
+ }
251
+ /**
252
+ * Adds a one-time listener function for the event named eventName to the beginning of the listeners array. The next time eventName is triggered, this listener is removed, and then invoked.
253
+ */
254
+ prependOnceListener(eventName, listener) {
255
+ this.eventEmitter.prependOnceListener(quadMatchToString(eventName), listener);
256
+ return this;
257
+ }
258
+ /**
259
+ * Removes all listeners, or those of the specified eventName.
260
+ */
261
+ removeAllListeners(eventName) {
262
+ this.eventEmitter.removeAllListeners(quadMatchToString(eventName));
263
+ return this;
264
+ }
265
+ /**
266
+ * Removes the specified listener from the listener array for the event named eventName.
267
+ */
268
+ removeListener(eventName, listener) {
269
+ this.eventEmitter.removeListener(quadMatchToString(eventName), listener);
270
+ return this;
271
+ }
272
+ /**
273
+ * Removes the specified listener from the listener array for the event named eventName.
274
+ */
275
+ removeListenerFromAllEvents(listener) {
276
+ const eventStringSet = this.listenerHashMap.get(listener);
277
+ if (eventStringSet) {
278
+ eventStringSet.forEach((eventString) => {
279
+ this.eventEmitter.off(eventString, listener);
280
+ });
281
+ }
282
+ return this;
283
+ }
284
+ /**
285
+ * By default EventEmitters will print a warning if more than 10 listeners are added for a particular event. This is a useful default that helps finding memory leaks. The emitter.setMaxListeners() method allows the limit to be modified for this specific EventEmitter instance. The value can be set to Infinity (or 0) to indicate an unlimited number of listeners.
286
+ */
287
+ setMaxListeners(n) {
288
+ this.eventEmitter.setMaxListeners(n);
289
+ return this;
290
+ }
291
+ /**
292
+ * Returns a copy of the array of listeners for the event named eventName, including any wrappers (such as those created by .once()).
293
+ */
294
+ rawListeners(eventName) {
295
+ return this.eventEmitter.rawListeners(quadMatchToString(eventName));
296
+ }
297
+ /**
298
+ * ==================================================================
299
+ * TRANSACTION METHODS
300
+ * ==================================================================
301
+ */
302
+ /**
303
+ * Returns a transactional dataset that will update this dataset when its transaction is committed.
304
+ */
305
+ startTransaction() {
306
+ return this.transactionDatasetFactory.transactionDataset(this);
307
+ }
308
+ }
309
+ //# sourceMappingURL=SubscribableDataset.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"SubscribableDataset.js","sourceRoot":"","sources":["../../src/SubscribableDataset.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,14 @@
1
+ import { SubscribableDataset } from "./SubscribableDataset.js";
2
+ /**
3
+ * A DatasetFactory that returns a SubscribableDataset given a generic DatasetFactory.
4
+ */
5
+ export class SubscribableDatasetFactory {
6
+ constructor(datasetFactory, transactionDatasetFactory) {
7
+ this.datasetFactory = datasetFactory;
8
+ this.transactionDatasetFactory = transactionDatasetFactory;
9
+ }
10
+ dataset(quads) {
11
+ return new SubscribableDataset(this.datasetFactory, this.transactionDatasetFactory, quads ? this.datasetFactory.dataset(quads) : undefined);
12
+ }
13
+ }
14
+ //# sourceMappingURL=SubscribableDatasetFactory.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"SubscribableDatasetFactory.js","sourceRoot":"","sources":["../../src/SubscribableDatasetFactory.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;GAEG;AACH,MAAM,OAAO,0BAA0B;IAMrC,YACE,cAA0D,EAC1D,yBAAmE;QAEnE,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,yBAAyB,GAAG,yBAAyB,CAAC;IAC7D,CAAC;IAED,OAAO,CACL,KAA4D;QAE5D,OAAO,IAAI,mBAAmB,CAC5B,IAAI,CAAC,cAAc,EACnB,IAAI,CAAC,yBAAyB,EAC9B,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CACvD,CAAC;IACJ,CAAC;CACF"}
@@ -0,0 +1,205 @@
1
+ import { mergeDatasetChanges } from "./mergeDatasetChanges.js";
2
+ import { SubscribableDataset } from "./SubscribableDataset.js";
3
+ import { updateDatasetInBulk } from "./util.js";
4
+ /**
5
+ * Proxy Transactional Dataset is a transactional dataset that does not duplicate
6
+ * the parent dataset, it will dynamically determine the correct return value for
7
+ * methods in real time when the method is called.
8
+ */
9
+ export class TransactionDataset extends SubscribableDataset {
10
+ /**
11
+ * Constructor
12
+ * @param parentDataset The dataset that will be updated upon commit
13
+ */
14
+ constructor(parentDataset, datasetFactory, transactionDatasetFactory) {
15
+ super(datasetFactory, transactionDatasetFactory, datasetFactory.dataset());
16
+ this.parentDataset = parentDataset;
17
+ this.datasetChanges = {};
18
+ }
19
+ /**
20
+ * ==================================================================
21
+ * DATASET METHODS
22
+ * ==================================================================
23
+ */
24
+ /**
25
+ * Imports the quads into this dataset.
26
+ * This method differs from Dataset.union in that it adds all quads to the current instance, rather than combining quads and the current instance to create a new instance.
27
+ * @param quads
28
+ * @returns the dataset instance it was called on.
29
+ */
30
+ addAll(quads) {
31
+ this.updateDatasetChanges({ added: quads });
32
+ return this;
33
+ }
34
+ /**
35
+ * Bulk add and remove triples
36
+ * @param changed
37
+ */
38
+ bulk(changes) {
39
+ this.updateDatasetChanges(changes);
40
+ return this;
41
+ }
42
+ /**
43
+ * This method removes the quads in the current instance that match the given arguments. The logic described in Quad Matching is applied for each quad in this dataset to select the quads which will be deleted.
44
+ * @param subject
45
+ * @param predicate
46
+ * @param object
47
+ * @param graph
48
+ * @returns the dataset instance it was called on.
49
+ */
50
+ deleteMatches(subject, predicate, object, graph) {
51
+ this.checkIfTransactionCommitted();
52
+ const matching = this.match(subject, predicate, object, graph);
53
+ for (const quad of matching) {
54
+ this.delete(quad);
55
+ }
56
+ return this;
57
+ }
58
+ /**
59
+ * This method returns a new dataset that is comprised of all quads in the current instance matching the given arguments. The logic described in Quad Matching is applied for each quad in this dataset to check if it should be included in the output dataset.
60
+ * @param subject
61
+ * @param predicate
62
+ * @param object
63
+ * @param graph
64
+ * @returns a Dataset with matching triples
65
+ */
66
+ match(subject, predicate, object, graph) {
67
+ let finalMatch = this.parentDataset.match(subject, predicate, object, graph);
68
+ if (this.datasetChanges.removed) {
69
+ finalMatch = finalMatch.difference(this.datasetChanges.removed);
70
+ }
71
+ if (this.datasetChanges.added) {
72
+ finalMatch = finalMatch.union(this.datasetChanges.added.match(subject, predicate, object, graph));
73
+ }
74
+ return finalMatch;
75
+ }
76
+ /**
77
+ * A non-negative integer that specifies the number of quads in the set.
78
+ */
79
+ get size() {
80
+ return (this.parentDataset.size +
81
+ (this.datasetChanges.added?.difference(this.parentDataset).size || 0) -
82
+ (this.datasetChanges.removed?.intersection(this.parentDataset).size || 0));
83
+ }
84
+ /**
85
+ * Adds the specified quad to the dataset.
86
+ * Existing quads, as defined in Quad.equals, will be ignored.
87
+ * @param quad
88
+ * @returns the dataset instance it was called on.
89
+ */
90
+ add(quad) {
91
+ this.updateDatasetChanges({ added: [quad] });
92
+ return this;
93
+ }
94
+ /**
95
+ * Removes the specified quad from the dataset.
96
+ * This method returns the dataset instance it was called on.
97
+ * @param quad
98
+ */
99
+ delete(quad) {
100
+ this.updateDatasetChanges({ removed: [quad] });
101
+ return this;
102
+ }
103
+ /**
104
+ * Determines whether a dataset includes a certain quad, returning true or false as appropriate.
105
+ * @param quad
106
+ */
107
+ has(quad) {
108
+ return (!this.datasetChanges.removed?.has(quad) &&
109
+ (this.datasetChanges.added?.has(quad) || this.parentDataset.has(quad)));
110
+ }
111
+ /**
112
+ * Returns an iterator
113
+ */
114
+ [Symbol.iterator]() {
115
+ const addedIterator = (this.datasetChanges.added || [])[Symbol.iterator]();
116
+ let addedNext = addedIterator.next();
117
+ const parentIterator = this.parentDataset[Symbol.iterator]();
118
+ let parentNext = parentIterator.next();
119
+ return {
120
+ next: () => {
121
+ if (!addedNext || !addedNext.done) {
122
+ const toReturn = addedNext;
123
+ addedNext = addedIterator.next();
124
+ return toReturn;
125
+ }
126
+ while (!parentNext.done) {
127
+ const toReturn = parentNext;
128
+ parentNext = parentIterator.next();
129
+ if (!(this.datasetChanges.added &&
130
+ this.datasetChanges.added.has(toReturn.value)) &&
131
+ !(this.datasetChanges.removed &&
132
+ this.datasetChanges.removed.has(toReturn.value))) {
133
+ return toReturn;
134
+ }
135
+ }
136
+ return { value: undefined, done: true };
137
+ },
138
+ };
139
+ }
140
+ /**
141
+ * ==================================================================
142
+ * TANSACTIONAL METHODS
143
+ * ==================================================================
144
+ */
145
+ /**
146
+ * Checks if the transaction has been committed and throws an error if it has
147
+ * @param changed
148
+ */
149
+ checkIfTransactionCommitted() {
150
+ if (this.committedDatasetChanges) {
151
+ throw new Error("Transaction has already committed");
152
+ }
153
+ }
154
+ /**
155
+ * Helper method to update the changes made
156
+ * @param changes
157
+ */
158
+ updateDatasetChanges(changes) {
159
+ this.checkIfTransactionCommitted();
160
+ const newDatasetChanges = {
161
+ added: changes.added
162
+ ? this.datasetFactory.dataset(changes.added)
163
+ : undefined,
164
+ removed: changes.removed
165
+ ? this.datasetFactory.dataset(changes.removed)
166
+ : undefined,
167
+ };
168
+ mergeDatasetChanges(this.datasetChanges, newDatasetChanges);
169
+ this.triggerSubscriptionForQuads(newDatasetChanges);
170
+ }
171
+ /**
172
+ * Helper method to update the parent dataset or any other provided dataset
173
+ */
174
+ updateParentDataset(datasetChanges) {
175
+ return updateDatasetInBulk(this.parentDataset, datasetChanges);
176
+ }
177
+ /**
178
+ * Commits changes made to the parent dataset
179
+ */
180
+ commit() {
181
+ this.checkIfTransactionCommitted();
182
+ this.committedDatasetChanges = {
183
+ added: this.datasetChanges.added?.difference(this.parentDataset),
184
+ removed: this.datasetChanges.removed?.intersection(this.parentDataset),
185
+ };
186
+ this.updateParentDataset(this.committedDatasetChanges);
187
+ }
188
+ /**
189
+ * Rolls back changes made to the parent dataset
190
+ */
191
+ rollback() {
192
+ if (!this.committedDatasetChanges) {
193
+ throw new Error("Cannot rollback. Transaction has not yet been committed");
194
+ }
195
+ this.updateParentDataset({
196
+ added: this.committedDatasetChanges.removed,
197
+ removed: this.committedDatasetChanges.added,
198
+ });
199
+ this.committedDatasetChanges = undefined;
200
+ }
201
+ getChanges() {
202
+ return this.datasetChanges;
203
+ }
204
+ }
205
+ //# sourceMappingURL=TransactionDataset.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"TransactionDataset.js","sourceRoot":"","sources":["../../src/TransactionDataset.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEhD;;;;GAIG;AACH,MAAM,OAAO,kBACX,SAAQ,mBAAiC;IAsBzC;;;OAGG;IACH,YACE,aAAkD,EAClD,cAA0D,EAC1D,yBAAmE;QAEnE,KAAK,CAAC,cAAc,EAAE,yBAAyB,EAAE,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3E,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IAEH;;;;;OAKG;IACI,MAAM,CACX,KAA2D;QAE3D,IAAI,CAAC,oBAAoB,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACI,IAAI,CAAC,OAAqC;QAC/C,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;OAOG;IACH,aAAa,CACX,OAAc,EACd,SAAgB,EAChB,MAAa,EACb,KAAY;QAEZ,IAAI,CAAC,2BAA2B,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QAC/D,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;OAOG;IACI,KAAK,CACV,OAAqB,EACrB,SAAuB,EACvB,MAAoB,EACpB,KAAmB;QAEnB,IAAI,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CACvC,OAAO,EACP,SAAS,EACT,MAAM,EACN,KAAK,CACN,CAAC;QACF,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC;YAChC,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;YAC9B,UAAU,GAAG,UAAU,CAAC,KAAK,CAC3B,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,CACnE,CAAC;QACJ,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,IAAW,IAAI;QACb,OAAO,CACL,IAAI,CAAC,aAAa,CAAC,IAAI;YACvB,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;YACrE,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAC1E,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACI,GAAG,CAAC,IAAkB;QAC3B,IAAI,CAAC,oBAAoB,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,IAAkB;QAC9B,IAAI,CAAC,oBAAoB,CAAC,EAAE,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACI,GAAG,CAAC,IAAkB;QAC3B,OAAO,CACL,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC;YACvC,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CACvE,CAAC;IACJ,CAAC;IAED;;OAEG;IACI,CAAC,MAAM,CAAC,QAAQ,CAAC;QACtB,MAAM,aAAa,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3E,IAAI,SAAS,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC;QACrC,MAAM,cAAc,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7D,IAAI,UAAU,GAAG,cAAc,CAAC,IAAI,EAAE,CAAC;QACvC,OAAO;YACL,IAAI,EAAE,GAAG,EAAE;gBACT,IAAI,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;oBAClC,MAAM,QAAQ,GAAG,SAAS,CAAC;oBAC3B,SAAS,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC;oBACjC,OAAO,QAAQ,CAAC;gBAClB,CAAC;gBACD,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;oBACxB,MAAM,QAAQ,GAAG,UAAU,CAAC;oBAC5B,UAAU,GAAG,cAAc,CAAC,IAAI,EAAE,CAAC;oBACnC,IACE,CAAC,CACC,IAAI,CAAC,cAAc,CAAC,KAAK;wBACzB,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAC9C;wBACD,CAAC,CACC,IAAI,CAAC,cAAc,CAAC,OAAO;4BAC3B,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAChD,EACD,CAAC;wBACD,OAAO,QAAQ,CAAC;oBAClB,CAAC;gBACH,CAAC;gBACD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YAC1C,CAAC;SACF,CAAC;IACJ,CAAC;IAED;;;;OAIG;IAEH;;;OAGG;IACK,2BAA2B;QACjC,IAAI,IAAI,CAAC,uBAAuB,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,oBAAoB,CAAC,OAG5B;QACC,IAAI,CAAC,2BAA2B,EAAE,CAAC;QACnC,MAAM,iBAAiB,GAAG;YACxB,KAAK,EAAE,OAAO,CAAC,KAAK;gBAClB,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;gBAC5C,CAAC,CAAC,SAAS;YACb,OAAO,EAAE,OAAO,CAAC,OAAO;gBACtB,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;gBAC9C,CAAC,CAAC,SAAS;SACd,CAAC;QAEF,mBAAmB,CAAC,IAAI,CAAC,cAAc,EAAE,iBAAiB,CAAC,CAAC;QAE5D,IAAI,CAAC,2BAA2B,CAAC,iBAAiB,CAAC,CAAC;IACtD,CAAC;IAED;;OAEG;IACK,mBAAmB,CAAC,cAA4C;QACtE,OAAO,mBAAmB,CAAC,IAAI,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;IACjE,CAAC;IAED;;OAEG;IACI,MAAM;QACX,IAAI,CAAC,2BAA2B,EAAE,CAAC;QACnC,IAAI,CAAC,uBAAuB,GAAG;YAC7B,KAAK,EAAE,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC;YAChE,OAAO,EAAE,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC;SACvE,CAAC;QACF,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACzD,CAAC;IAED;;OAEG;IACI,QAAQ;QACb,IAAI,CAAC,IAAI,CAAC,uBAAuB,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CACb,yDAAyD,CAC1D,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,mBAAmB,CAAC;YACvB,KAAK,EAAE,IAAI,CAAC,uBAAuB,CAAC,OAAO;YAC3C,OAAO,EAAE,IAAI,CAAC,uBAAuB,CAAC,KAAK;SAC5C,CAAC,CAAC;QACH,IAAI,CAAC,uBAAuB,GAAG,SAAS,CAAC;IAC3C,CAAC;IAEM,UAAU;QACf,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;CACF"}
@@ -0,0 +1,11 @@
1
+ import { TransactionDataset } from "./TransactionDataset.js";
2
+ export class TransactionDatasetFactory {
3
+ constructor(datasetFactory, transactionDatasetFactory) {
4
+ this.datasetFactory = datasetFactory;
5
+ this.transactionDatasetFactory = transactionDatasetFactory || this;
6
+ }
7
+ transactionDataset(parentDataset) {
8
+ return new TransactionDataset(parentDataset, this.datasetFactory, this.transactionDatasetFactory);
9
+ }
10
+ }
11
+ //# sourceMappingURL=TransactionDatasetFactory.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"TransactionDatasetFactory.js","sourceRoot":"","sources":["../../src/TransactionDatasetFactory.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,MAAM,OAAO,yBAAyB;IAKpC,YACE,cAA0D,EAC1D,yBAAoE;QAEpE,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,yBAAyB,GAAG,yBAAyB,IAAI,IAAI,CAAC;IACrE,CAAC;IAED,kBAAkB,CAChB,aAAiD;QAEjD,OAAO,IAAI,kBAAkB,CAC3B,aAAa,EACb,IAAI,CAAC,cAAc,EACnB,IAAI,CAAC,yBAAyB,CAC/B,CAAC;IACJ,CAAC;CACF"}