@fluidframework/container-runtime 1.4.0-121020 → 2.0.0-dev-rc.1.0.0.224419

package/lib/runningSummarizer.js

@@ -1,380 +0,0 @@
-/*!
- * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
- * Licensed under the MIT License.
- */
-var __rest = (this && this.__rest) || function (s, e) {
-    var t = {};
-    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
-        t[p] = s[p];
-    if (s != null && typeof Object.getOwnPropertySymbols === "function")
-        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
-            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
-                t[p[i]] = s[p[i]];
-        }
-    return t;
-};
-import { assert, delay, Deferred, PromiseTimer } from "@fluidframework/common-utils";
-import { UsageError } from "@fluidframework/container-utils";
-import { MessageType, } from "@fluidframework/protocol-definitions";
-import { ChildLogger } from "@fluidframework/telemetry-utils";
-import { SummarizeHeuristicRunner } from "./summarizerHeuristics";
-import { raceTimer, SummarizeResultBuilder, SummaryGenerator, } from "./summaryGenerator";
-const maxSummarizeAckWaitTime = 10 * 60 * 1000; // 10 minutes
-/**
- * An instance of RunningSummarizer manages the heuristics for summarizing.
- * Until disposed, the instance of RunningSummarizer can assume that it is
- * in a state of running, meaning it is connected and initialized.  It keeps
- * track of summaries that it is generating as they are broadcast and acked/nacked.
- * This object is created and controlled by Summarizer object.
- */
-export class RunningSummarizer {
-    constructor(baseLogger, summaryWatcher, configuration, submitSummaryCallback, heuristicData, raiseSummarizingError, summaryCollection, cancellationToken, stopSummarizerCallback) {
-        this.summaryWatcher = summaryWatcher;
-        this.configuration = configuration;
-        this.submitSummaryCallback = submitSummaryCallback;
-        this.heuristicData = heuristicData;
-        this.raiseSummarizingError = raiseSummarizingError;
-        this.summaryCollection = summaryCollection;
-        this.cancellationToken = cancellationToken;
-        this.stopSummarizerCallback = stopSummarizerCallback;
-        this.stopping = false;
-        this._disposed = false;
-        this.tryWhileSummarizing = false;
-        this.summarizeCount = 0;
-        this.totalSuccessfulAttempts = 0;
-        /**
-         * RunningSummarizer's logger includes the sequenced index of the current summary on each event.
-         * If some other Summarizer code wants that event on their logs they can get it here,
-         * but only if they're logging about that same summary.
-         * @param summaryOpRefSeq - RefSeq number of the summary op, to ensure the log correlation will be correct
-         */
-        this.tryGetCorrelatedLogger = (summaryOpRefSeq) => this.heuristicData.lastAttempt.refSequenceNumber === summaryOpRefSeq
-            ? this.logger
-            : undefined;
-        const telemetryProps = {
-            summarizeCount: () => this.summarizeCount,
-            summarizerSuccessfulAttempts: () => this.totalSuccessfulAttempts,
-        };
-        this.logger = ChildLogger.create(baseLogger, "Running", {
-            all: telemetryProps,
-        });
-        if (configuration.state !== "disableHeuristics") {
-            assert(this.configuration.state === "enabled", 0x2ea /* "Configuration state should be enabled" */);
-            this.heuristicRunner = new SummarizeHeuristicRunner(heuristicData, this.configuration, (reason) => this.trySummarize(reason), this.logger);
-        }
-        assert(this.configuration.state !== "disabled", 0x2eb /* "Summary not supported with configuration disabled" */);
-        // Cap the maximum amount of time client will wait for a summarize op ack to maxSummarizeAckWaitTime
-        // configuration.maxAckWaitTime is composed from defaults, server values, and runtime overrides
-        const maxAckWaitTime = Math.min(this.configuration.maxAckWaitTime, maxSummarizeAckWaitTime);
-        this.pendingAckTimer = new PromiseTimer(maxAckWaitTime, () => {
-            // pre-0.58 error message: summaryAckWaitTimeout
-            this.raiseSummarizingError("Pending summary ack not received in time");
-            // Note: summarizeCount (from ChildLogger definition) may be 0,
-            // since this code path is hit when RunningSummarizer first starts up,
-            // before this instance has kicked off a new summarize run.
-            this.logger.sendErrorEvent({
-                eventName: "SummaryAckWaitTimeout",
-                maxAckWaitTime,
-                referenceSequenceNumber: this.heuristicData.lastAttempt.refSequenceNumber,
-                summarySequenceNumber: this.heuristicData.lastAttempt.summarySequenceNumber,
-                timePending: Date.now() - this.heuristicData.lastAttempt.summaryTime,
-            });
-        });
-        // Set up pending ack timeout by op timestamp differences for previous summaries.
-        summaryCollection.setPendingAckTimerTimeoutCallback(maxAckWaitTime, () => {
-            if (this.pendingAckTimer.hasTimer) {
-                this.logger.sendTelemetryEvent({
-                    eventName: "MissingSummaryAckFoundByOps",
-                    referenceSequenceNumber: this.heuristicData.lastAttempt.refSequenceNumber,
-                    summarySequenceNumber: this.heuristicData.lastAttempt.summarySequenceNumber,
-                });
-                this.pendingAckTimer.clear();
-            }
-        });
-        this.generator = new SummaryGenerator(this.pendingAckTimer, this.heuristicData, this.submitSummaryCallback, this.raiseSummarizingError, () => { this.totalSuccessfulAttempts++; }, this.summaryWatcher, this.logger);
-    }
-    static async start(logger, summaryWatcher, configuration, submitSummaryCallback, heuristicData, raiseSummarizingError, summaryCollection, cancellationToken, stopSummarizerCallback) {
-        var _a;
-        const summarizer = new RunningSummarizer(logger, summaryWatcher, configuration, submitSummaryCallback, heuristicData, raiseSummarizingError, summaryCollection, cancellationToken, stopSummarizerCallback);
-        await summarizer.waitStart();
-        // Run the heuristics after starting
-        (_a = summarizer.heuristicRunner) === null || _a === void 0 ? void 0 : _a.run();
-        return summarizer;
-    }
-    get disposed() { return this._disposed; }
-    dispose() {
-        var _a;
-        this.summaryWatcher.dispose();
-        (_a = this.heuristicRunner) === null || _a === void 0 ? void 0 : _a.dispose();
-        this.heuristicRunner = undefined;
-        this.generator.dispose();
-        this.pendingAckTimer.clear();
-        this.disposeEnqueuedSummary();
-        this._disposed = true;
-        this.stopping = true;
-    }
-    handleSystemOp(op) {
-        switch (op.type) {
-            case MessageType.ClientLeave:
-            case MessageType.ClientJoin:
-            case MessageType.Propose: {
-                // Synchronously handle quorum ops like regular ops
-                this.handleOp(undefined, op);
-                return;
-            }
-            default: {
-                return;
-            }
-        }
-    }
-    handleOp(error, { sequenceNumber, type, clientId, contents }) {
-        var _a;
-        if (error !== undefined) {
-            return;
-        }
-        this.heuristicData.lastOpSequenceNumber = sequenceNumber;
-        // Check for enqueued on-demand summaries; Intentionally do nothing otherwise
-        if (!this.tryRunEnqueuedSummary()) {
-            (_a = this.heuristicRunner) === null || _a === void 0 ? void 0 : _a.run();
-        }
-    }
-    async waitStop(allowLastSummary) {
-        var _a;
-        if (this.stopping) {
-            return;
-        }
-        this.stopping = true;
-        this.disposeEnqueuedSummary();
-        // This will try to run lastSummary if needed.
-        if (allowLastSummary && ((_a = this.heuristicRunner) === null || _a === void 0 ? void 0 : _a.shouldRunLastSummary())) {
-            if (this.summarizingLock === undefined) {
-                this.trySummarizeOnce(
-                // summarizeProps
-                { reason: "lastSummary" }, 
-                // ISummarizeOptions, using defaults: { refreshLatestAck: false, fullTree: false }
-                {});
-            }
-        }
-        // Note that trySummarizeOnce() call above returns right away, without waiting.
-        // So we need to wait for its completion, otherwise it would be destroyed right away.
-        // That said, if summary lock was taken upfront, this wait might wait on  multiple retries to
-        // submit summary. We should reconsider this flow and make summarizer move to exit faster.
-        // This resolves when the current pending summary gets an ack or fails.
-        await this.summarizingLock;
-    }
-    async waitStart() {
-        // Wait no longer than ack timeout for all pending
-        const waitStartResult = await raceTimer(this.summaryWatcher.waitFlushed(), this.pendingAckTimer.start());
-        this.pendingAckTimer.clear();
-        // Remove pending ack wait timeout by op timestamp comparison, because
-        // it has race conditions with summaries submitted by this same client.
-        this.summaryCollection.unsetPendingAckTimerTimeoutCallback();
-        if (waitStartResult.result === "done" && waitStartResult.value !== undefined) {
-            this.heuristicData.updateWithLastSummaryAckInfo({
-                refSequenceNumber: waitStartResult.value.summaryOp.referenceSequenceNumber,
-                // This will be the Summarizer starting point so only use timestamps from client's machine.
-                summaryTime: Date.now(),
-                summarySequenceNumber: waitStartResult.value.summaryOp.sequenceNumber,
-            });
-        }
-    }
-    /**
-     * Blocks a new summarizer from running in case RefreshSummaryAck is being processed.
-     * Assumes that caller checked upfront for lack of concurrent action (this.refreshSummaryAckLock)
-     * before calling this API. I.e. caller is responsible for either erroring out or waiting on this promise.
-     * Note: The refreshSummaryAckLock makes sure no summarizer gets enqueued or processed
-     * until the refresh has completed. One can't rely uniquely on the summarizingLock as the
-     * refreshLatestSummaryAck also happens during the time summarizingLock !== undefined.
-     * Ex. Summarizer submits a summay + op and then waits for the Summary Ack to proceed
-     * with the refreshLatestSummaryAck and complete the summary.
-     * @param action - action to perform.
-     * @returns - result of action.
-     */
-    async lockedRefreshSummaryAckAction(action) {
-        assert(this.refreshSummaryAckLock === undefined, "Refresh Summary Ack - Caller is responsible for checking lock");
-        const refreshSummaryAckLock = new Deferred();
-        this.refreshSummaryAckLock = refreshSummaryAckLock.promise;
-        return action().finally(() => {
-            refreshSummaryAckLock.resolve();
-            this.refreshSummaryAckLock = undefined;
-        });
-    }
-    /**
-     * Runs single summary action that prevents any other concurrent actions.
-     * Assumes that caller checked upfront for lack of concurrent action (this.summarizingLock)
-     * before calling this API. I.e. caller is responsible for either erroring out or waiting on this promise.
-     * @param action - action to perform.
-     * @returns - result of action.
-     */
-    async lockedSummaryAction(action) {
-        assert(this.summarizingLock === undefined, 0x25b /* "Caller is responsible for checking lock" */);
-        const summarizingLock = new Deferred();
-        this.summarizingLock = summarizingLock.promise;
-        this.summarizeCount++;
-        // Make sure the RefreshLatestSummaryAck is not being executed.
-        await this.refreshSummaryAckLock;
-        return action().finally(() => {
-            var _a;
-            summarizingLock.resolve();
-            this.summarizingLock = undefined;
-            const retry = this.tryWhileSummarizing;
-            this.tryWhileSummarizing = false;
-            // After summarizing, we should check to see if we need to summarize again.
-            // Rerun the heuristics and check for enqueued summaries.
-            if (!this.stopping && !this.tryRunEnqueuedSummary() && retry) {
-                (_a = this.heuristicRunner) === null || _a === void 0 ? void 0 : _a.run();
-            }
-        });
-    }
-    /**
-     * Runs single summarize attempt
-     * @param summarizeProps - props to log with each telemetry event associated with this attempt
-     * @param options - summary options
-     * @param cancellationToken - cancellation token to use to be able to cancel this summary, if needed
-     * @param resultsBuilder - optional, result builder to use.
-     * @returns ISummarizeResult - result of running a summary.
-     */
-    trySummarizeOnce(summarizeProps, options, cancellationToken = this.cancellationToken, resultsBuilder = new SummarizeResultBuilder()) {
-        this.lockedSummaryAction(async () => {
-            const summarizeResult = this.generator.summarize(summarizeProps, options, cancellationToken, resultsBuilder);
-            // ensure we wait till the end of the process
-            return summarizeResult.receivedSummaryAckOrNack;
-        }).catch((error) => {
-            // SummaryGenerator.summarize() does not throw exceptions - it converts them to failed result
-            // on resultsBuilder
-            // We do not care about exceptions on receivedSummaryAckOrNack - caller should check results
-            // and take a appropriate action.
-        });
-        return resultsBuilder.build();
-    }
-    /** Heuristics summarize attempt. */
-    trySummarize(reason, cancellationToken = this.cancellationToken) {
-        if (this.summarizingLock !== undefined) {
-            // lockedSummaryAction() will retry heuristic-based summary at the end of current attempt
-            // if it's still needed
-            this.tryWhileSummarizing = true;
-            return;
-        }
-        this.lockedSummaryAction(async () => {
-            const attempts = [
-                { refreshLatestAck: false, fullTree: false },
-                { refreshLatestAck: true, fullTree: false },
-                { refreshLatestAck: true, fullTree: false, delaySeconds: 2 * 60 },
-                { refreshLatestAck: true, fullTree: true, delaySeconds: 10 * 60 },
-            ];
-            let overrideDelaySeconds;
-            let summaryAttempts = 0;
-            let summaryAttemptsPerPhase = 0;
-            let lastResult;
-            for (let summaryAttemptPhase = 0; summaryAttemptPhase < attempts.length;) {
-                if (this.cancellationToken.cancelled) {
-                    return;
-                }
-                // We only want to attempt 1 summary when reason is "lastSummary"
-                if (++summaryAttempts > 1 && reason === "lastSummary") {
-                    return;
-                }
-                summaryAttemptsPerPhase++;
-                const _a = attempts[summaryAttemptPhase], { delaySeconds: regularDelaySeconds = 0 } = _a, options = __rest(_a, ["delaySeconds"]);
-                const delaySeconds = overrideDelaySeconds !== null && overrideDelaySeconds !== void 0 ? overrideDelaySeconds : regularDelaySeconds;
-                const summarizeProps = Object.assign({ reason,
-                    summaryAttempts,
-                    summaryAttemptsPerPhase, summaryAttemptPhase: summaryAttemptPhase + 1 }, options);
-                if (delaySeconds > 0) {
-                    this.logger.sendPerformanceEvent(Object.assign({ eventName: "SummarizeAttemptDelay", duration: delaySeconds, summaryNackDelay: overrideDelaySeconds !== undefined }, summarizeProps));
-                    await delay(delaySeconds * 1000);
-                }
-                // Make sure the refresh Summary Ack is not being executed.
-                await this.refreshSummaryAckLock;
-                // Note: no need to account for cancellationToken.waitCancelled here, as
-                // this is accounted SummaryGenerator.summarizeCore that controls receivedSummaryAckOrNack.
-                const resultSummarize = this.generator.summarize(summarizeProps, options, cancellationToken);
-                const result = await resultSummarize.receivedSummaryAckOrNack;
-                if (result.success) {
-                    return;
-                }
-                // Check for retryDelay that can come from summaryNack or upload summary flow.
-                // Retry the same step only once per retryAfter response.
-                overrideDelaySeconds = result.retryAfterSeconds;
-                if (overrideDelaySeconds === undefined || summaryAttemptsPerPhase > 1) {
-                    summaryAttemptPhase++;
-                    summaryAttemptsPerPhase = 0;
-                }
-                lastResult = result;
-            }
-            // If all attempts failed, log error (with last attempt info) and close the summarizer container
-            this.logger.sendErrorEvent({
-                eventName: "FailToSummarize",
-                reason,
-                message: lastResult === null || lastResult === void 0 ? void 0 : lastResult.message,
-            }, lastResult === null || lastResult === void 0 ? void 0 : lastResult.error);
-            this.stopSummarizerCallback("failToSummarize");
-        }).catch((error) => {
-            this.logger.sendErrorEvent({ eventName: "UnexpectedSummarizeError" }, error);
-        });
-    }
-    /** {@inheritdoc (ISummarizer:interface).summarizeOnDemand} */
-    summarizeOnDemand(resultsBuilder = new SummarizeResultBuilder(), _a) {
-        var { reason } = _a, options = __rest(_a, ["reason"]);
-        if (this.stopping) {
-            resultsBuilder.fail("RunningSummarizer stopped or disposed", undefined);
-            return resultsBuilder.build();
-        }
-        // Check for concurrent summary attempts. If one is found,
-        // return a promise that caller can await before trying again.
-        if (this.summarizingLock !== undefined) {
-            // The heuristics are blocking concurrent summarize attempts.
-            throw new UsageError("Attempted to run an already-running summarizer on demand");
-        }
-        const result = this.trySummarizeOnce({ reason: `onDemand/${reason}` }, options, this.cancellationToken, resultsBuilder);
-        return result;
-    }
-    /** {@inheritdoc (ISummarizer:interface).enqueueSummarize} */
-    enqueueSummarize(_a) {
-        var { reason, afterSequenceNumber = 0, override = false } = _a, options = __rest(_a, ["reason", "afterSequenceNumber", "override"]);
-        const onDemandReason = `enqueue;${reason}`;
-        let overridden = false;
-        if (this.enqueuedSummary !== undefined) {
-            if (!override) {
-                return { alreadyEnqueued: true };
-            }
-            // Override existing enqueued summarize attempt.
-            this.enqueuedSummary.resultsBuilder.fail("Aborted; overridden by another enqueue summarize attempt", undefined);
-            this.enqueuedSummary = undefined;
-            overridden = true;
-        }
-        this.enqueuedSummary = {
-            reason: onDemandReason,
-            afterSequenceNumber,
-            options,
-            resultsBuilder: new SummarizeResultBuilder(),
-        };
-        const results = this.enqueuedSummary.resultsBuilder.build();
-        this.tryRunEnqueuedSummary();
-        return overridden ? Object.assign(Object.assign({}, results), { alreadyEnqueued: true, overridden: true }) : results;
-    }
-    tryRunEnqueuedSummary() {
-        if (this.stopping) {
-            this.disposeEnqueuedSummary();
-            return false;
-        }
-        if (this.enqueuedSummary === undefined
-            || this.heuristicData.lastOpSequenceNumber < this.enqueuedSummary.afterSequenceNumber
-            || this.summarizingLock !== undefined) {
-            // If no enqueued summary is ready or a summary is already in progress, take no action.
-            return false;
-        }
-        const { reason, resultsBuilder, options } = this.enqueuedSummary;
-        // Set to undefined first, so that subsequent enqueue attempt while summarize will occur later.
-        this.enqueuedSummary = undefined;
-        this.trySummarizeOnce({ reason: `enqueuedSummary/${reason}` }, options, this.cancellationToken, resultsBuilder);
-        return true;
-    }
-    disposeEnqueuedSummary() {
-        if (this.enqueuedSummary !== undefined) {
-            this.enqueuedSummary.resultsBuilder.fail("RunningSummarizer stopped or disposed", undefined);
-            this.enqueuedSummary = undefined;
-        }
-    }
-}
-//# sourceMappingURL=runningSummarizer.js.map

