@fluidframework/runtime-definitions 2.0.0-rc.1.0.3 → 2.0.0-rc.2.0.0

package/dist/runtime-definitions-untrimmed.d.ts

@@ -1,39 +1,28 @@
-import { AttachState } from '@fluidframework/container-definitions';
-import { FluidObject } from '@fluidframework/core-interfaces';
-import { IAudience } from '@fluidframework/container-definitions';
-import { IClientDetails } from '@fluidframework/protocol-definitions';
-import { IdCompressor } from '@fluidframework/id-compressor';
-import { IdCreationRange } from '@fluidframework/id-compressor';
-import { IDeltaManager } from '@fluidframework/container-definitions';
-import { IDisposable } from '@fluidframework/core-interfaces';
-import { IDocumentMessage } from '@fluidframework/protocol-definitions';
-import { IDocumentStorageService } from '@fluidframework/driver-definitions';
-import { IEvent } from '@fluidframework/core-interfaces';
-import { IEventProvider } from '@fluidframework/core-interfaces';
-import { IFluidHandle } from '@fluidframework/core-interfaces';
-import { IIdCompressor } from '@fluidframework/id-compressor';
-import { IIdCompressorCore } from '@fluidframework/id-compressor';
-import { ILoaderOptions } from '@fluidframework/container-definitions';
-import { IProvideFluidHandleContext } from '@fluidframework/core-interfaces';
-import { IQuorumClients } from '@fluidframework/protocol-definitions';
-import { IRequest } from '@fluidframework/core-interfaces';
-import { IResponse } from '@fluidframework/core-interfaces';
-import { ISequencedDocumentMessage } from '@fluidframework/protocol-definitions';
-import { ISignalMessage } from '@fluidframework/protocol-definitions';
-import { ISnapshotTree } from '@fluidframework/protocol-definitions';
-import { ISummaryTree } from '@fluidframework/protocol-definitions';
-import { ITelemetryBaseLogger } from '@fluidframework/core-interfaces';
-import { ITree } from '@fluidframework/protocol-definitions';
+import type { AttachState } from '@fluidframework/container-definitions';
+import type { FluidObject } from '@fluidframework/core-interfaces';
+import type { IAudience } from '@fluidframework/container-definitions';
+import type { IClientDetails } from '@fluidframework/protocol-definitions';
+import type { IDeltaManager } from '@fluidframework/container-definitions';
+import type { IDisposable } from '@fluidframework/core-interfaces';
+import type { IDocumentMessage } from '@fluidframework/protocol-definitions';
+import type { IDocumentStorageService } from '@fluidframework/driver-definitions';
+import type { IEvent } from '@fluidframework/core-interfaces';
+import type { IEventProvider } from '@fluidframework/core-interfaces';
+import type { IFluidHandle } from '@fluidframework/core-interfaces';
+import type { IIdCompressor } from '@fluidframework/id-compressor';
+import type { IProvideFluidHandleContext } from '@fluidframework/core-interfaces';
+import type { IQuorumClients } from '@fluidframework/protocol-definitions';
+import type { IRequest } from '@fluidframework/core-interfaces';
+import type { IResponse } from '@fluidframework/core-interfaces';
+import type { ISequencedDocumentMessage } from '@fluidframework/protocol-definitions';
+import type { ISignalMessage } from '@fluidframework/protocol-definitions';
+import type { ISnapshotTree } from '@fluidframework/protocol-definitions';
+import type { ISummaryTree } from '@fluidframework/protocol-definitions';
+import type { ITelemetryBaseLogger } from '@fluidframework/core-interfaces';
+import type { ITree } from '@fluidframework/protocol-definitions';
 import type { IUser } from '@fluidframework/protocol-definitions';
