@fluidframework/runtime-utils 2.0.0-dev.2.3.0.115467 → 2.0.0-dev.4.1.0.148229

package/src/summarizerNode/summarizerNodeUtils.ts

@@ -1,216 +0,0 @@
-/*!
- * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
- * Licensed under the MIT License.
- */
-
-import { ITelemetryLogger } from "@fluidframework/common-definitions";
-import {
-    ISnapshotTree,
-    ISummaryTree,
-    SummaryObject,
-} from "@fluidframework/protocol-definitions";
-import { channelsTreeName, ISummaryTreeWithStats } from "@fluidframework/runtime-definitions";
-import { ReadAndParseBlob } from "../utils";
-
-/**
- * Return value of refreshSummaryAck function. There can be three different scenarios based on the passed params:
- *
- * 1. The latest summary was not udpated.
- *
- * 2. The latest summary was updated and the summary corresponding to the params was tracked by this client.
- *
- * 3. The latest summary was updated but the summary corresponding to the params was not tracked. In this case, the
- * latest summary is updated based on the downloaded snapshot which is also returned.
- */
-export type RefreshSummaryResult = {
-    latestSummaryUpdated: false;
-} | {
-    latestSummaryUpdated: true;
-    wasSummaryTracked: true;
-} | {
-    latestSummaryUpdated: true;
-    wasSummaryTracked: false;
-    snapshot: ISnapshotTree;
-};
-
-export interface ISummarizerNodeRootContract {
-    startSummary(referenceSequenceNumber: number, summaryLogger: ITelemetryLogger): void;
-    completeSummary(proposalHandle: string): void;
-    clearSummary(): void;
-    refreshLatestSummary(
-        proposalHandle: string | undefined,
-        summaryRefSeq: number,
-        getSnapshot: () => Promise<ISnapshotTree>,
-        readAndParseBlob: ReadAndParseBlob,
-        correlatedSummaryLogger: ITelemetryLogger,
-    ): Promise<RefreshSummaryResult>;
-}
-
-/** Path for nodes in a tree with escaped special characters */
-export class EscapedPath {
-    private constructor(public readonly path: string) { }
-    public static create(path: string): EscapedPath {
-        return new EscapedPath(encodeURIComponent(path));
-    }
-    public static createAndConcat(pathParts: string[]): EscapedPath {
-        let ret = EscapedPath.create(pathParts[0] ?? "");
-        for (let i = 1; i < pathParts.length; i++) {
-            ret = ret.concat(EscapedPath.create(pathParts[i]));
-        }
-        return ret;
-    }
-    public toString(): string {
-        return this.path;
-    }
-    public concat(path: EscapedPath): EscapedPath {
-        return new EscapedPath(`${this.path}/${path.path}`);
-    }
-}
-
-/** Information about a summary relevant to a specific node in the tree */
-export class SummaryNode {
-    /** Creates an instance that is valid for the root with specific basePath and localPath */
-    public static createForRoot(referenceSequenceNumber: number): SummaryNode {
-        return new SummaryNode({
-            referenceSequenceNumber,
-            basePath: undefined,
-            localPath: EscapedPath.create(""), // root hard-coded to ""
-        });
-    }
-
-    /** Summary reference sequence number, i.e. last sequence number seen when it was created */
-    public get referenceSequenceNumber(): number {
-        return this.summary.referenceSequenceNumber;
-    }
-    /** Full path to parent node, or undefined if this is the root */
-    public get basePath(): EscapedPath | undefined {
-        return this.summary.basePath;
-    }
-    /** Relative path to this node from its parent node */
-    public get localPath(): EscapedPath {
-        return this.summary.localPath;
-    }
-    /** Relative path from this node to its node innermost base summary */
-    public get additionalPath(): EscapedPath | undefined {
-        return this.summary.additionalPath;
-    }
-    public set additionalPath(additionalPath: EscapedPath | undefined) {
-        this.summary.additionalPath = additionalPath;
-    }
-    constructor(private readonly summary: {
-        readonly referenceSequenceNumber: number;
-        readonly basePath: EscapedPath | undefined;
-        readonly localPath: EscapedPath;
-        additionalPath?: EscapedPath;
-    }) { }
-
-    /** Gets the full path to this node, to be used when sending a handle */
-    public get fullPath(): EscapedPath {
-        return this.basePath?.concat(this.localPath) ?? this.localPath;
-    }
-
-    /**
-     * Gets the full path to this node's innermost base summary.
-     * The children nodes can use this as their basePath to determine their path.
-     */
-    public get fullPathForChildren(): EscapedPath {
-        return this.additionalPath !== undefined
-            ? this.fullPath.concat(this.additionalPath)
-            : this.fullPath;
-    }
-
-    /**
-     * Creates a new node within the same summary for a child of this node.
-     * @param id - id of the child node
-     */
-    public createForChild(id: string): SummaryNode {
-        return new SummaryNode({
-            referenceSequenceNumber: this.referenceSequenceNumber,
-            basePath: this.fullPathForChildren,
-            localPath: EscapedPath.create(id),
-        });
-    }
-}
-
-/**
- * Parameter to help encode summary with conditional behavior.
- * When fromSummary is true, it will contain the SummaryNode of
- * its previous summary, which it can use to point to with a handle.
- * When fromSummary is false, it will use an actual summary tree
- * as its base summary in case the first summary is a differential summary.
- */
-export type EncodeSummaryParam = {
-    fromSummary: true;
-    summaryNode: SummaryNode;
-} | {
-    fromSummary: false;
-    initialSummary: ISummaryTreeWithStats;
-};
-
-/**
- * Information about the initial summary tree found from an attach op.
- */
-export interface IInitialSummary {
-    sequenceNumber: number;
-    id: string;
-    summary: ISummaryTreeWithStats | undefined;
-}
-
-/**
- * Represents the details needed to create a child summarizer node.
- */
-export interface ICreateChildDetails {
-    /** Summary from attach op if known */
-    initialSummary: IInitialSummary | undefined;
-    /** Latest summary from server node data */
-    latestSummary: SummaryNode | undefined;
-    /** Sequence number of latest known change to the node */
-    changeSequenceNumber: number;
-}
-
-export interface ISubtreeInfo<T extends ISnapshotTree | SummaryObject> {
-    /** Tree to use to find children subtrees */
-    childrenTree: T;
-    /** Additional path part where children are isolated */
-    childrenPathPart: string | undefined;
-}
-
-/**
- * Checks if the summary contains .channels subtree where the children subtrees
- * would be located if exists.
- * @param baseSummary - summary to check
- */
-export function parseSummaryForSubtrees(baseSummary: ISnapshotTree): ISubtreeInfo<ISnapshotTree> {
-    // New versions of snapshots have child nodes isolated in .channels subtree
-    const channelsSubtree = baseSummary.trees[channelsTreeName];
-    if (channelsSubtree !== undefined) {
-        return {
-            childrenTree: channelsSubtree,
-            childrenPathPart: channelsTreeName,
-        };
-    }
-    return {
-        childrenTree: baseSummary,
-        childrenPathPart: undefined,
-    };
-}
-
-/**
- * Checks if the summary contains .channels subtree where the children subtrees
- * would be located if exists.
- * @param baseSummary - summary to check
- */
-export function parseSummaryTreeForSubtrees(summary: ISummaryTree): ISubtreeInfo<SummaryObject> {
-    // New versions of snapshots have child nodes isolated in .channels subtree
-    const channelsSubtree = summary.tree[channelsTreeName];
-    if (channelsSubtree !== undefined) {
-        return {
-            childrenTree: channelsSubtree,
-            childrenPathPart: channelsTreeName,
-        };
-    }
-    return {
-        childrenTree: summary,
-        childrenPathPart: undefined,
-    };
-}

