feat(client-presence): promote to beta

.changeset/fluffy-donkeys-obey.md

@@ -0,0 +1,9 @@
+---
+"@fluidframework/presence": minor
+"__section": feature
+---
+Presence now available at beta support
+
+Importing via `@fluidframework/presence/beta` is now supported.
+
+Note: `Notifications` support remains only supported via `/alpha` imports. Cast `Presence` to `PresenceWithNotifications` to access notifications only workspace support.

docs/docs/build/presence.md

@@ -59,7 +59,7 @@ Notifications are special case where no data is retained during a session and al
 To access Presence APIs, use `getPresence()` with any `IFluidContainer`.
 
 ```typescript
-import { getPresence } from "@fluidframework/presence/alpha";
+import { getPresence } from "@fluidframework/presence/beta";
 
 function usePresence(container: IFluidContainer): void {
    const presence = await getPresence(container);

examples/apps/ai-collab/src/app/page.tsx

@@ -5,7 +5,7 @@
 
 "use client";
 
-import { getPresence } from "@fluidframework/presence/alpha";
+import { getPresence } from "@fluidframework/presence/beta";
 import {
 	Box,
 	Button,

examples/apps/ai-collab/src/app/presence.ts

@@ -9,7 +9,7 @@ import {
 	type Attendee,
 	type StatesWorkspace,
 	type StatesWorkspaceSchema,
-} from "@fluidframework/presence/alpha";
+} from "@fluidframework/presence/beta";
 
 import { getProfilePhoto } from "@/infra/authHelper";
 

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

@@ -10,8 +10,8 @@ import type {
 	LatestRaw,
 	Presence,
 	StatesWorkspace,
-} from "@fluidframework/presence/alpha";
-import { AttendeeStatus, StateFactory } from "@fluidframework/presence/alpha";
+} from "@fluidframework/presence/beta";
+import { AttendeeStatus, StateFactory } from "@fluidframework/presence/beta";
 
 /**
  * IFocusState is the data that individual session clients share via presence.

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

@@ -10,8 +10,8 @@ import type {
 	Attendee,
 	LatestRaw,
 	StatesWorkspace,
-} from "@fluidframework/presence/alpha";
-import { AttendeeStatus, StateFactory } from "@fluidframework/presence/alpha";
+} from "@fluidframework/presence/beta";
+import { AttendeeStatus, StateFactory } from "@fluidframework/presence/beta";
 
 /**
  * IMousePosition is the data that individual session clients share via presence.

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

@@ -4,7 +4,11 @@
  */
 
 import { Notifications } from "@fluidframework/presence/alpha";
-import type { Attendee, Presence } from "@fluidframework/presence/alpha";
+import type {
+	Attendee,
+	Presence,
+	PresenceWithNotifications,
+} from "@fluidframework/presence/alpha";
 
 import type { IMousePosition, MouseTracker } from "./MouseTracker.js";
 
@@ -17,7 +21,9 @@ export function initializeReactions(presence: Presence, mouseTracker: MouseTrack
 	// Create a notifications workspace to send reactions-related notifications. This workspace will be created if it
 	// doesn't exist. We also create a NotificationsManager. You can also
 	// add presence objects to the workspace later.
-	const notificationsWorkspace = presence.notifications.getWorkspace(
+	const notificationsWorkspace = (
+		presence as PresenceWithNotifications
+	).notifications.getWorkspace(
 		// A unique key identifying this workspace.
 		"name:reactions",
 		{

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

@@ -11,7 +11,7 @@ import {
 } from "@fluidframework/azure-client";
 import { createDevtoolsLogger, initializeDevtools } from "@fluidframework/devtools/beta";
 import { ISharedMap, IValueChanged, SharedMap } from "@fluidframework/map/legacy";
-import { getPresence } from "@fluidframework/presence/alpha";
+import { getPresence } from "@fluidframework/presence/beta";
 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";

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

@@ -8,7 +8,7 @@ import {
 	StateFactory,
 	type StatesWorkspace,
 	type StatesWorkspaceSchema,
-} from "@fluidframework/presence/alpha";
+} from "@fluidframework/presence/beta";
 
 import type { DieValue } from "./controller.js";
 

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

@@ -4,7 +4,7 @@
  */
 
 import { AzureMember, IAzureAudience } from "@fluidframework/azure-client";
-import type { LatestRaw, Presence } from "@fluidframework/presence/alpha";
+import type { LatestRaw, Presence } from "@fluidframework/presence/beta";
 
 import { ICustomUserDetails } from "./app.js";
 import { IDiceRollerController } from "./controller.js";

packages/framework/presence/.eslintrc.cjs

@@ -22,6 +22,7 @@ module.exports = {
 					"@fluidframework/*/internal{,/**}",
 					"*/index.js",
 					"@fluidframework/presence/alpha",
+					"@fluidframework/presence/beta",
 				],
 			},
 		],

packages/framework/presence/README.md

@@ -31,6 +31,8 @@ For more information on the related support guarantees, see [API Support Levels]
 
 To access the `public` ([SemVer](https://semver.org/)) APIs, import via `@fluidframework/presence` like normal.
 
+To access the `beta` APIs, import via `@fluidframework/presence/beta`.
+
 To access the `alpha` APIs, import via `@fluidframework/presence/alpha`.
 
 ## API Documentation
@@ -80,21 +82,15 @@ Notifications are special case where no data is retained during a session and al
 
 ## Onboarding
 
-While this package is developing 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/beta";
 
-const presence = await getPresenceViaDataObject(container.initialObjects.presence);
+function usePresence(container: IFluidContainer): void {
+   const presence = await getPresence(container);
 ```
 
-
 ## Limitations
 
 ### States Reliability

packages/framework/presence/api-extractor/api-extractor-lint-beta.cjs.json

@@ -0,0 +1,5 @@
+{
+	"$schema": "https://developer.microsoft.com/json-schemas/api-extractor/v7/api-extractor.schema.json",
+	"extends": "<projectFolder>/../../../common/build/build-common/api-extractor-lint.entrypoint.json",
+	"mainEntryPointFilePath": "<projectFolder>/dist/beta.d.ts"
+}

packages/framework/presence/api-extractor/api-extractor-lint-beta.esm.json

@@ -0,0 +1,5 @@
+{
+	"$schema": "https://developer.microsoft.com/json-schemas/api-extractor/v7/api-extractor.schema.json",
+	"extends": "<projectFolder>/../../../common/build/build-common/api-extractor-lint.entrypoint.json",
+	"mainEntryPointFilePath": "<projectFolder>/lib/beta.d.ts"
+}