package/lib/runningSummarizer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"runningSummarizer.js","sourceRoot":"","sources":["../src/runningSummarizer.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 { IDisposable, ITelemetryLogger } from \"@fluidframework/common-definitions\";\nimport { assert, delay, Deferred, PromiseTimer } from \"@fluidframework/common-utils\";\nimport { UsageError } from \"@fluidframework/container-utils\";\nimport {\n    ISequencedDocumentMessage,\n    MessageType,\n} from \"@fluidframework/protocol-definitions\";\nimport { ChildLogger } from \"@fluidframework/telemetry-utils\";\nimport {\n    ISummaryConfiguration,\n} from \"./containerRuntime\";\nimport { SummarizeHeuristicRunner } from \"./summarizerHeuristics\";\nimport {\n    IEnqueueSummarizeOptions,\n    ISummarizeOptions,\n    ISummarizeHeuristicData,\n    ISummarizeHeuristicRunner,\n    IOnDemandSummarizeOptions,\n    EnqueueSummarizeResult,\n    SummarizerStopReason,\n    ISubmitSummaryOptions,\n    SubmitSummaryResult,\n    ISummaryCancellationToken,\n    ISummarizeResults,\n    ISummarizeTelemetryProperties,\n    ISummarizeRunnerTelemetry,\n} from \"./summarizerTypes\";\nimport { IClientSummaryWatcher, SummaryCollection } from \"./summaryCollection\";\nimport {\n    raceTimer,\n    SummarizeReason,\n    SummarizeResultBuilder,\n    SummaryGenerator,\n} from \"./summaryGenerator\";\n\nconst maxSummarizeAckWaitTime = 10 * 60 * 1000; // 10 minutes\n\n/**\n * An instance of RunningSummarizer manages the heuristics for summarizing.\n * Until disposed, the instance of RunningSummarizer can assume that it is\n * in a state of running, meaning it is connected and initialized.  It keeps\n * track of summaries that it is generating as they are broadcast and acked/nacked.\n * This object is created and controlled by Summarizer object.\n */\nexport class RunningSummarizer implements IDisposable {\n    public static async start(\n        logger: ITelemetryLogger,\n        summaryWatcher: IClientSummaryWatcher,\n        configuration: ISummaryConfiguration,\n        submitSummaryCallback: (options: ISubmitSummaryOptions) => Promise<SubmitSummaryResult>,\n        heuristicData: ISummarizeHeuristicData,\n        raiseSummarizingError: (errorMessage: string) => void,\n        summaryCollection: SummaryCollection,\n        cancellationToken: ISummaryCancellationToken,\n        stopSummarizerCallback: (reason: SummarizerStopReason) => void,\n    ): Promise<RunningSummarizer> {\n        const summarizer = new RunningSummarizer(\n            logger,\n            summaryWatcher,\n            configuration,\n            submitSummaryCallback,\n            heuristicData,\n            raiseSummarizingError,\n            summaryCollection,\n            cancellationToken,\n            stopSummarizerCallback);\n\n        await summarizer.waitStart();\n\n        // Run the heuristics after starting\n        summarizer.heuristicRunner?.run();\n        return summarizer;\n    }\n\n    public get disposed() { return this._disposed; }\n    private stopping = false;\n    private _disposed = false;\n    private summarizingLock: Promise<void> | undefined;\n    private refreshSummaryAckLock: Promise<void> | undefined;\n    private tryWhileSummarizing = false;\n    private readonly pendingAckTimer: PromiseTimer;\n    private heuristicRunner?: ISummarizeHeuristicRunner;\n    private readonly generator: SummaryGenerator;\n    private readonly logger: ITelemetryLogger;\n    private enqueuedSummary: {\n        reason: SummarizeReason;\n        afterSequenceNumber: number;\n        options: ISummarizeOptions;\n        readonly resultsBuilder: SummarizeResultBuilder;\n    } | undefined;\n    private summarizeCount = 0;\n    private totalSuccessfulAttempts = 0;\n\n    private constructor(\n        baseLogger: ITelemetryLogger,\n        private readonly summaryWatcher: IClientSummaryWatcher,\n        private readonly configuration: ISummaryConfiguration,\n        private readonly submitSummaryCallback: (options: ISubmitSummaryOptions) => Promise<SubmitSummaryResult>,\n        private readonly heuristicData: ISummarizeHeuristicData,\n        private readonly raiseSummarizingError: (errorMessage: string) => void,\n        private readonly summaryCollection: SummaryCollection,\n        private readonly cancellationToken: ISummaryCancellationToken,\n        private readonly stopSummarizerCallback: (reason: SummarizerStopReason) => void,\n    ) {\n        const telemetryProps: ISummarizeRunnerTelemetry = {\n            summarizeCount: () => this.summarizeCount,\n            summarizerSuccessfulAttempts: () => this.totalSuccessfulAttempts,\n        };\n\n        this.logger = ChildLogger.create(\n            baseLogger, \"Running\",\n            {\n                all: telemetryProps,\n            },\n        );\n\n        if (configuration.state !== \"disableHeuristics\") {\n            assert(this.configuration.state === \"enabled\", 0x2ea /* \"Configuration state should be enabled\" */);\n            this.heuristicRunner = new SummarizeHeuristicRunner(\n                heuristicData,\n                this.configuration,\n                (reason) => this.trySummarize(reason),\n                this.logger);\n        }\n\n        assert(\n            this.configuration.state !== \"disabled\",\n            0x2eb /* \"Summary not supported with configuration disabled\" */,\n        );\n\n        // Cap the maximum amount of time client will wait for a summarize op ack to maxSummarizeAckWaitTime\n        // configuration.maxAckWaitTime is composed from defaults, server values, and runtime overrides\n\n        const maxAckWaitTime = Math.min(this.configuration.maxAckWaitTime, maxSummarizeAckWaitTime);\n\n        this.pendingAckTimer = new PromiseTimer(\n            maxAckWaitTime,\n            () => {\n                // pre-0.58 error message: summaryAckWaitTimeout\n                this.raiseSummarizingError(\"Pending summary ack not received in time\");\n                // Note: summarizeCount (from ChildLogger definition) may be 0,\n                // since this code path is hit when RunningSummarizer first starts up,\n                // before this instance has kicked off a new summarize run.\n                this.logger.sendErrorEvent({\n                    eventName: \"SummaryAckWaitTimeout\",\n                    maxAckWaitTime,\n                    referenceSequenceNumber: this.heuristicData.lastAttempt.refSequenceNumber,\n                    summarySequenceNumber: this.heuristicData.lastAttempt.summarySequenceNumber,\n                    timePending: Date.now() - this.heuristicData.lastAttempt.summaryTime,\n                });\n            });\n        // Set up pending ack timeout by op timestamp differences for previous summaries.\n        summaryCollection.setPendingAckTimerTimeoutCallback(maxAckWaitTime, () => {\n            if (this.pendingAckTimer.hasTimer) {\n                this.logger.sendTelemetryEvent({\n                    eventName: \"MissingSummaryAckFoundByOps\",\n                    referenceSequenceNumber: this.heuristicData.lastAttempt.refSequenceNumber,\n                    summarySequenceNumber: this.heuristicData.lastAttempt.summarySequenceNumber,\n                });\n                this.pendingAckTimer.clear();\n            }\n        });\n\n        this.generator = new SummaryGenerator(\n            this.pendingAckTimer,\n            this.heuristicData,\n            this.submitSummaryCallback,\n            this.raiseSummarizingError,\n            () => { this.totalSuccessfulAttempts++; },\n            this.summaryWatcher,\n            this.logger,\n        );\n    }\n\n    public dispose(): void {\n        this.summaryWatcher.dispose();\n        this.heuristicRunner?.dispose();\n        this.heuristicRunner = undefined;\n        this.generator.dispose();\n        this.pendingAckTimer.clear();\n        this.disposeEnqueuedSummary();\n        this._disposed = true;\n        this.stopping = true;\n    }\n\n    /**\n     * RunningSummarizer's logger includes the sequenced index of the current summary on each event.\n     * If some other Summarizer code wants that event on their logs they can get it here,\n     * but only if they're logging about that same summary.\n     * @param summaryOpRefSeq - RefSeq number of the summary op, to ensure the log correlation will be correct\n     */\n    public tryGetCorrelatedLogger = (summaryOpRefSeq) =>\n        this.heuristicData.lastAttempt.refSequenceNumber === summaryOpRefSeq\n            ? this.logger\n            : undefined;\n\n    public handleSystemOp(op: ISequencedDocumentMessage) {\n        switch (op.type) {\n            case MessageType.ClientLeave:\n            case MessageType.ClientJoin:\n            case MessageType.Propose: {\n                // Synchronously handle quorum ops like regular ops\n                this.handleOp(undefined, op);\n                return;\n            }\n            default: {\n                return;\n            }\n        }\n    }\n\n    public handleOp(error: any, { sequenceNumber, type, clientId, contents }: ISequencedDocumentMessage) {\n        if (error !== undefined) {\n            return;\n        }\n        this.heuristicData.lastOpSequenceNumber = sequenceNumber;\n\n        // Check for enqueued on-demand summaries; Intentionally do nothing otherwise\n        if (!this.tryRunEnqueuedSummary()) {\n            this.heuristicRunner?.run();\n        }\n    }\n\n    public async waitStop(allowLastSummary: boolean): Promise<void> {\n        if (this.stopping) {\n            return;\n        }\n\n        this.stopping = true;\n\n        this.disposeEnqueuedSummary();\n\n        // This will try to run lastSummary if needed.\n        if (allowLastSummary && this.heuristicRunner?.shouldRunLastSummary()) {\n            if (this.summarizingLock === undefined) {\n                this.trySummarizeOnce(\n                    // summarizeProps\n                    { reason: \"lastSummary\" },\n                    // ISummarizeOptions, using defaults: { refreshLatestAck: false, fullTree: false }\n                    {});\n            }\n        }\n\n        // Note that trySummarizeOnce() call above returns right away, without waiting.\n        // So we need to wait for its completion, otherwise it would be destroyed right away.\n        // That said, if summary lock was taken upfront, this wait might wait on  multiple retries to\n        // submit summary. We should reconsider this flow and make summarizer move to exit faster.\n        // This resolves when the current pending summary gets an ack or fails.\n        await this.summarizingLock;\n    }\n\n    private async waitStart() {\n        // Wait no longer than ack timeout for all pending\n        const waitStartResult = await raceTimer(\n            this.summaryWatcher.waitFlushed(),\n            this.pendingAckTimer.start(),\n        );\n        this.pendingAckTimer.clear();\n\n        // Remove pending ack wait timeout by op timestamp comparison, because\n        // it has race conditions with summaries submitted by this same client.\n        this.summaryCollection.unsetPendingAckTimerTimeoutCallback();\n\n        if (waitStartResult.result === \"done\" && waitStartResult.value !== undefined) {\n            this.heuristicData.updateWithLastSummaryAckInfo({\n                refSequenceNumber: waitStartResult.value.summaryOp.referenceSequenceNumber,\n                // This will be the Summarizer starting point so only use timestamps from client's machine.\n                summaryTime: Date.now(),\n                summarySequenceNumber: waitStartResult.value.summaryOp.sequenceNumber,\n            });\n        }\n    }\n\n    /**\n     * Blocks a new summarizer from running in case RefreshSummaryAck is being processed.\n     * Assumes that caller checked upfront for lack of concurrent action (this.refreshSummaryAckLock)\n     * before calling this API. I.e. caller is responsible for either erroring out or waiting on this promise.\n     * Note: The refreshSummaryAckLock makes sure no summarizer gets enqueued or processed\n     * until the refresh has completed. One can't rely uniquely on the summarizingLock as the\n     * refreshLatestSummaryAck also happens during the time summarizingLock !== undefined.\n     * Ex. Summarizer submits a summay + op and then waits for the Summary Ack to proceed\n     * with the refreshLatestSummaryAck and complete the summary.\n     * @param action - action to perform.\n     * @returns - result of action.\n     */\n    public async lockedRefreshSummaryAckAction<T>(action: () => Promise<T>) {\n        assert(this.refreshSummaryAckLock === undefined,\n            \"Refresh Summary Ack - Caller is responsible for checking lock\");\n\n        const refreshSummaryAckLock = new Deferred<void>();\n        this.refreshSummaryAckLock = refreshSummaryAckLock.promise;\n\n        return action().finally(() => {\n            refreshSummaryAckLock.resolve();\n            this.refreshSummaryAckLock = undefined;\n        });\n    }\n\n    /**\n     * Runs single summary action that prevents any other concurrent actions.\n     * Assumes that caller checked upfront for lack of concurrent action (this.summarizingLock)\n     * before calling this API. I.e. caller is responsible for either erroring out or waiting on this promise.\n     * @param action - action to perform.\n     * @returns - result of action.\n     */\n    private async lockedSummaryAction<T>(action: () => Promise<T>) {\n        assert(this.summarizingLock === undefined, 0x25b /* \"Caller is responsible for checking lock\" */);\n\n        const summarizingLock = new Deferred<void>();\n        this.summarizingLock = summarizingLock.promise;\n\n        this.summarizeCount++;\n        // Make sure the RefreshLatestSummaryAck is not being executed.\n        await this.refreshSummaryAckLock;\n\n        return action().finally(() => {\n            summarizingLock.resolve();\n            this.summarizingLock = undefined;\n\n            const retry = this.tryWhileSummarizing;\n            this.tryWhileSummarizing = false;\n\n            // After summarizing, we should check to see if we need to summarize again.\n            // Rerun the heuristics and check for enqueued summaries.\n            if (!this.stopping && !this.tryRunEnqueuedSummary() && retry) {\n                this.heuristicRunner?.run();\n            }\n        });\n    }\n\n    /**\n     * Runs single summarize attempt\n     * @param summarizeProps - props to log with each telemetry event associated with this attempt\n     * @param options - summary options\n     * @param cancellationToken - cancellation token to use to be able to cancel this summary, if needed\n     * @param resultsBuilder - optional, result builder to use.\n     * @returns ISummarizeResult - result of running a summary.\n     */\n    private trySummarizeOnce(\n        summarizeProps: ISummarizeTelemetryProperties,\n        options: ISummarizeOptions,\n        cancellationToken = this.cancellationToken,\n        resultsBuilder = new SummarizeResultBuilder()): ISummarizeResults {\n        this.lockedSummaryAction(async () => {\n            const summarizeResult = this.generator.summarize(\n                summarizeProps,\n                options,\n                cancellationToken,\n                resultsBuilder);\n            // ensure we wait till the end of the process\n            return summarizeResult.receivedSummaryAckOrNack;\n        }).catch((error) => {\n            // SummaryGenerator.summarize() does not throw exceptions - it converts them to failed result\n            // on resultsBuilder\n            // We do not care about exceptions on receivedSummaryAckOrNack - caller should check results\n            // and take a appropriate action.\n        });\n\n        return resultsBuilder.build();\n    }\n\n    /** Heuristics summarize attempt. */\n    private trySummarize(\n        reason: SummarizeReason,\n        cancellationToken = this.cancellationToken): void {\n        if (this.summarizingLock !== undefined) {\n            // lockedSummaryAction() will retry heuristic-based summary at the end of current attempt\n            // if it's still needed\n            this.tryWhileSummarizing = true;\n            return;\n        }\n\n        this.lockedSummaryAction(async () => {\n            const attempts: (ISummarizeOptions & { delaySeconds?: number; })[] = [\n                { refreshLatestAck: false, fullTree: false },\n                { refreshLatestAck: true, fullTree: false },\n                { refreshLatestAck: true, fullTree: false, delaySeconds: 2 * 60 },\n                { refreshLatestAck: true, fullTree: true, delaySeconds: 10 * 60 },\n            ];\n            let overrideDelaySeconds: number | undefined;\n            let summaryAttempts = 0;\n            let summaryAttemptsPerPhase = 0;\n\n            let lastResult: { message: string; error: any; } | undefined;\n\n            for (let summaryAttemptPhase = 0; summaryAttemptPhase < attempts.length;) {\n                if (this.cancellationToken.cancelled) {\n                    return;\n                }\n\n                // We only want to attempt 1 summary when reason is \"lastSummary\"\n                if (++summaryAttempts > 1 && reason === \"lastSummary\") {\n                    return;\n                }\n\n                summaryAttemptsPerPhase++;\n\n                const { delaySeconds: regularDelaySeconds = 0, ...options } = attempts[summaryAttemptPhase];\n                const delaySeconds = overrideDelaySeconds ?? regularDelaySeconds;\n\n                const summarizeProps: ISummarizeTelemetryProperties = {\n                    reason,\n                    summaryAttempts,\n                    summaryAttemptsPerPhase,\n                    summaryAttemptPhase: summaryAttemptPhase + 1, // make everything 1-based\n                    ...options,\n                };\n\n                if (delaySeconds > 0) {\n                    this.logger.sendPerformanceEvent({\n                        eventName: \"SummarizeAttemptDelay\",\n                        duration: delaySeconds,\n                        summaryNackDelay: overrideDelaySeconds !== undefined,\n                        ...summarizeProps,\n                    });\n                    await delay(delaySeconds * 1000);\n                }\n\n                // Make sure the refresh Summary Ack is not being executed.\n                await this.refreshSummaryAckLock;\n\n                // Note: no need to account for cancellationToken.waitCancelled here, as\n                // this is accounted SummaryGenerator.summarizeCore that controls receivedSummaryAckOrNack.\n                const resultSummarize = this.generator.summarize(summarizeProps, options, cancellationToken);\n                const result = await resultSummarize.receivedSummaryAckOrNack;\n\n                if (result.success) {\n                    return;\n                }\n                // Check for retryDelay that can come from summaryNack or upload summary flow.\n                // Retry the same step only once per retryAfter response.\n                overrideDelaySeconds = result.retryAfterSeconds;\n                if (overrideDelaySeconds === undefined || summaryAttemptsPerPhase > 1) {\n                    summaryAttemptPhase++;\n                    summaryAttemptsPerPhase = 0;\n                }\n                lastResult = result;\n            }\n\n            // If all attempts failed, log error (with last attempt info) and close the summarizer container\n            this.logger.sendErrorEvent({\n                eventName: \"FailToSummarize\",\n                reason,\n                message: lastResult?.message,\n            }, lastResult?.error);\n\n            this.stopSummarizerCallback(\"failToSummarize\");\n        }).catch((error) => {\n            this.logger.sendErrorEvent({ eventName: \"UnexpectedSummarizeError\" }, error);\n        });\n    }\n\n    /** {@inheritdoc (ISummarizer:interface).summarizeOnDemand} */\n    public summarizeOnDemand(\n        resultsBuilder: SummarizeResultBuilder = new SummarizeResultBuilder(),\n        {\n            reason,\n            ...options\n        }: IOnDemandSummarizeOptions): ISummarizeResults {\n        if (this.stopping) {\n            resultsBuilder.fail(\"RunningSummarizer stopped or disposed\", undefined);\n            return resultsBuilder.build();\n        }\n        // Check for concurrent summary attempts. If one is found,\n        // return a promise that caller can await before trying again.\n        if (this.summarizingLock !== undefined) {\n            // The heuristics are blocking concurrent summarize attempts.\n            throw new UsageError(\"Attempted to run an already-running summarizer on demand\");\n        }\n\n        const result = this.trySummarizeOnce(\n            { reason: `onDemand/${reason}` },\n            options,\n            this.cancellationToken,\n            resultsBuilder);\n        return result;\n    }\n\n    /** {@inheritdoc (ISummarizer:interface).enqueueSummarize} */\n    public enqueueSummarize({\n        reason,\n        afterSequenceNumber = 0,\n        override = false,\n        ...options\n    }: IEnqueueSummarizeOptions): EnqueueSummarizeResult {\n        const onDemandReason = `enqueue;${reason}` as const;\n        let overridden = false;\n        if (this.enqueuedSummary !== undefined) {\n            if (!override) {\n                return { alreadyEnqueued: true };\n            }\n            // Override existing enqueued summarize attempt.\n            this.enqueuedSummary.resultsBuilder.fail(\n                \"Aborted; overridden by another enqueue summarize attempt\",\n                undefined,\n            );\n            this.enqueuedSummary = undefined;\n            overridden = true;\n        }\n        this.enqueuedSummary = {\n            reason: onDemandReason,\n            afterSequenceNumber,\n            options,\n            resultsBuilder: new SummarizeResultBuilder(),\n        };\n        const results = this.enqueuedSummary.resultsBuilder.build();\n        this.tryRunEnqueuedSummary();\n        return overridden ? {\n            ...results,\n            alreadyEnqueued: true,\n            overridden: true,\n        } : results;\n    }\n\n    private tryRunEnqueuedSummary() {\n        if (this.stopping) {\n            this.disposeEnqueuedSummary();\n            return false;\n        }\n        if (\n            this.enqueuedSummary === undefined\n            || this.heuristicData.lastOpSequenceNumber < this.enqueuedSummary.afterSequenceNumber\n            || this.summarizingLock !== undefined\n        ) {\n            // If no enqueued summary is ready or a summary is already in progress, take no action.\n            return false;\n        }\n        const { reason, resultsBuilder, options } = this.enqueuedSummary;\n        // Set to undefined first, so that subsequent enqueue attempt while summarize will occur later.\n        this.enqueuedSummary = undefined;\n        this.trySummarizeOnce(\n            { reason: `enqueuedSummary/${reason}` },\n            options,\n            this.cancellationToken,\n            resultsBuilder);\n        return true;\n    }\n\n    private disposeEnqueuedSummary() {\n        if (this.enqueuedSummary !== undefined) {\n            this.enqueuedSummary.resultsBuilder.fail(\"RunningSummarizer stopped or disposed\", undefined);\n            this.enqueuedSummary = undefined;\n        }\n    }\n}\n"]}