-import { OpSpaceCompressedId } from '@fluidframework/id-compressor';
-import { SerializedIdCompressor } from '@fluidframework/id-compressor';
-import { SerializedIdCompressorWithNoSession } from '@fluidframework/id-compressor';
-import { SerializedIdCompressorWithOngoingSession } from '@fluidframework/id-compressor';
-import { SessionId } from '@fluidframework/id-compressor';
-import { SessionSpaceCompressedId } from '@fluidframework/id-compressor';
-import { StableId } from '@fluidframework/id-compressor';
-import { SummaryTree } from '@fluidframework/protocol-definitions';
-import { TelemetryEventPropertyType } from '@fluidframework/core-interfaces';
+import type { SummaryTree } from '@fluidframework/protocol-definitions';
+import type { TelemetryBaseEventPropertyType } from '@fluidframework/core-interfaces';
 
 /**
  * Encapsulates the return codes of the aliasing API.
@@ -145,6 +134,9 @@ export declare type FluidDataStoreRegistryEntry = Readonly<Partial<IProvideFluid
 export declare enum FlushMode {
     /**
      * In Immediate flush mode the runtime will immediately send all operations to the driver layer.
+     *
+     * @deprecated This option will be removed in the next major version and should not be used. Use {@link FlushMode.TurnBased} instead, which is the default.
+     * See https://github.com/microsoft/FluidFramework/tree/main/packages/runtime/container-runtime/src/opLifecycle#how-batching-works
      */
     Immediate = 0,
     /**
@@ -171,12 +163,19 @@ export declare enum FlushModeExperimental {
 }
 
 /**
- * They prefix for GC blobs in the GC tree in summary.
+ * The prefix for GC blobs in the GC tree in summary.
  *
  * @internal
  */
 export declare const gcBlobPrefix = "__gc";
 
+/**
+ * The key for the GC Data blob in attach summaries.
+ *
+ * @internal
+ */
+export declare const gcDataBlobKey = ".gcdata";
+
 /**
  * The key for deleted nodes blob in the GC tree in summary.
  *
@@ -226,6 +225,7 @@ export declare interface IAttachMessage {
 export declare interface IContainerRuntimeBase extends IEventProvider<IContainerRuntimeBaseEvents> {
     readonly logger: ITelemetryBaseLogger;
     readonly clientDetails: IClientDetails;
+    readonly disposed: boolean;
     /**
      * Invokes the given callback and guarantees that all operations generated within the callback will be ordered
      * sequentially.
@@ -237,12 +237,13 @@ export declare interface IContainerRuntimeBase extends IEventProvider<IContainer
      * Submits a container runtime level signal to be sent to other clients.
      * @param type - Type of the signal.
      * @param content - Content of the signal.
+     * @param targetClientId - When specified, the signal is only sent to the provided client id.
      */
-    submitSignal(type: string, content: any): void;
+    submitSignal(type: string, content: any, targetClientId?: string): void;
     /**
      * @deprecated 0.16 Issue #1537, #3631
      */
-    _createDataStoreWithProps(pkg: string | string[], props?: any, id?: string): Promise<IDataStore>;
+    _createDataStoreWithProps(pkg: Readonly<string | string[]>, props?: any, id?: string): Promise<IDataStore>;
     /**
      * Creates a data store and returns an object that exposes a handle to the data store's entryPoint, and also serves
      * as the data store's router. The data store is not bound to a container, and in such state is not persisted to
@@ -250,13 +251,20 @@ export declare interface IContainerRuntimeBase extends IEventProvider<IContainer
      * already attached DDS (or non-attached DDS that will eventually get attached to storage) will result in this
      * store being attached to storage.
      * @param pkg - Package name of the data store factory
+     * @param loadingGroupId - This represents the group of the datastore within a container or its snapshot.
+     * When not specified the datastore will belong to a `default` group. Read more about it in this
+     * {@link https://github.com/microsoft/FluidFramework/blob/main/packages/runtime/container-runtime/README.md | README}
      */
