@fluidframework/datastore 0.58.3000-61081 → 0.59.1000-61898

package/lib/localChannelContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"localChannelContext.js","sourceRoot":"","sources":["../src/localChannelContext.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,sDAAsD;AACtD,OAAO,SAAS,MAAM,kBAAkB,CAAC;AAezC,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AAE5D,OAAO,EACH,sBAAsB,EAEtB,gBAAgB,EAChB,qBAAqB,GACxB,MAAM,kBAAkB,CAAC;AAK1B;;GAEG;AACH,MAAM,OAAgB,uBAAuB;IAKzC,YACuB,EAAU,EACV,QAA+B,EAC/B,OAA+B,EACjC,cAGX;QANa,OAAE,GAAF,EAAE,CAAQ;QACV,aAAQ,GAAR,QAAQ,CAAuB;QAC/B,YAAO,GAAP,OAAO,CAAwB;QACjC,mBAAc,GAAd,cAAc,CAGzB;QAVF,aAAQ,GAAG,KAAK,CAAC;QACN,YAAO,GAAgC,EAAE,CAAC;IAW7D,CAAC;IAEM,KAAK,CAAC,UAAU;QACnB,MAAM,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,KAAK,CAAC,iCAAiC,CAAC,CAAC;QAC5E,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,IAAW,QAAQ;QACf,OAAO,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC;IACtC,CAAC;IAEM,kBAAkB,CAAC,SAAkB,EAAE,QAAiB;QAC3D,gFAAgF;QAChF,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,EAAE;YAChC,IAAI,CAAC,cAAc,EAAE,CAAC,KAAK,CAAC,eAAe,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;SAC7E;IACL,CAAC;IAEM,SAAS,CAAC,OAAkC,EAAE,KAAc,EAAE,eAAwB;QACzF,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,yDAAyD,CAAC,CAAC;QAEvF,wGAAwG;QACxG,uGAAuG;QACvG,8GAA8G;QAC9G,IAAI,IAAI,CAAC,QAAQ,EAAE;YACf,IAAI,CAAC,cAAc,EAAE,CAAC,KAAK,CAAC,eAAe,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC;SACxF;aAAM;YACH,MAAM,CAAC,KAAK,KAAK,KAAK,EAClB,KAAK,CAAC,yFAAyF,CAAC,CAAC;YACrG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;SAC9B;IACL,CAAC;IAEM,QAAQ,CAAC,OAAY,EAAE,eAAwB;QAClD,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,gDAAgD,CAAC,CAAC;QAC9E,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,2DAA2D,CAAC,CAAC;QACzF,IAAI,CAAC,cAAc,EAAE,CAAC,KAAK,CAAC,eAAe,CAAC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IACnF,CAAC;IAEM,cAAc;QACjB,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACvD,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,SAAS,CAAC,WAAoB,KAAK,EAAE,aAAsB,KAAK;QACzE,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACzG,OAAO,qBAAqB,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;IACrE,CAAC;IAEM,gBAAgB;QACnB,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,KAAK,CAAC,iDAAiD,CAAC,CAAC;QAC7G,OAAO,gBAAgB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACvF,CAAC;IAEM,YAAY;QACf,IAAI,IAAI,CAAC,QAAQ,EAAE;YACf,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;SAClD;QAED,IAAI,IAAI,CAAC,QAAQ,EAAE;YACf,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,2CAA2C,CAAC,CAAC;YAC1E,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,KAAK,CAAC,CAAC;SACrD;QACD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;IACzB,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,SAAS,CAAC,SAAkB,KAAK;QAC1C,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,KAAK,CAAC,0CAA0C,CAAC,CAAC;QACtG,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAEM,gBAAgB,CAAC,UAAoB,EAAE,WAAoB;QAC9D;;;;WAIG;IACP,CAAC;CACJ;AAED,MAAM,OAAO,6BAA8B,SAAQ,uBAAuB;IAQtE,YACI,EAAU,EACV,QAA+B,EAC/B,OAA+B,EAC/B,gBAAwC,EACxC,cAAuC,EACvC,MAAwB,EACxB,QAA0D,EAC1D,OAAkC,EAClC,0BAA2F,EAC1E,YAA2B;QAE5C,KAAK,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAFjC,iBAAY,GAAZ,YAAY,CAAe;QAG5C,MAAM,OAAO,GAAiC,IAAI,GAAG,EAA2B,CAAC;QACjF,MAAM,kBAAkB,GAAG,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACxD,4FAA4F;QAC5F,8FAA8F;QAC9F,2EAA2E;QAC3E,IAAI,IAAI,CAAC,oCAAoC,CAAC,kBAAkB,EAAE,OAAO,CAAC,EAAE;YACxE,IAAI,CAAC,gBAAgB,CAAC,kBAAkB,CAAC,CAAC;SAC7C;QAED,IAAI,CAAC,QAAQ,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE;YAC1B,OAAO,sBAAsB,CACzB,IAAI,CAAC,EAAE,EACP,gBAAgB,CAAC,SAAS,EAC1B,QAAQ,EACR,IAAI,CAAC,OAAO,EACZ,0BAA0B,EAC1B,cAAc,EACd,MAAM,EACN,kBAAkB,EAClB,OAAO,CACV,CAAC;QACN,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC;IAEM,KAAK,CAAC,UAAU;QACnB,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE;YAC5B,IAAI,CAAC,OAAO,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE;iBAClC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;gBACX,MAAM,mBAAmB,CAAC,kBAAkB,CACxC,GAAG,EAAE,kDAAkD,EAAE,SAAS,CAAC,CAAC;YAC5E,CAAC,CAAC,CAAC;SACV;QACD,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAEO,KAAK,CAAC,WAAW;QACrB,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,uDAAuD,CAAC,CAAC;QACtF,MAAM,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,aAAa,CAAC,QAAQ,CAAC,aAAa,CAAC,EAClE,KAAK,CAAC,0CAA0C,CAAC,CAAC;QACtD,MAAM,UAAU,GAAG,MAAM,YAAY,CACjC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,aAAa,EACjC,aAAa,CAAC,CAAC;QAEnB,MAAM,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,KAAK,CAAC,kDAAkD,CAAC,CAAC;QAC7F,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE;YAC5B,MAAM,IAAI,KAAK,CAAC,mBAAmB,UAAU,CAAC,IAAI,iBAAiB,CAAC,CAAC;SACxE;QACD,8CAA8C;QAC9C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CACnC,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,EAAE,EACP,IAAI,CAAC,QAAQ,CAAC,KAAK,EACnB,UAAU,CAAC,CAAC;QAEhB,kBAAkB;QAClB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QAEvB,2CAA2C;QAC3C,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,OAAO,EAAE;YAChC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,eAAe,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,qBAAqB,CAAC,CAAC;SAChG;QACD,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAEO,oCAAoC,CACxC,YAA2B,EAC3B,OAAqC;QAErC,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,MAAM,aAAa,GAAuC,YAAoB,CAAC,aAAa,CAAC;QAC7F,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;YACnD,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACxB,IAAI,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE;gBACvC,QAAQ,GAAG,IAAI,CAAC;aACnB;QACL,CAAC,CAAC,CAAC;QACH,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE;YACnD,QAAQ,GAAG,QAAQ,IAAI,IAAI,CAAC,oCAAoC,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;SACpF;QACD,OAAO,QAAQ,CAAC;IACpB,CAAC;IAEO,gBAAgB,CAAC,YAA2B;QAChD,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;QACnE,KAAK,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,cAAc,CAAC,OAAO,EAAE,EAAE;YACvD,MAAM,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC7C,IAAI,SAAS,KAAK,SAAS,EAAE;gBACzB,gEAAgE;gBAChE,OAAO,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;aACvC;SACJ;QACD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE;YACnD,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;SAChC;IACL,CAAC;CACJ;AAED,MAAM,OAAO,mBAAoB,SAAQ,uBAAuB;IAM5D,YACI,EAAU,EACV,QAA+B,EAC/B,IAAY,EACZ,OAA+B,EAC/B,gBAAwC,EACxC,cAAuC,EACvC,MAAwB,EACxB,QAA0D,EAC1D,OAAkC,EAClC,0BAA2F;QAE3F,KAAK,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAClD,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,KAAK,CAAC,sCAAsC,CAAC,CAAC;QACzE,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE;YAC5B,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,iBAAiB,CAAC,CAAC;SAC7D;QACD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAChD,IAAI,CAAC,QAAQ,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE;YAC1B,OAAO,sBAAsB,CACzB,IAAI,CAAC,EAAE,EACP,gBAAgB,CAAC,SAAS,EAC1B,QAAQ,EACR,IAAI,CAAC,OAAO,EACZ,0BAA0B,EAC1B,cAAc,EACd,MAAM,CACT,CAAC;QACN,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC;CACJ","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\n// eslint-disable-next-line import/no-internal-modules\nimport cloneDeep from \"lodash/cloneDeep\";\nimport { ITelemetryLogger } from \"@fluidframework/common-definitions\";\nimport { IDocumentStorageService } from \"@fluidframework/driver-definitions\";\nimport { ISequencedDocumentMessage, ISnapshotTree } from \"@fluidframework/protocol-definitions\";\nimport {\n    IChannel,\n    IFluidDataStoreRuntime,\n    IChannelFactory,\n    IChannelAttributes,\n} from \"@fluidframework/datastore-definitions\";\nimport {\n    IFluidDataStoreContext,\n    IGarbageCollectionData,\n    ISummarizeResult,\n} from \"@fluidframework/runtime-definitions\";\nimport { readAndParse } from \"@fluidframework/driver-utils\";\nimport { DataProcessingError } from \"@fluidframework/container-utils\";\nimport { assert, Lazy } from \"@fluidframework/common-utils\";\nimport { IFluidHandle } from \"@fluidframework/core-interfaces\";\nimport {\n    createServiceEndpoints,\n    IChannelContext,\n    summarizeChannel,\n    summarizeChannelAsync,\n} from \"./channelContext\";\nimport { ChannelDeltaConnection } from \"./channelDeltaConnection\";\nimport { ISharedObjectRegistry } from \"./dataStoreRuntime\";\nimport { ChannelStorageService } from \"./channelStorageService\";\n\n/**\n * Channel context for a locally created channel\n */\nexport abstract class LocalChannelContextBase implements IChannelContext {\n    public channel: IChannel | undefined;\n    private attached = false;\n    protected readonly pending: ISequencedDocumentMessage[] = [];\n    protected factory: IChannelFactory | undefined;\n    constructor(\n        protected readonly id: string,\n        protected readonly registry: ISharedObjectRegistry,\n        protected readonly runtime: IFluidDataStoreRuntime,\n        private readonly servicesGetter: () => Lazy<{\n                readonly deltaConnection: ChannelDeltaConnection,\n                readonly objectStorage: ChannelStorageService,\n            }>,\n    ) {\n    }\n\n    public async getChannel(): Promise<IChannel> {\n        assert(this.channel !== undefined, 0x207 /* \"Channel should be defined\" */);\n        return this.channel;\n    }\n\n    public get isLoaded(): boolean {\n        return this.channel !== undefined;\n    }\n\n    public setConnectionState(connected: boolean, clientId?: string) {\n        // Connection events are ignored if the data store is not yet attached or loaded\n        if (this.attached && this.isLoaded) {\n            this.servicesGetter().value.deltaConnection.setConnectionState(connected);\n        }\n    }\n\n    public processOp(message: ISequencedDocumentMessage, local: boolean, localOpMetadata: unknown): void {\n        assert(this.attached, 0x188 /* \"Local channel must be attached when processing op\" */);\n\n        // A local channel may not be loaded in case where we rehydrate the container from a snapshot because of\n        // delay loading. So after the container is attached and some other client joins which start generating\n        // ops for this channel. So not loaded local channel can still receive ops and we store them to process later.\n        if (this.isLoaded) {\n            this.servicesGetter().value.deltaConnection.process(message, local, localOpMetadata);\n        } else {\n            assert(local === false,\n                0x189 /* \"Should always be remote because a local dds shouldn't generate ops before loading\" */);\n            this.pending.push(message);\n        }\n    }\n\n    public reSubmit(content: any, localOpMetadata: unknown) {\n        assert(this.isLoaded, 0x18a /* \"Channel should be loaded to resubmit ops\" */);\n        assert(this.attached, 0x18b /* \"Local channel must be attached when resubmitting op\" */);\n        this.servicesGetter().value.deltaConnection.reSubmit(content, localOpMetadata);\n    }\n\n    public applyStashedOp() {\n        throw new Error(\"no stashed ops on local channel\");\n    }\n\n    /**\n     * Returns a summary at the current sequence number.\n     * @param fullTree - true to bypass optimizations and force a full summary tree\n     * @param trackState - This tells whether we should track state from this summary.\n     */\n    public async summarize(fullTree: boolean = false, trackState: boolean = false): Promise<ISummarizeResult> {\n        assert(this.isLoaded && this.channel !== undefined, 0x18c /* \"Channel should be loaded to summarize\" */);\n        return summarizeChannelAsync(this.channel, fullTree, trackState);\n    }\n\n    public getAttachSummary(): ISummarizeResult {\n        assert(this.isLoaded && this.channel !== undefined, 0x18d /* \"Channel should be loaded to take snapshot\" */);\n        return summarizeChannel(this.channel, true /* fullTree */, false /* trackState */);\n    }\n\n    public markAttached(): void {\n        if (this.attached) {\n            throw new Error(\"Channel is already attached\");\n        }\n\n        if (this.isLoaded) {\n            assert(!!this.channel, 0x192 /* \"Channel should be there if loaded!!\" */);\n            this.channel.connect(this.servicesGetter().value);\n        }\n        this.attached = true;\n    }\n\n    /**\n     * Returns the data used for garbage collection. This includes a list of GC nodes that represent this context.\n     * Each node has a set of outbound routes to other GC nodes in the document. This should be called only after\n     * the context has loaded.\n     * @param fullGC - true to bypass optimizations and force full generation of GC data.\n     */\n    public async getGCData(fullGC: boolean = false): Promise<IGarbageCollectionData> {\n        assert(this.isLoaded && this.channel !== undefined, 0x193 /* \"Channel should be loaded to run GC\" */);\n        return this.channel.getGCData(fullGC);\n    }\n\n    public updateUsedRoutes(usedRoutes: string[], gcTimestamp?: number) {\n        /**\n         * Currently, DDSs are always considered referenced and are not garbage collected.\n         * Once we have GC at DDS level, this channel context's used routes will be updated as per the passed\n         * value. See - https://github.com/microsoft/FluidFramework/issues/4611\n         */\n    }\n}\n\nexport class RehydratedLocalChannelContext extends LocalChannelContextBase {\n    private readonly services: Lazy<{\n        readonly deltaConnection: ChannelDeltaConnection,\n        readonly objectStorage: ChannelStorageService,\n    }>;\n\n    private readonly dirtyFn: () => void;\n\n    constructor(\n        id: string,\n        registry: ISharedObjectRegistry,\n        runtime: IFluidDataStoreRuntime,\n        dataStoreContext: IFluidDataStoreContext,\n        storageService: IDocumentStorageService,\n        logger: ITelemetryLogger,\n        submitFn: (content: any, localOpMetadata: unknown) => void,\n        dirtyFn: (address: string) => void,\n        addedGCOutboundReferenceFn: (srcHandle: IFluidHandle, outboundHandle: IFluidHandle) => void,\n        private readonly snapshotTree: ISnapshotTree,\n    ) {\n        super(id, registry, runtime, () => this.services);\n        const blobMap: Map<string, ArrayBufferLike> = new Map<string, ArrayBufferLike>();\n        const clonedSnapshotTree = cloneDeep(this.snapshotTree);\n        // 0.47 back-compat Need to sanitize if snapshotTree.blobs still contains blob contents too.\n        // This is for older snapshot which is generated by loader <=0.47 version which still contains\n        // the contents within blobs. After a couple of revisions we can remove it.\n        if (this.isSnapshotInOldFormatAndCollectBlobs(clonedSnapshotTree, blobMap)) {\n            this.sanitizeSnapshot(clonedSnapshotTree);\n        }\n\n        this.services = new Lazy(() => {\n            return createServiceEndpoints(\n                this.id,\n                dataStoreContext.connected,\n                submitFn,\n                this.dirtyFn,\n                addedGCOutboundReferenceFn,\n                storageService,\n                logger,\n                clonedSnapshotTree,\n                blobMap,\n            );\n        });\n        this.dirtyFn = () => { dirtyFn(id); };\n    }\n\n    public async getChannel(): Promise<IChannel> {\n        if (this.channel === undefined) {\n            this.channel = await this.loadChannel()\n                .catch((err) => {\n                    throw DataProcessingError.wrapIfUnrecognized(\n                        err, \"rehydratedLocalChannelContextFailedToLoadChannel\", undefined);\n                });\n        }\n        return this.channel;\n    }\n\n    private async loadChannel(): Promise<IChannel> {\n        assert(!this.isLoaded, 0x18e /* \"Channel must not already be loaded when loading\" */);\n        assert(await this.services.value.objectStorage.contains(\".attributes\"),\n            0x190 /* \".attributes blob should be present\" */);\n        const attributes = await readAndParse<IChannelAttributes>(\n            this.services.value.objectStorage,\n            \".attributes\");\n\n        assert(this.factory === undefined, 0x208 /* \"Factory should be undefined before loading\" */);\n        this.factory = this.registry.get(attributes.type);\n        if (this.factory === undefined) {\n            throw new Error(`Channel Factory ${attributes.type} not registered`);\n        }\n        // Services will be assigned during this load.\n        const channel = await this.factory.load(\n            this.runtime,\n            this.id,\n            this.services.value,\n            attributes);\n\n        // Commit changes.\n        this.channel = channel;\n\n        // Send all pending messages to the channel\n        for (const message of this.pending) {\n            this.services.value.deltaConnection.process(message, false, undefined /* localOpMetadata */);\n        }\n        return this.channel;\n    }\n\n    private isSnapshotInOldFormatAndCollectBlobs(\n        snapshotTree: ISnapshotTree,\n        blobMap: Map<string, ArrayBufferLike>,\n    ): boolean {\n        let sanitize = false;\n        const blobsContents: {[path: string]: ArrayBufferLike} = (snapshotTree as any).blobsContents;\n        Object.entries(blobsContents).forEach(([key, value]) => {\n            blobMap.set(key, value);\n            if (snapshotTree.blobs[key] !== undefined) {\n                sanitize = true;\n            }\n        });\n        for (const value of Object.values(snapshotTree.trees)) {\n            sanitize = sanitize || this.isSnapshotInOldFormatAndCollectBlobs(value, blobMap);\n        }\n        return sanitize;\n    }\n\n    private sanitizeSnapshot(snapshotTree: ISnapshotTree) {\n        const blobMapInitial = new Map(Object.entries(snapshotTree.blobs));\n        for (const [blobName, blobId] of blobMapInitial.entries()) {\n            const blobValue = blobMapInitial.get(blobId);\n            if (blobValue === undefined) {\n                // eslint-disable-next-line @typescript-eslint/no-dynamic-delete\n                delete snapshotTree.blobs[blobName];\n            }\n        }\n        for (const value of Object.values(snapshotTree.trees)) {\n            this.sanitizeSnapshot(value);\n        }\n    }\n}\n\nexport class LocalChannelContext extends LocalChannelContextBase {\n    private readonly services: Lazy<{\n        readonly deltaConnection: ChannelDeltaConnection,\n        readonly objectStorage: ChannelStorageService,\n    }>;\n    private readonly dirtyFn: () => void;\n    constructor(\n        id: string,\n        registry: ISharedObjectRegistry,\n        type: string,\n        runtime: IFluidDataStoreRuntime,\n        dataStoreContext: IFluidDataStoreContext,\n        storageService: IDocumentStorageService,\n        logger: ITelemetryLogger,\n        submitFn: (content: any, localOpMetadata: unknown) => void,\n        dirtyFn: (address: string) => void,\n        addedGCOutboundReferenceFn: (srcHandle: IFluidHandle, outboundHandle: IFluidHandle) => void,\n    ) {\n        super(id, registry, runtime, () => this.services);\n        assert(type !== undefined, 0x209 /* \"Factory Type should be defined\" */);\n        this.factory = registry.get(type);\n        if (this.factory === undefined) {\n            throw new Error(`Channel Factory ${type} not registered`);\n        }\n        this.channel = this.factory.create(runtime, id);\n        this.services = new Lazy(() => {\n            return createServiceEndpoints(\n                this.id,\n                dataStoreContext.connected,\n                submitFn,\n                this.dirtyFn,\n                addedGCOutboundReferenceFn,\n                storageService,\n                logger,\n            );\n        });\n        this.dirtyFn = () => { dirtyFn(id); };\n    }\n}\n"]}
+{"version":3,"file":"localChannelContext.js","sourceRoot":"","sources":["../src/localChannelContext.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\n// eslint-disable-next-line import/no-internal-modules\nimport cloneDeep from \"lodash/cloneDeep\";\nimport { ITelemetryLogger } from \"@fluidframework/common-definitions\";\nimport { IDocumentStorageService } from \"@fluidframework/driver-definitions\";\nimport { ISequencedDocumentMessage, ISnapshotTree } from \"@fluidframework/protocol-definitions\";\nimport {\n    IChannel,\n    IFluidDataStoreRuntime,\n    IChannelFactory,\n    IChannelAttributes,\n} from \"@fluidframework/datastore-definitions\";\nimport {\n    IFluidDataStoreContext,\n    IGarbageCollectionData,\n    ISummarizeResult,\n} from \"@fluidframework/runtime-definitions\";\nimport { readAndParse } from \"@fluidframework/driver-utils\";\nimport { DataProcessingError } from \"@fluidframework/container-utils\";\nimport { assert, Lazy } from \"@fluidframework/common-utils\";\nimport { IFluidHandle } from \"@fluidframework/core-interfaces\";\nimport {\n    createServiceEndpoints,\n    IChannelContext,\n    summarizeChannel,\n    summarizeChannelAsync,\n} from \"./channelContext\";\nimport { ChannelDeltaConnection } from \"./channelDeltaConnection\";\nimport { ISharedObjectRegistry } from \"./dataStoreRuntime\";\nimport { ChannelStorageService } from \"./channelStorageService\";\n\n/**\n * Channel context for a locally created channel\n */\nexport abstract class LocalChannelContextBase implements IChannelContext {\n    public channel: IChannel | undefined;\n    private globallyVisible = false;\n    protected readonly pending: ISequencedDocumentMessage[] = [];\n    protected factory: IChannelFactory | undefined;\n    constructor(\n        protected readonly id: string,\n        protected readonly registry: ISharedObjectRegistry,\n        protected readonly runtime: IFluidDataStoreRuntime,\n        private readonly servicesGetter: () => Lazy<{\n                readonly deltaConnection: ChannelDeltaConnection,\n                readonly objectStorage: ChannelStorageService,\n            }>,\n    ) {\n    }\n\n    public async getChannel(): Promise<IChannel> {\n        assert(this.channel !== undefined, 0x207 /* \"Channel should be defined\" */);\n        return this.channel;\n    }\n\n    public get isLoaded(): boolean {\n        return this.channel !== undefined;\n    }\n\n    public setConnectionState(connected: boolean, clientId?: string) {\n        // Connection events are ignored if the data store is not yet globallyVisible or loaded\n        if (this.globallyVisible && this.isLoaded) {\n            this.servicesGetter().value.deltaConnection.setConnectionState(connected);\n        }\n    }\n\n    public processOp(message: ISequencedDocumentMessage, local: boolean, localOpMetadata: unknown): void {\n        assert(this.globallyVisible, 0x2d3 /* \"Local channel must be globally visible when processing op\" */);\n\n        // A local channel may not be loaded in case where we rehydrate the container from a snapshot because of\n        // delay loading. So after the container is attached and some other client joins which start generating\n        // ops for this channel. So not loaded local channel can still receive ops and we store them to process later.\n        if (this.isLoaded) {\n            this.servicesGetter().value.deltaConnection.process(message, local, localOpMetadata);\n        } else {\n            assert(local === false,\n                0x189 /* \"Should always be remote because a local dds shouldn't generate ops before loading\" */);\n            this.pending.push(message);\n        }\n    }\n\n    public reSubmit(content: any, localOpMetadata: unknown) {\n        assert(this.isLoaded, 0x18a /* \"Channel should be loaded to resubmit ops\" */);\n        assert(this.globallyVisible, 0x2d4 /* \"Local channel must be globally visible when resubmitting op\" */);\n        this.servicesGetter().value.deltaConnection.reSubmit(content, localOpMetadata);\n    }\n\n    public applyStashedOp() {\n        throw new Error(\"no stashed ops on local channel\");\n    }\n\n    /**\n     * Returns a summary at the current sequence number.\n     * @param fullTree - true to bypass optimizations and force a full summary tree\n     * @param trackState - This tells whether we should track state from this summary.\n     */\n    public async summarize(fullTree: boolean = false, trackState: boolean = false): Promise<ISummarizeResult> {\n        assert(this.isLoaded && this.channel !== undefined, 0x18c /* \"Channel should be loaded to summarize\" */);\n        return summarizeChannelAsync(this.channel, fullTree, trackState);\n    }\n\n    public getAttachSummary(): ISummarizeResult {\n        assert(this.isLoaded && this.channel !== undefined, 0x18d /* \"Channel should be loaded to take snapshot\" */);\n        return summarizeChannel(this.channel, true /* fullTree */, false /* trackState */);\n    }\n\n    public makeVisible(): void {\n        if (this.globallyVisible) {\n            throw new Error(\"Channel is already globally visible\");\n        }\n\n        if (this.isLoaded) {\n            assert(!!this.channel, 0x192 /* \"Channel should be there if loaded!!\" */);\n            this.channel.connect(this.servicesGetter().value);\n        }\n        this.globallyVisible = true;\n    }\n\n    /**\n     * Returns the data used for garbage collection. This includes a list of GC nodes that represent this context.\n     * Each node has a set of outbound routes to other GC nodes in the document. This should be called only after\n     * the context has loaded.\n     * @param fullGC - true to bypass optimizations and force full generation of GC data.\n     */\n    public async getGCData(fullGC: boolean = false): Promise<IGarbageCollectionData> {\n        assert(this.isLoaded && this.channel !== undefined, 0x193 /* \"Channel should be loaded to run GC\" */);\n        return this.channel.getGCData(fullGC);\n    }\n\n    public updateUsedRoutes(usedRoutes: string[], gcTimestamp?: number) {\n        /**\n         * Currently, DDSs are always considered referenced and are not garbage collected.\n         * Once we have GC at DDS level, this channel context's used routes will be updated as per the passed\n         * value. See - https://github.com/microsoft/FluidFramework/issues/4611\n         */\n    }\n}\n\nexport class RehydratedLocalChannelContext extends LocalChannelContextBase {\n    private readonly services: Lazy<{\n        readonly deltaConnection: ChannelDeltaConnection,\n        readonly objectStorage: ChannelStorageService,\n    }>;\n\n    private readonly dirtyFn: () => void;\n\n    constructor(\n        id: string,\n        registry: ISharedObjectRegistry,\n        runtime: IFluidDataStoreRuntime,\n        dataStoreContext: IFluidDataStoreContext,\n        storageService: IDocumentStorageService,\n        logger: ITelemetryLogger,\n        submitFn: (content: any, localOpMetadata: unknown) => void,\n        dirtyFn: (address: string) => void,\n        addedGCOutboundReferenceFn: (srcHandle: IFluidHandle, outboundHandle: IFluidHandle) => void,\n        private readonly snapshotTree: ISnapshotTree,\n    ) {\n        super(id, registry, runtime, () => this.services);\n        const blobMap: Map<string, ArrayBufferLike> = new Map<string, ArrayBufferLike>();\n        const clonedSnapshotTree = cloneDeep(this.snapshotTree);\n        // 0.47 back-compat Need to sanitize if snapshotTree.blobs still contains blob contents too.\n        // This is for older snapshot which is generated by loader <=0.47 version which still contains\n        // the contents within blobs. After a couple of revisions we can remove it.\n        if (this.isSnapshotInOldFormatAndCollectBlobs(clonedSnapshotTree, blobMap)) {\n            this.sanitizeSnapshot(clonedSnapshotTree);\n        }\n\n        this.services = new Lazy(() => {\n            return createServiceEndpoints(\n                this.id,\n                dataStoreContext.connected,\n                submitFn,\n                this.dirtyFn,\n                addedGCOutboundReferenceFn,\n                storageService,\n                logger,\n                clonedSnapshotTree,\n                blobMap,\n            );\n        });\n        this.dirtyFn = () => { dirtyFn(id); };\n    }\n\n    public async getChannel(): Promise<IChannel> {\n        if (this.channel === undefined) {\n            this.channel = await this.loadChannel()\n                .catch((err) => {\n                    throw DataProcessingError.wrapIfUnrecognized(\n                        err, \"rehydratedLocalChannelContextFailedToLoadChannel\", undefined);\n                });\n        }\n        return this.channel;\n    }\n\n    private async loadChannel(): Promise<IChannel> {\n        assert(!this.isLoaded, 0x18e /* \"Channel must not already be loaded when loading\" */);\n        assert(await this.services.value.objectStorage.contains(\".attributes\"),\n            0x190 /* \".attributes blob should be present\" */);\n        const attributes = await readAndParse<IChannelAttributes>(\n            this.services.value.objectStorage,\n            \".attributes\");\n\n        assert(this.factory === undefined, 0x208 /* \"Factory should be undefined before loading\" */);\n        this.factory = this.registry.get(attributes.type);\n        if (this.factory === undefined) {\n            throw new Error(`Channel Factory ${attributes.type} not registered`);\n        }\n        // Services will be assigned during this load.\n        const channel = await this.factory.load(\n            this.runtime,\n            this.id,\n            this.services.value,\n            attributes);\n\n        // Commit changes.\n        this.channel = channel;\n\n        // Send all pending messages to the channel\n        for (const message of this.pending) {\n            this.services.value.deltaConnection.process(message, false, undefined /* localOpMetadata */);\n        }\n        return this.channel;\n    }\n\n    private isSnapshotInOldFormatAndCollectBlobs(\n        snapshotTree: ISnapshotTree,\n        blobMap: Map<string, ArrayBufferLike>,\n    ): boolean {\n        let sanitize = false;\n        const blobsContents: {[path: string]: ArrayBufferLike} = (snapshotTree as any).blobsContents;\n        Object.entries(blobsContents).forEach(([key, value]) => {\n            blobMap.set(key, value);\n            if (snapshotTree.blobs[key] !== undefined) {\n                sanitize = true;\n            }\n        });\n        for (const value of Object.values(snapshotTree.trees)) {\n            sanitize = sanitize || this.isSnapshotInOldFormatAndCollectBlobs(value, blobMap);\n        }\n        return sanitize;\n    }\n\n    private sanitizeSnapshot(snapshotTree: ISnapshotTree) {\n        const blobMapInitial = new Map(Object.entries(snapshotTree.blobs));\n        for (const [blobName, blobId] of blobMapInitial.entries()) {\n            const blobValue = blobMapInitial.get(blobId);\n            if (blobValue === undefined) {\n                // eslint-disable-next-line @typescript-eslint/no-dynamic-delete\n                delete snapshotTree.blobs[blobName];\n            }\n        }\n        for (const value of Object.values(snapshotTree.trees)) {\n            this.sanitizeSnapshot(value);\n        }\n    }\n}\n\nexport class LocalChannelContext extends LocalChannelContextBase {\n    private readonly services: Lazy<{\n        readonly deltaConnection: ChannelDeltaConnection,\n        readonly objectStorage: ChannelStorageService,\n    }>;\n    private readonly dirtyFn: () => void;\n    constructor(\n        id: string,\n        registry: ISharedObjectRegistry,\n        type: string,\n        runtime: IFluidDataStoreRuntime,\n        dataStoreContext: IFluidDataStoreContext,\n        storageService: IDocumentStorageService,\n        logger: ITelemetryLogger,\n        submitFn: (content: any, localOpMetadata: unknown) => void,\n        dirtyFn: (address: string) => void,\n        addedGCOutboundReferenceFn: (srcHandle: IFluidHandle, outboundHandle: IFluidHandle) => void,\n    ) {\n        super(id, registry, runtime, () => this.services);\n        assert(type !== undefined, 0x209 /* \"Factory Type should be defined\" */);\n        this.factory = registry.get(type);\n        if (this.factory === undefined) {\n            throw new Error(`Channel Factory ${type} not registered`);\n        }\n        this.channel = this.factory.create(runtime, id);\n        this.services = new Lazy(() => {\n            return createServiceEndpoints(\n                this.id,\n                dataStoreContext.connected,\n                submitFn,\n                this.dirtyFn,\n                addedGCOutboundReferenceFn,\n                storageService,\n                logger,\n            );\n        });\n        this.dirtyFn = () => { dirtyFn(id); };\n    }\n}\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 = "0.58.3000-61081";
+export declare const pkgVersion = "0.59.1000-61898";
 //# 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 = "0.58.3000-61081";
+export const pkgVersion = "0.59.1000-61898";
 //# 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,iBAAiB,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 = \"0.58.3000-61081\";\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,iBAAiB,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 = \"0.59.1000-61898\";\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fluidframework/datastore",
-  "version": "0.58.3000-61081",
+  "version": "0.59.1000-61898",
   "description": "Fluid data store implementation",
   "homepage": "https://fluidframework.com",
   "repository": {
@@ -62,27 +62,27 @@
   "dependencies": {
     "@fluidframework/common-definitions": "^0.20.1",
     "@fluidframework/common-utils": "^0.32.1",
-    "@fluidframework/container-definitions": "^0.47.1000",
-    "@fluidframework/container-utils": "0.58.3000-61081",
-    "@fluidframework/core-interfaces": "^0.42.0",
-    "@fluidframework/datastore-definitions": "0.58.3000-61081",
-    "@fluidframework/driver-definitions": "^0.45.2000-0",
-    "@fluidframework/driver-utils": "0.58.3000-61081",
-    "@fluidframework/garbage-collector": "0.58.3000-61081",
-    "@fluidframework/protocol-base": "^0.1035.1000",
-    "@fluidframework/protocol-definitions": "^0.1027.1000",
-    "@fluidframework/runtime-definitions": "0.58.3000-61081",
-    "@fluidframework/runtime-utils": "0.58.3000-61081",
-    "@fluidframework/telemetry-utils": "0.58.3000-61081",
+    "@fluidframework/container-definitions": "^0.48.1000-0",
+    "@fluidframework/container-utils": "0.59.1000-61898",
+    "@fluidframework/core-interfaces": "^0.43.1000-0",
+    "@fluidframework/datastore-definitions": "0.59.1000-61898",
+    "@fluidframework/driver-definitions": "^0.46.1000-0",
+    "@fluidframework/driver-utils": "0.59.1000-61898",
+    "@fluidframework/garbage-collector": "0.59.1000-61898",
+    "@fluidframework/protocol-base": "^0.1036.1000-0",
+    "@fluidframework/protocol-definitions": "^0.1028.1000-0",
+    "@fluidframework/runtime-definitions": "0.59.1000-61898",
+    "@fluidframework/runtime-utils": "0.59.1000-61898",
+    "@fluidframework/telemetry-utils": "0.59.1000-61898",
     "lodash": "^4.17.21",
     "uuid": "^8.3.1"
   },
   "devDependencies": {
     "@fluidframework/build-common": "^0.23.0",
-    "@fluidframework/datastore-previous": "npm:@fluidframework/datastore@0.58.2000",
-    "@fluidframework/eslint-config-fluid": "^0.27.2000-59622",
-    "@fluidframework/mocha-test-setup": "0.58.3000-61081",
-    "@fluidframework/test-runtime-utils": "0.58.3000-61081",
+    "@fluidframework/datastore-previous": "npm:@fluidframework/datastore@^0.58.0",
+    "@fluidframework/eslint-config-fluid": "^0.28.1000-61189",
+    "@fluidframework/mocha-test-setup": "0.59.1000-61898",
+    "@fluidframework/test-runtime-utils": "0.59.1000-61898",
     "@microsoft/api-extractor": "^7.16.1",
     "@rushstack/eslint-config": "^2.5.1",
     "@types/mocha": "^8.2.2",
@@ -107,7 +107,13 @@
     "typescript-formatter": "7.1.0"
   },
   "typeValidation": {
-    "version": "0.58.3000",
-    "broken": {}
+    "version": "0.59.1000",
+    "broken": {
+      "0.58.2002": {
+        "ClassDeclaration_FluidDataStoreRuntime": {
+          "forwardCompat": false
+        }
+      }
+    }
   }
 }

package/src/dataStoreRuntime.ts

@@ -49,6 +49,7 @@ import {
     IGarbageCollectionDetailsBase,
     IInboundSignalMessage,
     ISummaryTreeWithStats,
+    VisibilityState,
 } from "@fluidframework/runtime-definitions";
 import {
     convertSnapshotTreeToSummaryTree,
@@ -152,15 +153,14 @@ IFluidDataStoreChannel, IFluidDataStoreRuntime, IFluidHandleContext {
     private readonly pendingAttach = new Map<string, IAttachMessage>();
 
     private bindState: BindState;
-    // For new data stores, this is used to break the recursion while attaching the graph. The graph must be attached
-    // before the data store can move to Attached state (see _attachState) and become live.
-    // For existing data stores, the graph is always attached.
-    private graphAttachState: AttachState = AttachState.Detached;
     private readonly deferredAttached = new Deferred<void>();
     private readonly localChannelContextQueue = new Map<string, LocalChannelContextBase>();
     private readonly notBoundedChannelContextSet = new Set<string>();
-    private boundhandles: Set<IFluidHandle> | undefined;
     private _attachState: AttachState;
+    public visibilityState: VisibilityState;
+    // A list of handles that are bound when the data store is not visible. We have to make them visible when the data
+    // store becomes visible.
+    private readonly pendingHandlesToMakeVisible: Set<IFluidHandle> = new Set();
 
     public readonly id: string;
     public readonly options: ILoaderOptions;
@@ -224,11 +224,11 @@ IFluidDataStoreChannel, IFluidDataStoreRuntime, IFluidHandleContext {
                             this.addedGCOutboundReference(srcHandle, outboundHandle),
                         tree.trees[path]);
                     // This is the case of rehydrating a detached container from snapshot. Now due to delay loading of
-                    // data store, if the data store is loaded after the container is attached, then we missed marking
-                    // the channel as attached. So mark it now. Otherwise add it to local channel context queue, so
-                    // that it can be mark attached later with the data store.
+                    // data store, if the data store is loaded after the container is attached, then we missed making
+                    // the channel visible. So do it now. Otherwise, add it to local channel context queue, so
+                    // that it can be make it visible later with the data store.
                     if (dataStoreContext.attachState !== AttachState.Detached) {
-                        (channelContext as LocalChannelContextBase).markAttached();
+                        (channelContext as LocalChannelContextBase).makeVisible();
                     } else {
                         this.localChannelContextQueue.set(path, channelContext as LocalChannelContextBase);
                     }
@@ -260,10 +260,25 @@ IFluidDataStoreChannel, IFluidDataStoreRuntime, IFluidHandleContext {
         }
 
         this.attachListener();
-        // If exists on storage or loaded from a snapshot, it should already be binded.
+        // If exists on storage or loaded from a snapshot, it should already be bound.
         this.bindState = existing ? BindState.Bound : BindState.NotBound;
         this._attachState = dataStoreContext.attachState;
 
+        /**
+         * If existing flag is false, this is a new data store and is not visible. The existing flag can be true in two
+         * conditions:
+         * 1. It's a local data store that is created when a detached container is rehydrated. In this case, the data
+         *    store is locally visible because the snapshot it is loaded from contains locally visible data stores only.
+         * 2. It's a remote data store that is created when an attached container is loaded is loaded from snapshot or
+         *    when an attach op comes in. In both these cases, the data store is already globally visible.
+         */
+        if (existing) {
+            this.visibilityState = dataStoreContext.attachState === AttachState.Detached
+                ? VisibilityState.LocallyVisible : VisibilityState.GloballyVisible;
+        } else {
+            this.visibilityState = VisibilityState.NotVisible;
+        }
+
         // If it's existing we know it has been attached.
         if (existing) {
             this.deferredAttached.resolve();
@@ -377,38 +392,50 @@ IFluidDataStoreChannel, IFluidDataStoreRuntime, IFluidHandleContext {
         if (this.isAttached) {
             this.attachChannel(channel);
             return;
-        } else {
-            this.bind(channel.handle);
+        }
 
-            // If our data store is local then add the channel to the queue
-            if (!this.localChannelContextQueue.has(channel.id)) {
-                this.localChannelContextQueue.set(channel.id, this.contexts.get(channel.id) as LocalChannelContextBase);
-            }
+        /**
+         * If this channel is already waiting to be made visible, do nothing. This can happen during attachGraph() when
+         * a channel's graph is attached. It calls bindToContext on the shared object which will end up back here.
+         */
+        if (this.pendingHandlesToMakeVisible.has(channel.handle)) {
+            return;
+        }
+
+        this.bind(channel.handle);
+
+        // If our data store is local then add the channel to the queue
+        if (!this.localChannelContextQueue.has(channel.id)) {
+            this.localChannelContextQueue.set(channel.id, this.contexts.get(channel.id) as LocalChannelContextBase);
         }
     }
 
-    public attachGraph() {
-        if (this.graphAttachState !== AttachState.Detached) {
+    /**
+     * This function is called when a data store becomes root. It does the following:
+     * 1. Marks the data store locally visible in the container.
+     * 2. Attaches the graph of all the handles bound to it.
+     * 3. Calls into the data store context to mark it visible in the container too. If the container is globally
+     *    visible, it will mark us globally visible. Otherwise, it will mark us globally visible when it becomes
+     *    globally visible.
+     */
+    public makeVisibleAndAttachGraph() {
+        if (this.visibilityState !== VisibilityState.NotVisible) {
             return;
         }
-        this.graphAttachState = AttachState.Attaching;
-        if (this.boundhandles !== undefined) {
-            this.boundhandles.forEach((handle) => {
-                handle.attachGraph();
-            });
-            this.boundhandles = undefined;
-        }
+        this.visibilityState = VisibilityState.LocallyVisible;
 
-        // Flush the queue to set any pre-existing channels to local
-        this.localChannelContextQueue.forEach((channel) => {
-            // When we are attaching the data store we don't need to send attach for the registered services.
-            // This is because they will be captured as part of the Attach data store snapshot
-            channel.markAttached();
+        this.pendingHandlesToMakeVisible.forEach((handle) => {
+            handle.attachGraph();
         });
-
-        this.localChannelContextQueue.clear();
+        this.pendingHandlesToMakeVisible.clear();
         this.bindToContext();
-        this.graphAttachState = AttachState.Attached;
+    }
+
+    /**
+     * This function is called when a handle to this data store is added to a visible DDS.
+     */
+    public attachGraph() {
+        this.makeVisibleAndAttachGraph();
     }
 
     /**
@@ -417,7 +444,7 @@ IFluidDataStoreChannel, IFluidDataStoreRuntime, IFluidHandleContext {
      * 1. Sending an Attach op that includes all existing state
      * 2. Attaching the graph if the data store becomes attached.
      */
-     public bindToContext() {
+    public bindToContext() {
         if (this.bindState !== BindState.NotBound) {
             return;
         }
@@ -427,17 +454,12 @@ IFluidDataStoreChannel, IFluidDataStoreRuntime, IFluidHandleContext {
     }
 
     public bind(handle: IFluidHandle): void {
-        // If the data store is already attached or its graph is already in attaching or attached state,
-        // then attach the incoming handle too.
-        if (this.isAttached || this.graphAttachState !== AttachState.Detached) {
+        // If visible, attach the incoming handle's graph. Else, this will be done when we become visible.
+        if (this.visibilityState !== VisibilityState.NotVisible) {
             handle.attachGraph();
             return;
         }
-        if (this.boundhandles === undefined) {
-            this.boundhandles = new Set<IFluidHandle>();
-        }
-
-        this.boundhandles.add(handle);
+        this.pendingHandlesToMakeVisible.add(handle);
     }
 
     public setConnectionState(connected: boolean, clientId?: string) {
@@ -587,8 +609,8 @@ IFluidDataStoreChannel, IFluidDataStoreRuntime, IFluidHandleContext {
      * including any of its child channel contexts. Each node has a set of outbound routes to other GC nodes in the
      * document. It does the following:
      * 1. Calls into each child context to get its GC data.
-     * 2. Prefixs the child context's id to the GC nodes in the child's GC data. This makes sure that the node can be
-     *    idenfied as belonging to the child.
+     * 2. Prefixes the child context's id to the GC nodes in the child's GC data. This makes sure that the node can be
+     *    identified as belonging to the child.
      * 3. Adds a GC node for this channel to the nodes received from the children. All these nodes together represent
      *    the GC data of this channel.
      * @param fullGC - true to bypass optimizations and force full generation of GC data.
@@ -695,8 +717,26 @@ IFluidDataStoreChannel, IFluidDataStoreRuntime, IFluidHandleContext {
     }
 
     public getAttachSummary(): ISummaryTreeWithStats {
+        /**
+         * back-compat 0.59.1000 - getAttachSummary() is called when making a data store globally visible (previously
+         * attaching state). Ideally, attachGraph() should have already be called making it locally visible. However,
+         * before visibility state was added, this may not have been the case and getAttachSummary() could be called:
+         * 1) Before attaching the data store - When a detached container is attached.
+         * 2) After attaching the data store - When a data store is created and bound in an attached container.
+         *
+         * The basic idea is that all local object should become locally visible before they are globally visible.
+         */
         this.attachGraph();
 
+        /**
+         * This assert cannot be added now due to back-compat. To be uncommented when the following issue is fixed -
+         * https://github.com/microsoft/FluidFramework/issues/9688.
+         *
+         * assert(this.visibilityState === VisibilityState.LocallyVisible,
+         *   "The data store should be locally visible when generating attach summary",
+         * );
+         */
+
         const summaryBuilder = new SummaryTreeBuilder();
 
         // Craft the .attributes file for each shared object
@@ -756,24 +796,23 @@ IFluidDataStoreChannel, IFluidDataStoreRuntime, IFluidHandleContext {
         channel.handle.attachGraph();
 
         assert(this.isAttached, 0x182 /* "Data store should be attached to attach the channel." */);
-        // Get the object snapshot only if the data store is Bound and its graph is attached too,
-        // because if the graph is attaching, then it would get included in the data store snapshot.
-        if (this.bindState === BindState.Bound && this.graphAttachState === AttachState.Attached) {
-            const summarizeResult = summarizeChannel(channel, true /* fullTree */, false /* trackState */);
-            // Attach message needs the summary in ITree format. Convert the ISummaryTree into an ITree.
-            const snapshot = convertSummaryTreeToITree(summarizeResult.summary);
-
-            const message: IAttachMessage = {
-                id: channel.id,
-                snapshot,
-                type: channel.attributes.type,
-            };
-            this.pendingAttach.set(channel.id, message);
-            this.submit(DataStoreMessageType.Attach, message);
-        }
+        assert(this.visibilityState === VisibilityState.GloballyVisible,
+            0x2d0 /* "Data store should be globally visible to attach channels." */);
+
+        const summarizeResult = summarizeChannel(channel, true /* fullTree */, false /* trackState */);
+        // Attach message needs the summary in ITree format. Convert the ISummaryTree into an ITree.
+        const snapshot = convertSummaryTreeToITree(summarizeResult.summary);
+
+        const message: IAttachMessage = {
+            id: channel.id,
+            snapshot,
+            type: channel.attributes.type,
+        };
+        this.pendingAttach.set(channel.id, message);
+        this.submit(DataStoreMessageType.Attach, message);
 
         const context = this.contexts.get(channel.id) as LocalChannelContextBase;
-        context.markAttached();
+        context.makeVisible();
     }
 
     private submitChannelOp(address: string, contents: any, localOpMetadata: unknown) {
@@ -851,16 +890,36 @@ IFluidDataStoreChannel, IFluidDataStoreRuntime, IFluidHandleContext {
     private attachListener() {
         this.setMaxListeners(Number.MAX_SAFE_INTEGER);
         this.dataStoreContext.once("attaching", () => {
-            assert(this.bindState !== BindState.NotBound,
-                0x186 /* "Data store attaching should not occur if it is not bound" */);
+            /**
+             * back-compat 0.59.1000 - Ideally, attachGraph() should have already been called making the data store
+             * locally visible. However, before visibility state was added, this may not have been the case and data
+             * store can move to "attaching" state in 2 scenarios:
+             * 1) Before attachGraph() is called - When a data store is created and bound in an attached container.
+             * 2) After attachGraph() is called - When a detached container is attached.
+             *
+             * The basic idea is that all local object should become locally visible before they are globally visible.
+             */
+            this.attachGraph();
+
             this._attachState = AttachState.Attaching;
+
+            assert(this.visibilityState === VisibilityState.LocallyVisible,
+                0x2d1 /* "Data store should be locally visible before it can become globally visible." */);
+
+            // Mark the data store globally visible and make its child channels visible as well.
+            this.visibilityState = VisibilityState.GloballyVisible;
+            this.localChannelContextQueue.forEach((channel) => {
+                channel.makeVisible();
+            });
+            this.localChannelContextQueue.clear();
+
             // This promise resolution will be moved to attached event once we fix the scheduler.
             this.deferredAttached.resolve();
             this.emit("attaching");
         });
         this.dataStoreContext.once("attached", () => {
-            assert(this.bindState === BindState.Bound,
-                0x187 /* "Data store should only be attached after it is bound" */);
+            assert(this.visibilityState === VisibilityState.GloballyVisible,
+                0x2d2 /* "Data store should be globally visible when its attached." */);
             this._attachState = AttachState.Attached;
             this.emit("attached");
         });

package/src/fluidHandle.ts

@@ -4,18 +4,14 @@
  */
 
 import {
-    IFluidObject,
     IFluidHandle,
     IFluidHandleContext,
     FluidObject,
 } from "@fluidframework/core-interfaces";
-import { AttachState } from "@fluidframework/container-definitions";
 import { generateHandleContextPath } from "@fluidframework/runtime-utils";
 
-export class FluidObjectHandle<T extends FluidObject = IFluidObject> implements IFluidHandle {
-    // This is used to break the recursion while attaching the graph. Also tells the attach state of the graph.
-    private graphAttachState: AttachState = AttachState.Detached;
-    private bound: Set<IFluidHandle> | undefined;
+export class FluidObjectHandle<T extends FluidObject = FluidObject> implements IFluidHandle {
+    private readonly pendingHandlesToMakeVisible: Set<IFluidHandle> = new Set();
     public readonly absolutePath: string;
 
     public get IFluidHandle(): IFluidHandle { return this; }
@@ -24,6 +20,26 @@ export class FluidObjectHandle<T extends FluidObject = IFluidObject> implements
         return this.routeContext.isAttached;
     }
 
+    /**
+     * Tells whether the object of this handle is visible in the container locally or globally.
+     */
+    private get visible(): boolean {
+        /**
+         * If the object of this handle is attached, it is visible in the container. Ideally, checking local visibility
+         * should be enough for a handle. However, there are scenarios where the object becomes locally visible but the
+         * handle does not know this - This will happen is attachGraph is never called on the handle. Couple of examples
+         * where this can happen:
+         * 1. Handles to DDS other than the default handle won't know if the DDS becomes visible after the handle was
+         *    created.
+         * 2. Handles to root data stores will never know that it was visible because the handle will not be stores in
+         *    another DDS and so, attachGraph will never be called on it.
+         */
+        return this.isAttached || this.locallyVisible;
+    }
+
+    // Tracks whether this handle is locally visible in the container.
+    private locallyVisible: boolean = false;
+
     /**
      * Creates a new FluidObjectHandle.
      * @param value - The FluidObject object this handle is for.
@@ -43,33 +59,24 @@ export class FluidObjectHandle<T extends FluidObject = IFluidObject> implements
     }
 
     public attachGraph(): void {
-        // If this handle is already in attaching state in the graph or attached, no need to attach again.
-        if (this.graphAttachState !== AttachState.Detached) {
+        if (this.visible) {
             return;
         }
-        this.graphAttachState = AttachState.Attaching;
-        if (this.bound !== undefined) {
-            for (const handle of this.bound) {
-                handle.attachGraph();
-            }
 
-            this.bound = undefined;
-        }
+        this.locallyVisible = true;
+        this.pendingHandlesToMakeVisible.forEach((handle) => {
+            handle.attachGraph();
+        });
+        this.pendingHandlesToMakeVisible.clear();
         this.routeContext.attachGraph();
-        this.graphAttachState = AttachState.Attached;
     }
 
     public bind(handle: IFluidHandle) {
-        // If the dds is already attached or its graph is already in attaching or attached state,
-        // then attach the incoming handle too.
-        if (this.isAttached || this.graphAttachState !== AttachState.Detached) {
+        // If this handle is visible, attach the graph of the incoming handle as well.
+        if (this.visible) {
             handle.attachGraph();
             return;
         }
-        if (this.bound === undefined) {
-            this.bound = new Set<IFluidHandle>();
-        }
-
-        this.bound.add(handle);
+        this.pendingHandlesToMakeVisible.add(handle);
     }
 }

package/src/localChannelContext.ts

@@ -38,7 +38,7 @@ import { ChannelStorageService } from "./channelStorageService";
  */
 export abstract class LocalChannelContextBase implements IChannelContext {
     public channel: IChannel | undefined;
-    private attached = false;
+    private globallyVisible = false;
     protected readonly pending: ISequencedDocumentMessage[] = [];
     protected factory: IChannelFactory | undefined;
     constructor(
@@ -62,14 +62,14 @@ export abstract class LocalChannelContextBase implements IChannelContext {
     }
 
     public setConnectionState(connected: boolean, clientId?: string) {
-        // Connection events are ignored if the data store is not yet attached or loaded
-        if (this.attached && this.isLoaded) {
+        // Connection events are ignored if the data store is not yet globallyVisible or loaded
+        if (this.globallyVisible && this.isLoaded) {
             this.servicesGetter().value.deltaConnection.setConnectionState(connected);
         }
     }
 
     public processOp(message: ISequencedDocumentMessage, local: boolean, localOpMetadata: unknown): void {
-        assert(this.attached, 0x188 /* "Local channel must be attached when processing op" */);
+        assert(this.globallyVisible, 0x2d3 /* "Local channel must be globally visible when processing op" */);
 
         // A local channel may not be loaded in case where we rehydrate the container from a snapshot because of
         // delay loading. So after the container is attached and some other client joins which start generating
@@ -85,7 +85,7 @@ export abstract class LocalChannelContextBase implements IChannelContext {
 
     public reSubmit(content: any, localOpMetadata: unknown) {
         assert(this.isLoaded, 0x18a /* "Channel should be loaded to resubmit ops" */);
-        assert(this.attached, 0x18b /* "Local channel must be attached when resubmitting op" */);
+        assert(this.globallyVisible, 0x2d4 /* "Local channel must be globally visible when resubmitting op" */);
         this.servicesGetter().value.deltaConnection.reSubmit(content, localOpMetadata);
     }
 
@@ -108,16 +108,16 @@ export abstract class LocalChannelContextBase implements IChannelContext {
         return summarizeChannel(this.channel, true /* fullTree */, false /* trackState */);
     }
 
-    public markAttached(): void {
-        if (this.attached) {
-            throw new Error("Channel is already attached");
+    public makeVisible(): void {
+        if (this.globallyVisible) {
+            throw new Error("Channel is already globally visible");
         }
 
         if (this.isLoaded) {
             assert(!!this.channel, 0x192 /* "Channel should be there if loaded!!" */);
             this.channel.connect(this.servicesGetter().value);
         }
-        this.attached = true;
+        this.globallyVisible = true;
     }
 
     /**

package/src/packageVersion.ts

@@ -6,4 +6,4 @@
  */
 
 export const pkgName = "@fluidframework/datastore";
-export const pkgVersion = "0.58.3000-61081";
+export const pkgVersion = "0.59.1000-61898";