package/lib/serializedSnapshotStorage.d.ts

@@ -1,58 +0,0 @@
-/*!
- * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
- * Licensed under the MIT License.
- */
-import { IDocumentStorageService, ISummaryContext } from "@fluidframework/driver-definitions";
-import { ICreateBlobResponse, ISnapshotTree, ISummaryHandle, ISummaryTree, IVersion } from "@fluidframework/protocol-definitions";
-import { ISnapshotTreeWithBlobContents } from "@fluidframework/container-definitions";
-/**
- * Serialized blobs from a snapshot. Used to load offline.
- */
-export interface ISerializedBaseSnapshotBlobs {
-    [id: string]: string;
-}
-/**
- * A storage wrapper that can serialize blobs from a snapshot tree and then use them to rehydrate.
- * Used in offline load/attached dehydration to save snapshot blobs that are still needed but may have been deleted.
- */
-export declare class SerializedSnapshotStorage implements IDocumentStorageService {
-    private readonly storageGetter;
-    private readonly blobs;
-    constructor(storageGetter: () => IDocumentStorageService, blobs: ISerializedBaseSnapshotBlobs);
-    static serializeTree(snapshot: ISnapshotTree, storage: IDocumentStorageService): Promise<ISerializedBaseSnapshotBlobs>;
-    private static serializeTreeCore;
-    static serializeTreeWithBlobContents(snapshot: ISnapshotTreeWithBlobContents): ISerializedBaseSnapshotBlobs;
-    private static serializeTreeWithBlobContentsCore;
-    private _storage?;
-    private get storage();
-    get repositoryUrl(): string;
-    /**
-     * Reads the object with the given ID, returns content in arrayBufferLike
-     */
-    readBlob(id: string): Promise<ArrayBufferLike>;
-    /**
-     * Returns the snapshot tree.
-     */
-    getSnapshotTree(version?: IVersion): Promise<ISnapshotTree | null>;
-    /**
-     * Retrieves all versions of the document starting at the specified versionId - or null if from the head
-     */
-    getVersions(versionId: string | null, count: number): Promise<IVersion[]>;
-    /**
-     * Creates a blob out of the given buffer
-     */
-    createBlob(file: ArrayBufferLike): Promise<ICreateBlobResponse>;
-    /**
-     * Uploads a summary tree to storage using the given context for reference of previous summary handle.
-     * The ISummaryHandles in the uploaded tree should have paths to indicate which summary object they are
-     * referencing from the previously acked summary.
-     * Returns the uploaded summary handle.
-     */
-    uploadSummaryWithContext(summary: ISummaryTree, context: ISummaryContext): Promise<string>;
-    /**
-     * Retrieves the commit that matches the packfile handle. If the packfile has already been committed and the
-     * server has deleted it this call may result in a broken promise.
-     */
-    downloadSummary(handle: ISummaryHandle): Promise<ISummaryTree>;
-}
-//# sourceMappingURL=serializedSnapshotStorage.d.ts.map