-    createDataStore(pkg: string | string[]): Promise<IDataStore>;
+    createDataStore(pkg: Readonly<string | string[]>, loadingGroupId?: string): Promise<IDataStore>;
     /**
      * Creates detached data store context. Only after context.attachRuntime() is called,
      * data store initialization is considered complete.
+     * @param pkg - Package name of the data store factory
+     * @param loadingGroupId - This represents the group of the datastore within a container or its snapshot.
+     * When not specified the datastore will belong to a `default` group. Read more about it in this
+     * {@link https://github.com/microsoft/FluidFramework/blob/main/packages/runtime/container-runtime/README.md | README}.
      */
-    createDetachedDataStore(pkg: Readonly<string[]>): IFluidDataStoreContextDetached;
+    createDetachedDataStore(pkg: Readonly<string[]>, loadingGroupId?: string): IFluidDataStoreContextDetached;
     /**
      * Get an absolute url for a provided container-relative request.
      * Returns undefined if the container or data store isn't attached to storage.
@@ -272,6 +280,28 @@ export declare interface IContainerRuntimeBase extends IEventProvider<IContainer
      * Returns the current audience.
      */
     getAudience(): IAudience;
+    /**
+     * Generates a new ID that is guaranteed to be unique across all sessions for this container.
+     * It could be in compact form (non-negative integer, oppotunistic), but it could also be UUID string.
+     * UUIDs generated will have low entropy in groups and will compress well.
+     * It can be leveraged anywhere in container where container unique IDs are required, i.e. any place
+     * that uses uuid() and stores result in container is likely candidate to start leveraging this API.
+     * If you always want to convert to string, instead of doing String(generateDocumentUniqueId()), consider
+     * doing encodeCompactIdToString(generateDocumentUniqueId()).
+     *
+     * For more details, please see IIdCompressor.generateDocumentUniqueId()
+     */
+    generateDocumentUniqueId(): number | string;
+    /**
+     * Api to fetch the snapshot from the service for a loadingGroupIds.
+     * @param loadingGroupIds - LoadingGroupId for which the snapshot is asked for.
+     * @param pathParts - Parts of the path, which we want to extract from the snapshot tree.
+     * @returns - snapshotTree and the sequence number of the snapshot.
+     */
+    getSnapshotForLoadingGroupId(loadingGroupIds: string[], pathParts: string[]): Promise<{
+        snapshotTree: ISnapshotTree;
+        sequenceNumber: number;
+    }>;
 }
 
 /**
@@ -286,6 +316,7 @@ export declare interface IContainerRuntimeBaseEvents extends IEvent {
     (event: "op", listener: (op: ISequencedDocumentMessage, runtimeMessage?: boolean) => void): any;
     (event: "batchEnd", listener: (error: any, op: ISequencedDocumentMessage) => void): any;
     (event: "signal", listener: (message: IInboundSignalMessage, local: boolean) => void): any;
+    (event: "dispose", listener: () => void): any;
 }
 
 /**
@@ -312,10 +343,6 @@ export declare interface IDataStore {
     readonly entryPoint: IFluidHandle<FluidObject>;
 }
 
-export { IdCompressor }
-
-export { IdCreationRange }
-
 /**
  * An envelope wraps the contents with the intended target
  * @alpha
@@ -366,34 +393,27 @@ export declare interface IExperimentalIncrementalSummaryContext {
  * @alpha
  */
 export declare interface IFluidDataStoreChannel extends IDisposable {
-    readonly id: string;
-    /**
-     * Indicates the attachment state of the channel to a host service.
-     */
-    readonly attachState: AttachState;
-    readonly visibilityState: VisibilityState;
-    /**
-     * Runs through the graph and attaches the bound handles. Then binds this runtime to the container.
-     * @deprecated This will be removed in favor of {@link IFluidDataStoreChannel.makeVisibleAndAttachGraph}.
-     */
-    attachGraph(): void;
     /**
      * Makes the data store channel visible in the container. Also, runs through its graph and attaches all
      * bound handles that represent its dependencies in the container's graph.
      */
     makeVisibleAndAttachGraph(): void;
     /**
-     * Retrieves the summary used as part of the initial summary message
+     * Synchronously retrieves the summary used as part of the initial summary message
      */
     getAttachSummary(telemetryContext?: ITelemetryContext): ISummaryTreeWithStats;
+    /**
+     * Synchronously retrieves GC Data (representing the outbound routes present) for the initial state of the DataStore
+     */
+    getAttachGCData?(telemetryContext?: ITelemetryContext): IGarbageCollectionData;
     /**
      * Processes the op.
      */
-    process(message: ISequencedDocumentMessage, local: boolean, localOpMetadata: unknown): void;
+    process(message: ISequencedDocumentMessage, local: boolean, localOpMetadata: unknown, addedOutboundReference?: (fromNodePath: string, toNodePath: string) => void): void;
     /**
      * Processes the signal.
      */
-    processSignal(message: any, local: boolean): void;
+    processSignal(message: IInboundSignalMessage, local: boolean): void;
     /**
      * Generates a summary for the channel.
      * Introduced with summarizerNode - will be required in a future release.
@@ -448,7 +468,7 @@ export declare interface IFluidDataStoreChannel extends IDisposable {
  * get information and call functionality to the container.
  * @alpha
  */
-export declare interface IFluidDataStoreContext extends IEventProvider<IFluidDataStoreContextEvents>, Partial<IProvideFluidDataStoreRegistry>, IProvideFluidHandleContext {
+export declare interface IFluidDataStoreContext extends IEventProvider<IFluidDataStoreContextEvents>, IFluidParentContext {
     readonly id: string;
     /**
      * A data store created by a client, is a local data store for that client. Also, when a detached container loads
@@ -463,28 +483,122 @@ export declare interface IFluidDataStoreContext extends IEventProvider<IFluidDat
      * The package path of the data store as per the package factory.
      */
     readonly packagePath: readonly string[];
-    readonly options: ILoaderOptions;
+    readonly baseSnapshot: ISnapshotTree | undefined;
+    /**
+     * @deprecated 0.16 Issue #1635, #3631
+     */
+    readonly createProps?: any;
+    /**
+     * Call by IFluidDataStoreChannel, indicates that a channel is dirty and needs to be part of the summary.
+     * @param address - The address of the channel that is dirty.
+     */
+    setChannelDirty(address: string): void;
+    /**
+     * @deprecated The functionality to get base GC details has been moved to summarizer node.
+     *
+     * Returns the GC details in the initial summary of this data store. This is used to initialize the data store
+     * and its children with the GC details from the previous summary.
+     */
+    getBaseGCDetails(): Promise<IGarbageCollectionDetailsBase>;
+    /**
+     * (Same as @see addedGCOutboundReference, but with string paths instead of handles)
+     *
+     * Called when a new outbound reference is added to another node. This is used by garbage collection to identify
+     * all references added in the system.
+     *
+     * @param fromPath - The absolute path of the node that added the reference.
+     * @param toPath - The absolute path of the outbound node that is referenced.
+     */
+    addedGCOutboundRoute?(fromPath: string, toPath: string): void;
+}
+
+/**
+ * @alpha
+ */
+export declare interface IFluidDataStoreContextDetached extends IFluidDataStoreContext {
+    /**
+     * Binds a runtime to the context.
+     */
+    attachRuntime(factory: IProvideFluidDataStoreFactory, dataStoreRuntime: IFluidDataStoreChannel): Promise<IDataStore>;
+}
+
+/**
+ * @alpha
+ */
+export declare interface IFluidDataStoreContextEvents extends IEvent {
+    (event: "attaching" | "attached", listener: () => void): any;
+}
+
+/**
+ * @alpha
+ */
+export declare const IFluidDataStoreFactory: keyof IProvideFluidDataStoreFactory;
+
+/**
+ * IFluidDataStoreFactory create data stores.  It is associated with an identifier (its `type` member)
+ * and usually provided to consumers using this mapping through a data store registry.
+ * @alpha
+ */
+export declare interface IFluidDataStoreFactory extends IProvideFluidDataStoreFactory {
+    /**
+     * String that uniquely identifies the type of data store created by this factory.
+     */
+    type: string;
+    /**
+     * Generates runtime for the data store from the data store context. Once created should be bound to the context.
+     * @param context - Context for the data store.
+     * @param existing - If instantiating from an existing file.
+     */
+    instantiateDataStore(context: IFluidDataStoreContext, existing: boolean): Promise<IFluidDataStoreChannel>;
+}
+
+/**
+ * @alpha
+ */
+export declare const IFluidDataStoreRegistry: keyof IProvideFluidDataStoreRegistry;
+
+/**
+ * An association of identifiers to data store registry entries, where the
+ * entries can be used to create data stores.
+ * @alpha
+ */
+export declare interface IFluidDataStoreRegistry extends IProvideFluidDataStoreRegistry {
+    get(name: string): Promise<FluidDataStoreRegistryEntry | undefined>;
+}
+
+/**
+ * Represents the context for the data store like objects. It is used by the data store runtime to
+ * get information and call functionality to its parent.
+ *
+ * This layout is temporary, as {@link IFluidParentContext} and {@link IFluidDataStoreContext} will converge.
+ *
+ * @alpha
+ */
+export declare interface IFluidParentContext extends IProvideFluidHandleContext, Partial<IProvideFluidDataStoreRegistry> {
+    readonly options: Record<string | number, any>;
     readonly clientId: string | undefined;
     readonly connected: boolean;
     readonly deltaManager: IDeltaManager<ISequencedDocumentMessage, IDocumentMessage>;
     readonly storage: IDocumentStorageService;
-    readonly baseSnapshot: ISnapshotTree | undefined;
     readonly logger: ITelemetryBaseLogger;
     readonly clientDetails: IClientDetails;
     readonly idCompressor?: IIdCompressor;
+    /**
+     * Represents the loading group to which the data store belongs to. Please refer to this readme for more context.
+     * {@link https://github.com/microsoft/FluidFramework/blob/main/packages/runtime/container-runtime/README.md | README}
+     */
+    readonly loadingGroupId?: string;
     /**
      * Indicates the attachment state of the data store to a host service.
      */
     readonly attachState: AttachState;
     readonly containerRuntime: IContainerRuntimeBase;
-    /**
-     * @deprecated 0.16 Issue #1635, #3631
-     */
-    readonly createProps?: any;
     /**
      * Ambient services provided with the context
      */
     readonly scope: FluidObject;
+    readonly gcThrowOnTombstoneUsage: boolean;
+    readonly gcTombstoneEnforcementAllowed: boolean;
     /**
      * Returns the current quorum.
      */
@@ -523,11 +637,6 @@ export declare interface IFluidDataStoreContext extends IEventProvider<IFluidDat
      * when they are marked as root. For non-root data stores, this happens when their handle is added to a visible DDS.
      */
     makeLocallyVisible(): void;
-    /**
-     * Call by IFluidDataStoreChannel, indicates that a channel is dirty and needs to be part of the summary.
-     * @param address - The address of the channel that is dirty.
-     */
-    setChannelDirty(address: string): void;
     /**
      * Get an absolute url to the container based on the provided relativeUrl.
      * Returns undefined if the container or data store isn't attached to storage.
@@ -546,78 +655,24 @@ export declare interface IFluidDataStoreContext extends IEventProvider<IFluidDat
      * If it is local, it will throw unsupported errors on calls to summarize.
      */
     createParam: CreateChildSummarizerNodeParam): CreateChildSummarizerNodeFn;
+    deleteChildSummarizerNode?(id: string): void;
     uploadBlob(blob: ArrayBufferLike, signal?: AbortSignal): Promise<IFluidHandle<ArrayBufferLike>>;
-    /**
-     * @deprecated The functionality to get base GC details has been moved to summarizer node.
-     *
-     * Returns the GC details in the initial summary of this data store. This is used to initialize the data store
-     * and its children with the GC details from the previous summary.
-     */
-    getBaseGCDetails(): Promise<IGarbageCollectionDetailsBase>;
     /**
      * @deprecated There is no replacement for this, its functionality is no longer needed at this layer.
      * It will be removed in a future release, sometime after 2.0.0-internal.8.0.0
      *
+     * Similar capability is exposed with from/to string paths instead of handles via @see addedGCOutboundRoute
+     *
      * Called when a new outbound reference is added to another node. This is used by garbage collection to identify
      * all references added in the system.
      * @param srcHandle - The handle of the node that added the reference.
      * @param outboundHandle - The handle of the outbound node that is referenced.
      */
-    addedGCOutboundReference?(srcHandle: IFluidHandle, outboundHandle: IFluidHandle): void;
-}
-
-/**
- * @alpha
- */
-export declare interface IFluidDataStoreContextDetached extends IFluidDataStoreContext {
-    /**
-     * Binds a runtime to the context.
-     */
-    attachRuntime(factory: IProvideFluidDataStoreFactory, dataStoreRuntime: IFluidDataStoreChannel): Promise<void>;
-}
-
-/**
- * @alpha
- */
-export declare interface IFluidDataStoreContextEvents extends IEvent {
-    (event: "attaching" | "attached", listener: () => void): any;
-}
-
-/**
- * @alpha
- */
-export declare const IFluidDataStoreFactory: keyof IProvideFluidDataStoreFactory;
-
-/**
- * IFluidDataStoreFactory create data stores.  It is associated with an identifier (its `type` member)
- * and usually provided to consumers using this mapping through a data store registry.
- * @alpha
- */
-export declare interface IFluidDataStoreFactory extends IProvideFluidDataStoreFactory {
-    /**
-     * String that uniquely identifies the type of data store created by this factory.
-     */
-    type: string;
-    /**
-     * Generates runtime for the data store from the data store context. Once created should be bound to the context.
-     * @param context - Context for the data store.
-     * @param existing - If instantiating from an existing file.
-     */
-    instantiateDataStore(context: IFluidDataStoreContext, existing: boolean): Promise<IFluidDataStoreChannel>;
-}
-
-/**
- * @alpha
- */
-export declare const IFluidDataStoreRegistry: keyof IProvideFluidDataStoreRegistry;
-
-/**
- * An association of identifiers to data store registry entries, where the
- * entries can be used to create data stores.
- * @alpha
- */
-export declare interface IFluidDataStoreRegistry extends IProvideFluidDataStoreRegistry {
-    get(name: string): Promise<FluidDataStoreRegistryEntry | undefined>;
+    addedGCOutboundReference?(srcHandle: {
+        absolutePath: string;
+    }, outboundHandle: {
+        absolutePath: string;
+    }): void;
 }
 
 /**
@@ -649,10 +704,6 @@ export declare interface IGarbageCollectionDetailsBase {
     gcData?: IGarbageCollectionData;
 }
 
-export { IIdCompressor }
-
-export { IIdCompressorCore }
-
 /**
  * Represents ISignalMessage with its type.
  * @public
@@ -688,6 +739,7 @@ export declare interface IProvideFluidDataStoreRegistry {
 
 /**
  * @internal
+ * @deprecated - This interface is now moved to `@fluidframework/container-definitions` package. Please import from that package.
  */
 export declare interface ISignalEnvelope {
     /**
@@ -755,9 +807,6 @@ export declare interface ISummarizerNode {
     invalidate(sequenceNumber: number): void;
     /**
      * Calls the internal summarize function and handles internal state tracking.
-     * If unchanged and fullTree is false, it will reuse previous summary subtree.
-     * If an error is encountered and throwOnFailure is false, it will try to make
-     * a summary with a pointer to the previous summary + a blob of outstanding ops.
      * @param fullTree - true to skip optimizations and always generate the full tree
      * @param trackState - indicates whether the summarizer node should track the state of the summary or not
      * @param telemetryContext - summary data passed through the layers for telemetry purposes
@@ -798,7 +847,9 @@ export declare interface ISummarizerNode {
      */
     config?: ISummarizerNodeConfig): ISummarizerNode;
     getChild(id: string): ISummarizerNode | undefined;
-    /** True if a summary is currently in progress */
+    /**
+     * True if a summary is currently in progress
+     */
     isSummaryInProgress?(): boolean;
 }
 
