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

package/src/{dataStores.ts → channelCollection.ts}

@@ -8,35 +8,44 @@ import {
 	IDisposable,
 	IFluidHandle,
 	IRequest,
+	FluidObject,
+	IResponse,
 } from "@fluidframework/core-interfaces";
 import { FluidObjectHandle } from "@fluidframework/datastore";
 import { ISequencedDocumentMessage, ISnapshotTree } from "@fluidframework/protocol-definitions";
 import {
 	AliasResult,
 	channelsTreeName,
-	CreateChildSummarizerNodeFn,
-	CreateChildSummarizerNodeParam,
 	CreateSummarizerNodeSource,
 	IAttachMessage,
 	IEnvelope,
+	IFluidDataStoreChannel,
 	IFluidDataStoreContextDetached,
 	IGarbageCollectionData,
 	IInboundSignalMessage,
+	IFluidParentContext,
 	InboundAttachMessage,
 	ISummarizeResult,
 	ISummaryTreeWithStats,
 	ITelemetryContext,
+	IFluidDataStoreFactory,
+	IFluidDataStoreContext,
+	NamedFluidDataStoreRegistryEntries,
+	IFluidDataStoreRegistry,
 } from "@fluidframework/runtime-definitions";
 import {
 	convertSnapshotTreeToSummaryTree,
-	convertToSummaryTree,
+	convertSummaryTreeToITree,
 	create404Response,
 	createResponseError,
 	GCDataBuilder,
 	isSerializedHandle,
+	processAttachMessageGCData,
 	responseToException,
 	SummaryTreeBuilder,
 	unpackChildNodesUsedRoutes,
+	RequestParser,
+	encodeCompactIdToString,
 } from "@fluidframework/runtime-utils";
 import {
 	createChildMonitoringContext,
@@ -46,32 +55,183 @@ import {
 	LoggingError,
 	MonitoringContext,
 	tagCodeArtifacts,
+	createChildLogger,
 } from "@fluidframework/telemetry-utils";
 import { AttachState } from "@fluidframework/container-definitions";
 import { buildSnapshotTree } from "@fluidframework/driver-utils";
-import { assert, Lazy } from "@fluidframework/core-utils";
-import { v4 as uuid } from "uuid";
-import { DataStoreContexts } from "./dataStoreContexts";
-import { ContainerRuntime, defaultRuntimeHeaderData, RuntimeHeaderData } from "./containerRuntime";
+import { assert, Lazy, LazyPromise } from "@fluidframework/core-utils";
+import { DataStoreContexts } from "./dataStoreContexts.js";
+import { defaultRuntimeHeaderData, RuntimeHeaderData } from "./containerRuntime.js";
 import {
 	FluidDataStoreContext,
 	RemoteFluidDataStoreContext,
 	LocalFluidDataStoreContext,
 	createAttributesBlob,
 	LocalDetachedFluidDataStoreContext,
-} from "./dataStoreContext";
-import { StorageServiceWithAttachBlobs } from "./storageServiceWithAttachBlobs";
-import { GCNodeType, detectOutboundRoutesViaDDSKey } from "./gc";
-import { IDataStoreAliasMessage, isDataStoreAliasMessage } from "./dataStore";
-import { IContainerRuntimeMetadata, nonDataStorePaths, rootHasIsolatedChannels } from "./summary";
+} from "./dataStoreContext.js";
+import { StorageServiceWithAttachBlobs } from "./storageServiceWithAttachBlobs.js";
+import {
+	IDataStoreAliasMessage,
+	channelToDataStore,
+	isDataStoreAliasMessage,
+} from "./dataStore.js";
+import {
+	GCNodeType,
+	detectOutboundRoutesViaDDSKey,
+	trimLeadingAndTrailingSlashes,
+} from "./gc/index.js";
+import {
+	IContainerRuntimeMetadata,
+	nonDataStorePaths,
+	rootHasIsolatedChannels,
+} from "./summary/index.js";
+import { ContainerMessageType, LocalContainerRuntimeMessage } from "./messageTypes.js";
+import { FluidDataStoreRegistry } from "./dataStoreRegistry.js";
+
+/**
+ * Accepted header keys for requests coming to the runtime.
+ * @internal
+ */
+export enum RuntimeHeaders {
+	/** True to wait for a data store to be created and loaded before returning it. */
+	wait = "wait",
+	/** True if the request is coming from an IFluidHandle. */
+	viaHandle = "viaHandle",
+}
+
+/** True if a tombstoned object should be returned without erroring
+ * @alpha
+ */
+export const AllowTombstoneRequestHeaderKey = "allowTombstone"; // Belongs in the enum above, but avoiding the breaking change
+/**
+ * [IRRELEVANT IF throwOnInactiveLoad OPTION NOT SET] True if an inactive object should be returned without erroring
+ * @internal
+ */
+export const AllowInactiveRequestHeaderKey = "allowInactive"; // Belongs in the enum above, but avoiding the breaking change
 
 type PendingAliasResolve = (success: boolean) => void;
 
