@fluidframework/devtools-core 2.70.0-361248 → 2.70.0-361788

package/lib/ContainerDevtools.d.ts

@@ -9,13 +9,15 @@ import type { HasContainerKey } from "./CommonInterfaces.js";
 import type { ContainerDevtoolsFeatureFlags } from "./Features.js";
 /**
  * Properties for registering a {@link @fluidframework/container-definitions#IContainer} with the Devtools.
- * @alpha
+ * @beta
+ * @input
+ * @sealed
  */
 export interface ContainerDevtoolsProps extends HasContainerKey {
     /**
      * The Container to register with the Devtools.
      */
-    container: IContainer;
+    readonly container: IContainer;
     /**
      * (optional) Distributed Data Structures (DDSs) associated with the
      * {@link ContainerDevtoolsProps.container | Container}.
@@ -29,7 +31,7 @@ export interface ContainerDevtoolsProps extends HasContainerKey {
      *
      * @privateRemarks TODO: rename this to make it more clear that this data does not *belong* to the Container.
      */
-    containerData?: Record<string, IFluidLoadable>;
+    readonly containerData?: Record<string, IFluidLoadable>;
 }
 /**
  * {@link IContainerDevtools} implementation for real containers.

package/lib/ContainerDevtools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ContainerDevtools.d.ts","sourceRoot":"","sources":["../src/ContainerDevtools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gDAAgD,CAAC;AACjF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEtE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,eAAe,CAAC;AAQnE;;;GAGG;AACH,MAAM,WAAW,sBAAuB,SAAQ,eAAe;IAC9D;;OAEG;IACH,SAAS,EAAE,UAAU,CAAC;IAEtB;;;;;;;;;;;;OAYG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAG/C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,qBAAa,iBAAkB,SAAQ,YAAY,CAAC,UAAU,CAAC;IAC9D;;OAEG;IACH,cAAuB,SAAS,IAAI,UAAU,CAE7C;IAED,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;gBAErB,KAAK,EAAE,sBAAsB;cAwC7B,oBAAoB,IAAI,6BAA6B;CAMxE"}
+{"version":3,"file":"ContainerDevtools.d.ts","sourceRoot":"","sources":["../src/ContainerDevtools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gDAAgD,CAAC;AACjF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEtE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,eAAe,CAAC;AAQnE;;;;;GAKG;AACH,MAAM,WAAW,sBAAuB,SAAQ,eAAe;IAC9D;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC;IAE/B;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAGxD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,qBAAa,iBAAkB,SAAQ,YAAY,CAAC,UAAU,CAAC;IAC9D;;OAEG;IACH,cAAuB,SAAS,IAAI,UAAU,CAE7C;IAED,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;gBAErB,KAAK,EAAE,sBAAsB;cAwC7B,oBAAoB,IAAI,6BAA6B;CAMxE"}

package/lib/ContainerDevtools.js.map

@@ -1 +1 @@
-{"version":3,"file":"ContainerDevtools.js","sourceRoot":"","sources":["../src/ContainerDevtools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,OAAO,EACN,cAAc,EACd,gBAAgB,EAChB,mBAAmB,GAEnB,MAAM,sBAAsB,CAAC;AA8B9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,MAAM,OAAO,iBAAkB,SAAQ,YAAwB;IAC9D;;OAEG;IACH,IAAuB,SAAS;QAC/B,OAAO,IAAI,CAAC,UAAU,CAAC;IACxB,CAAC;IAID,YAAmB,KAA6B;QAC/C,4DAA4D;QAC5D,MAAM,gBAAgB,GAAoB;YACzC,CAAC,gBAAgB,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE;gBACxD,MAAM,OAAO,GAAG,cAA0C,CAAC;gBAC3D,IAAI,OAAO,CAAC,IAAI,CAAC,YAAY,KAAK,KAAK,CAAC,YAAY,EAAE,CAAC;oBACtD,KAAK,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;oBAC1B,OAAO,IAAI,CAAC;gBACb,CAAC;gBACD,OAAO,KAAK,CAAC;YACd,CAAC;YACD,CAAC,mBAAmB,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE;gBAC3D,MAAM,OAAO,GAAG,cAA6C,CAAC;gBAC9D,IAAI,OAAO,CAAC,IAAI,CAAC,YAAY,KAAK,KAAK,CAAC,YAAY,EAAE,CAAC;oBACtD,KAAK,CAAC,SAAS,CAAC,UAAU;oBACzB,6DAA6D;qBAC7D,CAAC;oBACF,OAAO,IAAI,CAAC;gBACb,CAAC;gBACD,OAAO,KAAK,CAAC;YACd,CAAC;YACD,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE;gBACtD,MAAM,OAAO,GAAG,cAAwC,CAAC;gBACzD,IAAI,OAAO,CAAC,IAAI,CAAC,YAAY,KAAK,KAAK,CAAC,YAAY,EAAE,CAAC;oBACtD,KAAK,CAAC,SAAS,CAAC,KAAK,EAAC,6DAA6D,CAAC,CAAC;oBACrF,OAAO,IAAI,CAAC;gBACb,CAAC;gBACD,OAAO,KAAK,CAAC;YACd,CAAC;SACD,CAAC;QAEF,KAAK,CAAC,KAAK,CAAC,YAAY,EAAE,gBAAgB,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;QAEjE,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC;QAElC,4DAA4D;QAC5D,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC3B,IAAI,CAAC,kBAAkB,EAAE,CAAC;IAC3B,CAAC;IAEkB,oBAAoB;QACtC,OAAO;YACN,0BAA0B,EAAE,IAAI,CAAC,aAAa,KAAK,SAAS;YAC5D,uBAAuB,EAAE,IAAI;SAC7B,CAAC;IACH,CAAC;CACD","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport type { IContainer } from \"@fluidframework/container-definitions/internal\";\nimport type { IFluidLoadable } from \"@fluidframework/core-interfaces\";\n\nimport { BaseDevtools } from \"./BaseDevtools.js\";\nimport type { HasContainerKey } from \"./CommonInterfaces.js\";\nimport type { ContainerDevtoolsFeatureFlags } from \"./Features.js\";\nimport {\n\tCloseContainer,\n\tConnectContainer,\n\tDisconnectContainer,\n\ttype InboundHandlers,\n} from \"./messaging/index.js\";\n\n/**\n * Properties for registering a {@link @fluidframework/container-definitions#IContainer} with the Devtools.\n * @alpha\n */\nexport interface ContainerDevtoolsProps extends HasContainerKey {\n\t/**\n\t * The Container to register with the Devtools.\n\t */\n\tcontainer: IContainer;\n\n\t/**\n\t * (optional) Distributed Data Structures (DDSs) associated with the\n\t * {@link ContainerDevtoolsProps.container | Container}.\n\t *\n\t * @remarks\n\t *\n\t * Providing this data will enable associated tooling to visualize the Fluid data reachable from the provided\n\t * objects.\n\t *\n\t * Fluid DevTools will not mutate this data.\n\t *\n\t * @privateRemarks TODO: rename this to make it more clear that this data does not *belong* to the Container.\n\t */\n\tcontainerData?: Record<string, IFluidLoadable>;\n\n\t// TODO: Add ability for customers to specify custom visualizer overrides\n}\n\n/**\n * {@link IContainerDevtools} implementation for real containers.\n *\n * @remarks\n *\n * This class listens to incoming messages from the window (globalThis), and posts messages to it upon relevant\n * state changes and when requested.\n *\n * **Messages it listens for (if the {@link HasContainerKey.containerKey} matches):**\n *\n * - {@link GetContainerDevtoolsFeatures.Message}: When received, {@link ContainerDevtoolsFeatures.Message} will be\n * posted in response.\n *\n * - {@link GetContainerState.Message}: When received, {@link ContainerStateChange.Message} will be posted in response.\n *\n * - {@link ConnectContainer.Message}: When received, {@link @fluidframework/container-definitions#IContainer.connect}\n * will be called on the {@link ContainerDevtools.container} (if it is disconnected).\n *\n * - {@link DisconnectContainer.Message}: When received, {@link @fluidframework/container-definitions#IContainer.disconnect}\n * will be called on the {@link ContainerDevtools.container} (if it is connected).\n *\n * - {@link CloseContainer.Message}: When received, {@link @fluidframework/container-definitions#IContainer.close}\n * will be called on the {@link ContainerDevtools.container}.\n *\n * - {@link GetAudienceSummary.Message}: When received, {@link AudienceSummary.Message} will be posted in response.\n *\n * - {@link GetRootDataVisualizations.Message}: When received, {@link RootDataVisualizations.Message} will be posted\n * in response.\n *\n * - {@link GetDataVisualization.Message}: When received, {@link DataVisualization.Message} will be posted in response.\n *\n * **Messages it posts:**\n *\n * - {@link ContainerDevtoolsFeatures.Message}: Posted only when requested via {@link GetContainerDevtoolsFeatures.Message}.\n *\n * - {@link AudienceSummary.Message}: Posted any time the Container's Audience state changes, or when requested\n * (via {@link GetAudienceSummary.Message}).\n *\n * - {@link ContainerStateChange.Message}: Posted any time relevant Container state changes,\n * or when requested (via {@link GetContainerState.Message}).\n *\n * - {@link RootDataVisualizations.Message}: Posted when requested via {@link GetRootDataVisualizations.Message}.\n *\n * - {@link DataVisualization.Message}: Posted when requested via {@link GetDataVisualization.Message}, or when\n * a change has occurred on the associated DDS, reachable from the visualization graph.\n *\n * @sealed\n */\nexport class ContainerDevtools extends BaseDevtools<IContainer> {\n\t/**\n\t * The registered Container.\n\t */\n\tprotected override get container(): IContainer {\n\t\treturn this._container;\n\t}\n\n\tprivate readonly _container: IContainer;\n\n\tpublic constructor(props: ContainerDevtoolsProps) {\n\t\t// Create specific message handlers for container operations\n\t\tconst specificHandlers: InboundHandlers = {\n\t\t\t[ConnectContainer.MessageType]: async (untypedMessage) => {\n\t\t\t\tconst message = untypedMessage as ConnectContainer.Message;\n\t\t\t\tif (message.data.containerKey === props.containerKey) {\n\t\t\t\t\tprops.container.connect();\n\t\t\t\t\treturn true;\n\t\t\t\t}\n\t\t\t\treturn false;\n\t\t\t},\n\t\t\t[DisconnectContainer.MessageType]: async (untypedMessage) => {\n\t\t\t\tconst message = untypedMessage as DisconnectContainer.Message;\n\t\t\t\tif (message.data.containerKey === props.containerKey) {\n\t\t\t\t\tprops.container.disconnect(\n\t\t\t\t\t\t/* TODO: Specify devtools reason here once it is supported */\n\t\t\t\t\t);\n\t\t\t\t\treturn true;\n\t\t\t\t}\n\t\t\t\treturn false;\n\t\t\t},\n\t\t\t[CloseContainer.MessageType]: async (untypedMessage) => {\n\t\t\t\tconst message = untypedMessage as CloseContainer.Message;\n\t\t\t\tif (message.data.containerKey === props.containerKey) {\n\t\t\t\t\tprops.container.close(/* TODO: Specify devtools reason here once it is supported */);\n\t\t\t\t\treturn true;\n\t\t\t\t}\n\t\t\t\treturn false;\n\t\t\t},\n\t\t};\n\n\t\tsuper(props.containerKey, specificHandlers, props.containerData);\n\n\t\tthis._container = props.container;\n\n\t\t// Bind container and audience events after container is set\n\t\tthis.bindContainerEvents();\n\t\tthis.bindAudienceEvents();\n\t}\n\n\tprotected override getSupportedFeatures(): ContainerDevtoolsFeatureFlags {\n\t\treturn {\n\t\t\tcontainerDataVisualization: this.containerData !== undefined,\n\t\t\tcanModifyContainerState: true,\n\t\t};\n\t}\n}\n"]}
+{"version":3,"file":"ContainerDevtools.js","sourceRoot":"","sources":["../src/ContainerDevtools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,OAAO,EACN,cAAc,EACd,gBAAgB,EAChB,mBAAmB,GAEnB,MAAM,sBAAsB,CAAC;AAgC9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,MAAM,OAAO,iBAAkB,SAAQ,YAAwB;IAC9D;;OAEG;IACH,IAAuB,SAAS;QAC/B,OAAO,IAAI,CAAC,UAAU,CAAC;IACxB,CAAC;IAID,YAAmB,KAA6B;QAC/C,4DAA4D;QAC5D,MAAM,gBAAgB,GAAoB;YACzC,CAAC,gBAAgB,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE;gBACxD,MAAM,OAAO,GAAG,cAA0C,CAAC;gBAC3D,IAAI,OAAO,CAAC,IAAI,CAAC,YAAY,KAAK,KAAK,CAAC,YAAY,EAAE,CAAC;oBACtD,KAAK,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;oBAC1B,OAAO,IAAI,CAAC;gBACb,CAAC;gBACD,OAAO,KAAK,CAAC;YACd,CAAC;YACD,CAAC,mBAAmB,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE;gBAC3D,MAAM,OAAO,GAAG,cAA6C,CAAC;gBAC9D,IAAI,OAAO,CAAC,IAAI,CAAC,YAAY,KAAK,KAAK,CAAC,YAAY,EAAE,CAAC;oBACtD,KAAK,CAAC,SAAS,CAAC,UAAU;oBACzB,6DAA6D;qBAC7D,CAAC;oBACF,OAAO,IAAI,CAAC;gBACb,CAAC;gBACD,OAAO,KAAK,CAAC;YACd,CAAC;YACD,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE;gBACtD,MAAM,OAAO,GAAG,cAAwC,CAAC;gBACzD,IAAI,OAAO,CAAC,IAAI,CAAC,YAAY,KAAK,KAAK,CAAC,YAAY,EAAE,CAAC;oBACtD,KAAK,CAAC,SAAS,CAAC,KAAK,EAAC,6DAA6D,CAAC,CAAC;oBACrF,OAAO,IAAI,CAAC;gBACb,CAAC;gBACD,OAAO,KAAK,CAAC;YACd,CAAC;SACD,CAAC;QAEF,KAAK,CAAC,KAAK,CAAC,YAAY,EAAE,gBAAgB,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;QAEjE,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC;QAElC,4DAA4D;QAC5D,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC3B,IAAI,CAAC,kBAAkB,EAAE,CAAC;IAC3B,CAAC;IAEkB,oBAAoB;QACtC,OAAO;YACN,0BAA0B,EAAE,IAAI,CAAC,aAAa,KAAK,SAAS;YAC5D,uBAAuB,EAAE,IAAI;SAC7B,CAAC;IACH,CAAC;CACD","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport type { IContainer } from \"@fluidframework/container-definitions/internal\";\nimport type { IFluidLoadable } from \"@fluidframework/core-interfaces\";\n\nimport { BaseDevtools } from \"./BaseDevtools.js\";\nimport type { HasContainerKey } from \"./CommonInterfaces.js\";\nimport type { ContainerDevtoolsFeatureFlags } from \"./Features.js\";\nimport {\n\tCloseContainer,\n\tConnectContainer,\n\tDisconnectContainer,\n\ttype InboundHandlers,\n} from \"./messaging/index.js\";\n\n/**\n * Properties for registering a {@link @fluidframework/container-definitions#IContainer} with the Devtools.\n * @beta\n * @input\n * @sealed\n */\nexport interface ContainerDevtoolsProps extends HasContainerKey {\n\t/**\n\t * The Container to register with the Devtools.\n\t */\n\treadonly container: IContainer;\n\n\t/**\n\t * (optional) Distributed Data Structures (DDSs) associated with the\n\t * {@link ContainerDevtoolsProps.container | Container}.\n\t *\n\t * @remarks\n\t *\n\t * Providing this data will enable associated tooling to visualize the Fluid data reachable from the provided\n\t * objects.\n\t *\n\t * Fluid DevTools will not mutate this data.\n\t *\n\t * @privateRemarks TODO: rename this to make it more clear that this data does not *belong* to the Container.\n\t */\n\treadonly containerData?: Record<string, IFluidLoadable>;\n\n\t// TODO: Add ability for customers to specify custom visualizer overrides\n}\n\n/**\n * {@link IContainerDevtools} implementation for real containers.\n *\n * @remarks\n *\n * This class listens to incoming messages from the window (globalThis), and posts messages to it upon relevant\n * state changes and when requested.\n *\n * **Messages it listens for (if the {@link HasContainerKey.containerKey} matches):**\n *\n * - {@link GetContainerDevtoolsFeatures.Message}: When received, {@link ContainerDevtoolsFeatures.Message} will be\n * posted in response.\n *\n * - {@link GetContainerState.Message}: When received, {@link ContainerStateChange.Message} will be posted in response.\n *\n * - {@link ConnectContainer.Message}: When received, {@link @fluidframework/container-definitions#IContainer.connect}\n * will be called on the {@link ContainerDevtools.container} (if it is disconnected).\n *\n * - {@link DisconnectContainer.Message}: When received, {@link @fluidframework/container-definitions#IContainer.disconnect}\n * will be called on the {@link ContainerDevtools.container} (if it is connected).\n *\n * - {@link CloseContainer.Message}: When received, {@link @fluidframework/container-definitions#IContainer.close}\n * will be called on the {@link ContainerDevtools.container}.\n *\n * - {@link GetAudienceSummary.Message}: When received, {@link AudienceSummary.Message} will be posted in response.\n *\n * - {@link GetRootDataVisualizations.Message}: When received, {@link RootDataVisualizations.Message} will be posted\n * in response.\n *\n * - {@link GetDataVisualization.Message}: When received, {@link DataVisualization.Message} will be posted in response.\n *\n * **Messages it posts:**\n *\n * - {@link ContainerDevtoolsFeatures.Message}: Posted only when requested via {@link GetContainerDevtoolsFeatures.Message}.\n *\n * - {@link AudienceSummary.Message}: Posted any time the Container's Audience state changes, or when requested\n * (via {@link GetAudienceSummary.Message}).\n *\n * - {@link ContainerStateChange.Message}: Posted any time relevant Container state changes,\n * or when requested (via {@link GetContainerState.Message}).\n *\n * - {@link RootDataVisualizations.Message}: Posted when requested via {@link GetRootDataVisualizations.Message}.\n *\n * - {@link DataVisualization.Message}: Posted when requested via {@link GetDataVisualization.Message}, or when\n * a change has occurred on the associated DDS, reachable from the visualization graph.\n *\n * @sealed\n */\nexport class ContainerDevtools extends BaseDevtools<IContainer> {\n\t/**\n\t * The registered Container.\n\t */\n\tprotected override get container(): IContainer {\n\t\treturn this._container;\n\t}\n\n\tprivate readonly _container: IContainer;\n\n\tpublic constructor(props: ContainerDevtoolsProps) {\n\t\t// Create specific message handlers for container operations\n\t\tconst specificHandlers: InboundHandlers = {\n\t\t\t[ConnectContainer.MessageType]: async (untypedMessage) => {\n\t\t\t\tconst message = untypedMessage as ConnectContainer.Message;\n\t\t\t\tif (message.data.containerKey === props.containerKey) {\n\t\t\t\t\tprops.container.connect();\n\t\t\t\t\treturn true;\n\t\t\t\t}\n\t\t\t\treturn false;\n\t\t\t},\n\t\t\t[DisconnectContainer.MessageType]: async (untypedMessage) => {\n\t\t\t\tconst message = untypedMessage as DisconnectContainer.Message;\n\t\t\t\tif (message.data.containerKey === props.containerKey) {\n\t\t\t\t\tprops.container.disconnect(\n\t\t\t\t\t\t/* TODO: Specify devtools reason here once it is supported */\n\t\t\t\t\t);\n\t\t\t\t\treturn true;\n\t\t\t\t}\n\t\t\t\treturn false;\n\t\t\t},\n\t\t\t[CloseContainer.MessageType]: async (untypedMessage) => {\n\t\t\t\tconst message = untypedMessage as CloseContainer.Message;\n\t\t\t\tif (message.data.containerKey === props.containerKey) {\n\t\t\t\t\tprops.container.close(/* TODO: Specify devtools reason here once it is supported */);\n\t\t\t\t\treturn true;\n\t\t\t\t}\n\t\t\t\treturn false;\n\t\t\t},\n\t\t};\n\n\t\tsuper(props.containerKey, specificHandlers, props.containerData);\n\n\t\tthis._container = props.container;\n\n\t\t// Bind container and audience events after container is set\n\t\tthis.bindContainerEvents();\n\t\tthis.bindAudienceEvents();\n\t}\n\n\tprotected override getSupportedFeatures(): ContainerDevtoolsFeatureFlags {\n\t\treturn {\n\t\t\tcontainerDataVisualization: this.containerData !== undefined,\n\t\t\tcanModifyContainerState: true,\n\t\t};\n\t}\n}\n"]}

package/lib/ContainerRuntimeDevtools.d.ts

@@ -13,7 +13,8 @@ import type { DecomposedContainer } from "./DecomposedContainer.js";
 import type { ContainerDevtoolsFeatureFlags } from "./Features.js";
 /**
  * Properties for registering a container runtime with the Devtools.
- * @alpha
+ * @beta
+ * @sealed
  * @input
  */
 export interface ContainerRuntimeProps {
@@ -24,7 +25,7 @@ export interface ContainerRuntimeProps {
     /**
      * Optional label for the container runtime replacing the guid generated by {@link @fluidframework/container-runtime#IContainerRuntime.generateDocumentUniqueId}.
      */
-    label?: string;
+    readonly label?: string;
 }
 /**
  * Properties for constructing a {@link ContainerRuntimeDevtools} instance.

package/lib/ContainerRuntimeDevtools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ContainerRuntimeDevtools.d.ts","sourceRoot":"","sources":["../src/ContainerRuntimeDevtools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EACX,WAAW,EACX,SAAS,EACT,gBAAgB,EAChB,MAAM,gDAAgD,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAEnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wDAAwD,CAAC;AAChG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAGtE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,eAAe,CAAC;AAGnE;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACrC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IAEpC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,wCAAwC;IACxD;;OAEG;IACH,YAAY,EAAE,YAAY,CAAC;IAE3B;;OAEG;IACH,SAAS,EAAE,mBAAmB,CAAC;IAE/B;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC/C;AAED;;;;;;;;;;GAUG;AACH,qBAAa,wBAAyB,SAAQ,YAAY,CAAC,mBAAmB,CAAC;IAC9E;;OAEG;IACH,cAAuB,SAAS,IAAI,mBAAmB,CAEtD;IAED,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;gBAE9B,KAAK,EAAE,wCAAwC;cAa/C,oBAAoB,IAAI,6BAA6B;IAQxE;;OAEG;IACI,QAAQ,IAAI,OAAO;CAI1B;AAED;;;;GAIG;AACH,qBAAa,sCACZ,SAAQ,iBAAiB,CAAC,gBAAgB,CAC1C,YAAW,mBAAmB;IAE9B,OAAO,CAAC,SAAS,CAAS;gBAEP,OAAO,EAAE,iBAAiB;IAW7C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAwC;IACxE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CACC;IAClC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA4C;IAChF,OAAO,CAAC,QAAQ,CAAC,eAAe,CAK9B;IAEF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAE5C,IAAW,QAAQ,IAAI,SAAS,CAE/B;IAED,IAAW,QAAQ,IAAI,MAAM,GAAG,SAAS,CAExC;IAED,IAAW,WAAW,IAAI,WAAW,CAEpC;IAED,IAAW,eAAe,IAAI,eAAe,CAG5C;IAED,IAAW,MAAM,IAAI,OAAO,CAE3B;IAED,IAAW,YAAY,IAAI;QAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAOzD;CACD"}
+{"version":3,"file":"ContainerRuntimeDevtools.d.ts","sourceRoot":"","sources":["../src/ContainerRuntimeDevtools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EACX,WAAW,EACX,SAAS,EACT,gBAAgB,EAChB,MAAM,gDAAgD,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAEnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wDAAwD,CAAC;AAChG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAGtE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,eAAe,CAAC;AAGnE;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACrC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IAEpC;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,wCAAwC;IACxD;;OAEG;IACH,YAAY,EAAE,YAAY,CAAC;IAE3B;;OAEG;IACH,SAAS,EAAE,mBAAmB,CAAC;IAE/B;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC/C;AAED;;;;;;;;;;GAUG;AACH,qBAAa,wBAAyB,SAAQ,YAAY,CAAC,mBAAmB,CAAC;IAC9E;;OAEG;IACH,cAAuB,SAAS,IAAI,mBAAmB,CAEtD;IAED,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;gBAE9B,KAAK,EAAE,wCAAwC;cAa/C,oBAAoB,IAAI,6BAA6B;IAQxE;;OAEG;IACI,QAAQ,IAAI,OAAO;CAI1B;AAED;;;;GAIG;AACH,qBAAa,sCACZ,SAAQ,iBAAiB,CAAC,gBAAgB,CAC1C,YAAW,mBAAmB;IAE9B,OAAO,CAAC,SAAS,CAAS;gBAEP,OAAO,EAAE,iBAAiB;IAW7C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAwC;IACxE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CACC;IAClC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA4C;IAChF,OAAO,CAAC,QAAQ,CAAC,eAAe,CAK9B;IAEF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAE5C,IAAW,QAAQ,IAAI,SAAS,CAE/B;IAED,IAAW,QAAQ,IAAI,MAAM,GAAG,SAAS,CAExC;IAED,IAAW,WAAW,IAAI,WAAW,CAEpC;IAED,IAAW,eAAe,IAAI,eAAe,CAG5C;IAED,IAAW,MAAM,IAAI,OAAO,CAE3B;IAED,IAAW,YAAY,IAAI;QAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAOzD;CACD"}

package/lib/ContainerRuntimeDevtools.js.map

@@ -1 +1 @@
-{"version":3,"file":"ContainerRuntimeDevtools.js","sourceRoot":"","sources":["../src/ContainerRuntimeDevtools.ts"],"names":[],"mappings":"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","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { TypedEventEmitter } from \"@fluid-internal/client-utils\";\nimport type {\n\tAttachState,\n\tIAudience,\n\tIContainerEvents,\n} from \"@fluidframework/container-definitions/internal\";\nimport { ConnectionState } from \"@fluidframework/container-loader\";\nimport { ContainerRuntime } from \"@fluidframework/container-runtime/internal\";\nimport type { IContainerRuntime } from \"@fluidframework/container-runtime-definitions/internal\";\nimport type { IFluidLoadable } from \"@fluidframework/core-interfaces\";\nimport { assert } from \"@fluidframework/core-utils/internal\";\n\nimport { BaseDevtools } from \"./BaseDevtools.js\";\nimport type { ContainerKey } from \"./CommonInterfaces.js\";\nimport type { DecomposedContainer } from \"./DecomposedContainer.js\";\nimport type { ContainerDevtoolsFeatureFlags } from \"./Features.js\";\nimport type { InboundHandlers } from \"./messaging/index.js\";\n\n/**\n * Properties for registering a container runtime with the Devtools.\n * @alpha\n * @input\n */\nexport interface ContainerRuntimeProps {\n\t/**\n\t * The container runtime to register with the Devtools.\n\t */\n\treadonly runtime: IContainerRuntime;\n\n\t/**\n\t * Optional label for the container runtime replacing the guid generated by {@link @fluidframework/container-runtime#IContainerRuntime.generateDocumentUniqueId}.\n\t */\n\tlabel?: string;\n}\n\n/**\n * Properties for constructing a {@link ContainerRuntimeDevtools} instance.\n */\nexport interface ContainerRuntimeDevtoolsConstructorProps {\n\t/**\n\t * The container key to use for this container runtime.\n\t */\n\tcontainerKey: ContainerKey;\n\n\t/**\n\t * The decomposed container wrapping the container runtime.\n\t */\n\tcontainer: DecomposedContainer;\n\n\t/**\n\t * (optional) Data associated with the container runtime.\n\t */\n\tcontainerData?: Record<string, IFluidLoadable>;\n}\n\n/**\n * {@link IContainerDevtools} implementation for container runtimes.\n *\n * @remarks\n *\n * This class provides devtools functionality for container runtimes that don't support\n * container-level operations like connect/disconnect/close. Container runtimes represent\n * the internal runtime state and don't emit \"closed\" events like IContainer does.\n *\n * @sealed\n */\nexport class ContainerRuntimeDevtools extends BaseDevtools<DecomposedContainer> {\n\t/**\n\t * The registered container runtime's decomposed container.\n\t */\n\tprotected override get container(): DecomposedContainer {\n\t\treturn this._container;\n\t}\n\n\tprivate readonly _container: DecomposedContainer;\n\n\tpublic constructor(props: ContainerRuntimeDevtoolsConstructorProps) {\n\t\t// Container runtimes don't support connection operations, so pass empty handlers\n\t\tconst specificHandlers: InboundHandlers = {};\n\n\t\tsuper(props.containerKey, specificHandlers, props.containerData);\n\n\t\tthis._container = props.container;\n\n\t\t// Bind container and audience events after container is set\n\t\tthis.bindContainerEvents();\n\t\tthis.bindAudienceEvents();\n\t}\n\n\tprotected override getSupportedFeatures(): ContainerDevtoolsFeatureFlags {\n\t\treturn {\n\t\t\tcontainerDataVisualization: this.containerData !== undefined,\n\t\t\t// Container runtimes do not have direct control over container lifecycle\n\t\t\tcanModifyContainerState: false,\n\t\t};\n\t}\n\n\t/**\n\t * {@inheritDoc IContainerDevtools.isClosed}\n\t */\n\tpublic isClosed(): boolean {\n\t\t// Container runtimes cannot be closed directly\n\t\treturn false;\n\t}\n}\n\n/**\n * Implementation of {@link DecomposedContainer} that wraps an {@link @fluidframework/container-runtime-definitions/internal#IContainerRuntime}.\n * @remarks\n * This class provides a bridge between {@link @fluidframework/container-runtime-definitions/internal#IContainerRuntime} and the devtools system by exposing runtime properties and events.\n */\nexport class DecomposedContainerForContainerRuntime\n\textends TypedEventEmitter<IContainerEvents>\n\timplements DecomposedContainer\n{\n\tprivate _disposed = false; // Track actual disposed state\n\n\tpublic constructor(runtime: IContainerRuntime) {\n\t\tsuper();\n\t\tthis.runtime = runtime;\n\t\t// Note: IContainerRuntime doesn't emit \"closed\" events like IContainer does\n\t\t// Only bind to events that IContainerRuntime actually supports\n\t\truntime.on(\"attached\", this.attachedHandler);\n\t\truntime.on(\"connected\", this.connectedHandler);\n\t\truntime.on(\"disconnected\", this.disconnectedHandler);\n\t\truntime.on(\"dispose\", this.disposedHandler);\n\t}\n\n\tprivate readonly attachedHandler = (): boolean => this.emit(\"attached\");\n\tprivate readonly connectedHandler = (clientId: string): boolean =>\n\t\tthis.emit(\"connected\", clientId);\n\tprivate readonly disconnectedHandler = (): boolean => this.emit(\"disconnected\");\n\tprivate readonly disposedHandler = (): boolean => {\n\t\t// IContainerRuntime emits \"dispose\" (no error) but we emit \"disposed\" to match IContainerEvents\n\t\t// Since IContainerRuntime doesn't provide error info, we emit without error parameter\n\t\tthis._disposed = true; // Mark as disposed when dispose event occurs\n\t\treturn this.emit(\"disposed\");\n\t};\n\n\tprivate readonly runtime: IContainerRuntime;\n\n\tpublic get audience(): IAudience {\n\t\treturn this.runtime.getAudience();\n\t}\n\n\tpublic get clientId(): string | undefined {\n\t\treturn this.runtime.clientId;\n\t}\n\n\tpublic get attachState(): AttachState {\n\t\treturn this.runtime.attachState;\n\t}\n\n\tpublic get connectionState(): ConnectionState {\n\t\t// Normal connection state logic - readonly state is handled separately via readOnlyInfo\n\t\treturn this.runtime.connected ? ConnectionState.Connected : ConnectionState.Disconnected;\n\t}\n\n\tpublic get closed(): boolean {\n\t\treturn this._disposed; // IContainerRuntime doesn't have a \"closed\" state - only \"disconnected\" (reconnectable) and \"disposed\" (permanent)\n\t}\n\n\tpublic get readOnlyInfo(): { readonly readonly?: boolean } {\n\t\t// IContainerRuntime doesn't expose readonly in its interface, but the implementation has isReadOnly()\n\t\tassert(\n\t\t\tthis.runtime instanceof ContainerRuntime,\n\t\t\t0xc2e /* DecomposedContainerForContainerRuntime is not a ContainerRuntime */,\n\t\t);\n\t\treturn { readonly: this.runtime.isReadOnly() };\n\t}\n}\n"]}
+{"version":3,"file":"ContainerRuntimeDevtools.js","sourceRoot":"","sources":["../src/ContainerRuntimeDevtools.ts"],"names":[],"mappings":"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","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { TypedEventEmitter } from \"@fluid-internal/client-utils\";\nimport type {\n\tAttachState,\n\tIAudience,\n\tIContainerEvents,\n} from \"@fluidframework/container-definitions/internal\";\nimport { ConnectionState } from \"@fluidframework/container-loader\";\nimport { ContainerRuntime } from \"@fluidframework/container-runtime/internal\";\nimport type { IContainerRuntime } from \"@fluidframework/container-runtime-definitions/internal\";\nimport type { IFluidLoadable } from \"@fluidframework/core-interfaces\";\nimport { assert } from \"@fluidframework/core-utils/internal\";\n\nimport { BaseDevtools } from \"./BaseDevtools.js\";\nimport type { ContainerKey } from \"./CommonInterfaces.js\";\nimport type { DecomposedContainer } from \"./DecomposedContainer.js\";\nimport type { ContainerDevtoolsFeatureFlags } from \"./Features.js\";\nimport type { InboundHandlers } from \"./messaging/index.js\";\n\n/**\n * Properties for registering a container runtime with the Devtools.\n * @beta\n * @sealed\n * @input\n */\nexport interface ContainerRuntimeProps {\n\t/**\n\t * The container runtime to register with the Devtools.\n\t */\n\treadonly runtime: IContainerRuntime;\n\n\t/**\n\t * Optional label for the container runtime replacing the guid generated by {@link @fluidframework/container-runtime#IContainerRuntime.generateDocumentUniqueId}.\n\t */\n\treadonly label?: string;\n}\n\n/**\n * Properties for constructing a {@link ContainerRuntimeDevtools} instance.\n */\nexport interface ContainerRuntimeDevtoolsConstructorProps {\n\t/**\n\t * The container key to use for this container runtime.\n\t */\n\tcontainerKey: ContainerKey;\n\n\t/**\n\t * The decomposed container wrapping the container runtime.\n\t */\n\tcontainer: DecomposedContainer;\n\n\t/**\n\t * (optional) Data associated with the container runtime.\n\t */\n\tcontainerData?: Record<string, IFluidLoadable>;\n}\n\n/**\n * {@link IContainerDevtools} implementation for container runtimes.\n *\n * @remarks\n *\n * This class provides devtools functionality for container runtimes that don't support\n * container-level operations like connect/disconnect/close. Container runtimes represent\n * the internal runtime state and don't emit \"closed\" events like IContainer does.\n *\n * @sealed\n */\nexport class ContainerRuntimeDevtools extends BaseDevtools<DecomposedContainer> {\n\t/**\n\t * The registered container runtime's decomposed container.\n\t */\n\tprotected override get container(): DecomposedContainer {\n\t\treturn this._container;\n\t}\n\n\tprivate readonly _container: DecomposedContainer;\n\n\tpublic constructor(props: ContainerRuntimeDevtoolsConstructorProps) {\n\t\t// Container runtimes don't support connection operations, so pass empty handlers\n\t\tconst specificHandlers: InboundHandlers = {};\n\n\t\tsuper(props.containerKey, specificHandlers, props.containerData);\n\n\t\tthis._container = props.container;\n\n\t\t// Bind container and audience events after container is set\n\t\tthis.bindContainerEvents();\n\t\tthis.bindAudienceEvents();\n\t}\n\n\tprotected override getSupportedFeatures(): ContainerDevtoolsFeatureFlags {\n\t\treturn {\n\t\t\tcontainerDataVisualization: this.containerData !== undefined,\n\t\t\t// Container runtimes do not have direct control over container lifecycle\n\t\t\tcanModifyContainerState: false,\n\t\t};\n\t}\n\n\t/**\n\t * {@inheritDoc IContainerDevtools.isClosed}\n\t */\n\tpublic isClosed(): boolean {\n\t\t// Container runtimes cannot be closed directly\n\t\treturn false;\n\t}\n}\n\n/**\n * Implementation of {@link DecomposedContainer} that wraps an {@link @fluidframework/container-runtime-definitions/internal#IContainerRuntime}.\n * @remarks\n * This class provides a bridge between {@link @fluidframework/container-runtime-definitions/internal#IContainerRuntime} and the devtools system by exposing runtime properties and events.\n */\nexport class DecomposedContainerForContainerRuntime\n\textends TypedEventEmitter<IContainerEvents>\n\timplements DecomposedContainer\n{\n\tprivate _disposed = false; // Track actual disposed state\n\n\tpublic constructor(runtime: IContainerRuntime) {\n\t\tsuper();\n\t\tthis.runtime = runtime;\n\t\t// Note: IContainerRuntime doesn't emit \"closed\" events like IContainer does\n\t\t// Only bind to events that IContainerRuntime actually supports\n\t\truntime.on(\"attached\", this.attachedHandler);\n\t\truntime.on(\"connected\", this.connectedHandler);\n\t\truntime.on(\"disconnected\", this.disconnectedHandler);\n\t\truntime.on(\"dispose\", this.disposedHandler);\n\t}\n\n\tprivate readonly attachedHandler = (): boolean => this.emit(\"attached\");\n\tprivate readonly connectedHandler = (clientId: string): boolean =>\n\t\tthis.emit(\"connected\", clientId);\n\tprivate readonly disconnectedHandler = (): boolean => this.emit(\"disconnected\");\n\tprivate readonly disposedHandler = (): boolean => {\n\t\t// IContainerRuntime emits \"dispose\" (no error) but we emit \"disposed\" to match IContainerEvents\n\t\t// Since IContainerRuntime doesn't provide error info, we emit without error parameter\n\t\tthis._disposed = true; // Mark as disposed when dispose event occurs\n\t\treturn this.emit(\"disposed\");\n\t};\n\n\tprivate readonly runtime: IContainerRuntime;\n\n\tpublic get audience(): IAudience {\n\t\treturn this.runtime.getAudience();\n\t}\n\n\tpublic get clientId(): string | undefined {\n\t\treturn this.runtime.clientId;\n\t}\n\n\tpublic get attachState(): AttachState {\n\t\treturn this.runtime.attachState;\n\t}\n\n\tpublic get connectionState(): ConnectionState {\n\t\t// Normal connection state logic - readonly state is handled separately via readOnlyInfo\n\t\treturn this.runtime.connected ? ConnectionState.Connected : ConnectionState.Disconnected;\n\t}\n\n\tpublic get closed(): boolean {\n\t\treturn this._disposed; // IContainerRuntime doesn't have a \"closed\" state - only \"disconnected\" (reconnectable) and \"disposed\" (permanent)\n\t}\n\n\tpublic get readOnlyInfo(): { readonly readonly?: boolean } {\n\t\t// IContainerRuntime doesn't expose readonly in its interface, but the implementation has isReadOnly()\n\t\tassert(\n\t\t\tthis.runtime instanceof ContainerRuntime,\n\t\t\t0xc2e /* DecomposedContainerForContainerRuntime is not a ContainerRuntime */,\n\t\t);\n\t\treturn { readonly: this.runtime.isReadOnly() };\n\t}\n}\n"]}

package/lib/FluidDevtools.d.ts

@@ -33,7 +33,9 @@ export declare const accessBeforeInitializeErrorText = "Devtools have not yet be
 export declare function getContainerAlreadyRegisteredErrorText(containerKey: ContainerKey): string;
 /**
  * Properties for configuring the Devtools.
- * @alpha
+ * @beta
+ * @input
+ * @sealed
  */
 export interface FluidDevtoolsProps {
     /**
@@ -46,13 +48,13 @@ export interface FluidDevtoolsProps {
      * This is provided to the Devtools instance strictly to enable communicating supported / desired functionality with
      * external listeners.
      */
-    logger?: IDevtoolsLogger;
+    readonly logger?: IDevtoolsLogger;
     /**
      * (optional) List of Containers to initialize the devtools with.
      *
      * @remarks Additional Containers can be registered with the Devtools via {@link IFluidDevtools.registerContainerDevtools}.
      */
-    initialContainers?: ContainerDevtoolsProps[];
+    readonly initialContainers?: ContainerDevtoolsProps[];
 }
 /**
  * {@link IFluidDevtools} implementation.
@@ -205,12 +207,12 @@ export declare class FluidDevtools implements IFluidDevtools {
  *
  * It is automatically disposed on webpage unload, but it can be closed earlier by calling `dispose`
  * on the returned handle.
- * @alpha
+ * @beta
  */
 export declare function initializeDevtools(props?: FluidDevtoolsProps): IFluidDevtools;
 /**
  * Gets the Devtools singleton if it has been {@link initializeDevtools | initialized}, otherwise returns `undefined`.
- * @alpha
+ * @beta
  */
 export declare function tryGetFluidDevtools(): IFluidDevtools | undefined;
 //# sourceMappingURL=FluidDevtools.d.ts.map

package/lib/FluidDevtools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FluidDevtools.d.ts","sourceRoot":"","sources":["../src/FluidDevtools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"FluidDevtools.d.ts","sourceRoot":"","sources":["../src/FluidDevtools.ts"],"names":[],"mappings":"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"}

package/lib/FluidDevtools.js

@@ -352,14 +352,14 @@ export class FluidDevtools {
  *
  * It is automatically disposed on webpage unload, but it can be closed earlier by calling `dispose`
  * on the returned handle.
- * @alpha
+ * @beta
  */
 export function initializeDevtools(props) {
     return FluidDevtools.initialize(props);
 }
 /**
  * Gets the Devtools singleton if it has been {@link initializeDevtools | initialized}, otherwise returns `undefined`.
- * @alpha
+ * @beta
  */
 export function tryGetFluidDevtools() {
     return FluidDevtools.tryGet();

package/lib/FluidDevtools.js.map

@@ -1 +1 @@
-{"version":3,"file":"FluidDevtools.js","sourceRoot":"","sources":["../src/FluidDevtools.ts"],"names":[],"mappings":"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","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport type { IContainerRuntime } from \"@fluidframework/container-runtime-definitions/internal\";\nimport type { IFluidLoadable } from \"@fluidframework/core-interfaces\";\nimport { UsageError } from \"@fluidframework/telemetry-utils/internal\";\n\nimport type { BaseDevtools } from \"./BaseDevtools.js\";\nimport type { ContainerKey } from \"./CommonInterfaces.js\";\nimport { ContainerDevtools, type ContainerDevtoolsProps } from \"./ContainerDevtools.js\";\nimport {\n\tContainerRuntimeDevtools,\n\ttype ContainerRuntimeProps,\n\tDecomposedContainerForContainerRuntime,\n} from \"./ContainerRuntimeDevtools.js\";\nimport type { DecomposedContainer } from \"./DecomposedContainer.js\";\nimport type { IDevtoolsLogger } from \"./DevtoolsLogger.js\";\nimport type { DevtoolsFeatureFlags } from \"./Features.js\";\nimport type { IContainerDevtools } from \"./IContainerDevtools.js\";\nimport type { IFluidDevtools } from \"./IFluidDevtools.js\";\nimport {\n\tContainerList,\n\tDevtoolsDisposed,\n\tDevtoolsFeatures,\n\tGetContainerList,\n\tGetDevtoolsFeatures,\n\tSetUnsampledTelemetry,\n\ttype ISourcedDevtoolsMessage,\n\ttype InboundHandlers,\n\ttype MessageLoggingOptions,\n\thandleIncomingWindowMessage,\n\tpostMessagesToWindow,\n} from \"./messaging/index.js\";\nimport { pkgVersion as devtoolsVersion } from \"./packageVersion.js\";\n\n/**\n * Message logging options used by the root devtools.\n */\nconst devtoolsMessageLoggingOptions: MessageLoggingOptions = {\n\tcontext: \"Fluid Devtools\",\n};\n\n/**\n * Error text thrown when {@link FluidDevtools} operations are used after it has been disposed.\n *\n * @privateRemarks Exported for test purposes only.\n */\nexport const useAfterDisposeErrorText =\n\t\"The devtools instance has been disposed. Further operations are invalid.\";\n\n/**\n * Error text thrown when {@link FluidDevtools.getOrThrow} is called before the Devtools have been initialized.\n *\n * @privateRemarks Exported for test purposes only.\n */\nexport const accessBeforeInitializeErrorText = \"Devtools have not yet been initialized.\";\n\n/**\n * Key for sessionStorage that's used to toggle unsampled telemetry.\n */\nconst unsampledTelemetryKey = \"Fluid.Telemetry.DisableSampling\";\n\n/**\n * Error text thrown when a user attempts to register a {@link IContainerDevtools} instance for an ID that is already\n * registered with the {@link IFluidDevtools}.\n *\n * @privateRemarks Exported for test purposes only.\n */\nexport function getContainerAlreadyRegisteredErrorText(containerKey: ContainerKey): string {\n\treturn (\n\t\t`A ContainerDevtools instance has already been registered for specified key: \"${containerKey}\".` +\n\t\t\"Existing instance must be closed before a replacement may be registered.\"\n\t);\n}\n\n/**\n * Properties for configuring the Devtools.\n * @alpha\n */\nexport interface FluidDevtoolsProps {\n\t/**\n\t * (optional) telemetry logger associated with the Fluid runtime.\n\t *\n\t * @remarks\n\t *\n\t * Note: {@link IFluidDevtools} does not register this logger with the Fluid runtime; that must be done separately.\n\t *\n\t * This is provided to the Devtools instance strictly to enable communicating supported / desired functionality with\n\t * external listeners.\n\t */\n\tlogger?: IDevtoolsLogger;\n\n\t/**\n\t * (optional) List of Containers to initialize the devtools with.\n\t *\n\t * @remarks Additional Containers can be registered with the Devtools via {@link IFluidDevtools.registerContainerDevtools}.\n\t */\n\tinitialContainers?: ContainerDevtoolsProps[];\n\n\t// TODO: Add ability for customers to specify custom data visualizer overrides\n}\n\n/**\n * {@link IFluidDevtools} implementation.\n *\n * @remarks\n *\n * This class listens for incoming messages from the window (globalThis), and posts messages to it upon relevant\n * state changes and when requested.\n *\n * **Messages it listens for:**\n *\n * - {@link GetDevtoolsFeatures.Message}: When received, {@link DevtoolsFeatures.Message} will be posted in response.\n *\n * - {@link GetContainerList.Message}: When received, {@link ContainerList.Message} will be posted in response.\n *\n * -{@link SetUnsampledTelemetry.Message}: When received, the unsampled telemetry flag will be toggled.\n *\n * TODO: Document others as they are added.\n *\n * **Messages it posts:**\n *\n * - {@link DevtoolsFeatures.Message}: Posted only when requested via {@link GetDevtoolsFeatures.Message}.\n *\n * - {@link ContainerList.Message}: Posted whenever the list of registered Containers changes, or when requested\n * (via {@link GetContainerList.Message}).\n *\n * TODO: Document others as they are added.\n *\n * @sealed\n */\nexport class FluidDevtools implements IFluidDevtools {\n\t/**\n\t * (optional) Telemetry logger associated with the Fluid runtime.\n\t */\n\tpublic readonly logger: IDevtoolsLogger | undefined;\n\n\t/**\n\t * Stores Container-level devtools instances registered with this object.\n\t * Maps from a {@link ContainerKey} to the corresponding {@link ContainerDevtools} instance.\n\t */\n\tprivate readonly containers: Map<ContainerKey, BaseDevtools<DecomposedContainer>>;\n\n\t/**\n\t * Private {@link FluidDevtools.disposed} tracking.\n\t */\n\tprivate _disposed: boolean;\n\n\t// #region Event handlers\n\n\t/**\n\t * Handlers for inbound messages specific to FluidDevTools.\n\t */\n\tprivate readonly inboundMessageHandlers: InboundHandlers = {\n\t\t[GetDevtoolsFeatures.MessageType]: async () => {\n\t\t\tthis.postSupportedFeatures();\n\t\t\treturn true;\n\t\t},\n\t\t[GetContainerList.MessageType]: async () => {\n\t\t\tthis.postContainerList();\n\t\t\treturn true;\n\t\t},\n\t\t[SetUnsampledTelemetry.MessageType]: async (message) => {\n\t\t\tconst newValue = (message as SetUnsampledTelemetry.Message).data.unsampledTelemetry;\n\t\t\tglobalThis.sessionStorage?.setItem(unsampledTelemetryKey, String(newValue));\n\t\t\tthis.postSupportedFeatures();\n\t\t\twindow.location.reload();\n\t\t\treturn true;\n\t\t},\n\t};\n\n\t/**\n\t * Event handler for messages coming from the window (globalThis).\n\t */\n\tprivate readonly windowMessageHandler = (\n\t\tevent: MessageEvent<Partial<ISourcedDevtoolsMessage>>,\n\t): void => {\n\t\thandleIncomingWindowMessage(\n\t\t\tevent,\n\t\t\tthis.inboundMessageHandlers,\n\t\t\tdevtoolsMessageLoggingOptions,\n\t\t);\n\t};\n\n\t/**\n\t * Event handler for the window (globalThis) `beforeUnload` event.\n\t * Disposes of the Devtools instance (which also clears the global singleton).\n\t */\n\tprivate readonly windowBeforeUnloadHandler = (): void => {\n\t\tthis.dispose();\n\t};\n\n\t/**\n\t * Posts {@link DevtoolsFeatures.Message} to the window (globalThis) with the set of features supported by\n\t * this instance.\n\t */\n\tprivate readonly postSupportedFeatures = (): void => {\n\t\tconst supportedFeatures = this.getSupportedFeatures();\n\t\tconst unsampledTelemetry =\n\t\t\tglobalThis.sessionStorage?.getItem(unsampledTelemetryKey) === \"true\";\n\t\tpostMessagesToWindow(\n\t\t\tdevtoolsMessageLoggingOptions,\n\t\t\tDevtoolsFeatures.createMessage({\n\t\t\t\tfeatures: supportedFeatures,\n\t\t\t\tdevtoolsVersion,\n\t\t\t\tunsampledTelemetry,\n\t\t\t}),\n\t\t);\n\t};\n\n\t/**\n\t * Posts a {@link ContainerList.Message} to the window (globalThis).\n\t */\n\tprivate readonly postContainerList = (): void => {\n\t\tconst containers: ContainerKey[] = this.getAllContainers().map(\n\t\t\t(container) => container.containerKey,\n\t\t);\n\n\t\tpostMessagesToWindow(\n\t\t\tdevtoolsMessageLoggingOptions,\n\t\t\tContainerList.createMessage({\n\t\t\t\tcontainers,\n\t\t\t}),\n\t\t);\n\t};\n\n\t// #endregion\n\n\t/**\n\t * Singleton instance.\n\t */\n\tprivate static I: FluidDevtools | undefined;\n\n\tprivate constructor(props?: FluidDevtoolsProps) {\n\t\t// Populate initial Container-level devtools\n\t\tthis.containers = new Map<ContainerKey, BaseDevtools<DecomposedContainer>>();\n\t\tif (props?.initialContainers !== undefined) {\n\t\t\tfor (const containerConfig of props.initialContainers) {\n\t\t\t\tthis.containers.set(\n\t\t\t\t\tcontainerConfig.containerKey,\n\t\t\t\t\tnew ContainerDevtools(containerConfig),\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\n\t\tthis.logger = props?.logger;\n\n\t\t// Register listener for inbound messages from the Window (globalThis)\n\t\tglobalThis.addEventListener?.(\"message\", this.windowMessageHandler);\n\n\t\t// Register the devtools instance to be disposed on Window unload\n\t\tglobalThis.addEventListener?.(\"beforeunload\", this.windowBeforeUnloadHandler);\n\n\t\t// Post message for supported features\n\t\tthis.postSupportedFeatures();\n\n\t\tthis._disposed = false;\n\t}\n\n\t/**\n\t * Creates and returns the FluidDevtools singleton.\n\t *\n\t * @remarks\n\t *\n\t * If the singleton has already been initialized, a warning will be logged and the existing instance will\n\t * be returned.\n\t */\n\tpublic static initialize(props?: FluidDevtoolsProps): FluidDevtools {\n\t\tif (FluidDevtools.I === undefined) {\n\t\t\tFluidDevtools.I = new FluidDevtools(props);\n\t\t} else {\n\t\t\tconsole.warn(\n\t\t\t\t\"Devtools have already been initialized. \" +\n\t\t\t\t\t\"Existing Devtools instance must be disposed before new ones may be initialized. \" +\n\t\t\t\t\t\"Returning existing Devtools instance.\",\n\t\t\t);\n\t\t}\n\n\t\treturn FluidDevtools.I;\n\t}\n\n\t/**\n\t * Gets the Devtools singleton if it has been initialized, otherwise throws.\n\t */\n\tpublic static getOrThrow(): FluidDevtools {\n\t\tif (FluidDevtools.I === undefined) {\n\t\t\tthrow new UsageError(accessBeforeInitializeErrorText);\n\t\t}\n\t\treturn FluidDevtools.I;\n\t}\n\n\t/**\n\t * Gets the Devtools singleton if it has been initialized, otherwise returns `undefined`.\n\t */\n\tpublic static tryGet(): FluidDevtools | undefined {\n\t\treturn FluidDevtools.I;\n\t}\n\n\t/**\n\t * {@inheritDoc IFluidDevtools.registerContainerDevtools}\n\t */\n\tpublic registerContainerDevtools(props: ContainerDevtoolsProps): void {\n\t\tif (this.disposed) {\n\t\t\tthrow new UsageError(useAfterDisposeErrorText);\n\t\t}\n\n\t\tconst { containerKey } = props;\n\n\t\tif (this.containers.has(containerKey)) {\n\t\t\tthrow new UsageError(getContainerAlreadyRegisteredErrorText(containerKey));\n\t\t}\n\n\t\tconst containerDevtools = new ContainerDevtools(props);\n\t\tthis.containers.set(containerKey, containerDevtools);\n\n\t\t// Post message for container list change\n\t\tthis.postContainerList();\n\t}\n\n\tpublic async registerContainerRuntime(props: ContainerRuntimeProps): Promise<void> {\n\t\tconst { runtime, label } = props;\n\n\t\tconst containerRuntimeKey = this.generateReadableKey(label ?? \"Container-Runtime\");\n\t\tconst extractedContainerRuntimeData =\n\t\t\tawait FluidDevtools.extractContainerDataFromRuntime(runtime);\n\n\t\tconst decomposedContainer = new DecomposedContainerForContainerRuntime(runtime);\n\n\t\t// Check if the container runtime is already registered.\n\t\tif (this.containers.has(containerRuntimeKey)) {\n\t\t\tthrow new UsageError(getContainerAlreadyRegisteredErrorText(containerRuntimeKey));\n\t\t}\n\n\t\tconst containerRuntimeDevtools = new ContainerRuntimeDevtools({\n\t\t\tcontainerKey: containerRuntimeKey,\n\t\t\tcontainer: decomposedContainer,\n\t\t\tcontainerData: extractedContainerRuntimeData,\n\t\t});\n\t\tthis.containers.set(containerRuntimeKey, containerRuntimeDevtools);\n\n\t\tthis.postContainerList();\n\t}\n\n\t/**\n\t * Helper method to extract container data from IContainerRuntime for visualization.\n\t * This method attempts to access the entry point data store from the runtime.\n\t *\n\t * @param containerRuntime - The container runtime to extract data from\n\t * @returns A record of data store names to IFluidLoadable objects, or undefined if no data can be extracted\n\t */\n\tpublic static async extractContainerDataFromRuntime(\n\t\tcontainerRuntime: IContainerRuntime,\n\t): Promise<Record<string, IFluidLoadable> | undefined> {\n\t\ttry {\n\t\t\t// Get the entry point from the container runtime\n\t\t\t// Cast to access getEntryPoint method which exists on the concrete implementation\n\t\t\tconst runtimeWithEntryPoint = containerRuntime as IContainerRuntime & {\n\t\t\t\tgetEntryPoint(): Promise<IFluidLoadable>;\n\t\t\t};\n\n\t\t\tif (\n\t\t\t\ttypeof runtimeWithEntryPoint.scope === \"object\" &&\n\t\t\t\ttypeof runtimeWithEntryPoint.getEntryPoint === \"function\"\n\t\t\t) {\n\t\t\t\tconst entryPoint = await runtimeWithEntryPoint.getEntryPoint();\n\t\t\t\tif (entryPoint !== undefined) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\tentryPoint,\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tconsole.warn(\"Could not extract container data from runtime:\", error);\n\t\t}\n\n\t\treturn undefined;\n\t}\n\n\t/**\n\t * {@inheritDoc IFluidDevtools.closeContainerDevtools}\n\t */\n\tpublic closeContainerDevtools(containerKey: ContainerKey): void {\n\t\tif (this.disposed) {\n\t\t\tthrow new UsageError(useAfterDisposeErrorText);\n\t\t}\n\n\t\tif (this.containers.has(containerKey)) {\n\t\t\tthis.removeContainer(containerKey);\n\t\t} else {\n\t\t\tconsole.warn(\n\t\t\t\t`No ContainerDevtools or ContainerRuntimeDevtools associated with key \"${containerKey}\" was found.`,\n\t\t\t);\n\t\t}\n\t}\n\n\t/**\n\t * Gets the registered Container Devtools or Container Runtime Devtools associated with the provided {@link ContainerKey}, if one exists.\n\t * Otherwise returns `undefined`.\n\t */\n\tpublic getContainerDevtools(containerKey: ContainerKey): IContainerDevtools | undefined {\n\t\tif (this.disposed) {\n\t\t\tthrow new UsageError(useAfterDisposeErrorText);\n\t\t}\n\n\t\treturn this.containers.get(containerKey);\n\t}\n\n\t/**\n\t * Gets all container devtools instances (not data objects).\n\t */\n\tpublic getAllContainers(): readonly BaseDevtools<DecomposedContainer>[] {\n\t\tif (this.disposed) {\n\t\t\tthrow new UsageError(useAfterDisposeErrorText);\n\t\t}\n\n\t\treturn [...this.containers.values()];\n\t}\n\n\t/**\n\t * {@inheritDoc @fluidframework/core-interfaces#IDisposable.disposed}\n\t */\n\tpublic get disposed(): boolean {\n\t\treturn this._disposed;\n\t}\n\n\t/**\n\t * {@inheritDoc @fluidframework/core-interfaces#IDisposable.dispose}\n\t */\n\tpublic dispose(): void {\n\t\tif (this.disposed) {\n\t\t\tthrow new UsageError(useAfterDisposeErrorText);\n\t\t}\n\n\t\t// Send close devtool message\n\t\tpostMessagesToWindow(devtoolsMessageLoggingOptions, DevtoolsDisposed.createMessage());\n\n\t\t// Dispose of container-level devtools\n\t\tfor (const [, containerDevtools] of this.containers) {\n\t\t\tcontainerDevtools.dispose();\n\t\t}\n\t\tthis.containers.clear();\n\n\t\t// Notify listeners that the list of Containers changed.\n\t\tthis.postContainerList();\n\n\t\t// Clear the singleton so a new one may be initialized.\n\t\tFluidDevtools.I = undefined;\n\n\t\t// Clean up event listeners\n\t\tglobalThis.removeEventListener?.(\"message\", this.windowMessageHandler);\n\t\tglobalThis.removeEventListener?.(\"beforeunload\", this.windowBeforeUnloadHandler);\n\n\t\tthis._disposed = true;\n\t}\n\n\t/**\n\t * Gets the set of features supported by this instance.\n\t */\n\tprivate getSupportedFeatures(): DevtoolsFeatureFlags {\n\t\treturn {\n\t\t\ttelemetry: this.logger !== undefined,\n\t\t\t// Most work completed, but not ready to completely enable.\n\t\t\topLatencyTelemetry: true,\n\t\t};\n\t}\n\n\t/**\n\t * Removes a container devtools instance from the devtools instance.\n\t * @param containerKey - The key of the container to remove.\n\t */\n\tprivate removeContainer(containerKey: ContainerKey): void {\n\t\tif (this.disposed) {\n\t\t\tthrow new UsageError(useAfterDisposeErrorText);\n\t\t}\n\n\t\tconst containerDevtools = this.containers.get(containerKey);\n\t\tif (containerDevtools === undefined) {\n\t\t\tconsole.warn(`No ContainerDevtools associated with key \"${containerKey}\" was found.`);\n\t\t\treturn;\n\t\t}\n\n\t\tcontainerDevtools.dispose();\n\t\tthis.containers.delete(containerKey);\n\n\t\t// Post message for container list change\n\t\tthis.postContainerList();\n\t}\n\n\t/**\n\t * Tracks the number of {@link ContainerRuntimeDevtools} instances created for each base key.\n\t */\n\tprivate readonly containerRuntimesInstanceCounts = new Map<string, number>();\n\n\t/**\n\t * Generates a readable key for a container runtime using package path and sequential numbering.\n\t *\n\t * @privateRemarks\n\t * TODO: Once we enable automatic extraction of ContainerData for IContainer instance, extend the usage of assigning readable key.\n\t */\n\tprivate generateReadableKey(baseKey: string): string {\n\t\t// Get the next number for this base key\n\t\tconst nextNumber = (this.containerRuntimesInstanceCounts.get(baseKey) ?? 0) + 1;\n\t\tthis.containerRuntimesInstanceCounts.set(baseKey, nextNumber);\n\n\t\treturn `${baseKey}-${nextNumber}`;\n\t}\n}\n\n/**\n * Initializes the Devtools singleton and returns a handle to it.\n *\n * @remarks\n *\n * The instance is tracked as a static singleton.\n *\n * It is automatically disposed on webpage unload, but it can be closed earlier by calling `dispose`\n * on the returned handle.\n * @alpha\n */\nexport function initializeDevtools(props?: FluidDevtoolsProps): IFluidDevtools {\n\treturn FluidDevtools.initialize(props);\n}\n\n/**\n * Gets the Devtools singleton if it has been {@link initializeDevtools | initialized}, otherwise returns `undefined`.\n * @alpha\n */\nexport function tryGetFluidDevtools(): IFluidDevtools | undefined {\n\treturn FluidDevtools.tryGet();\n}\n"]}
+{"version":3,"file":"FluidDevtools.js","sourceRoot":"","sources":["../src/FluidDevtools.ts"],"names":[],"mappings":"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","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport type { IContainerRuntime } from \"@fluidframework/container-runtime-definitions/internal\";\nimport type { IFluidLoadable } from \"@fluidframework/core-interfaces\";\nimport { UsageError } from \"@fluidframework/telemetry-utils/internal\";\n\nimport type { BaseDevtools } from \"./BaseDevtools.js\";\nimport type { ContainerKey } from \"./CommonInterfaces.js\";\nimport { ContainerDevtools, type ContainerDevtoolsProps } from \"./ContainerDevtools.js\";\nimport {\n\tContainerRuntimeDevtools,\n\ttype ContainerRuntimeProps,\n\tDecomposedContainerForContainerRuntime,\n} from \"./ContainerRuntimeDevtools.js\";\nimport type { DecomposedContainer } from \"./DecomposedContainer.js\";\nimport type { IDevtoolsLogger } from \"./DevtoolsLogger.js\";\nimport type { DevtoolsFeatureFlags } from \"./Features.js\";\nimport type { IContainerDevtools } from \"./IContainerDevtools.js\";\nimport type { IFluidDevtools } from \"./IFluidDevtools.js\";\nimport {\n\tContainerList,\n\tDevtoolsDisposed,\n\tDevtoolsFeatures,\n\tGetContainerList,\n\tGetDevtoolsFeatures,\n\tSetUnsampledTelemetry,\n\ttype ISourcedDevtoolsMessage,\n\ttype InboundHandlers,\n\ttype MessageLoggingOptions,\n\thandleIncomingWindowMessage,\n\tpostMessagesToWindow,\n} from \"./messaging/index.js\";\nimport { pkgVersion as devtoolsVersion } from \"./packageVersion.js\";\n\n/**\n * Message logging options used by the root devtools.\n */\nconst devtoolsMessageLoggingOptions: MessageLoggingOptions = {\n\tcontext: \"Fluid Devtools\",\n};\n\n/**\n * Error text thrown when {@link FluidDevtools} operations are used after it has been disposed.\n *\n * @privateRemarks Exported for test purposes only.\n */\nexport const useAfterDisposeErrorText =\n\t\"The devtools instance has been disposed. Further operations are invalid.\";\n\n/**\n * Error text thrown when {@link FluidDevtools.getOrThrow} is called before the Devtools have been initialized.\n *\n * @privateRemarks Exported for test purposes only.\n */\nexport const accessBeforeInitializeErrorText = \"Devtools have not yet been initialized.\";\n\n/**\n * Key for sessionStorage that's used to toggle unsampled telemetry.\n */\nconst unsampledTelemetryKey = \"Fluid.Telemetry.DisableSampling\";\n\n/**\n * Error text thrown when a user attempts to register a {@link IContainerDevtools} instance for an ID that is already\n * registered with the {@link IFluidDevtools}.\n *\n * @privateRemarks Exported for test purposes only.\n */\nexport function getContainerAlreadyRegisteredErrorText(containerKey: ContainerKey): string {\n\treturn (\n\t\t`A ContainerDevtools instance has already been registered for specified key: \"${containerKey}\".` +\n\t\t\"Existing instance must be closed before a replacement may be registered.\"\n\t);\n}\n\n/**\n * Properties for configuring the Devtools.\n * @beta\n * @input\n * @sealed\n */\nexport interface FluidDevtoolsProps {\n\t/**\n\t * (optional) telemetry logger associated with the Fluid runtime.\n\t *\n\t * @remarks\n\t *\n\t * Note: {@link IFluidDevtools} does not register this logger with the Fluid runtime; that must be done separately.\n\t *\n\t * This is provided to the Devtools instance strictly to enable communicating supported / desired functionality with\n\t * external listeners.\n\t */\n\treadonly logger?: IDevtoolsLogger;\n\n\t/**\n\t * (optional) List of Containers to initialize the devtools with.\n\t *\n\t * @remarks Additional Containers can be registered with the Devtools via {@link IFluidDevtools.registerContainerDevtools}.\n\t */\n\treadonly initialContainers?: ContainerDevtoolsProps[];\n\n\t// TODO: Add ability for customers to specify custom data visualizer overrides\n}\n\n/**\n * {@link IFluidDevtools} implementation.\n *\n * @remarks\n *\n * This class listens for incoming messages from the window (globalThis), and posts messages to it upon relevant\n * state changes and when requested.\n *\n * **Messages it listens for:**\n *\n * - {@link GetDevtoolsFeatures.Message}: When received, {@link DevtoolsFeatures.Message} will be posted in response.\n *\n * - {@link GetContainerList.Message}: When received, {@link ContainerList.Message} will be posted in response.\n *\n * -{@link SetUnsampledTelemetry.Message}: When received, the unsampled telemetry flag will be toggled.\n *\n * TODO: Document others as they are added.\n *\n * **Messages it posts:**\n *\n * - {@link DevtoolsFeatures.Message}: Posted only when requested via {@link GetDevtoolsFeatures.Message}.\n *\n * - {@link ContainerList.Message}: Posted whenever the list of registered Containers changes, or when requested\n * (via {@link GetContainerList.Message}).\n *\n * TODO: Document others as they are added.\n *\n * @sealed\n */\nexport class FluidDevtools implements IFluidDevtools {\n\t/**\n\t * (optional) Telemetry logger associated with the Fluid runtime.\n\t */\n\tpublic readonly logger: IDevtoolsLogger | undefined;\n\n\t/**\n\t * Stores Container-level devtools instances registered with this object.\n\t * Maps from a {@link ContainerKey} to the corresponding {@link ContainerDevtools} instance.\n\t */\n\tprivate readonly containers: Map<ContainerKey, BaseDevtools<DecomposedContainer>>;\n\n\t/**\n\t * Private {@link FluidDevtools.disposed} tracking.\n\t */\n\tprivate _disposed: boolean;\n\n\t// #region Event handlers\n\n\t/**\n\t * Handlers for inbound messages specific to FluidDevTools.\n\t */\n\tprivate readonly inboundMessageHandlers: InboundHandlers = {\n\t\t[GetDevtoolsFeatures.MessageType]: async () => {\n\t\t\tthis.postSupportedFeatures();\n\t\t\treturn true;\n\t\t},\n\t\t[GetContainerList.MessageType]: async () => {\n\t\t\tthis.postContainerList();\n\t\t\treturn true;\n\t\t},\n\t\t[SetUnsampledTelemetry.MessageType]: async (message) => {\n\t\t\tconst newValue = (message as SetUnsampledTelemetry.Message).data.unsampledTelemetry;\n\t\t\tglobalThis.sessionStorage?.setItem(unsampledTelemetryKey, String(newValue));\n\t\t\tthis.postSupportedFeatures();\n\t\t\twindow.location.reload();\n\t\t\treturn true;\n\t\t},\n\t};\n\n\t/**\n\t * Event handler for messages coming from the window (globalThis).\n\t */\n\tprivate readonly windowMessageHandler = (\n\t\tevent: MessageEvent<Partial<ISourcedDevtoolsMessage>>,\n\t): void => {\n\t\thandleIncomingWindowMessage(\n\t\t\tevent,\n\t\t\tthis.inboundMessageHandlers,\n\t\t\tdevtoolsMessageLoggingOptions,\n\t\t);\n\t};\n\n\t/**\n\t * Event handler for the window (globalThis) `beforeUnload` event.\n\t * Disposes of the Devtools instance (which also clears the global singleton).\n\t */\n\tprivate readonly windowBeforeUnloadHandler = (): void => {\n\t\tthis.dispose();\n\t};\n\n\t/**\n\t * Posts {@link DevtoolsFeatures.Message} to the window (globalThis) with the set of features supported by\n\t * this instance.\n\t */\n\tprivate readonly postSupportedFeatures = (): void => {\n\t\tconst supportedFeatures = this.getSupportedFeatures();\n\t\tconst unsampledTelemetry =\n\t\t\tglobalThis.sessionStorage?.getItem(unsampledTelemetryKey) === \"true\";\n\t\tpostMessagesToWindow(\n\t\t\tdevtoolsMessageLoggingOptions,\n\t\t\tDevtoolsFeatures.createMessage({\n\t\t\t\tfeatures: supportedFeatures,\n\t\t\t\tdevtoolsVersion,\n\t\t\t\tunsampledTelemetry,\n\t\t\t}),\n\t\t);\n\t};\n\n\t/**\n\t * Posts a {@link ContainerList.Message} to the window (globalThis).\n\t */\n\tprivate readonly postContainerList = (): void => {\n\t\tconst containers: ContainerKey[] = this.getAllContainers().map(\n\t\t\t(container) => container.containerKey,\n\t\t);\n\n\t\tpostMessagesToWindow(\n\t\t\tdevtoolsMessageLoggingOptions,\n\t\t\tContainerList.createMessage({\n\t\t\t\tcontainers,\n\t\t\t}),\n\t\t);\n\t};\n\n\t// #endregion\n\n\t/**\n\t * Singleton instance.\n\t */\n\tprivate static I: FluidDevtools | undefined;\n\n\tprivate constructor(props?: FluidDevtoolsProps) {\n\t\t// Populate initial Container-level devtools\n\t\tthis.containers = new Map<ContainerKey, BaseDevtools<DecomposedContainer>>();\n\t\tif (props?.initialContainers !== undefined) {\n\t\t\tfor (const containerConfig of props.initialContainers) {\n\t\t\t\tthis.containers.set(\n\t\t\t\t\tcontainerConfig.containerKey,\n\t\t\t\t\tnew ContainerDevtools(containerConfig),\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\n\t\tthis.logger = props?.logger;\n\n\t\t// Register listener for inbound messages from the Window (globalThis)\n\t\tglobalThis.addEventListener?.(\"message\", this.windowMessageHandler);\n\n\t\t// Register the devtools instance to be disposed on Window unload\n\t\tglobalThis.addEventListener?.(\"beforeunload\", this.windowBeforeUnloadHandler);\n\n\t\t// Post message for supported features\n\t\tthis.postSupportedFeatures();\n\n\t\tthis._disposed = false;\n\t}\n\n\t/**\n\t * Creates and returns the FluidDevtools singleton.\n\t *\n\t * @remarks\n\t *\n\t * If the singleton has already been initialized, a warning will be logged and the existing instance will\n\t * be returned.\n\t */\n\tpublic static initialize(props?: FluidDevtoolsProps): FluidDevtools {\n\t\tif (FluidDevtools.I === undefined) {\n\t\t\tFluidDevtools.I = new FluidDevtools(props);\n\t\t} else {\n\t\t\tconsole.warn(\n\t\t\t\t\"Devtools have already been initialized. \" +\n\t\t\t\t\t\"Existing Devtools instance must be disposed before new ones may be initialized. \" +\n\t\t\t\t\t\"Returning existing Devtools instance.\",\n\t\t\t);\n\t\t}\n\n\t\treturn FluidDevtools.I;\n\t}\n\n\t/**\n\t * Gets the Devtools singleton if it has been initialized, otherwise throws.\n\t */\n\tpublic static getOrThrow(): FluidDevtools {\n\t\tif (FluidDevtools.I === undefined) {\n\t\t\tthrow new UsageError(accessBeforeInitializeErrorText);\n\t\t}\n\t\treturn FluidDevtools.I;\n\t}\n\n\t/**\n\t * Gets the Devtools singleton if it has been initialized, otherwise returns `undefined`.\n\t */\n\tpublic static tryGet(): FluidDevtools | undefined {\n\t\treturn FluidDevtools.I;\n\t}\n\n\t/**\n\t * {@inheritDoc IFluidDevtools.registerContainerDevtools}\n\t */\n\tpublic registerContainerDevtools(props: ContainerDevtoolsProps): void {\n\t\tif (this.disposed) {\n\t\t\tthrow new UsageError(useAfterDisposeErrorText);\n\t\t}\n\n\t\tconst { containerKey } = props;\n\n\t\tif (this.containers.has(containerKey)) {\n\t\t\tthrow new UsageError(getContainerAlreadyRegisteredErrorText(containerKey));\n\t\t}\n\n\t\tconst containerDevtools = new ContainerDevtools(props);\n\t\tthis.containers.set(containerKey, containerDevtools);\n\n\t\t// Post message for container list change\n\t\tthis.postContainerList();\n\t}\n\n\tpublic async registerContainerRuntime(props: ContainerRuntimeProps): Promise<void> {\n\t\tconst { runtime, label } = props;\n\n\t\tconst containerRuntimeKey = this.generateReadableKey(label ?? \"Container-Runtime\");\n\t\tconst extractedContainerRuntimeData =\n\t\t\tawait FluidDevtools.extractContainerDataFromRuntime(runtime);\n\n\t\tconst decomposedContainer = new DecomposedContainerForContainerRuntime(runtime);\n\n\t\t// Check if the container runtime is already registered.\n\t\tif (this.containers.has(containerRuntimeKey)) {\n\t\t\tthrow new UsageError(getContainerAlreadyRegisteredErrorText(containerRuntimeKey));\n\t\t}\n\n\t\tconst containerRuntimeDevtools = new ContainerRuntimeDevtools({\n\t\t\tcontainerKey: containerRuntimeKey,\n\t\t\tcontainer: decomposedContainer,\n\t\t\tcontainerData: extractedContainerRuntimeData,\n\t\t});\n\t\tthis.containers.set(containerRuntimeKey, containerRuntimeDevtools);\n\n\t\tthis.postContainerList();\n\t}\n\n\t/**\n\t * Helper method to extract container data from IContainerRuntime for visualization.\n\t * This method attempts to access the entry point data store from the runtime.\n\t *\n\t * @param containerRuntime - The container runtime to extract data from\n\t * @returns A record of data store names to IFluidLoadable objects, or undefined if no data can be extracted\n\t */\n\tpublic static async extractContainerDataFromRuntime(\n\t\tcontainerRuntime: IContainerRuntime,\n\t): Promise<Record<string, IFluidLoadable> | undefined> {\n\t\ttry {\n\t\t\t// Get the entry point from the container runtime\n\t\t\t// Cast to access getEntryPoint method which exists on the concrete implementation\n\t\t\tconst runtimeWithEntryPoint = containerRuntime as IContainerRuntime & {\n\t\t\t\tgetEntryPoint(): Promise<IFluidLoadable>;\n\t\t\t};\n\n\t\t\tif (\n\t\t\t\ttypeof runtimeWithEntryPoint.scope === \"object\" &&\n\t\t\t\ttypeof runtimeWithEntryPoint.getEntryPoint === \"function\"\n\t\t\t) {\n\t\t\t\tconst entryPoint = await runtimeWithEntryPoint.getEntryPoint();\n\t\t\t\tif (entryPoint !== undefined) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\tentryPoint,\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tconsole.warn(\"Could not extract container data from runtime:\", error);\n\t\t}\n\n\t\treturn undefined;\n\t}\n\n\t/**\n\t * {@inheritDoc IFluidDevtools.closeContainerDevtools}\n\t */\n\tpublic closeContainerDevtools(containerKey: ContainerKey): void {\n\t\tif (this.disposed) {\n\t\t\tthrow new UsageError(useAfterDisposeErrorText);\n\t\t}\n\n\t\tif (this.containers.has(containerKey)) {\n\t\t\tthis.removeContainer(containerKey);\n\t\t} else {\n\t\t\tconsole.warn(\n\t\t\t\t`No ContainerDevtools or ContainerRuntimeDevtools associated with key \"${containerKey}\" was found.`,\n\t\t\t);\n\t\t}\n\t}\n\n\t/**\n\t * Gets the registered Container Devtools or Container Runtime Devtools associated with the provided {@link ContainerKey}, if one exists.\n\t * Otherwise returns `undefined`.\n\t */\n\tpublic getContainerDevtools(containerKey: ContainerKey): IContainerDevtools | undefined {\n\t\tif (this.disposed) {\n\t\t\tthrow new UsageError(useAfterDisposeErrorText);\n\t\t}\n\n\t\treturn this.containers.get(containerKey);\n\t}\n\n\t/**\n\t * Gets all container devtools instances (not data objects).\n\t */\n\tpublic getAllContainers(): readonly BaseDevtools<DecomposedContainer>[] {\n\t\tif (this.disposed) {\n\t\t\tthrow new UsageError(useAfterDisposeErrorText);\n\t\t}\n\n\t\treturn [...this.containers.values()];\n\t}\n\n\t/**\n\t * {@inheritDoc @fluidframework/core-interfaces#IDisposable.disposed}\n\t */\n\tpublic get disposed(): boolean {\n\t\treturn this._disposed;\n\t}\n\n\t/**\n\t * {@inheritDoc @fluidframework/core-interfaces#IDisposable.dispose}\n\t */\n\tpublic dispose(): void {\n\t\tif (this.disposed) {\n\t\t\tthrow new UsageError(useAfterDisposeErrorText);\n\t\t}\n\n\t\t// Send close devtool message\n\t\tpostMessagesToWindow(devtoolsMessageLoggingOptions, DevtoolsDisposed.createMessage());\n\n\t\t// Dispose of container-level devtools\n\t\tfor (const [, containerDevtools] of this.containers) {\n\t\t\tcontainerDevtools.dispose();\n\t\t}\n\t\tthis.containers.clear();\n\n\t\t// Notify listeners that the list of Containers changed.\n\t\tthis.postContainerList();\n\n\t\t// Clear the singleton so a new one may be initialized.\n\t\tFluidDevtools.I = undefined;\n\n\t\t// Clean up event listeners\n\t\tglobalThis.removeEventListener?.(\"message\", this.windowMessageHandler);\n\t\tglobalThis.removeEventListener?.(\"beforeunload\", this.windowBeforeUnloadHandler);\n\n\t\tthis._disposed = true;\n\t}\n\n\t/**\n\t * Gets the set of features supported by this instance.\n\t */\n\tprivate getSupportedFeatures(): DevtoolsFeatureFlags {\n\t\treturn {\n\t\t\ttelemetry: this.logger !== undefined,\n\t\t\t// Most work completed, but not ready to completely enable.\n\t\t\topLatencyTelemetry: true,\n\t\t};\n\t}\n\n\t/**\n\t * Removes a container devtools instance from the devtools instance.\n\t * @param containerKey - The key of the container to remove.\n\t */\n\tprivate removeContainer(containerKey: ContainerKey): void {\n\t\tif (this.disposed) {\n\t\t\tthrow new UsageError(useAfterDisposeErrorText);\n\t\t}\n\n\t\tconst containerDevtools = this.containers.get(containerKey);\n\t\tif (containerDevtools === undefined) {\n\t\t\tconsole.warn(`No ContainerDevtools associated with key \"${containerKey}\" was found.`);\n\t\t\treturn;\n\t\t}\n\n\t\tcontainerDevtools.dispose();\n\t\tthis.containers.delete(containerKey);\n\n\t\t// Post message for container list change\n\t\tthis.postContainerList();\n\t}\n\n\t/**\n\t * Tracks the number of {@link ContainerRuntimeDevtools} instances created for each base key.\n\t */\n\tprivate readonly containerRuntimesInstanceCounts = new Map<string, number>();\n\n\t/**\n\t * Generates a readable key for a container runtime using package path and sequential numbering.\n\t *\n\t * @privateRemarks\n\t * TODO: Once we enable automatic extraction of ContainerData for IContainer instance, extend the usage of assigning readable key.\n\t */\n\tprivate generateReadableKey(baseKey: string): string {\n\t\t// Get the next number for this base key\n\t\tconst nextNumber = (this.containerRuntimesInstanceCounts.get(baseKey) ?? 0) + 1;\n\t\tthis.containerRuntimesInstanceCounts.set(baseKey, nextNumber);\n\n\t\treturn `${baseKey}-${nextNumber}`;\n\t}\n}\n\n/**\n * Initializes the Devtools singleton and returns a handle to it.\n *\n * @remarks\n *\n * The instance is tracked as a static singleton.\n *\n * It is automatically disposed on webpage unload, but it can be closed earlier by calling `dispose`\n * on the returned handle.\n * @beta\n */\nexport function initializeDevtools(props?: FluidDevtoolsProps): IFluidDevtools {\n\treturn FluidDevtools.initialize(props);\n}\n\n/**\n * Gets the Devtools singleton if it has been {@link initializeDevtools | initialized}, otherwise returns `undefined`.\n * @beta\n */\nexport function tryGetFluidDevtools(): IFluidDevtools | undefined {\n\treturn FluidDevtools.tryGet();\n}\n"]}

package/lib/IFluidDevtools.d.ts

@@ -18,7 +18,7 @@ import type { ContainerRuntimeProps } from "./ContainerRuntimeDevtools.js";
  * The lifetime of the associated singleton is bound by that of the Window (globalThis), and it will be automatically
  * disposed of on Window unload.
  * If you wish to dispose of it earlier, you may call its {@link @fluidframework/core-interfaces#IDisposable.dispose} method.
- * @alpha
+ * @beta
  * @sealed
  */
 export interface IFluidDevtools extends IDisposable {

package/lib/IFluidDevtools.js.map

@@ -1 +1 @@
-{"version":3,"file":"IFluidDevtools.js","sourceRoot":"","sources":["../src/IFluidDevtools.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport type { IDisposable } from \"@fluidframework/core-interfaces\";\n\nimport type { ContainerKey } from \"./CommonInterfaces.js\";\nimport type { ContainerDevtoolsProps } from \"./ContainerDevtools.js\";\nimport type { ContainerRuntimeProps } from \"./ContainerRuntimeDevtools.js\";\n\n/**\n * Fluid Devtools. A single, global instance is used to generate and communicate stats associated with the general Fluid\n * runtime (i.e., it is not associated with any single Framework entity).\n *\n * @remarks\n *\n * Supports registering {@link @fluidframework/container-definitions#IContainer}s for Container-level stats\n * (via {@link IFluidDevtools.registerContainerDevtools}).\n *\n * The lifetime of the associated singleton is bound by that of the Window (globalThis), and it will be automatically\n * disposed of on Window unload.\n * If you wish to dispose of it earlier, you may call its {@link @fluidframework/core-interfaces#IDisposable.dispose} method.\n * @alpha\n * @sealed\n */\nexport interface IFluidDevtools extends IDisposable {\n\t/**\n\t * Registers the provided {@link @fluidframework/container-definitions#IContainer} with the Devtools to begin\n\t * generating stats for it.\n\t *\n\t * @remarks To remove the Container from the Devtools, call {@link IFluidDevtools.closeContainerDevtools}.\n\t *\n\t * @throws Will throw if devtools have already been registered for the specified {@link ContainerKey}.\n\t */\n\tregisterContainerDevtools(props: ContainerDevtoolsProps): void;\n\n\t/**\n\t * Registers a container runtime with the devtools.\n\t *\n\t * @remarks To remove the Container Runtime from the Devtools, call {@link IFluidDevtools.closeContainerDevtools}.\n\t *\n\t * @throws Will throw if devtools have already been registered for the specified {@link ContainerKey}.\n\t */\n\tregisterContainerRuntime(props: ContainerRuntimeProps): Promise<void>;\n\n\t/**\n\t * Removes the Container with the specified {@link ContainerKey} from the Devtools.\n\t *\n\t * @remarks Will no-op if no such Container is registered.\n\t */\n\tcloseContainerDevtools(containerKey: ContainerKey): void;\n}\n"]}
+{"version":3,"file":"IFluidDevtools.js","sourceRoot":"","sources":["../src/IFluidDevtools.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport type { IDisposable } from \"@fluidframework/core-interfaces\";\n\nimport type { ContainerKey } from \"./CommonInterfaces.js\";\nimport type { ContainerDevtoolsProps } from \"./ContainerDevtools.js\";\nimport type { ContainerRuntimeProps } from \"./ContainerRuntimeDevtools.js\";\n\n/**\n * Fluid Devtools. A single, global instance is used to generate and communicate stats associated with the general Fluid\n * runtime (i.e., it is not associated with any single Framework entity).\n *\n * @remarks\n *\n * Supports registering {@link @fluidframework/container-definitions#IContainer}s for Container-level stats\n * (via {@link IFluidDevtools.registerContainerDevtools}).\n *\n * The lifetime of the associated singleton is bound by that of the Window (globalThis), and it will be automatically\n * disposed of on Window unload.\n * If you wish to dispose of it earlier, you may call its {@link @fluidframework/core-interfaces#IDisposable.dispose} method.\n * @beta\n * @sealed\n */\nexport interface IFluidDevtools extends IDisposable {\n\t/**\n\t * Registers the provided {@link @fluidframework/container-definitions#IContainer} with the Devtools to begin\n\t * generating stats for it.\n\t *\n\t * @remarks To remove the Container from the Devtools, call {@link IFluidDevtools.closeContainerDevtools}.\n\t *\n\t * @throws Will throw if devtools have already been registered for the specified {@link ContainerKey}.\n\t */\n\tregisterContainerDevtools(props: ContainerDevtoolsProps): void;\n\n\t/**\n\t * Registers a container runtime with the devtools.\n\t *\n\t * @remarks To remove the Container Runtime from the Devtools, call {@link IFluidDevtools.closeContainerDevtools}.\n\t *\n\t * @throws Will throw if devtools have already been registered for the specified {@link ContainerKey}.\n\t */\n\tregisterContainerRuntime(props: ContainerRuntimeProps): Promise<void>;\n\n\t/**\n\t * Removes the Container with the specified {@link ContainerKey} from the Devtools.\n\t *\n\t * @remarks Will no-op if no such Container is registered.\n\t */\n\tcloseContainerDevtools(containerKey: ContainerKey): void;\n}\n"]}

package/lib/alpha.d.ts

@@ -28,17 +28,14 @@
 
 export {
 	// #region @beta APIs
-	ContainerKey, 
-	HasContainerKey, 
-	IDevtoolsLogger, 
-	createDevtoolsLogger,
-	// #endregion
- 
-	// #region @alpha APIs
 	ContainerDevtoolsProps, 
+	ContainerKey, 
 	ContainerRuntimeProps, 
 	FluidDevtoolsProps, 
+	HasContainerKey, 
+	IDevtoolsLogger, 
 	IFluidDevtools, 
+	createDevtoolsLogger, 
 	initializeDevtools, 
 	tryGetFluidDevtools
 	// #endregion

package/lib/beta.d.ts

@@ -0,0 +1,42 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+
+/*
+ * THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY.
+ * Generated by "flub generate entrypoints" in @fluid-tools/build-cli.
+ */
+
+/**
+ * Contains an API for initializing developer tooling alongside the Fluid Framework.
+ *
+ * This tooling is built for use alongside our Chromium browser extension.
+ * It listens for incoming messages from the corresponding extension, and posts direct responses as well as automatic
+ * updates for Fluid state changes.
+ *
+ * Individual {@link @fluidframework/container-definitions#IContainer | Fluid Containers} can be registered to generate
+ * Container-level stats.
+ *
+ * Visualization of telemetry logs can be enabled by creating a {@link DevtoolsLogger} and providing it to Devtools
+ * initialization.
+ *
+ * See the package README for more details.
+ *
+ * @packageDocumentation
+ */
+
+export {
+	// #region @beta APIs
+	ContainerDevtoolsProps, 
+	ContainerKey, 
+	ContainerRuntimeProps, 
+	FluidDevtoolsProps, 
+	HasContainerKey, 
+	IDevtoolsLogger, 
+	IFluidDevtools, 
+	createDevtoolsLogger, 
+	initializeDevtools, 
+	tryGetFluidDevtools
+	// #endregion
+} from "./index.js";

package/lib/packageVersion.d.ts

@@ -5,5 +5,5 @@
  * THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY
  */
 export declare const pkgName = "@fluidframework/devtools-core";
-export declare const pkgVersion = "2.70.0-361248";
+export declare const pkgVersion = "2.70.0-361788";
 //# sourceMappingURL=packageVersion.d.ts.map

package/lib/packageVersion.js

@@ -5,5 +5,5 @@
  * THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY
  */
 export const pkgName = "@fluidframework/devtools-core";
-export const pkgVersion = "2.70.0-361248";
+export const pkgVersion = "2.70.0-361788";
 //# sourceMappingURL=packageVersion.js.map

package/lib/packageVersion.js.map

@@ -1 +1 @@
-{"version":3,"file":"packageVersion.js","sourceRoot":"","sources":["../src/packageVersion.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,+BAA+B,CAAC;AACvD,MAAM,CAAC,MAAM,UAAU,GAAG,eAAe,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n *\n * THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY\n */\n\nexport const pkgName = \"@fluidframework/devtools-core\";\nexport const pkgVersion = \"2.70.0-361248\";\n"]}
+{"version":3,"file":"packageVersion.js","sourceRoot":"","sources":["../src/packageVersion.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,+BAA+B,CAAC;AACvD,MAAM,CAAC,MAAM,UAAU,GAAG,eAAe,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n *\n * THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY\n */\n\nexport const pkgName = \"@fluidframework/devtools-core\";\nexport const pkgVersion = \"2.70.0-361788\";\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fluidframework/devtools-core",
-  "version": "2.70.0-361248",
+  "version": "2.70.0-361788",
   "description": "Fluid Framework developer tools core functionality",
   "homepage": "https://fluidframework.com",
   "repository": {
@@ -33,6 +33,16 @@
         "default": "./dist/index.js"
       }
     },
+    "./beta": {
+      "import": {
+        "types": "./lib/beta.d.ts",
+        "default": "./lib/index.js"
+      },
+      "require": {
+        "types": "./dist/beta.d.ts",
+        "default": "./dist/index.js"
+      }
+    },
     "./internal": {
       "import": {
         "types": "./lib/index.d.ts",
@@ -67,37 +77,37 @@
     "temp-directory": "nyc/.nyc_output"
   },
   "dependencies": {
-    "@fluid-internal/client-utils": "2.70.0-361248",
-    "@fluidframework/aqueduct": "2.70.0-361248",
-    "@fluidframework/cell": "2.70.0-361248",
-    "@fluidframework/container-definitions": "2.70.0-361248",
-    "@fluidframework/container-loader": "2.70.0-361248",
-    "@fluidframework/container-runtime": "2.70.0-361248",
-    "@fluidframework/container-runtime-definitions": "2.70.0-361248",
-    "@fluidframework/core-interfaces": "2.70.0-361248",
-    "@fluidframework/core-utils": "2.70.0-361248",
-    "@fluidframework/counter": "2.70.0-361248",
-    "@fluidframework/datastore-definitions": "2.70.0-361248",
-    "@fluidframework/driver-definitions": "2.70.0-361248",
-    "@fluidframework/map": "2.70.0-361248",
-    "@fluidframework/matrix": "2.70.0-361248",
-    "@fluidframework/runtime-definitions": "2.70.0-361248",
-    "@fluidframework/sequence": "2.70.0-361248",
-    "@fluidframework/shared-object-base": "2.70.0-361248",
-    "@fluidframework/telemetry-utils": "2.70.0-361248",
-    "@fluidframework/tree": "2.70.0-361248"
+    "@fluid-internal/client-utils": "2.70.0-361788",
+    "@fluidframework/aqueduct": "2.70.0-361788",
+    "@fluidframework/cell": "2.70.0-361788",
+    "@fluidframework/container-definitions": "2.70.0-361788",
+    "@fluidframework/container-loader": "2.70.0-361788",
+    "@fluidframework/container-runtime": "2.70.0-361788",
+    "@fluidframework/container-runtime-definitions": "2.70.0-361788",
+    "@fluidframework/core-interfaces": "2.70.0-361788",
+    "@fluidframework/core-utils": "2.70.0-361788",
+    "@fluidframework/counter": "2.70.0-361788",
+    "@fluidframework/datastore-definitions": "2.70.0-361788",
+    "@fluidframework/driver-definitions": "2.70.0-361788",
+    "@fluidframework/map": "2.70.0-361788",
+    "@fluidframework/matrix": "2.70.0-361788",
+    "@fluidframework/runtime-definitions": "2.70.0-361788",
+    "@fluidframework/sequence": "2.70.0-361788",
+    "@fluidframework/shared-object-base": "2.70.0-361788",
+    "@fluidframework/telemetry-utils": "2.70.0-361788",
+    "@fluidframework/tree": "2.70.0-361788"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.17.1",
     "@biomejs/biome": "~1.9.3",
-    "@fluid-internal/mocha-test-setup": "2.70.0-361248",
+    "@fluid-internal/mocha-test-setup": "2.70.0-361788",
     "@fluid-tools/build-cli": "^0.58.3",
     "@fluidframework/build-common": "^2.0.3",
     "@fluidframework/build-tools": "^0.58.3",
     "@fluidframework/devtools-core-previous": "npm:@fluidframework/devtools-core@2.63.0",
     "@fluidframework/eslint-config-fluid": "^6.1.0",
-    "@fluidframework/id-compressor": "2.70.0-361248",
-    "@fluidframework/test-runtime-utils": "2.70.0-361248",
+    "@fluidframework/id-compressor": "2.70.0-361788",
+    "@fluidframework/test-runtime-utils": "2.70.0-361788",
     "@microsoft/api-extractor": "7.52.11",
     "@types/chai": "^4.0.0",
     "@types/mocha": "^10.0.10",
@@ -136,8 +146,10 @@
     "check:exports": "concurrently \"npm:check:exports:*\"",
     "check:exports:bundle-release-tags": "api-extractor run --config api-extractor/api-extractor-lint-bundle.json",
     "check:exports:cjs:alpha": "api-extractor run --config api-extractor/api-extractor-lint-alpha.cjs.json",
+    "check:exports:cjs:beta": "api-extractor run --config api-extractor/api-extractor-lint-beta.cjs.json",
     "check:exports:cjs:public": "api-extractor run --config api-extractor/api-extractor-lint-public.cjs.json",
     "check:exports:esm:alpha": "api-extractor run --config api-extractor/api-extractor-lint-alpha.esm.json",
+    "check:exports:esm:beta": "api-extractor run --config api-extractor/api-extractor-lint-beta.esm.json",
     "check:exports:esm:public": "api-extractor run --config api-extractor/api-extractor-lint-public.esm.json",
     "check:format": "npm run check:biome",
     "ci:build:docs": "api-extractor run",

package/src/ContainerDevtools.ts

@@ -18,13 +18,15 @@ import {
 
 /**
  * Properties for registering a {@link @fluidframework/container-definitions#IContainer} with the Devtools.
- * @alpha
+ * @beta
+ * @input
+ * @sealed
  */
 export interface ContainerDevtoolsProps extends HasContainerKey {
 	/**
 	 * The Container to register with the Devtools.
 	 */
-	container: IContainer;
+	readonly container: IContainer;
 
 	/**
 	 * (optional) Distributed Data Structures (DDSs) associated with the
@@ -39,7 +41,7 @@ export interface ContainerDevtoolsProps extends HasContainerKey {
 	 *
 	 * @privateRemarks TODO: rename this to make it more clear that this data does not *belong* to the Container.
 	 */
-	containerData?: Record<string, IFluidLoadable>;
+	readonly containerData?: Record<string, IFluidLoadable>;
 
 	// TODO: Add ability for customers to specify custom visualizer overrides
 }

package/src/ContainerRuntimeDevtools.ts

@@ -23,7 +23,8 @@ import type { InboundHandlers } from "./messaging/index.js";
 
 /**
  * Properties for registering a container runtime with the Devtools.
- * @alpha
+ * @beta
+ * @sealed
  * @input
  */
 export interface ContainerRuntimeProps {
@@ -35,7 +36,7 @@ export interface ContainerRuntimeProps {
 	/**
 	 * Optional label for the container runtime replacing the guid generated by {@link @fluidframework/container-runtime#IContainerRuntime.generateDocumentUniqueId}.
 	 */
-	label?: string;
+	readonly label?: string;
 }
 
 /**