@@ -811,16 +862,6 @@ export declare interface ISummarizerNodeConfig {
      * Defaults to true.
      */
     readonly canReuseHandle?: boolean;
-    /**
-     * True to always stop execution on error during summarize, or false to
-     * attempt creating a summary that is a pointer ot the last acked summary
-     * plus outstanding ops in case of internal summarize failure.
-     * Defaults to false.
-     *
-     * BUG BUG: Default to true while we investigate problem
-     * with differential summaries
-     */
-    readonly throwOnFailure?: true;
 }
 
 /**
@@ -951,24 +992,30 @@ export declare interface ITelemetryContext {
      * @param property - property name of the telemetry data being tracked (ex: "DirectoryCount")
      * @param value - value to attribute to this summary telemetry data
      */
-    set(prefix: string, property: string, value: TelemetryEventPropertyType): void;
+    set(prefix: string, property: string, value: TelemetryBaseEventPropertyType): void;
     /**
      * Sets multiple values for telemetry data being tracked.
      * @param prefix - unique prefix to tag this data with (ex: "fluid:summarize:")
      * @param property - property name of the telemetry data being tracked (ex: "Options")
      * @param values - A set of values to attribute to this summary telemetry data.
      */
-    setMultiple(prefix: string, property: string, values: Record<string, TelemetryEventPropertyType>): void;
+    setMultiple(prefix: string, property: string, values: Record<string, TelemetryBaseEventPropertyType>): void;
     /**
      * Get the telemetry data being tracked
+     *
+     * @deprecated This interface should only be used for instrumenting, not for attempting to read already-set telemetry data.
+     *
      * @param prefix - unique prefix for this data (ex: "fluid:map:")
      * @param property - property name of the telemetry data being tracked (ex: "DirectoryCount")
      * @returns undefined if item not found
      */