package/lib/serializedSnapshotStorage.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"serializedSnapshotStorage.d.ts","sourceRoot":"","sources":["../src/serializedSnapshotStorage.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC9F,OAAO,EACH,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,YAAY,EACZ,QAAQ,EACX,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,6BAA6B,EAAE,MAAM,uCAAuC,CAAC;AAEtF;;GAEG;AACH,MAAM,WAAW,4BAA4B;IACzC,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,qBAAa,yBAA0B,YAAW,uBAAuB;IAEjE,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK;gBADL,aAAa,EAAE,MAAM,uBAAuB,EAC5C,KAAK,EAAE,4BAA4B;WAGpC,aAAa,CAC7B,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,uBAAuB,GACjC,OAAO,CAAC,4BAA4B,CAAC;mBAMnB,iBAAiB;WAiBxB,6BAA6B,CACvC,QAAQ,EAAE,6BAA6B,GACxC,4BAA4B;IAM/B,OAAO,CAAC,MAAM,CAAC,iCAAiC;IAehD,OAAO,CAAC,QAAQ,CAAC,CAA0B;IAC3C,OAAO,KAAK,OAAO,GAQlB;IAED,IAAW,aAAa,IAAI,MAAM,CAAuC;IAEzE;;OAEG;IACU,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAO3D;;OAEG;IAEU,eAAe,CAAC,OAAO,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAI/E;;OAEG;IAEU,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAItF;;OAEG;IACU,UAAU,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAI5E;;;;;OAKG;IACU,wBAAwB,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;IAIvG;;;OAGG;IACU,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;CAG9E"}

