@fluid-experimental/tree 1.2.6 → 2.0.0-dev.1.3.0.96595
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.
- package/.mocharc.js +12 -0
- package/.prettierignore +6 -0
- package/README.md +1 -1
- package/dist/Checkout.d.ts +9 -4
- package/dist/Checkout.d.ts.map +1 -1
- package/dist/Checkout.js +34 -25
- package/dist/Checkout.js.map +1 -1
- package/dist/Common.d.ts +31 -18
- package/dist/Common.d.ts.map +1 -1
- package/dist/Common.js +33 -22
- package/dist/Common.js.map +1 -1
- package/dist/EditLog.js +2 -2
- package/dist/EditLog.js.map +1 -1
- package/dist/EditUtilities.d.ts +5 -0
- package/dist/EditUtilities.d.ts.map +1 -1
- package/dist/EditUtilities.js +4 -3
- package/dist/EditUtilities.js.map +1 -1
- package/dist/EventTypes.d.ts +11 -6
- package/dist/EventTypes.d.ts.map +1 -1
- package/dist/EventTypes.js +11 -6
- package/dist/EventTypes.js.map +1 -1
- package/dist/HistoryEditFactory.d.ts +5 -3
- package/dist/HistoryEditFactory.d.ts.map +1 -1
- package/dist/HistoryEditFactory.js +25 -6
- package/dist/HistoryEditFactory.js.map +1 -1
- package/dist/LogViewer.d.ts +12 -6
- package/dist/LogViewer.d.ts.map +1 -1
- package/dist/LogViewer.js.map +1 -1
- package/dist/RevisionValueCache.d.ts +8 -4
- package/dist/RevisionValueCache.d.ts.map +1 -1
- package/dist/RevisionValueCache.js +4 -2
- package/dist/RevisionValueCache.js.map +1 -1
- package/dist/SharedTree.d.ts +22 -11
- package/dist/SharedTree.d.ts.map +1 -1
- package/dist/SharedTree.js +25 -19
- package/dist/SharedTree.js.map +1 -1
- package/dist/StringInterner.d.ts +4 -3
- package/dist/StringInterner.d.ts.map +1 -1
- package/dist/StringInterner.js +4 -3
- package/dist/StringInterner.js.map +1 -1
- package/dist/Transaction.d.ts +2 -2
- package/dist/Transaction.d.ts.map +1 -1
- package/dist/Transaction.js +3 -2
- package/dist/Transaction.js.map +1 -1
- package/dist/TransactionInternal.d.ts.map +1 -1
- package/dist/TransactionInternal.js +1 -0
- package/dist/TransactionInternal.js.map +1 -1
- package/dist/id-compressor/IdCompressor.d.ts +14 -8
- package/dist/id-compressor/IdCompressor.d.ts.map +1 -1
- package/dist/id-compressor/IdCompressor.js +36 -15
- package/dist/id-compressor/IdCompressor.js.map +1 -1
- package/dist/id-compressor/NumericUuid.d.ts +4 -0
- package/dist/id-compressor/NumericUuid.d.ts.map +1 -1
- package/dist/id-compressor/NumericUuid.js +13 -3
- package/dist/id-compressor/NumericUuid.js.map +1 -1
- package/dist/id-compressor/SessionIdNormalizer.d.ts +10 -5
- package/dist/id-compressor/SessionIdNormalizer.d.ts.map +1 -1
- package/dist/id-compressor/SessionIdNormalizer.js +10 -5
- package/dist/id-compressor/SessionIdNormalizer.js.map +1 -1
- package/dist/id-compressor/persisted-types/0.0.1.d.ts.map +1 -1
- package/dist/id-compressor/persisted-types/0.0.1.js.map +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/lib/Checkout.d.ts +9 -4
- package/lib/Checkout.d.ts.map +1 -1
- package/lib/Checkout.js +36 -27
- package/lib/Checkout.js.map +1 -1
- package/lib/Common.d.ts +31 -18
- package/lib/Common.d.ts.map +1 -1
- package/lib/Common.js +31 -21
- package/lib/Common.js.map +1 -1
- package/lib/EditLog.js +2 -2
- package/lib/EditLog.js.map +1 -1
- package/lib/EditUtilities.d.ts +5 -0
- package/lib/EditUtilities.d.ts.map +1 -1
- package/lib/EditUtilities.js +4 -3
- package/lib/EditUtilities.js.map +1 -1
- package/lib/EventTypes.d.ts +11 -6
- package/lib/EventTypes.d.ts.map +1 -1
- package/lib/EventTypes.js +11 -6
- package/lib/EventTypes.js.map +1 -1
- package/lib/HistoryEditFactory.d.ts +5 -3
- package/lib/HistoryEditFactory.d.ts.map +1 -1
- package/lib/HistoryEditFactory.js +25 -6
- package/lib/HistoryEditFactory.js.map +1 -1
- package/lib/LogViewer.d.ts +12 -6
- package/lib/LogViewer.d.ts.map +1 -1
- package/lib/LogViewer.js.map +1 -1
- package/lib/RevisionValueCache.d.ts +8 -4
- package/lib/RevisionValueCache.d.ts.map +1 -1
- package/lib/RevisionValueCache.js +4 -2
- package/lib/RevisionValueCache.js.map +1 -1
- package/lib/SharedTree.d.ts +22 -11
- package/lib/SharedTree.d.ts.map +1 -1
- package/lib/SharedTree.js +26 -20
- package/lib/SharedTree.js.map +1 -1
- package/lib/StringInterner.d.ts +4 -3
- package/lib/StringInterner.d.ts.map +1 -1
- package/lib/StringInterner.js +4 -3
- package/lib/StringInterner.js.map +1 -1
- package/lib/Transaction.d.ts +2 -2
- package/lib/Transaction.d.ts.map +1 -1
- package/lib/Transaction.js +3 -2
- package/lib/Transaction.js.map +1 -1
- package/lib/TransactionInternal.d.ts.map +1 -1
- package/lib/TransactionInternal.js +1 -0
- package/lib/TransactionInternal.js.map +1 -1
- package/lib/id-compressor/IdCompressor.d.ts +14 -8
- package/lib/id-compressor/IdCompressor.d.ts.map +1 -1
- package/lib/id-compressor/IdCompressor.js +36 -15
- package/lib/id-compressor/IdCompressor.js.map +1 -1
- package/lib/id-compressor/NumericUuid.d.ts +4 -0
- package/lib/id-compressor/NumericUuid.d.ts.map +1 -1
- package/lib/id-compressor/NumericUuid.js +13 -3
- package/lib/id-compressor/NumericUuid.js.map +1 -1
- package/lib/id-compressor/SessionIdNormalizer.d.ts +10 -5
- package/lib/id-compressor/SessionIdNormalizer.d.ts.map +1 -1
- package/lib/id-compressor/SessionIdNormalizer.js +10 -5
- package/lib/id-compressor/SessionIdNormalizer.js.map +1 -1
- package/lib/id-compressor/persisted-types/0.0.1.d.ts.map +1 -1
- package/lib/id-compressor/persisted-types/0.0.1.js.map +1 -1
- package/lib/index.d.ts +1 -1
- package/lib/index.js +1 -1
- package/lib/index.js.map +1 -1
- package/lib/test/AppendOnlySortedMap.perf.tests.js.map +1 -1
- package/lib/test/Checkout.tests.d.ts.map +1 -1
- package/lib/test/Checkout.tests.js +39 -10
- package/lib/test/Checkout.tests.js.map +1 -1
- package/lib/test/Common.tests.js +20 -1
- package/lib/test/Common.tests.js.map +1 -1
- package/lib/test/HistoryEditFactory.tests.js +48 -9
- package/lib/test/HistoryEditFactory.tests.js.map +1 -1
- package/lib/test/IdCompressor.tests.js +23 -0
- package/lib/test/IdCompressor.tests.js.map +1 -1
- package/lib/test/SessionIdNormalizer.tests.js +3 -2
- package/lib/test/SessionIdNormalizer.tests.js.map +1 -1
- package/lib/test/fuzz/Generators.d.ts.map +1 -1
- package/lib/test/fuzz/Generators.js.map +1 -1
- package/lib/test/fuzz/SharedTreeFuzzTests.d.ts.map +1 -1
- package/lib/test/fuzz/SharedTreeFuzzTests.js +2 -3
- package/lib/test/fuzz/SharedTreeFuzzTests.js.map +1 -1
- package/lib/test/utilities/MockTransaction.d.ts.map +1 -1
- package/lib/test/utilities/MockTransaction.js +1 -0
- package/lib/test/utilities/MockTransaction.js.map +1 -1
- package/lib/test/utilities/SharedTreeTests.d.ts.map +1 -1
- package/lib/test/utilities/SharedTreeTests.js +35 -26
- package/lib/test/utilities/SharedTreeTests.js.map +1 -1
- package/lib/test/utilities/SharedTreeVersioningTests.d.ts.map +1 -1
- package/lib/test/utilities/SharedTreeVersioningTests.js +7 -0
- package/lib/test/utilities/SharedTreeVersioningTests.js.map +1 -1
- package/lib/test/utilities/TestUtilities.d.ts +5 -0
- package/lib/test/utilities/TestUtilities.d.ts.map +1 -1
- package/lib/test/utilities/TestUtilities.js +4 -3
- package/lib/test/utilities/TestUtilities.js.map +1 -1
- package/lib/test/utilities/UndoRedoTests.js +3 -2
- package/lib/test/utilities/UndoRedoTests.js.map +1 -1
- package/package.json +28 -23
- package/src/Checkout.ts +56 -14
- package/src/Common.ts +39 -21
- package/src/EditLog.ts +2 -2
- package/src/EditUtilities.ts +3 -3
- package/src/EventTypes.ts +12 -6
- package/src/HistoryEditFactory.ts +31 -6
- package/src/LogViewer.ts +12 -6
- package/src/RevisionValueCache.ts +8 -4
- package/src/SharedTree.ts +39 -26
- package/src/StringInterner.ts +4 -3
- package/src/Transaction.ts +5 -4
- package/src/TransactionInternal.ts +1 -0
- package/src/id-compressor/IdCompressor.ts +55 -24
- package/src/id-compressor/NumericUuid.ts +17 -3
- package/src/id-compressor/SessionIdNormalizer.ts +10 -5
- package/src/id-compressor/persisted-types/0.0.1.ts +1 -0
- package/src/index.ts +1 -1
package/dist/SharedTree.d.ts
CHANGED
|
@@ -93,8 +93,7 @@ export declare class SharedTreeFactory implements IChannelFactory {
|
|
|
93
93
|
* @param options - Configuration options for this tree
|
|
94
94
|
* @returns A factory that creates `SharedTree`s and loads them from storage.
|
|
95
95
|
*/
|
|
96
|
-
constructor(...args: SharedTreeArgs
|
|
97
|
-
constructor(...args: SharedTreeArgs<WriteFormat.v0_1_1>);
|
|
96
|
+
constructor(...args: SharedTreeArgs);
|
|
98
97
|
/**
|
|
99
98
|
* {@inheritDoc @fluidframework/shared-object-base#ISharedObjectFactory."type"}
|
|
100
99
|
*/
|
|
@@ -217,6 +216,10 @@ export declare class SharedTree extends SharedObject<ISharedTreeEvents> implemen
|
|
|
217
216
|
*/
|
|
218
217
|
static getFactory(...args: SharedTreeArgs<WriteFormat.v0_0_2>): SharedTreeFactory;
|
|
219
218
|
static getFactory(...args: SharedTreeArgs<WriteFormat.v0_1_1>): SharedTreeFactory;
|
|
219
|
+
/**
|
|
220
|
+
* Get a factory for SharedTree to register with the data store, using the latest write version and default options.
|
|
221
|
+
*/
|
|
222
|
+
static getFactory(): SharedTreeFactory;
|
|
220
223
|
/**
|
|
221
224
|
* The UUID used for attribution of nodes created by this SharedTree. All shared trees with a write format of 0.1.1 or
|
|
222
225
|
* greater have a unique attribution ID which may be configured in the constructor. All other shared trees (i.e. those
|
|
@@ -243,7 +246,10 @@ export declare class SharedTree extends SharedObject<ISharedTreeEvents> implemen
|
|
|
243
246
|
* Viewer for trees defined by editLog. This allows access to views of the tree at different revisions (various points in time).
|
|
244
247
|
*/
|
|
245
248
|
get logViewer(): LogViewer;
|
|
246
|
-
|
|
249
|
+
/**
|
|
250
|
+
* logger for SharedTree events.
|
|
251
|
+
*/
|
|
252
|
+
readonly logger: ITelemetryLogger;
|
|
247
253
|
private readonly sequencedEditAppliedLogger;
|
|
248
254
|
private readonly encoder_0_0_2;
|
|
249
255
|
private encoder_0_1_1;
|
|
@@ -400,14 +406,19 @@ export declare class SharedTree extends SharedObject<ISharedTreeEvents> implemen
|
|
|
400
406
|
* Equality means that the histories as captured by the EditLogs are equivalent.
|
|
401
407
|
*
|
|
402
408
|
* Equality does not include:
|
|
403
|
-
*
|
|
404
|
-
*
|
|
405
|
-
*
|
|
406
|
-
*
|
|
407
|
-
*
|
|
409
|
+
*
|
|
410
|
+
* - if an edit is open
|
|
411
|
+
*
|
|
412
|
+
* - the shared tree's id
|
|
413
|
+
*
|
|
414
|
+
* - local vs sequenced status of edits
|
|
415
|
+
*
|
|
416
|
+
* - registered event listeners
|
|
417
|
+
*
|
|
418
|
+
* - state of caches
|
|
408
419
|
*
|
|
409
420
|
* @internal
|
|
410
|
-
|
|
421
|
+
*/
|
|
411
422
|
equals(sharedTree: SharedTree): boolean;
|
|
412
423
|
/**
|
|
413
424
|
* {@inheritDoc @fluidframework/shared-object-base#SharedObject.loadCore}
|
|
@@ -444,8 +455,8 @@ export declare class SharedTree extends SharedObject<ISharedTreeEvents> implemen
|
|
|
444
455
|
* should be used instead.
|
|
445
456
|
* @public
|
|
446
457
|
*/
|
|
447
|
-
applyEdit(...changes: Change[]): Edit<InternalizedChange>;
|
|
448
|
-
applyEdit(changes: Change[]): Edit<InternalizedChange>;
|
|
458
|
+
applyEdit(...changes: readonly Change[]): Edit<InternalizedChange>;
|
|
459
|
+
applyEdit(changes: readonly Change[]): Edit<InternalizedChange>;
|
|
449
460
|
/**
|
|
450
461
|
* Merges `edits` from `other` into this SharedTree.
|
|
451
462
|
* @param other - Tree containing the edits that should be applied to this one.
|
package/dist/SharedTree.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"SharedTree.d.ts","sourceRoot":"","sources":["../src/SharedTree.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EACN,sBAAsB,EACtB,sBAAsB,EACtB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,QAAQ,EACR,MAAM,uCAAuC,CAAC;AAE/C,OAAO,EAEN,gBAAgB,EAChB,mBAAmB,EAEnB,YAAY,EACZ,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAE5F,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;
|
|
1
|
+
{"version":3,"file":"SharedTree.d.ts","sourceRoot":"","sources":["../src/SharedTree.ts"],"names":[],"mappings":"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"}
|
package/dist/SharedTree.js
CHANGED
|
@@ -34,6 +34,13 @@ const UuidUtilities_1 = require("./UuidUtilities");
|
|
|
34
34
|
* @public
|
|
35
35
|
*/
|
|
36
36
|
class SharedTreeFactory {
|
|
37
|
+
/**
|
|
38
|
+
* Get a factory for SharedTree to register with the data store.
|
|
39
|
+
* @param writeFormat - Determines the format version the SharedTree will write ops and summaries in. See [the write format
|
|
40
|
+
* documentation](../docs/Write-Format.md) for more information.
|
|
41
|
+
* @param options - Configuration options for this tree
|
|
42
|
+
* @returns A factory that creates `SharedTree`s and loads them from storage.
|
|
43
|
+
*/
|
|
37
44
|
constructor(...args) {
|
|
38
45
|
this.args = args;
|
|
39
46
|
}
|
|
@@ -185,19 +192,13 @@ class SharedTree extends shared_object_base_1.SharedObject {
|
|
|
185
192
|
return runtime.createChannel(id, SharedTreeFactory.Type);
|
|
186
193
|
}
|
|
187
194
|
static getFactory(...args) {
|
|
188
|
-
const [
|
|
195
|
+
const [formatArg, options] = args;
|
|
196
|
+
const writeFormat = formatArg !== null && formatArg !== void 0 ? formatArg : persisted_types_1.WriteFormat.v0_1_1;
|
|
189
197
|
// On 0.1.1 documents, due to current code limitations, all clients MUST agree on the value of `summarizeHistory`.
|
|
190
198
|
// Note that this means staged rollout changing this value should not be attempted.
|
|
191
199
|
// It is possible to update shared-tree to correctly handle such a staged rollout, but that hasn't been implemented.
|
|
192
200
|
// See the skipped test in SharedTreeFuzzTests.ts for more details on this issue.
|
|
193
|
-
|
|
194
|
-
case persisted_types_1.WriteFormat.v0_0_2:
|
|
195
|
-
return new SharedTreeFactory(...args);
|
|
196
|
-
case persisted_types_1.WriteFormat.v0_1_1:
|
|
197
|
-
return new SharedTreeFactory(...args);
|
|
198
|
-
default:
|
|
199
|
-
(0, Common_1.fail)('Unknown write format');
|
|
200
|
-
}
|
|
201
|
+
return new SharedTreeFactory(writeFormat, options);
|
|
201
202
|
}
|
|
202
203
|
/**
|
|
203
204
|
* The UUID used for attribution of nodes created by this SharedTree. All shared trees with a write format of 0.1.1 or
|
|
@@ -420,7 +421,7 @@ class SharedTree extends shared_object_base_1.SharedObject {
|
|
|
420
421
|
* @internal
|
|
421
422
|
*/
|
|
422
423
|
saveSerializedSummary(options) {
|
|
423
|
-
const { serializer } = options
|
|
424
|
+
const { serializer } = options !== null && options !== void 0 ? options : {};
|
|
424
425
|
return (0, Summary_1.serialize)(this.saveSummary(), serializer !== null && serializer !== void 0 ? serializer : this.serializer, this.handle);
|
|
425
426
|
}
|
|
426
427
|
/**
|
|
@@ -619,14 +620,19 @@ class SharedTree extends shared_object_base_1.SharedObject {
|
|
|
619
620
|
* Equality means that the histories as captured by the EditLogs are equivalent.
|
|
620
621
|
*
|
|
621
622
|
* Equality does not include:
|
|
622
|
-
*
|
|
623
|
-
*
|
|
624
|
-
*
|
|
625
|
-
*
|
|
626
|
-
*
|
|
623
|
+
*
|
|
624
|
+
* - if an edit is open
|
|
625
|
+
*
|
|
626
|
+
* - the shared tree's id
|
|
627
|
+
*
|
|
628
|
+
* - local vs sequenced status of edits
|
|
629
|
+
*
|
|
630
|
+
* - registered event listeners
|
|
631
|
+
*
|
|
632
|
+
* - state of caches
|
|
627
633
|
*
|
|
628
634
|
* @internal
|
|
629
|
-
|
|
635
|
+
*/
|
|
630
636
|
equals(sharedTree) {
|
|
631
637
|
if (!(0, EditUtilities_1.areRevisionViewsSemanticallyEqual)(this.currentView, this, sharedTree.currentView, sharedTree)) {
|
|
632
638
|
return false;
|
|
@@ -848,8 +854,8 @@ class SharedTree extends shared_object_base_1.SharedObject {
|
|
|
848
854
|
newIdCompressor.finalizeCreationRange(ghostIdCompressor.takeNextCreationRange());
|
|
849
855
|
this.idCompressor = newIdCompressor;
|
|
850
856
|
}
|
|
851
|
-
applyEdit(
|
|
852
|
-
const changes =
|
|
857
|
+
applyEdit(...changesOrArray) {
|
|
858
|
+
const changes = (0, Common_1.unwrapRestOrArray)(changesOrArray);
|
|
853
859
|
const id = (0, EditUtilities_1.newEditId)();
|
|
854
860
|
const internalEdit = {
|
|
855
861
|
id,
|
|
@@ -999,7 +1005,7 @@ class SharedTree extends shared_object_base_1.SharedObject {
|
|
|
999
1005
|
* @internal
|
|
1000
1006
|
*/
|
|
1001
1007
|
revertChanges(changes, before) {
|
|
1002
|
-
return (0, HistoryEditFactory_1.revert)(changes, before);
|
|
1008
|
+
return (0, HistoryEditFactory_1.revert)(changes, before, this.logger);
|
|
1003
1009
|
}
|
|
1004
1010
|
/**
|
|
1005
1011
|
* Submits an edit by the local client to the runtime.
|