-    get(prefix: string, property: string): TelemetryEventPropertyType;
+    get(prefix: string, property: string): TelemetryBaseEventPropertyType;
     /**
      * Returns a serialized version of all the telemetry data.
      * Should be used when logging in telemetry events.
+     *
+     * @deprecated This interface should only be used for instrumenting. A concrete implementation will likely have a serialize function
+     * but this functionality should not be used by other code being given an ITelemetryContext.
      */
     serialize(): string;
 }
@@ -1013,20 +1060,6 @@ export declare interface OpAttributionKey {
     seq: number;
 }
 
-export { OpSpaceCompressedId }
-
-export { SerializedIdCompressor }
-
-export { SerializedIdCompressorWithNoSession }
-
-export { SerializedIdCompressorWithOngoingSession }
-
-export { SessionId }
-
-export { SessionSpaceCompressedId }
-
-export { StableId }
-
 /**
  * @alpha
  */

package/dist/summary.d.ts

@@ -2,9 +2,9 @@
  * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
  * Licensed under the MIT License.
  */
-import { TelemetryEventPropertyType } from "@fluidframework/core-interfaces";
-import { SummaryTree, ISummaryTree, ISequencedDocumentMessage, ISnapshotTree, ITree } from "@fluidframework/protocol-definitions";
-import { IGarbageCollectionData, IGarbageCollectionDetailsBase } from "./garbageCollection";
+import type { TelemetryBaseEventPropertyType } from "@fluidframework/core-interfaces";
+import type { SummaryTree, ISummaryTree, ISequencedDocumentMessage, ISnapshotTree, ITree } from "@fluidframework/protocol-definitions";
+import type { IGarbageCollectionData, IGarbageCollectionDetailsBase } from "./garbageCollectionDefinitions.js";
 /**
  * Contains the aggregation data from a Tree/Subtree.
  * @public
@@ -105,16 +105,6 @@ export interface ISummarizerNodeConfig {
      * Defaults to true.
      */
     readonly canReuseHandle?: boolean;
