@fluidframework/container-runtime 2.100.0 → 2.101.1

package/dist/summary/summarizerTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"summarizerTypes.js","sourceRoot":"","sources":["../../src/summary/summarizerTypes.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAiCU,QAAA,oBAAoB,GAAG,YAAY,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport type {\n\tIDeltaManager,\n\tContainerWarning,\n} from \"@fluidframework/container-definitions/internal\";\nimport type {\n\tISummarizerEvents,\n\tSummarizerStopReason,\n} from \"@fluidframework/container-runtime-definitions/internal\";\nimport type {\n\tIEventProvider,\n\tITelemetryBaseProperties,\n\tITelemetryBaseLogger,\n} from \"@fluidframework/core-interfaces\";\nimport type { ISummaryTree } from \"@fluidframework/driver-definitions\";\nimport type {\n\tIDocumentMessage,\n\tISequencedDocumentMessage,\n} from \"@fluidframework/driver-definitions/internal\";\nimport type { ISummaryStats } from \"@fluidframework/runtime-definitions/internal\";\nimport type { TelemetryContext } from \"@fluidframework/runtime-utils/internal\";\nimport type {\n\tITelemetryLoggerExt,\n\tITelemetryLoggerPropertyBag,\n} from \"@fluidframework/telemetry-utils/internal\";\n\nimport type { SummarizeReason } from \"./summarizerUtils.js\";\nimport type {\n\tEnqueueSummarizeResult,\n\tISummarizeResults,\n} from \"./summaryDelayLoadedModule/index.js\";\n\nexport const summarizerClientType = \"summarizer\";\n\n/**\n * Similar to AbortSignal, but using promise instead of events\n * @param T - cancellation reason type\n * @internal\n */\nexport interface ICancellationToken<T> {\n\t/**\n\t * Tells if this cancellable token is cancelled\n\t */\n\treadonly cancelled: boolean;\n\t/**\n\t * Promise that gets fulfilled when this cancellable token is cancelled\n\t * @returns reason of cancellation\n\t */\n\treadonly waitCancelled: Promise<T>;\n}\n\n/**\n * Similar to AbortSignal, but using promise instead of events\n * @internal\n */\nexport type ISummaryCancellationToken = ICancellationToken<SummarizerStopReason>;\n\n/**\n * Data required to update internal tracking state after receiving a Summary Ack.\n * @internal\n */\nexport interface IRefreshSummaryAckOptions {\n\t/**\n\t * Handle from the ack's summary op.\n\t */\n\treadonly proposalHandle: string | undefined;\n\t/**\n\t * Handle from the summary ack just received\n\t */\n\treadonly ackHandle: string;\n\t/**\n\t * Reference sequence number from the ack's summary op\n\t */\n\treadonly summaryRefSeq: number;\n\t/**\n\t * Telemetry logger to which telemetry events will be forwarded.\n\t */\n\treadonly summaryLogger: ITelemetryLoggerExt;\n}\n\n/**\n * @internal\n */\nexport interface ISummarizerInternalsProvider {\n\t/**\n\t * Encapsulates the work to walk the internals of the running container to generate a summary\n\t */\n\tsubmitSummary(options: ISubmitSummaryOptions): Promise<SubmitSummaryResult>;\n\n\t/**\n\t * Callback whenever a new SummaryAck is received, to update internal tracking state\n\t */\n\trefreshLatestSummaryAck(options: IRefreshSummaryAckOptions): Promise<void>;\n}\n\n/**\n * @internal\n */\nexport interface ISummarizingWarning extends ContainerWarning {\n\treadonly errorType: \"summarizingError\";\n\treadonly logged: boolean;\n}\n\n/**\n * @internal\n */\nexport interface IConnectableRuntime {\n\treadonly disposed: boolean;\n\treadonly connected: boolean;\n\treadonly clientId: string | undefined;\n\tonce(event: \"connected\" | \"disconnected\" | \"dispose\", listener: () => void): this;\n}\n\n/**\n * @internal\n */\nexport interface ISummarizerRuntime extends IConnectableRuntime {\n\treadonly baseLogger: ITelemetryBaseLogger;\n\t/**\n\t * clientId of parent (non-summarizing) container that owns summarizer container\n\t */\n\treadonly summarizerClientId: string | undefined;\n\treadonly deltaManager: IDeltaManager<ISequencedDocumentMessage, IDocumentMessage>;\n\tdisposeFn(): void;\n\tcloseFn(): void;\n\ton(\n\t\tevent: \"op\",\n\t\tlistener: (op: ISequencedDocumentMessage, runtimeMessage?: boolean) => void,\n\t): this;\n\toff(\n\t\tevent: \"op\",\n\t\tlistener: (op: ISequencedDocumentMessage, runtimeMessage?: boolean) => void,\n\t): this;\n}\n\n/**\n * Options affecting summarize behavior.\n * @legacy @beta\n */\nexport interface ISummarizeOptions {\n\t/**\n\t * True to generate the full tree with no handle reuse optimizations; defaults to false\n\t */\n\treadonly fullTree?: boolean;\n}\n\n/**\n * @internal\n */\nexport interface ISubmitSummaryOptions extends ISummarizeOptions {\n\t/**\n\t * Logger to use for correlated summary events\n\t */\n\treadonly summaryLogger: ITelemetryLoggerExt;\n\t/**\n\t * Tells when summary process should be cancelled\n\t */\n\treadonly cancellationToken: ISummaryCancellationToken;\n\t/**\n\t * Summarization may be attempted multiple times. This tells whether this is the final summarization attempt.\n\t */\n\treadonly finalAttempt?: boolean;\n\t/**\n\t * The sequence number of the latest summary used to validate if summary state is correct before summarizing\n\t */\n\treadonly latestSummaryRefSeqNum: number;\n\t/**\n\t * Shared telemetry context for the current summarize attempt.\n\t */\n\ttelemetryContext?: TelemetryContext;\n}\n\n/**\n * @legacy @beta\n */\nexport interface IOnDemandSummarizeOptions extends ISummarizeOptions {\n\t/**\n\t * Reason for generating summary.\n\t */\n\treadonly reason: string;\n\t/**\n\t * In case of a failure, will attempt to retry based on if the failure is retriable.\n\t */\n\treadonly retryOnFailure?: boolean;\n}\n\n/**\n * Options to use when enqueueing a summarize attempt.\n * @legacy @beta\n */\nexport interface IEnqueueSummarizeOptions extends IOnDemandSummarizeOptions {\n\t/**\n\t * If specified, The summarize attempt will not occur until after this sequence number.\n\t */\n\treadonly afterSequenceNumber?: number;\n\n\t/**\n\t * True to override the existing enqueued summarize attempt if there is one.\n\t * This will guarantee that this attempt gets enqueued. If override is false,\n\t * than an existing enqueued summarize attempt will block a new one from being\n\t * enqueued. There can only be one enqueued at a time. Defaults to false.\n\t */\n\treadonly override?: boolean;\n}\n\n/**\n * In addition to the normal summary tree + stats, this contains additional stats\n * only relevant at the root of the tree.\n * @legacy @beta\n */\nexport interface IGeneratedSummaryStats extends ISummaryStats {\n\t/**\n\t * The total number of data stores in the container.\n\t */\n\treadonly dataStoreCount: number;\n\t/**\n\t * The number of data stores that were summarized in this summary.\n\t */\n\treadonly summarizedDataStoreCount: number;\n\t/**\n\t * The number of data stores whose GC reference state was updated in this summary.\n\t */\n\treadonly gcStateUpdatedDataStoreCount?: number;\n\t/**\n\t * The size of the gc blobs in this summary.\n\t */\n\treadonly gcTotalBlobsSize?: number;\n\t/**\n\t * The number of gc blobs in this summary.\n\t */\n\treadonly gcBlobNodeCount?: number;\n\t/**\n\t * The summary number for a container's summary. Incremented on summaries throughout its lifetime.\n\t */\n\treadonly summaryNumber: number;\n}\n\n/**\n * Type for summarization failures that are retriable.\n * @legacy @beta\n */\nexport interface IRetriableFailureError extends Error {\n\treadonly retryAfterSeconds?: number;\n}\n\n/**\n * Base results for all submitSummary attempts.\n * @legacy @beta\n */\nexport interface IBaseSummarizeResult {\n\treadonly stage: \"base\";\n\t/**\n\t * Retriable error object related to failed summarize attempt.\n\t */\n\treadonly error: IRetriableFailureError | undefined;\n\t/**\n\t * Reference sequence number as of the generate summary attempt.\n\t */\n\treadonly referenceSequenceNumber: number;\n\treadonly minimumSequenceNumber: number;\n}\n\n/**\n * Results of submitSummary after generating the summary tree.\n * @legacy @beta\n */\nexport interface IGenerateSummaryTreeResult extends Omit<IBaseSummarizeResult, \"stage\"> {\n\treadonly stage: \"generate\";\n\t/**\n\t * Generated summary tree.\n\t */\n\treadonly summaryTree: ISummaryTree;\n\t/**\n\t * Stats for generated summary tree.\n\t */\n\treadonly summaryStats: IGeneratedSummaryStats;\n\t/**\n\t * Time it took to generate the summary tree and stats.\n\t */\n\treadonly generateDuration: number;\n}\n\n/**\n * Results of submitSummary after uploading the tree to storage.\n * @legacy @beta\n */\nexport interface IUploadSummaryResult extends Omit<IGenerateSummaryTreeResult, \"stage\"> {\n\treadonly stage: \"upload\";\n\t/**\n\t * The handle returned by storage pointing to the uploaded summary tree.\n\t */\n\treadonly handle: string;\n\t/**\n\t * Time it took to upload the summary tree to storage.\n\t */\n\treadonly uploadDuration: number;\n}\n\n/**\n * Results of submitSummary after submitting the summarize op.\n * @legacy @beta\n */\nexport interface ISubmitSummaryOpResult extends Omit<IUploadSummaryResult, \"stage\" | \"error\"> {\n\treadonly stage: \"submit\";\n\t/**\n\t * The client sequence number of the summarize op submitted for the summary.\n\t */\n\treadonly clientSequenceNumber: number;\n\t/**\n\t * Time it took to submit the summarize op to the broadcasting service.\n\t */\n\treadonly submitOpDuration: number;\n}\n\n/**\n * Strict type representing result of a submitSummary attempt.\n * The result consists of 4 possible stages, each with its own data.\n * The data is cumulative, so each stage will contain the data from the previous stages.\n * If the final \"submitted\" stage is not reached, the result may contain the error object.\n *\n * Stages:\n *\n * 1. \"base\" - stopped before the summary tree was even generated, and the result only contains the base data\n *\n * 2. \"generate\" - the summary tree was generated, and the result will contain that tree + stats\n *\n * 3. \"upload\" - the summary was uploaded to storage, and the result contains the server-provided handle\n *\n * 4. \"submit\" - the summarize op was submitted, and the result contains the op client sequence number.\n * @legacy @beta\n */\nexport type SubmitSummaryResult =\n\t| IBaseSummarizeResult\n\t| IGenerateSummaryTreeResult\n\t| IUploadSummaryResult\n\t| ISubmitSummaryOpResult;\n\n/**\n * The stages of Summarize, used to describe how far progress succeeded in case of a failure at a later stage.\n * @legacy @beta\n */\nexport type SummaryStage = SubmitSummaryResult[\"stage\"] | \"unknown\";\n\n/**\n * The data in summarizer result when submit summary stage fails.\n * @legacy @beta\n */\nexport interface SubmitSummaryFailureData {\n\tstage: SummaryStage;\n}\n\n/**\n * @legacy @beta\n */\nexport type SummarizeResultPart<TSuccess, TFailure = undefined> =\n\t| {\n\t\t\tsuccess: true;\n\t\t\tdata: TSuccess;\n\t  }\n\t| {\n\t\t\tsuccess: false;\n\t\t\tdata: TFailure | undefined;\n\t\t\tmessage: string;\n\t\t\terror: IRetriableFailureError;\n\t  };\n\n/**\n * @legacy @beta\n */\nexport interface ISummarizer extends IEventProvider<ISummarizerEvents> {\n\t/**\n\t * Allows {@link ISummarizer} to be used with our {@link @fluidframework/core-interfaces#FluidObject} pattern.\n\t */\n\treadonly ISummarizer?: ISummarizer;\n\n\t/*\n\t * Asks summarizer to move to exit.\n\t * Summarizer will finish current processes, which may take a while.\n\t * For example, summarizer may complete last summary before exiting.\n\t */\n\tstop(reason: SummarizerStopReason): void;\n\n\t/* Closes summarizer. Any pending processes (summary in flight) are abandoned. */\n\tclose(): void;\n\n\trun(onBehalfOf: string): Promise<SummarizerStopReason>;\n\n\t/**\n\t * Attempts to generate a summary on demand. If already running, takes no action.\n\t * @param options - options controlling the summarize attempt\n\t * @returns an alreadyRunning promise if a summarize attempt is already in progress,\n\t * which will resolve when the current attempt completes. At that point caller can\n\t * decide to try again or not. Otherwise, it will return an object containing promises\n\t * that resolve as the summarize attempt progresses. They will resolve with success\n\t * false if a failure is encountered.\n\t */\n\tsummarizeOnDemand(options: IOnDemandSummarizeOptions): ISummarizeResults;\n\t/**\n\t * Enqueue an attempt to summarize after the specified sequence number.\n\t * If afterSequenceNumber is provided, the summarize attempt is \"enqueued\"\n\t * to run once an eligible op comes in with sequenceNumber \\>= afterSequenceNumber.\n\t * @param options - options controlling the summarize attempt\n\t * @returns an object containing an alreadyEnqueued flag to indicate if another\n\t * summarize attempt has already been enqueued. It also may contain an overridden flag\n\t * when alreadyEnqueued is true, that indicates whether this attempt forced the\n\t * previous attempt to abort. If this attempt becomes enqueued, it returns an object\n\t * containing promises that resolve as the summarize attempt progresses. They will\n\t * resolve with success false if a failure is encountered.\n\t */\n\tenqueueSummarize(options: IEnqueueSummarizeOptions): EnqueueSummarizeResult;\n}\n\n/**\n * Data about an attempt to summarize used for heuristics.\n */\nexport interface ISummarizeAttempt {\n\t/**\n\t * Reference sequence number when summary was generated or attempted\n\t */\n\treadonly refSequenceNumber: number;\n\n\t/**\n\t * Time of summary attempt after it was sent or attempted\n\t */\n\treadonly summaryTime: number;\n\n\t/**\n\t * Sequence number of summary op\n\t */\n\tsummarySequenceNumber?: number;\n}\n\n/**\n * Data relevant for summary heuristics.\n */\nexport interface ISummarizeHeuristicData {\n\t/**\n\t * Latest received op sequence number\n\t */\n\tlastOpSequenceNumber: number;\n\n\t/**\n\t * Most recent summary attempt from this client\n\t */\n\treadonly lastAttempt: ISummarizeAttempt;\n\n\t/**\n\t * Most recent summary that received an ack\n\t */\n\treadonly lastSuccessfulSummary: Readonly<ISummarizeAttempt>;\n\n\t/**\n\t * Number of runtime ops since last summary\n\t */\n\tnumRuntimeOps: number;\n\n\t/**\n\t * Number of non-runtime ops since last summary\n\t */\n\tnumNonRuntimeOps: number;\n\n\t/**\n\t * Cumulative size in bytes of all the ops since the last summary\n\t */\n\ttotalOpsSize: number;\n\n\t/**\n\t * Wether or not this instance contains adjusted metrics due to missing op data\n\t */\n\thasMissingOpData: boolean;\n\n\t/**\n\t * Updates lastAttempt and lastSuccessfulAttempt based on the last summary.\n\t * @param lastSummary - last ack summary\n\t */\n\tupdateWithLastSummaryAckInfo(lastSummary: ISummarizeAttempt): void;\n\n\t/**\n\t * Records a summary attempt. If the attempt was successfully sent,\n\t * provide the reference sequence number, otherwise it will be set\n\t * to the last seen op sequence number.\n\t * @param referenceSequenceNumber - reference sequence number of sent summary\n\t */\n\trecordAttempt(referenceSequenceNumber?: number): void;\n\n\t/**\n\t * Mark that the last sent summary attempt has received an ack\n\t */\n\tmarkLastAttemptAsSuccessful(): void;\n\n\topsSinceLastSummary: number;\n}\n\n/**\n * Responsible for running heuristics determining when to summarize.\n */\nexport interface ISummarizeHeuristicRunner {\n\t/**\n\t * Start specific heuristic trackers (ex: idle timer)\n\t */\n\tstart(): void;\n\n\t/**\n\t * Runs the heuristics to determine if it should try to summarize\n\t */\n\trun(): void;\n\n\t/**\n\t * Runs a different heuristic to check if it should summarize before closing\n\t */\n\tshouldRunLastSummary(): boolean;\n\n\t/**\n\t * Disposes of resources\n\t */\n\tdispose(): void;\n}\n\ntype ISummarizeTelemetryRequiredProperties =\n\t/**\n\t * Reason code for attempting to summarize\n\t */\n\t\"summarizeReason\";\n\ntype ISummarizeTelemetryOptionalProperties =\n\t/**\n\t * Number of attempts within the last time window, used for calculating the throttle delay.\n\t */\n\t| \"summaryAttempts\"\n\t/**\n\t * Summarization may be attempted multiple times. This tells whether this is the final summarization attempt\n\t */\n\t| \"finalAttempt\"\n\t| keyof ISummarizeOptions;\n\nexport type ISummarizeTelemetryProperties = Pick<\n\tITelemetryBaseProperties,\n\tISummarizeTelemetryRequiredProperties\n> &\n\tPartial<Pick<ITelemetryBaseProperties, ISummarizeTelemetryOptionalProperties>>;\n\n/**\n * Strategy used to heuristically determine when we should run a summary\n */\nexport interface ISummaryHeuristicStrategy {\n\t/**\n\t * Summarize reason for this summarize heuristic strategy (ex: \"maxTime\")\n\t */\n\tsummarizeReason: Readonly<SummarizeReason>;\n\n\t/**\n\t * Determines if this strategy's summarize criteria been met\n\t * @param configuration - summary configuration we are to check against\n\t * @param heuristicData - heuristic data used to confirm conditions are met\n\t */\n\tshouldRunSummary(\n\t\tconfiguration: ISummaryConfigurationHeuristics,\n\t\theuristicData: ISummarizeHeuristicData,\n\t): boolean;\n}\n\ntype SummaryGeneratorRequiredTelemetryProperties =\n\t/**\n\t * True to generate the full tree with no handle reuse optimizations\n\t */\n\t| \"fullTree\"\n\t/**\n\t * Time since we last attempted to generate a summary\n\t */\n\t| \"timeSinceLastAttempt\"\n\t/**\n\t * Time since we last successfully generated a summary\n\t */\n\t| \"timeSinceLastSummary\";\n\ntype SummaryGeneratorOptionalTelemetryProperties =\n\t/**\n\t * Reference sequence number as of the generate summary attempt.\n\t */\n\t| \"referenceSequenceNumber\"\n\t/**\n\t * minimum sequence number (at the reference sequence number)\n\t */\n\t| \"minimumSequenceNumber\"\n\t/**\n\t * Delta between the current reference sequence number and the reference sequence number of the last attempt\n\t */\n\t| \"opsSinceLastAttempt\"\n\t/**\n\t * Delta between the current reference sequence number and the reference sequence number of the last summary\n\t */\n\t| \"opsSinceLastSummary\"\n\t/**\n\t * Delta in sum of op sizes between the current reference sequence number and the reference\n\t * sequence number of the last summary\n\t */\n\t| \"opsSizesSinceLastSummary\"\n\t/**\n\t * Delta between the number of non-runtime ops since the last summary\n\t */\n\t| \"nonRuntimeOpsSinceLastSummary\"\n\t/**\n\t * Delta between the number of runtime ops since the last summary\n\t */\n\t| \"runtimeOpsSinceLastSummary\"\n\t/**\n\t * Wether or not this instance contains adjusted metrics due to missing op data\n\t */\n\t| \"hasMissingOpData\"\n\t/**\n\t * Time it took to generate the summary tree and stats.\n\t */\n\t| \"generateDuration\"\n\t/**\n\t * The handle returned by storage pointing to the uploaded summary tree.\n\t */\n\t| \"handle\"\n\t/**\n\t * Time it took to upload the summary tree to storage.\n\t */\n\t| \"uploadDuration\"\n\t/**\n\t * The client sequence number of the summarize op submitted for the summary.\n\t */\n\t| \"clientSequenceNumber\"\n\t/**\n\t * Time it took for this summary to be acked after it was generated\n\t */\n\t| \"ackWaitDuration\"\n\t/**\n\t * Reference sequence number of the ack/nack message\n\t */\n\t| \"ackNackSequenceNumber\"\n\t/**\n\t * Actual sequence number of the summary op proposal.\n\t */\n\t| \"summarySequenceNumber\"\n\t/**\n\t * Optional Retry-After time in seconds. If specified, the client should wait this many seconds before retrying.\n\t */\n\t| \"nackRetryAfter\"\n\t/**\n\t * The stage at which the submit summary method failed at. This can help determine what type of failure we have\n\t */\n\t| \"stage\";\n\nexport type SummaryGeneratorTelemetry = Pick<\n\tITelemetryBaseProperties,\n\tSummaryGeneratorRequiredTelemetryProperties\n> &\n\tPartial<Pick<ITelemetryBaseProperties, SummaryGeneratorOptionalTelemetryProperties>>;\n\nexport interface ISummarizeRunnerTelemetry extends ITelemetryLoggerPropertyBag {\n\t/**\n\t * Number of times the summarizer run.\n\t */\n\tsummarizeCount: () => number;\n\t/**\n\t * Number of successful attempts to summarize.\n\t */\n\tsummarizerSuccessfulAttempts: () => number;\n}\n\n/**\n * @legacy @beta\n */\nexport interface ISummaryBaseConfiguration {\n\t/**\n\t * Delay before first attempt to spawn summarizing container.\n\t */\n\tinitialSummarizerDelayMs: number;\n\n\t/**\n\t * Defines the maximum allowed time to wait for a pending summary ack.\n\t * The maximum amount of time client will wait for a summarize is the minimum of\n\t * maxSummarizeAckWaitTime (currently 3 * 60 * 1000) and maxAckWaitTime.\n\t */\n\tmaxAckWaitTime: number;\n\t/**\n\t * Defines the maximum number of Ops in between Summaries that can be\n\t * allowed before forcibly electing a new summarizer client.\n\t */\n\tmaxOpsSinceLastSummary: number;\n}\n\n/**\n * @legacy @beta\n */\nexport interface ISummaryConfigurationHeuristics extends ISummaryBaseConfiguration {\n\tstate: \"enabled\";\n\t/**\n\t * Defines the maximum allowed time, since the last received Ack, before running the summary\n\t * with reason maxTime.\n\t * For example, say we receive ops one by one just before the idle time is triggered.\n\t * In this case, we still want to run a summary since it's been a while since the last summary.\n\t */\n\tmaxTime: number;\n\t/**\n\t * Defines the maximum number of Ops, since the last received Ack, that can be allowed\n\t * before running the summary with reason maxOps.\n\t */\n\tmaxOps: number;\n\t/**\n\t * Defines the minimum number of Ops, since the last received Ack, that can be allowed\n\t * before running the last summary.\n\t */\n\tminOpsForLastSummaryAttempt: number;\n\t/**\n\t * Defines the lower boundary for the allowed time in between summarizations.\n\t * Pairs with maxIdleTime to form a range.\n\t * For example, if we only receive 1 op, we don't want to have the same idle time as say 100 ops.\n\t * Based on the boundaries we set in minIdleTime and maxIdleTime, the idle time will change\n\t * linearly depending on the number of ops we receive.\n\t */\n\tminIdleTime: number;\n\t/**\n\t * Defines the upper boundary for the allowed time in between summarizations.\n\t * Pairs with minIdleTime to form a range.\n\t * For example, if we only receive 1 op, we don't want to have the same idle time as say 100 ops.\n\t * Based on the boundaries we set in minIdleTime and maxIdleTime, the idle time will change\n\t * linearly depending on the number of ops we receive.\n\t */\n\tmaxIdleTime: number;\n\t/**\n\t * Runtime op weight to use in heuristic summarizing.\n\t * This number is a multiplier on the number of runtime ops we process when running summarize heuristics.\n\t * For example: (multiplier) * (number of runtime ops) = weighted number of runtime ops\n\t */\n\truntimeOpWeight: number;\n\t/**\n\t * Non-runtime op weight to use in heuristic summarizing\n\t * This number is a multiplier on the number of non-runtime ops we process when running summarize heuristics.\n\t * For example: (multiplier) * (number of non-runtime ops) = weighted number of non-runtime ops\n\t */\n\tnonRuntimeOpWeight: number;\n\n\t/**\n\t * Number of ops since last summary needed before a non-runtime op can trigger running summary heuristics.\n\t *\n\t * Note: Any runtime ops sent before the threshold is reached will trigger heuristics normally.\n\t * This threshold ONLY applies to non-runtime ops triggering summaries.\n\t *\n\t * For example: Say the threshold is 20. Sending 19 non-runtime ops will not trigger any heuristic checks.\n\t * Sending the 20th non-runtime op will trigger the heuristic checks for summarizing.\n\t */\n\tnonRuntimeHeuristicThreshold?: number;\n}\n\n/**\n * @legacy @beta\n */\nexport interface ISummaryConfigurationDisableSummarizer {\n\tstate: \"disabled\";\n}\n\n/**\n * @legacy @beta\n */\nexport interface ISummaryConfigurationDisableHeuristics extends ISummaryBaseConfiguration {\n\tstate: \"disableHeuristics\";\n}\n\n/**\n * Configuration used internally to indicate on-demand summaries only (no election/heuristics).\n * @legacy @beta\n */\nexport interface ISummaryConfigurationWithSummaryOnRequest extends ISummaryBaseConfiguration {\n\tstate: \"summaryOnRequest\";\n}\n\n/**\n * @legacy @beta\n */\nexport type ISummaryConfiguration =\n\t| ISummaryConfigurationDisableSummarizer\n\t| ISummaryConfigurationDisableHeuristics\n\t| ISummaryConfigurationHeuristics\n\t| ISummaryConfigurationWithSummaryOnRequest;\n"]}
+{"version":3,"file":"summarizerTypes.js","sourceRoot":"","sources":["../../src/summary/summarizerTypes.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAiCU,QAAA,oBAAoB,GAAG,YAAY,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport type {\n\tIDeltaManager,\n\tContainerWarning,\n} from \"@fluidframework/container-definitions/internal\";\nimport type {\n\tISummarizerEvents,\n\tSummarizerStopReason,\n} from \"@fluidframework/container-runtime-definitions/internal\";\nimport type {\n\tIEventProvider,\n\tITelemetryBaseProperties,\n\tITelemetryBaseLogger,\n} from \"@fluidframework/core-interfaces\";\nimport type { ISummaryTree } from \"@fluidframework/driver-definitions\";\nimport type {\n\tIDocumentMessage,\n\tISequencedDocumentMessage,\n} from \"@fluidframework/driver-definitions/internal\";\nimport type { ISummaryStats } from \"@fluidframework/runtime-definitions/internal\";\nimport type { TelemetryContext } from \"@fluidframework/runtime-utils/internal\";\nimport type {\n\tITelemetryLoggerExt,\n\tITelemetryLoggerPropertyBag,\n} from \"@fluidframework/telemetry-utils/internal\";\n\nimport type { SummarizeReason } from \"./summarizerUtils.js\";\nimport type {\n\tEnqueueSummarizeResult,\n\tISummarizeResults,\n} from \"./summaryDelayLoadedModule/index.js\";\n\nexport const summarizerClientType = \"summarizer\";\n\n/**\n * Similar to AbortSignal, but using promise instead of events\n * @param T - cancellation reason type\n * @internal\n */\nexport interface ICancellationToken<T> {\n\t/**\n\t * Tells if this cancellable token is cancelled\n\t */\n\treadonly cancelled: boolean;\n\t/**\n\t * Promise that gets fulfilled when this cancellable token is cancelled\n\t * @returns reason of cancellation\n\t */\n\treadonly waitCancelled: Promise<T>;\n}\n\n/**\n * Similar to AbortSignal, but using promise instead of events\n * @internal\n */\nexport type ISummaryCancellationToken = ICancellationToken<SummarizerStopReason>;\n\n/**\n * Data required to update internal tracking state after receiving a Summary Ack.\n * @internal\n */\nexport interface IRefreshSummaryAckOptions {\n\t/**\n\t * Handle from the ack's summary op.\n\t */\n\treadonly proposalHandle: string | undefined;\n\t/**\n\t * Handle from the summary ack just received\n\t */\n\treadonly ackHandle: string;\n\t/**\n\t * Reference sequence number from the ack's summary op\n\t */\n\treadonly summaryRefSeq: number;\n\t/**\n\t * Telemetry logger to which telemetry events will be forwarded.\n\t */\n\treadonly summaryLogger: ITelemetryLoggerExt;\n}\n\n/**\n * @internal\n */\nexport interface ISummarizerInternalsProvider {\n\t/**\n\t * Encapsulates the work to walk the internals of the running container to generate a summary\n\t */\n\tsubmitSummary(options: ISubmitSummaryOptions): Promise<SubmitSummaryResult>;\n\n\t/**\n\t * Callback whenever a new SummaryAck is received, to update internal tracking state\n\t */\n\trefreshLatestSummaryAck(options: IRefreshSummaryAckOptions): Promise<void>;\n}\n\n/**\n * @internal\n */\nexport interface ISummarizingWarning extends ContainerWarning {\n\treadonly errorType: \"summarizingError\";\n\treadonly logged: boolean;\n}\n\n/**\n * @internal\n */\nexport interface IConnectableRuntime {\n\treadonly disposed: boolean;\n\treadonly connected: boolean;\n\treadonly clientId: string | undefined;\n\tonce(event: \"connected\" | \"disconnected\" | \"dispose\", listener: () => void): this;\n}\n\n/**\n * @internal\n */\nexport interface ISummarizerRuntime extends IConnectableRuntime {\n\treadonly baseLogger: ITelemetryBaseLogger;\n\t/**\n\t * clientId of parent (non-summarizing) container that owns summarizer container\n\t */\n\treadonly summarizerClientId: string | undefined;\n\treadonly deltaManager: IDeltaManager<ISequencedDocumentMessage, IDocumentMessage>;\n\t/**\n\t * Initiate disposal of the container.\n\t */\n\tdisposeFn(): void;\n\ton(\n\t\tevent: \"op\",\n\t\tlistener: (op: ISequencedDocumentMessage, runtimeMessage?: boolean) => void,\n\t): this;\n\toff(\n\t\tevent: \"op\",\n\t\tlistener: (op: ISequencedDocumentMessage, runtimeMessage?: boolean) => void,\n\t): this;\n}\n\n/**\n * Options affecting summarize behavior.\n * @legacy @beta\n */\nexport interface ISummarizeOptions {\n\t/**\n\t * True to generate the full tree with no handle reuse optimizations; defaults to false\n\t */\n\treadonly fullTree?: boolean;\n}\n\n/**\n * @internal\n */\nexport interface ISubmitSummaryOptions extends ISummarizeOptions {\n\t/**\n\t * Logger to use for correlated summary events\n\t */\n\treadonly summaryLogger: ITelemetryLoggerExt;\n\t/**\n\t * Tells when summary process should be cancelled\n\t */\n\treadonly cancellationToken: ISummaryCancellationToken;\n\t/**\n\t * Summarization may be attempted multiple times. This tells whether this is the final summarization attempt.\n\t */\n\treadonly finalAttempt?: boolean;\n\t/**\n\t * The sequence number of the latest summary used to validate if summary state is correct before summarizing\n\t */\n\treadonly latestSummaryRefSeqNum: number;\n\t/**\n\t * Shared telemetry context for the current summarize attempt.\n\t */\n\ttelemetryContext?: TelemetryContext;\n}\n\n/**\n * @legacy @beta\n */\nexport interface IOnDemandSummarizeOptions extends ISummarizeOptions {\n\t/**\n\t * Reason for generating summary.\n\t */\n\treadonly reason: string;\n\t/**\n\t * In case of a failure, will attempt to retry based on if the failure is retriable.\n\t */\n\treadonly retryOnFailure?: boolean;\n}\n\n/**\n * Options to use when enqueueing a summarize attempt.\n * @legacy @beta\n */\nexport interface IEnqueueSummarizeOptions extends IOnDemandSummarizeOptions {\n\t/**\n\t * If specified, The summarize attempt will not occur until after this sequence number.\n\t */\n\treadonly afterSequenceNumber?: number;\n\n\t/**\n\t * True to override the existing enqueued summarize attempt if there is one.\n\t * This will guarantee that this attempt gets enqueued. If override is false,\n\t * than an existing enqueued summarize attempt will block a new one from being\n\t * enqueued. There can only be one enqueued at a time. Defaults to false.\n\t */\n\treadonly override?: boolean;\n}\n\n/**\n * In addition to the normal summary tree + stats, this contains additional stats\n * only relevant at the root of the tree.\n * @legacy @beta\n */\nexport interface IGeneratedSummaryStats extends ISummaryStats {\n\t/**\n\t * The total number of data stores in the container.\n\t */\n\treadonly dataStoreCount: number;\n\t/**\n\t * The number of data stores that were summarized in this summary.\n\t */\n\treadonly summarizedDataStoreCount: number;\n\t/**\n\t * The number of data stores whose GC reference state was updated in this summary.\n\t */\n\treadonly gcStateUpdatedDataStoreCount?: number;\n\t/**\n\t * The size of the gc blobs in this summary.\n\t */\n\treadonly gcTotalBlobsSize?: number;\n\t/**\n\t * The number of gc blobs in this summary.\n\t */\n\treadonly gcBlobNodeCount?: number;\n\t/**\n\t * The summary number for a container's summary. Incremented on summaries throughout its lifetime.\n\t */\n\treadonly summaryNumber: number;\n}\n\n/**\n * Type for summarization failures that are retriable.\n * @legacy @beta\n */\nexport interface IRetriableFailureError extends Error {\n\treadonly retryAfterSeconds?: number;\n}\n\n/**\n * Base results for all submitSummary attempts.\n * @legacy @beta\n */\nexport interface IBaseSummarizeResult {\n\treadonly stage: \"base\";\n\t/**\n\t * Retriable error object related to failed summarize attempt.\n\t */\n\treadonly error: IRetriableFailureError | undefined;\n\t/**\n\t * Reference sequence number as of the generate summary attempt.\n\t */\n\treadonly referenceSequenceNumber: number;\n\treadonly minimumSequenceNumber: number;\n}\n\n/**\n * Results of submitSummary after generating the summary tree.\n * @legacy @beta\n */\nexport interface IGenerateSummaryTreeResult extends Omit<IBaseSummarizeResult, \"stage\"> {\n\treadonly stage: \"generate\";\n\t/**\n\t * Generated summary tree.\n\t */\n\treadonly summaryTree: ISummaryTree;\n\t/**\n\t * Stats for generated summary tree.\n\t */\n\treadonly summaryStats: IGeneratedSummaryStats;\n\t/**\n\t * Time it took to generate the summary tree and stats.\n\t */\n\treadonly generateDuration: number;\n}\n\n/**\n * Results of submitSummary after uploading the tree to storage.\n * @legacy @beta\n */\nexport interface IUploadSummaryResult extends Omit<IGenerateSummaryTreeResult, \"stage\"> {\n\treadonly stage: \"upload\";\n\t/**\n\t * The handle returned by storage pointing to the uploaded summary tree.\n\t */\n\treadonly handle: string;\n\t/**\n\t * Time it took to upload the summary tree to storage.\n\t */\n\treadonly uploadDuration: number;\n}\n\n/**\n * Results of submitSummary after submitting the summarize op.\n * @legacy @beta\n */\nexport interface ISubmitSummaryOpResult extends Omit<IUploadSummaryResult, \"stage\" | \"error\"> {\n\treadonly stage: \"submit\";\n\t/**\n\t * The client sequence number of the summarize op submitted for the summary.\n\t */\n\treadonly clientSequenceNumber: number;\n\t/**\n\t * Time it took to submit the summarize op to the broadcasting service.\n\t */\n\treadonly submitOpDuration: number;\n}\n\n/**\n * Strict type representing result of a submitSummary attempt.\n * The result consists of 4 possible stages, each with its own data.\n * The data is cumulative, so each stage will contain the data from the previous stages.\n * If the final \"submitted\" stage is not reached, the result may contain the error object.\n *\n * Stages:\n *\n * 1. \"base\" - stopped before the summary tree was even generated, and the result only contains the base data\n *\n * 2. \"generate\" - the summary tree was generated, and the result will contain that tree + stats\n *\n * 3. \"upload\" - the summary was uploaded to storage, and the result contains the server-provided handle\n *\n * 4. \"submit\" - the summarize op was submitted, and the result contains the op client sequence number.\n * @legacy @beta\n */\nexport type SubmitSummaryResult =\n\t| IBaseSummarizeResult\n\t| IGenerateSummaryTreeResult\n\t| IUploadSummaryResult\n\t| ISubmitSummaryOpResult;\n\n/**\n * The stages of Summarize, used to describe how far progress succeeded in case of a failure at a later stage.\n * @legacy @beta\n */\nexport type SummaryStage = SubmitSummaryResult[\"stage\"] | \"unknown\";\n\n/**\n * The data in summarizer result when submit summary stage fails.\n * @legacy @beta\n */\nexport interface SubmitSummaryFailureData {\n\tstage: SummaryStage;\n}\n\n/**\n * @legacy @beta\n */\nexport type SummarizeResultPart<TSuccess, TFailure = undefined> =\n\t| {\n\t\t\tsuccess: true;\n\t\t\tdata: TSuccess;\n\t  }\n\t| {\n\t\t\tsuccess: false;\n\t\t\tdata: TFailure | undefined;\n\t\t\tmessage: string;\n\t\t\terror: IRetriableFailureError;\n\t  };\n\n/**\n * @legacy @beta\n */\nexport interface ISummarizer extends IEventProvider<ISummarizerEvents> {\n\t/**\n\t * Allows {@link ISummarizer} to be used with our {@link @fluidframework/core-interfaces#FluidObject} pattern.\n\t */\n\treadonly ISummarizer?: ISummarizer;\n\n\t/*\n\t * Asks summarizer to move to exit.\n\t * Summarizer will finish current processes, which may take a while.\n\t * For example, summarizer may complete last summary before exiting.\n\t */\n\tstop(reason: SummarizerStopReason): void;\n\n\t/* Closes summarizer. Any pending processes (summary in flight) are abandoned. */\n\tclose(): void;\n\n\trun(onBehalfOf: string): Promise<SummarizerStopReason>;\n\n\t/**\n\t * Attempts to generate a summary on demand. If already running, takes no action.\n\t * @param options - options controlling the summarize attempt\n\t * @returns an alreadyRunning promise if a summarize attempt is already in progress,\n\t * which will resolve when the current attempt completes. At that point caller can\n\t * decide to try again or not. Otherwise, it will return an object containing promises\n\t * that resolve as the summarize attempt progresses. They will resolve with success\n\t * false if a failure is encountered.\n\t */\n\tsummarizeOnDemand(options: IOnDemandSummarizeOptions): ISummarizeResults;\n\t/**\n\t * Enqueue an attempt to summarize after the specified sequence number.\n\t * If afterSequenceNumber is provided, the summarize attempt is \"enqueued\"\n\t * to run once an eligible op comes in with sequenceNumber \\>= afterSequenceNumber.\n\t * @param options - options controlling the summarize attempt\n\t * @returns an object containing an alreadyEnqueued flag to indicate if another\n\t * summarize attempt has already been enqueued. It also may contain an overridden flag\n\t * when alreadyEnqueued is true, that indicates whether this attempt forced the\n\t * previous attempt to abort. If this attempt becomes enqueued, it returns an object\n\t * containing promises that resolve as the summarize attempt progresses. They will\n\t * resolve with success false if a failure is encountered.\n\t */\n\tenqueueSummarize(options: IEnqueueSummarizeOptions): EnqueueSummarizeResult;\n}\n\n/**\n * Data about an attempt to summarize used for heuristics.\n */\nexport interface ISummarizeAttempt {\n\t/**\n\t * Reference sequence number when summary was generated or attempted\n\t */\n\treadonly refSequenceNumber: number;\n\n\t/**\n\t * Time of summary attempt after it was sent or attempted\n\t */\n\treadonly summaryTime: number;\n\n\t/**\n\t * Sequence number of summary op\n\t */\n\tsummarySequenceNumber?: number;\n}\n\n/**\n * Data relevant for summary heuristics.\n */\nexport interface ISummarizeHeuristicData {\n\t/**\n\t * Latest received op sequence number\n\t */\n\tlastOpSequenceNumber: number;\n\n\t/**\n\t * Most recent summary attempt from this client\n\t */\n\treadonly lastAttempt: ISummarizeAttempt;\n\n\t/**\n\t * Most recent summary that received an ack\n\t */\n\treadonly lastSuccessfulSummary: Readonly<ISummarizeAttempt>;\n\n\t/**\n\t * Number of runtime ops since last summary\n\t */\n\tnumRuntimeOps: number;\n\n\t/**\n\t * Number of non-runtime ops since last summary\n\t */\n\tnumNonRuntimeOps: number;\n\n\t/**\n\t * Cumulative size in bytes of all the ops since the last summary\n\t */\n\ttotalOpsSize: number;\n\n\t/**\n\t * Wether or not this instance contains adjusted metrics due to missing op data\n\t */\n\thasMissingOpData: boolean;\n\n\t/**\n\t * Updates lastAttempt and lastSuccessfulAttempt based on the last summary.\n\t * @param lastSummary - last ack summary\n\t */\n\tupdateWithLastSummaryAckInfo(lastSummary: ISummarizeAttempt): void;\n\n\t/**\n\t * Records a summary attempt. If the attempt was successfully sent,\n\t * provide the reference sequence number, otherwise it will be set\n\t * to the last seen op sequence number.\n\t * @param referenceSequenceNumber - reference sequence number of sent summary\n\t */\n\trecordAttempt(referenceSequenceNumber?: number): void;\n\n\t/**\n\t * Mark that the last sent summary attempt has received an ack\n\t */\n\tmarkLastAttemptAsSuccessful(): void;\n\n\topsSinceLastSummary: number;\n}\n\n/**\n * Responsible for running heuristics determining when to summarize.\n */\nexport interface ISummarizeHeuristicRunner {\n\t/**\n\t * Start specific heuristic trackers (ex: idle timer)\n\t */\n\tstart(): void;\n\n\t/**\n\t * Runs the heuristics to determine if it should try to summarize\n\t */\n\trun(): void;\n\n\t/**\n\t * Runs a different heuristic to check if it should summarize before closing\n\t */\n\tshouldRunLastSummary(): boolean;\n\n\t/**\n\t * Disposes of resources\n\t */\n\tdispose(): void;\n}\n\ntype ISummarizeTelemetryRequiredProperties =\n\t/**\n\t * Reason code for attempting to summarize\n\t */\n\t\"summarizeReason\";\n\ntype ISummarizeTelemetryOptionalProperties =\n\t/**\n\t * Number of attempts within the last time window, used for calculating the throttle delay.\n\t */\n\t| \"summaryAttempts\"\n\t/**\n\t * Summarization may be attempted multiple times. This tells whether this is the final summarization attempt\n\t */\n\t| \"finalAttempt\"\n\t| keyof ISummarizeOptions;\n\nexport type ISummarizeTelemetryProperties = Pick<\n\tITelemetryBaseProperties,\n\tISummarizeTelemetryRequiredProperties\n> &\n\tPartial<Pick<ITelemetryBaseProperties, ISummarizeTelemetryOptionalProperties>>;\n\n/**\n * Strategy used to heuristically determine when we should run a summary\n */\nexport interface ISummaryHeuristicStrategy {\n\t/**\n\t * Summarize reason for this summarize heuristic strategy (ex: \"maxTime\")\n\t */\n\tsummarizeReason: Readonly<SummarizeReason>;\n\n\t/**\n\t * Determines if this strategy's summarize criteria been met\n\t * @param configuration - summary configuration we are to check against\n\t * @param heuristicData - heuristic data used to confirm conditions are met\n\t */\n\tshouldRunSummary(\n\t\tconfiguration: ISummaryConfigurationHeuristics,\n\t\theuristicData: ISummarizeHeuristicData,\n\t): boolean;\n}\n\ntype SummaryGeneratorRequiredTelemetryProperties =\n\t/**\n\t * True to generate the full tree with no handle reuse optimizations\n\t */\n\t| \"fullTree\"\n\t/**\n\t * Time since we last attempted to generate a summary\n\t */\n\t| \"timeSinceLastAttempt\"\n\t/**\n\t * Time since we last successfully generated a summary\n\t */\n\t| \"timeSinceLastSummary\";\n\ntype SummaryGeneratorOptionalTelemetryProperties =\n\t/**\n\t * Reference sequence number as of the generate summary attempt.\n\t */\n\t| \"referenceSequenceNumber\"\n\t/**\n\t * minimum sequence number (at the reference sequence number)\n\t */\n\t| \"minimumSequenceNumber\"\n\t/**\n\t * Delta between the current reference sequence number and the reference sequence number of the last attempt\n\t */\n\t| \"opsSinceLastAttempt\"\n\t/**\n\t * Delta between the current reference sequence number and the reference sequence number of the last summary\n\t */\n\t| \"opsSinceLastSummary\"\n\t/**\n\t * Delta in sum of op sizes between the current reference sequence number and the reference\n\t * sequence number of the last summary\n\t */\n\t| \"opsSizesSinceLastSummary\"\n\t/**\n\t * Delta between the number of non-runtime ops since the last summary\n\t */\n\t| \"nonRuntimeOpsSinceLastSummary\"\n\t/**\n\t * Delta between the number of runtime ops since the last summary\n\t */\n\t| \"runtimeOpsSinceLastSummary\"\n\t/**\n\t * Wether or not this instance contains adjusted metrics due to missing op data\n\t */\n\t| \"hasMissingOpData\"\n\t/**\n\t * Time it took to generate the summary tree and stats.\n\t */\n\t| \"generateDuration\"\n\t/**\n\t * The handle returned by storage pointing to the uploaded summary tree.\n\t */\n\t| \"handle\"\n\t/**\n\t * Time it took to upload the summary tree to storage.\n\t */\n\t| \"uploadDuration\"\n\t/**\n\t * The client sequence number of the summarize op submitted for the summary.\n\t */\n\t| \"clientSequenceNumber\"\n\t/**\n\t * Time it took for this summary to be acked after it was generated\n\t */\n\t| \"ackWaitDuration\"\n\t/**\n\t * Reference sequence number of the ack/nack message\n\t */\n\t| \"ackNackSequenceNumber\"\n\t/**\n\t * Actual sequence number of the summary op proposal.\n\t */\n\t| \"summarySequenceNumber\"\n\t/**\n\t * Optional Retry-After time in seconds. If specified, the client should wait this many seconds before retrying.\n\t */\n\t| \"nackRetryAfter\"\n\t/**\n\t * The stage at which the submit summary method failed at. This can help determine what type of failure we have\n\t */\n\t| \"stage\";\n\nexport type SummaryGeneratorTelemetry = Pick<\n\tITelemetryBaseProperties,\n\tSummaryGeneratorRequiredTelemetryProperties\n> &\n\tPartial<Pick<ITelemetryBaseProperties, SummaryGeneratorOptionalTelemetryProperties>>;\n\nexport interface ISummarizeRunnerTelemetry extends ITelemetryLoggerPropertyBag {\n\t/**\n\t * Number of times the summarizer run.\n\t */\n\tsummarizeCount: () => number;\n\t/**\n\t * Number of successful attempts to summarize.\n\t */\n\tsummarizerSuccessfulAttempts: () => number;\n}\n\n/**\n * @legacy @beta\n */\nexport interface ISummaryBaseConfiguration {\n\t/**\n\t * Delay before first attempt to spawn summarizing container.\n\t */\n\tinitialSummarizerDelayMs: number;\n\n\t/**\n\t * Defines the maximum allowed time to wait for a pending summary ack.\n\t * The maximum amount of time client will wait for a summarize is the minimum of\n\t * maxSummarizeAckWaitTime (currently 3 * 60 * 1000) and maxAckWaitTime.\n\t */\n\tmaxAckWaitTime: number;\n\t/**\n\t * Defines the maximum number of Ops in between Summaries that can be\n\t * allowed before forcibly electing a new summarizer client.\n\t */\n\tmaxOpsSinceLastSummary: number;\n}\n\n/**\n * @legacy @beta\n */\nexport interface ISummaryConfigurationHeuristics extends ISummaryBaseConfiguration {\n\tstate: \"enabled\";\n\t/**\n\t * Defines the maximum allowed time, since the last received Ack, before running the summary\n\t * with reason maxTime.\n\t * For example, say we receive ops one by one just before the idle time is triggered.\n\t * In this case, we still want to run a summary since it's been a while since the last summary.\n\t */\n\tmaxTime: number;\n\t/**\n\t * Defines the maximum number of Ops, since the last received Ack, that can be allowed\n\t * before running the summary with reason maxOps.\n\t */\n\tmaxOps: number;\n\t/**\n\t * Defines the minimum number of Ops, since the last received Ack, that can be allowed\n\t * before running the last summary.\n\t */\n\tminOpsForLastSummaryAttempt: number;\n\t/**\n\t * Defines the lower boundary for the allowed time in between summarizations.\n\t * Pairs with maxIdleTime to form a range.\n\t * For example, if we only receive 1 op, we don't want to have the same idle time as say 100 ops.\n\t * Based on the boundaries we set in minIdleTime and maxIdleTime, the idle time will change\n\t * linearly depending on the number of ops we receive.\n\t */\n\tminIdleTime: number;\n\t/**\n\t * Defines the upper boundary for the allowed time in between summarizations.\n\t * Pairs with minIdleTime to form a range.\n\t * For example, if we only receive 1 op, we don't want to have the same idle time as say 100 ops.\n\t * Based on the boundaries we set in minIdleTime and maxIdleTime, the idle time will change\n\t * linearly depending on the number of ops we receive.\n\t */\n\tmaxIdleTime: number;\n\t/**\n\t * Runtime op weight to use in heuristic summarizing.\n\t * This number is a multiplier on the number of runtime ops we process when running summarize heuristics.\n\t * For example: (multiplier) * (number of runtime ops) = weighted number of runtime ops\n\t */\n\truntimeOpWeight: number;\n\t/**\n\t * Non-runtime op weight to use in heuristic summarizing\n\t * This number is a multiplier on the number of non-runtime ops we process when running summarize heuristics.\n\t * For example: (multiplier) * (number of non-runtime ops) = weighted number of non-runtime ops\n\t */\n\tnonRuntimeOpWeight: number;\n\n\t/**\n\t * Number of ops since last summary needed before a non-runtime op can trigger running summary heuristics.\n\t *\n\t * Note: Any runtime ops sent before the threshold is reached will trigger heuristics normally.\n\t * This threshold ONLY applies to non-runtime ops triggering summaries.\n\t *\n\t * For example: Say the threshold is 20. Sending 19 non-runtime ops will not trigger any heuristic checks.\n\t * Sending the 20th non-runtime op will trigger the heuristic checks for summarizing.\n\t */\n\tnonRuntimeHeuristicThreshold?: number;\n}\n\n/**\n * @legacy @beta\n */\nexport interface ISummaryConfigurationDisableSummarizer {\n\tstate: \"disabled\";\n}\n\n/**\n * @legacy @beta\n */\nexport interface ISummaryConfigurationDisableHeuristics extends ISummaryBaseConfiguration {\n\tstate: \"disableHeuristics\";\n}\n\n/**\n * Configuration used internally to indicate on-demand summaries only (no election/heuristics).\n * @legacy @beta\n */\nexport interface ISummaryConfigurationWithSummaryOnRequest extends ISummaryBaseConfiguration {\n\tstate: \"summaryOnRequest\";\n}\n\n/**\n * @legacy @beta\n */\nexport type ISummaryConfiguration =\n\t| ISummaryConfigurationDisableSummarizer\n\t| ISummaryConfigurationDisableHeuristics\n\t| ISummaryConfigurationHeuristics\n\t| ISummaryConfigurationWithSummaryOnRequest;\n"]}

