@fluidframework/datastore 2.0.0-internal.2.0.2 → 2.0.0-internal.2.1.0

package/lib/fluidHandle.js

@@ -3,12 +3,17 @@
  * Licensed under the MIT License.
  */
 import { generateHandleContextPath } from "@fluidframework/runtime-utils";
+/**
+ * Handle for a shared {@link @fluidframework/core-interfaces#FluidObject}.
+ */
 export class FluidObjectHandle {
     /**
-     * Creates a new FluidObjectHandle.
-     * @param value - The FluidObject object this handle is for.
-     * @param path - The path to this handle relative to the routeContext.
-     * @param routeContext - The parent IFluidHandleContext that has a route to this handle.
+     * Creates a new `FluidObjectHandle`.
+     *
+     * @param value - The {@link @fluidframework/core-interfaces#FluidObject} object this handle is for.
+     * @param path - The path to this handle relative to the `routeContext`.
+     * @param routeContext - The parent {@link @fluidframework/core-interfaces#IFluidHandleContext} that has a route
+     * to this handle.
      */
     constructor(value, path, routeContext) {
         this.value = value;
@@ -21,7 +26,15 @@ export class FluidObjectHandle {
         this.locallyVisible = false;
         this.absolutePath = generateHandleContextPath(path, this.routeContext);
     }
-    get IFluidHandle() { return this; }
+    /**
+     * {@inheritDoc @fluidframework/core-interfaces#IProvideFluidHandle.IFluidHandle}
+     */
+    get IFluidHandle() {
+        return this;
+    }
+    /**
+     * {@inheritDoc @fluidframework/core-interfaces#IFluidHandle.isAttached}
+     */
     get isAttached() {
         return this.routeContext.isAttached;
     }
@@ -43,10 +56,16 @@ export class FluidObjectHandle {
          */
         return this.isAttached || this.locallyVisible;
     }
+    /**
+     * {@inheritDoc @fluidframework/core-interfaces#IFluidHandle.get}
+     */
     async get() {
         // Note that this return works whether we received a T or a Promise<T> for this.value in the constructor.
         return this.value;
     }
+    /**
+     * {@inheritDoc @fluidframework/core-interfaces#IFluidHandle.attachGraph }
+     */
     attachGraph() {
         if (this.visible) {
             return;
@@ -58,6 +77,9 @@ export class FluidObjectHandle {
         this.pendingHandlesToMakeVisible.clear();
         this.routeContext.attachGraph();
     }
+    /**
+     * {@inheritDoc @fluidframework/core-interfaces#IFluidHandle.bind}
+     */
     bind(handle) {
         // If this handle is visible, attach the graph of the incoming handle as well.
         if (this.visible) {

package/lib/fluidHandle.js.map

@@ -1 +1 @@
-{"version":3,"file":"fluidHandle.js","sourceRoot":"","sources":["../src/fluidHandle.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAE1E,MAAM,OAAO,iBAAiB;IAkC1B;;;;;OAKG;IACH,YACuB,KAAqB,EACxB,IAAY,EACZ,YAAiC;QAF9B,UAAK,GAAL,KAAK,CAAgB;QACxB,SAAI,GAAJ,IAAI,CAAQ;QACZ,iBAAY,GAAZ,YAAY,CAAqB;QA1CpC,gCAA2B,GAAsB,IAAI,GAAG,EAAE,CAAC;QA4B5E;;WAEG;QACK,mBAAc,GAAY,KAAK,CAAC;QAapC,IAAI,CAAC,YAAY,GAAG,yBAAyB,CAAC,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IAC3E,CAAC;IA1CD,IAAW,YAAY,KAAmB,OAAO,IAAI,CAAC,CAAC,CAAC;IAExD,IAAW,UAAU;QACjB,OAAO,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,IAAY,OAAO;QACf;;;;;;;;;;;WAWG;QACH,OAAO,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,cAAc,CAAC;IAClD,CAAC;IAqBM,KAAK,CAAC,GAAG;QACZ,yGAAyG;QACzG,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;IAEM,WAAW;QACd,IAAI,IAAI,CAAC,OAAO,EAAE;YACd,OAAO;SACV;QAED,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC3B,IAAI,CAAC,2BAA2B,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;YAChD,MAAM,CAAC,WAAW,EAAE,CAAC;QACzB,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,2BAA2B,CAAC,KAAK,EAAE,CAAC;QACzC,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;IACpC,CAAC;IAEM,IAAI,CAAC,MAAoB;QAC5B,8EAA8E;QAC9E,IAAI,IAAI,CAAC,OAAO,EAAE;YACd,MAAM,CAAC,WAAW,EAAE,CAAC;YACrB,OAAO;SACV;QACD,IAAI,CAAC,2BAA2B,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACjD,CAAC;CACJ","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport {\n    IFluidHandle,\n    IFluidHandleContext,\n    FluidObject,\n} from \"@fluidframework/core-interfaces\";\nimport { generateHandleContextPath } from \"@fluidframework/runtime-utils\";\n\nexport class FluidObjectHandle<T extends FluidObject = FluidObject> implements IFluidHandle {\n    private readonly pendingHandlesToMakeVisible: Set<IFluidHandle> = new Set();\n    public readonly absolutePath: string;\n\n    public get IFluidHandle(): IFluidHandle { return this; }\n\n    public get isAttached(): boolean {\n        return this.routeContext.isAttached;\n    }\n\n    /**\n     * Tells whether the object of this handle is visible in the container locally or globally.\n     */\n    private get visible(): boolean {\n        /**\n         * If the object of this handle is attached, it is visible in the container. Ideally, checking local visibility\n         * should be enough for a handle. However, there are scenarios where the object becomes locally visible but the\n         * handle does not know this - This will happen is attachGraph is never called on the handle. Couple of examples\n         * where this can happen:\n         *\n         * 1. Handles to DDS other than the default handle won't know if the DDS becomes visible after the handle was\n         * created.\n         *\n         * 2. Handles to root data stores will never know that it was visible because the handle will not be stores in\n         * another DDS and so, attachGraph will never be called on it.\n         */\n        return this.isAttached || this.locallyVisible;\n    }\n\n    /**\n     * Tracks whether this handle is locally visible in the container.\n     */\n    private locallyVisible: boolean = false;\n\n    /**\n     * Creates a new FluidObjectHandle.\n     * @param value - The FluidObject object this handle is for.\n     * @param path - The path to this handle relative to the routeContext.\n     * @param routeContext - The parent IFluidHandleContext that has a route to this handle.\n     */\n    constructor(\n        protected readonly value: T | Promise<T>,\n        public readonly path: string,\n        public readonly routeContext: IFluidHandleContext,\n    ) {\n        this.absolutePath = generateHandleContextPath(path, this.routeContext);\n    }\n\n    public async get(): Promise<any> {\n        // Note that this return works whether we received a T or a Promise<T> for this.value in the constructor.\n        return this.value;\n    }\n\n    public attachGraph(): void {\n        if (this.visible) {\n            return;\n        }\n\n        this.locallyVisible = true;\n        this.pendingHandlesToMakeVisible.forEach((handle) => {\n            handle.attachGraph();\n        });\n        this.pendingHandlesToMakeVisible.clear();\n        this.routeContext.attachGraph();\n    }\n\n    public bind(handle: IFluidHandle) {\n        // If this handle is visible, attach the graph of the incoming handle as well.\n        if (this.visible) {\n            handle.attachGraph();\n            return;\n        }\n        this.pendingHandlesToMakeVisible.add(handle);\n    }\n}\n"]}
+{"version":3,"file":"fluidHandle.js","sourceRoot":"","sources":["../src/fluidHandle.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAE1E;;GAEG;AACH,MAAM,OAAO,iBAAiB;IA8C1B;;;;;;;OAOG;IACH,YACuB,KAAqB,EACxB,IAAY,EACZ,YAAiC;QAF9B,UAAK,GAAL,KAAK,CAAgB;QACxB,SAAI,GAAJ,IAAI,CAAQ;QACZ,iBAAY,GAAZ,YAAY,CAAqB;QAxDpC,gCAA2B,GAAsB,IAAI,GAAG,EAAE,CAAC;QAwC5E;;WAEG;QACK,mBAAc,GAAY,KAAK,CAAC;QAepC,IAAI,CAAC,YAAY,GAAG,yBAAyB,CAAC,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IAC3E,CAAC;IApDD;;OAEG;IACH,IAAW,YAAY;QACnB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,IAAW,UAAU;QACjB,OAAO,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,IAAY,OAAO;QACf;;;;;;;;;;;WAWG;QACH,OAAO,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,cAAc,CAAC;IAClD,CAAC;IAuBD;;OAEG;IACI,KAAK,CAAC,GAAG;QACZ,yGAAyG;QACzG,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;IAED;;OAEG;IACI,WAAW;QACd,IAAI,IAAI,CAAC,OAAO,EAAE;YACd,OAAO;SACV;QAED,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC3B,IAAI,CAAC,2BAA2B,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;YAChD,MAAM,CAAC,WAAW,EAAE,CAAC;QACzB,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,2BAA2B,CAAC,KAAK,EAAE,CAAC;QACzC,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;IACpC,CAAC;IAED;;OAEG;IACI,IAAI,CAAC,MAAoB;QAC5B,8EAA8E;QAC9E,IAAI,IAAI,CAAC,OAAO,EAAE;YACd,MAAM,CAAC,WAAW,EAAE,CAAC;YACrB,OAAO;SACV;QACD,IAAI,CAAC,2BAA2B,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACjD,CAAC;CACJ","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport {\n    IFluidHandle,\n    IFluidHandleContext,\n    FluidObject,\n} from \"@fluidframework/core-interfaces\";\nimport { generateHandleContextPath } from \"@fluidframework/runtime-utils\";\n\n/**\n * Handle for a shared {@link @fluidframework/core-interfaces#FluidObject}.\n */\nexport class FluidObjectHandle<T extends FluidObject = FluidObject> implements IFluidHandle {\n    private readonly pendingHandlesToMakeVisible: Set<IFluidHandle> = new Set();\n\n    /**\n     * {@inheritDoc @fluidframework/core-interfaces#IFluidHandle.absolutePath}\n     */\n    public readonly absolutePath: string;\n\n    /**\n     * {@inheritDoc @fluidframework/core-interfaces#IProvideFluidHandle.IFluidHandle}\n     */\n    public get IFluidHandle(): IFluidHandle {\n        return this;\n    }\n\n    /**\n     * {@inheritDoc @fluidframework/core-interfaces#IFluidHandle.isAttached}\n     */\n    public get isAttached(): boolean {\n        return this.routeContext.isAttached;\n    }\n\n    /**\n     * Tells whether the object of this handle is visible in the container locally or globally.\n     */\n    private get visible(): boolean {\n        /**\n         * If the object of this handle is attached, it is visible in the container. Ideally, checking local visibility\n         * should be enough for a handle. However, there are scenarios where the object becomes locally visible but the\n         * handle does not know this - This will happen is attachGraph is never called on the handle. Couple of examples\n         * where this can happen:\n         *\n         * 1. Handles to DDS other than the default handle won't know if the DDS becomes visible after the handle was\n         * created.\n         *\n         * 2. Handles to root data stores will never know that it was visible because the handle will not be stores in\n         * another DDS and so, attachGraph will never be called on it.\n         */\n        return this.isAttached || this.locallyVisible;\n    }\n\n    /**\n     * Tracks whether this handle is locally visible in the container.\n     */\n    private locallyVisible: boolean = false;\n\n    /**\n     * Creates a new `FluidObjectHandle`.\n     *\n     * @param value - The {@link @fluidframework/core-interfaces#FluidObject} object this handle is for.\n     * @param path - The path to this handle relative to the `routeContext`.\n     * @param routeContext - The parent {@link @fluidframework/core-interfaces#IFluidHandleContext} that has a route\n     * to this handle.\n     */\n    constructor(\n        protected readonly value: T | Promise<T>,\n        public readonly path: string,\n        public readonly routeContext: IFluidHandleContext,\n    ) {\n        this.absolutePath = generateHandleContextPath(path, this.routeContext);\n    }\n\n    /**\n     * {@inheritDoc @fluidframework/core-interfaces#IFluidHandle.get}\n     */\n    public async get(): Promise<any> {\n        // Note that this return works whether we received a T or a Promise<T> for this.value in the constructor.\n        return this.value;\n    }\n\n    /**\n     * {@inheritDoc @fluidframework/core-interfaces#IFluidHandle.attachGraph }\n     */\n    public attachGraph(): void {\n        if (this.visible) {\n            return;\n        }\n\n        this.locallyVisible = true;\n        this.pendingHandlesToMakeVisible.forEach((handle) => {\n            handle.attachGraph();\n        });\n        this.pendingHandlesToMakeVisible.clear();\n        this.routeContext.attachGraph();\n    }\n\n    /**\n     * {@inheritDoc @fluidframework/core-interfaces#IFluidHandle.bind}\n     */\n    public bind(handle: IFluidHandle) {\n        // If this handle is visible, attach the graph of the incoming handle as well.\n        if (this.visible) {\n            handle.attachGraph();\n            return;\n        }\n        this.pendingHandlesToMakeVisible.add(handle);\n    }\n}\n"]}

package/lib/index.d.ts

@@ -2,6 +2,6 @@
  * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
  * Licensed under the MIT License.
  */
-export * from "./dataStoreRuntime";
-export * from "./fluidHandle";
+export { FluidObjectHandle } from "./fluidHandle";
+export { DataStoreMessageType, FluidDataStoreRuntime, ISharedObjectRegistry, mixinRequestHandler, mixinSummaryHandler, } from "./dataStoreRuntime";
 //# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EACN,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,GACnB,MAAM,oBAAoB,CAAC"}

package/lib/index.js

@@ -2,6 +2,6 @@
  * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
  * Licensed under the MIT License.
  */
-export * from "./dataStoreRuntime";
-export * from "./fluidHandle";
+export { FluidObjectHandle } from "./fluidHandle";
+export { DataStoreMessageType, FluidDataStoreRuntime, mixinRequestHandler, mixinSummaryHandler, } from "./dataStoreRuntime";
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nexport * from \"./dataStoreRuntime\";\nexport * from \"./fluidHandle\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EACN,oBAAoB,EACpB,qBAAqB,EAErB,mBAAmB,EACnB,mBAAmB,GACnB,MAAM,oBAAoB,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nexport { FluidObjectHandle } from \"./fluidHandle\";\nexport {\n\tDataStoreMessageType,\n\tFluidDataStoreRuntime,\n\tISharedObjectRegistry,\n\tmixinRequestHandler,\n\tmixinSummaryHandler,\n} from \"./dataStoreRuntime\";\n"]}

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/datastore";
-export declare const pkgVersion = "2.0.0-internal.2.0.2";
+export declare const pkgVersion = "2.0.0-internal.2.1.0";
 //# 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/datastore";
-export const pkgVersion = "2.0.0-internal.2.0.2";
+export const pkgVersion = "2.0.0-internal.2.1.0";
 //# 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,2BAA2B,CAAC;AACnD,MAAM,CAAC,MAAM,UAAU,GAAG,sBAAsB,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/datastore\";\nexport const pkgVersion = \"2.0.0-internal.2.0.2\";\n"]}
+{"version":3,"file":"packageVersion.js","sourceRoot":"","sources":["../src/packageVersion.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,2BAA2B,CAAC;AACnD,MAAM,CAAC,MAAM,UAAU,GAAG,sBAAsB,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/datastore\";\nexport const pkgVersion = \"2.0.0-internal.2.1.0\";\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fluidframework/datastore",
-  "version": "2.0.0-internal.2.0.2",
+  "version": "2.0.0-internal.2.1.0",
   "description": "Fluid data store implementation",
   "homepage": "https://fluidframework.com",
   "repository": {
@@ -36,8 +36,6 @@
     "test:mocha:verbose": "cross-env FLUID_TEST_VERBOSE=1 npm run test:mocha",
     "tsc": "tsc",
     "tsc:watch": "tsc --watch",
-    "tsfmt": "tsfmt --verify",
-    "tsfmt:fix": "tsfmt --replace",
     "typetests:gen": "fluid-type-validator -g -d ."
   },
   "nyc": {
@@ -63,28 +61,29 @@
   "dependencies": {
     "@fluidframework/common-definitions": "^0.20.1",
     "@fluidframework/common-utils": "^1.0.0",
-    "@fluidframework/container-definitions": ">=2.0.0-internal.2.0.2 <2.0.0-internal.3.0.0",
-    "@fluidframework/container-utils": ">=2.0.0-internal.2.0.2 <2.0.0-internal.3.0.0",
-    "@fluidframework/core-interfaces": ">=2.0.0-internal.2.0.2 <2.0.0-internal.3.0.0",
-    "@fluidframework/datastore-definitions": ">=2.0.0-internal.2.0.2 <2.0.0-internal.3.0.0",
-    "@fluidframework/driver-definitions": ">=2.0.0-internal.2.0.2 <2.0.0-internal.3.0.0",
-    "@fluidframework/driver-utils": ">=2.0.0-internal.2.0.2 <2.0.0-internal.3.0.0",
-    "@fluidframework/garbage-collector": ">=2.0.0-internal.2.0.2 <2.0.0-internal.3.0.0",
+    "@fluidframework/container-definitions": ">=2.0.0-internal.2.1.0 <2.0.0-internal.3.0.0",
+    "@fluidframework/container-utils": ">=2.0.0-internal.2.1.0 <2.0.0-internal.3.0.0",
+    "@fluidframework/core-interfaces": ">=2.0.0-internal.2.1.0 <2.0.0-internal.3.0.0",
+    "@fluidframework/datastore-definitions": ">=2.0.0-internal.2.1.0 <2.0.0-internal.3.0.0",
+    "@fluidframework/driver-definitions": ">=2.0.0-internal.2.1.0 <2.0.0-internal.3.0.0",
+    "@fluidframework/driver-utils": ">=2.0.0-internal.2.1.0 <2.0.0-internal.3.0.0",
+    "@fluidframework/garbage-collector": ">=2.0.0-internal.2.1.0 <2.0.0-internal.3.0.0",
     "@fluidframework/protocol-base": "^0.1038.2000",
     "@fluidframework/protocol-definitions": "^1.1.0",
-    "@fluidframework/runtime-definitions": ">=2.0.0-internal.2.0.2 <2.0.0-internal.3.0.0",
-    "@fluidframework/runtime-utils": ">=2.0.0-internal.2.0.2 <2.0.0-internal.3.0.0",
-    "@fluidframework/telemetry-utils": ">=2.0.0-internal.2.0.2 <2.0.0-internal.3.0.0",
+    "@fluidframework/runtime-definitions": ">=2.0.0-internal.2.1.0 <2.0.0-internal.3.0.0",
+    "@fluidframework/runtime-utils": ">=2.0.0-internal.2.1.0 <2.0.0-internal.3.0.0",
+    "@fluidframework/telemetry-utils": ">=2.0.0-internal.2.1.0 <2.0.0-internal.3.0.0",
     "lodash": "^4.17.21",
     "uuid": "^8.3.1"
   },
   "devDependencies": {
-    "@fluidframework/build-common": "^1.0.0",
-    "@fluidframework/build-tools": "^0.4.6000",
+    "@fluid-tools/build-cli": "^0.5.0",
+    "@fluidframework/build-common": "^1.1.0",
+    "@fluidframework/build-tools": "^0.5.0",
     "@fluidframework/datastore-previous": "npm:@fluidframework/datastore@2.0.0-internal.2.0.0",
-    "@fluidframework/eslint-config-fluid": "^1.0.0",
-    "@fluidframework/mocha-test-setup": ">=2.0.0-internal.2.0.2 <2.0.0-internal.3.0.0",
-    "@fluidframework/test-runtime-utils": ">=2.0.0-internal.2.0.2 <2.0.0-internal.3.0.0",
+    "@fluidframework/eslint-config-fluid": "^1.1.0",
+    "@fluidframework/mocha-test-setup": ">=2.0.0-internal.2.1.0 <2.0.0-internal.3.0.0",
+    "@fluidframework/test-runtime-utils": ">=2.0.0-internal.2.1.0 <2.0.0-internal.3.0.0",
     "@microsoft/api-extractor": "^7.22.2",
     "@rushstack/eslint-config": "^2.5.1",
     "@types/mocha": "^9.1.1",
@@ -97,11 +96,10 @@
     "mocha": "^10.0.0",
     "nyc": "^15.0.0",
     "rimraf": "^2.6.2",
-    "typescript": "~4.5.5",
-    "typescript-formatter": "7.1.0"
+    "typescript": "~4.5.5"
   },
   "typeValidation": {
-    "version": "2.0.0-internal.2.0.1",
+    "version": "2.0.0-internal.2.1.0",
     "broken": {}
   }
 }

package/src/dataStoreRuntime.ts

@@ -5,6 +5,7 @@
 
 import { ITelemetryLogger } from "@fluidframework/common-definitions";
 import {
+    FluidObject,
     IFluidHandle,
     IFluidHandleContext,
     IRequest,
@@ -62,6 +63,7 @@ import {
     create404Response,
     createResponseError,
     exceptionToResponse,
+    requestFluidObject,
 } from "@fluidframework/runtime-utils";
 import {
     IChannel,
@@ -79,6 +81,7 @@ import { v4 as uuid } from "uuid";
 import { IChannelContext, summarizeChannel } from "./channelContext";
 import { LocalChannelContext, LocalChannelContextBase, RehydratedLocalChannelContext } from "./localChannelContext";
 import { RemoteChannelContext } from "./remoteChannelContext";
+import { FluidObjectHandle } from "./fluidHandle";
 
 export enum DataStoreMessageType {
     // Creates a new channel
@@ -99,6 +102,8 @@ export class FluidDataStoreRuntime extends
 TypedEventEmitter<IFluidDataStoreRuntimeEvents> implements
 IFluidDataStoreChannel, IFluidDataStoreRuntime, IFluidHandleContext {
     /**
+     * @deprecated - Instantiate the class using its constructor instead.
+     *
      * Loads the data store runtime
      * @param context - The data store context
      * @param sharedObjectRegistry - The registry of shared objects used by this data store
@@ -109,9 +114,18 @@ IFluidDataStoreChannel, IFluidDataStoreRuntime, IFluidHandleContext {
         sharedObjectRegistry: ISharedObjectRegistry,
         existing: boolean,
     ): FluidDataStoreRuntime {
-        return new FluidDataStoreRuntime(context, sharedObjectRegistry, existing);
+        return new FluidDataStoreRuntime(
+            context,
+            sharedObjectRegistry,
+            existing,
+            async (dataStoreRuntime) => requestFluidObject(dataStoreRuntime, "/"));
     }
 
+    /**
+     * {@inheritDoc @fluidframework/datastore-definitions#IFluidDataStoreRuntime.entryPoint}
+     */
+    public readonly entryPoint?: IFluidHandle<FluidObject>;
+
     public get IFluidRouter() { return this; }
 
     public get connected(): boolean {
@@ -176,10 +190,22 @@ IFluidDataStoreChannel, IFluidDataStoreRuntime, IFluidHandleContext {
     // channel contexts.
     private readonly channelsBaseGCDetails: LazyPromise<Map<string, IGarbageCollectionDetailsBase>>;
 
+    /**
+     * Create an instance of a DataStore runtime.
+     *
+     * @param dataStoreContext - Context object for the runtime.
+     * @param sharedObjectRegistry - The registry of shared objects that this data store will be able to instantiate.
+     * @param existing - Pass 'true' if loading this datastore from an existing file; pass 'false' otherwise.
+     * @param initializeEntryPoint - Function to initialize the entryPoint object for the data store runtime. The
+     * handle to this data store runtime will point to the object returned by this function. If this function is not
+     * provided, the handle will be left undefined. This is here so we can start making handles a first-class citizen
+     * and the primary way of interacting with some Fluid objects, and should be used if possible.
+     */
     public constructor(
         private readonly dataStoreContext: IFluidDataStoreContext,
         private readonly sharedObjectRegistry: ISharedObjectRegistry,
         existing: boolean,
+        initializeEntryPoint?: (runtime: IFluidDataStoreRuntime) => Promise<FluidObject>,
     ) {
         super();
 
@@ -264,6 +290,11 @@ IFluidDataStoreChannel, IFluidDataStoreRuntime, IFluidHandleContext {
             });
         }
 
+        if (initializeEntryPoint) {
+            const promise = new LazyPromise(async () => initializeEntryPoint(this));
+            this.entryPoint = new FluidObjectHandle<FluidObject>(promise, "", this.objectsRoutingContext);
+        }
+
         this.attachListener();
         // If exists on storage or loaded from a snapshot, it should already be bound.
         this.bindState = existing ? BindState.Bound : BindState.NotBound;

package/src/fluidHandle.ts

@@ -10,12 +10,27 @@ import {
 } from "@fluidframework/core-interfaces";
 import { generateHandleContextPath } from "@fluidframework/runtime-utils";
 
+/**
+ * Handle for a shared {@link @fluidframework/core-interfaces#FluidObject}.
+ */
 export class FluidObjectHandle<T extends FluidObject = FluidObject> implements IFluidHandle {
     private readonly pendingHandlesToMakeVisible: Set<IFluidHandle> = new Set();
+
+    /**
+     * {@inheritDoc @fluidframework/core-interfaces#IFluidHandle.absolutePath}
+     */
     public readonly absolutePath: string;
 
-    public get IFluidHandle(): IFluidHandle { return this; }
+    /**
+     * {@inheritDoc @fluidframework/core-interfaces#IProvideFluidHandle.IFluidHandle}
+     */
+    public get IFluidHandle(): IFluidHandle {
+        return this;
+    }
 
+    /**
+     * {@inheritDoc @fluidframework/core-interfaces#IFluidHandle.isAttached}
+     */
     public get isAttached(): boolean {
         return this.routeContext.isAttached;
     }
@@ -45,10 +60,12 @@ export class FluidObjectHandle<T extends FluidObject = FluidObject> implements I
     private locallyVisible: boolean = false;
 
     /**
-     * Creates a new FluidObjectHandle.
-     * @param value - The FluidObject object this handle is for.
-     * @param path - The path to this handle relative to the routeContext.
-     * @param routeContext - The parent IFluidHandleContext that has a route to this handle.
+     * Creates a new `FluidObjectHandle`.
+     *
+     * @param value - The {@link @fluidframework/core-interfaces#FluidObject} object this handle is for.
+     * @param path - The path to this handle relative to the `routeContext`.
+     * @param routeContext - The parent {@link @fluidframework/core-interfaces#IFluidHandleContext} that has a route
+     * to this handle.
      */
     constructor(
         protected readonly value: T | Promise<T>,
@@ -58,11 +75,17 @@ export class FluidObjectHandle<T extends FluidObject = FluidObject> implements I
         this.absolutePath = generateHandleContextPath(path, this.routeContext);
     }
 
+    /**
+     * {@inheritDoc @fluidframework/core-interfaces#IFluidHandle.get}
+     */
     public async get(): Promise<any> {
         // Note that this return works whether we received a T or a Promise<T> for this.value in the constructor.
         return this.value;
     }
 
+    /**
+     * {@inheritDoc @fluidframework/core-interfaces#IFluidHandle.attachGraph }
+     */
     public attachGraph(): void {
         if (this.visible) {
             return;
@@ -76,6 +99,9 @@ export class FluidObjectHandle<T extends FluidObject = FluidObject> implements I
         this.routeContext.attachGraph();
     }
 
+    /**
+     * {@inheritDoc @fluidframework/core-interfaces#IFluidHandle.bind}
+     */
     public bind(handle: IFluidHandle) {
         // If this handle is visible, attach the graph of the incoming handle as well.
         if (this.visible) {

package/src/index.ts

@@ -3,5 +3,11 @@
  * Licensed under the MIT License.
  */
 
-export * from "./dataStoreRuntime";
-export * from "./fluidHandle";
+export { FluidObjectHandle } from "./fluidHandle";
+export {
+	DataStoreMessageType,
+	FluidDataStoreRuntime,
+	ISharedObjectRegistry,
+	mixinRequestHandler,
+	mixinSummaryHandler,
+} from "./dataStoreRuntime";

package/src/packageVersion.ts

@@ -6,4 +6,4 @@
  */
 
 export const pkgName = "@fluidframework/datastore";
-export const pkgVersion = "2.0.0-internal.2.0.2";
+export const pkgVersion = "2.0.0-internal.2.1.0";