-    /**
-     * True to always stop execution on error during summarize, or false to
-     * attempt creating a summary that is a pointer ot the last acked summary
-     * plus outstanding ops in case of internal summarize failure.
-     * Defaults to false.
-     *
-     * BUG BUG: Default to true while we investigate problem
-     * with differential summaries
-     */
-    readonly throwOnFailure?: true;
 }
 /**
  * @alpha
@@ -161,9 +151,6 @@ export interface ISummarizerNode {
     invalidate(sequenceNumber: number): void;
     /**
      * Calls the internal summarize function and handles internal state tracking.
-     * If unchanged and fullTree is false, it will reuse previous summary subtree.
-     * If an error is encountered and throwOnFailure is false, it will try to make
-     * a summary with a pointer to the previous summary + a blob of outstanding ops.
      * @param fullTree - true to skip optimizations and always generate the full tree
      * @param trackState - indicates whether the summarizer node should track the state of the summary or not
      * @param telemetryContext - summary data passed through the layers for telemetry purposes
@@ -204,7 +191,9 @@ export interface ISummarizerNode {
      */
     config?: ISummarizerNodeConfig): ISummarizerNode;
     getChild(id: string): ISummarizerNode | undefined;
-    /** True if a summary is currently in progress */
+    /**
+     * True if a summary is currently in progress
+     */
     isSummaryInProgress?(): boolean;
 }
 /**
@@ -295,24 +284,30 @@ export interface ITelemetryContext {
      * @param property - property name of the telemetry data being tracked (ex: "DirectoryCount")
      * @param value - value to attribute to this summary telemetry data
      */
