feat(client): [internal] container extensions and presence use

.changeset/wet-towns-ask.md

@@ -0,0 +1,8 @@
+---
+"@fluidframework/container-runtime": minor
+"__section": feature
+---
+
+Introduce path based message routing
+
+Add ability for runtime to address messages with a `/` separated path scheme. `/runtime/` is reserved for runtime where `undefined` was previously used and data store messages are prefixed with `/channels/`. To enable general sending messages with this scheme, internal `IContainerRuntimeOptionsInternal.pathBasedAddressing` must be enabled. Internally `presence` requires this support under the `/ext/` path and thus should only be used once involved clients are using version 2.33 or later.

.vscode/settings.json

@@ -53,6 +53,7 @@
 		"mocharc",
 		"multinomial",
 		"nonfinite",
+		"privateremarks",
 		"pseudorandomly",
 		"reconnections",
 		"Routerlicious",

docs/docs/build/presence.md

@@ -5,8 +5,7 @@ sidebar_postition: 10
 
 ## Overview
 
-We are introducting a new way to power your ephemeral experiences wth Fluid. Introducing the new Presence APIs (currently in alpha) that provide session-focused utilities for lightweight data sharing and messaging.
-
+We are introducing a new way to power your ephemeral experiences with Fluid. Introducing the new Presence APIs (currently in alpha) that provide session-focused utilities for lightweight data sharing and messaging.
 Collaborative features typically rely on each user maintaining their own temporary state, which is subsequently shared with others. For example, in applications featuring multiplayer cursors, the cursor position of each user signifies their state. This state can be further utilized for various purposes such as indicating typing activity or displaying a user's current selection. This concept is referred to as _presence_.
 
 By leveraging this shared state, applications can provide a seamless and interactive collaborative experience, ensuring that users are always aware of each other's actions and selections in real-time.
@@ -57,21 +56,13 @@ Notifications are special case where no data is retained during a session and al
 
 ## Onboarding
 
-While this package is developing as experimental and other Fluid Framework internals are being updated to accommodate it, a temporary Shared Object must be added within container to gain access.
+To access Presence APIs, use `getPresence()` with any `IFluidContainer`.
 
 ```typescript
-import {
-	getPresenceViaDataObject,
-	ExperimentalPresenceManager,
-} from "@fluidframework/presence/alpha";
-
-const containerSchema = {
-	initialObjects: {
-		presence: ExperimentalPresenceManager,
-	},
-} satisfies ContainerSchema;
+import { getPresence } from "@fluidframework/presence/alpha";
 
-const presence = await getPresenceViaDataObject(container.initialObjects.presence);
+function usePresence(container: IFluidContainer): void {
+   const presence = await getPresence(container);
 ```
 
 ## Limitations

examples/apps/presence-tracker/src/app.ts

@@ -4,6 +4,7 @@
  */
 
 import {
+	getPresence,
 	getPresenceViaDataObject,
 	ExperimentalPresenceManager,
 } from "@fluidframework/presence/alpha";
@@ -16,10 +17,14 @@ import { initializeReactions } from "./reactions.js";
 import { renderControlPanel, renderFocusPresence, renderMousePresence } from "./view.js";
 
 // Define the schema of the Fluid container.
-// This example uses the presence features only, so only that data object is added.
+// This example uses the presence features only, so no data object is required.
+// But the old experimental presence data object is used to check that old path still works.
+// Besides initialObjects is not currently allowed to be empty.
+// That version of presence is compatible with all 2.x runtimes. Long-term support without
+// data object requires 2.32 or later.
 const containerSchema = {
 	initialObjects: {
-		// A Presence Manager object temporarily needs to be placed within container schema
+		// A Presence Manager object placed within container schema for experimental presence access
 		// https://github.com/microsoft/FluidFramework/blob/main/packages/framework/presence/README.md#onboarding
 		presence: ExperimentalPresenceManager,
 	},
@@ -56,8 +61,11 @@ async function start() {
 		({ container } = await client.getContainer(id, containerSchema, "2"));
 	}
 
-	// Retrieve a reference to the presence APIs via the data object.
-	const presence = getPresenceViaDataObject(container.initialObjects.presence);
+	const useDataObject = new URLSearchParams(location.search).has("useDataObject");
+	const presence = useDataObject
+		? // Retrieve a reference to the presence APIs via the data object.
+			getPresenceViaDataObject(container.initialObjects.presence)
+		: getPresence(container);
 
 	// Get the states workspace for the tracker data. This workspace will be created if it doesn't exist.
 	// We create it with no states; we will pass the workspace to the Mouse and Focus trackers, and they will create value

examples/service-clients/azure-client/external-controller/src/app.ts

@@ -11,10 +11,7 @@ import {
 } from "@fluidframework/azure-client";
 import { createDevtoolsLogger, initializeDevtools } from "@fluidframework/devtools/beta";
 import { ISharedMap, IValueChanged, SharedMap } from "@fluidframework/map/legacy";
-import {
-	getPresenceViaDataObject,
-	ExperimentalPresenceManager,
-} from "@fluidframework/presence/alpha";
+import { getPresence } from "@fluidframework/presence/alpha";
 import { createChildLogger } from "@fluidframework/telemetry-utils/legacy";
 // eslint-disable-next-line import/no-internal-modules -- #26985: `test-runtime-utils` internal used in example
 import { InsecureTokenProvider } from "@fluidframework/test-runtime-utils/internal";
@@ -76,9 +73,6 @@ const containerSchema = {
 		/* [id]: DataObject */
 		map1: SharedMap,
 		map2: SharedMap,
-		// A Presence Manager object temporarily needs to be placed within container schema
-		// https://github.com/microsoft/FluidFramework/blob/main/packages/framework/presence/README.md#onboarding
-		presence: ExperimentalPresenceManager,
 	},
 } satisfies ContainerSchema;
 type DiceRollerContainerSchema = typeof containerSchema;
@@ -182,7 +176,7 @@ async function start(): Promise<void> {
 
 	// Biome insist on no semicolon - https://dev.azure.com/fluidframework/internal/_workitems/edit/9083
 	const lastRoll: { die1?: DieValue; die2?: DieValue } = {};
-	const presence = getPresenceViaDataObject(container.initialObjects.presence);
+	const presence = getPresence(container);
 	const states = buildDicePresence(presence).states;
 
 	// Initialize Devtools