feat(odsp-client): Add OdspContainerServices readonly and sensitivity label event emitters (#25800)

## Description

Portion of #25597 to add read-only state and sensitivity labels events
to OdspContainerServices.

## Reviewer Guidance

I think this PR could be better if it separated read-only events and
sensitivity label events, but it will introduce either merge conflicts
or blocking on either. I think it would be weird to extend
`IEventProvider` without any events, which would allow for async feature
introduction.

Author: znewton

PACKAGES.md

@@ -183,7 +183,7 @@ The dependencies between layers are enforced by the layer-check command._
 
 | Packages | Layer Dependencies |
 | --- | --- |
-| - [@fluidframework/azure-client](/packages/service-clients/azure-client)</br>- [@fluidframework/odsp-client](/packages/service-clients/odsp-client)</br>- [@fluidframework/tinylicious-client](/packages/service-clients/tinylicious-client)</br>&nbsp;</br>&nbsp;</br>&nbsp;</br>&nbsp;</br>&nbsp;</br>&nbsp;</br>&nbsp;</br>&nbsp;</br>&nbsp; | - [Core-Interfaces](#Core-Interfaces)</br>- [Driver-Definitions](#Driver-Definitions)</br>- [Container-Definitions](#Container-Definitions)</br>- [Core-Utils](#Core-Utils)</br>- [Telemetry-Utils](#Telemetry-Utils)</br>- [Driver-Utils](#Driver-Utils)</br>- [Other-Utils](#Other-Utils)</br>- [Driver](#Driver)</br>- [Loader](#Loader)</br>- [Runtime](#Runtime)</br>- [Framework](#Framework)</br>- [Routerlicious-Driver](#Routerlicious-Driver) |
+| - [@fluidframework/azure-client](/packages/service-clients/azure-client)</br>- [@fluidframework/odsp-client](/packages/service-clients/odsp-client)</br>- [@fluidframework/tinylicious-client](/packages/service-clients/tinylicious-client)</br>&nbsp;</br>&nbsp;</br>&nbsp;</br>&nbsp;</br>&nbsp;</br>&nbsp;</br>&nbsp;</br>&nbsp;</br>&nbsp;</br>&nbsp; | - [Core-Interfaces](#Core-Interfaces)</br>- [Driver-Definitions](#Driver-Definitions)</br>- [Container-Definitions](#Container-Definitions)</br>- [Core-Utils](#Core-Utils)</br>- [Client-Utils](#Client-Utils)</br>- [Telemetry-Utils](#Telemetry-Utils)</br>- [Driver-Utils](#Driver-Utils)</br>- [Other-Utils](#Other-Utils)</br>- [Driver](#Driver)</br>- [Loader](#Loader)</br>- [Runtime](#Runtime)</br>- [Framework](#Framework)</br>- [Routerlicious-Driver](#Routerlicious-Driver) |
 
 ### Examples
 

packages/service-clients/odsp-client/api-report/odsp-client.alpha.api.md

@@ -7,6 +7,12 @@
 // @beta
 export type IOdspAudience = IServiceAudience<OdspMember>;
 
+// @beta @sealed
+export interface IOdspContainerServicesEvents {
+    readOnlyStateChanged: () => void;
+    sensitivityLabelsInfoChanged: () => void;
+}
+
 // @beta
 export interface IOdspFluidContainer<TContainerSchema extends ContainerSchema = ContainerSchema> extends IFluidContainer<TContainerSchema> {
     attach(props?: ContainerAttachProps<OdspContainerAttachProps>): Promise<string>;
@@ -54,9 +60,13 @@ export interface OdspContainerAttachProps {
     filePath: string | undefined;
 }
 
-// @beta
-export interface OdspContainerServices {
+// @beta @sealed
+export interface OdspContainerServices extends IDisposable {
     audience: IOdspAudience;
+    // (undocumented)
+    events: Listenable<IOdspContainerServicesEvents>;
+    getReadOnlyState(): boolean | undefined;
+    getSensitivityLabelsInfo(): string | undefined;
 }
 
 // @beta

packages/service-clients/odsp-client/api-report/odsp-client.beta.api.md

@@ -7,6 +7,12 @@
 // @beta
 export type IOdspAudience = IServiceAudience<OdspMember>;
 
+// @beta @sealed
+export interface IOdspContainerServicesEvents {
+    readOnlyStateChanged: () => void;
+    sensitivityLabelsInfoChanged: () => void;
+}
+
 // @beta
 export interface IOdspFluidContainer<TContainerSchema extends ContainerSchema = ContainerSchema> extends IFluidContainer<TContainerSchema> {
     attach(props?: ContainerAttachProps<OdspContainerAttachProps>): Promise<string>;
@@ -54,9 +60,13 @@ export interface OdspContainerAttachProps {
     filePath: string | undefined;
 }
 
-// @beta
-export interface OdspContainerServices {
+// @beta @sealed
+export interface OdspContainerServices extends IDisposable {
     audience: IOdspAudience;
+    // (undocumented)
+    events: Listenable<IOdspContainerServicesEvents>;
+    getReadOnlyState(): boolean | undefined;
+    getSensitivityLabelsInfo(): string | undefined;
 }
 
 // @beta

packages/service-clients/odsp-client/package.json

@@ -104,6 +104,7 @@
 		"temp-directory": "nyc/.nyc_output"
 	},
 	"dependencies": {
+		"@fluid-internal/client-utils": "workspace:~",
 		"@fluidframework/container-definitions": "workspace:~",
 		"@fluidframework/container-loader": "workspace:~",
 		"@fluidframework/core-interfaces": "workspace:~",

packages/service-clients/odsp-client/src/index.ts

@@ -15,6 +15,7 @@
 
 export type {
 	IOdspAudience,
+	IOdspContainerServicesEvents,
 	IOdspFluidContainer,
 	OdspClientProps,
 	OdspConnectionConfig,

packages/service-clients/odsp-client/src/interfaces.ts

@@ -5,7 +5,9 @@
 
 import type {
 	IConfigProviderBase,
+	IDisposable,
 	ITelemetryBaseLogger,
+	Listenable,
 } from "@fluidframework/core-interfaces";
 import type {
 	ContainerAttachProps,
@@ -79,6 +81,25 @@ export interface OdspContainerAttachProps {
 	fileName: string | undefined;
 }
 
+/**
+ * Events emitted by the ODSP container service to notify consumers of select
+ * container changes.
+ * @beta
+ * @sealed
+ */
+export interface IOdspContainerServicesEvents {
+	/**
+	 * Emitted when the read-only state of the container changes.
+	 * Consumers can call `OdspContainerServices.getReadOnlyState()` to get the updated value.
+	 */
+	readOnlyStateChanged: () => void;
+	/**
+	 * Emitted when the sensitivity label of the container changes.
+	 * Consumers can call `OdspContainerServices.getSensitivityLabelsInfo()` to get the updated value.
+	 */
+	sensitivityLabelsInfoChanged: () => void;
+}
+
 /**
  * ODSP version of the IFluidContainer interface.
  * @beta
@@ -106,12 +127,32 @@ export interface IOdspFluidContainer<
  * how the data is handled within the FluidContainer itself, i.e. which data objects or DDSes to
  * use, will not be included here but rather on the FluidContainer class itself.
  * @beta
+ * @sealed
  */
-export interface OdspContainerServices {
+export interface OdspContainerServices extends IDisposable {
+	events: Listenable<IOdspContainerServicesEvents>;
 	/**
 	 * Provides an object that facilitates obtaining information about users present in the Fluid session, as well as listeners for roster changes triggered by users joining or leaving the session.
 	 */
 	audience: IOdspAudience;
+
+	/**
+	 * Gets the read-only state of the container, if available.
+	 * This is not available until the container is in the "Connected" state.
+	 * @remarks
+	 * In the case that the read-only state cannot be determined, wait for the "readOnlyStateChanged" event to be emitted.
+	 * @returns The read-only state (true when readonly, false when editable), or undefined if not available.
+	 */
+	getReadOnlyState(): boolean | undefined;
+	/**
+	 * Gets the sensitivity labels info of the container, if available.
+	 * This is not available until the container is in the "Connected" state, and will only be available
+	 * if sensitivity labels have been applied to the container.
+	 * @remarks
+	 * In the case that the sensitivity labels info are expected but cannot be determined, wait for the "sensitivityLabelChanged" event to be emitted.
+	 * @returns The sensitivity labels info string, or undefined if not available.
+	 */
+	getSensitivityLabelsInfo(): string | undefined;
 }
 
 /**

packages/service-clients/odsp-client/src/odspContainerServices.ts

@@ -3,25 +3,71 @@
  * Licensed under the MIT License.
  */
 
+import { createEmitter } from "@fluid-internal/client-utils";
 import type { IContainer } from "@fluidframework/container-definitions/internal";
+import type { IDisposable, Listenable } from "@fluidframework/core-interfaces";
 import { createServiceAudience } from "@fluidframework/fluid-static/internal";
 
 import type {
 	IOdspAudience,
 	OdspContainerServices as IOdspContainerServices,
+	IOdspContainerServicesEvents,
 } from "./interfaces.js";
 import { createOdspAudienceMember } from "./odspAudience.js";
 
 /**
  * @internal
  */
-export class OdspContainerServices implements IOdspContainerServices {
+export class OdspContainerServices implements IOdspContainerServices, IDisposable {
+	#disposed = false;
+	readonly #container: IContainer;
+
 	public readonly audience: IOdspAudience;
 
+	readonly #events = createEmitter<IOdspContainerServicesEvents>();
+	public get events(): Listenable<IOdspContainerServicesEvents> {
+		return this.#events;
+	}
+
 	public constructor(container: IContainer) {
+		this.#container = container;
+		this.#container.on("readonly", this.#readonlyEventHandler);
+		this.#container.on("metadataUpdate", this.#metadataUpdateEventHandler);
 		this.audience = createServiceAudience({
 			container,
 			createServiceMember: createOdspAudienceMember,
 		});
 	}
+
+	readonly #readonlyEventHandler = (): void => {
+		this.#events.emit("readOnlyStateChanged");
+	};
+
+	readonly #metadataUpdateEventHandler = (metadata: Record<string, string>): void => {
+		if (metadata.sensitivityLabelsInfo !== undefined) {
+			this.#events.emit("sensitivityLabelsInfoChanged");
+		}
+	};
+
+	public get disposed(): boolean {
+		return this.#disposed;
+	}
+
+	public dispose(): void {
+		if (this.#disposed) {
+			return;
+		}
+
+		this.#disposed = true;
+		this.#container.off("readonly", this.#readonlyEventHandler);
+		this.#container.off("metadataUpdate", this.#metadataUpdateEventHandler);
+	}
+
+	public getReadOnlyState(): boolean | undefined {
+		return this.#container.readOnlyInfo.readonly;
+	}
+
+	public getSensitivityLabelsInfo(): string | undefined {
+		return this.#container.containerMetadata.sensitivityLabelsInfo;
+	}
 }