-    set(prefix: string, property: string, value: TelemetryEventPropertyType): void;
+    set(prefix: string, property: string, value: TelemetryBaseEventPropertyType): void;
     /**
      * Sets multiple values for telemetry data being tracked.
      * @param prefix - unique prefix to tag this data with (ex: "fluid:summarize:")
      * @param property - property name of the telemetry data being tracked (ex: "Options")
      * @param values - A set of values to attribute to this summary telemetry data.
      */
-    setMultiple(prefix: string, property: string, values: Record<string, TelemetryEventPropertyType>): void;
+    setMultiple(prefix: string, property: string, values: Record<string, TelemetryBaseEventPropertyType>): void;
     /**
      * Get the telemetry data being tracked
+     *
+     * @deprecated This interface should only be used for instrumenting, not for attempting to read already-set telemetry data.
+     *
      * @param prefix - unique prefix for this data (ex: "fluid:map:")
      * @param property - property name of the telemetry data being tracked (ex: "DirectoryCount")
      * @returns undefined if item not found
      */
-    get(prefix: string, property: string): TelemetryEventPropertyType;
+    get(prefix: string, property: string): TelemetryBaseEventPropertyType;
     /**
      * Returns a serialized version of all the telemetry data.
      * Should be used when logging in telemetry events.
+     *
+     * @deprecated This interface should only be used for instrumenting. A concrete implementation will likely have a serialize function
+     * but this functionality should not be used by other code being given an ITelemetryContext.
      */
     serialize(): string;
 }