package/src/summarizerNode/summarizerNodeWithGc.ts

@@ -1,432 +0,0 @@
-/*!
- * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
- * Licensed under the MIT License.
- */
-
-import { ITelemetryLogger } from "@fluidframework/common-definitions";
-import { assert, LazyPromise } from "@fluidframework/common-utils";
-import { cloneGCData } from "@fluidframework/garbage-collector";
-import { ISnapshotTree } from "@fluidframework/protocol-definitions";
-import {
-    CreateChildSummarizerNodeParam,
-    gcBlobKey,
-    IGarbageCollectionData,
-    IGarbageCollectionDetailsBase,
-    ISummarizeInternalResult,
-    ISummarizeResult,
-    ISummarizerNodeConfigWithGC,
-    ISummarizerNodeWithGC,
-    SummarizeInternalFn,
-    ITelemetryContext,
-} from "@fluidframework/runtime-definitions";
-import { ReadAndParseBlob } from "../utils";
-import { SummarizerNode } from "./summarizerNode";
-import {
-    EscapedPath,
-    ICreateChildDetails,
-    IInitialSummary,
-    ISummarizerNodeRootContract,
-    SummaryNode,
-} from "./summarizerNodeUtils";
-
-export interface IRootSummarizerNodeWithGC extends ISummarizerNodeWithGC, ISummarizerNodeRootContract {}
-
-// Extend SummaryNode to add used routes tracking to it.
-class SummaryNodeWithGC extends SummaryNode {
-    constructor(
-        public readonly serializedUsedRoutes: string,
-        summary: {
-            readonly referenceSequenceNumber: number;
-            readonly basePath: EscapedPath | undefined;
-            readonly localPath: EscapedPath;
-            additionalPath?: EscapedPath;
-        },
-    ) {
-        super(summary);
-    }
-}
-
-/**
- * Extends the functionality of SummarizerNode to manage this node's garbage collection data:
- *
- * - Adds a new API `getGCData` to return GC data of this node.
- *
- * - Caches the result of `getGCData` to be used if nothing changes between summaries.
- *
- * - Manages the used routes of this node. These are used to identify if this node is referenced in the document
- * and to determine if the node's used state changed since last summary.
- *
- * - Adds trackState param to summarize. If trackState is false, it bypasses the SummarizerNode and calls
- * directly into summarizeInternal method.
- */
-export class SummarizerNodeWithGC extends SummarizerNode implements IRootSummarizerNodeWithGC {
-    // Tracks the work-in-progress used routes during summary.
-    private wipSerializedUsedRoutes: string | undefined;
-
-    // This is the last known used routes of this node as seen by the server as part of a summary.
-    private referenceUsedRoutes: string[] | undefined;
-
-    // The base GC details of this node used to initialize the GC state.
-    private readonly baseGCDetailsP: LazyPromise<IGarbageCollectionDetailsBase>;
-
-    // Keeps track of whether we have loaded the base details to ensure that we on;y do it once.
-    private baseGCDetailsLoaded: boolean = false;
-
-    private gcData: IGarbageCollectionData | undefined;
-
-    // Set used routes to have self route by default. This makes the node referenced by default. This is done to ensure
-    // that this node is not marked as collected when running GC has been disabled. Once, the option to disable GC is
-    // removed (from runGC flag in IContainerRuntimeOptions), this should be changed to be have no routes by default.
-    private usedRoutes: string[] = [""];
-
-    // True if GC is disabled for this node. If so, do not track GC specific state for a summary.
-    private readonly gcDisabled: boolean;
-
-    /**
-     * Do not call constructor directly.
-     * Use createRootSummarizerNodeWithGC to create root node, or createChild to create child nodes.
-     */
-    public constructor(
-        logger: ITelemetryLogger,
-        private readonly summarizeFn: (
-            fullTree: boolean,
-            trackState: boolean,
-            telemetryContext?: ITelemetryContext,
-        ) => Promise<ISummarizeInternalResult>,
-        config: ISummarizerNodeConfigWithGC,
-        changeSequenceNumber: number,
-        /** Undefined means created without summary */
-        latestSummary?: SummaryNode,
-        initialSummary?: IInitialSummary,
-        wipSummaryLogger?: ITelemetryLogger,
-        private readonly getGCDataFn?: (fullGC?: boolean) => Promise<IGarbageCollectionData>,
-        getBaseGCDetailsFn?: () => Promise<IGarbageCollectionDetailsBase>,
-    ) {
-        super(
-            logger,
-            async (fullTree: boolean, _trackState: boolean, telemetryContext?: ITelemetryContext) =>
-                summarizeFn(fullTree, true /* trackState */, telemetryContext),
-            config,
-            changeSequenceNumber,
-            latestSummary,
-            initialSummary,
-            wipSummaryLogger,
-        );
-
-        this.gcDisabled = config.gcDisabled === true;
-
-        this.baseGCDetailsP = new LazyPromise(async () => {
-            return (await getBaseGCDetailsFn?.()) ?? { usedRoutes: [] };
-        });
-    }
-
-    /**
-     * Loads state from this node's initial GC summary details. This contains the following data from the last summary
-     * seen by the server for this client:
-     * - usedRoutes: This is used to figure out if the used state of this node changed since last summary.
-     * - gcData: The garbage collection data of this node that is required for running GC.
-     */
-    private async loadBaseGCDetails() {
-        const baseGCDetails = await this.baseGCDetailsP;
-
-        // Possible race - If there were parallel calls to loadBaseGCDetails, we want to make sure that we only update
-        // the state from the base details only once.
-        if (this.baseGCDetailsLoaded) {
-            return;
-        }
-        this.baseGCDetailsLoaded = true;
-
-        // If the GC details has GC data, initialize our GC data from it.
-        if (baseGCDetails.gcData !== undefined) {
-            this.gcData = cloneGCData(baseGCDetails.gcData);
-        }
-        // Sort the used routes because we compare them with the current used routes to check if they changed between
-        // summaries. Both are sorted so that the order of elements is the same.
-        this.referenceUsedRoutes = baseGCDetails.usedRoutes?.sort();
-    }
-
-    public async summarize(
-        fullTree: boolean,
-        trackState: boolean = true,
-        telemetryContext?: ITelemetryContext,
-    ): Promise<ISummarizeResult> {
-        // If GC is not disabled and we are tracking a summary, GC should have run and updated the used routes for this
-        // summary by calling updateUsedRoutes which sets wipSerializedUsedRoutes.
-        if (!this.gcDisabled && this.isTrackingInProgress()) {
-            assert(this.wipSerializedUsedRoutes !== undefined,
-                0x1b1 /* "wip used routes should be set if tracking a summary" */);
-        }
-
-        // If trackState is true, get summary from base summarizer node which tracks summary state.
-        // If trackState is false, get summary from summarizeInternal.
-        return trackState
-            ? super.summarize(fullTree, true /* trackState */, telemetryContext)
-            : this.summarizeFn(fullTree, trackState, telemetryContext);
-    }
-
-    /**
-     * Returns the GC data of this node. If nothing has changed since last summary, it tries to reuse the data from
-     * the previous summary. Else, it gets new GC data from the underlying Fluid object.
-     * @param fullGC - true to bypass optimizations and force full generation of GC data.
-     */
-    public async getGCData(fullGC: boolean = false): Promise<IGarbageCollectionData> {
-        assert(!this.gcDisabled, 0x1b2 /* "Getting GC data should not be called when GC is disabled!" */);
-        assert(this.getGCDataFn !== undefined, 0x1b3 /* "GC data cannot be retrieved without getGCDataFn" */);
-
-        // Load GC details from the initial summary, if not already loaded. If this is the first time this function is
-        // called and the node's data has not changed since last summary, the GC data in initial details is returned.
-        await this.loadBaseGCDetails();
-
-        // If there is no new data since last summary and we have GC data from the previous run, return it. We may not
-        // have data from previous GC run for clients with older summary format before GC was added. They won't have
-        // GC details in their initial summary.
-        if (!fullGC && !this.hasDataChanged() && this.gcData !== undefined) {
-            return cloneGCData(this.gcData);
-        }
-
-        const gcData = await this.getGCDataFn(fullGC);
-        this.gcData = cloneGCData(gcData);
-        return gcData;
-    }
-
-    /**
-     * Called during the start of a summary. Updates the work-in-progress used routes.
-     */
-    public startSummary(referenceSequenceNumber: number, summaryLogger: ITelemetryLogger) {
-        // If GC is disabled, skip setting wip used routes since we should not track GC state.
-        if (!this.gcDisabled) {
-            assert(
-                this.wipSerializedUsedRoutes === undefined,
-                0x1b4 /* "We should not already be tracking used routes when to track a new summary" */);
-        }
-        super.startSummary(referenceSequenceNumber, summaryLogger);
-    }
-
-    /**
-     * Called after summary has been uploaded to the server. Add the work-in-progress state to the pending
-     * summary queue. We track this until we get an ack from the server for this summary.
-     */
-    protected completeSummaryCore(
-        proposalHandle: string,
-        parentPath: EscapedPath | undefined,
-        parentSkipRecursion: boolean,
-    ) {
-        let wipSerializedUsedRoutes: string | undefined;
-        // If GC is disabled, don't set wip used routes.
-        if (!this.gcDisabled) {
-            wipSerializedUsedRoutes = this.wipSerializedUsedRoutes;
-            assert(wipSerializedUsedRoutes !== undefined, 0x1b5 /* "We should have been tracking used routes" */);
-        }
-
-        super.completeSummaryCore(proposalHandle, parentPath, parentSkipRecursion);
-
-        // If GC is disabled, skip setting pending summary with GC state.
-        if (!this.gcDisabled) {
-            const summaryNode = this.pendingSummaries.get(proposalHandle);
-            if (summaryNode !== undefined) {
-                // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-                const summaryNodeWithGC = new SummaryNodeWithGC(wipSerializedUsedRoutes!, summaryNode);
-                this.pendingSummaries.set(proposalHandle, summaryNodeWithGC);
-            }
-        }
-    }
-
-    /**
-     * Clears the work-in-progress state.
-     */
-    public clearSummary() {
-        this.wipSerializedUsedRoutes = undefined;
-        super.clearSummary();
-    }
-
-    /**
-     * Called when we get an ack from the server for a summary we sent. Update the reference state of this node
-     * from the state in the pending summary queue.
-     */
-    protected refreshLatestSummaryFromPending(
-        proposalHandle: string,
-        referenceSequenceNumber: number,
-    ): void {
-        // If GC is disabled, skip setting referenced used routes since we are not tracking GC state.
-        if (!this.gcDisabled) {
-            const summaryNode = this.pendingSummaries.get(proposalHandle) as SummaryNodeWithGC;
-            if (summaryNode?.serializedUsedRoutes !== undefined) {
-                this.referenceUsedRoutes = JSON.parse(summaryNode.serializedUsedRoutes);
-            }
-        }
-
-        return super.refreshLatestSummaryFromPending(proposalHandle, referenceSequenceNumber);
-    }
-
-    /**
-     * Called when we need to upload the reference state from the given summary. Read the GC blob and get the state
-     * to upload from it.
-     */
-    protected async refreshLatestSummaryFromSnapshot(
-        referenceSequenceNumber: number,
-        snapshotTree: ISnapshotTree,
-        basePath: EscapedPath | undefined,
-        localPath: EscapedPath,
-        correlatedSummaryLogger: ITelemetryLogger,
-        readAndParseBlob: ReadAndParseBlob,
-    ): Promise<void> {
-        // If GC is disabled, skip setting referenced used routes since we are not tracking GC state.
-        if (!this.gcDisabled) {
-            const gcDetailsBlob = snapshotTree.blobs[gcBlobKey];
-            if (gcDetailsBlob !== undefined) {
-                const gcDetails = await readAndParseBlob<IGarbageCollectionDetailsBase>(gcDetailsBlob);
-
-                // Possible re-entrancy. If we have already seen a summary later than this one, ignore it.
-                if (this.referenceSequenceNumber >= referenceSequenceNumber) {
-                    return;
-                }
-
-                this.referenceUsedRoutes = gcDetails.usedRoutes;
-            }
-        }
-
-        return super.refreshLatestSummaryFromSnapshot(
-            referenceSequenceNumber,
-            snapshotTree,
-            basePath,
-            localPath,
-            correlatedSummaryLogger,
-            readAndParseBlob,
-        );
-    }
-
-    /**
-     * Override the createChild method to return an instance of SummarizerNodeWithGC.
-     */
-    public createChild(
-        /** Summarize function */
-        summarizeInternalFn: SummarizeInternalFn,
-        /** Initial id or path part of this node */
-        id: string,
-        /**
-         * Information needed to create the node.
-         * If it is from a base summary, it will assert that a summary has been seen.
-         * Attach information if it is created from an attach op.
-         */
-        createParam: CreateChildSummarizerNodeParam,
-        config: ISummarizerNodeConfigWithGC = {},
-        getGCDataFn?: (fullGC?: boolean) => Promise<IGarbageCollectionData>,
-        getBaseGCDetailsFn?: () => Promise<IGarbageCollectionDetailsBase>,
-    ): ISummarizerNodeWithGC {
-        assert(!this.children.has(id), 0x1b6 /* "Create SummarizerNode child already exists" */);
-
-        const createDetails: ICreateChildDetails = this.getCreateDetailsForChild(id, createParam);
-        const child = new SummarizerNodeWithGC(
-            this.defaultLogger,
-            summarizeInternalFn,
-            {
-                ...config,
-                // Propagate our gcDisabled state to the child if its not explicity specified in child's config.
-                gcDisabled: config.gcDisabled ?? this.gcDisabled,
-            },
-            createDetails.changeSequenceNumber,
-            createDetails.latestSummary,
-            createDetails.initialSummary,
-            this.wipSummaryLogger,
-            getGCDataFn,
-            getBaseGCDetailsFn,
-        );
-
-        // There may be additional state that has to be updated in this child. For example, if a summary is being
-        // tracked, the child's summary tracking state needs to be updated too.
-        this.maybeUpdateChildState(child);
-
-        this.children.set(id, child);
-        return child;
-    }
-
-    /**
-     * Deletes the child node with the given id.
-     */
-    public deleteChild(id: string): void {
-        this.children.delete(id);
-    }
-
-    /**
-     * Override the getChild method to return an instance of SummarizerNodeWithGC.
-     */
-    public getChild(id: string): ISummarizerNodeWithGC | undefined {
-        return this.children.get(id) as SummarizerNodeWithGC;
-    }
-
-    public isReferenced(): boolean {
-        return this.usedRoutes.includes("") || this.usedRoutes.includes("/");
-    }
-
-    public updateUsedRoutes(usedRoutes: string[]) {
-        // Sort the given routes before updating. This will ensure that the routes compared in hasUsedStateChanged()
-        // are in the same order.
-        this.usedRoutes = usedRoutes.sort();
-
-        // If GC is not disabled and we are tracking a summary, update the work-in-progress used routes so that it can
-        // be tracked for this summary.
-        if (!this.gcDisabled && this.isTrackingInProgress()) {
-            this.wipSerializedUsedRoutes = JSON.stringify(this.usedRoutes);
-        }
-    }
-
-    /**
-     * Override the hasChanged method. If this node data or its used state changed, the node is considered changed.
-     */
-    protected hasChanged(): boolean {
-        return this.hasDataChanged() || this.hasUsedStateChanged();
-    }
-
-    /**
-     * This tells whether the data in this node has changed or not.
-     */
-    private hasDataChanged(): boolean {
-        return super.hasChanged();
-    }
-
-    /**
-     * This tells whether the used state of this node has changed since last successful summary. If the used routes
-     * of this node changed, its used state is considered changed. Basically, if this node or any of its child nodes
-     * was previously used and became unused (or vice versa), its used state has changed.
-     */
-    private hasUsedStateChanged(): boolean {
-        // If GC is disabled, we are not tracking used state, return false.
-        if (this.gcDisabled) {
-            return false;
-        }
-
-        return this.referenceUsedRoutes === undefined ||
-            JSON.stringify(this.usedRoutes) !== JSON.stringify(this.referenceUsedRoutes);
-    }
-}
-
-/**
- * Creates a root summarizer node with GC functionality built-in.
- * @param logger - Logger to use within SummarizerNode
- * @param summarizeInternalFn - Function to generate summary
- * @param changeSequenceNumber - Sequence number of latest change to new node/subtree
- * @param referenceSequenceNumber - Reference sequence number of last acked summary,
- * or undefined if not loaded from summary
- * @param config - Configure behavior of summarizer node
- * @param getGCDataFn - Function to get the GC data of this node
- * @param baseGCDetailsP - Function to get the initial GC details of this node
- */
-export const createRootSummarizerNodeWithGC = (
-    logger: ITelemetryLogger,
-    summarizeInternalFn: SummarizeInternalFn,
-    changeSequenceNumber: number,
-    referenceSequenceNumber: number | undefined,
-    config: ISummarizerNodeConfigWithGC = {},
-    getGCDataFn?: (fullGC?: boolean) => Promise<IGarbageCollectionData>,
-    getBaseGCDetailsFn?: () => Promise<IGarbageCollectionDetailsBase>,
-): IRootSummarizerNodeWithGC => new SummarizerNodeWithGC(
-    logger,
-    summarizeInternalFn,
-    config,
-    changeSequenceNumber,
-    referenceSequenceNumber === undefined ? undefined : SummaryNode.createForRoot(referenceSequenceNumber),
-    undefined /* initialSummary */,
-    undefined /* wipSummaryLogger */,
-    getGCDataFn,
-    getBaseGCDetailsFn,
-);