@fluid-experimental/tree 0.58.2001 → 0.59.2000-61729

package/lib/SharedTreeEncoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SharedTreeEncoder.js","sourceRoot":"","sources":["../src/SharedTreeEncoder.ts"],"names":[],"mappings":"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","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { IsoBuffer } from '@fluidframework/common-utils';\nimport { assert, fail } from './Common';\nimport { EditLog } from './EditLog';\nimport { convertTreeNodes, newEdit } from './EditUtilities';\nimport { DetachedSequenceId, FinalNodeId, OpSpaceNodeId, TraitLabel } from './Identifiers';\nimport { initialTree } from './InitialTree';\nimport {\n\tContextualizedNodeIdNormalizer,\n\tgetNodeIdContext,\n\tNodeIdContext,\n\tNodeIdConverter,\n\tNodeIdGenerator,\n\tNodeIdNormalizer,\n\tscopeIdNormalizer,\n\tsequencedIdNormalizer,\n} from './NodeIdUtilities';\nimport { getChangeNodeFromView, getChangeNode_0_0_2FromView } from './SerializationUtilities';\nimport {\n\tCompressedChangeInternal,\n\tChangeInternal,\n\tSharedTreeSummary_0_0_2,\n\tWriteFormat,\n\tChangeNode,\n\tEdit,\n\tSharedTreeEditOp,\n\tSharedTreeOpType,\n\tSharedTreeSummary,\n\tEditWithoutId,\n\tChangeTypeInternal,\n\tChangeInternal_0_0_2,\n\tSharedTreeEditOp_0_0_2,\n\treservedIdCount,\n\tChangeNode_0_0_2,\n\tEditChunkContents,\n\tEditLogSummary,\n\tEditChunkContents_0_1_1,\n\tFluidEditHandle,\n\tStablePlaceInternal,\n\tSide,\n} from './persisted-types';\nimport { RevisionView } from './RevisionView';\nimport { MutableStringInterner, StringInterner } from './StringInterner';\nimport { SummaryContents } from './Summary';\nimport { InterningTreeCompressor } from './TreeCompressor';\nimport {\n\tcreateSessionId,\n\thasOngoingSession,\n\tIdCompressor,\n\tIdCreationRange,\n\tSerializedIdCompressorWithNoSession,\n} from './id-compressor';\nimport { ChangeCompressor, compressEdit, decompressEdit } from './ChangeCompression';\nimport { convertEditIds, convertNodeDataIds } from './IdConversion';\n\n/**\n * Object capable of converting between the current internal representation for 0.1.1 edits and their wire format.\n * @internal\n */\nexport class SharedTreeEncoder_0_1_1 {\n\tprivate readonly treeCompressor = new InterningTreeCompressor<never>();\n\tprivate readonly changeCompressor = new ChangeCompressor(this.treeCompressor);\n\n\tpublic constructor(private readonly summarizeHistory: boolean) {}\n\n\t/**\n\t * Encodes an edit op to be sent.\n\t * @param edit - edit to encode.\n\t * @param fluidSerialize - Callback which serializes Fluid handles contained in a JSON-serializable object, returning the result.\n\t * Should be invoked on the edit contents at some point before op encoding is complete.\n\t * This is because edit contents may have Payloads needing to be serialized.\n\t */\n\tpublic encodeEditOp(\n\t\tedit: Edit<ChangeInternal>,\n\t\tfluidSerialize: (\n\t\t\tedit: Edit<CompressedChangeInternal<OpSpaceNodeId>>\n\t\t) => Edit<CompressedChangeInternal<OpSpaceNodeId>>,\n\t\tidRange: IdCreationRange,\n\t\tidNormalizer: NodeIdNormalizer<OpSpaceNodeId>,\n\t\tinterner: StringInterner\n\t): SharedTreeEditOp {\n\t\t// IFluidHandles are not allowed in Ops.\n\t\t// Ops can contain Fluid's Serializable (for payloads) which allows IFluidHandles.\n\t\t// So replace the handles by encoding before sending:\n\t\tconst semiSerialized = fluidSerialize(\n\t\t\tcompressEdit(this.changeCompressor, interner, scopeIdNormalizer(idNormalizer, idRange.sessionId), edit)\n\t\t);\n\n\t\treturn {\n\t\t\ttype: SharedTreeOpType.Edit,\n\t\t\tedit: semiSerialized,\n\t\t\tversion: WriteFormat.v0_1_1,\n\t\t\tidRange,\n\t\t};\n\t}\n\n\t/**\n\t * Decodes an edit op encoded with `encodeEditOp`.\n\t * @param op - op to decode.\n\t * @param fluidDeserialize - Callback which deserializes Fluid handles contained in a JSON-serializable object.\n\t * Should be invoked on the semi-serialized edit contents at some point before decoding is complete.\n\t * This will rehydrate any serialized Fluid handles into usable IFluidHandle objects.\n\t */\n\tpublic decodeEditOp(\n\t\top: SharedTreeEditOp,\n\t\tfluidDeserialize: (\n\t\t\tsemiSerializedEdit: Edit<CompressedChangeInternal<OpSpaceNodeId>>\n\t\t) => Edit<CompressedChangeInternal<OpSpaceNodeId>>,\n\t\tidNormalizer: NodeIdNormalizer<OpSpaceNodeId>,\n\t\tinterner: StringInterner\n\t): Edit<ChangeInternal> {\n\t\tconst { edit: semiSerializedEdit } = op;\n\t\tconst parsedEdit = fluidDeserialize(semiSerializedEdit);\n\t\treturn decompressEdit(\n\t\t\tthis.changeCompressor,\n\t\t\tinterner,\n\t\t\tscopeIdNormalizer(idNormalizer, op.idRange.sessionId),\n\t\t\tparsedEdit\n\t\t);\n\t}\n\n\t/**\n\t * Encodes a summary.\n\t */\n\tpublic encodeSummary(\n\t\tedits: EditLog<ChangeInternal>,\n\t\tcurrentView: RevisionView,\n\t\tidContext: NodeIdContext,\n\t\tidNormalizer: NodeIdNormalizer<OpSpaceNodeId>,\n\t\tinterner: StringInterner,\n\t\tserializedIdCompressor: SerializedIdCompressorWithNoSession\n\t): SharedTreeSummary {\n\t\tif (this.summarizeHistory) {\n\t\t\treturn this.fullHistorySummarizer(edits, currentView, idNormalizer, interner, serializedIdCompressor);\n\t\t} else {\n\t\t\treturn this.noHistorySummarizer(\n\t\t\t\tedits,\n\t\t\t\tcurrentView,\n\t\t\t\tidContext,\n\t\t\t\tidNormalizer,\n\t\t\t\tinterner,\n\t\t\t\tserializedIdCompressor\n\t\t\t);\n\t\t}\n\t}\n\n\t/**\n\t * Decodes an encoded summary.\n\t */\n\tpublic decodeSummary({\n\t\teditHistory,\n\t\tcurrentTree: compressedTree,\n\t\tinternedStrings,\n\t\tidCompressor: serializedIdCompressor,\n\t\tversion,\n\t}: SharedTreeSummary): SummaryContents {\n\t\tassert(version === WriteFormat.v0_1_1, `Invalid summary version to decode: ${version}, expected: 0.1.1`);\n\t\tassert(typeof editHistory === 'object', '0.1.1 summary encountered with non-object edit history.');\n\n\t\tconst idCompressor = hasOngoingSession(serializedIdCompressor)\n\t\t\t? IdCompressor.deserialize(serializedIdCompressor)\n\t\t\t: IdCompressor.deserialize(serializedIdCompressor, createSessionId()); // TODO attribution\n\n\t\tconst interner = new MutableStringInterner(internedStrings);\n\t\tconst sequencedNormalizer = sequencedIdNormalizer(getNodeIdContext(idCompressor));\n\t\tconst decompressedTree: ChangeNode | undefined =\n\t\t\tcompressedTree !== undefined\n\t\t\t\t? this.treeCompressor.decompress(compressedTree, interner, sequencedNormalizer)\n\t\t\t\t: undefined;\n\t\tconst { editChunks, editIds } = editHistory;\n\t\tassert(editChunks !== undefined, 'Missing editChunks on 0.1.1 summary.');\n\t\tassert(editIds !== undefined, 'Missing editIds on 0.1.1 summary.');\n\n\t\tconst uncompressedChunks = editChunks.map(({ startRevision, chunk }) => ({\n\t\t\tstartRevision,\n\t\t\tchunk: isEditHandle(chunk)\n\t\t\t\t? {\n\t\t\t\t\t\tget: async () => {\n\t\t\t\t\t\t\tconst baseHandle = chunk;\n\t\t\t\t\t\t\tconst contents: EditChunkContents = JSON.parse(\n\t\t\t\t\t\t\t\tIsoBuffer.from(await baseHandle.get()).toString()\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t// Note: any interned IDs referenced in chunks taken at the time of summarization must be included\n\t\t\t\t\t\t\t// in the summary. So this interner is sufficient.\n\t\t\t\t\t\t\treturn this.decodeEditChunk(contents, sequencedNormalizer, interner);\n\t\t\t\t\t\t},\n\t\t\t\t\t\tbaseHandle: chunk,\n\t\t\t\t  }\n\t\t\t\t: chunk.map((edit) => decompressEdit(this.changeCompressor, interner, sequencedNormalizer, edit)),\n\t\t}));\n\t\treturn {\n\t\t\tcurrentTree: decompressedTree,\n\t\t\teditHistory: { editIds, editChunks: uncompressedChunks },\n\t\t\tidCompressor,\n\t\t\tinterner,\n\t\t};\n\t}\n\n\t/**\n\t * Does not preserve (persist) history at all.\n\t * Instead, the history returned in the summary will contain a single edit that creates a revision identical to the supplied view.\n\t * Writes summary format 0.1.1 which does not store the currentView for no history summaries.\n\t */\n\tprivate noHistorySummarizer<TChange>(\n\t\t_edits: EditLog<TChange>,\n\t\tcurrentView: RevisionView,\n\t\tidContext: NodeIdContext,\n\t\tidNormalizer: NodeIdNormalizer<OpSpaceNodeId>,\n\t\tinterner: StringInterner,\n\t\tserializedIdCompressor: SerializedIdCompressorWithNoSession\n\t): SharedTreeSummary {\n\t\tconst currentTree = getChangeNodeFromView(currentView);\n\t\tconst initialTreeId = idContext.convertToNodeId(initialTree.identifier);\n\t\tconst changes: ChangeInternal[] = [];\n\t\t// Generate a set of changes to set the root node's children to that of the root in the currentTree\n\t\tObject.entries(currentTree.traits).forEach(([label, children]) => {\n\t\t\tconst id = 0 as DetachedSequenceId;\n\t\t\tchanges.push(\n\t\t\t\tChangeInternal.build(children, id),\n\t\t\t\tChangeInternal.insert(\n\t\t\t\t\tid,\n\t\t\t\t\tStablePlaceInternal.atStartOf({ parent: initialTreeId, label: label as TraitLabel })\n\t\t\t\t)\n\t\t\t);\n\t\t});\n\n\t\tif (currentTree.payload !== undefined) {\n\t\t\tchanges.push(ChangeInternal.setPayload(initialTreeId, currentTree.payload));\n\t\t}\n\n\t\tassert(\n\t\t\tcurrentTree.identifier === initialTreeId && currentTree.definition === initialTree.definition,\n\t\t\t'root definition and identifier should be immutable.'\n\t\t);\n\t\tconst edit = newEdit(changes);\n\t\tconst compressedChanges = edit.changes.map((change) =>\n\t\t\tthis.changeCompressor.compress(change, interner, sequencedIdNormalizer(idNormalizer))\n\t\t);\n\t\treturn {\n\t\t\teditHistory: {\n\t\t\t\teditChunks: [{ startRevision: 0, chunk: [{ changes: compressedChanges }] }],\n\t\t\t\teditIds: [edit.id],\n\t\t\t},\n\t\t\tversion: WriteFormat.v0_1_1,\n\t\t\tinternedStrings: interner.getSerializable(),\n\t\t\tidCompressor: serializedIdCompressor,\n\t\t};\n\t}\n\n\t/**\n\t * Generates a summary with format version 0.1.1. This will prefer handles over edits in edit chunks where possible,\n\t * and string interning and tree compression will be applied.\n\t */\n\tprivate fullHistorySummarizer(\n\t\tedits: EditLog<ChangeInternal>,\n\t\tcurrentView: RevisionView,\n\t\tidNormalizer: NodeIdNormalizer<OpSpaceNodeId>,\n\t\tinterner: StringInterner,\n\t\tserializedIdCompressor: SerializedIdCompressorWithNoSession\n\t): SharedTreeSummary {\n\t\tconst sequencedNormalizer = sequencedIdNormalizer(idNormalizer);\n\t\tconst currentTree = this.treeCompressor.compress(\n\t\t\tgetChangeNodeFromView(currentView),\n\t\t\tinterner,\n\t\t\tsequencedNormalizer\n\t\t);\n\n\t\treturn {\n\t\t\tcurrentTree,\n\t\t\teditHistory: edits.getEditLogSummary((edit) =>\n\t\t\t\tcompressEdit(this.changeCompressor, interner, sequencedNormalizer, edit)\n\t\t\t),\n\t\t\tversion: WriteFormat.v0_1_1,\n\t\t\tinternedStrings: interner.getSerializable(),\n\t\t\tidCompressor: serializedIdCompressor,\n\t\t};\n\t}\n\n\tpublic encodeEditChunk(\n\t\tedits: readonly EditWithoutId<ChangeInternal>[],\n\t\tidNormalizer: ContextualizedNodeIdNormalizer<FinalNodeId>,\n\t\tinterner: StringInterner\n\t): EditChunkContents_0_1_1 {\n\t\tconst compressedEdits = edits.map((edit) => compressEdit(this.changeCompressor, interner, idNormalizer, edit));\n\t\treturn {\n\t\t\tversion: WriteFormat.v0_1_1,\n\t\t\tedits: compressedEdits,\n\t\t};\n\t}\n\n\tpublic decodeEditChunk(\n\t\tcontents: EditChunkContents,\n\t\tidNormalizer: ContextualizedNodeIdNormalizer<FinalNodeId>,\n\t\tinterner: StringInterner\n\t): EditWithoutId<ChangeInternal>[] {\n\t\tassert(\n\t\t\tcontents.version === WriteFormat.v0_1_1,\n\t\t\t`Invalid editChunk to decode: ${contents.version}. Expected 0.1.1.`\n\t\t);\n\t\treturn contents.edits.map((edit) => decompressEdit(this.changeCompressor, interner, idNormalizer, edit));\n\t}\n}\n\n/**\n * Object capable of converting between the current internal representation for 0.0.2 edits and their wire format.\n * @internal\n */\nexport class SharedTreeEncoder_0_0_2 {\n\tpublic constructor(private readonly summarizeHistory: boolean) {}\n\n\t/**\n\t * Encodes an edit op to be sent.\n\t * @param edit - edit to encode.\n\t * @param fluidSerialize - Callback which serializes Fluid handles contained in a JSON-serializable object, returning the result.\n\t * Should be invoked on the edit contents at some point before op encoding is complete.\n\t * This is because edit contents may have Payloads needing to be serialized.\n\t */\n\tpublic encodeEditOp(\n\t\tedit: Edit<ChangeInternal>,\n\t\tfluidSerialize: (edit: Edit<ChangeInternal_0_0_2>) => Edit<ChangeInternal_0_0_2>,\n\t\tidConverter: NodeIdConverter\n\t): SharedTreeEditOp_0_0_2 {\n\t\t// IFluidHandles are not allowed in Ops.\n\t\t// Ops can contain Fluid's Serializable (for payloads) which allows IFluidHandles.\n\t\t// So replace the handles by encoding before sending:\n\t\tconst semiSerialized = fluidSerialize(convertEditIds(edit, (id) => idConverter.convertToStableNodeId(id)));\n\n\t\treturn {\n\t\t\ttype: SharedTreeOpType.Edit,\n\t\t\tedit: semiSerialized,\n\t\t\tversion: WriteFormat.v0_0_2,\n\t\t};\n\t}\n\n\t/**\n\t * Decodes an edit op encoded with `encodeEditOp`.\n\t * @param op - op to decode.\n\t * @param fluidDeserialize - Callback which deserializes Fluid handles contained in a JSON-serializable object.\n\t * Should be invoked on the semi-serialized edit contents at some point before decoding is complete.\n\t * This will rehydrate any serialized Fluid handles into usable IFluidHandle objects.\n\t */\n\tpublic decodeEditOp(\n\t\top: SharedTreeEditOp_0_0_2,\n\t\tfluidDeserialize: (semiSerializedEdit: Edit<ChangeInternal_0_0_2>) => Edit<ChangeInternal_0_0_2>,\n\t\tidGenerator: NodeIdGenerator\n\t): Edit<ChangeInternal> {\n\t\tconst { edit: semiSerializedEdit } = op;\n\t\tconst parsedEdit = fluidDeserialize(semiSerializedEdit);\n\t\treturn convertEditIds(parsedEdit, (id) => idGenerator.generateNodeId(id));\n\t}\n\n\t/**\n\t * Encodes a summary.\n\t */\n\tpublic encodeSummary(\n\t\tedits: EditLog<ChangeInternal>,\n\t\tcurrentView: RevisionView,\n\t\tidConverter: NodeIdConverter\n\t): SharedTreeSummary_0_0_2 {\n\t\tif (this.summarizeHistory) {\n\t\t\treturn this.fullHistorySummarizer(edits, currentView, idConverter);\n\t\t} else {\n\t\t\treturn this.noHistorySummarizer(edits, currentView, idConverter);\n\t\t}\n\t}\n\n\t/**\n\t * Decodes an encoded summary.\n\t */\n\tpublic decodeSummary({ currentTree, sequencedEdits }: SharedTreeSummary_0_0_2): SummaryContents {\n\t\tassert(sequencedEdits !== undefined, '0.0.2 summary encountered with missing sequencedEdits field.');\n\t\tconst idCompressor = new IdCompressor(createSessionId(), reservedIdCount);\n\t\tconst idGenerator = getNodeIdContext(idCompressor);\n\t\tconst generateId = (id) => idGenerator.generateNodeId(id);\n\n\t\t// This saves all of the edits in the summary as part of the first chunk.\n\t\tconst temporaryLog = new EditLog<ChangeInternal>();\n\t\tsequencedEdits.forEach((edit) =>\n\t\t\ttemporaryLog.addSequencedEdit(convertEditIds(edit, generateId), {\n\t\t\t\tsequenceNumber: 1,\n\t\t\t\treferenceSequenceNumber: 0,\n\t\t\t})\n\t\t);\n\n\t\treturn {\n\t\t\tcurrentTree: convertTreeNodes<ChangeNode_0_0_2, ChangeNode>(currentTree, (node) =>\n\t\t\t\tconvertNodeDataIds(node, generateId)\n\t\t\t),\n\t\t\tidCompressor,\n\t\t\tinterner: new MutableStringInterner(),\n\t\t\t// This cast is valid because we just constructed this log and gave it only in-session edits.\n\t\t\teditHistory: temporaryLog.getEditLogSummary() as EditLogSummary<ChangeInternal, never>,\n\t\t};\n\t}\n\n\t/**\n\t * Does not preserve (persist) history at all.\n\t * Instead, the history returned in the summary will contain a single edit that creates a revision identical to the supplied view.\n\t * @param stable - Generates the single edit with a stable edit ID. False by default, used for testing.\n\t */\n\tprivate noHistorySummarizer<TChange>(\n\t\t_edits: EditLog<TChange>,\n\t\tcurrentView: RevisionView,\n\t\tidConverter: NodeIdConverter\n\t): SharedTreeSummary_0_0_2 {\n\t\tconst currentTree = getChangeNode_0_0_2FromView(currentView, idConverter);\n\t\tconst changes: ChangeInternal_0_0_2[] = [];\n\t\t// Generate a set of changes to set the root node's children to that of the root in the currentTree\n\t\tObject.entries(currentTree.traits).forEach(([label, children]) => {\n\t\t\tconst id = 0 as DetachedSequenceId;\n\t\t\tchanges.push(\n\t\t\t\t{ type: ChangeTypeInternal.Build, source: children, destination: id },\n\t\t\t\t{\n\t\t\t\t\ttype: ChangeTypeInternal.Insert,\n\t\t\t\t\tsource: id,\n\t\t\t\t\tdestination: {\n\t\t\t\t\t\tside: Side.After,\n\t\t\t\t\t\treferenceTrait: { label: label as TraitLabel, parent: initialTree.identifier },\n\t\t\t\t\t},\n\t\t\t\t}\n\t\t\t);\n\t\t});\n\n\t\tif (currentTree.payload !== undefined) {\n\t\t\tchanges.push({\n\t\t\t\ttype: ChangeTypeInternal.SetValue,\n\t\t\t\tnodeToModify: initialTree.identifier,\n\t\t\t\tpayload: currentTree.payload,\n\t\t\t});\n\t\t}\n\n\t\tassert(\n\t\t\tcurrentTree.identifier === initialTree.identifier && currentTree.definition === initialTree.definition,\n\t\t\t'root definition and identifier should be immutable.'\n\t\t);\n\t\tconst edit = newEdit(changes);\n\n\t\treturn {\n\t\t\tcurrentTree,\n\t\t\tsequencedEdits: [\n\t\t\t\t{\n\t\t\t\t\tid: edit.id,\n\t\t\t\t\tchanges: edit.changes,\n\t\t\t\t},\n\t\t\t],\n\t\t\tversion: WriteFormat.v0_0_2,\n\t\t};\n\t}\n\t/**\n\t * Preserves the full history in the generated summary.\n\t */\n\tprivate fullHistorySummarizer(\n\t\tedits: EditLog<ChangeInternal>,\n\t\tcurrentView: RevisionView,\n\t\tidConverter: NodeIdConverter\n\t): SharedTreeSummary_0_0_2 {\n\t\tconst { editChunks, editIds } = edits.getEditLogSummary();\n\n\t\tconst sequencedEdits: Edit<ChangeInternal_0_0_2>[] = [];\n\t\tlet idIndex = 0;\n\t\teditChunks.forEach(({ chunk }) => {\n\t\t\tif (isEditHandle(chunk)) {\n\t\t\t\tfail('Cannot write handles to summary version 0.0.2');\n\t\t\t} else {\n\t\t\t\tchunk.forEach(({ changes }) => {\n\t\t\t\t\tsequencedEdits.push(\n\t\t\t\t\t\tconvertEditIds(\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\tchanges,\n\t\t\t\t\t\t\t\tid: editIds[idIndex++] ?? fail('Number of edits should match number of edit IDs.'),\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t(id) => idConverter.convertToStableNodeId(id)\n\t\t\t\t\t\t)\n\t\t\t\t\t);\n\t\t\t\t});\n\t\t\t}\n\t\t});\n\n\t\treturn {\n\t\t\tcurrentTree: getChangeNode_0_0_2FromView(currentView, idConverter),\n\t\t\tsequencedEdits,\n\t\t\tversion: WriteFormat.v0_0_2,\n\t\t};\n\t}\n}\n\nfunction isEditHandle(chunk: FluidEditHandle | readonly EditWithoutId<unknown>[]): chunk is FluidEditHandle {\n\treturn !Array.isArray(chunk);\n}\n"]}

package/lib/StringInterner.d.ts

@@ -0,0 +1,46 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import type { InternedStringId } from './Identifiers';
+/**
+ * Interns strings as integers.
+ */
+export interface StringInterner {
+    getInternedId(input: string): InternedStringId | undefined;
+    getString(internedId: number): string;
+    getSerializable(): readonly string[];
+}
+/**
+ * Interns strings as integers.
+ * Given a string, this class will produce a unique integer associated with that string that can then be used to retrieve the string.
+ */
+export declare class MutableStringInterner implements StringInterner {
+    private readonly stringToInternedIdMap;
+    private readonly internedStrings;
+    /**
+     * @param inputStrings - A list of strings to intern in the order given. Can be used to rehydrate from a previous
+     * `StringInterner`'s {@link StringInterner.getSerializable} return value.
+     */
+    constructor(inputStrings?: readonly string[]);
+    /**
+     * @param input - The string to get the associated intern ID for
+     * @returns an intern ID that is uniquely associated with the input string
+     */
+    getOrCreateInternedId(input: string): InternedStringId;
+    getInternedId(input: string): InternedStringId | undefined;
+    /**
+     *
+     * @param internId - The intern ID to get the associated string for. Can only retrieve strings that have been used as inputs to
+     *                   calls of `getInternId`.
+     * @returns a string that is uniquely associated with the given intern ID
+     */
+    getString(internId: number): string;
+    /**
+     * @returns the list of strings interned where the indices map to the associated {@link InternedStringId} of each string
+     */
+    getSerializable(): readonly string[];
+    /** Create a new interned id. Assumes without validation that the input doesn't already have an interned id. */
+    private createNewId;
+}
+//# sourceMappingURL=StringInterner.d.ts.map

package/lib/StringInterner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StringInterner.d.ts","sourceRoot":"","sources":["../src/StringInterner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAAC;IAC3D,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;IACtC,eAAe,IAAI,SAAS,MAAM,EAAE,CAAC;CACrC;AAED;;;GAGG;AACH,qBAAa,qBAAsB,YAAW,cAAc;IAC3D,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAuC;IAC7E,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAgB;IAEhD;;;OAGG;gBACS,YAAY,GAAE,SAAS,MAAM,EAAO;IAMhD;;;OAGG;IACI,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB;IAItD,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAIjE;;;;;OAKG;IACI,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAI1C;;OAEG;IACI,eAAe,IAAI,SAAS,MAAM,EAAE;IAI3C,+GAA+G;IAC/G,OAAO,CAAC,WAAW;CAMnB"}

package/lib/StringInterner.js

@@ -0,0 +1,57 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { fail } from './Common';
+/**
+ * Interns strings as integers.
+ * Given a string, this class will produce a unique integer associated with that string that can then be used to retrieve the string.
+ */
+export class MutableStringInterner {
+    /**
+     * @param inputStrings - A list of strings to intern in the order given. Can be used to rehydrate from a previous
+     * `StringInterner`'s {@link StringInterner.getSerializable} return value.
+     */
+    constructor(inputStrings = []) {
+        this.stringToInternedIdMap = new Map();
+        this.internedStrings = [];
+        for (const value of inputStrings) {
+            this.getOrCreateInternedId(value);
+        }
+    }
+    /**
+     * @param input - The string to get the associated intern ID for
+     * @returns an intern ID that is uniquely associated with the input string
+     */
+    getOrCreateInternedId(input) {
+        var _a;
+        return (_a = this.getInternedId(input)) !== null && _a !== void 0 ? _a : this.createNewId(input);
+    }
+    getInternedId(input) {
+        return this.stringToInternedIdMap.get(input);
+    }
+    /**
+     *
+     * @param internId - The intern ID to get the associated string for. Can only retrieve strings that have been used as inputs to
+     *                   calls of `getInternId`.
+     * @returns a string that is uniquely associated with the given intern ID
+     */
+    getString(internId) {
+        var _a;
+        return (_a = this.internedStrings[internId]) !== null && _a !== void 0 ? _a : fail(`No string associated with ${internId}.`);
+    }
+    /**
+     * @returns the list of strings interned where the indices map to the associated {@link InternedStringId} of each string
+     */
+    getSerializable() {
+        return this.internedStrings;
+    }
+    /** Create a new interned id. Assumes without validation that the input doesn't already have an interned id. */
+    createNewId(input) {
+        const internedId = this.stringToInternedIdMap.size;
+        this.stringToInternedIdMap.set(input, internedId);
+        this.internedStrings.push(input);
+        return internedId;
+    }
+}
+//# sourceMappingURL=StringInterner.js.map

package/lib/StringInterner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StringInterner.js","sourceRoot":"","sources":["../src/StringInterner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAYhC;;;GAGG;AACH,MAAM,OAAO,qBAAqB;IAIjC;;;OAGG;IACH,YAAY,eAAkC,EAAE;QAP/B,0BAAqB,GAAG,IAAI,GAAG,EAA4B,CAAC;QAC5D,oBAAe,GAAa,EAAE,CAAC;QAO/C,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE;YACjC,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;SAClC;IACF,CAAC;IAED;;;OAGG;IACI,qBAAqB,CAAC,KAAa;;QACzC,aAAO,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,mCAAI,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IAC7D,CAAC;IAEM,aAAa,CAAC,KAAa;QACjC,OAAO,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;OAKG;IACI,SAAS,CAAC,QAAgB;;QAChC,aAAO,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,mCAAI,IAAI,CAAC,6BAA6B,QAAQ,GAAG,CAAC,CAAC;IACzF,CAAC;IAED;;OAEG;IACI,eAAe;QACrB,OAAO,IAAI,CAAC,eAAe,CAAC;IAC7B,CAAC;IAED,+GAA+G;IACvG,WAAW,CAAC,KAAa;QAChC,MAAM,UAAU,GAAG,IAAI,CAAC,qBAAqB,CAAC,IAAwB,CAAC;QACvE,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QAClD,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjC,OAAO,UAAU,CAAC;IACnB,CAAC;CACD","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { fail } from './Common';\nimport type { InternedStringId } from './Identifiers';\n\n/**\n * Interns strings as integers.\n */\nexport interface StringInterner {\n\tgetInternedId(input: string): InternedStringId | undefined;\n\tgetString(internedId: number): string;\n\tgetSerializable(): readonly string[];\n}\n\n/**\n * Interns strings as integers.\n * Given a string, this class will produce a unique integer associated with that string that can then be used to retrieve the string.\n */\nexport class MutableStringInterner implements StringInterner {\n\tprivate readonly stringToInternedIdMap = new Map<string, InternedStringId>();\n\tprivate readonly internedStrings: string[] = [];\n\n\t/**\n\t * @param inputStrings - A list of strings to intern in the order given. Can be used to rehydrate from a previous\n\t * `StringInterner`'s {@link StringInterner.getSerializable} return value.\n\t */\n\tconstructor(inputStrings: readonly string[] = []) {\n\t\tfor (const value of inputStrings) {\n\t\t\tthis.getOrCreateInternedId(value);\n\t\t}\n\t}\n\n\t/**\n\t * @param input - The string to get the associated intern ID for\n\t * @returns an intern ID that is uniquely associated with the input string\n\t */\n\tpublic getOrCreateInternedId(input: string): InternedStringId {\n\t\treturn this.getInternedId(input) ?? this.createNewId(input);\n\t}\n\n\tpublic getInternedId(input: string): InternedStringId | undefined {\n\t\treturn this.stringToInternedIdMap.get(input);\n\t}\n\n\t/**\n\t *\n\t * @param internId - The intern ID to get the associated string for. Can only retrieve strings that have been used as inputs to\n\t *                   calls of `getInternId`.\n\t * @returns a string that is uniquely associated with the given intern ID\n\t */\n\tpublic getString(internId: number): string {\n\t\treturn this.internedStrings[internId] ?? fail(`No string associated with ${internId}.`);\n\t}\n\n\t/**\n\t * @returns the list of strings interned where the indices map to the associated {@link InternedStringId} of each string\n\t */\n\tpublic getSerializable(): readonly string[] {\n\t\treturn this.internedStrings;\n\t}\n\n\t/** Create a new interned id. Assumes without validation that the input doesn't already have an interned id. */\n\tprivate createNewId(input: string): InternedStringId {\n\t\tconst internedId = this.stringToInternedIdMap.size as InternedStringId;\n\t\tthis.stringToInternedIdMap.set(input, internedId);\n\t\tthis.internedStrings.push(input);\n\t\treturn internedId;\n\t}\n}\n"]}

package/lib/Summary.d.ts

@@ -0,0 +1,40 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import type { IFluidHandle } from '@fluidframework/core-interfaces';
+import { IFluidSerializer } from '@fluidframework/shared-object-base';
+import type { IdCompressor } from './id-compressor';
+import type { EditLogSummary, SharedTreeSummaryBase, ChangeNode, ChangeInternal } from './persisted-types';
+import type { EditHandle } from './EditLog';
+import type { MutableStringInterner } from './StringInterner';
+/**
+ * The contents of a SharedTree summary, converted to a common internal format that can be
+ * loaded into a SharedTree.
+ * @internal
+ */
+export interface SummaryContents {
+    readonly currentTree?: ChangeNode;
+    /**
+     * Information that can populate an edit log.
+     */
+    readonly editHistory: EditLogSummary<ChangeInternal, EditHandle<ChangeInternal>>;
+    /**
+     * Information about all IDs compressed in the summary
+     */
+    readonly idCompressor: IdCompressor;
+    /**
+     * Interner pre-loaded with all definitions and labels from the summary.
+     */
+    readonly interner: MutableStringInterner;
+}
+/**
+ * Serializes a SharedTree summary into a JSON string. This may later be used to initialize a SharedTree's state via `deserialize()`
+ * Also replaces handle objects with their serialized form.
+ *
+ * @param summary - The SharedTree summary to serialize.
+ * @param serializer - The serializer required to serialize handles in the summary.
+ * @param bind - The object handle required to serialize handles in the summary
+ */
+export declare function serialize(summary: SharedTreeSummaryBase, serializer: IFluidSerializer, bind: IFluidHandle): string;
+//# sourceMappingURL=Summary.d.ts.map

package/lib/Summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Summary.d.ts","sourceRoot":"","sources":["../src/Summary.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAoB,MAAM,oCAAoC,CAAC;AAExF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC3G,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAE9D;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,UAAU,CAAC;IAElC;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC,cAAc,EAAE,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC;IAEjF;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IAEpC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC;CACzC;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,qBAAqB,EAAE,UAAU,EAAE,gBAAgB,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,CAElH"}

package/lib/Summary.js

@@ -0,0 +1,19 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { serializeHandles } from '@fluidframework/shared-object-base';
+import { fail } from './Common';
+/**
+ * Serializes a SharedTree summary into a JSON string. This may later be used to initialize a SharedTree's state via `deserialize()`
+ * Also replaces handle objects with their serialized form.
+ *
+ * @param summary - The SharedTree summary to serialize.
+ * @param serializer - The serializer required to serialize handles in the summary.
+ * @param bind - The object handle required to serialize handles in the summary
+ */
+export function serialize(summary, serializer, bind) {
+    var _a;
+    return (_a = serializeHandles(summary, serializer, bind)) !== null && _a !== void 0 ? _a : fail();
+}
+//# sourceMappingURL=Summary.js.map

package/lib/Summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Summary.js","sourceRoot":"","sources":["../src/Summary.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAoB,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACxF,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AA8BhC;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,OAA8B,EAAE,UAA4B,EAAE,IAAkB;;IACzG,aAAO,gBAAgB,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,mCAAI,IAAI,EAAE,CAAC;AAC9D,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport type { IFluidHandle } from '@fluidframework/core-interfaces';\nimport { IFluidSerializer, serializeHandles } from '@fluidframework/shared-object-base';\nimport { fail } from './Common';\nimport type { IdCompressor } from './id-compressor';\nimport type { EditLogSummary, SharedTreeSummaryBase, ChangeNode, ChangeInternal } from './persisted-types';\nimport type { EditHandle } from './EditLog';\nimport type { MutableStringInterner } from './StringInterner';\n\n/**\n * The contents of a SharedTree summary, converted to a common internal format that can be\n * loaded into a SharedTree.\n * @internal\n */\nexport interface SummaryContents {\n\treadonly currentTree?: ChangeNode;\n\n\t/**\n\t * Information that can populate an edit log.\n\t */\n\treadonly editHistory: EditLogSummary<ChangeInternal, EditHandle<ChangeInternal>>;\n\n\t/**\n\t * Information about all IDs compressed in the summary\n\t */\n\treadonly idCompressor: IdCompressor;\n\n\t/**\n\t * Interner pre-loaded with all definitions and labels from the summary.\n\t */\n\treadonly interner: MutableStringInterner;\n}\n\n/**\n * Serializes a SharedTree summary into a JSON string. This may later be used to initialize a SharedTree's state via `deserialize()`\n * Also replaces handle objects with their serialized form.\n *\n * @param summary - The SharedTree summary to serialize.\n * @param serializer - The serializer required to serialize handles in the summary.\n * @param bind - The object handle required to serialize handles in the summary\n */\nexport function serialize(summary: SharedTreeSummaryBase, serializer: IFluidSerializer, bind: IFluidHandle): string {\n\treturn serializeHandles(summary, serializer, bind) ?? fail();\n}\n"]}

package/lib/SummaryBackCompatibility.d.ts

@@ -2,36 +2,36 @@
  * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
  * Licensed under the MIT License.
  */
-import { IFluidSerializer } from '@fluidframework/shared-object-base';
-import { ErrorString } from './Common';
-import { ChangeNode, Edit, SharedTreeSummaryBase, SharedTreeSummary } from './generic';
-/** The summary format version that is read by SharedTree. */
-export declare const readFormatVersion = "0.1.0";
-/**
- * Legacy summary format currently still used for writing.
- * TODO:#49901: Remove export when this format is no longer written.
- * @internal
- */
-export interface SharedTreeSummary_0_0_2<TChange> extends SharedTreeSummaryBase {
-    readonly currentTree: ChangeNode;
-    /**
-     * A list of edits.
-     */
-    readonly sequencedEdits: readonly Edit<TChange>[];
-}
+import type { ITelemetryProperties } from '@fluidframework/common-definitions';
+import type { IFluidSerializer } from '@fluidframework/shared-object-base';
+import { SharedTreeSummaryBase } from './persisted-types';
 /**
  * Deserializes a JSON object produced by `serialize()` and uses it to initialize the tree with the encoded state.
  * Also constructs handle objects from their serialized form.
  *
  * @param jsonSummary - The string to deserialize.
  * @param serializer - The serializer required to deserialize handles in the string.
- * @returns A SharedTree summary or an ErrorString if the summary could not be interpreted.
+ * @returns A SharedTree summary.
+ * @throws If the summary could not be interpreted.
  *
  */
-export declare function deserialize(jsonSummary: string, serializer: IFluidSerializer): SharedTreeSummaryBase | ErrorString;
+export declare function deserialize(jsonSummary: string, serializer: IFluidSerializer): SharedTreeSummaryBase;
 /**
- * @returns SharedTreeSummary that can be used to initialize a SharedTree, or an ErrorString if the summary could not be converted.
- *
+ * General statistics about summaries.
+ */
+export interface SummaryStatistics extends ITelemetryProperties {
+    /** Format version the summary is written in. */
+    readonly formatVersion: string;
+    /** Number of edits. */
+    readonly historySize: number;
+    /** Number of edit chunks in the history. */
+    readonly totalNumberOfChunks?: number;
+    /** Number of chunks in the summary that have handles stored. */
+    readonly uploadedChunks?: number;
+}
+/**
+ * @returns SummaryStatistics.
+ * @throws If statistics could not be obtained from the summary.
  */
-export declare function convertSummaryToReadFormat<TChange>(summary: SharedTreeSummaryBase): SharedTreeSummary<TChange> | ErrorString;
+export declare function getSummaryStatistics(summary: SharedTreeSummaryBase): SummaryStatistics;
 //# sourceMappingURL=SummaryBackCompatibility.d.ts.map

package/lib/SummaryBackCompatibility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SummaryBackCompatibility.d.ts","sourceRoot":"","sources":["../src/SummaryBackCompatibility.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEvF,6DAA6D;AAC7D,eAAO,MAAM,iBAAiB,UAAU,CAAC;AAEzC;;;;GAIG;AACH,MAAM,WAAW,uBAAuB,CAAC,OAAO,CAAE,SAAQ,qBAAqB;IAC9E,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC;IAEjC;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,SAAS,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;CAClD;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,GAAG,qBAAqB,GAAG,WAAW,CAmBlH;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EACjD,OAAO,EAAE,qBAAqB,GAC5B,iBAAiB,CAAC,OAAO,CAAC,GAAG,WAAW,CA4C1C"}
+{"version":3,"file":"SummaryBackCompatibility.d.ts","sourceRoot":"","sources":["../src/SummaryBackCompatibility.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAG3E,OAAO,EAAqB,qBAAqB,EAAwC,MAAM,mBAAmB,CAAC;AAEnH;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,GAAG,qBAAqB,CAmBpG;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,oBAAoB;IAC9D,gDAAgD;IAChD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,uBAAuB;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,4CAA4C;IAC5C,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,gEAAgE;IAChE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CACjC;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,iBAAiB,CAqCtF"}

package/lib/SummaryBackCompatibility.js

@@ -2,16 +2,17 @@
  * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
  * Licensed under the MIT License.
  */
-import { EditLog } from './EditLog';
-/** The summary format version that is read by SharedTree. */
-export const readFormatVersion = '0.1.0';
+import { fail } from './Common';
+import { getNumberOfHandlesFromEditLogSummary } from './EditLog';
+import { WriteFormat } from './persisted-types';
 /**
  * Deserializes a JSON object produced by `serialize()` and uses it to initialize the tree with the encoded state.
  * Also constructs handle objects from their serialized form.
  *
  * @param jsonSummary - The string to deserialize.
  * @param serializer - The serializer required to deserialize handles in the string.
- * @returns A SharedTree summary or an ErrorString if the summary could not be interpreted.
+ * @returns A SharedTree summary.
+ * @throws If the summary could not be interpreted.
  *
  */
 export function deserialize(jsonSummary, serializer) {
@@ -20,56 +21,52 @@ export function deserialize(jsonSummary, serializer) {
         summary = serializer.parse(jsonSummary);
     }
     catch (_a) {
-        return 'Json syntax error in Summary';
+        fail('Json syntax error in Summary');
     }
     if (typeof summary !== 'object') {
-        return 'Summary is not an object';
+        fail('Summary is not an object');
     }
     const { version } = summary;
     if (version !== undefined) {
         return Object.assign({ version }, summary);
     }
-    return 'Missing fields on summary';
+    fail('Missing fields on summary');
 }
 /**
- * @returns SharedTreeSummary that can be used to initialize a SharedTree, or an ErrorString if the summary could not be converted.
- *
+ * @returns SummaryStatistics.
+ * @throws If statistics could not be obtained from the summary.
  */
-export function convertSummaryToReadFormat(summary) {
+export function getSummaryStatistics(summary) {
     const { version } = summary;
-    if (version === readFormatVersion) {
-        const { currentTree, editHistory } = summary;
+    if (version === WriteFormat.v0_1_1) {
+        const { editHistory } = summary;
         if (editHistory !== undefined) {
             if (typeof editHistory !== 'object') {
-                return 'Edit history is not an object';
+                fail('Edit history is not an object');
             }
             const { editChunks, editIds } = editHistory;
             // TODO:#45414: Add more robust validation of the summary's fields. Even if they are present, they may be malformed.
             if (editChunks !== undefined && editIds !== undefined) {
-                return { currentTree, editHistory, version };
+                return {
+                    formatVersion: version,
+                    historySize: editIds.length,
+                    totalNumberOfChunks: editChunks.length,
+                    uploadedChunks: getNumberOfHandlesFromEditLogSummary(editHistory),
+                };
             }
+            fail('Missing fields on edit log summary');
         }
     }
-    else if (version === '0.0.2') {
-        const { currentTree, sequencedEdits } = summary;
-        if (sequencedEdits !== undefined) {
-            /**
-             * The number of edits that can safely fit in a blob upload.
-             */
-            const maxChunkSize = 1000;
-            // This saves all of the edits in the summary as part of the first chunk.
-            const temporaryLog = new EditLog(undefined, undefined, maxChunkSize);
-            sequencedEdits.forEach((edit) => temporaryLog.addSequencedEdit(edit, { sequenceNumber: 1, referenceSequenceNumber: 0 }));
-            return {
-                currentTree,
-                editHistory: temporaryLog.getEditLogSummary(),
-                version: readFormatVersion,
-            };
-        }
+    else if (version === WriteFormat.v0_0_2) {
+        const { sequencedEdits } = summary;
+        return {
+            formatVersion: version,
+            historySize: sequencedEdits.length,
+        };
     }
     else {
-        return 'Format version is not supported';
+        fail('Format version is not supported');
     }
-    return 'Missing fields on summary';
+    fail('Missing fields on summary');
 }
 //# sourceMappingURL=SummaryBackCompatibility.js.map

package/lib/SummaryBackCompatibility.js.map

@@ -1 +1 @@
-{"version":3,"file":"SummaryBackCompatibility.js","sourceRoot":"","sources":["../src/SummaryBackCompatibility.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,6DAA6D;AAC7D,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAO,CAAC;AAgBzC;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,WAAmB,EAAE,UAA4B;IAC5E,IAAI,OAAuC,CAAC;IAC5C,IAAI;QACH,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;KACxC;IAAC,WAAM;QACP,OAAO,8BAA8B,CAAC;KACtC;IAED,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE;QAChC,OAAO,0BAA0B,CAAC;KAClC;IAED,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAE5B,IAAI,OAAO,KAAK,SAAS,EAAE;QAC1B,uBAAS,OAAO,IAAK,OAAO,EAAG;KAC/B;IAED,OAAO,2BAA2B,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CACzC,OAA8B;IAE9B,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAE5B,IAAI,OAAO,KAAK,iBAAiB,EAAE;QAClC,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,OAAqC,CAAC;QAE3E,IAAI,WAAW,KAAK,SAAS,EAAE;YAC9B,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE;gBACpC,OAAO,+BAA+B,CAAC;aACvC;YAED,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,WAAW,CAAC;YAE5C,oHAAoH;YACpH,IAAI,UAAU,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS,EAAE;gBACtD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;aAC7C;SACD;KACD;SAAM,IAAI,OAAO,KAAK,OAAO,EAAE;QAC/B,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,GAAG,OAA2C,CAAC;QAEpF,IAAI,cAAc,KAAK,SAAS,EAAE;YACjC;;eAEG;YACH,MAAM,YAAY,GAAG,IAAI,CAAC;YAE1B,yEAAyE;YACzE,MAAM,YAAY,GAAG,IAAI,OAAO,CAAU,SAAS,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;YAC9E,cAAc,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAC/B,YAAY,CAAC,gBAAgB,CAAC,IAAI,EAAE,EAAE,cAAc,EAAE,CAAC,EAAE,uBAAuB,EAAE,CAAC,EAAE,CAAC,CACtF,CAAC;YAEF,OAAO;gBACN,WAAW;gBACX,WAAW,EAAE,YAAY,CAAC,iBAAiB,EAAE;gBAC7C,OAAO,EAAE,iBAAiB;aAC1B,CAAC;SACF;KACD;SAAM;QACN,OAAO,iCAAiC,CAAC;KACzC;IAED,OAAO,2BAA2B,CAAC;AACpC,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { IFluidSerializer } from '@fluidframework/shared-object-base';\nimport { ErrorString } from './Common';\nimport { EditLog } from './EditLog';\nimport { ChangeNode, Edit, SharedTreeSummaryBase, SharedTreeSummary } from './generic';\n\n/** The summary format version that is read by SharedTree. */\nexport const readFormatVersion = '0.1.0';\n\n/**\n * Legacy summary format currently still used for writing.\n * TODO:#49901: Remove export when this format is no longer written.\n * @internal\n */\nexport interface SharedTreeSummary_0_0_2<TChange> extends SharedTreeSummaryBase {\n\treadonly currentTree: ChangeNode;\n\n\t/**\n\t * A list of edits.\n\t */\n\treadonly sequencedEdits: readonly Edit<TChange>[];\n}\n\n/**\n * Deserializes a JSON object produced by `serialize()` and uses it to initialize the tree with the encoded state.\n * Also constructs handle objects from their serialized form.\n *\n * @param jsonSummary - The string to deserialize.\n * @param serializer - The serializer required to deserialize handles in the string.\n * @returns A SharedTree summary or an ErrorString if the summary could not be interpreted.\n *\n */\nexport function deserialize(jsonSummary: string, serializer: IFluidSerializer): SharedTreeSummaryBase | ErrorString {\n\tlet summary: Partial<SharedTreeSummaryBase>;\n\ttry {\n\t\tsummary = serializer.parse(jsonSummary);\n\t} catch {\n\t\treturn 'Json syntax error in Summary';\n\t}\n\n\tif (typeof summary !== 'object') {\n\t\treturn 'Summary is not an object';\n\t}\n\n\tconst { version } = summary;\n\n\tif (version !== undefined) {\n\t\treturn { version, ...summary };\n\t}\n\n\treturn 'Missing fields on summary';\n}\n\n/**\n * @returns SharedTreeSummary that can be used to initialize a SharedTree, or an ErrorString if the summary could not be converted.\n *\n */\nexport function convertSummaryToReadFormat<TChange>(\n\tsummary: SharedTreeSummaryBase\n): SharedTreeSummary<TChange> | ErrorString {\n\tconst { version } = summary;\n\n\tif (version === readFormatVersion) {\n\t\tconst { currentTree, editHistory } = summary as SharedTreeSummary<TChange>;\n\n\t\tif (editHistory !== undefined) {\n\t\t\tif (typeof editHistory !== 'object') {\n\t\t\t\treturn 'Edit history is not an object';\n\t\t\t}\n\n\t\t\tconst { editChunks, editIds } = editHistory;\n\n\t\t\t// TODO:#45414: Add more robust validation of the summary's fields. Even if they are present, they may be malformed.\n\t\t\tif (editChunks !== undefined && editIds !== undefined) {\n\t\t\t\treturn { currentTree, editHistory, version };\n\t\t\t}\n\t\t}\n\t} else if (version === '0.0.2') {\n\t\tconst { currentTree, sequencedEdits } = summary as SharedTreeSummary_0_0_2<TChange>;\n\n\t\tif (sequencedEdits !== undefined) {\n\t\t\t/**\n\t\t\t * The number of edits that can safely fit in a blob upload.\n\t\t\t */\n\t\t\tconst maxChunkSize = 1000;\n\n\t\t\t// This saves all of the edits in the summary as part of the first chunk.\n\t\t\tconst temporaryLog = new EditLog<TChange>(undefined, undefined, maxChunkSize);\n\t\t\tsequencedEdits.forEach((edit) =>\n\t\t\t\ttemporaryLog.addSequencedEdit(edit, { sequenceNumber: 1, referenceSequenceNumber: 0 })\n\t\t\t);\n\n\t\t\treturn {\n\t\t\t\tcurrentTree,\n\t\t\t\teditHistory: temporaryLog.getEditLogSummary(),\n\t\t\t\tversion: readFormatVersion,\n\t\t\t};\n\t\t}\n\t} else {\n\t\treturn 'Format version is not supported';\n\t}\n\n\treturn 'Missing fields on summary';\n}\n"]}
+{"version":3,"file":"SummaryBackCompatibility.js","sourceRoot":"","sources":["../src/SummaryBackCompatibility.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,oCAAoC,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EAAqE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEnH;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAAC,WAAmB,EAAE,UAA4B;IAC5E,IAAI,OAAuC,CAAC;IAC5C,IAAI;QACH,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;KACxC;IAAC,WAAM;QACP,IAAI,CAAC,8BAA8B,CAAC,CAAC;KACrC;IAED,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE;QAChC,IAAI,CAAC,0BAA0B,CAAC,CAAC;KACjC;IAED,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAE5B,IAAI,OAAO,KAAK,SAAS,EAAE;QAC1B,uBAAS,OAAO,IAAK,OAAO,EAAG;KAC/B;IAED,IAAI,CAAC,2BAA2B,CAAC,CAAC;AACnC,CAAC;AAgBD;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAA8B;IAClE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAE5B,IAAI,OAAO,KAAK,WAAW,CAAC,MAAM,EAAE;QACnC,MAAM,EAAE,WAAW,EAAE,GAAG,OAA4B,CAAC;QAErD,IAAI,WAAW,KAAK,SAAS,EAAE;YAC9B,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE;gBACpC,IAAI,CAAC,+BAA+B,CAAC,CAAC;aACtC;YAED,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,WAAW,CAAC;YAE5C,oHAAoH;YACpH,IAAI,UAAU,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS,EAAE;gBACtD,OAAO;oBACN,aAAa,EAAE,OAAO;oBACtB,WAAW,EAAE,OAAO,CAAC,MAAM;oBAC3B,mBAAmB,EAAE,UAAU,CAAC,MAAM;oBACtC,cAAc,EAAE,oCAAoC,CAAC,WAAW,CAAC;iBACjE,CAAC;aACF;YAED,IAAI,CAAC,oCAAoC,CAAC,CAAC;SAC3C;KACD;SAAM,IAAI,OAAO,KAAK,WAAW,CAAC,MAAM,EAAE;QAC1C,MAAM,EAAE,cAAc,EAAE,GAAG,OAAkC,CAAC;QAE9D,OAAO;YACN,aAAa,EAAE,OAAO;YACtB,WAAW,EAAE,cAAc,CAAC,MAAM;SAClC,CAAC;KACF;SAAM;QACN,IAAI,CAAC,iCAAiC,CAAC,CAAC;KACxC;IAED,IAAI,CAAC,2BAA2B,CAAC,CAAC;AACnC,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport type { ITelemetryProperties } from '@fluidframework/common-definitions';\nimport type { IFluidSerializer } from '@fluidframework/shared-object-base';\nimport { fail } from './Common';\nimport { getNumberOfHandlesFromEditLogSummary } from './EditLog';\nimport { SharedTreeSummary, SharedTreeSummaryBase, SharedTreeSummary_0_0_2, WriteFormat } from './persisted-types';\n\n/**\n * Deserializes a JSON object produced by `serialize()` and uses it to initialize the tree with the encoded state.\n * Also constructs handle objects from their serialized form.\n *\n * @param jsonSummary - The string to deserialize.\n * @param serializer - The serializer required to deserialize handles in the string.\n * @returns A SharedTree summary.\n * @throws If the summary could not be interpreted.\n *\n */\nexport function deserialize(jsonSummary: string, serializer: IFluidSerializer): SharedTreeSummaryBase {\n\tlet summary: Partial<SharedTreeSummaryBase>;\n\ttry {\n\t\tsummary = serializer.parse(jsonSummary);\n\t} catch {\n\t\tfail('Json syntax error in Summary');\n\t}\n\n\tif (typeof summary !== 'object') {\n\t\tfail('Summary is not an object');\n\t}\n\n\tconst { version } = summary;\n\n\tif (version !== undefined) {\n\t\treturn { version, ...summary };\n\t}\n\n\tfail('Missing fields on summary');\n}\n\n/**\n * General statistics about summaries.\n */\nexport interface SummaryStatistics extends ITelemetryProperties {\n\t/** Format version the summary is written in. */\n\treadonly formatVersion: string;\n\t/** Number of edits. */\n\treadonly historySize: number;\n\t/** Number of edit chunks in the history. */\n\treadonly totalNumberOfChunks?: number;\n\t/** Number of chunks in the summary that have handles stored. */\n\treadonly uploadedChunks?: number;\n}\n\n/**\n * @returns SummaryStatistics.\n * @throws If statistics could not be obtained from the summary.\n */\nexport function getSummaryStatistics(summary: SharedTreeSummaryBase): SummaryStatistics {\n\tconst { version } = summary;\n\n\tif (version === WriteFormat.v0_1_1) {\n\t\tconst { editHistory } = summary as SharedTreeSummary;\n\n\t\tif (editHistory !== undefined) {\n\t\t\tif (typeof editHistory !== 'object') {\n\t\t\t\tfail('Edit history is not an object');\n\t\t\t}\n\n\t\t\tconst { editChunks, editIds } = editHistory;\n\n\t\t\t// TODO:#45414: Add more robust validation of the summary's fields. Even if they are present, they may be malformed.\n\t\t\tif (editChunks !== undefined && editIds !== undefined) {\n\t\t\t\treturn {\n\t\t\t\t\tformatVersion: version,\n\t\t\t\t\thistorySize: editIds.length,\n\t\t\t\t\ttotalNumberOfChunks: editChunks.length,\n\t\t\t\t\tuploadedChunks: getNumberOfHandlesFromEditLogSummary(editHistory),\n\t\t\t\t};\n\t\t\t}\n\n\t\t\tfail('Missing fields on edit log summary');\n\t\t}\n\t} else if (version === WriteFormat.v0_0_2) {\n\t\tconst { sequencedEdits } = summary as SharedTreeSummary_0_0_2;\n\n\t\treturn {\n\t\t\tformatVersion: version,\n\t\t\thistorySize: sequencedEdits.length,\n\t\t};\n\t} else {\n\t\tfail('Format version is not supported');\n\t}\n\n\tfail('Missing fields on summary');\n}\n"]}

package/lib/SummaryTestUtilities.d.ts

@@ -0,0 +1,31 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import type { EditChunkContents } from './persisted-types';
+import type { SharedTree } from './SharedTree';
+/**
+ * Format used for exporting an uploaded edit chunk and its associated handle path. Primarily used for testing SharedTree summaries.
+ * @public
+ */
+export interface UploadedEditChunkContents {
+    /**
+     * The handle path associated with the edit chunk.
+     */
+    absolutePath: string;
+    /**
+     * The edits uploaded as part of the edit chunk.
+     */
+    chunkContents: EditChunkContents;
+}
+/**
+ * Returns a list of blob paths and their associated contents for all uploaded edit chunks in the given edit log, in order of edit sequence numbers.
+ * The contents will not be decoded from the format used in the blob.
+ */
+export declare function getUploadedEditChunkContents(sharedTree: SharedTree): Promise<UploadedEditChunkContents[]>;
+/**
+ * Returns a serialized description of blob paths and their associated contents for all uploaded edit chunks in the given edit log.
+ * @public
+ */
+export declare function getSerializedUploadedEditChunkContents(sharedTree: SharedTree): Promise<string>;
+//# sourceMappingURL=SummaryTestUtilities.d.ts.map

package/lib/SummaryTestUtilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SummaryTestUtilities.d.ts","sourceRoot":"","sources":["../src/SummaryTestUtilities.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAkB,iBAAiB,EAAmB,MAAM,mBAAmB,CAAC;AAC5F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACzC;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,aAAa,EAAE,iBAAiB,CAAC;CACjC;AAED;;;GAGG;AACH,wBAAsB,4BAA4B,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,yBAAyB,EAAE,CAAC,CAgB/G;AAED;;;GAGG;AACH,wBAAsB,sCAAsC,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAEpG"}

package/lib/SummaryTestUtilities.js

@@ -0,0 +1,32 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { IsoBuffer } from '@fluidframework/common-utils';
+/**
+ * Returns a list of blob paths and their associated contents for all uploaded edit chunks in the given edit log, in order of edit sequence numbers.
+ * The contents will not be decoded from the format used in the blob.
+ */
+export async function getUploadedEditChunkContents(sharedTree) {
+    const editChunks = [];
+    const { editChunks: editsOrHandles } = sharedTree.edits.getEditLogSummary();
+    for (const { chunk } of editsOrHandles) {
+        if (!Array.isArray(chunk)) {
+            const handle = chunk;
+            const chunkContents = JSON.parse(IsoBuffer.from(await handle.get()).toString());
+            editChunks.push({
+                absolutePath: handle.absolutePath,
+                chunkContents,
+            });
+        }
+    }
+    return editChunks;
+}
+/**
+ * Returns a serialized description of blob paths and their associated contents for all uploaded edit chunks in the given edit log.
+ * @public
+ */
+export async function getSerializedUploadedEditChunkContents(sharedTree) {
+    return JSON.stringify(await getUploadedEditChunkContents(sharedTree));
+}
+//# sourceMappingURL=SummaryTestUtilities.js.map

package/lib/SummaryTestUtilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SummaryTestUtilities.js","sourceRoot":"","sources":["../src/SummaryTestUtilities.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAoBzD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAAC,UAAsB;IACxE,MAAM,UAAU,GAAgC,EAAE,CAAC;IACnD,MAAM,EAAE,UAAU,EAAE,cAAc,EAAE,GAAI,UAAU,CAAC,KAAiC,CAAC,iBAAiB,EAAE,CAAC;IACzG,KAAK,MAAM,EAAE,KAAK,EAAE,IAAI,cAAc,EAAE;QACvC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;YAC1B,MAAM,MAAM,GAAG,KAAwB,CAAC;YAExC,MAAM,aAAa,GAAsB,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;YACnG,UAAU,CAAC,IAAI,CAAC;gBACf,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,aAAa;aACb,CAAC,CAAC;SACH;KACD;IAED,OAAO,UAAU,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,sCAAsC,CAAC,UAAsB;IAClF,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,4BAA4B,CAAC,UAAU,CAAC,CAAC,CAAC;AACvE,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { IsoBuffer } from '@fluidframework/common-utils';\nimport type { EditLog } from './EditLog';\nimport type { ChangeInternal, EditChunkContents, FluidEditHandle } from './persisted-types';\nimport type { SharedTree } from './SharedTree';\n\n/**\n * Format used for exporting an uploaded edit chunk and its associated handle path. Primarily used for testing SharedTree summaries.\n * @public\n */\nexport interface UploadedEditChunkContents {\n\t/**\n\t * The handle path associated with the edit chunk.\n\t */\n\tabsolutePath: string;\n\t/**\n\t * The edits uploaded as part of the edit chunk.\n\t */\n\tchunkContents: EditChunkContents;\n}\n\n/**\n * Returns a list of blob paths and their associated contents for all uploaded edit chunks in the given edit log, in order of edit sequence numbers.\n * The contents will not be decoded from the format used in the blob.\n */\nexport async function getUploadedEditChunkContents(sharedTree: SharedTree): Promise<UploadedEditChunkContents[]> {\n\tconst editChunks: UploadedEditChunkContents[] = [];\n\tconst { editChunks: editsOrHandles } = (sharedTree.edits as EditLog<ChangeInternal>).getEditLogSummary();\n\tfor (const { chunk } of editsOrHandles) {\n\t\tif (!Array.isArray(chunk)) {\n\t\t\tconst handle = chunk as FluidEditHandle;\n\n\t\t\tconst chunkContents: EditChunkContents = JSON.parse(IsoBuffer.from(await handle.get()).toString());\n\t\t\teditChunks.push({\n\t\t\t\tabsolutePath: handle.absolutePath,\n\t\t\t\tchunkContents,\n\t\t\t});\n\t\t}\n\t}\n\n\treturn editChunks;\n}\n\n/**\n * Returns a serialized description of blob paths and their associated contents for all uploaded edit chunks in the given edit log.\n * @public\n */\nexport async function getSerializedUploadedEditChunkContents(sharedTree: SharedTree): Promise<string> {\n\treturn JSON.stringify(await getUploadedEditChunkContents(sharedTree));\n}\n"]}

package/lib/Transaction.d.ts

@@ -0,0 +1,71 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { IErrorEvent } from '@fluidframework/common-definitions';
+import { TypedEventEmitter } from '@fluidframework/common-utils';
+import { EditStatus } from './persisted-types';
+import { TreeView } from './TreeView';
+import { Change } from './ChangeTypes';
+import { SharedTree } from './SharedTree';
+/**
+ * An event emitted by a `Transaction` to indicate a state change. See {@link TransactionEvents} for event argument information.
+ * @public
+ */
+export declare enum TransactionEvent {
+    /**
+     * `currentView` has changed from `before` to `after`
+     */
+    ViewChange = "viewChange"
+}
+/**
+ * Events which may be emitted by `Transaction`
+ */
+export interface TransactionEvents extends IErrorEvent {
+    (event: TransactionEvent.ViewChange, listener: (before: TreeView, after: TreeView) => void): any;
+}
+/**
+ * Buffers changes to be applied to an isolated view of a `SharedTree` over time before applying them directly to the tree itself as a
+ * single edit
+ */
+export declare class Transaction extends TypedEventEmitter<TransactionEvents> {
+    readonly tree: SharedTree;
+    /** The view of the tree when this transaction was created */
+    readonly startingView: TreeView;
+    private readonly transaction;
+    /**
+     * Create a new transaction over the given tree. The tree's `currentView` at this time will become the `startingView` for this
+     * transaction.
+     * @param tree - the `SharedTree` that this transaction applies changes to
+     */
+    constructor(tree: SharedTree);
+    /**
+     * True if this transaction is open, false if it is closed. A transaction may be closed manually via `closeAndApplyEdit()`, or may
+     * be automatically closed by a change in this transaction failing to apply (see `applyChange()`).
+     */
+    get isOpen(): boolean;
+    /**
+     * The status of the most recently applied change in this transaction
+     */
+    get status(): EditStatus;
+    /**
+     * The state of the tree following the most change that was successfully applied. If no changes have been applied, this is the same as
+     * `startingView`.
+     */
+    get currentView(): TreeView;
+    /**
+     * Attempt to apply a sequence of changes in this transaction. The `currentView` will be updated to reflect the new tree state after all
+     * applied changes. If any change fails to apply, the remaining changes will be ignored and this transaction will be automatically
+     * closed (see `isOpen`). If this transaction is already closed, this method has no effect. This method will emit a
+     * `TransactionEvent.ViewChange` event at most once per call.
+     * @param changes - the changes to apply
+     * @returns either the `EditStatus` of the given changes or the `EditStatus` of the last change before the transaction was closed
+     */
+    apply(...changes: Change[]): EditStatus;
+    apply(changes: Change[]): EditStatus;
+    /**
+     * Close this transaction and apply its changes to the `SharedTree`. If this transaction is already closed, this method has no effect.
+     */
+    closeAndCommit(): void;
+}
+//# sourceMappingURL=Transaction.d.ts.map

package/lib/Transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Transaction.d.ts","sourceRoot":"","sources":["../src/Transaction.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAwB,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAErE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAI1C;;;GAGG;AACH,oBAAY,gBAAgB;IAC3B;;OAEG;IACH,UAAU,eAAe;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,WAAW;IACrD,CAAC,KAAK,EAAE,gBAAgB,CAAC,UAAU,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,KAAK,IAAI,OAAE;CAC5F;AAED;;;GAGG;AACH,qBAAa,WAAY,SAAQ,iBAAiB,CAAC,iBAAiB,CAAC;aAUjC,IAAI,EAAE,UAAU;IATnD,6DAA6D;IAC7D,SAAgB,YAAY,EAAE,QAAQ,CAAC;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IAEjD;;;;OAIG;gBACgC,IAAI,EAAE,UAAU;IAOnD;;;OAGG;IACH,IAAW,MAAM,IAAI,OAAO,CAE3B;IAED;;OAEG;IACH,IAAW,MAAM,IAAI,UAAU,CAE9B;IAED;;;OAGG;IACH,IAAW,WAAW,IAAI,QAAQ,CAEjC;IAED;;;;;;;OAOG;IACI,KAAK,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,UAAU;IACvC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,UAAU;IAkB3C;;OAEG;IACI,cAAc,IAAI,IAAI;CAY7B"}