package/lib/serializedSnapshotStorage.js

@@ -1,104 +0,0 @@
-/*!
- * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
- * Licensed under the MIT License.
- */
-import { assert, bufferToString, stringToBuffer } from "@fluidframework/common-utils";
-/**
- * A storage wrapper that can serialize blobs from a snapshot tree and then use them to rehydrate.
- * Used in offline load/attached dehydration to save snapshot blobs that are still needed but may have been deleted.
- */
-export class SerializedSnapshotStorage {
-    constructor(storageGetter, blobs) {
-        this.storageGetter = storageGetter;
-        this.blobs = blobs;
-    }
-    static async serializeTree(snapshot, storage) {
-        const blobs = {};
-        await this.serializeTreeCore(snapshot, blobs, storage);
-        return blobs;
-    }
-    static async serializeTreeCore(tree, blobs, storage) {
-        const treePs = [];
-        for (const subTree of Object.values(tree.trees)) {
-            treePs.push(this.serializeTreeCore(subTree, blobs, storage));
-        }
-        for (const id of Object.values(tree.blobs)) {
-            const blob = await storage.readBlob(id);
-            // ArrayBufferLike will not survive JSON.stringify()
-            blobs[id] = bufferToString(blob, "utf8");
-        }
-        return Promise.all(treePs);
-    }
-    static serializeTreeWithBlobContents(snapshot) {
-        const blobs = {};
-        this.serializeTreeWithBlobContentsCore(snapshot, blobs);
-        return blobs;
-    }
-    static serializeTreeWithBlobContentsCore(tree, blobs) {
-        for (const subTree of Object.values(tree.trees)) {
-            this.serializeTreeWithBlobContentsCore(subTree, blobs);
-        }
-        for (const id of Object.values(tree.blobs)) {
-            const blob = tree.blobsContents[id];
-            assert(!!blob, 0x2ec /* "Blob must be present in blobsContents" */);
-            // ArrayBufferLike will not survive JSON.stringify()
-            blobs[id] = bufferToString(blob, "utf8");
-        }
-    }
-    get storage() {
-        // avoid calling it until we need it since it will be undefined if we're not connected
-        // and we shouldn't need it in this case anyway
-        if (this._storage) {
-            return this._storage;
-        }
-        this._storage = this.storageGetter();
-        return this._storage;
-    }
-    get repositoryUrl() { return this.storage.repositoryUrl; }
-    /**
-     * Reads the object with the given ID, returns content in arrayBufferLike
-     */
-    async readBlob(id) {
-        if (this.blobs[id] !== undefined) {
-            return stringToBuffer(this.blobs[id], "utf8");
-        }
-        return this.storage.readBlob(id);
-    }
-    /**
-     * Returns the snapshot tree.
-     */
-    // eslint-disable-next-line @rushstack/no-new-null
-    async getSnapshotTree(version) {
-        return this.storage.getSnapshotTree(version);
-    }
-    /**
-     * Retrieves all versions of the document starting at the specified versionId - or null if from the head
-     */
-    // eslint-disable-next-line @rushstack/no-new-null
-    async getVersions(versionId, count) {
-        return this.storage.getVersions(versionId, count);
-    }
-    /**
-     * Creates a blob out of the given buffer
-     */
-    async createBlob(file) {
-        return this.storage.createBlob(file);
-    }
-    /**
-     * Uploads a summary tree to storage using the given context for reference of previous summary handle.
-     * The ISummaryHandles in the uploaded tree should have paths to indicate which summary object they are
-     * referencing from the previously acked summary.
-     * Returns the uploaded summary handle.
-     */
-    async uploadSummaryWithContext(summary, context) {
-        return this.storage.uploadSummaryWithContext(summary, context);
-    }
-    /**
-     * Retrieves the commit that matches the packfile handle. If the packfile has already been committed and the
-     * server has deleted it this call may result in a broken promise.
-     */
-    async downloadSummary(handle) {
-        return this.storage.downloadSummary(handle);
-    }
-}
-//# sourceMappingURL=serializedSnapshotStorage.js.map