+interface FluidDataStoreMessage {
+	content: any;
+	type: string;
+}
+
+/**
+ * Creates a shallow wrapper of {@link IFluidParentContext}. The wrapper can then have its methods overwritten as needed
+ */
+export function wrapContext(context: IFluidParentContext): IFluidParentContext {
+	return {
+		get IFluidDataStoreRegistry() {
+			return context.IFluidDataStoreRegistry;
+		},
+		IFluidHandleContext: context.IFluidHandleContext,
+		options: context.options,
+		get clientId() {
+			return context.clientId;
+		},
+		get connected() {
+			return context.connected;
+		},
+		deltaManager: context.deltaManager,
+		storage: context.storage,
+		logger: context.logger,
+		get clientDetails() {
+			return context.clientDetails;
+		},
+		get idCompressor() {
+			return context.idCompressor;
+		},
+		loadingGroupId: context.loadingGroupId,
+		get attachState() {
+			return context.attachState;
+		},
+		containerRuntime: context.containerRuntime,
+		scope: context.scope,
+		gcThrowOnTombstoneUsage: context.gcThrowOnTombstoneUsage,
+		gcTombstoneEnforcementAllowed: context.gcTombstoneEnforcementAllowed,
+		getAbsoluteUrl: async (...args) => {
+			return context.getAbsoluteUrl(...args);
+		},
+		getQuorum: (...args) => {
+			return context.getQuorum(...args);
+		},
+		getAudience: (...args) => {
+			return context.getAudience(...args);
+		},
+		ensureNoDataModelChanges: (...args) => {
+			return context.ensureNoDataModelChanges(...args);
+		},
+		submitMessage: (...args) => {
+			return context.submitMessage(...args);
+		},
+		submitSignal: (...args) => {
+			return context.submitSignal(...args);
+		},
+		makeLocallyVisible: (...args) => {
+			return context.makeLocallyVisible(...args);
+		},
+		uploadBlob: async (...args) => {
+			return context.uploadBlob(...args);
+		},
+		addedGCOutboundReference: (...args) => {
+			return context.addedGCOutboundReference?.(...args);
+		},
+		getCreateChildSummarizerNodeFn: (...args) => {
+			return context.getCreateChildSummarizerNodeFn?.(...args);
+		},
+		deleteChildSummarizerNode: (...args) => {
+			return context.deleteChildSummarizerNode?.(...args);
+		},
+	};
+}
+
+/**
+ * Creates a wrapper of a {@link IFluidParentContext} to be provided to the inner datastore channels.
+ * The wrapper will have the submit methods overwritten with the appropriate id as the destination address.
+ *
+ * @param id - the id of the channel
+ * @param parentContext - the {@link IFluidParentContext} to wrap
+ * @returns A wrapped {@link IFluidParentContext}
+ */
+export function wrapContextForInnerChannel(
+	id: string,
+	parentContext: IFluidParentContext,
+): IFluidParentContext {
+	const context = wrapContext(parentContext);
+
+	context.submitMessage = (type: string, content: any, localOpMetadata: unknown) => {
+		const fluidDataStoreContent: FluidDataStoreMessage = {
+			content,
+			type,
+		};
+		const envelope: IEnvelope = {
+			address: id,
+			contents: fluidDataStoreContent,
+		};
+		parentContext.submitMessage(
+			ContainerMessageType.FluidDataStoreOp,
+			envelope,
+			localOpMetadata,
+		);
+	};
+
+	context.submitSignal = (type: string, contents: any, targetClientId?: string) => {
+		const envelope: IEnvelope = {
+			address: id,
+			contents,
+		};
+		parentContext.submitSignal(type, envelope, targetClientId);
+	};
+
+	return context;
+}
+
 /**
  * This class encapsulates data store handling. Currently it is only used by the container runtime,
  * but eventually could be hosted on any channel once we formalize the channel api boundary.
+ * @internal
  */