package/lib/blobManager/blobManager.d.ts

@@ -74,6 +74,9 @@ export type SerializableLocalBlobRecord = (Omit<LocalOnlyBlob, "blob"> & {
 export interface IPendingBlobs {
     [localId: string]: SerializableLocalBlobRecord;
 }
+/**
+ * @internal
+ */
 export declare const blobManagerBasePath = "_blobs";
 export declare class BlobManager {
     private readonly mc;

package/lib/blobManager/blobManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"blobManager.d.ts","sourceRoot":"","sources":["../../src/blobManager/blobManager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"blobManager.d.ts","sourceRoot":"","sources":["../../src/blobManager/blobManager.ts"],"names":[],"mappings":"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"}

package/lib/blobManager/blobManager.js

@@ -65,6 +65,9 @@ export class BlobHandle extends FluidHandleBase {
 const isTTLTooCloseToExpiry = (blobRecord) => blobRecord.minTTLInSeconds !== undefined &&
     Date.now() - blobRecord.uploadTime > (blobRecord.minTTLInSeconds / 2) * 1000;
 const createAbortError = () => new LoggingError("uploadBlob aborted");
+/**
+ * @internal
+ */
 export const blobManagerBasePath = "_blobs";
 export class BlobManager {
     constructor(props) {

package/lib/blobManager/blobManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"blobManager.js","sourceRoot":"","sources":["../../src/blobManager/blobManager.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 { bufferToString, createEmitter, stringToBuffer } from \"@fluid-internal/client-utils\";\nimport {\n\tAttachState,\n\ttype IContainerStorageService,\n} from \"@fluidframework/container-definitions/internal\";\nimport type {\n\tIContainerRuntime,\n\tIContainerRuntimeEvents,\n} from \"@fluidframework/container-runtime-definitions/internal\";\nimport type {\n\tIEmitter,\n\tIEventProvider,\n\tIFluidHandleContext,\n\tIFluidHandleInternalPayloadPending,\n\tILocalFluidHandle,\n\tILocalFluidHandleEvents,\n\tListenable,\n\tPayloadState,\n} from \"@fluidframework/core-interfaces/internal\";\nimport { assert } from \"@fluidframework/core-utils/internal\";\nimport type { ICreateBlobResponse } from \"@fluidframework/driver-definitions/internal\";\nimport type {\n\tIGarbageCollectionData,\n\tISummaryTreeWithStats,\n\tITelemetryContext,\n\tISequencedMessageEnvelope,\n} from \"@fluidframework/runtime-definitions/internal\";\nimport {\n\tFluidHandleBase,\n\tcreateResponseError,\n\tgenerateHandleContextPath,\n\tresponseToException,\n} from \"@fluidframework/runtime-utils/internal\";\nimport {\n\tLoggingError,\n\ttype MonitoringContext,\n\tPerformanceEvent,\n\tcreateChildMonitoringContext,\n} from \"@fluidframework/telemetry-utils/internal\";\nimport { v4 as uuid } from \"uuid\";\n\nimport { isBlobMetadata } from \"../metadata.js\";\n\nimport {\n\tsummarizeBlobManagerState,\n\ttoRedirectTable,\n\ttype IBlobManagerLoadInfo,\n} from \"./blobManagerSnapSum.js\";\n\n/**\n * This class represents blob (long string)\n * This object is used only when creating (writing) new blob and serialization purposes.\n * De-serialization process goes through FluidObjectHandle and request flow:\n * DataObject.request() recognizes requests in the form of `/blobs/<id>`\n * and loads blob.\n */\nexport class BlobHandle\n\textends FluidHandleBase<ArrayBufferLike>\n\timplements\n\t\tILocalFluidHandle<ArrayBufferLike>,\n\t\tIFluidHandleInternalPayloadPending<ArrayBufferLike>\n{\n\tprivate attached: boolean = false;\n\n\tpublic get isAttached(): boolean {\n\t\treturn this.routeContext.isAttached && this.attached;\n\t}\n\n\tprivate _events:\n\t\t| (Listenable<ILocalFluidHandleEvents> & IEmitter<ILocalFluidHandleEvents>)\n\t\t| undefined;\n\tpublic get events(): Listenable<ILocalFluidHandleEvents> {\n\t\treturn (this._events ??= createEmitter<ILocalFluidHandleEvents>());\n\t}\n\n\tprivate _payloadState: PayloadState;\n\tpublic get payloadState(): PayloadState {\n\t\treturn this._payloadState;\n\t}\n\n\t/**\n\t * The error property starts undefined, signalling that there has been no error yet.\n\t * If an error occurs, the property will contain the error.\n\t */\n\tprivate _payloadShareError: unknown;\n\tpublic get payloadShareError(): unknown {\n\t\treturn this._payloadShareError;\n\t}\n\n\tpublic readonly absolutePath: string;\n\n\tpublic constructor(\n\t\tpublic readonly path: string,\n\t\tpublic readonly routeContext: IFluidHandleContext,\n\t\t// TODO: just take the blob rather than a get function?\n\t\tpublic get: () => Promise<ArrayBufferLike>,\n\t\tpublic readonly payloadPending: boolean,\n\t\tprivate readonly onAttachGraph?: () => void,\n\t) {\n\t\tsuper();\n\t\tthis._payloadState = payloadPending ? \"pending\" : \"shared\";\n\t\tthis.absolutePath = generateHandleContextPath(path, this.routeContext);\n\t}\n\n\tpublic readonly notifyShared = (): void => {\n\t\tthis._payloadState = \"shared\";\n\t\tthis._events?.emit(\"payloadShared\");\n\t};\n\n\tpublic readonly notifyFailed = (error: unknown): void => {\n\t\tthis._payloadShareError = error;\n\t\tthis._events?.emit(\"payloadShareFailed\", error);\n\t};\n\n\tpublic attachGraph(): void {\n\t\tif (!this.attached) {\n\t\t\tthis.attached = true;\n\t\t\tthis.onAttachGraph?.();\n\t\t}\n\t}\n}\n\n// Restrict the IContainerRuntime interface to the subset required by BlobManager. This helps to make\n// the contract explicit and reduces the amount of mocking required for tests.\nexport type IBlobManagerRuntime = Pick<\n\tIContainerRuntime,\n\t\"attachState\" | \"baseLogger\" | \"disposed\"\n> &\n\tIEventProvider<IContainerRuntimeEvents>;\n\nexport type ICreateBlobResponseWithTTL = ICreateBlobResponse &\n\tPartial<Record<\"minTTLInSeconds\", number>>;\n\n/**\n * A blob tracked by BlobManager that is only available on the local client. It is not currently\n * attempting an upload.\n */\ninterface LocalOnlyBlob {\n\tstate: \"localOnly\";\n\tblob: ArrayBufferLike;\n}\n\n/**\n * A blob tracked by BlobManager that is only known to be available on the local client, but is in\n * the process of being uploaded to storage.\n */\ninterface UploadingBlob {\n\tstate: \"uploading\";\n\tblob: ArrayBufferLike;\n}\n\n/**\n * A blob tracked by BlobManager that has been uploaded to storage. If the TTL has not expired, it\n * should still be available in storage. It is not currently attempting to send a BlobAttach op.\n */\ninterface UploadedBlob {\n\tstate: \"uploaded\";\n\tblob: ArrayBufferLike;\n\tstorageId: string;\n\tuploadTime: number;\n\tminTTLInSeconds: number | undefined;\n}\n\n/**\n * A blob tracked by BlobManager that has been uploaded to storage and is in the process of sending\n * a BlobAttach message and waiting for the ack.\n */\ninterface AttachingBlob {\n\tstate: \"attaching\";\n\tblob: ArrayBufferLike;\n\tstorageId: string;\n\tuploadTime: number;\n\tminTTLInSeconds: number | undefined;\n}\n\n/**\n * A blob tracked by BlobManager that has been uploaded to storage and its BlobAttach message has been\n * ack'd. It is fully shared and available to all clients, and is no longer considered pending.\n */\ninterface AttachedBlob {\n\tstate: \"attached\";\n\tblob: ArrayBufferLike;\n}\n\n/**\n * Blobs that were created locally are tracked, and may be in one of these states. When first\n * created, they are in localOnly state. The process of sharing has two steps, blob upload and\n * sending a BlobAttach op. Progress through the stages may regress back to localOnly if we\n * determine the storage may have deleted the blob before we could finish attaching it.\n */\ntype LocalBlobRecord =\n\t| LocalOnlyBlob\n\t| UploadingBlob\n\t| UploadedBlob\n\t| AttachingBlob\n\t| AttachedBlob;\n\n/**\n * Serializable form of the LocalBlobRecord that can be used to save and restore pending state.\n * Omits attached blobs since they are fully uploaded and don't need to be saved and restored.\n * Omits uploading and attaching states since upon restore we will need to restart those processes.\n */\nexport type SerializableLocalBlobRecord =\n\t| (Omit<LocalOnlyBlob, \"blob\"> & { blob: string })\n\t| (Omit<UploadedBlob, \"blob\"> & { blob: string });\n\nexport interface IPendingBlobs {\n\t[localId: string]: SerializableLocalBlobRecord;\n}\n\n/**\n * Check if for a given uploaded or attaching blob, the TTL is too close to expiry to safely attempt\n * an attach. Currently using a heuristic of half the TTL duration having passed since upload.\n */\nconst isTTLTooCloseToExpiry = (blobRecord: UploadedBlob | AttachingBlob): boolean =>\n\tblobRecord.minTTLInSeconds !== undefined &&\n\tDate.now() - blobRecord.uploadTime > (blobRecord.minTTLInSeconds / 2) * 1000;\n\ninterface IBlobManagerInternalEvents {\n\tblobExpired: (localId: string) => void;\n\thandleAttached: (pending: LocalBlobRecord) => void;\n\tprocessedBlobAttach: (localId: string, storageId: string) => void;\n}\n\nconst createAbortError = (): LoggingError => new LoggingError(\"uploadBlob aborted\");\n\nexport const blobManagerBasePath = \"_blobs\";\n\nexport class BlobManager {\n\tprivate readonly mc: MonitoringContext;\n\n\tprivate readonly internalEvents = createEmitter<IBlobManagerInternalEvents>();\n\n\t/**\n\t * Map of local IDs to storage IDs. Also includes identity mappings of storage ID to storage ID for all known\n\t * storage IDs. All requested IDs must be a key in this map. Blobs created while the container is detached are\n\t * stored in IDetachedBlobStorage which gives pseudo storage IDs; the real storage IDs are filled in at attach\n\t * time via setRedirectTable().\n\t */\n\tprivate readonly redirectTable: Map<string, string>;\n\n\t/**\n\t * The localBlobCache has a dual role of caching locally-created blobs, as well as tracking their state as they\n\t * are shared. Keys are localIds.\n\t */\n\tprivate readonly localBlobCache: Map<string, LocalBlobRecord> = new Map();\n\t/**\n\t * Blobs with an attached handle that have not finished blob-attaching are the set we need to provide from\n\t * getPendingState().  This stores their local IDs, and then we can look them up against the localBlobCache.\n\t */\n\tprivate readonly pendingBlobsWithAttachedHandles: Set<string> = new Set();\n\t/**\n\t * Local IDs for any pending blobs we loaded with and have not yet started the upload/attach flow for.\n\t */\n\tprivate readonly pendingOnlyLocalIds: Set<string> = new Set();\n\n\tprivate readonly sendBlobAttachMessage: (localId: string, storageId: string) => void;\n\n\tprivate readonly routeContext: IFluidHandleContext;\n\tprivate readonly storage: Pick<IContainerStorageService, \"createBlob\" | \"readBlob\">;\n\t// Called when a blob node is requested. blobPath is the path of the blob's node in GC's graph.\n\t// blobPath's format - `/<basePath>/<localId>`.\n\tprivate readonly blobRequested: (blobPath: string) => void;\n\t// Called to check if a blob has been deleted by GC.\n\t// blobPath's format - `/<basePath>/<localId>`.\n\tprivate readonly isBlobDeleted: (blobPath: string) => boolean;\n\tprivate readonly runtime: IBlobManagerRuntime;\n\n\tprivate readonly createBlobPayloadPending: boolean;\n\n\tpublic constructor(props: {\n\t\treadonly routeContext: IFluidHandleContext;\n\n\t\tblobManagerLoadInfo: IBlobManagerLoadInfo;\n\t\treadonly storage: Pick<IContainerStorageService, \"createBlob\" | \"readBlob\">;\n\t\t/**\n\t\t * Submit a BlobAttach message. When a blob is uploaded, there is a short grace period before which the blob is\n\t\t * deleted. The BlobAttach message notifies the server that blob is in use. The server will then not delete the\n\t\t * the blob as long as it is listed as referenced in future summaries. The summarizing client will know to\n\t\t * include the storage ID in the summary when it sees the message.\n\t\t *\n\t\t * The message will also include a local ID to inform all clients of the relation to the storage ID, without\n\t\t * knowledge of which they cannot request the blob from storage. It's important that this message is sequenced\n\t\t * before any messages that reference the local ID, otherwise, an invalid handle could be added to the document.\n\t\t */\n\t\tsendBlobAttachMessage: (localId: string, storageId: string) => void;\n\t\t// Called when a blob node is requested. blobPath is the path of the blob's node in GC's graph.\n\t\t// blobPath's format - `/<basePath>/<localId>`.\n\t\treadonly blobRequested: (blobPath: string) => void;\n\t\t// Called to check if a blob has been deleted by GC.\n\t\t// blobPath's format - `/<basePath>/<localId>`.\n\t\treadonly isBlobDeleted: (blobPath: string) => boolean;\n\t\treadonly runtime: IBlobManagerRuntime;\n\t\tpendingBlobs: IPendingBlobs | undefined;\n\t\treadonly createBlobPayloadPending: boolean;\n\t}) {\n\t\tconst {\n\t\t\trouteContext,\n\t\t\tblobManagerLoadInfo,\n\t\t\tstorage,\n\t\t\tsendBlobAttachMessage,\n\t\t\tblobRequested,\n\t\t\tisBlobDeleted,\n\t\t\truntime,\n\t\t\tpendingBlobs,\n\t\t\tcreateBlobPayloadPending,\n\t\t} = props;\n\t\tthis.routeContext = routeContext;\n\t\tthis.storage = storage;\n\t\tthis.sendBlobAttachMessage = sendBlobAttachMessage;\n\t\tthis.blobRequested = blobRequested;\n\t\tthis.isBlobDeleted = isBlobDeleted;\n\t\tthis.runtime = runtime;\n\t\tthis.createBlobPayloadPending = createBlobPayloadPending;\n\n\t\tthis.mc = createChildMonitoringContext({\n\t\t\tlogger: this.runtime.baseLogger,\n\t\t\tnamespace: \"BlobManager\",\n\t\t});\n\n\t\tthis.redirectTable = toRedirectTable(blobManagerLoadInfo, this.mc.logger);\n\n\t\t// We populate the localBlobCache with any pending blobs we are provided, which makes them available\n\t\t// to access even though they are not shared yet. However, we don't start the share flow until it is\n\t\t// explicitly invoked via sharePendingBlobs() in case we are loaded in a frozen container.\n\t\tif (pendingBlobs !== undefined) {\n\t\t\tfor (const [localId, serializableBlobRecord] of Object.entries(pendingBlobs)) {\n\t\t\t\tassert(\n\t\t\t\t\t!this.redirectTable.has(localId),\n\t\t\t\t\t0xc7e /* Pending blob already in redirect table */,\n\t\t\t\t);\n\t\t\t\tconst localBlobRecord = {\n\t\t\t\t\t...serializableBlobRecord,\n\t\t\t\t\tblob: stringToBuffer(serializableBlobRecord.blob, \"base64\"),\n\t\t\t\t};\n\t\t\t\tthis.localBlobCache.set(localId, localBlobRecord);\n\t\t\t\t// Since we received these blobs from pending state, we'll assume they were only added to the\n\t\t\t\t// pending state at generation time because their handles were attached. We add them back here\n\t\t\t\t// in case we need to round-trip them back out again due to another getPendingBlobs() call.\n\t\t\t\tthis.pendingBlobsWithAttachedHandles.add(localId);\n\t\t\t\tthis.pendingOnlyLocalIds.add(localId);\n\t\t\t}\n\t\t}\n\t}\n\n\t/**\n\t * Returns whether a blob with the given localId can be retrieved by the BlobManager via getBlob().\n\t */\n\tpublic hasBlob(localId: string): boolean {\n\t\treturn this.redirectTable.has(localId) || this.localBlobCache.has(localId);\n\t}\n\n\t/**\n\t * Lookup the blob storage ID for a given local blob id.\n\t * @param localId - The local blob id. Likely coming from a handle.\n\t * @returns The storage ID if found and the blob is not pending, undefined otherwise.\n\t * @remarks\n\t * For blobs with pending payloads (localId exists but upload hasn't finished), this is expected to return undefined.\n\t * Consumers should use the observability APIs on the handle (handle.payloadState, payloadShared event)\n\t * to understand/wait for storage ID availability.\n\t * Similarly, when the runtime is detached, this will return undefined as no blobs have been uploaded to storage.\n\t */\n\tpublic lookupTemporaryBlobStorageId(localId: string): string | undefined {\n\t\tif (this.runtime.attachState === AttachState.Detached) {\n\t\t\treturn undefined;\n\t\t}\n\t\t// Get the storage ID from the redirect table\n\t\treturn this.redirectTable.get(localId);\n\t}\n\n\t/**\n\t * Retrieve the blob with the given local blob id.\n\t * @param localId - The local blob id.  Likely coming from a handle.\n\t * @param payloadPending - Whether we suspect the payload may be pending and not available yet.\n\t * @returns A promise which resolves to the blob contents\n\t */\n\tpublic async getBlob(localId: string, payloadPending: boolean): Promise<ArrayBufferLike> {\n\t\t// Verify that the blob is not deleted, i.e., it has not been garbage collected. If it is, this will throw\n\t\t// an error, failing the call.\n\t\tthis.verifyBlobNotDeleted(localId);\n\t\t// Let runtime know that the corresponding GC node was requested.\n\t\t// Note that this will throw if the blob is inactive or tombstoned and throwing on incorrect usage\n\t\t// is configured.\n\t\tthis.blobRequested(getGCNodePathFromLocalId(localId));\n\n\t\tconst localBlobRecord = this.localBlobCache.get(localId);\n\t\tif (localBlobRecord !== undefined) {\n\t\t\treturn localBlobRecord.blob;\n\t\t}\n\n\t\tlet storageId = this.redirectTable.get(localId);\n\t\tif (storageId === undefined) {\n\t\t\t// Only blob handles explicitly marked with pending payload are permitted to exist without\n\t\t\t// yet knowing their storage id. Otherwise they must already be associated with a storage id.\n\t\t\t// Handles for detached blobs are not payload pending, though they should also always be present\n\t\t\t// in the localBlobCache and therefore should never need to refer to storage.\n\t\t\tassert(payloadPending, 0x11f /* \"requesting unknown blobs\" */);\n\t\t\t// If we didn't find it in the redirectTable and it's payloadPending, assume the attach message is coming\n\t\t\t// eventually and wait. We do this even if the local client doesn't have the blob payloadPending flag\n\t\t\t// enabled, in case a remote client does have it enabled. This wait may be infinite if the uploading\n\t\t\t// client failed the upload and doesn't exist anymore.\n\t\t\t// TODO: Fix this violation and remove the disable\n\t\t\t// eslint-disable-next-line require-atomic-updates\n\t\t\tstorageId = await new Promise<string>((resolve) => {\n\t\t\t\tconst onProcessBlobAttach = (_localId: string, _storageId: string): void => {\n\t\t\t\t\tif (_localId === localId) {\n\t\t\t\t\t\tthis.internalEvents.off(\"processedBlobAttach\", onProcessBlobAttach);\n\t\t\t\t\t\tresolve(_storageId);\n\t\t\t\t\t}\n\t\t\t\t};\n\t\t\t\tthis.internalEvents.on(\"processedBlobAttach\", onProcessBlobAttach);\n\t\t\t});\n\t\t}\n\n\t\treturn PerformanceEvent.timedExecAsync(\n\t\t\tthis.mc.logger,\n\t\t\t{ eventName: \"AttachmentReadBlob\", id: storageId },\n\t\t\tasync (event) => {\n\t\t\t\treturn this.storage.readBlob(storageId).catch((error) => {\n\t\t\t\t\tif (this.runtime.disposed) {\n\t\t\t\t\t\t// If the runtime is disposed, this is not an error we care to track, it's expected behavior.\n\t\t\t\t\t\tevent.cancel({ category: \"generic\" });\n\t\t\t\t\t}\n\n\t\t\t\t\tthrow error;\n\t\t\t\t});\n\t\t\t},\n\t\t\t{ end: true, cancel: \"error\" },\n\t\t);\n\t}\n\n\tprivate getNonPayloadPendingBlobHandle(localId: string): BlobHandle {\n\t\tconst localBlobRecord = this.localBlobCache.get(localId);\n\t\tassert(localBlobRecord !== undefined, 0x384 /* requesting handle for unknown blob */);\n\t\tassert(localBlobRecord.state === \"attached\", 0xc7f /* Expected blob to be attached */);\n\n\t\treturn new BlobHandle(\n\t\t\tgetGCNodePathFromLocalId(localId),\n\t\t\tthis.routeContext,\n\t\t\tasync () => this.getBlob(localId, false),\n\t\t\tfalse, // payloadPending\n\t\t);\n\t}\n\n\tpublic async createBlob(\n\t\tblob: ArrayBufferLike,\n\t\tsignal?: AbortSignal,\n\t): Promise<IFluidHandleInternalPayloadPending<ArrayBufferLike>> {\n\t\tif (this.runtime.attachState === AttachState.Detached) {\n\t\t\treturn this.createBlobDetached(blob, signal);\n\t\t}\n\t\tif (this.runtime.attachState === AttachState.Attaching) {\n\t\t\t// blob upload is not supported in \"Attaching\" state\n\t\t\tthis.mc.logger.sendTelemetryEvent({ eventName: \"CreateBlobWhileAttaching\" });\n\t\t\tawait new Promise<void>((resolve) => this.runtime.once(\"attached\", resolve));\n\t\t}\n\t\tassert(\n\t\t\tthis.runtime.attachState === AttachState.Attached,\n\t\t\t0x385 /* For clarity and paranoid defense against adding future attachment states */,\n\t\t);\n\n\t\treturn this.createBlobPayloadPending\n\t\t\t? this.createBlobWithPayloadPending(blob, signal)\n\t\t\t: this.createBlobLegacy(blob, signal);\n\t}\n\n\tprivate async createBlobDetached(\n\t\tblob: ArrayBufferLike,\n\t\tsignal?: AbortSignal,\n\t): Promise<IFluidHandleInternalPayloadPending<ArrayBufferLike>> {\n\t\tif (signal?.aborted === true) {\n\t\t\tthrow createAbortError();\n\t\t}\n\t\tconst localId = uuid();\n\t\tthis.localBlobCache.set(localId, { state: \"uploading\", blob });\n\t\t// Blobs created while the container is detached are stored in IDetachedBlobStorage.\n\t\t// The 'IContainerStorageService.createBlob()' call below will respond with a pseudo storage ID.\n\t\t// That pseudo storage ID will be replaced with the real storage ID at attach time.\n\t\tconst { id: detachedStorageId } = await this.storage.createBlob(blob);\n\t\t// From the perspective of the BlobManager, the blob is now fully attached. The actual\n\t\t// upload/attach process at container attach time is treated as opaque to this tracking.\n\t\tthis.localBlobCache.set(localId, { state: \"attached\", blob });\n\t\tthis.redirectTable.set(localId, detachedStorageId);\n\t\treturn this.getNonPayloadPendingBlobHandle(localId);\n\t}\n\n\tprivate async createBlobLegacy(\n\t\tblob: ArrayBufferLike,\n\t\tsignal?: AbortSignal,\n\t): Promise<IFluidHandleInternalPayloadPending<ArrayBufferLike>> {\n\t\tconst localId = uuid();\n\t\tthis.localBlobCache.set(localId, { state: \"localOnly\", blob });\n\t\tawait this.uploadAndAttach(localId, signal);\n\t\treturn this.getNonPayloadPendingBlobHandle(localId);\n\t}\n\n\tprivate createBlobWithPayloadPending(\n\t\tblob: ArrayBufferLike,\n\t\tsignal?: AbortSignal,\n\t): IFluidHandleInternalPayloadPending<ArrayBufferLike> {\n\t\tconst localId = uuid();\n\t\tthis.localBlobCache.set(localId, { state: \"localOnly\", blob });\n\n\t\tconst blobHandle = new BlobHandle(\n\t\t\tgetGCNodePathFromLocalId(localId),\n\t\t\tthis.routeContext,\n\t\t\tasync () => blob,\n\t\t\ttrue, // payloadPending\n\t\t\t() => {\n\t\t\t\tthis.pendingBlobsWithAttachedHandles.add(localId);\n\t\t\t\tconst uploadAndAttachP = this.uploadAndAttach(localId, signal);\n\t\t\t\tuploadAndAttachP.then(blobHandle.notifyShared).catch((error) => {\n\t\t\t\t\t// TODO: notifyShared won't fail directly, but it emits an event to the customer.\n\t\t\t\t\t// Consider what to do if the customer's code throws. reportError is nice.\n\t\t\t\t});\n\t\t\t\tuploadAndAttachP.catch(blobHandle.notifyFailed);\n\t\t\t},\n\t\t);\n\n\t\treturn blobHandle;\n\t}\n\n\t/**\n\t * Upload and attach the localBlobCache entry for the given localId.\n\t *\n\t * Expects the localBlobCache entry for the given localId to be in either localOnly or uploaded state\n\t * when called. Returns a promise that resolves when the blob completes uploading and attaching, or else\n\t * rejects if an error is encountered or the signal is aborted.\n\t */\n\tprivate readonly uploadAndAttach = async (\n\t\tlocalId: string,\n\t\tsignal?: AbortSignal,\n\t): Promise<void> => {\n\t\tif (signal?.aborted === true) {\n\t\t\tthis.localBlobCache.delete(localId);\n\t\t\tthis.pendingBlobsWithAttachedHandles.delete(localId);\n\t\t\tthrow createAbortError();\n\t\t}\n\t\tconst localBlobRecordInitial = this.localBlobCache.get(localId);\n\t\tassert(\n\t\t\tlocalBlobRecordInitial?.state === \"localOnly\" ||\n\t\t\t\tlocalBlobRecordInitial?.state === \"uploaded\",\n\t\t\t0xc80 /* Expect uploadAndAttach to be called with either localOnly or uploaded state */,\n\t\t);\n\t\tconst { blob } = localBlobRecordInitial;\n\n\t\t/**\n\t\t * Expects the localBlobCache entry for the given localId to be in either localOnly or uploaded state\n\t\t * when called. Returns a promise that resolves when the blob is in uploaded or attached state, or else\n\t\t * rejects on error during upload or if the signal is aborted.\n\t\t *\n\t\t * Most of the time this should be expected to exit in uploaded state, but if we are loading from pending\n\t\t * state we may see an attach message from the client that generated the pending state, which can complete the\n\t\t * attach while the upload is outstanding.\n\t\t */\n\t\tconst ensureUploaded = async (): Promise<void> => {\n\t\t\tconst localBlobRecord = this.localBlobCache.get(localId);\n\t\t\tif (localBlobRecord?.state === \"uploaded\") {\n\t\t\t\t// In normal creation flows, the blob will be in localOnly state here. But in the case of loading\n\t\t\t\t// with pending state we can call it with an uploaded-but-not-attached blob. Start the upload\n\t\t\t\t// flow only if it's localOnly.\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tassert(\n\t\t\t\tlocalBlobRecord?.state === \"localOnly\",\n\t\t\t\t0xc81 /* Attempting to upload from unexpected state */,\n\t\t\t);\n\n\t\t\tthis.localBlobCache.set(localId, { state: \"uploading\", blob });\n\t\t\tawait new Promise<void>((resolve, reject) => {\n\t\t\t\t// If we eventually have driver-level support for abort, then this can simplify a bit as we won't\n\t\t\t\t// need to track upload completion and abort separately. Until then, we need to handle the case that\n\t\t\t\t// the upload continues and settles after becoming irrelevant due to signal abort or blob attach.\n\t\t\t\tlet uploadHasBecomeIrrelevant = false;\n\t\t\t\tconst onSignalAbort = (): void => {\n\t\t\t\t\tremoveListeners();\n\t\t\t\t\tuploadHasBecomeIrrelevant = true;\n\t\t\t\t\tthis.localBlobCache.delete(localId);\n\t\t\t\t\tthis.pendingBlobsWithAttachedHandles.delete(localId);\n\t\t\t\t\treject(createAbortError());\n\t\t\t\t};\n\t\t\t\tconst onProcessedBlobAttach = (_localId: string, _storageId: string): void => {\n\t\t\t\t\tif (_localId === localId) {\n\t\t\t\t\t\tremoveListeners();\n\t\t\t\t\t\tuploadHasBecomeIrrelevant = true;\n\t\t\t\t\t\tresolve();\n\t\t\t\t\t}\n\t\t\t\t};\n\t\t\t\tconst removeListeners = (): void => {\n\t\t\t\t\tthis.internalEvents.off(\"processedBlobAttach\", onProcessedBlobAttach);\n\t\t\t\t\tsignal?.removeEventListener(\"abort\", onSignalAbort);\n\t\t\t\t};\n\t\t\t\tthis.internalEvents.on(\"processedBlobAttach\", onProcessedBlobAttach);\n\t\t\t\tsignal?.addEventListener(\"abort\", onSignalAbort);\n\n\t\t\t\tthis.storage\n\t\t\t\t\t.createBlob(blob)\n\t\t\t\t\t.then((createBlobResponse: ICreateBlobResponseWithTTL) => {\n\t\t\t\t\t\tif (!uploadHasBecomeIrrelevant) {\n\t\t\t\t\t\t\tremoveListeners();\n\t\t\t\t\t\t\tthis.localBlobCache.set(localId, {\n\t\t\t\t\t\t\t\tstate: \"uploaded\",\n\t\t\t\t\t\t\t\tblob,\n\t\t\t\t\t\t\t\tstorageId: createBlobResponse.id,\n\t\t\t\t\t\t\t\tuploadTime: Date.now(),\n\t\t\t\t\t\t\t\tminTTLInSeconds: createBlobResponse.minTTLInSeconds,\n\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\tresolve();\n\t\t\t\t\t\t}\n\t\t\t\t\t})\n\t\t\t\t\t.catch((error) => {\n\t\t\t\t\t\tif (!uploadHasBecomeIrrelevant) {\n\t\t\t\t\t\t\tremoveListeners();\n\t\t\t\t\t\t\t// If the storage call errors, we can't recover. Reject to throw back to the caller.\n\t\t\t\t\t\t\tthis.localBlobCache.delete(localId);\n\t\t\t\t\t\t\tthis.pendingBlobsWithAttachedHandles.delete(localId);\n\t\t\t\t\t\t\t// eslint-disable-next-line @typescript-eslint/prefer-promise-reject-errors\n\t\t\t\t\t\t\treject(error);\n\t\t\t\t\t\t}\n\t\t\t\t\t});\n\t\t\t});\n\t\t};\n\n\t\t/**\n\t\t * Expects the localBlobCache entry for the given localId to be in uploaded or attached state when called.\n\t\t * Returns a promise that resolves to true if the blob is successfully attached, or false if it cannot be\n\t\t * attached and the upload flow needs to be restarted from the top (currently only if the TTL expires before\n\t\t * attach can be completed). In the latter case, the localBlobRecord will also be reset to localOnly state.\n\t\t * The promise rejects if the signal is aborted.\n\t\t */\n\t\tconst tryAttach = async (): Promise<boolean> => {\n\t\t\tconst localBlobRecord = this.localBlobCache.get(localId);\n\t\t\tif (localBlobRecord?.state === \"attached\") {\n\t\t\t\t// In normal creation flows, the blob will be in uploaded state here. But if we are loading from pending\n\t\t\t\t// state and see an attach message from the client that generated the pending state, we may have reached\n\t\t\t\t// attached state in the middle of the upload attempt. In that case there's no more work to do and we\n\t\t\t\t// can just return.\n\t\t\t\treturn true;\n\t\t\t}\n\t\t\tassert(\n\t\t\t\tlocalBlobRecord?.state === \"uploaded\",\n\t\t\t\t0xc82 /* Attempting to attach from unexpected state */,\n\t\t\t);\n\n\t\t\t// If we just uploaded the blob TTL really shouldn't be expired at this location. But if we loaded from\n\t\t\t// pending state, the upload may have happened some time far in the past and could be expired here.\n\t\t\tif (isTTLTooCloseToExpiry(localBlobRecord)) {\n\t\t\t\t// If the TTL is expired, we assume it's gone from the storage and so is effectively localOnly again.\n\t\t\t\t// Then when we re-enter the loop, we'll re-upload it.\n\t\t\t\tthis.localBlobCache.set(localId, { state: \"localOnly\", blob });\n\t\t\t\t// Emitting here isn't really necessary since the only listener would be attached below. Including here\n\t\t\t\t// for completeness though, in case we add other listeners in the future.\n\t\t\t\tthis.internalEvents.emit(\"blobExpired\", localId);\n\t\t\t\treturn false;\n\t\t\t} else {\n\t\t\t\tthis.localBlobCache.set(localId, {\n\t\t\t\t\t...localBlobRecord,\n\t\t\t\t\tstate: \"attaching\",\n\t\t\t\t});\n\n\t\t\t\t// Send and await a blob attach op. This serves two purposes:\n\t\t\t\t// 1. If its a new blob, i.e., it isn't de-duped, the server will keep the blob alive if it sees this op\n\t\t\t\t//    until its storage ID is added to the next summary.\n\t\t\t\t// 2. It will create a local ID to storage ID mapping in all clients which is needed to retrieve the\n\t\t\t\t//    blob from the server via the storage ID.\n\t\t\t\treturn new Promise<boolean>((resolve, reject) => {\n\t\t\t\t\tconst onProcessedBlobAttach = (_localId: string, _storageId: string): void => {\n\t\t\t\t\t\tif (_localId === localId) {\n\t\t\t\t\t\t\tremoveListeners();\n\t\t\t\t\t\t\tresolve(true);\n\t\t\t\t\t\t}\n\t\t\t\t\t};\n\t\t\t\t\t// Although we already checked for TTL expiry above, the message we're about to send may later be asked\n\t\t\t\t\t// to resubmit. Before we resubmit, we check again for TTL expiry - this listener is how we learn if\n\t\t\t\t\t// we discovered expiry in the resubmit flow.\n\t\t\t\t\tconst onBlobExpired = (_localId: string): void => {\n\t\t\t\t\t\tif (_localId === localId) {\n\t\t\t\t\t\t\tremoveListeners();\n\t\t\t\t\t\t\tresolve(false);\n\t\t\t\t\t\t}\n\t\t\t\t\t};\n\t\t\t\t\tconst onSignalAbort = (): void => {\n\t\t\t\t\t\tremoveListeners();\n\t\t\t\t\t\tthis.localBlobCache.delete(localId);\n\t\t\t\t\t\tthis.pendingBlobsWithAttachedHandles.delete(localId);\n\t\t\t\t\t\treject(createAbortError());\n\t\t\t\t\t};\n\t\t\t\t\tconst removeListeners = (): void => {\n\t\t\t\t\t\tthis.internalEvents.off(\"processedBlobAttach\", onProcessedBlobAttach);\n\t\t\t\t\t\tthis.internalEvents.off(\"blobExpired\", onBlobExpired);\n\t\t\t\t\t\tsignal?.removeEventListener(\"abort\", onSignalAbort);\n\t\t\t\t\t};\n\n\t\t\t\t\tthis.internalEvents.on(\"processedBlobAttach\", onProcessedBlobAttach);\n\t\t\t\t\tthis.internalEvents.on(\"blobExpired\", onBlobExpired);\n\t\t\t\t\tsignal?.addEventListener(\"abort\", onSignalAbort);\n\t\t\t\t\tthis.sendBlobAttachMessage(localId, localBlobRecord.storageId);\n\t\t\t\t});\n\t\t\t}\n\t\t};\n\n\t\tlet attachCompleted = false;\n\t\twhile (!attachCompleted) {\n\t\t\tawait ensureUploaded();\n\t\t\tattachCompleted = await tryAttach();\n\n\t\t\t// If something stopped the attach from completing successfully (currently just TTL expiry),\n\t\t\t// we expect that the blob was already updated to reflect the updated state (i.e. back to localOnly)\n\t\t\t// and we'll try the loop again from the top.\n\t\t}\n\t\t// When the blob successfully attaches, the localBlobRecord will have been updated to attached state\n\t\t// at the time we processed the op, so there's nothing else to do here.\n\t};\n\n\t/**\n\t * Resubmit a BlobAttach op. Used to add storage IDs to messages that were\n\t * submitted to runtime while disconnected.\n\t * @param metadata - message metadata containing storage and/or local IDs\n\t */\n\tpublic reSubmit(metadata: Record<string, unknown> | undefined): void {\n\t\tassert(isBlobMetadata(metadata), 0xc01 /* Expected blob metadata for a BlobAttach op */);\n\t\tconst { localId, blobId: storageId } = metadata;\n\t\t// Any blob that we're actively trying to advance to attached state must be in attaching state.\n\t\t// Decline to resubmit for anything else.\n\t\t// For example, we might be asked to resubmit stashed messages for blobs that never had their handle\n\t\t// attached - these won't have a localBlobCache entry because we filter them out when generating\n\t\t// pending state. We shouldn't try to attach them since they won't be accessible to the customer\n\t\t// and would just be considered garbage immediately.\n\t\t// TODO: Is it possible that we'd be asked to resubmit for a pending blob before we call sharePendingBlobs?\n\t\tconst localBlobRecord = this.localBlobCache.get(localId);\n\t\tif (localBlobRecord?.state === \"attaching\") {\n\t\t\t// If the TTL is expired, we assume it's gone from the storage and so is effectively localOnly again.\n\t\t\tif (isTTLTooCloseToExpiry(localBlobRecord)) {\n\t\t\t\tthis.localBlobCache.set(localId, { state: \"localOnly\", blob: localBlobRecord.blob });\n\t\t\t\tthis.internalEvents.emit(\"blobExpired\", localId);\n\t\t\t} else {\n\t\t\t\tthis.sendBlobAttachMessage(localId, storageId);\n\t\t\t}\n\t\t}\n\t}\n\n\tpublic processBlobAttachMessage(message: ISequencedMessageEnvelope, local: boolean): void {\n\t\tassert(\n\t\t\tisBlobMetadata(message.metadata),\n\t\t\t0xc02 /* Expected blob metadata for a BlobAttach op */,\n\t\t);\n\t\tconst { localId, blobId: storageId } = message.metadata;\n\t\tconst maybeLocalBlobRecord = this.localBlobCache.get(localId);\n\t\tif (maybeLocalBlobRecord !== undefined) {\n\t\t\tconst attachedBlobRecord: AttachedBlob = {\n\t\t\t\tstate: \"attached\",\n\t\t\t\tblob: maybeLocalBlobRecord.blob,\n\t\t\t};\n\t\t\t// Processing a blob attach message is authoritative and may stomp on any existing state. Other\n\t\t\t// callsites that update localBlobCache entries must take proper caution to handle the case\n\t\t\t// that a blob attach message is processed concurrently.\n\t\t\tthis.localBlobCache.set(localId, attachedBlobRecord);\n\t\t\t// Note there may or may not be an entry in pendingBlobsWithAttachedHandles for this localId,\n\t\t\t// in particular for the non-payloadPending case since we should be reaching this point\n\t\t\t// before even returning a handle to the caller.\n\t\t\tthis.pendingBlobsWithAttachedHandles.delete(localId);\n\t\t\tthis.pendingOnlyLocalIds.delete(localId);\n\t\t}\n\t\tthis.redirectTable.set(localId, storageId);\n\t\t// set identity (id -> id) entry\n\t\tthis.redirectTable.set(storageId, storageId);\n\t\tthis.internalEvents.emit(\"processedBlobAttach\", localId, storageId);\n\t}\n\n\tpublic summarize(telemetryContext?: ITelemetryContext): ISummaryTreeWithStats {\n\t\treturn summarizeBlobManagerState(this.redirectTable);\n\t}\n\n\t/**\n\t * Generates data used for garbage collection. Each blob uploaded represents a node in the GC graph as it can be\n\t * individually referenced by storing its handle in a referenced DDS. Returns the list of blob ids as GC nodes.\n\t * @param fullGC - true to bypass optimizations and force full generation of GC data. BlobManager doesn't care\n\t * about this for now because the data is a simple list of blob ids.\n\t */\n\tpublic getGCData(fullGC: boolean = false): IGarbageCollectionData {\n\t\tconst gcData: IGarbageCollectionData = { gcNodes: {} };\n\t\tfor (const [localId, storageId] of this.redirectTable) {\n\t\t\t// Don't report the identity mappings to GC - these exist to service old handles that referenced the storage\n\t\t\t// IDs directly. We'll implicitly clean them up if all of their localId references get GC'd first.\n\t\t\tif (localId !== storageId) {\n\t\t\t\t// The outbound routes are empty because a blob node cannot reference other nodes. It can only be referenced\n\t\t\t\t// by adding its handle to a referenced DDS.\n\t\t\t\tgcData.gcNodes[getGCNodePathFromLocalId(localId)] = [];\n\t\t\t}\n\t\t}\n\t\treturn gcData;\n\t}\n\n\t/**\n\t * Delete blobs with the given routes from the redirect table.\n\t * @returns The routes of blobs that were deleted.\n\t *\n\t * @remarks\n\t * The routes are GC nodes paths of format -`/<blobManagerBasePath>/<localId>`.\n\t * Deleting the blobs involves 2 steps:\n\t *\n\t * 1. The redirect table entry for the local ids are deleted.\n\t *\n\t * 2. If the storage ids corresponding to the deleted local ids are not referenced by any further local ids, the\n\t * identity mappings in the redirect table are deleted as well.\n\t *\n\t * Note that this does not delete the blobs from storage service immediately. Deleting the blobs from redirect table\n\t * will ensure we don't create an attachment blob for them at the next summary. The service would then delete them\n\t * some time in the future.\n\t */\n\tpublic deleteSweepReadyNodes(sweepReadyBlobRoutes: readonly string[]): readonly string[] {\n\t\t// maybeUnusedStorageIds is used to compute the set of storage IDs that *used to have a local ID*, but that\n\t\t// local ID is being deleted.\n\t\tconst maybeUnusedStorageIds: Set<string> = new Set();\n\t\tfor (const route of sweepReadyBlobRoutes) {\n\t\t\tconst localId = getLocalIdFromGCNodePath(route);\n\t\t\t// If the blob hasn't already been deleted, log an error because this should never happen.\n\t\t\t// If the blob has already been deleted, log a telemetry event. This can happen because multiple GC\n\t\t\t// sweep messages can contain the same data store. It would be interesting to track how often this happens.\n\t\t\tconst alreadyDeleted = this.isBlobDeleted(route);\n\t\t\tconst storageId = this.redirectTable.get(localId);\n\t\t\tif (storageId === undefined) {\n\t\t\t\tthis.mc.logger.sendTelemetryEvent({\n\t\t\t\t\teventName: \"DeletedAttachmentBlobNotFound\",\n\t\t\t\t\tcategory: alreadyDeleted ? \"generic\" : \"error\",\n\t\t\t\t\tblobId: localId,\n\t\t\t\t\tdetails: { alreadyDeleted },\n\t\t\t\t});\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tmaybeUnusedStorageIds.add(storageId);\n\t\t\tthis.redirectTable.delete(localId);\n\t\t}\n\n\t\t// Remove any storage IDs that still have local IDs referring to them (excluding the identity mapping).\n\t\tfor (const [localId, storageId] of this.redirectTable) {\n\t\t\tif (localId !== storageId) {\n\t\t\t\tmaybeUnusedStorageIds.delete(storageId);\n\t\t\t}\n\t\t}\n\n\t\t// Now delete any identity mappings (storage ID -> storage ID) from the redirect table that used to be\n\t\t// referenced by a distinct local ID. This way they'll be absent from the next summary, and the service\n\t\t// is free to delete them from storage.\n\t\t// WARNING: This can potentially delete identity mappings that are still referenced, if storage deduping\n\t\t// has let us add a local ID -> storage ID mapping that is later deleted.  AB#47337 tracks this issue\n\t\t// and possible solutions.\n\t\tfor (const storageId of maybeUnusedStorageIds) {\n\t\t\tthis.redirectTable.delete(storageId);\n\t\t}\n\t\treturn [...sweepReadyBlobRoutes];\n\t}\n\n\t/**\n\t * Verifies that the blob with given id is not deleted, i.e., it has not been garbage collected. If the blob is GC'd,\n\t * log an error and throw if necessary.\n\t */\n\tprivate verifyBlobNotDeleted(localId: string): void {\n\t\tif (!this.isBlobDeleted(getGCNodePathFromLocalId(localId))) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst request = { url: localId };\n\t\tconst error = responseToException(\n\t\t\tcreateResponseError(404, `Blob was deleted`, request),\n\t\t\trequest,\n\t\t);\n\t\t// Only log deleted events. Tombstone events are logged by garbage collector.\n\t\tthis.mc.logger.sendErrorEvent(\n\t\t\t{\n\t\t\t\teventName: \"GC_Deleted_Blob_Requested\",\n\t\t\t\tpkg: blobManagerBasePath,\n\t\t\t},\n\t\t\terror,\n\t\t);\n\t\tthrow error;\n\t}\n\n\t/**\n\t * Called in detached state just prior to attaching, this will update the redirect table by\n\t * converting the pseudo storage IDs into real storage IDs using the provided detachedStorageTable.\n\t * The provided table must have exactly the same set of pseudo storage IDs as are found in the redirect table.\n\t * @param detachedStorageTable - A map of pseudo storage IDs to real storage IDs.\n\t */\n\tpublic readonly patchRedirectTable = (detachedStorageTable: Map<string, string>): void => {\n\t\tassert(\n\t\t\tthis.runtime.attachState === AttachState.Detached,\n\t\t\t0x252 /* \"redirect table can only be set in detached container\" */,\n\t\t);\n\t\t// The values of the redirect table are the pseudo storage IDs, which are the keys of the\n\t\t// detachedStorageTable. We expect to have a many:1 mapping from local IDs to pseudo\n\t\t// storage IDs (many in the case that the storage dedupes the blob).\n\t\tassert(\n\t\t\tnew Set(this.redirectTable.values()).size === detachedStorageTable.size,\n\t\t\t0x391 /* Redirect table size must match BlobManager's local ID count */,\n\t\t);\n\t\t// Taking a snapshot of the redirect table entries before iterating, because\n\t\t// we will be adding identity mappings to the the redirect table as we iterate\n\t\t// and we don't want to include those in the iteration.\n\t\tconst redirectTableEntries = [...this.redirectTable.entries()];\n\t\tfor (const [localId, detachedStorageId] of redirectTableEntries) {\n\t\t\tconst newStorageId = detachedStorageTable.get(detachedStorageId);\n\t\t\tassert(newStorageId !== undefined, 0xc53 /* Couldn't find a matching storage ID */);\n\t\t\tthis.redirectTable.set(localId, newStorageId);\n\t\t\t// set identity (id -> id) entry\n\t\t\tthis.redirectTable.set(newStorageId, newStorageId);\n\t\t}\n\t};\n\n\t/**\n\t * Upload and attach any pending blobs that the BlobManager was loaded with that have not already\n\t * been attached in the meantime.\n\t * @returns A promise that resolves when all the uploads and attaches have completed, or rejects\n\t * if any of them fail.\n\t */\n\tpublic readonly sharePendingBlobs = async (): Promise<void> => {\n\t\tconst localIdsToUpload = [...this.pendingOnlyLocalIds];\n\t\tthis.pendingOnlyLocalIds.clear();\n\t\tawait Promise.all<void>(\n\t\t\tlocalIdsToUpload.map(async (localId) => this.uploadAndAttach(localId)),\n\t\t);\n\t};\n\n\t/**\n\t * To be used in getPendingLocalState flow. Get a serializable record of the blobs that are\n\t * pending upload and/or their BlobAttach op, which can be given to a new BlobManager to\n\t * resume work.\n\t */\n\tpublic getPendingBlobs(): IPendingBlobs | undefined {\n\t\tconst pendingBlobs: IPendingBlobs = {};\n\t\tfor (const localId of this.pendingBlobsWithAttachedHandles) {\n\t\t\tconst localBlobRecord = this.localBlobCache.get(localId);\n\t\t\tassert(localBlobRecord !== undefined, 0xc83 /* Pending blob must be in local cache */);\n\t\t\tassert(\n\t\t\t\tlocalBlobRecord.state !== \"attached\",\n\t\t\t\t0xc84 /* Pending blob must not be in attached state */,\n\t\t\t);\n\t\t\t// We downgrade uploading blobs to localOnly, and attaching blobs to uploaded. In the case of\n\t\t\t// uploading blobs, we don't have a way to retrieve the eventual storageId so the upload will\n\t\t\t// need to be restarted anyway. In the case of attaching blobs, we can't know whether the\n\t\t\t// BlobAttach message will eventually be ack'd. So we assume we'll need to send another message, but also\n\t\t\t// remain prepared to handle seeing the ack of the original message after loading from pending state.\n\t\t\tpendingBlobs[localId] =\n\t\t\t\tlocalBlobRecord.state === \"localOnly\" || localBlobRecord.state === \"uploading\"\n\t\t\t\t\t? {\n\t\t\t\t\t\t\tstate: \"localOnly\",\n\t\t\t\t\t\t\tblob: bufferToString(localBlobRecord.blob, \"base64\"),\n\t\t\t\t\t\t}\n\t\t\t\t\t: {\n\t\t\t\t\t\t\t...localBlobRecord,\n\t\t\t\t\t\t\tstate: \"uploaded\",\n\t\t\t\t\t\t\tblob: bufferToString(localBlobRecord.blob, \"base64\"),\n\t\t\t\t\t\t};\n\t\t}\n\t\treturn Object.keys(pendingBlobs).length > 0 ? pendingBlobs : undefined;\n\t}\n}\n\n/**\n * For a localId, returns its path in GC's graph. The node path is of the format `/<blobManagerBasePath>/<localId>`.\n * This path must match the path of the blob handle returned by the createBlob API because blobs are marked\n * referenced by storing these handles in a referenced DDS.\n */\nexport const getGCNodePathFromLocalId = (localId: string): string =>\n\t`/${blobManagerBasePath}/${localId}`;\n\n/**\n * For a given GC node path, return the localId. The node path is of the format `/<basePath>/<localId>`.\n */\nconst getLocalIdFromGCNodePath = (nodePath: string): string => {\n\tconst pathParts = nodePath.split(\"/\");\n\tassert(areBlobPathParts(pathParts), 0x5bd /* Invalid blob node path */);\n\treturn pathParts[2];\n};\n\n/**\n * Returns whether a given path is for attachment blobs that are in the format - \"/blobManagerBasePath/...\".\n */\nexport const isBlobPath = (path: string): path is `/${typeof blobManagerBasePath}/${string}` =>\n\tareBlobPathParts(path.split(\"/\"));\n\nconst areBlobPathParts = (\n\tpathParts: string[],\n): pathParts is [\"\", typeof blobManagerBasePath, string] =>\n\tpathParts.length === 3 && pathParts[1] === blobManagerBasePath;\n"]}
+{"version":3,"file":"blobManager.js","sourceRoot":"","sources":["../../src/blobManager/blobManager.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 { bufferToString, createEmitter, stringToBuffer } from \"@fluid-internal/client-utils\";\nimport {\n\tAttachState,\n\ttype IContainerStorageService,\n} from \"@fluidframework/container-definitions/internal\";\nimport type {\n\tIContainerRuntime,\n\tIContainerRuntimeEvents,\n} from \"@fluidframework/container-runtime-definitions/internal\";\nimport type {\n\tIEmitter,\n\tIEventProvider,\n\tIFluidHandleContext,\n\tIFluidHandleInternalPayloadPending,\n\tILocalFluidHandle,\n\tILocalFluidHandleEvents,\n\tListenable,\n\tPayloadState,\n} from \"@fluidframework/core-interfaces/internal\";\nimport { assert } from \"@fluidframework/core-utils/internal\";\nimport type { ICreateBlobResponse } from \"@fluidframework/driver-definitions/internal\";\nimport type {\n\tIGarbageCollectionData,\n\tISummaryTreeWithStats,\n\tITelemetryContext,\n\tISequencedMessageEnvelope,\n} from \"@fluidframework/runtime-definitions/internal\";\nimport {\n\tFluidHandleBase,\n\tcreateResponseError,\n\tgenerateHandleContextPath,\n\tresponseToException,\n} from \"@fluidframework/runtime-utils/internal\";\nimport {\n\tLoggingError,\n\ttype MonitoringContext,\n\tPerformanceEvent,\n\tcreateChildMonitoringContext,\n} from \"@fluidframework/telemetry-utils/internal\";\nimport { v4 as uuid } from \"uuid\";\n\nimport { isBlobMetadata } from \"../metadata.js\";\n\nimport {\n\tsummarizeBlobManagerState,\n\ttoRedirectTable,\n\ttype IBlobManagerLoadInfo,\n} from \"./blobManagerSnapSum.js\";\n\n/**\n * This class represents blob (long string)\n * This object is used only when creating (writing) new blob and serialization purposes.\n * De-serialization process goes through FluidObjectHandle and request flow:\n * DataObject.request() recognizes requests in the form of `/blobs/<id>`\n * and loads blob.\n */\nexport class BlobHandle\n\textends FluidHandleBase<ArrayBufferLike>\n\timplements\n\t\tILocalFluidHandle<ArrayBufferLike>,\n\t\tIFluidHandleInternalPayloadPending<ArrayBufferLike>\n{\n\tprivate attached: boolean = false;\n\n\tpublic get isAttached(): boolean {\n\t\treturn this.routeContext.isAttached && this.attached;\n\t}\n\n\tprivate _events:\n\t\t| (Listenable<ILocalFluidHandleEvents> & IEmitter<ILocalFluidHandleEvents>)\n\t\t| undefined;\n\tpublic get events(): Listenable<ILocalFluidHandleEvents> {\n\t\treturn (this._events ??= createEmitter<ILocalFluidHandleEvents>());\n\t}\n\n\tprivate _payloadState: PayloadState;\n\tpublic get payloadState(): PayloadState {\n\t\treturn this._payloadState;\n\t}\n\n\t/**\n\t * The error property starts undefined, signalling that there has been no error yet.\n\t * If an error occurs, the property will contain the error.\n\t */\n\tprivate _payloadShareError: unknown;\n\tpublic get payloadShareError(): unknown {\n\t\treturn this._payloadShareError;\n\t}\n\n\tpublic readonly absolutePath: string;\n\n\tpublic constructor(\n\t\tpublic readonly path: string,\n\t\tpublic readonly routeContext: IFluidHandleContext,\n\t\t// TODO: just take the blob rather than a get function?\n\t\tpublic get: () => Promise<ArrayBufferLike>,\n\t\tpublic readonly payloadPending: boolean,\n\t\tprivate readonly onAttachGraph?: () => void,\n\t) {\n\t\tsuper();\n\t\tthis._payloadState = payloadPending ? \"pending\" : \"shared\";\n\t\tthis.absolutePath = generateHandleContextPath(path, this.routeContext);\n\t}\n\n\tpublic readonly notifyShared = (): void => {\n\t\tthis._payloadState = \"shared\";\n\t\tthis._events?.emit(\"payloadShared\");\n\t};\n\n\tpublic readonly notifyFailed = (error: unknown): void => {\n\t\tthis._payloadShareError = error;\n\t\tthis._events?.emit(\"payloadShareFailed\", error);\n\t};\n\n\tpublic attachGraph(): void {\n\t\tif (!this.attached) {\n\t\t\tthis.attached = true;\n\t\t\tthis.onAttachGraph?.();\n\t\t}\n\t}\n}\n\n// Restrict the IContainerRuntime interface to the subset required by BlobManager. This helps to make\n// the contract explicit and reduces the amount of mocking required for tests.\nexport type IBlobManagerRuntime = Pick<\n\tIContainerRuntime,\n\t\"attachState\" | \"baseLogger\" | \"disposed\"\n> &\n\tIEventProvider<IContainerRuntimeEvents>;\n\nexport type ICreateBlobResponseWithTTL = ICreateBlobResponse &\n\tPartial<Record<\"minTTLInSeconds\", number>>;\n\n/**\n * A blob tracked by BlobManager that is only available on the local client. It is not currently\n * attempting an upload.\n */\ninterface LocalOnlyBlob {\n\tstate: \"localOnly\";\n\tblob: ArrayBufferLike;\n}\n\n/**\n * A blob tracked by BlobManager that is only known to be available on the local client, but is in\n * the process of being uploaded to storage.\n */\ninterface UploadingBlob {\n\tstate: \"uploading\";\n\tblob: ArrayBufferLike;\n}\n\n/**\n * A blob tracked by BlobManager that has been uploaded to storage. If the TTL has not expired, it\n * should still be available in storage. It is not currently attempting to send a BlobAttach op.\n */\ninterface UploadedBlob {\n\tstate: \"uploaded\";\n\tblob: ArrayBufferLike;\n\tstorageId: string;\n\tuploadTime: number;\n\tminTTLInSeconds: number | undefined;\n}\n\n/**\n * A blob tracked by BlobManager that has been uploaded to storage and is in the process of sending\n * a BlobAttach message and waiting for the ack.\n */\ninterface AttachingBlob {\n\tstate: \"attaching\";\n\tblob: ArrayBufferLike;\n\tstorageId: string;\n\tuploadTime: number;\n\tminTTLInSeconds: number | undefined;\n}\n\n/**\n * A blob tracked by BlobManager that has been uploaded to storage and its BlobAttach message has been\n * ack'd. It is fully shared and available to all clients, and is no longer considered pending.\n */\ninterface AttachedBlob {\n\tstate: \"attached\";\n\tblob: ArrayBufferLike;\n}\n\n/**\n * Blobs that were created locally are tracked, and may be in one of these states. When first\n * created, they are in localOnly state. The process of sharing has two steps, blob upload and\n * sending a BlobAttach op. Progress through the stages may regress back to localOnly if we\n * determine the storage may have deleted the blob before we could finish attaching it.\n */\ntype LocalBlobRecord =\n\t| LocalOnlyBlob\n\t| UploadingBlob\n\t| UploadedBlob\n\t| AttachingBlob\n\t| AttachedBlob;\n\n/**\n * Serializable form of the LocalBlobRecord that can be used to save and restore pending state.\n * Omits attached blobs since they are fully uploaded and don't need to be saved and restored.\n * Omits uploading and attaching states since upon restore we will need to restart those processes.\n */\nexport type SerializableLocalBlobRecord =\n\t| (Omit<LocalOnlyBlob, \"blob\"> & { blob: string })\n\t| (Omit<UploadedBlob, \"blob\"> & { blob: string });\n\nexport interface IPendingBlobs {\n\t[localId: string]: SerializableLocalBlobRecord;\n}\n\n/**\n * Check if for a given uploaded or attaching blob, the TTL is too close to expiry to safely attempt\n * an attach. Currently using a heuristic of half the TTL duration having passed since upload.\n */\nconst isTTLTooCloseToExpiry = (blobRecord: UploadedBlob | AttachingBlob): boolean =>\n\tblobRecord.minTTLInSeconds !== undefined &&\n\tDate.now() - blobRecord.uploadTime > (blobRecord.minTTLInSeconds / 2) * 1000;\n\ninterface IBlobManagerInternalEvents {\n\tblobExpired: (localId: string) => void;\n\thandleAttached: (pending: LocalBlobRecord) => void;\n\tprocessedBlobAttach: (localId: string, storageId: string) => void;\n}\n\nconst createAbortError = (): LoggingError => new LoggingError(\"uploadBlob aborted\");\n\n/**\n * @internal\n */\nexport const blobManagerBasePath = \"_blobs\";\n\nexport class BlobManager {\n\tprivate readonly mc: MonitoringContext;\n\n\tprivate readonly internalEvents = createEmitter<IBlobManagerInternalEvents>();\n\n\t/**\n\t * Map of local IDs to storage IDs. Also includes identity mappings of storage ID to storage ID for all known\n\t * storage IDs. All requested IDs must be a key in this map. Blobs created while the container is detached are\n\t * stored in IDetachedBlobStorage which gives pseudo storage IDs; the real storage IDs are filled in at attach\n\t * time via setRedirectTable().\n\t */\n\tprivate readonly redirectTable: Map<string, string>;\n\n\t/**\n\t * The localBlobCache has a dual role of caching locally-created blobs, as well as tracking their state as they\n\t * are shared. Keys are localIds.\n\t */\n\tprivate readonly localBlobCache: Map<string, LocalBlobRecord> = new Map();\n\t/**\n\t * Blobs with an attached handle that have not finished blob-attaching are the set we need to provide from\n\t * getPendingState().  This stores their local IDs, and then we can look them up against the localBlobCache.\n\t */\n\tprivate readonly pendingBlobsWithAttachedHandles: Set<string> = new Set();\n\t/**\n\t * Local IDs for any pending blobs we loaded with and have not yet started the upload/attach flow for.\n\t */\n\tprivate readonly pendingOnlyLocalIds: Set<string> = new Set();\n\n\tprivate readonly sendBlobAttachMessage: (localId: string, storageId: string) => void;\n\n\tprivate readonly routeContext: IFluidHandleContext;\n\tprivate readonly storage: Pick<IContainerStorageService, \"createBlob\" | \"readBlob\">;\n\t// Called when a blob node is requested. blobPath is the path of the blob's node in GC's graph.\n\t// blobPath's format - `/<basePath>/<localId>`.\n\tprivate readonly blobRequested: (blobPath: string) => void;\n\t// Called to check if a blob has been deleted by GC.\n\t// blobPath's format - `/<basePath>/<localId>`.\n\tprivate readonly isBlobDeleted: (blobPath: string) => boolean;\n\tprivate readonly runtime: IBlobManagerRuntime;\n\n\tprivate readonly createBlobPayloadPending: boolean;\n\n\tpublic constructor(props: {\n\t\treadonly routeContext: IFluidHandleContext;\n\n\t\tblobManagerLoadInfo: IBlobManagerLoadInfo;\n\t\treadonly storage: Pick<IContainerStorageService, \"createBlob\" | \"readBlob\">;\n\t\t/**\n\t\t * Submit a BlobAttach message. When a blob is uploaded, there is a short grace period before which the blob is\n\t\t * deleted. The BlobAttach message notifies the server that blob is in use. The server will then not delete the\n\t\t * the blob as long as it is listed as referenced in future summaries. The summarizing client will know to\n\t\t * include the storage ID in the summary when it sees the message.\n\t\t *\n\t\t * The message will also include a local ID to inform all clients of the relation to the storage ID, without\n\t\t * knowledge of which they cannot request the blob from storage. It's important that this message is sequenced\n\t\t * before any messages that reference the local ID, otherwise, an invalid handle could be added to the document.\n\t\t */\n\t\tsendBlobAttachMessage: (localId: string, storageId: string) => void;\n\t\t// Called when a blob node is requested. blobPath is the path of the blob's node in GC's graph.\n\t\t// blobPath's format - `/<basePath>/<localId>`.\n\t\treadonly blobRequested: (blobPath: string) => void;\n\t\t// Called to check if a blob has been deleted by GC.\n\t\t// blobPath's format - `/<basePath>/<localId>`.\n\t\treadonly isBlobDeleted: (blobPath: string) => boolean;\n\t\treadonly runtime: IBlobManagerRuntime;\n\t\tpendingBlobs: IPendingBlobs | undefined;\n\t\treadonly createBlobPayloadPending: boolean;\n\t}) {\n\t\tconst {\n\t\t\trouteContext,\n\t\t\tblobManagerLoadInfo,\n\t\t\tstorage,\n\t\t\tsendBlobAttachMessage,\n\t\t\tblobRequested,\n\t\t\tisBlobDeleted,\n\t\t\truntime,\n\t\t\tpendingBlobs,\n\t\t\tcreateBlobPayloadPending,\n\t\t} = props;\n\t\tthis.routeContext = routeContext;\n\t\tthis.storage = storage;\n\t\tthis.sendBlobAttachMessage = sendBlobAttachMessage;\n\t\tthis.blobRequested = blobRequested;\n\t\tthis.isBlobDeleted = isBlobDeleted;\n\t\tthis.runtime = runtime;\n\t\tthis.createBlobPayloadPending = createBlobPayloadPending;\n\n\t\tthis.mc = createChildMonitoringContext({\n\t\t\tlogger: this.runtime.baseLogger,\n\t\t\tnamespace: \"BlobManager\",\n\t\t});\n\n\t\tthis.redirectTable = toRedirectTable(blobManagerLoadInfo, this.mc.logger);\n\n\t\t// We populate the localBlobCache with any pending blobs we are provided, which makes them available\n\t\t// to access even though they are not shared yet. However, we don't start the share flow until it is\n\t\t// explicitly invoked via sharePendingBlobs() in case we are loaded in a frozen container.\n\t\tif (pendingBlobs !== undefined) {\n\t\t\tfor (const [localId, serializableBlobRecord] of Object.entries(pendingBlobs)) {\n\t\t\t\tassert(\n\t\t\t\t\t!this.redirectTable.has(localId),\n\t\t\t\t\t0xc7e /* Pending blob already in redirect table */,\n\t\t\t\t);\n\t\t\t\tconst localBlobRecord = {\n\t\t\t\t\t...serializableBlobRecord,\n\t\t\t\t\tblob: stringToBuffer(serializableBlobRecord.blob, \"base64\"),\n\t\t\t\t};\n\t\t\t\tthis.localBlobCache.set(localId, localBlobRecord);\n\t\t\t\t// Since we received these blobs from pending state, we'll assume they were only added to the\n\t\t\t\t// pending state at generation time because their handles were attached. We add them back here\n\t\t\t\t// in case we need to round-trip them back out again due to another getPendingBlobs() call.\n\t\t\t\tthis.pendingBlobsWithAttachedHandles.add(localId);\n\t\t\t\tthis.pendingOnlyLocalIds.add(localId);\n\t\t\t}\n\t\t}\n\t}\n\n\t/**\n\t * Returns whether a blob with the given localId can be retrieved by the BlobManager via getBlob().\n\t */\n\tpublic hasBlob(localId: string): boolean {\n\t\treturn this.redirectTable.has(localId) || this.localBlobCache.has(localId);\n\t}\n\n\t/**\n\t * Lookup the blob storage ID for a given local blob id.\n\t * @param localId - The local blob id. Likely coming from a handle.\n\t * @returns The storage ID if found and the blob is not pending, undefined otherwise.\n\t * @remarks\n\t * For blobs with pending payloads (localId exists but upload hasn't finished), this is expected to return undefined.\n\t * Consumers should use the observability APIs on the handle (handle.payloadState, payloadShared event)\n\t * to understand/wait for storage ID availability.\n\t * Similarly, when the runtime is detached, this will return undefined as no blobs have been uploaded to storage.\n\t */\n\tpublic lookupTemporaryBlobStorageId(localId: string): string | undefined {\n\t\tif (this.runtime.attachState === AttachState.Detached) {\n\t\t\treturn undefined;\n\t\t}\n\t\t// Get the storage ID from the redirect table\n\t\treturn this.redirectTable.get(localId);\n\t}\n\n\t/**\n\t * Retrieve the blob with the given local blob id.\n\t * @param localId - The local blob id.  Likely coming from a handle.\n\t * @param payloadPending - Whether we suspect the payload may be pending and not available yet.\n\t * @returns A promise which resolves to the blob contents\n\t */\n\tpublic async getBlob(localId: string, payloadPending: boolean): Promise<ArrayBufferLike> {\n\t\t// Verify that the blob is not deleted, i.e., it has not been garbage collected. If it is, this will throw\n\t\t// an error, failing the call.\n\t\tthis.verifyBlobNotDeleted(localId);\n\t\t// Let runtime know that the corresponding GC node was requested.\n\t\t// Note that this will throw if the blob is inactive or tombstoned and throwing on incorrect usage\n\t\t// is configured.\n\t\tthis.blobRequested(getGCNodePathFromLocalId(localId));\n\n\t\tconst localBlobRecord = this.localBlobCache.get(localId);\n\t\tif (localBlobRecord !== undefined) {\n\t\t\treturn localBlobRecord.blob;\n\t\t}\n\n\t\tlet storageId = this.redirectTable.get(localId);\n\t\tif (storageId === undefined) {\n\t\t\t// Only blob handles explicitly marked with pending payload are permitted to exist without\n\t\t\t// yet knowing their storage id. Otherwise they must already be associated with a storage id.\n\t\t\t// Handles for detached blobs are not payload pending, though they should also always be present\n\t\t\t// in the localBlobCache and therefore should never need to refer to storage.\n\t\t\tassert(payloadPending, 0x11f /* \"requesting unknown blobs\" */);\n\t\t\t// If we didn't find it in the redirectTable and it's payloadPending, assume the attach message is coming\n\t\t\t// eventually and wait. We do this even if the local client doesn't have the blob payloadPending flag\n\t\t\t// enabled, in case a remote client does have it enabled. This wait may be infinite if the uploading\n\t\t\t// client failed the upload and doesn't exist anymore.\n\t\t\t// TODO: Fix this violation and remove the disable\n\t\t\t// eslint-disable-next-line require-atomic-updates\n\t\t\tstorageId = await new Promise<string>((resolve) => {\n\t\t\t\tconst onProcessBlobAttach = (_localId: string, _storageId: string): void => {\n\t\t\t\t\tif (_localId === localId) {\n\t\t\t\t\t\tthis.internalEvents.off(\"processedBlobAttach\", onProcessBlobAttach);\n\t\t\t\t\t\tresolve(_storageId);\n\t\t\t\t\t}\n\t\t\t\t};\n\t\t\t\tthis.internalEvents.on(\"processedBlobAttach\", onProcessBlobAttach);\n\t\t\t});\n\t\t}\n\n\t\treturn PerformanceEvent.timedExecAsync(\n\t\t\tthis.mc.logger,\n\t\t\t{ eventName: \"AttachmentReadBlob\", id: storageId },\n\t\t\tasync (event) => {\n\t\t\t\treturn this.storage.readBlob(storageId).catch((error) => {\n\t\t\t\t\tif (this.runtime.disposed) {\n\t\t\t\t\t\t// If the runtime is disposed, this is not an error we care to track, it's expected behavior.\n\t\t\t\t\t\tevent.cancel({ category: \"generic\" });\n\t\t\t\t\t}\n\n\t\t\t\t\tthrow error;\n\t\t\t\t});\n\t\t\t},\n\t\t\t{ end: true, cancel: \"error\" },\n\t\t);\n\t}\n\n\tprivate getNonPayloadPendingBlobHandle(localId: string): BlobHandle {\n\t\tconst localBlobRecord = this.localBlobCache.get(localId);\n\t\tassert(localBlobRecord !== undefined, 0x384 /* requesting handle for unknown blob */);\n\t\tassert(localBlobRecord.state === \"attached\", 0xc7f /* Expected blob to be attached */);\n\n\t\treturn new BlobHandle(\n\t\t\tgetGCNodePathFromLocalId(localId),\n\t\t\tthis.routeContext,\n\t\t\tasync () => this.getBlob(localId, false),\n\t\t\tfalse, // payloadPending\n\t\t);\n\t}\n\n\tpublic async createBlob(\n\t\tblob: ArrayBufferLike,\n\t\tsignal?: AbortSignal,\n\t): Promise<IFluidHandleInternalPayloadPending<ArrayBufferLike>> {\n\t\tif (this.runtime.attachState === AttachState.Detached) {\n\t\t\treturn this.createBlobDetached(blob, signal);\n\t\t}\n\t\tif (this.runtime.attachState === AttachState.Attaching) {\n\t\t\t// blob upload is not supported in \"Attaching\" state\n\t\t\tthis.mc.logger.sendTelemetryEvent({ eventName: \"CreateBlobWhileAttaching\" });\n\t\t\tawait new Promise<void>((resolve) => this.runtime.once(\"attached\", resolve));\n\t\t}\n\t\tassert(\n\t\t\tthis.runtime.attachState === AttachState.Attached,\n\t\t\t0x385 /* For clarity and paranoid defense against adding future attachment states */,\n\t\t);\n\n\t\treturn this.createBlobPayloadPending\n\t\t\t? this.createBlobWithPayloadPending(blob, signal)\n\t\t\t: this.createBlobLegacy(blob, signal);\n\t}\n\n\tprivate async createBlobDetached(\n\t\tblob: ArrayBufferLike,\n\t\tsignal?: AbortSignal,\n\t): Promise<IFluidHandleInternalPayloadPending<ArrayBufferLike>> {\n\t\tif (signal?.aborted === true) {\n\t\t\tthrow createAbortError();\n\t\t}\n\t\tconst localId = uuid();\n\t\tthis.localBlobCache.set(localId, { state: \"uploading\", blob });\n\t\t// Blobs created while the container is detached are stored in IDetachedBlobStorage.\n\t\t// The 'IContainerStorageService.createBlob()' call below will respond with a pseudo storage ID.\n\t\t// That pseudo storage ID will be replaced with the real storage ID at attach time.\n\t\tconst { id: detachedStorageId } = await this.storage.createBlob(blob);\n\t\t// From the perspective of the BlobManager, the blob is now fully attached. The actual\n\t\t// upload/attach process at container attach time is treated as opaque to this tracking.\n\t\tthis.localBlobCache.set(localId, { state: \"attached\", blob });\n\t\tthis.redirectTable.set(localId, detachedStorageId);\n\t\treturn this.getNonPayloadPendingBlobHandle(localId);\n\t}\n\n\tprivate async createBlobLegacy(\n\t\tblob: ArrayBufferLike,\n\t\tsignal?: AbortSignal,\n\t): Promise<IFluidHandleInternalPayloadPending<ArrayBufferLike>> {\n\t\tconst localId = uuid();\n\t\tthis.localBlobCache.set(localId, { state: \"localOnly\", blob });\n\t\tawait this.uploadAndAttach(localId, signal);\n\t\treturn this.getNonPayloadPendingBlobHandle(localId);\n\t}\n\n\tprivate createBlobWithPayloadPending(\n\t\tblob: ArrayBufferLike,\n\t\tsignal?: AbortSignal,\n\t): IFluidHandleInternalPayloadPending<ArrayBufferLike> {\n\t\tconst localId = uuid();\n\t\tthis.localBlobCache.set(localId, { state: \"localOnly\", blob });\n\n\t\tconst blobHandle = new BlobHandle(\n\t\t\tgetGCNodePathFromLocalId(localId),\n\t\t\tthis.routeContext,\n\t\t\tasync () => blob,\n\t\t\ttrue, // payloadPending\n\t\t\t() => {\n\t\t\t\tthis.pendingBlobsWithAttachedHandles.add(localId);\n\t\t\t\tconst uploadAndAttachP = this.uploadAndAttach(localId, signal);\n\t\t\t\tuploadAndAttachP.then(blobHandle.notifyShared).catch((error) => {\n\t\t\t\t\t// TODO: notifyShared won't fail directly, but it emits an event to the customer.\n\t\t\t\t\t// Consider what to do if the customer's code throws. reportError is nice.\n\t\t\t\t});\n\t\t\t\tuploadAndAttachP.catch(blobHandle.notifyFailed);\n\t\t\t},\n\t\t);\n\n\t\treturn blobHandle;\n\t}\n\n\t/**\n\t * Upload and attach the localBlobCache entry for the given localId.\n\t *\n\t * Expects the localBlobCache entry for the given localId to be in either localOnly or uploaded state\n\t * when called. Returns a promise that resolves when the blob completes uploading and attaching, or else\n\t * rejects if an error is encountered or the signal is aborted.\n\t */\n\tprivate readonly uploadAndAttach = async (\n\t\tlocalId: string,\n\t\tsignal?: AbortSignal,\n\t): Promise<void> => {\n\t\tif (signal?.aborted === true) {\n\t\t\tthis.localBlobCache.delete(localId);\n\t\t\tthis.pendingBlobsWithAttachedHandles.delete(localId);\n\t\t\tthrow createAbortError();\n\t\t}\n\t\tconst localBlobRecordInitial = this.localBlobCache.get(localId);\n\t\tassert(\n\t\t\tlocalBlobRecordInitial?.state === \"localOnly\" ||\n\t\t\t\tlocalBlobRecordInitial?.state === \"uploaded\",\n\t\t\t0xc80 /* Expect uploadAndAttach to be called with either localOnly or uploaded state */,\n\t\t);\n\t\tconst { blob } = localBlobRecordInitial;\n\n\t\t/**\n\t\t * Expects the localBlobCache entry for the given localId to be in either localOnly or uploaded state\n\t\t * when called. Returns a promise that resolves when the blob is in uploaded or attached state, or else\n\t\t * rejects on error during upload or if the signal is aborted.\n\t\t *\n\t\t * Most of the time this should be expected to exit in uploaded state, but if we are loading from pending\n\t\t * state we may see an attach message from the client that generated the pending state, which can complete the\n\t\t * attach while the upload is outstanding.\n\t\t */\n\t\tconst ensureUploaded = async (): Promise<void> => {\n\t\t\tconst localBlobRecord = this.localBlobCache.get(localId);\n\t\t\tif (localBlobRecord?.state === \"uploaded\") {\n\t\t\t\t// In normal creation flows, the blob will be in localOnly state here. But in the case of loading\n\t\t\t\t// with pending state we can call it with an uploaded-but-not-attached blob. Start the upload\n\t\t\t\t// flow only if it's localOnly.\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tassert(\n\t\t\t\tlocalBlobRecord?.state === \"localOnly\",\n\t\t\t\t0xc81 /* Attempting to upload from unexpected state */,\n\t\t\t);\n\n\t\t\tthis.localBlobCache.set(localId, { state: \"uploading\", blob });\n\t\t\tawait new Promise<void>((resolve, reject) => {\n\t\t\t\t// If we eventually have driver-level support for abort, then this can simplify a bit as we won't\n\t\t\t\t// need to track upload completion and abort separately. Until then, we need to handle the case that\n\t\t\t\t// the upload continues and settles after becoming irrelevant due to signal abort or blob attach.\n\t\t\t\tlet uploadHasBecomeIrrelevant = false;\n\t\t\t\tconst onSignalAbort = (): void => {\n\t\t\t\t\tremoveListeners();\n\t\t\t\t\tuploadHasBecomeIrrelevant = true;\n\t\t\t\t\tthis.localBlobCache.delete(localId);\n\t\t\t\t\tthis.pendingBlobsWithAttachedHandles.delete(localId);\n\t\t\t\t\treject(createAbortError());\n\t\t\t\t};\n\t\t\t\tconst onProcessedBlobAttach = (_localId: string, _storageId: string): void => {\n\t\t\t\t\tif (_localId === localId) {\n\t\t\t\t\t\tremoveListeners();\n\t\t\t\t\t\tuploadHasBecomeIrrelevant = true;\n\t\t\t\t\t\tresolve();\n\t\t\t\t\t}\n\t\t\t\t};\n\t\t\t\tconst removeListeners = (): void => {\n\t\t\t\t\tthis.internalEvents.off(\"processedBlobAttach\", onProcessedBlobAttach);\n\t\t\t\t\tsignal?.removeEventListener(\"abort\", onSignalAbort);\n\t\t\t\t};\n\t\t\t\tthis.internalEvents.on(\"processedBlobAttach\", onProcessedBlobAttach);\n\t\t\t\tsignal?.addEventListener(\"abort\", onSignalAbort);\n\n\t\t\t\tthis.storage\n\t\t\t\t\t.createBlob(blob)\n\t\t\t\t\t.then((createBlobResponse: ICreateBlobResponseWithTTL) => {\n\t\t\t\t\t\tif (!uploadHasBecomeIrrelevant) {\n\t\t\t\t\t\t\tremoveListeners();\n\t\t\t\t\t\t\tthis.localBlobCache.set(localId, {\n\t\t\t\t\t\t\t\tstate: \"uploaded\",\n\t\t\t\t\t\t\t\tblob,\n\t\t\t\t\t\t\t\tstorageId: createBlobResponse.id,\n\t\t\t\t\t\t\t\tuploadTime: Date.now(),\n\t\t\t\t\t\t\t\tminTTLInSeconds: createBlobResponse.minTTLInSeconds,\n\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\tresolve();\n\t\t\t\t\t\t}\n\t\t\t\t\t})\n\t\t\t\t\t.catch((error) => {\n\t\t\t\t\t\tif (!uploadHasBecomeIrrelevant) {\n\t\t\t\t\t\t\tremoveListeners();\n\t\t\t\t\t\t\t// If the storage call errors, we can't recover. Reject to throw back to the caller.\n\t\t\t\t\t\t\tthis.localBlobCache.delete(localId);\n\t\t\t\t\t\t\tthis.pendingBlobsWithAttachedHandles.delete(localId);\n\t\t\t\t\t\t\t// eslint-disable-next-line @typescript-eslint/prefer-promise-reject-errors\n\t\t\t\t\t\t\treject(error);\n\t\t\t\t\t\t}\n\t\t\t\t\t});\n\t\t\t});\n\t\t};\n\n\t\t/**\n\t\t * Expects the localBlobCache entry for the given localId to be in uploaded or attached state when called.\n\t\t * Returns a promise that resolves to true if the blob is successfully attached, or false if it cannot be\n\t\t * attached and the upload flow needs to be restarted from the top (currently only if the TTL expires before\n\t\t * attach can be completed). In the latter case, the localBlobRecord will also be reset to localOnly state.\n\t\t * The promise rejects if the signal is aborted.\n\t\t */\n\t\tconst tryAttach = async (): Promise<boolean> => {\n\t\t\tconst localBlobRecord = this.localBlobCache.get(localId);\n\t\t\tif (localBlobRecord?.state === \"attached\") {\n\t\t\t\t// In normal creation flows, the blob will be in uploaded state here. But if we are loading from pending\n\t\t\t\t// state and see an attach message from the client that generated the pending state, we may have reached\n\t\t\t\t// attached state in the middle of the upload attempt. In that case there's no more work to do and we\n\t\t\t\t// can just return.\n\t\t\t\treturn true;\n\t\t\t}\n\t\t\tassert(\n\t\t\t\tlocalBlobRecord?.state === \"uploaded\",\n\t\t\t\t0xc82 /* Attempting to attach from unexpected state */,\n\t\t\t);\n\n\t\t\t// If we just uploaded the blob TTL really shouldn't be expired at this location. But if we loaded from\n\t\t\t// pending state, the upload may have happened some time far in the past and could be expired here.\n\t\t\tif (isTTLTooCloseToExpiry(localBlobRecord)) {\n\t\t\t\t// If the TTL is expired, we assume it's gone from the storage and so is effectively localOnly again.\n\t\t\t\t// Then when we re-enter the loop, we'll re-upload it.\n\t\t\t\tthis.localBlobCache.set(localId, { state: \"localOnly\", blob });\n\t\t\t\t// Emitting here isn't really necessary since the only listener would be attached below. Including here\n\t\t\t\t// for completeness though, in case we add other listeners in the future.\n\t\t\t\tthis.internalEvents.emit(\"blobExpired\", localId);\n\t\t\t\treturn false;\n\t\t\t} else {\n\t\t\t\tthis.localBlobCache.set(localId, {\n\t\t\t\t\t...localBlobRecord,\n\t\t\t\t\tstate: \"attaching\",\n\t\t\t\t});\n\n\t\t\t\t// Send and await a blob attach op. This serves two purposes:\n\t\t\t\t// 1. If its a new blob, i.e., it isn't de-duped, the server will keep the blob alive if it sees this op\n\t\t\t\t//    until its storage ID is added to the next summary.\n\t\t\t\t// 2. It will create a local ID to storage ID mapping in all clients which is needed to retrieve the\n\t\t\t\t//    blob from the server via the storage ID.\n\t\t\t\treturn new Promise<boolean>((resolve, reject) => {\n\t\t\t\t\tconst onProcessedBlobAttach = (_localId: string, _storageId: string): void => {\n\t\t\t\t\t\tif (_localId === localId) {\n\t\t\t\t\t\t\tremoveListeners();\n\t\t\t\t\t\t\tresolve(true);\n\t\t\t\t\t\t}\n\t\t\t\t\t};\n\t\t\t\t\t// Although we already checked for TTL expiry above, the message we're about to send may later be asked\n\t\t\t\t\t// to resubmit. Before we resubmit, we check again for TTL expiry - this listener is how we learn if\n\t\t\t\t\t// we discovered expiry in the resubmit flow.\n\t\t\t\t\tconst onBlobExpired = (_localId: string): void => {\n\t\t\t\t\t\tif (_localId === localId) {\n\t\t\t\t\t\t\tremoveListeners();\n\t\t\t\t\t\t\tresolve(false);\n\t\t\t\t\t\t}\n\t\t\t\t\t};\n\t\t\t\t\tconst onSignalAbort = (): void => {\n\t\t\t\t\t\tremoveListeners();\n\t\t\t\t\t\tthis.localBlobCache.delete(localId);\n\t\t\t\t\t\tthis.pendingBlobsWithAttachedHandles.delete(localId);\n\t\t\t\t\t\treject(createAbortError());\n\t\t\t\t\t};\n\t\t\t\t\tconst removeListeners = (): void => {\n\t\t\t\t\t\tthis.internalEvents.off(\"processedBlobAttach\", onProcessedBlobAttach);\n\t\t\t\t\t\tthis.internalEvents.off(\"blobExpired\", onBlobExpired);\n\t\t\t\t\t\tsignal?.removeEventListener(\"abort\", onSignalAbort);\n\t\t\t\t\t};\n\n\t\t\t\t\tthis.internalEvents.on(\"processedBlobAttach\", onProcessedBlobAttach);\n\t\t\t\t\tthis.internalEvents.on(\"blobExpired\", onBlobExpired);\n\t\t\t\t\tsignal?.addEventListener(\"abort\", onSignalAbort);\n\t\t\t\t\tthis.sendBlobAttachMessage(localId, localBlobRecord.storageId);\n\t\t\t\t});\n\t\t\t}\n\t\t};\n\n\t\tlet attachCompleted = false;\n\t\twhile (!attachCompleted) {\n\t\t\tawait ensureUploaded();\n\t\t\tattachCompleted = await tryAttach();\n\n\t\t\t// If something stopped the attach from completing successfully (currently just TTL expiry),\n\t\t\t// we expect that the blob was already updated to reflect the updated state (i.e. back to localOnly)\n\t\t\t// and we'll try the loop again from the top.\n\t\t}\n\t\t// When the blob successfully attaches, the localBlobRecord will have been updated to attached state\n\t\t// at the time we processed the op, so there's nothing else to do here.\n\t};\n\n\t/**\n\t * Resubmit a BlobAttach op. Used to add storage IDs to messages that were\n\t * submitted to runtime while disconnected.\n\t * @param metadata - message metadata containing storage and/or local IDs\n\t */\n\tpublic reSubmit(metadata: Record<string, unknown> | undefined): void {\n\t\tassert(isBlobMetadata(metadata), 0xc01 /* Expected blob metadata for a BlobAttach op */);\n\t\tconst { localId, blobId: storageId } = metadata;\n\t\t// Any blob that we're actively trying to advance to attached state must be in attaching state.\n\t\t// Decline to resubmit for anything else.\n\t\t// For example, we might be asked to resubmit stashed messages for blobs that never had their handle\n\t\t// attached - these won't have a localBlobCache entry because we filter them out when generating\n\t\t// pending state. We shouldn't try to attach them since they won't be accessible to the customer\n\t\t// and would just be considered garbage immediately.\n\t\t// TODO: Is it possible that we'd be asked to resubmit for a pending blob before we call sharePendingBlobs?\n\t\tconst localBlobRecord = this.localBlobCache.get(localId);\n\t\tif (localBlobRecord?.state === \"attaching\") {\n\t\t\t// If the TTL is expired, we assume it's gone from the storage and so is effectively localOnly again.\n\t\t\tif (isTTLTooCloseToExpiry(localBlobRecord)) {\n\t\t\t\tthis.localBlobCache.set(localId, { state: \"localOnly\", blob: localBlobRecord.blob });\n\t\t\t\tthis.internalEvents.emit(\"blobExpired\", localId);\n\t\t\t} else {\n\t\t\t\tthis.sendBlobAttachMessage(localId, storageId);\n\t\t\t}\n\t\t}\n\t}\n\n\tpublic processBlobAttachMessage(message: ISequencedMessageEnvelope, local: boolean): void {\n\t\tassert(\n\t\t\tisBlobMetadata(message.metadata),\n\t\t\t0xc02 /* Expected blob metadata for a BlobAttach op */,\n\t\t);\n\t\tconst { localId, blobId: storageId } = message.metadata;\n\t\tconst maybeLocalBlobRecord = this.localBlobCache.get(localId);\n\t\tif (maybeLocalBlobRecord !== undefined) {\n\t\t\tconst attachedBlobRecord: AttachedBlob = {\n\t\t\t\tstate: \"attached\",\n\t\t\t\tblob: maybeLocalBlobRecord.blob,\n\t\t\t};\n\t\t\t// Processing a blob attach message is authoritative and may stomp on any existing state. Other\n\t\t\t// callsites that update localBlobCache entries must take proper caution to handle the case\n\t\t\t// that a blob attach message is processed concurrently.\n\t\t\tthis.localBlobCache.set(localId, attachedBlobRecord);\n\t\t\t// Note there may or may not be an entry in pendingBlobsWithAttachedHandles for this localId,\n\t\t\t// in particular for the non-payloadPending case since we should be reaching this point\n\t\t\t// before even returning a handle to the caller.\n\t\t\tthis.pendingBlobsWithAttachedHandles.delete(localId);\n\t\t\tthis.pendingOnlyLocalIds.delete(localId);\n\t\t}\n\t\tthis.redirectTable.set(localId, storageId);\n\t\t// set identity (id -> id) entry\n\t\tthis.redirectTable.set(storageId, storageId);\n\t\tthis.internalEvents.emit(\"processedBlobAttach\", localId, storageId);\n\t}\n\n\tpublic summarize(telemetryContext?: ITelemetryContext): ISummaryTreeWithStats {\n\t\treturn summarizeBlobManagerState(this.redirectTable);\n\t}\n\n\t/**\n\t * Generates data used for garbage collection. Each blob uploaded represents a node in the GC graph as it can be\n\t * individually referenced by storing its handle in a referenced DDS. Returns the list of blob ids as GC nodes.\n\t * @param fullGC - true to bypass optimizations and force full generation of GC data. BlobManager doesn't care\n\t * about this for now because the data is a simple list of blob ids.\n\t */\n\tpublic getGCData(fullGC: boolean = false): IGarbageCollectionData {\n\t\tconst gcData: IGarbageCollectionData = { gcNodes: {} };\n\t\tfor (const [localId, storageId] of this.redirectTable) {\n\t\t\t// Don't report the identity mappings to GC - these exist to service old handles that referenced the storage\n\t\t\t// IDs directly. We'll implicitly clean them up if all of their localId references get GC'd first.\n\t\t\tif (localId !== storageId) {\n\t\t\t\t// The outbound routes are empty because a blob node cannot reference other nodes. It can only be referenced\n\t\t\t\t// by adding its handle to a referenced DDS.\n\t\t\t\tgcData.gcNodes[getGCNodePathFromLocalId(localId)] = [];\n\t\t\t}\n\t\t}\n\t\treturn gcData;\n\t}\n\n\t/**\n\t * Delete blobs with the given routes from the redirect table.\n\t * @returns The routes of blobs that were deleted.\n\t *\n\t * @remarks\n\t * The routes are GC nodes paths of format -`/<blobManagerBasePath>/<localId>`.\n\t * Deleting the blobs involves 2 steps:\n\t *\n\t * 1. The redirect table entry for the local ids are deleted.\n\t *\n\t * 2. If the storage ids corresponding to the deleted local ids are not referenced by any further local ids, the\n\t * identity mappings in the redirect table are deleted as well.\n\t *\n\t * Note that this does not delete the blobs from storage service immediately. Deleting the blobs from redirect table\n\t * will ensure we don't create an attachment blob for them at the next summary. The service would then delete them\n\t * some time in the future.\n\t */\n\tpublic deleteSweepReadyNodes(sweepReadyBlobRoutes: readonly string[]): readonly string[] {\n\t\t// maybeUnusedStorageIds is used to compute the set of storage IDs that *used to have a local ID*, but that\n\t\t// local ID is being deleted.\n\t\tconst maybeUnusedStorageIds: Set<string> = new Set();\n\t\tfor (const route of sweepReadyBlobRoutes) {\n\t\t\tconst localId = getLocalIdFromGCNodePath(route);\n\t\t\t// If the blob hasn't already been deleted, log an error because this should never happen.\n\t\t\t// If the blob has already been deleted, log a telemetry event. This can happen because multiple GC\n\t\t\t// sweep messages can contain the same data store. It would be interesting to track how often this happens.\n\t\t\tconst alreadyDeleted = this.isBlobDeleted(route);\n\t\t\tconst storageId = this.redirectTable.get(localId);\n\t\t\tif (storageId === undefined) {\n\t\t\t\tthis.mc.logger.sendTelemetryEvent({\n\t\t\t\t\teventName: \"DeletedAttachmentBlobNotFound\",\n\t\t\t\t\tcategory: alreadyDeleted ? \"generic\" : \"error\",\n\t\t\t\t\tblobId: localId,\n\t\t\t\t\tdetails: { alreadyDeleted },\n\t\t\t\t});\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tmaybeUnusedStorageIds.add(storageId);\n\t\t\tthis.redirectTable.delete(localId);\n\t\t}\n\n\t\t// Remove any storage IDs that still have local IDs referring to them (excluding the identity mapping).\n\t\tfor (const [localId, storageId] of this.redirectTable) {\n\t\t\tif (localId !== storageId) {\n\t\t\t\tmaybeUnusedStorageIds.delete(storageId);\n\t\t\t}\n\t\t}\n\n\t\t// Now delete any identity mappings (storage ID -> storage ID) from the redirect table that used to be\n\t\t// referenced by a distinct local ID. This way they'll be absent from the next summary, and the service\n\t\t// is free to delete them from storage.\n\t\t// WARNING: This can potentially delete identity mappings that are still referenced, if storage deduping\n\t\t// has let us add a local ID -> storage ID mapping that is later deleted.  AB#47337 tracks this issue\n\t\t// and possible solutions.\n\t\tfor (const storageId of maybeUnusedStorageIds) {\n\t\t\tthis.redirectTable.delete(storageId);\n\t\t}\n\t\treturn [...sweepReadyBlobRoutes];\n\t}\n\n\t/**\n\t * Verifies that the blob with given id is not deleted, i.e., it has not been garbage collected. If the blob is GC'd,\n\t * log an error and throw if necessary.\n\t */\n\tprivate verifyBlobNotDeleted(localId: string): void {\n\t\tif (!this.isBlobDeleted(getGCNodePathFromLocalId(localId))) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst request = { url: localId };\n\t\tconst error = responseToException(\n\t\t\tcreateResponseError(404, `Blob was deleted`, request),\n\t\t\trequest,\n\t\t);\n\t\t// Only log deleted events. Tombstone events are logged by garbage collector.\n\t\tthis.mc.logger.sendErrorEvent(\n\t\t\t{\n\t\t\t\teventName: \"GC_Deleted_Blob_Requested\",\n\t\t\t\tpkg: blobManagerBasePath,\n\t\t\t},\n\t\t\terror,\n\t\t);\n\t\tthrow error;\n\t}\n\n\t/**\n\t * Called in detached state just prior to attaching, this will update the redirect table by\n\t * converting the pseudo storage IDs into real storage IDs using the provided detachedStorageTable.\n\t * The provided table must have exactly the same set of pseudo storage IDs as are found in the redirect table.\n\t * @param detachedStorageTable - A map of pseudo storage IDs to real storage IDs.\n\t */\n\tpublic readonly patchRedirectTable = (detachedStorageTable: Map<string, string>): void => {\n\t\tassert(\n\t\t\tthis.runtime.attachState === AttachState.Detached,\n\t\t\t0x252 /* \"redirect table can only be set in detached container\" */,\n\t\t);\n\t\t// The values of the redirect table are the pseudo storage IDs, which are the keys of the\n\t\t// detachedStorageTable. We expect to have a many:1 mapping from local IDs to pseudo\n\t\t// storage IDs (many in the case that the storage dedupes the blob).\n\t\tassert(\n\t\t\tnew Set(this.redirectTable.values()).size === detachedStorageTable.size,\n\t\t\t0x391 /* Redirect table size must match BlobManager's local ID count */,\n\t\t);\n\t\t// Taking a snapshot of the redirect table entries before iterating, because\n\t\t// we will be adding identity mappings to the the redirect table as we iterate\n\t\t// and we don't want to include those in the iteration.\n\t\tconst redirectTableEntries = [...this.redirectTable.entries()];\n\t\tfor (const [localId, detachedStorageId] of redirectTableEntries) {\n\t\t\tconst newStorageId = detachedStorageTable.get(detachedStorageId);\n\t\t\tassert(newStorageId !== undefined, 0xc53 /* Couldn't find a matching storage ID */);\n\t\t\tthis.redirectTable.set(localId, newStorageId);\n\t\t\t// set identity (id -> id) entry\n\t\t\tthis.redirectTable.set(newStorageId, newStorageId);\n\t\t}\n\t};\n\n\t/**\n\t * Upload and attach any pending blobs that the BlobManager was loaded with that have not already\n\t * been attached in the meantime.\n\t * @returns A promise that resolves when all the uploads and attaches have completed, or rejects\n\t * if any of them fail.\n\t */\n\tpublic readonly sharePendingBlobs = async (): Promise<void> => {\n\t\tconst localIdsToUpload = [...this.pendingOnlyLocalIds];\n\t\tthis.pendingOnlyLocalIds.clear();\n\t\tawait Promise.all<void>(\n\t\t\tlocalIdsToUpload.map(async (localId) => this.uploadAndAttach(localId)),\n\t\t);\n\t};\n\n\t/**\n\t * To be used in getPendingLocalState flow. Get a serializable record of the blobs that are\n\t * pending upload and/or their BlobAttach op, which can be given to a new BlobManager to\n\t * resume work.\n\t */\n\tpublic getPendingBlobs(): IPendingBlobs | undefined {\n\t\tconst pendingBlobs: IPendingBlobs = {};\n\t\tfor (const localId of this.pendingBlobsWithAttachedHandles) {\n\t\t\tconst localBlobRecord = this.localBlobCache.get(localId);\n\t\t\tassert(localBlobRecord !== undefined, 0xc83 /* Pending blob must be in local cache */);\n\t\t\tassert(\n\t\t\t\tlocalBlobRecord.state !== \"attached\",\n\t\t\t\t0xc84 /* Pending blob must not be in attached state */,\n\t\t\t);\n\t\t\t// We downgrade uploading blobs to localOnly, and attaching blobs to uploaded. In the case of\n\t\t\t// uploading blobs, we don't have a way to retrieve the eventual storageId so the upload will\n\t\t\t// need to be restarted anyway. In the case of attaching blobs, we can't know whether the\n\t\t\t// BlobAttach message will eventually be ack'd. So we assume we'll need to send another message, but also\n\t\t\t// remain prepared to handle seeing the ack of the original message after loading from pending state.\n\t\t\tpendingBlobs[localId] =\n\t\t\t\tlocalBlobRecord.state === \"localOnly\" || localBlobRecord.state === \"uploading\"\n\t\t\t\t\t? {\n\t\t\t\t\t\t\tstate: \"localOnly\",\n\t\t\t\t\t\t\tblob: bufferToString(localBlobRecord.blob, \"base64\"),\n\t\t\t\t\t\t}\n\t\t\t\t\t: {\n\t\t\t\t\t\t\t...localBlobRecord,\n\t\t\t\t\t\t\tstate: \"uploaded\",\n\t\t\t\t\t\t\tblob: bufferToString(localBlobRecord.blob, \"base64\"),\n\t\t\t\t\t\t};\n\t\t}\n\t\treturn Object.keys(pendingBlobs).length > 0 ? pendingBlobs : undefined;\n\t}\n}\n\n/**\n * For a localId, returns its path in GC's graph. The node path is of the format `/<blobManagerBasePath>/<localId>`.\n * This path must match the path of the blob handle returned by the createBlob API because blobs are marked\n * referenced by storing these handles in a referenced DDS.\n */\nexport const getGCNodePathFromLocalId = (localId: string): string =>\n\t`/${blobManagerBasePath}/${localId}`;\n\n/**\n * For a given GC node path, return the localId. The node path is of the format `/<basePath>/<localId>`.\n */\nconst getLocalIdFromGCNodePath = (nodePath: string): string => {\n\tconst pathParts = nodePath.split(\"/\");\n\tassert(areBlobPathParts(pathParts), 0x5bd /* Invalid blob node path */);\n\treturn pathParts[2];\n};\n\n/**\n * Returns whether a given path is for attachment blobs that are in the format - \"/blobManagerBasePath/...\".\n */\nexport const isBlobPath = (path: string): path is `/${typeof blobManagerBasePath}/${string}` =>\n\tareBlobPathParts(path.split(\"/\"));\n\nconst areBlobPathParts = (\n\tpathParts: string[],\n): pathParts is [\"\", typeof blobManagerBasePath, string] =>\n\tpathParts.length === 3 && pathParts[1] === blobManagerBasePath;\n"]}

package/lib/blobManager/blobManagerSnapSum.d.ts

@@ -13,6 +13,9 @@ export interface IBlobManagerLoadInfo {
     ids?: string[];
     redirectTable?: [string, string][];
 }
+/**
+ * @internal
+ */
 export declare const redirectTableBlobName = ".redirectTable";
 /**
  * @internal

package/lib/blobManager/blobManagerSnapSum.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"blobManagerSnapSum.d.ts","sourceRoot":"","sources":["../../src/blobManager/blobManagerSnapSum.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AAExF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8CAA8C,CAAC;AAE1F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AAEpF;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACpC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;CACnC;AAED,eAAO,MAAM,qBAAqB,mBAAmB,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,aAAa,WAAW,CAAC;AAEtC;;;GAGG;AACH,eAAO,MAAM,uBAAuB,YAC1B,KAAK,iBAAiB,EAAE,cAAc,GAAG,SAAS,GAAG,aAAa,CAAC,KAC1E,QAAQ,oBAAoB,CAAoB,CAAC;AAsBpD,eAAO,MAAM,eAAe,wBACN,oBAAoB,UACjC,mBAAmB,KACzB,IAAI,MAAM,EAAE,MAAM,CAkBpB,CAAC;AAEF,eAAO,MAAM,yBAAyB,kBACtB,IAAI,MAAM,EAAE,MAAM,CAAC,KAChC,qBAAmD,CAAC;AA0BvD,eAAO,MAAM,aAAa,kBAAmB,IAAI,MAAM,EAAE,MAAM,CAAC,KAAG,IAAI,MAAM,CAE5E,CAAC"}
+{"version":3,"file":"blobManagerSnapSum.d.ts","sourceRoot":"","sources":["../../src/blobManager/blobManagerSnapSum.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AAExF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8CAA8C,CAAC;AAE1F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AAEpF;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACpC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;CACnC;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,mBAAmB,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,aAAa,WAAW,CAAC;AAEtC;;;GAGG;AACH,eAAO,MAAM,uBAAuB,YAC1B,KAAK,iBAAiB,EAAE,cAAc,GAAG,SAAS,GAAG,aAAa,CAAC,KAC1E,QAAQ,oBAAoB,CAAoB,CAAC;AAsBpD,eAAO,MAAM,eAAe,wBACN,oBAAoB,UACjC,mBAAmB,KACzB,IAAI,MAAM,EAAE,MAAM,CAsBpB,CAAC;AAEF,eAAO,MAAM,yBAAyB,kBACtB,IAAI,MAAM,EAAE,MAAM,CAAC,KAChC,qBAAmD,CAAC;AA0BvD,eAAO,MAAM,aAAa,kBAAmB,IAAI,MAAM,EAAE,MAAM,CAAC,KAAG,IAAI,MAAM,CAE5E,CAAC"}

package/lib/blobManager/blobManagerSnapSum.js

@@ -4,6 +4,9 @@
  */
 import { readAndParse } from "@fluidframework/driver-utils/internal";
 import { SummaryTreeBuilder } from "@fluidframework/runtime-utils/internal";
+/**
+ * @internal
+ */
 export const redirectTableBlobName = ".redirectTable";
 /**
  * @internal
@@ -30,11 +33,15 @@ const loadV1 = async (context) => {
     return { ids, redirectTable: redirectTableEntries };
 };
 export const toRedirectTable = (blobManagerLoadInfo, logger) => {
-    logger.sendTelemetryEvent({
-        eventName: "AttachmentBlobsLoaded",
-        count: blobManagerLoadInfo.ids?.length ?? 0,
-        redirectTable: blobManagerLoadInfo.redirectTable?.length,
-    });
+    const count = blobManagerLoadInfo.ids?.length ?? 0;
+    const redirectTableLength = blobManagerLoadInfo.redirectTable?.length ?? 0;
+    if (count > 0 || redirectTableLength > 0) {
+        logger.sendTelemetryEvent({
+            eventName: "AttachmentBlobsLoaded",
+            count,
+            redirectTable: redirectTableLength,
+        });
+    }
     const redirectTable = new Map(blobManagerLoadInfo.redirectTable);
     if (blobManagerLoadInfo.ids !== undefined) {
         for (const storageId of blobManagerLoadInfo.ids) {

package/lib/blobManager/blobManagerSnapSum.js.map

@@ -1 +1 @@
-{"version":3,"file":"blobManagerSnapSum.js","sourceRoot":"","sources":["../../src/blobManager/blobManagerSnapSum.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 type { IContainerContext } from \"@fluidframework/container-definitions/internal\";\nimport { readAndParse } from \"@fluidframework/driver-utils/internal\";\nimport type { ISummaryTreeWithStats } from \"@fluidframework/runtime-definitions/internal\";\nimport { SummaryTreeBuilder } from \"@fluidframework/runtime-utils/internal\";\nimport type { ITelemetryLoggerExt } from \"@fluidframework/telemetry-utils/internal\";\n\n/**\n * Information from a snapshot needed to load BlobManager\n * @internal\n */\nexport interface IBlobManagerLoadInfo {\n\tids?: string[];\n\tredirectTable?: [string, string][];\n}\n\nexport const redirectTableBlobName = \".redirectTable\";\n\n/**\n * @internal\n */\nexport const blobsTreeName = \".blobs\";\n\n/**\n * Reads blobs needed to load BlobManager from storage.\n *\n */\nexport const loadBlobManagerLoadInfo = async (\n\tcontext: Pick<IContainerContext, \"baseSnapshot\" | \"storage\" | \"attachState\">,\n): Promise<IBlobManagerLoadInfo> => loadV1(context);\n\nconst loadV1 = async (\n\tcontext: Pick<IContainerContext, \"baseSnapshot\" | \"storage\" | \"attachState\">,\n): Promise<IBlobManagerLoadInfo> => {\n\tconst blobsTree = context.baseSnapshot?.trees[blobsTreeName];\n\n\tif (!blobsTree) {\n\t\treturn {};\n\t}\n\tlet redirectTableEntries: [string, string][] = [];\n\tconst tableId: string | undefined = blobsTree.blobs[redirectTableBlobName];\n\tif (tableId) {\n\t\tredirectTableEntries = await readAndParse(context.storage, tableId);\n\t}\n\tconst ids = Object.entries(blobsTree.blobs)\n\t\t.filter(([k, _]) => k !== redirectTableBlobName)\n\t\t.map(([_, v]) => v);\n\n\treturn { ids, redirectTable: redirectTableEntries };\n};\n\nexport const toRedirectTable = (\n\tblobManagerLoadInfo: IBlobManagerLoadInfo,\n\tlogger: ITelemetryLoggerExt,\n): Map<string, string> => {\n\tlogger.sendTelemetryEvent({\n\t\teventName: \"AttachmentBlobsLoaded\",\n\t\tcount: blobManagerLoadInfo.ids?.length ?? 0,\n\t\tredirectTable: blobManagerLoadInfo.redirectTable?.length,\n\t});\n\tconst redirectTable = new Map<string, string>(blobManagerLoadInfo.redirectTable);\n\tif (blobManagerLoadInfo.ids !== undefined) {\n\t\tfor (const storageId of blobManagerLoadInfo.ids) {\n\t\t\t// Older versions of the runtime used the storage ID directly in the handle,\n\t\t\t// rather than routing through the redirectTable. To support old handles that\n\t\t\t// were created in this way but unify handling through the redirectTable, we\n\t\t\t// add identity mappings to the redirect table at load. These identity entries\n\t\t\t// will be excluded during summarization.\n\t\t\tredirectTable.set(storageId, storageId);\n\t\t}\n\t}\n\treturn redirectTable;\n};\n\nexport const summarizeBlobManagerState = (\n\tredirectTable: Map<string, string>,\n): ISummaryTreeWithStats => summarizeV1(redirectTable);\n\nconst summarizeV1 = (redirectTable: Map<string, string>): ISummaryTreeWithStats => {\n\tconst builder = new SummaryTreeBuilder();\n\tconst storageIds = getStorageIds(redirectTable);\n\tfor (const storageId of storageIds) {\n\t\t// The Attachment is inspectable by storage, which lets it detect that the blob is referenced\n\t\t// and therefore should not be GC'd.\n\t\tbuilder.addAttachment(storageId);\n\t}\n\n\t// Exclude identity mappings from the redirectTable summary. Note that\n\t// the storageIds of the identity mappings are still included in the Attachments\n\t// above, so we expect these identity mappings will be recreated at load\n\t// time in toRedirectTable even if there is no non-identity mapping in\n\t// the redirectTable.\n\tconst nonIdentityRedirectTableEntries = [...redirectTable.entries()].filter(\n\t\t([localId, storageId]) => localId !== storageId,\n\t);\n\tif (nonIdentityRedirectTableEntries.length > 0) {\n\t\tbuilder.addBlob(redirectTableBlobName, JSON.stringify(nonIdentityRedirectTableEntries));\n\t}\n\n\treturn builder.getSummaryTree();\n};\n\nexport const getStorageIds = (redirectTable: Map<string, string>): Set<string> => {\n\treturn new Set<string>(redirectTable.values());\n};\n"]}
+{"version":3,"file":"blobManagerSnapSum.js","sourceRoot":"","sources":["../../src/blobManager/blobManagerSnapSum.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 type { IContainerContext } from \"@fluidframework/container-definitions/internal\";\nimport { readAndParse } from \"@fluidframework/driver-utils/internal\";\nimport type { ISummaryTreeWithStats } from \"@fluidframework/runtime-definitions/internal\";\nimport { SummaryTreeBuilder } from \"@fluidframework/runtime-utils/internal\";\nimport type { ITelemetryLoggerExt } from \"@fluidframework/telemetry-utils/internal\";\n\n/**\n * Information from a snapshot needed to load BlobManager\n * @internal\n */\nexport interface IBlobManagerLoadInfo {\n\tids?: string[];\n\tredirectTable?: [string, string][];\n}\n\n/**\n * @internal\n */\nexport const redirectTableBlobName = \".redirectTable\";\n\n/**\n * @internal\n */\nexport const blobsTreeName = \".blobs\";\n\n/**\n * Reads blobs needed to load BlobManager from storage.\n *\n */\nexport const loadBlobManagerLoadInfo = async (\n\tcontext: Pick<IContainerContext, \"baseSnapshot\" | \"storage\" | \"attachState\">,\n): Promise<IBlobManagerLoadInfo> => loadV1(context);\n\nconst loadV1 = async (\n\tcontext: Pick<IContainerContext, \"baseSnapshot\" | \"storage\" | \"attachState\">,\n): Promise<IBlobManagerLoadInfo> => {\n\tconst blobsTree = context.baseSnapshot?.trees[blobsTreeName];\n\n\tif (!blobsTree) {\n\t\treturn {};\n\t}\n\tlet redirectTableEntries: [string, string][] = [];\n\tconst tableId: string | undefined = blobsTree.blobs[redirectTableBlobName];\n\tif (tableId) {\n\t\tredirectTableEntries = await readAndParse(context.storage, tableId);\n\t}\n\tconst ids = Object.entries(blobsTree.blobs)\n\t\t.filter(([k, _]) => k !== redirectTableBlobName)\n\t\t.map(([_, v]) => v);\n\n\treturn { ids, redirectTable: redirectTableEntries };\n};\n\nexport const toRedirectTable = (\n\tblobManagerLoadInfo: IBlobManagerLoadInfo,\n\tlogger: ITelemetryLoggerExt,\n): Map<string, string> => {\n\tconst count = blobManagerLoadInfo.ids?.length ?? 0;\n\tconst redirectTableLength = blobManagerLoadInfo.redirectTable?.length ?? 0;\n\tif (count > 0 || redirectTableLength > 0) {\n\t\tlogger.sendTelemetryEvent({\n\t\t\teventName: \"AttachmentBlobsLoaded\",\n\t\t\tcount,\n\t\t\tredirectTable: redirectTableLength,\n\t\t});\n\t}\n\tconst redirectTable = new Map<string, string>(blobManagerLoadInfo.redirectTable);\n\tif (blobManagerLoadInfo.ids !== undefined) {\n\t\tfor (const storageId of blobManagerLoadInfo.ids) {\n\t\t\t// Older versions of the runtime used the storage ID directly in the handle,\n\t\t\t// rather than routing through the redirectTable. To support old handles that\n\t\t\t// were created in this way but unify handling through the redirectTable, we\n\t\t\t// add identity mappings to the redirect table at load. These identity entries\n\t\t\t// will be excluded during summarization.\n\t\t\tredirectTable.set(storageId, storageId);\n\t\t}\n\t}\n\treturn redirectTable;\n};\n\nexport const summarizeBlobManagerState = (\n\tredirectTable: Map<string, string>,\n): ISummaryTreeWithStats => summarizeV1(redirectTable);\n\nconst summarizeV1 = (redirectTable: Map<string, string>): ISummaryTreeWithStats => {\n\tconst builder = new SummaryTreeBuilder();\n\tconst storageIds = getStorageIds(redirectTable);\n\tfor (const storageId of storageIds) {\n\t\t// The Attachment is inspectable by storage, which lets it detect that the blob is referenced\n\t\t// and therefore should not be GC'd.\n\t\tbuilder.addAttachment(storageId);\n\t}\n\n\t// Exclude identity mappings from the redirectTable summary. Note that\n\t// the storageIds of the identity mappings are still included in the Attachments\n\t// above, so we expect these identity mappings will be recreated at load\n\t// time in toRedirectTable even if there is no non-identity mapping in\n\t// the redirectTable.\n\tconst nonIdentityRedirectTableEntries = [...redirectTable.entries()].filter(\n\t\t([localId, storageId]) => localId !== storageId,\n\t);\n\tif (nonIdentityRedirectTableEntries.length > 0) {\n\t\tbuilder.addBlob(redirectTableBlobName, JSON.stringify(nonIdentityRedirectTableEntries));\n\t}\n\n\treturn builder.getSummaryTree();\n};\n\nexport const getStorageIds = (redirectTable: Map<string, string>): Set<string> => {\n\treturn new Set<string>(redirectTable.values());\n};\n"]}

package/lib/connectionTelemetry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connectionTelemetry.d.ts","sourceRoot":"","sources":["../src/connectionTelemetry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AACxF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wDAAwD,CAAC;AACtG,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAiB5F;;GAEG;AACH,eAAO,MAAM,gBAAgB,OAAO,CAAC;AA+arC;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACpC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,YAAY,EAAE,iBAAiB,EAC/B,sBAAsB,EAAE,cAAc,CAAC,uBAAuB,CAAC,EAC/D,MAAM,EAAE,oBAAoB,GAC1B,IAAI,CAON"}
+{"version":3,"file":"connectionTelemetry.d.ts","sourceRoot":"","sources":["../src/connectionTelemetry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AACxF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wDAAwD,CAAC;AACtG,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAkB5F;;GAEG;AACH,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAmbrC;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACpC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,YAAY,EAAE,iBAAiB,EAC/B,sBAAsB,EAAE,cAAc,CAAC,uBAAuB,CAAC,EAC/D,MAAM,EAAE,oBAAoB,GAC1B,IAAI,CAON"}

package/lib/connectionTelemetry.js

@@ -3,6 +3,7 @@
  * Licensed under the MIT License.
  */
 import { performanceNow } from "@fluid-internal/client-utils";
+import { LogLevel } from "@fluidframework/core-interfaces";
 import { assert } from "@fluidframework/core-utils/internal";
 import { MessageType, } from "@fluidframework/driver-definitions/internal";
 import { isRuntimeMessage } from "@fluidframework/driver-utils/internal";
@@ -184,7 +185,8 @@ class OpPerfTelemetry {
                 ? formatTick(this.connectionStartTime - this.bootTime)
                 : undefined,
             firstConnection: this.firstConnection,
-        });
+        }, undefined, // error
+        LogLevel.info);
     }
     recordPingTime(latency) {
         this.pingLatency = latency;