package/lib/serializedSnapshotStorage.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"serializedSnapshotStorage.js","sourceRoot":"","sources":["../src/serializedSnapshotStorage.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 { assert, bufferToString, stringToBuffer } from \"@fluidframework/common-utils\";\nimport { IDocumentStorageService, ISummaryContext } from \"@fluidframework/driver-definitions\";\nimport {\n    ICreateBlobResponse,\n    ISnapshotTree,\n    ISummaryHandle,\n    ISummaryTree,\n    IVersion,\n} from \"@fluidframework/protocol-definitions\";\nimport { ISnapshotTreeWithBlobContents } from \"@fluidframework/container-definitions\";\n\n/**\n * Serialized blobs from a snapshot. Used to load offline.\n */\nexport interface ISerializedBaseSnapshotBlobs {\n    [id: string]: string;\n}\n\n/**\n * A storage wrapper that can serialize blobs from a snapshot tree and then use them to rehydrate.\n * Used in offline load/attached dehydration to save snapshot blobs that are still needed but may have been deleted.\n */\nexport class SerializedSnapshotStorage implements IDocumentStorageService {\n    constructor(\n        private readonly storageGetter: () => IDocumentStorageService,\n        private readonly blobs: ISerializedBaseSnapshotBlobs,\n    ) { }\n\n    public static async serializeTree(\n        snapshot: ISnapshotTree,\n        storage: IDocumentStorageService,\n    ): Promise<ISerializedBaseSnapshotBlobs> {\n        const blobs = {};\n        await this.serializeTreeCore(snapshot, blobs, storage);\n        return blobs;\n    }\n\n    private static async serializeTreeCore(\n        tree: ISnapshotTree,\n        blobs: ISerializedBaseSnapshotBlobs,\n        storage: IDocumentStorageService,\n    ) {\n        const treePs: Promise<any>[] = [];\n        for (const subTree of Object.values(tree.trees)) {\n            treePs.push(this.serializeTreeCore(subTree, blobs, storage));\n        }\n        for (const id of Object.values(tree.blobs)) {\n            const blob = await storage.readBlob(id);\n            // ArrayBufferLike will not survive JSON.stringify()\n            blobs[id] = bufferToString(blob, \"utf8\");\n        }\n        return Promise.all(treePs);\n    }\n\n    public static serializeTreeWithBlobContents(\n        snapshot: ISnapshotTreeWithBlobContents,\n    ): ISerializedBaseSnapshotBlobs {\n        const blobs = {};\n        this.serializeTreeWithBlobContentsCore(snapshot, blobs);\n        return blobs;\n    }\n\n    private static serializeTreeWithBlobContentsCore(\n        tree: ISnapshotTreeWithBlobContents,\n        blobs: ISerializedBaseSnapshotBlobs,\n    ) {\n        for (const subTree of Object.values(tree.trees)) {\n            this.serializeTreeWithBlobContentsCore(subTree, blobs);\n        }\n        for (const id of Object.values(tree.blobs)) {\n            const blob = tree.blobsContents[id];\n            assert(!!blob, 0x2ec /* \"Blob must be present in blobsContents\" */);\n            // ArrayBufferLike will not survive JSON.stringify()\n            blobs[id] = bufferToString(blob, \"utf8\");\n        }\n    }\n\n    private _storage?: IDocumentStorageService;\n    private get storage(): IDocumentStorageService {\n        // avoid calling it until we need it since it will be undefined if we're not connected\n        // and we shouldn't need it in this case anyway\n        if (this._storage) {\n            return this._storage;\n        }\n        this._storage = this.storageGetter();\n        return this._storage;\n    }\n\n    public get repositoryUrl(): string { return this.storage.repositoryUrl; }\n\n    /**\n     * Reads the object with the given ID, returns content in arrayBufferLike\n     */\n    public async readBlob(id: string): Promise<ArrayBufferLike> {\n        if (this.blobs[id] !== undefined) {\n            return stringToBuffer(this.blobs[id], \"utf8\");\n        }\n        return this.storage.readBlob(id);\n    }\n\n    /**\n     * Returns the snapshot tree.\n     */\n    // eslint-disable-next-line @rushstack/no-new-null\n    public async getSnapshotTree(version?: IVersion): Promise<ISnapshotTree | null> {\n        return this.storage.getSnapshotTree(version);\n    }\n\n    /**\n     * Retrieves all versions of the document starting at the specified versionId - or null if from the head\n     */\n    // eslint-disable-next-line @rushstack/no-new-null\n    public async getVersions(versionId: string | null, count: number): Promise<IVersion[]> {\n        return this.storage.getVersions(versionId, count);\n    }\n\n    /**\n     * Creates a blob out of the given buffer\n     */\n    public async createBlob(file: ArrayBufferLike): Promise<ICreateBlobResponse> {\n        return this.storage.createBlob(file);\n    }\n\n    /**\n     * Uploads a summary tree to storage using the given context for reference of previous summary handle.\n     * The ISummaryHandles in the uploaded tree should have paths to indicate which summary object they are\n     * referencing from the previously acked summary.\n     * Returns the uploaded summary handle.\n     */\n    public async uploadSummaryWithContext(summary: ISummaryTree, context: ISummaryContext): Promise<string> {\n        return this.storage.uploadSummaryWithContext(summary, context);\n    }\n\n    /**\n     * Retrieves the commit that matches the packfile handle. If the packfile has already been committed and the\n     * server has deleted it this call may result in a broken promise.\n     */\n    public async downloadSummary(handle: ISummaryHandle): Promise<ISummaryTree> {\n        return this.storage.downloadSummary(handle);\n    }\n}\n"]}