-export class DataStores implements IDisposable {
+export class ChannelCollection implements IFluidDataStoreChannel, IDisposable {
 	// Stores tracked by the Domain
 	private readonly pendingAttach = new Map<string, IAttachMessage>();
 	// 0.24 back-compat attachingBeforeSummary
@@ -81,6 +241,8 @@ export class DataStores implements IDisposable {
 
 	private readonly disposeOnce = new Lazy<void>(() => this.contexts.dispose());
 
+	public readonly entryPoint: IFluidHandle<FluidObject>;
+
 	public readonly containerLoadStats: {
 		// number of dataStores during loadContainer
 		readonly containerLoadDataStoreCount: number;
@@ -99,30 +261,35 @@ export class DataStores implements IDisposable {
 		Promise<AliasResult>
 	>();
 
+	private readonly contexts: DataStoreContexts;
+
 	constructor(
 		private readonly baseSnapshot: ISnapshotTree | undefined,
-		private readonly runtime: ContainerRuntime,
-		private readonly submitAttachFn: (attachContent: IAttachMessage) => void,
-		private readonly getCreateChildSummarizerNodeFn: (
-			id: string,
-			createParam: CreateChildSummarizerNodeParam,
-		) => CreateChildSummarizerNodeFn,
-		private readonly deleteChildSummarizerNodeFn: (id: string) => void,
+		public readonly parentContext: IFluidParentContext,
 		baseLogger: ITelemetryBaseLogger,
 		private readonly gcNodeUpdated: (
 			nodePath: string,
-			timestampMs: number,
+			reason: "Loaded" | "Changed",
+			timestampMs?: number,
 			packagePath?: readonly string[],
+			request?: IRequest,
+			headerData?: RuntimeHeaderData,
 		) => void,
 		private readonly isDataStoreDeleted: (nodePath: string) => boolean,
 		private readonly aliasMap: Map<string, string>,
-		private readonly contexts: DataStoreContexts = new DataStoreContexts(baseLogger),
+		provideEntryPoint: (runtime: ChannelCollection) => Promise<FluidObject>,
 	) {
 		this.mc = createChildMonitoringContext({ logger: baseLogger });
+		this.contexts = new DataStoreContexts(baseLogger);
 		this.containerRuntimeHandle = new FluidObjectHandle(
-			this.runtime,
+			this.parentContext,
 			"/",
-			this.runtime.IFluidHandleContext,
+			this.parentContext.IFluidHandleContext,
+		);
+		this.entryPoint = new FluidObjectHandle<FluidObject>(
+			new LazyPromise(async () => provideEntryPoint(this)),
+			"",
+			this.parentContext.IFluidHandleContext,
 		);
 
 		// Extract stores stored inside the snapshot
@@ -143,16 +310,17 @@ export class DataStores implements IDisposable {
 				unreferencedDataStoreCount++;
 			}
 			// If we have a detached container, then create local data store contexts.
-			if (this.runtime.attachState !== AttachState.Detached) {
+			if (this.parentContext.attachState !== AttachState.Detached) {
 				dataStoreContext = new RemoteFluidDataStoreContext({
 					id: key,
 					snapshotTree: value,
-					runtime: this.runtime,
-					storage: this.runtime.storage,
-					scope: this.runtime.scope,
-					createSummarizerNodeFn: this.getCreateChildSummarizerNodeFn(key, {
+					parentContext: this.wrapContextForInnerChannel(key),
+					storage: this.parentContext.storage,
+					scope: this.parentContext.scope,
+					createSummarizerNodeFn: this.parentContext.getCreateChildSummarizerNodeFn(key, {
 						type: CreateSummarizerNodeSource.FromSummary,
 					}),
+					loadingGroupId: value.groupId,
 				});
 			} else {
 				if (typeof value !== "object") {
@@ -162,10 +330,10 @@ export class DataStores implements IDisposable {
 				dataStoreContext = new LocalFluidDataStoreContext({
 					id: key,
 					pkg: undefined,
-					runtime: this.runtime,
-					storage: this.runtime.storage,
-					scope: this.runtime.scope,
-					createSummarizerNodeFn: this.getCreateChildSummarizerNodeFn(key, {
+					parentContext: this.wrapContextForInnerChannel(key),
+					storage: this.parentContext.storage,
+					scope: this.parentContext.scope,
+					createSummarizerNodeFn: this.parentContext.getCreateChildSummarizerNodeFn(key, {
 						type: CreateSummarizerNodeSource.FromSummary,
 					}),
 					makeLocallyVisibleFn: () => this.makeDataStoreLocallyVisible(key),
@@ -194,11 +362,53 @@ export class DataStores implements IDisposable {
 		return pendingAliasPromise ?? "Success";
 	}
 
-	public processAttachMessage(message: ISequencedDocumentMessage, local: boolean) {
+	/** For sampling. Only log once per container */
+	private shouldSendAttachLog = true;
+
+	private wrapContextForInnerChannel(id: string): IFluidParentContext {
+		return wrapContextForInnerChannel(id, this.parentContext);
+	}
+
+	/**
+	 * IFluidDataStoreChannel.makeVisibleAndAttachGraph implementation
+	 * Not clear when it would be called and what it should do.
+	 * Currently this API is called by context only for root data stores.
+	 */
+	public makeVisibleAndAttachGraph() {
+		this.parentContext.makeLocallyVisible();
+	}
+
+	private processAttachMessage(message: ISequencedDocumentMessage, local: boolean) {
 		const attachMessage = message.contents as InboundAttachMessage;
 
 		this.dataStoresSinceLastGC.push(attachMessage.id);
 
+		// We need to process the GC Data for both local and remote attach messages
+		const foundGCData = processAttachMessageGCData(attachMessage.snapshot, (nodeId, toPath) => {
+			// nodeId is the relative path under the node being attached. Always starts with "/", but no trailing "/" after an id
+			const fromPath = `/${attachMessage.id}${nodeId === "/" ? "" : nodeId}`;
+			this.parentContext.addedGCOutboundReference?.(
+				{ absolutePath: fromPath },
+				{ absolutePath: toPath },
+			);
+		});
+
+		// Only log once per container to avoid noise/cost.
+		// Allows longitudinal tracking of various state (e.g. foundGCData), and some sampled details
+		if (this.shouldSendAttachLog) {
+			this.shouldSendAttachLog = false;
+			this.mc.logger.sendTelemetryEvent({
+				eventName: "dataStoreAttachMessage_sampled",
+				...tagCodeArtifacts({ id: attachMessage.id, pkg: attachMessage.type }),
+				details: {
+					local,
+					snapshot: !!attachMessage.snapshot,
+					foundGCData,
+				},
+				...extractSafePropertiesFromMessage(message),
+			});
+		}
+
 		// The local object has already been attached
 		if (local) {
 			assert(
@@ -236,23 +446,27 @@ export class DataStores implements IDisposable {
 		const remoteFluidDataStoreContext = new RemoteFluidDataStoreContext({
 			id: attachMessage.id,
 			snapshotTree,
-			runtime: this.runtime,
-			storage: new StorageServiceWithAttachBlobs(this.runtime.storage, flatAttachBlobs),
-			scope: this.runtime.scope,
-			createSummarizerNodeFn: this.getCreateChildSummarizerNodeFn(attachMessage.id, {
-				type: CreateSummarizerNodeSource.FromAttach,
-				sequenceNumber: message.sequenceNumber,
-				snapshot: attachMessage.snapshot ?? {
-					entries: [createAttributesBlob(pkg, true /* isRootDataStore */)],
+			parentContext: this.wrapContextForInnerChannel(attachMessage.id),
+			storage: new StorageServiceWithAttachBlobs(this.parentContext.storage, flatAttachBlobs),
+			scope: this.parentContext.scope,
+			loadingGroupId: attachMessage.snapshot?.groupId,
+			createSummarizerNodeFn: this.parentContext.getCreateChildSummarizerNodeFn(
+				attachMessage.id,
+				{
+					type: CreateSummarizerNodeSource.FromAttach,
+					sequenceNumber: message.sequenceNumber,
+					snapshot: attachMessage.snapshot ?? {
+						entries: [createAttributesBlob(pkg, true /* isRootDataStore */)],
+					},
 				},
-			}),
+			),
 			pkg,
 		});
 
 		this.contexts.addBoundOrRemoted(remoteFluidDataStoreContext);
 	}
 
-	public processAliasMessage(
+	private processAliasMessage(
 		message: ISequencedDocumentMessage,
 		localOpMetadata: unknown,
 		local: boolean,
@@ -301,9 +515,9 @@ export class DataStores implements IDisposable {
 		const handle = new FluidObjectHandle(
 			context,
 			aliasMessage.internalId,
-			this.runtime.IFluidHandleContext,
+			this.parentContext.IFluidHandleContext,
 		);
-		this.runtime.addedGCOutboundReference(this.containerRuntimeHandle, handle);
+		this.parentContext.addedGCOutboundReference?.(this.containerRuntimeHandle, handle);
 
 		this.aliasMap.set(aliasMessage.alias, context.id);
 		context.setInMemoryRoot();
@@ -314,9 +528,24 @@ export class DataStores implements IDisposable {
 		return this.aliasMap.get(id) !== undefined || this.contexts.get(id) !== undefined;
 	}
 
+	/** Package up the context's attach summary etc into an IAttachMessage */
+	private generateAttachMessage(localContext: LocalFluidDataStoreContext): IAttachMessage {
+		const { attachSummary } = localContext.getAttachData(/* includeGCData: */ true);
+		const type = localContext.packagePath[localContext.packagePath.length - 1];
+
+		// Attach message needs the summary in ITree format. Convert the ISummaryTree into an ITree.
+		const snapshot = convertSummaryTreeToITree(attachSummary.summary);
+
+		return {
+			id: localContext.id,
+			snapshot,
+			type,
+		} satisfies IAttachMessage;
+	}
+
 	/**
-	 * Make the data stores locally visible in the container graph by moving the data store context from unbound to
-	 * bound list. This data store can now be reached from the root.
+	 * Make the data store locally visible in the container graph by moving the data store context from unbound to
+	 * bound list and submitting the attach message. This data store can now be reached from the root.
 	 * @param id - The id of the data store context to make visible.
 	 */
 	private makeDataStoreLocallyVisible(id: string): void {
@@ -328,57 +557,102 @@ export class DataStores implements IDisposable {
 		 * globally visible. Move it to attaching state and send an "attach" op for it.
 		 * If the container is detached, this data store will be part of the summary that makes the container attached.
 		 */
-		if (this.runtime.attachState !== AttachState.Detached) {
+		if (this.parentContext.attachState !== AttachState.Detached) {
 			localContext.emit("attaching");
-			const message = localContext.generateAttachMessage();
+			const message = this.generateAttachMessage(localContext);
 
 			this.pendingAttach.set(id, message);
-			this.submitAttachFn(message);
+			this.parentContext.submitMessage(ContainerMessageType.Attach, message, undefined);
 			this.attachOpFiredForDataStore.add(id);
 		}
 
 		this.contexts.bind(id);
 	}
 
+	/**
+	 * Generate compact internal DataStore ID.
+	 *
+	 * A note about namespace and name collisions:
+	 * This code assumes that that's the only way to generate internal IDs, and that it's Ok for this namespace to overlap with
+	 * user-provided alias names namespace.
+	 * There are two scenarios where it could cause trouble:
+	 * 1) Old files, where (already removed) CreateRoot*DataStore*() API was used, and thus internal name of data store
+	 * was provided by user. Such files may experience name collision with future data stores that receive a name generated
+	 * by this function.
+	 * 2) Much less likely, but if it happen that internal ID (generated by this function) is exactly the same as alias name
+	 * that user might use in the future, them ContainerRuntime.getAliasedDataStoreEntryPoint() or
+	 * ContainerRuntime.getDataStoreFromRequest() could return a data store with internalID matching user request, even though
+	 * user expected some other data store (that would receive alias later).
+	 * Please note that above mentioned functions have the implementation they have (allowing #2) due to #1.
+	 */
+	protected createDataStoreId(): string {
+		// We use three non-overlapping namespaces:
+		// - detached state: even numbers
+		// - attached state: odd numbers
+		// - uuids
+		// In first two cases we will encode result as strings in more compact form.
+		if (this.parentContext.attachState === AttachState.Detached) {
+			// container is detached, only one client observes content,  no way to hit collisions with other clients.
+			return encodeCompactIdToString(2 * this.contexts.size);
+		}
+		const id = this.parentContext.containerRuntime.generateDocumentUniqueId();
+		if (typeof id === "number") {
+			return encodeCompactIdToString(2 * id + 1);
+		}
+		return id;
+	}
+
 	public createDetachedDataStoreCore(
 		pkg: Readonly<string[]>,
-		isRoot: boolean,
-		id = uuid(),
+		loadingGroupId?: string,
 	): IFluidDataStoreContextDetached {
-		assert(!id.includes("/"), 0x30c /* Id cannot contain slashes */);
+		const id = this.createDataStoreId();
 
 		const context = new LocalDetachedFluidDataStoreContext({
 			id,
 			pkg,
-			runtime: this.runtime,
-			storage: this.runtime.storage,
-			scope: this.runtime.scope,
-			createSummarizerNodeFn: this.getCreateChildSummarizerNodeFn(id, {
+			parentContext: this.wrapContextForInnerChannel(id),
+			storage: this.parentContext.storage,
+			scope: this.parentContext.scope,
+			createSummarizerNodeFn: this.parentContext.getCreateChildSummarizerNodeFn(id, {
 				type: CreateSummarizerNodeSource.Local,
 			}),
 			makeLocallyVisibleFn: () => this.makeDataStoreLocallyVisible(id),
 			snapshotTree: undefined,
-			isRootDataStore: isRoot,
+			isRootDataStore: false,
+			loadingGroupId,
+			channelToDataStoreFn: (channel: IFluidDataStoreChannel) =>
+				channelToDataStore(
+					channel,
+					id,
+					this,
+					createChildLogger({ logger: this.parentContext.logger }),
+				),
 		});
 		this.contexts.addUnbound(context);
 		return context;
 	}
 
-	public _createFluidDataStoreContext(pkg: string[], id: string, props?: any) {
-		assert(!id.includes("/"), 0x30d /* Id cannot contain slashes */);
+	public _createFluidDataStoreContext(
+		pkg: Readonly<string[]>,
+		props?: any,
+		loadingGroupId?: string,
+	) {
+		const id = this.createDataStoreId();
 		const context = new LocalFluidDataStoreContext({
 			id,
 			pkg,
-			runtime: this.runtime,
-			storage: this.runtime.storage,
-			scope: this.runtime.scope,
-			createSummarizerNodeFn: this.getCreateChildSummarizerNodeFn(id, {
+			parentContext: this.wrapContextForInnerChannel(id),
+			storage: this.parentContext.storage,
+			scope: this.parentContext.scope,
+			createSummarizerNodeFn: this.parentContext.getCreateChildSummarizerNodeFn(id, {
 				type: CreateSummarizerNodeSource.Local,
 			}),
 			makeLocallyVisibleFn: () => this.makeDataStoreLocallyVisible(id),
 			snapshotTree: undefined,
 			isRootDataStore: false,
 			createProps: props,
+			loadingGroupId,
 		});
 		this.contexts.addUnbound(context);
 		return context;
@@ -389,7 +663,17 @@ export class DataStores implements IDisposable {
 	}
 	public readonly dispose = () => this.disposeOnce.value;
 
-	public resubmitDataStoreOp(envelope: IEnvelope, localOpMetadata: unknown) {
+	public reSubmit(type: string, content: any, localOpMetadata: unknown) {
+		switch (type) {
+			case ContainerMessageType.Attach:
+			case ContainerMessageType.Alias:
+				this.parentContext.submitMessage(type, content, localOpMetadata);
+				return;
+			default:
+		}
+
+		assert(type === ContainerMessageType.FluidDataStoreOp, 0x8e7 /* type */);
+		const envelope = content as IEnvelope;
 		const context = this.contexts.get(envelope.address);
 		// If the data store has been deleted, log an error and throw an error. If there are local changes for a
 		// deleted data store, it can otherwise lead to inconsistent state when compared to other clients.
@@ -402,10 +686,13 @@ export class DataStores implements IDisposable {
 			});
 		}
 		assert(!!context, 0x160 /* "There should be a store context for the op" */);
-		context.reSubmit(envelope.contents, localOpMetadata);
+		const innerContents = envelope.contents as FluidDataStoreMessage;
+		context.reSubmit(innerContents.type, innerContents.content, localOpMetadata);
 	}
 
-	public rollbackDataStoreOp(envelope: IEnvelope, localOpMetadata: unknown) {
+	public rollback(type: string, content: any, localOpMetadata: unknown) {
+		assert(type === ContainerMessageType.FluidDataStoreOp, 0x8e8 /* type */);
+		const envelope = content as IEnvelope;
 		const context = this.contexts.get(envelope.address);
 		// If the data store has been deleted, log an error and throw an error. If there are local changes for a
 		// deleted data store, it can otherwise lead to inconsistent state when compared to other clients.
@@ -418,10 +705,21 @@ export class DataStores implements IDisposable {
 			});
 		}
 		assert(!!context, 0x2e8 /* "There should be a store context for the op" */);
-		context.rollback(envelope.contents, localOpMetadata);
+		const innerContents = envelope.contents as FluidDataStoreMessage;
+		context.rollback(innerContents.type, innerContents.content, localOpMetadata);
 	}
 
-	public async applyStashedOp(envelope: IEnvelope): Promise<unknown> {
+	public async applyStashedOp(content: unknown): Promise<unknown> {
+		const opContents = content as LocalContainerRuntimeMessage;
+		switch (opContents.type) {
+			case ContainerMessageType.Attach:
+				return this.applyStashedAttachOp(opContents.contents);
+			case ContainerMessageType.Alias:
+				return;
+			default:
+		}
+
+		const envelope = opContents.contents as IEnvelope;
 		const context = this.contexts.get(envelope.address);
 		// If the data store has been deleted, log an error and ignore this message. This helps prevent document
 		// corruption in case the data store that stashed the op is deleted.
@@ -432,20 +730,39 @@ export class DataStores implements IDisposable {
 		return context.applyStashedOp(envelope.contents);
 	}
 
-	public async applyStashedAttachOp(message: IAttachMessage) {
+	private async applyStashedAttachOp(message: IAttachMessage) {
 		this.pendingAttach.set(message.id, message);
 		// eslint-disable-next-line @typescript-eslint/consistent-type-assertions
 		this.processAttachMessage({ contents: message } as ISequencedDocumentMessage, false);
 	}
 
-	public processFluidDataStoreOp(
+	public process(
 		message: ISequencedDocumentMessage,
 		local: boolean,
 		localMessageMetadata: unknown,
-		addedOutboundReference: (fromNodePath: string, toNodePath: string) => void,
+		addedOutboundReference?: (fromNodePath: string, toNodePath: string) => void,
 	) {
+		switch (message.type) {
+			case ContainerMessageType.Attach:
+				this.processAttachMessage(message, local);
+				return;
+			case ContainerMessageType.Alias:
+				this.processAliasMessage(message, localMessageMetadata, local);
+				return;
+			case ContainerMessageType.FluidDataStoreOp:
+				break;
+			default:
+				assert(false, 0x8e9 /* unreached */);
+		}
+
 		const envelope = message.contents as IEnvelope;
-		const transformed = { ...message, contents: envelope.contents };
+		const innerContents = envelope.contents as FluidDataStoreMessage;
+		const transformed = {
+			...message,
+			type: innerContents.type,
+			contents: innerContents.content,
+		};
+
 		const context = this.contexts.get(envelope.address);
 
 		// If the data store has been deleted, log an error and ignore this message. This helps prevent document
@@ -482,7 +799,10 @@ export class DataStores implements IDisposable {
 
 		// By default, we use the new behavior of detecting outbound routes here.
 		// If this setting is true, then DataStoreContext would be notifying GC instead.
-		if (this.mc.config.getBoolean(detectOutboundRoutesViaDDSKey) !== true) {
+		if (
+			this.mc.config.getBoolean(detectOutboundRoutesViaDDSKey) !== true &&
+			addedOutboundReference !== undefined
+		) {
 			// Notify GC of any outbound references that were added by this op.
 			detectOutboundReferences(envelope, addedOutboundReference);
 		}
@@ -491,6 +811,7 @@ export class DataStores implements IDisposable {
 		// being used.
 		this.gcNodeUpdated(
 			`/${envelope.address}`,
+			"Changed",
 			message.timestamp,
 			context.isLoaded ? context.packagePath : undefined,
 		);
@@ -584,7 +905,10 @@ export class DataStores implements IDisposable {
 		return true;
 	}
 
-	public processSignal(fluidDataStoreId: string, message: IInboundSignalMessage, local: boolean) {
+	public processSignal(messageArg: IInboundSignalMessage, local: boolean) {
+		const envelope = messageArg.content as IEnvelope;
+		const fluidDataStoreId = envelope.address;
+		const message = { ...messageArg, content: envelope.contents };
 		const context = this.contexts.get(fluidDataStoreId);
 		// If the data store has been deleted, log an error and ignore this message. This helps prevent document
 		// corruption in case a deleted data store accidentally submitted a signal.
@@ -620,7 +944,7 @@ export class DataStores implements IDisposable {
 							fluidDataStoreId,
 						}),
 						details: JSON.stringify({
-							runtimeConnected: this.runtime.connected,
+							runtimeConnected: this.parentContext.connected,
 							connected,
 						}),
 					},
@@ -681,7 +1005,10 @@ export class DataStores implements IDisposable {
 		return summaryBuilder.getSummaryTree();
 	}
 
-	public createSummary(telemetryContext?: ITelemetryContext): ISummaryTreeWithStats {
+	/**
+	 * Create a summary. Used when attaching or serializing a detached container.
+	 */
+	public getAttachSummary(telemetryContext?: ITelemetryContext): ISummaryTreeWithStats {
 		const builder = new SummaryTreeBuilder();
 		// Attaching graph of some stores can cause other stores to get bound too.
 		// So keep taking summary until no new stores get bound.
@@ -705,8 +1032,10 @@ export class DataStores implements IDisposable {
 				.map(([key, value]) => {
 					let dataStoreSummary: ISummarizeResult;
 					if (value.isLoaded) {
-						const snapshot = value.generateAttachMessage().snapshot;
-						dataStoreSummary = convertToSummaryTree(snapshot, true);
+						dataStoreSummary = value.getAttachData(
+							/* includeGCCData: */ false,
+							telemetryContext,
+						).attachSummary;
 					} else {
 						// If this data store is not yet loaded, then there should be no changes in the snapshot from
 						// which it was created as it is detached container. So just use the previous snapshot.
@@ -736,8 +1065,12 @@ export class DataStores implements IDisposable {
 			assert(context !== undefined, 0x2b6 /* Missing data store context */);
 			if (await context.isRoot()) {
 				// A root data store is basically a reference from the container runtime to the data store.
-				const handle = new FluidObjectHandle(context, id, this.runtime.IFluidHandleContext);
-				this.runtime.addedGCOutboundReference(this.containerRuntimeHandle, handle);
+				const handle = new FluidObjectHandle(
+					context,
+					id,
+					this.parentContext.IFluidHandleContext,
+				);
+				this.parentContext.addedGCOutboundReference?.(this.containerRuntimeHandle, handle);
 			}
 		}
 		this.dataStoresSinceLastGC = [];
@@ -828,7 +1161,7 @@ export class DataStores implements IDisposable {
 			// Delete the contexts of unused data stores.
 			this.contexts.delete(dataStoreId);
 			// Delete the summarizer node of the unused data stores.
-			this.deleteChildSummarizerNodeFn(dataStoreId);
+			this.parentContext.deleteChildSummarizerNode?.(dataStoreId);
 		}
 	}
 
@@ -870,7 +1203,7 @@ export class DataStores implements IDisposable {
 			// Delete the contexts of sweep ready data stores.
 			this.contexts.delete(dataStoreId);
 			// Delete the summarizer node of the sweep ready data stores.
-			this.deleteChildSummarizerNodeFn(dataStoreId);
+			this.parentContext.deleteChildSummarizerNode?.(dataStoreId);
 		}
 		return Array.from(sweepReadyDataStoreRoutes);
 	}
@@ -944,6 +1277,69 @@ export class DataStores implements IDisposable {
 		}
 		return GCNodeType.SubDataStore;
 	}
+
+	public internalId(maybeAlias: string): string {
+		return this.aliases.get(maybeAlias) ?? maybeAlias;
+	}
+
+	public async request(request: IRequest): Promise<IResponse> {
+		const requestParser = RequestParser.create(request);
+		const id = requestParser.pathParts[0];
+
+		// Differentiate between requesting the dataStore directly, or one of its children
+		const requestForChild = !requestParser.isLeaf(1);
+
+		const headerData: RuntimeHeaderData = {};
+		if (typeof request.headers?.[RuntimeHeaders.wait] === "boolean") {
+			headerData.wait = request.headers[RuntimeHeaders.wait];
+		}
+		if (typeof request.headers?.[RuntimeHeaders.viaHandle] === "boolean") {
+			headerData.viaHandle = request.headers[RuntimeHeaders.viaHandle];
+		}
+		if (typeof request.headers?.[AllowTombstoneRequestHeaderKey] === "boolean") {
+			headerData.allowTombstone = request.headers[AllowTombstoneRequestHeaderKey];
+		}
+		if (typeof request.headers?.[AllowInactiveRequestHeaderKey] === "boolean") {
+			headerData.allowInactive = request.headers[AllowInactiveRequestHeaderKey];
+		}
+
+		// We allow Tombstone requests for sub-DataStore objects
+		if (requestForChild) {
+			headerData.allowTombstone = true;
+		}
+
+		await this.waitIfPendingAlias(id);
+		const internalId = this.internalId(id);
+		const dataStoreContext = await this.getDataStore(internalId, headerData);
+
+		// Remove query params, leading and trailing slashes from the url. This is done to make sure the format is
+		// the same as GC nodes id.
+		const urlWithoutQuery = trimLeadingAndTrailingSlashes(request.url.split("?")[0]);
+		// Get the initial snapshot details which contain the data store package path.
+		const details = await dataStoreContext.getInitialSnapshotDetails();
+
+		// Note that this will throw if the data store is inactive or tombstoned and throwing on incorrect usage
+		// is configured.
+		this.gcNodeUpdated(
+			`/${urlWithoutQuery}`,
+			"Loaded",
+			undefined /* timestampMs */,
+			details.pkg,
+			request,
+			headerData,
+		);
+		const dataStore = await dataStoreContext.realize();
+
+		const subRequest = requestParser.createSubRequest(1);
+		// We always expect createSubRequest to include a leading slash, but asserting here to protect against
+		// unintentionally modifying the url if that changes.
+		assert(
+			subRequest.url.startsWith("/"),
+			0x126 /* "Expected createSubRequest url to include a leading slash" */,
+		);
+
+		return dataStore.request(subRequest);
+	}
 }
 
 export function getSummaryForDatastores(
@@ -975,6 +1371,8 @@ export function getSummaryForDatastores(
 
 /**
  * Traverse this op's contents and detect any outbound routes that were added by this op.
+ *
+ * @internal
  */
 export function detectOutboundReferences(
 	envelope: IEnvelope,
@@ -1011,3 +1409,41 @@ export function detectOutboundReferences(
 	const fromPath = ["", envelope.address, ddsAddress].join("/");
 	outboundPaths.forEach((toPath) => addedOutboundReference(fromPath, toPath));
 }
+
+/** @internal */
+export class ChannelCollectionFactory implements IFluidDataStoreFactory {
+	public readonly type = "ChannelCollectionChannel";
+
+	public IFluidDataStoreRegistry: IFluidDataStoreRegistry;
+
+	constructor(
+		registryEntries: NamedFluidDataStoreRegistryEntries,
+		// ADO:7302 We need a better type here
+		private readonly provideEntryPoint: (
+			runtime: IFluidDataStoreChannel,
+		) => Promise<FluidObject>,
+	) {
+		this.IFluidDataStoreRegistry = new FluidDataStoreRegistry(registryEntries);
+	}
+
+	public get IFluidDataStoreFactory() {
+		return this;
+	}
+
+	public async instantiateDataStore(
+		context: IFluidDataStoreContext,
+		_existing: boolean,
+	): Promise<IFluidDataStoreChannel> {
+		const runtime = new ChannelCollection(
+			context.baseSnapshot,
+			context, // parentContext
+			context.logger,
+			() => {}, // gcNodeUpdated
+			(_nodePath: string) => false, // isDataStoreDeleted
+			new Map(), // aliasMap
+			this.provideEntryPoint,
+		);
+
+		return runtime;
+	}
+}