@fluidframework/sequence 0.52.1 → 0.54.0

package/lib/sharedObjectSequence.d.ts

@@ -10,6 +10,9 @@ import { SharedSequence } from "./sharedSequence";
  * at a position within the sequence. See the
  * {@link https://fluidframework.com/docs/data-structures/sequences/ | sequence documentation}
  * for details on working with sequences.
+ *
+ * @deprecated SharedObjectSequence is not recommended for use and will be removed in an upcoming release.
+ * For more info, please see [Github issue 8526](https://github.com/microsoft/FluidFramework/issues/8526)
  */
 export declare class SharedObjectSequence<T> extends SharedSequence<T> {
     id: string;
@@ -19,15 +22,29 @@ export declare class SharedObjectSequence<T> extends SharedSequence<T> {
      * @param runtime - data store runtime the new shared object sequence belongs to
      * @param id - optional name of the shared object sequence
      * @returns newly create shared object sequence (but not attached yet)
+     *
+     * @deprecated SharedObjectSequence is not recommended for use and will be removed in an upcoming release.
+     * For more info, please see [Github issue 8526](https://github.com/microsoft/FluidFramework/issues/8526)
      */
     static create<T>(runtime: IFluidDataStoreRuntime, id?: string): SharedObjectSequence<T>;
     /**
      * Get a factory for SharedObjectSequence to register with the data store.
      *
      * @returns a factory that creates and load SharedObjectSequence
+     *
+     * @deprecated SharedObjectSequence is not recommended for use and will be removed in an upcoming release.
+     * For more info, please see [Github issue 8526](https://github.com/microsoft/FluidFramework/issues/8526)
      */
     static getFactory(): SharedObjectSequenceFactory;
+    /**
+     * @deprecated SharedObjectSequence is not recommended for use and will be removed in an upcoming release.
+     * For more info, please see [Github issue 8526](https://github.com/microsoft/FluidFramework/issues/8526)
+     */
     constructor(document: IFluidDataStoreRuntime, id: string, attributes: IChannelAttributes);
+    /**
+     * @deprecated SharedObjectSequence is not recommended for use and will be removed in an upcoming release.
+     * For more info, please see [Github issue 8526](https://github.com/microsoft/FluidFramework/issues/8526)
+     */
     getRange(start: number, end?: number): Serializable<T>[];
 }
 //# sourceMappingURL=sharedObjectSequence.d.ts.map

package/lib/sharedObjectSequence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sharedObjectSequence.d.ts","sourceRoot":"","sources":["../src/sharedObjectSequence.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AACjH,OAAO,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;;;GAKG;AACH,qBAAa,oBAAoB,CAAC,CAAC,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAC;IAsBL,EAAE,EAAE,MAAM;IArB/D;;;;;;OAMG;WAEW,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,sBAAsB,EAAE,EAAE,CAAC,EAAE,MAAM;IAIpE;;;;OAIG;WACW,UAAU;gBAIZ,QAAQ,EAAE,sBAAsB,EAAS,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB;IAIxF,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,EAAE;CAGlE"}
+{"version":3,"file":"sharedObjectSequence.d.ts","sourceRoot":"","sources":["../src/sharedObjectSequence.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AACjH,OAAO,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;;;;;;GAQG;AACH,qBAAa,oBAAoB,CAAC,CAAC,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAC;IAgCL,EAAE,EAAE,MAAM;IA/B/D;;;;;;;;;OASG;WAEW,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,sBAAsB,EAAE,EAAE,CAAC,EAAE,MAAM;IAIpE;;;;;;;OAOG;WACW,UAAU;IAIxB;;;OAGG;gBACS,QAAQ,EAAE,sBAAsB,EAAS,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB;IAI/F;;;OAGG;IACI,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,EAAE;CAGlE"}

package/lib/sharedObjectSequence.js

@@ -9,8 +9,15 @@ import { SharedSequence } from "./sharedSequence";
  * at a position within the sequence. See the
  * {@link https://fluidframework.com/docs/data-structures/sequences/ | sequence documentation}
  * for details on working with sequences.
+ *
+ * @deprecated SharedObjectSequence is not recommended for use and will be removed in an upcoming release.
+ * For more info, please see [Github issue 8526](https://github.com/microsoft/FluidFramework/issues/8526)
  */
 export class SharedObjectSequence extends SharedSequence {
+    /**
+     * @deprecated SharedObjectSequence is not recommended for use and will be removed in an upcoming release.
+     * For more info, please see [Github issue 8526](https://github.com/microsoft/FluidFramework/issues/8526)
+     */
     constructor(document, id, attributes) {
         super(document, id, attributes, SharedObjectSequenceFactory.segmentFromSpec);
         this.id = id;
@@ -21,6 +28,9 @@ export class SharedObjectSequence extends SharedSequence {
      * @param runtime - data store runtime the new shared object sequence belongs to
      * @param id - optional name of the shared object sequence
      * @returns newly create shared object sequence (but not attached yet)
+     *
+     * @deprecated SharedObjectSequence is not recommended for use and will be removed in an upcoming release.
+     * For more info, please see [Github issue 8526](https://github.com/microsoft/FluidFramework/issues/8526)
      */
     // eslint-disable-next-line @typescript-eslint/no-shadow
     static create(runtime, id) {
@@ -30,10 +40,17 @@ export class SharedObjectSequence extends SharedSequence {
      * Get a factory for SharedObjectSequence to register with the data store.
      *
      * @returns a factory that creates and load SharedObjectSequence
+     *
+     * @deprecated SharedObjectSequence is not recommended for use and will be removed in an upcoming release.
+     * For more info, please see [Github issue 8526](https://github.com/microsoft/FluidFramework/issues/8526)
      */
     static getFactory() {
         return new SharedObjectSequenceFactory();
     }
+    /**
+     * @deprecated SharedObjectSequence is not recommended for use and will be removed in an upcoming release.
+     * For more info, please see [Github issue 8526](https://github.com/microsoft/FluidFramework/issues/8526)
+     */
     getRange(start, end) {
         return this.getItems(start, end);
     }

package/lib/sharedObjectSequence.js.map

@@ -1 +1 @@
-{"version":3,"file":"sharedObjectSequence.js","sourceRoot":"","sources":["../src/sharedObjectSequence.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;;;GAKG;AACH,MAAM,OAAO,oBAAwB,SAAQ,cAAiB;IAsB1D,YAAY,QAAgC,EAAS,EAAU,EAAE,UAA8B;QAC3F,KAAK,CAAC,QAAQ,EAAE,EAAE,EAAE,UAAU,EAAE,2BAA2B,CAAC,eAAe,CAAC,CAAC;QAD5B,OAAE,GAAF,EAAE,CAAQ;IAE/D,CAAC;IAvBD;;;;;;OAMG;IACH,wDAAwD;IACjD,MAAM,CAAC,MAAM,CAAI,OAA+B,EAAE,EAAW;QAChE,OAAO,OAAO,CAAC,aAAa,CAAC,EAAE,EAAE,2BAA2B,CAAC,IAAI,CAA4B,CAAC;IAClG,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,UAAU;QACpB,OAAO,IAAI,2BAA2B,EAAE,CAAC;IAC7C,CAAC;IAMM,QAAQ,CAAC,KAAa,EAAE,GAAY;QACvC,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACrC,CAAC;CACJ","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { IFluidDataStoreRuntime, IChannelAttributes, Serializable } from \"@fluidframework/datastore-definitions\";\nimport { SharedObjectSequenceFactory } from \"./sequenceFactory\";\nimport { SharedSequence } from \"./sharedSequence\";\n\n/**\n * The SharedObjectSequence holds a sequence of serializable objects. Each object will be stored\n * at a position within the sequence. See the\n * {@link https://fluidframework.com/docs/data-structures/sequences/ | sequence documentation}\n * for details on working with sequences.\n */\nexport class SharedObjectSequence<T> extends SharedSequence<T> {\n    /**\n     * Create a new shared object sequence\n     *\n     * @param runtime - data store runtime the new shared object sequence belongs to\n     * @param id - optional name of the shared object sequence\n     * @returns newly create shared object sequence (but not attached yet)\n     */\n    // eslint-disable-next-line @typescript-eslint/no-shadow\n    public static create<T>(runtime: IFluidDataStoreRuntime, id?: string) {\n        return runtime.createChannel(id, SharedObjectSequenceFactory.Type) as SharedObjectSequence<T>;\n    }\n\n    /**\n     * Get a factory for SharedObjectSequence to register with the data store.\n     *\n     * @returns a factory that creates and load SharedObjectSequence\n     */\n    public static getFactory() {\n        return new SharedObjectSequenceFactory();\n    }\n\n    constructor(document: IFluidDataStoreRuntime, public id: string, attributes: IChannelAttributes) {\n        super(document, id, attributes, SharedObjectSequenceFactory.segmentFromSpec);\n    }\n\n    public getRange(start: number, end?: number): Serializable<T>[] {\n        return this.getItems(start, end);\n    }\n}\n"]}
+{"version":3,"file":"sharedObjectSequence.js","sourceRoot":"","sources":["../src/sharedObjectSequence.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;;;;;;GAQG;AACH,MAAM,OAAO,oBAAwB,SAAQ,cAAiB;IA4B1D;;;OAGG;IACH,YAAY,QAAgC,EAAS,EAAU,EAAE,UAA8B;QAC3F,KAAK,CAAC,QAAQ,EAAE,EAAE,EAAE,UAAU,EAAE,2BAA2B,CAAC,eAAe,CAAC,CAAC;QAD5B,OAAE,GAAF,EAAE,CAAQ;IAE/D,CAAC;IAjCD;;;;;;;;;OASG;IACH,wDAAwD;IACjD,MAAM,CAAC,MAAM,CAAI,OAA+B,EAAE,EAAW;QAChE,OAAO,OAAO,CAAC,aAAa,CAAC,EAAE,EAAE,2BAA2B,CAAC,IAAI,CAA4B,CAAC;IAClG,CAAC;IAED;;;;;;;OAOG;IACI,MAAM,CAAC,UAAU;QACpB,OAAO,IAAI,2BAA2B,EAAE,CAAC;IAC7C,CAAC;IAUD;;;OAGG;IACI,QAAQ,CAAC,KAAa,EAAE,GAAY;QACvC,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACrC,CAAC;CACJ","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { IFluidDataStoreRuntime, IChannelAttributes, Serializable } from \"@fluidframework/datastore-definitions\";\nimport { SharedObjectSequenceFactory } from \"./sequenceFactory\";\nimport { SharedSequence } from \"./sharedSequence\";\n\n/**\n * The SharedObjectSequence holds a sequence of serializable objects. Each object will be stored\n * at a position within the sequence. See the\n * {@link https://fluidframework.com/docs/data-structures/sequences/ | sequence documentation}\n * for details on working with sequences.\n *\n * @deprecated SharedObjectSequence is not recommended for use and will be removed in an upcoming release.\n * For more info, please see [Github issue 8526](https://github.com/microsoft/FluidFramework/issues/8526)\n */\nexport class SharedObjectSequence<T> extends SharedSequence<T> {\n    /**\n     * Create a new shared object sequence\n     *\n     * @param runtime - data store runtime the new shared object sequence belongs to\n     * @param id - optional name of the shared object sequence\n     * @returns newly create shared object sequence (but not attached yet)\n     *\n     * @deprecated SharedObjectSequence is not recommended for use and will be removed in an upcoming release.\n     * For more info, please see [Github issue 8526](https://github.com/microsoft/FluidFramework/issues/8526)\n     */\n    // eslint-disable-next-line @typescript-eslint/no-shadow\n    public static create<T>(runtime: IFluidDataStoreRuntime, id?: string) {\n        return runtime.createChannel(id, SharedObjectSequenceFactory.Type) as SharedObjectSequence<T>;\n    }\n\n    /**\n     * Get a factory for SharedObjectSequence to register with the data store.\n     *\n     * @returns a factory that creates and load SharedObjectSequence\n     *\n     * @deprecated SharedObjectSequence is not recommended for use and will be removed in an upcoming release.\n     * For more info, please see [Github issue 8526](https://github.com/microsoft/FluidFramework/issues/8526)\n     */\n    public static getFactory() {\n        return new SharedObjectSequenceFactory();\n    }\n\n    /**\n     * @deprecated SharedObjectSequence is not recommended for use and will be removed in an upcoming release.\n     * For more info, please see [Github issue 8526](https://github.com/microsoft/FluidFramework/issues/8526)\n     */\n    constructor(document: IFluidDataStoreRuntime, public id: string, attributes: IChannelAttributes) {\n        super(document, id, attributes, SharedObjectSequenceFactory.segmentFromSpec);\n    }\n\n    /**\n     * @deprecated SharedObjectSequence is not recommended for use and will be removed in an upcoming release.\n     * For more info, please see [Github issue 8526](https://github.com/microsoft/FluidFramework/issues/8526)\n     */\n    public getRange(start: number, end?: number): Serializable<T>[] {\n        return this.getItems(start, end);\n    }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fluidframework/sequence",
-  "version": "0.52.1",
+  "version": "0.54.0",
   "description": "Distributed sequence",
   "homepage": "https://fluidframework.com",
   "repository": "https://github.com/microsoft/FluidFramework",
@@ -60,27 +60,27 @@
     "@fluidframework/common-definitions": "^0.20.1",
     "@fluidframework/common-utils": "^0.32.1",
     "@fluidframework/core-interfaces": "^0.41.0",
-    "@fluidframework/datastore-definitions": "^0.52.1",
-    "@fluidframework/merge-tree": "^0.52.1",
+    "@fluidframework/datastore-definitions": "^0.54.0",
+    "@fluidframework/merge-tree": "^0.54.0",
     "@fluidframework/protocol-definitions": "^0.1026.0",
-    "@fluidframework/runtime-definitions": "^0.52.1",
-    "@fluidframework/runtime-utils": "^0.52.1",
-    "@fluidframework/shared-object-base": "^0.52.1",
-    "@fluidframework/telemetry-utils": "^0.52.1",
+    "@fluidframework/runtime-definitions": "^0.54.0",
+    "@fluidframework/runtime-utils": "^0.54.0",
+    "@fluidframework/shared-object-base": "^0.54.0",
+    "@fluidframework/telemetry-utils": "^0.54.0",
     "uuid": "^8.3.1"
   },
   "devDependencies": {
-    "@fluid-internal/test-dds-utils": "^0.52.1",
+    "@fluid-internal/test-dds-utils": "^0.54.0",
     "@fluidframework/build-common": "^0.23.0",
     "@fluidframework/eslint-config-fluid": "^0.24.0",
     "@fluidframework/gitresources": "^0.1034.0",
-    "@fluidframework/mocha-test-setup": "^0.52.1",
+    "@fluidframework/mocha-test-setup": "^0.54.0",
     "@fluidframework/server-services-client": "^0.1034.0",
-    "@fluidframework/test-runtime-utils": "^0.52.1",
+    "@fluidframework/test-runtime-utils": "^0.54.0",
     "@microsoft/api-extractor": "^7.16.1",
     "@types/diff": "^3.5.1",
     "@types/mocha": "^8.2.2",
-    "@types/node": "^12.19.0",
+    "@types/node": "^14.18.0",
     "@types/random-js": "^1.0.31",
     "@typescript-eslint/eslint-plugin": "~4.14.0",
     "@typescript-eslint/parser": "~4.14.0",

package/src/intervalCollection.ts

@@ -653,31 +653,6 @@ export class LocalIntervalCollection<TInterval extends ISerializableInterval> {
         // eslint-disable-next-line @typescript-eslint/no-unsafe-return
         return intervals.map((interval) => interval.serialize(client));
     }
-
-    /**
-     * @deprecated This method only exists to support the deprecated IntervalCollection.delete(start, end).
-     */
-    public getLegacyInterval(start: number, end: number): TInterval | undefined {
-        const transientInterval: TInterval = this.helpers.create(
-            "transient",
-            start,
-            end,
-            this.client,
-            IntervalType.Transient,
-        );
-
-        let result: TInterval;
-        this.mapUntil((interval: TInterval): boolean => {
-            if (interval.compareStart(transientInterval) === 0 &&
-                interval.compareEnd(transientInterval) === 0 &&
-                interval.getIntervalId()?.startsWith(LocalIntervalCollection.legacyIdPrefix)) {
-                result = interval;
-                return false;
-            }
-            return true;
-        });
-        return result;
-    }
 }
 
 const compareSequenceIntervalEnds = (a: SequenceInterval, b: SequenceInterval): number => a.end.compare(b.end);
@@ -960,23 +935,6 @@ export class IntervalCollection<TInterval extends ISerializableInterval>
         return interval;
     }
 
-    /**
-     * @deprecated delete by start/end position is deprecated. Use removeIntervalById.
-     */
-    public delete(
-        start: number,
-        end: number,
-    ) {
-        if (!this.attached) {
-            throw new Error("attach must be called prior to deleting intervals");
-        }
-
-        const interval = this.localCollection.getLegacyInterval(start, end);
-        if (interval) {
-            this.deleteExistingInterval(interval, true, undefined);
-        }
-    }
-
     private deleteExistingInterval(interval: TInterval, local: boolean, op: ISequencedDocumentMessage) {
         // The given interval is known to exist in the collection.
         this.localCollection.removeExistingInterval(interval);
@@ -1194,22 +1152,6 @@ export class IntervalCollection<TInterval extends ISerializableInterval>
         });
     }
 
-    /**
-     * @deprecated IntervalCollectionView has been removed. Refer to IntervalCollection directly.
-     */
-    public async getView(onDeserialize?: DeserializeCallback): Promise<IntervalCollection<TInterval>> {
-        if (!this.attached) {
-            return Promise.reject(new Error("attachSequence must be called prior to retrieving the view"));
-        }
-
-        // Attach custom deserializers if specified
-        if (onDeserialize) {
-            this.attachDeserializer(onDeserialize);
-        }
-
-        return this;
-    }
-
     public addInternal(
         serializedInterval: ISerializedInterval,
         local: boolean,

package/src/mapKernelInterfaces.ts

@@ -118,11 +118,9 @@ export interface ISharedMapEvents extends ISharedObjectEvents {
     (event: "valueChanged", listener: (
         changed: IValueChanged,
         local: boolean,
-        op: ISequencedDocumentMessage | null,
         target: IEventThisPlaceHolder) => void);
     (event: "clear", listener: (
         local: boolean,
-        op: ISequencedDocumentMessage | null,
         target: IEventThisPlaceHolder
     ) => void);
 }

package/src/packageVersion.ts

@@ -6,4 +6,4 @@
  */
 
 export const pkgName = "@fluidframework/sequence";
-export const pkgVersion = "0.52.1";
+export const pkgVersion = "0.54.0";

package/src/sequence.ts

@@ -3,7 +3,7 @@
  * Licensed under the MIT License.
  */
 import { Deferred, bufferToString, assert } from "@fluidframework/common-utils";
-import { IFluidSerializer } from "@fluidframework/core-interfaces";
+import { IFluidHandle, IFluidSerializer } from "@fluidframework/core-interfaces";
 import { ChildLogger } from "@fluidframework/telemetry-utils";
 import {
     FileMode,
@@ -461,7 +461,10 @@ export abstract class SharedSegmentSequence<T extends ISegment>
     protected getGCDataCore(): IGarbageCollectionData {
         // Create a SummarySerializer and use it to serialize all the cells. It keeps track of all IFluidHandles that it
         // serializes.
-        const serializer = new SummarySerializer(this.runtime.channelsRoutingContext);
+        const serializer = new SummarySerializer(
+            this.runtime.channelsRoutingContext,
+            (handle: IFluidHandle) => this.handleDecoded(handle),
+        );
 
         if (this.intervalMapKernel.size > 0) {
             this.intervalMapKernel.serialize(serializer);

package/src/sequenceFactory.ts

@@ -68,15 +68,31 @@ export class SharedStringFactory implements IChannelFactory {
     }
 }
 
+/**
+ * @deprecated SharedObjectSequence is not recommended for use and will be removed in an upcoming release.
+ * For more info, please see [Github issue 8526](https://github.com/microsoft/FluidFramework/issues/8526)
+ */
 export class SharedObjectSequenceFactory implements IChannelFactory {
+    /**
+     * @deprecated SharedObjectSequence is not recommended for use and will be removed in an upcoming release.
+     * For more info, please see [Github issue 8526](https://github.com/microsoft/FluidFramework/issues/8526)
+     */
     public static Type = "https://graph.microsoft.com/types/mergeTree/object-sequence";
 
+    /**
+     * @deprecated SharedObjectSequence is not recommended for use and will be removed in an upcoming release.
+     * For more info, please see [Github issue 8526](https://github.com/microsoft/FluidFramework/issues/8526)
+     */
     public static readonly Attributes: IChannelAttributes = {
         type: SharedObjectSequenceFactory.Type,
         snapshotFormatVersion: "0.1",
         packageVersion: pkgVersion,
     };
 
+    /**
+     * @deprecated SharedObjectSequence is not recommended for use and will be removed in an upcoming release.
+     * For more info, please see [Github issue 8526](https://github.com/microsoft/FluidFramework/issues/8526)
+     */
     public static segmentFromSpec(segSpec: IJSONSegment) {
         // eslint-disable-next-line @typescript-eslint/ban-types
         const runSegment = segSpec as IJSONRunSegment<object>;
@@ -90,16 +106,27 @@ export class SharedObjectSequenceFactory implements IChannelFactory {
         }
     }
 
+    /**
+     * @deprecated SharedObjectSequence is not recommended for use and will be removed in an upcoming release.
+     * For more info, please see [Github issue 8526](https://github.com/microsoft/FluidFramework/issues/8526)
+     */
     public get type() {
         return SharedObjectSequenceFactory.Type;
     }
 
+    /**
+     * @deprecated SharedObjectSequence is not recommended for use and will be removed in an upcoming release.
+     * For more info, please see [Github issue 8526](https://github.com/microsoft/FluidFramework/issues/8526)
+     */
     public get attributes() {
         return SharedObjectSequenceFactory.Attributes;
     }
 
     /**
      * {@inheritDoc @fluidframework/datastore-definitions#IChannelFactory.load}
+     *
+     * @deprecated SharedObjectSequence is not recommended for use and will be removed in an upcoming release.
+     * For more info, please see [Github issue 8526](https://github.com/microsoft/FluidFramework/issues/8526)
      */
     public async load(
         runtime: IFluidDataStoreRuntime,
@@ -112,6 +139,10 @@ export class SharedObjectSequenceFactory implements IChannelFactory {
         return sharedSeq;
     }
 
+    /**
+     * @deprecated SharedObjectSequence is not recommended for use and will be removed in an upcoming release.
+     * For more info, please see [Github issue 8526](https://github.com/microsoft/FluidFramework/issues/8526)
+     */
     public create(document: IFluidDataStoreRuntime, id: string): ISharedObject {
         const sharedString = new SharedObjectSequence(document, id, this.attributes);
         sharedString.initializeLocal();
@@ -119,15 +150,31 @@ export class SharedObjectSequenceFactory implements IChannelFactory {
     }
 }
 
+/**
+ * @deprecated SharedNumberSequence is not recommended for use and will be removed in an upcoming release.
+ * For more info, please see [Github issue 8526](https://github.com/microsoft/FluidFramework/issues/8526)
+ */
 export class SharedNumberSequenceFactory implements IChannelFactory {
+    /**
+     * @deprecated SharedNumberSequence is not recommended for use and will be removed in an upcoming release.
+     * For more info, please see [Github issue 8526](https://github.com/microsoft/FluidFramework/issues/8526)
+     */
     public static Type = "https://graph.microsoft.com/types/mergeTree/number-sequence";
 
+    /**
+     * @deprecated SharedNumberSequence is not recommended for use and will be removed in an upcoming release.
+     * For more info, please see [Github issue 8526](https://github.com/microsoft/FluidFramework/issues/8526)
+     */
     public static readonly Attributes: IChannelAttributes = {
         type: SharedNumberSequenceFactory.Type,
         snapshotFormatVersion: "0.1",
         packageVersion: pkgVersion,
     };
 
+    /**
+     * @deprecated SharedNumberSequence is not recommended for use and will be removed in an upcoming release.
+     * For more info, please see [Github issue 8526](https://github.com/microsoft/FluidFramework/issues/8526)
+     */
     public static segmentFromSpec(segSpec: IJSONSegment) {
         const runSegment = segSpec as IJSONRunSegment<number>;
         if (runSegment.items) {
@@ -139,16 +186,27 @@ export class SharedNumberSequenceFactory implements IChannelFactory {
         }
     }
 
+    /**
+     * @deprecated SharedNumberSequence is not recommended for use and will be removed in an upcoming release.
+     * For more info, please see [Github issue 8526](https://github.com/microsoft/FluidFramework/issues/8526)
+     */
     public get type() {
         return SharedNumberSequenceFactory.Type;
     }
 
+    /**
+     * @deprecated SharedNumberSequence is not recommended for use and will be removed in an upcoming release.
+     * For more info, please see [Github issue 8526](https://github.com/microsoft/FluidFramework/issues/8526)
+     */
     public get attributes() {
         return SharedNumberSequenceFactory.Attributes;
     }
 
     /**
      * {@inheritDoc @fluidframework/datastore-definitions#IChannelFactory.load}
+     *
+     * @deprecated SharedNumberSequence is not recommended for use and will be removed in an upcoming release.
+     * For more info, please see [Github issue 8526](https://github.com/microsoft/FluidFramework/issues/8526)
      */
     public async load(
         runtime: IFluidDataStoreRuntime,
@@ -160,6 +218,10 @@ export class SharedNumberSequenceFactory implements IChannelFactory {
         return sharedSeq;
     }
 
+    /**
+     * @deprecated SharedNumberSequence is not recommended for use and will be removed in an upcoming release.
+     * For more info, please see [Github issue 8526](https://github.com/microsoft/FluidFramework/issues/8526)
+     */
     public create(document: IFluidDataStoreRuntime, id: string): ISharedObject {
         const sharedString = new SharedNumberSequence(document, id, this.attributes);
         sharedString.initializeLocal();

package/src/sharedNumberSequence.ts

@@ -12,6 +12,9 @@ import { SharedSequence } from "./sharedSequence";
  * at a position within the sequence. See the
  * {@link https://fluidframework.com/docs/data-structures/sequences/ | sequence documentation}
  * for details on working with sequences.
+ *
+ * @deprecated SharedNumberSequence is not recommended for use and will be removed in an upcoming release.
+ * For more info, please see [Github issue 8526](https://github.com/microsoft/FluidFramework/issues/8526)
  */
 export class SharedNumberSequence extends SharedSequence<number> {
     /**
@@ -20,6 +23,9 @@ export class SharedNumberSequence extends SharedSequence<number> {
      * @param runtime - data store runtime the new shared number sequence belongs to
      * @param id - optional name of the shared number sequence
      * @returns newly create shared number sequence (but not attached yet)
+     *
+     * @deprecated SharedNumberSequence is not recommended for use and will be removed in an upcoming release.
+     * For more info, please see [Github issue 8526](https://github.com/microsoft/FluidFramework/issues/8526)
      */
     public static create(runtime: IFluidDataStoreRuntime, id?: string) {
         return runtime.createChannel(id,
@@ -30,15 +36,26 @@ export class SharedNumberSequence extends SharedSequence<number> {
      * Get a factory for SharedNumberSequence to register with the data store.
      *
      * @returns a factory that creates and load SharedNumberSequence
+     *
+     * @deprecated SharedNumberSequence is not recommended for use and will be removed in an upcoming release.
+     * For more info, please see [Github issue 8526](https://github.com/microsoft/FluidFramework/issues/8526)
      */
     public static getFactory() {
         return new SharedNumberSequenceFactory();
     }
 
+    /**
+     * @deprecated SharedNumberSequence is not recommended for use and will be removed in an upcoming release.
+     * For more info, please see [Github issue 8526](https://github.com/microsoft/FluidFramework/issues/8526)
+     */
     constructor(document: IFluidDataStoreRuntime, public id: string, attributes: IChannelAttributes) {
         super(document, id, attributes, SharedNumberSequenceFactory.segmentFromSpec);
     }
 
+    /**
+     * @deprecated SharedNumberSequence is not recommended for use and will be removed in an upcoming release.
+     * For more info, please see [Github issue 8526](https://github.com/microsoft/FluidFramework/issues/8526)
+     */
     public getRange(start: number, end?: number) {
         return this.getItems(start, end);
     }

package/src/sharedObjectSequence.ts

@@ -12,6 +12,9 @@ import { SharedSequence } from "./sharedSequence";
  * at a position within the sequence. See the
  * {@link https://fluidframework.com/docs/data-structures/sequences/ | sequence documentation}
  * for details on working with sequences.
+ *
+ * @deprecated SharedObjectSequence is not recommended for use and will be removed in an upcoming release.
+ * For more info, please see [Github issue 8526](https://github.com/microsoft/FluidFramework/issues/8526)
  */
 export class SharedObjectSequence<T> extends SharedSequence<T> {
     /**
@@ -20,6 +23,9 @@ export class SharedObjectSequence<T> extends SharedSequence<T> {
      * @param runtime - data store runtime the new shared object sequence belongs to
      * @param id - optional name of the shared object sequence
      * @returns newly create shared object sequence (but not attached yet)
+     *
+     * @deprecated SharedObjectSequence is not recommended for use and will be removed in an upcoming release.
+     * For more info, please see [Github issue 8526](https://github.com/microsoft/FluidFramework/issues/8526)
      */
     // eslint-disable-next-line @typescript-eslint/no-shadow
     public static create<T>(runtime: IFluidDataStoreRuntime, id?: string) {
@@ -30,15 +36,26 @@ export class SharedObjectSequence<T> extends SharedSequence<T> {
      * Get a factory for SharedObjectSequence to register with the data store.
      *
      * @returns a factory that creates and load SharedObjectSequence
+     *
+     * @deprecated SharedObjectSequence is not recommended for use and will be removed in an upcoming release.
+     * For more info, please see [Github issue 8526](https://github.com/microsoft/FluidFramework/issues/8526)
      */
     public static getFactory() {
         return new SharedObjectSequenceFactory();
     }
 
+    /**
+     * @deprecated SharedObjectSequence is not recommended for use and will be removed in an upcoming release.
+     * For more info, please see [Github issue 8526](https://github.com/microsoft/FluidFramework/issues/8526)
+     */
     constructor(document: IFluidDataStoreRuntime, public id: string, attributes: IChannelAttributes) {
         super(document, id, attributes, SharedObjectSequenceFactory.segmentFromSpec);
     }
 
+    /**
+     * @deprecated SharedObjectSequence is not recommended for use and will be removed in an upcoming release.
+     * For more info, please see [Github issue 8526](https://github.com/microsoft/FluidFramework/issues/8526)
+     */
     public getRange(start: number, end?: number): Serializable<T>[] {
         return this.getItems(start, end);
     }