@fluid-experimental/dds-interceptions 2.0.0-dev-rc.2.0.0.245554

package/dist/map/sharedMapWithInterception.d.ts

@@ -0,0 +1,23 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { ISharedMap } from "@fluidframework/map";
+import { IFluidDataStoreContext } from "@fluidframework/runtime-definitions";
+/**
+ * - Create a new object from the passed SharedMap.
+ *
+ * - Modify the set method to call the setInterceptionCallback before calling set on the underlying SharedMap.
+ *
+ * - The setInterceptionCallback and the call to the underlying SharedMap are wrapped around an
+ * orderSequentially call to batch any operations that might happen in the callback.
+ *
+ * @param sharedMap - The underlying SharedMap
+ * @param context - The IFluidDataStoreContext that will be used to call orderSequentially
+ * @param setInterceptionCallback - The interception callback to be called
+ *
+ * @returns A new SharedMap that intercepts the set method and calls the setInterceptionCallback.
+ * @internal
+ */
+export declare function createSharedMapWithInterception(sharedMap: ISharedMap, context: IFluidDataStoreContext, setInterceptionCallback: (sharedMap: ISharedMap, key: string, value: any) => void): ISharedMap;
+//# sourceMappingURL=sharedMapWithInterception.d.ts.map

package/dist/map/sharedMapWithInterception.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sharedMapWithInterception.d.ts","sourceRoot":"","sources":["../../src/map/sharedMapWithInterception.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAE7E;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,+BAA+B,CAC9C,SAAS,EAAE,UAAU,EACrB,OAAO,EAAE,sBAAsB,EAC/B,uBAAuB,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,GAC/E,UAAU,CA6BZ"}

package/dist/map/sharedMapWithInterception.js

@@ -0,0 +1,49 @@
+"use strict";
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSharedMapWithInterception = void 0;
+const core_utils_1 = require("@fluidframework/core-utils");
+/**
+ * - Create a new object from the passed SharedMap.
+ *
+ * - Modify the set method to call the setInterceptionCallback before calling set on the underlying SharedMap.
+ *
+ * - The setInterceptionCallback and the call to the underlying SharedMap are wrapped around an
+ * orderSequentially call to batch any operations that might happen in the callback.
+ *
+ * @param sharedMap - The underlying SharedMap
+ * @param context - The IFluidDataStoreContext that will be used to call orderSequentially
+ * @param setInterceptionCallback - The interception callback to be called
+ *
+ * @returns A new SharedMap that intercepts the set method and calls the setInterceptionCallback.
+ * @internal
+ */
+function createSharedMapWithInterception(sharedMap, context, setInterceptionCallback) {
+    const sharedMapWithInterception = Object.create(sharedMap);
+    // executingCallback keeps track of whether set is called recursively from the setInterceptionCallback.
+    let executingCallback = false;
+    sharedMapWithInterception.set = (key, value) => {
+        let map;
+        // Set should not be called on the wrapped object from the interception callback as this will lead to
+        // infinite recursion.
+        (0, core_utils_1.assert)(executingCallback === false, 0x0c0 /* "set called recursively from the interception callback" */);
+        context.containerRuntime.orderSequentially(() => {
+            map = sharedMap.set(key, value);
+            executingCallback = true;
+            try {
+                setInterceptionCallback(sharedMap, key, value);
+            }
+            finally {
+                executingCallback = false;
+            }
+        });
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+        return map;
+    };
+    return sharedMapWithInterception;
+}
+exports.createSharedMapWithInterception = createSharedMapWithInterception;
+//# sourceMappingURL=sharedMapWithInterception.js.map

package/dist/map/sharedMapWithInterception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sharedMapWithInterception.js","sourceRoot":"","sources":["../../src/map/sharedMapWithInterception.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,2DAAoD;AAIpD;;;;;;;;;;;;;;GAcG;AACH,SAAgB,+BAA+B,CAC9C,SAAqB,EACrB,OAA+B,EAC/B,uBAAiF;IAEjF,MAAM,yBAAyB,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAE3D,uGAAuG;IACvG,IAAI,iBAAiB,GAAY,KAAK,CAAC;IAEvC,yBAAyB,CAAC,GAAG,GAAG,CAAC,GAAW,EAAE,KAAU,EAAE,EAAE;QAC3D,IAAI,GAAG,CAAC;QACR,qGAAqG;QACrG,sBAAsB;QACtB,IAAA,mBAAM,EACL,iBAAiB,KAAK,KAAK,EAC3B,KAAK,CAAC,6DAA6D,CACnE,CAAC;QAEF,OAAO,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,GAAG,EAAE;YAC/C,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAChC,iBAAiB,GAAG,IAAI,CAAC;YACzB,IAAI;gBACH,uBAAuB,CAAC,SAAS,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;aAC/C;oBAAS;gBACT,iBAAiB,GAAG,KAAK,CAAC;aAC1B;QACF,CAAC,CAAC,CAAC;QACH,+DAA+D;QAC/D,OAAO,GAAG,CAAC;IACZ,CAAC,CAAC;IAEF,OAAO,yBAAuC,CAAC;AAChD,CAAC;AAjCD,0EAiCC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { assert } from \"@fluidframework/core-utils\";\nimport { ISharedMap } from \"@fluidframework/map\";\nimport { IFluidDataStoreContext } from \"@fluidframework/runtime-definitions\";\n\n/**\n * - Create a new object from the passed SharedMap.\n *\n * - Modify the set method to call the setInterceptionCallback before calling set on the underlying SharedMap.\n *\n * - The setInterceptionCallback and the call to the underlying SharedMap are wrapped around an\n * orderSequentially call to batch any operations that might happen in the callback.\n *\n * @param sharedMap - The underlying SharedMap\n * @param context - The IFluidDataStoreContext that will be used to call orderSequentially\n * @param setInterceptionCallback - The interception callback to be called\n *\n * @returns A new SharedMap that intercepts the set method and calls the setInterceptionCallback.\n * @internal\n */\nexport function createSharedMapWithInterception(\n\tsharedMap: ISharedMap,\n\tcontext: IFluidDataStoreContext,\n\tsetInterceptionCallback: (sharedMap: ISharedMap, key: string, value: any) => void,\n): ISharedMap {\n\tconst sharedMapWithInterception = Object.create(sharedMap);\n\n\t// executingCallback keeps track of whether set is called recursively from the setInterceptionCallback.\n\tlet executingCallback: boolean = false;\n\n\tsharedMapWithInterception.set = (key: string, value: any) => {\n\t\tlet map;\n\t\t// Set should not be called on the wrapped object from the interception callback as this will lead to\n\t\t// infinite recursion.\n\t\tassert(\n\t\t\texecutingCallback === false,\n\t\t\t0x0c0 /* \"set called recursively from the interception callback\" */,\n\t\t);\n\n\t\tcontext.containerRuntime.orderSequentially(() => {\n\t\t\tmap = sharedMap.set(key, value);\n\t\t\texecutingCallback = true;\n\t\t\ttry {\n\t\t\t\tsetInterceptionCallback(sharedMap, key, value);\n\t\t\t} finally {\n\t\t\t\texecutingCallback = false;\n\t\t\t}\n\t\t});\n\t\t// eslint-disable-next-line @typescript-eslint/no-unsafe-return\n\t\treturn map;\n\t};\n\n\treturn sharedMapWithInterception as ISharedMap;\n}\n"]}

package/dist/package.json

@@ -0,0 +1,3 @@
+{
+	"type": "commonjs"
+}

package/dist/sequence/index.d.ts

@@ -0,0 +1,6 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+export { createSharedStringWithInterception } from "./sharedStringWithInterception.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/sequence/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sequence/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,kCAAkC,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/sequence/index.js

@@ -0,0 +1,10 @@
+"use strict";
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSharedStringWithInterception = void 0;
+var sharedStringWithInterception_js_1 = require("./sharedStringWithInterception.js");
+Object.defineProperty(exports, "createSharedStringWithInterception", { enumerable: true, get: function () { return sharedStringWithInterception_js_1.createSharedStringWithInterception; } });
+//# sourceMappingURL=index.js.map

package/dist/sequence/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sequence/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,qFAAuF;AAA9E,qJAAA,kCAAkC,OAAA","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nexport { createSharedStringWithInterception } from \"./sharedStringWithInterception.js\";\n"]}

package/dist/sequence/sharedStringWithInterception.d.ts

@@ -0,0 +1,27 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import * as MergeTree from "@fluidframework/merge-tree";
+import { SharedString } from "@fluidframework/sequence";
+import { IFluidDataStoreContext } from "@fluidframework/runtime-definitions";
+/**
+ * - Create a new object from the passed SharedString.
+ *
+ * - Modify the methods that insert / remove / annotate the properties of the SharedString to call
+ * the propertyInterceptionCallback to get new properties.
+ *
+ * - Use these new properties to call the underlying SharedString.
+ *
+ * - The propertyInterceptionCallback and the call to the underlying SharedString are wrapped around an
+ * orderSequentially call to batch any operations that might happen in the callback.
+ *
+ * @param sharedString - The underlying SharedString
+ * @param context - The IFluidDataStoreContext that will be used to call orderSequentially
+ * @param propertyInterceptionCallback - The interception callback to be called
+ *
+ * @returns A new SharedString that intercepts the methods modifying the SharedString properties.
+ * @internal
+ */
+export declare function createSharedStringWithInterception(sharedString: SharedString, context: IFluidDataStoreContext, propertyInterceptionCallback: (props?: MergeTree.PropertySet) => MergeTree.PropertySet): SharedString;
+//# sourceMappingURL=sharedStringWithInterception.d.ts.map

package/dist/sequence/sharedStringWithInterception.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sharedStringWithInterception.d.ts","sourceRoot":"","sources":["../../src/sequence/sharedStringWithInterception.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,SAAS,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAE7E;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kCAAkC,CACjD,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,sBAAsB,EAC/B,4BAA4B,EAAE,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,WAAW,KAAK,SAAS,CAAC,WAAW,GACpF,YAAY,CA+Pd"}

package/dist/sequence/sharedStringWithInterception.js

@@ -0,0 +1,207 @@
+"use strict";
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSharedStringWithInterception = void 0;
+const core_utils_1 = require("@fluidframework/core-utils");
+/**
+ * - Create a new object from the passed SharedString.
+ *
+ * - Modify the methods that insert / remove / annotate the properties of the SharedString to call
+ * the propertyInterceptionCallback to get new properties.
+ *
+ * - Use these new properties to call the underlying SharedString.
+ *
+ * - The propertyInterceptionCallback and the call to the underlying SharedString are wrapped around an
+ * orderSequentially call to batch any operations that might happen in the callback.
+ *
+ * @param sharedString - The underlying SharedString
+ * @param context - The IFluidDataStoreContext that will be used to call orderSequentially
+ * @param propertyInterceptionCallback - The interception callback to be called
+ *
+ * @returns A new SharedString that intercepts the methods modifying the SharedString properties.
+ * @internal
+ */
+function createSharedStringWithInterception(sharedString, context, propertyInterceptionCallback) {
+    const sharedStringWithInterception = Object.create(sharedString);
+    // executingCallback keeps track of whether a method on this wrapper object is called recursively
+    // from the propertyInterceptionCallback.
+    let executingCallback = false;
+    /**
+     * Inserts a marker at a relative position.
+     *
+     * @param relativePos1 - The relative position to insert the marker at
+     * @param refType - The reference type of the marker
+     * @param props - The properties of the marker
+     */
+    sharedStringWithInterception.insertMarkerRelative = (relativePos1, refType, props) => {
+        // Wrapper methods should not be called from the interception callback as this will lead to
+        // infinite recursion.
+        (0, core_utils_1.assert)(executingCallback === false, 0x0c1 /* "Interception wrapper methods called recursively from the interception callback" */);
+        context.containerRuntime.orderSequentially(() => {
+            executingCallback = true;
+            try {
+                sharedString.insertMarkerRelative(relativePos1, refType, propertyInterceptionCallback(props));
+            }
+            finally {
+                executingCallback = false;
+            }
+        });
+    };
+    /**
+     * Inserts a marker at the position.
+     *
+     * @param pos - The position to insert the marker at
+     * @param refType - The reference type of the marker
+     * @param props - The properties of the marker
+     */
+    sharedStringWithInterception.insertMarker = (pos, refType, props) => {
+        let insertOp;
+        // Wrapper methods should not be called from the interception callback as this will lead to
+        // infinite recursion.
+        (0, core_utils_1.assert)(executingCallback === false, 0x0c2 /* "Interception wrapper methods called recursively from the interception callback" */);
+        context.containerRuntime.orderSequentially(() => {
+            executingCallback = true;
+            try {
+                insertOp = sharedString.insertMarker(pos, refType, propertyInterceptionCallback(props));
+            }
+            finally {
+                executingCallback = false;
+            }
+        });
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+        return insertOp;
+    };
+    /**
+     * Inserts the text at a relative position.
+     *
+     * @param relativePos1 - The relative position to insert the text at
+     * @param text - The text to insert
+     * @param props - The properties of text
+     */
+    sharedStringWithInterception.insertTextRelative = (relativePos1, text, props) => {
+        // Wrapper methods should not be called from the interception callback as this will lead to
+        // infinite recursion.
+        (0, core_utils_1.assert)(executingCallback === false, 0x0c3 /* "Interception wrapper methods called recursively from the interception callback" */);
+        context.containerRuntime.orderSequentially(() => {
+            executingCallback = true;
+            try {
+                sharedString.insertTextRelative(relativePos1, text, propertyInterceptionCallback(props));
+            }
+            finally {
+                executingCallback = false;
+            }
+        });
+    };
+    /**
+     * Inserts the text at the position.
+     *
+     * @param pos - The position to insert the text at
+     * @param text - The text to insert
+     * @param props - The properties of text
+     */
+    sharedStringWithInterception.insertText = (pos, text, props) => {
+        // Wrapper methods should not be called from the interception callback as this will lead to
+        // infinite recursion.
+        (0, core_utils_1.assert)(executingCallback === false, 0x0c4 /* "Interception wrapper methods called recursively from the interception callback" */);
+        context.containerRuntime.orderSequentially(() => {
+            executingCallback = true;
+            try {
+                sharedString.insertText(pos, text, propertyInterceptionCallback(props));
+            }
+            finally {
+                executingCallback = false;
+            }
+        });
+    };
+    /**
+     * Replaces a range with the provided text.
+     *
+     * @param start - The inclusive start of the range to replace
+     * @param end - The exclusive end of the range to replace
+     * @param text - The text to replace the range with
+     * @param props - Optional. The properties of the replacement text
+     */
+    sharedStringWithInterception.replaceText = (start, end, text, props) => {
+        // Wrapper methods should not be called from the interception callback as this will lead to
+        // infinite recursion.
+        (0, core_utils_1.assert)(executingCallback === false, 0x0c5 /* "Interception wrapper methods called recursively from the interception callback" */);
+        context.containerRuntime.orderSequentially(() => {
+            executingCallback = true;
+            try {
+                sharedString.replaceText(start, end, text, propertyInterceptionCallback(props));
+            }
+            finally {
+                executingCallback = false;
+            }
+        });
+    };
+    /**
+     * Annotates the marker with the provided properties.
+     *
+     * @param marker - The marker to annotate
+     * @param props - The properties to annotate the marker with
+     */
+    sharedStringWithInterception.annotateMarker = (marker, props) => {
+        // Wrapper methods should not be called from the interception callback as this will lead to
+        // infinite recursion.
+        (0, core_utils_1.assert)(executingCallback === false, 0x0c7 /* "Interception wrapper methods called recursively from the interception callback" */);
+        context.containerRuntime.orderSequentially(() => {
+            executingCallback = true;
+            try {
+                sharedString.annotateMarker(marker, propertyInterceptionCallback(props));
+            }
+            finally {
+                executingCallback = false;
+            }
+        });
+    };
+    /**
+     * Annotates the range with the provided properties.
+     *
+     * @param start - The inclusive start position of the range to annotate
+     * @param end - The exclusive end position of the range to annotate
+     * @param props - The properties to annotate the range with
+     *
+     */
+    sharedStringWithInterception.annotateRange = (start, end, props) => {
+        // Wrapper methods should not be called from the interception callback as this will lead to
+        // infinite recursion.
+        (0, core_utils_1.assert)(executingCallback === false, 0x0c8 /* "Interception wrapper methods called recursively from the interception callback" */);
+        context.containerRuntime.orderSequentially(() => {
+            executingCallback = true;
+            try {
+                sharedString.annotateRange(start, end, propertyInterceptionCallback(props));
+            }
+            finally {
+                executingCallback = false;
+            }
+        });
+    };
+    /**
+     * Inserts the segment at the given position
+     *
+     * @param pos - The position to insert the segment at
+     * @param segment - The segment to insert
+     */
+    sharedStringWithInterception.insertAtReferencePosition = (pos, segment) => {
+        // Wrapper methods should not be called from the interception callback as this will lead to
+        // infinite recursion.
+        (0, core_utils_1.assert)(executingCallback === false, 0x0c9 /* "Interception wrapper methods called recursively from the interception callback" */);
+        context.containerRuntime.orderSequentially(() => {
+            executingCallback = true;
+            try {
+                segment.properties = propertyInterceptionCallback(segment.properties);
+                sharedString.insertAtReferencePosition(pos, segment);
+            }
+            finally {
+                executingCallback = false;
+            }
+        });
+    };
+    return sharedStringWithInterception;
+}
+exports.createSharedStringWithInterception = createSharedStringWithInterception;
+//# sourceMappingURL=sharedStringWithInterception.js.map

package/dist/sequence/sharedStringWithInterception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sharedStringWithInterception.js","sourceRoot":"","sources":["../../src/sequence/sharedStringWithInterception.ts"],"names":[],"mappings":"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","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { assert } from \"@fluidframework/core-utils\";\nimport * as MergeTree from \"@fluidframework/merge-tree\";\nimport { SharedString } from \"@fluidframework/sequence\";\nimport { IFluidDataStoreContext } from \"@fluidframework/runtime-definitions\";\n\n/**\n * - Create a new object from the passed SharedString.\n *\n * - Modify the methods that insert / remove / annotate the properties of the SharedString to call\n * the propertyInterceptionCallback to get new properties.\n *\n * - Use these new properties to call the underlying SharedString.\n *\n * - The propertyInterceptionCallback and the call to the underlying SharedString are wrapped around an\n * orderSequentially call to batch any operations that might happen in the callback.\n *\n * @param sharedString - The underlying SharedString\n * @param context - The IFluidDataStoreContext that will be used to call orderSequentially\n * @param propertyInterceptionCallback - The interception callback to be called\n *\n * @returns A new SharedString that intercepts the methods modifying the SharedString properties.\n * @internal\n */\nexport function createSharedStringWithInterception(\n\tsharedString: SharedString,\n\tcontext: IFluidDataStoreContext,\n\tpropertyInterceptionCallback: (props?: MergeTree.PropertySet) => MergeTree.PropertySet,\n): SharedString {\n\tconst sharedStringWithInterception = Object.create(sharedString);\n\n\t// executingCallback keeps track of whether a method on this wrapper object is called recursively\n\t// from the propertyInterceptionCallback.\n\tlet executingCallback: boolean = false;\n\n\t/**\n\t * Inserts a marker at a relative position.\n\t *\n\t * @param relativePos1 - The relative position to insert the marker at\n\t * @param refType - The reference type of the marker\n\t * @param props - The properties of the marker\n\t */\n\tsharedStringWithInterception.insertMarkerRelative = (\n\t\trelativePos1: MergeTree.IRelativePosition,\n\t\trefType: MergeTree.ReferenceType,\n\t\tprops?: MergeTree.PropertySet,\n\t) => {\n\t\t// Wrapper methods should not be called from the interception callback as this will lead to\n\t\t// infinite recursion.\n\t\tassert(\n\t\t\texecutingCallback === false,\n\t\t\t0x0c1 /* \"Interception wrapper methods called recursively from the interception callback\" */,\n\t\t);\n\n\t\tcontext.containerRuntime.orderSequentially(() => {\n\t\t\texecutingCallback = true;\n\t\t\ttry {\n\t\t\t\tsharedString.insertMarkerRelative(\n\t\t\t\t\trelativePos1,\n\t\t\t\t\trefType,\n\t\t\t\t\tpropertyInterceptionCallback(props),\n\t\t\t\t);\n\t\t\t} finally {\n\t\t\t\texecutingCallback = false;\n\t\t\t}\n\t\t});\n\t};\n\n\t/**\n\t * Inserts a marker at the position.\n\t *\n\t * @param pos - The position to insert the marker at\n\t * @param refType - The reference type of the marker\n\t * @param props - The properties of the marker\n\t */\n\tsharedStringWithInterception.insertMarker = (\n\t\tpos: number,\n\t\trefType: MergeTree.ReferenceType,\n\t\tprops?: MergeTree.PropertySet,\n\t) => {\n\t\tlet insertOp;\n\t\t// Wrapper methods should not be called from the interception callback as this will lead to\n\t\t// infinite recursion.\n\t\tassert(\n\t\t\texecutingCallback === false,\n\t\t\t0x0c2 /* \"Interception wrapper methods called recursively from the interception callback\" */,\n\t\t);\n\n\t\tcontext.containerRuntime.orderSequentially(() => {\n\t\t\texecutingCallback = true;\n\t\t\ttry {\n\t\t\t\tinsertOp = sharedString.insertMarker(\n\t\t\t\t\tpos,\n\t\t\t\t\trefType,\n\t\t\t\t\tpropertyInterceptionCallback(props),\n\t\t\t\t);\n\t\t\t} finally {\n\t\t\t\texecutingCallback = false;\n\t\t\t}\n\t\t});\n\t\t// eslint-disable-next-line @typescript-eslint/no-unsafe-return\n\t\treturn insertOp;\n\t};\n\n\t/**\n\t * Inserts the text at a relative position.\n\t *\n\t * @param relativePos1 - The relative position to insert the text at\n\t * @param text - The text to insert\n\t * @param props - The properties of text\n\t */\n\tsharedStringWithInterception.insertTextRelative = (\n\t\trelativePos1: MergeTree.IRelativePosition,\n\t\ttext: string,\n\t\tprops?: MergeTree.PropertySet,\n\t) => {\n\t\t// Wrapper methods should not be called from the interception callback as this will lead to\n\t\t// infinite recursion.\n\t\tassert(\n\t\t\texecutingCallback === false,\n\t\t\t0x0c3 /* \"Interception wrapper methods called recursively from the interception callback\" */,\n\t\t);\n\n\t\tcontext.containerRuntime.orderSequentially(() => {\n\t\t\texecutingCallback = true;\n\t\t\ttry {\n\t\t\t\tsharedString.insertTextRelative(\n\t\t\t\t\trelativePos1,\n\t\t\t\t\ttext,\n\t\t\t\t\tpropertyInterceptionCallback(props),\n\t\t\t\t);\n\t\t\t} finally {\n\t\t\t\texecutingCallback = false;\n\t\t\t}\n\t\t});\n\t};\n\n\t/**\n\t * Inserts the text at the position.\n\t *\n\t * @param pos - The position to insert the text at\n\t * @param text - The text to insert\n\t * @param props - The properties of text\n\t */\n\tsharedStringWithInterception.insertText = (\n\t\tpos: number,\n\t\ttext: string,\n\t\tprops?: MergeTree.PropertySet,\n\t) => {\n\t\t// Wrapper methods should not be called from the interception callback as this will lead to\n\t\t// infinite recursion.\n\t\tassert(\n\t\t\texecutingCallback === false,\n\t\t\t0x0c4 /* \"Interception wrapper methods called recursively from the interception callback\" */,\n\t\t);\n\n\t\tcontext.containerRuntime.orderSequentially(() => {\n\t\t\texecutingCallback = true;\n\t\t\ttry {\n\t\t\t\tsharedString.insertText(pos, text, propertyInterceptionCallback(props));\n\t\t\t} finally {\n\t\t\t\texecutingCallback = false;\n\t\t\t}\n\t\t});\n\t};\n\n\t/**\n\t * Replaces a range with the provided text.\n\t *\n\t * @param start - The inclusive start of the range to replace\n\t * @param end - The exclusive end of the range to replace\n\t * @param text - The text to replace the range with\n\t * @param props - Optional. The properties of the replacement text\n\t */\n\tsharedStringWithInterception.replaceText = (\n\t\tstart: number,\n\t\tend: number,\n\t\ttext: string,\n\t\tprops?: MergeTree.PropertySet,\n\t) => {\n\t\t// Wrapper methods should not be called from the interception callback as this will lead to\n\t\t// infinite recursion.\n\t\tassert(\n\t\t\texecutingCallback === false,\n\t\t\t0x0c5 /* \"Interception wrapper methods called recursively from the interception callback\" */,\n\t\t);\n\n\t\tcontext.containerRuntime.orderSequentially(() => {\n\t\t\texecutingCallback = true;\n\t\t\ttry {\n\t\t\t\tsharedString.replaceText(start, end, text, propertyInterceptionCallback(props));\n\t\t\t} finally {\n\t\t\t\texecutingCallback = false;\n\t\t\t}\n\t\t});\n\t};\n\n\t/**\n\t * Annotates the marker with the provided properties.\n\t *\n\t * @param marker - The marker to annotate\n\t * @param props - The properties to annotate the marker with\n\t */\n\tsharedStringWithInterception.annotateMarker = (\n\t\tmarker: MergeTree.Marker,\n\t\tprops: MergeTree.PropertySet,\n\t) => {\n\t\t// Wrapper methods should not be called from the interception callback as this will lead to\n\t\t// infinite recursion.\n\t\tassert(\n\t\t\texecutingCallback === false,\n\t\t\t0x0c7 /* \"Interception wrapper methods called recursively from the interception callback\" */,\n\t\t);\n\n\t\tcontext.containerRuntime.orderSequentially(() => {\n\t\t\texecutingCallback = true;\n\t\t\ttry {\n\t\t\t\tsharedString.annotateMarker(marker, propertyInterceptionCallback(props));\n\t\t\t} finally {\n\t\t\t\texecutingCallback = false;\n\t\t\t}\n\t\t});\n\t};\n\n\t/**\n\t * Annotates the range with the provided properties.\n\t *\n\t * @param start - The inclusive start position of the range to annotate\n\t * @param end - The exclusive end position of the range to annotate\n\t * @param props - The properties to annotate the range with\n\t *\n\t */\n\tsharedStringWithInterception.annotateRange = (\n\t\tstart: number,\n\t\tend: number,\n\t\tprops: MergeTree.PropertySet,\n\t) => {\n\t\t// Wrapper methods should not be called from the interception callback as this will lead to\n\t\t// infinite recursion.\n\t\tassert(\n\t\t\texecutingCallback === false,\n\t\t\t0x0c8 /* \"Interception wrapper methods called recursively from the interception callback\" */,\n\t\t);\n\n\t\tcontext.containerRuntime.orderSequentially(() => {\n\t\t\texecutingCallback = true;\n\t\t\ttry {\n\t\t\t\tsharedString.annotateRange(start, end, propertyInterceptionCallback(props));\n\t\t\t} finally {\n\t\t\t\texecutingCallback = false;\n\t\t\t}\n\t\t});\n\t};\n\n\t/**\n\t * Inserts the segment at the given position\n\t *\n\t * @param pos - The position to insert the segment at\n\t * @param segment - The segment to insert\n\t */\n\tsharedStringWithInterception.insertAtReferencePosition = (\n\t\tpos: MergeTree.ReferencePosition,\n\t\tsegment: MergeTree.TextSegment,\n\t) => {\n\t\t// Wrapper methods should not be called from the interception callback as this will lead to\n\t\t// infinite recursion.\n\t\tassert(\n\t\t\texecutingCallback === false,\n\t\t\t0x0c9 /* \"Interception wrapper methods called recursively from the interception callback\" */,\n\t\t);\n\n\t\tcontext.containerRuntime.orderSequentially(() => {\n\t\t\texecutingCallback = true;\n\t\t\ttry {\n\t\t\t\tsegment.properties = propertyInterceptionCallback(segment.properties);\n\t\t\t\tsharedString.insertAtReferencePosition(pos, segment);\n\t\t\t} finally {\n\t\t\t\texecutingCallback = false;\n\t\t\t}\n\t\t});\n\t};\n\n\treturn sharedStringWithInterception as SharedString;\n}\n"]}

package/dist/tsdoc-metadata.json

@@ -0,0 +1,11 @@
+// This file is read by tools that parse documentation comments conforming to the TSDoc standard.
+// It should be published with your NPM package.  It should not be tracked by Git.
+{
+  "tsdocVersion": "0.12",
+  "toolPackages": [
+    {
+      "packageName": "@microsoft/api-extractor",
+      "packageVersion": "7.42.3"
+    }
+  ]
+}

package/lib/dds-interceptions-alpha.d.ts

@@ -0,0 +1,13 @@
+import { IDirectory } from '@fluidframework/map';
+import { IFluidDataStoreContext } from '@fluidframework/runtime-definitions';
+import { ISharedMap } from '@fluidframework/map';
+import * as MergeTree from '@fluidframework/merge-tree';
+import { SharedString } from '@fluidframework/sequence';
+
+/* Excluded from this release type: createDirectoryWithInterception */
+
+/* Excluded from this release type: createSharedMapWithInterception */
+
+/* Excluded from this release type: createSharedStringWithInterception */
+
+export { }

package/lib/dds-interceptions-beta.d.ts

@@ -0,0 +1,19 @@
+import { IDirectory } from '@fluidframework/map';
+import { IFluidDataStoreContext } from '@fluidframework/runtime-definitions';
+import { ISharedMap } from '@fluidframework/map';
+import * as MergeTree from '@fluidframework/merge-tree';
+import { SharedString } from '@fluidframework/sequence';
+
+/* Excluded from this release type: createDirectoryWithInterception */
+
+/* Excluded from this release type: createSharedMapWithInterception */
+
+/* Excluded from this release type: createSharedStringWithInterception */
+
+/* Excluded from this release type: IDirectory */
+
+/* Excluded from this release type: IFluidDataStoreContext */
+
+/* Excluded from this release type: SharedString */
+
+export { }

package/lib/dds-interceptions-public.d.ts

@@ -0,0 +1,19 @@
+import { IDirectory } from '@fluidframework/map';
+import { IFluidDataStoreContext } from '@fluidframework/runtime-definitions';
+import { ISharedMap } from '@fluidframework/map';
+import * as MergeTree from '@fluidframework/merge-tree';
+import { SharedString } from '@fluidframework/sequence';
+
+/* Excluded from this release type: createDirectoryWithInterception */
+
+/* Excluded from this release type: createSharedMapWithInterception */
+
+/* Excluded from this release type: createSharedStringWithInterception */
+
+/* Excluded from this release type: IDirectory */
+
+/* Excluded from this release type: IFluidDataStoreContext */
+
+/* Excluded from this release type: SharedString */
+
+export { }

package/lib/dds-interceptions-untrimmed.d.ts

@@ -0,0 +1,67 @@
+import { IDirectory } from '@fluidframework/map';
+import { IFluidDataStoreContext } from '@fluidframework/runtime-definitions';
+import { ISharedMap } from '@fluidframework/map';
+import * as MergeTree from '@fluidframework/merge-tree';
+import { SharedString } from '@fluidframework/sequence';
+
+/**
+ * - Create a new object from the passed IDirectory object.
+ *
+ * - Modify the set method to call the setInterceptionCallback before calling set on the underlying object.
+ *
+ * - The setInterceptionCallback and the call to the underlying object are wrapped around an orderSequentially
+ * call to batch any operations that might happen in the callback.
+ *
+ * - Modify the sub directory methods to create / return a wrapper object that in turn intercepts the set method and
+ * calls the setInterceptionCallback.
+ *
+ * - When a sub directory is created from this directory, this directory object is passed to it which is passed into
+ * the interception callback.
+ *
+ * @param baseDirectory - The underlying object that is to be intercepted
+ * @param context - The IFluidDataStoreContext that will be used to call orderSequentially
+ * @param setInterceptionCallback - The interception callback to be called
+ *
+ * @returns A new IDirectory object that intercepts the set method and calls the setInterceptionCallback.
+ * @internal
+ */
+export declare function createDirectoryWithInterception<T extends IDirectory>(baseDirectory: T, context: IFluidDataStoreContext, setInterceptionCallback: (baseDirectory: IDirectory, subDirectory: IDirectory, key: string, value: any) => void): T;
+
+/**
+ * - Create a new object from the passed SharedMap.
+ *
+ * - Modify the set method to call the setInterceptionCallback before calling set on the underlying SharedMap.
+ *
+ * - The setInterceptionCallback and the call to the underlying SharedMap are wrapped around an
+ * orderSequentially call to batch any operations that might happen in the callback.
+ *
+ * @param sharedMap - The underlying SharedMap
+ * @param context - The IFluidDataStoreContext that will be used to call orderSequentially
+ * @param setInterceptionCallback - The interception callback to be called
+ *
+ * @returns A new SharedMap that intercepts the set method and calls the setInterceptionCallback.
+ * @internal
+ */
+export declare function createSharedMapWithInterception(sharedMap: ISharedMap, context: IFluidDataStoreContext, setInterceptionCallback: (sharedMap: ISharedMap, key: string, value: any) => void): ISharedMap;
+
+/**
+ * - Create a new object from the passed SharedString.
+ *
+ * - Modify the methods that insert / remove / annotate the properties of the SharedString to call
+ * the propertyInterceptionCallback to get new properties.
+ *
+ * - Use these new properties to call the underlying SharedString.
+ *
+ * - The propertyInterceptionCallback and the call to the underlying SharedString are wrapped around an
+ * orderSequentially call to batch any operations that might happen in the callback.
+ *
+ * @param sharedString - The underlying SharedString
+ * @param context - The IFluidDataStoreContext that will be used to call orderSequentially
+ * @param propertyInterceptionCallback - The interception callback to be called
+ *
+ * @returns A new SharedString that intercepts the methods modifying the SharedString properties.
+ * @internal
+ */
+export declare function createSharedStringWithInterception(sharedString: SharedString, context: IFluidDataStoreContext, propertyInterceptionCallback: (props?: MergeTree.PropertySet) => MergeTree.PropertySet): SharedString;
+
+export { }

package/lib/index.d.ts

@@ -0,0 +1,7 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+export { createDirectoryWithInterception, createSharedMapWithInterception } from "./map/index.js";
+export { createSharedStringWithInterception } from "./sequence/index.js";
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,+BAA+B,EAAE,+BAA+B,EAAE,MAAM,gBAAgB,CAAC;AAClG,OAAO,EAAE,kCAAkC,EAAE,MAAM,qBAAqB,CAAC"}

package/lib/index.js

@@ -0,0 +1,7 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+export { createDirectoryWithInterception, createSharedMapWithInterception } from "./map/index.js";
+export { createSharedStringWithInterception } from "./sequence/index.js";
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,+BAA+B,EAAE,+BAA+B,EAAE,MAAM,gBAAgB,CAAC;AAClG,OAAO,EAAE,kCAAkC,EAAE,MAAM,qBAAqB,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nexport { createDirectoryWithInterception, createSharedMapWithInterception } from \"./map/index.js\";\nexport { createSharedStringWithInterception } from \"./sequence/index.js\";\n"]}

package/lib/map/index.d.ts

@@ -0,0 +1,7 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+export { createDirectoryWithInterception } from "./sharedDirectoryWithInterception.js";
+export { createSharedMapWithInterception } from "./sharedMapWithInterception.js";
+//# sourceMappingURL=index.d.ts.map

package/lib/map/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/map/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC;AACvF,OAAO,EAAE,+BAA+B,EAAE,MAAM,gCAAgC,CAAC"}

package/lib/map/index.js

@@ -0,0 +1,7 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+export { createDirectoryWithInterception } from "./sharedDirectoryWithInterception.js";
+export { createSharedMapWithInterception } from "./sharedMapWithInterception.js";
+//# sourceMappingURL=index.js.map

package/lib/map/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/map/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC;AACvF,OAAO,EAAE,+BAA+B,EAAE,MAAM,gCAAgC,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nexport { createDirectoryWithInterception } from \"./sharedDirectoryWithInterception.js\";\nexport { createSharedMapWithInterception } from \"./sharedMapWithInterception.js\";\n"]}

package/lib/map/sharedDirectoryWithInterception.d.ts

@@ -0,0 +1,29 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { IDirectory } from "@fluidframework/map";
+import { IFluidDataStoreContext } from "@fluidframework/runtime-definitions";
+/**
+ * - Create a new object from the passed IDirectory object.
+ *
+ * - Modify the set method to call the setInterceptionCallback before calling set on the underlying object.
+ *
+ * - The setInterceptionCallback and the call to the underlying object are wrapped around an orderSequentially
+ * call to batch any operations that might happen in the callback.
+ *
+ * - Modify the sub directory methods to create / return a wrapper object that in turn intercepts the set method and
+ * calls the setInterceptionCallback.
+ *
+ * - When a sub directory is created from this directory, this directory object is passed to it which is passed into
+ * the interception callback.
+ *
+ * @param baseDirectory - The underlying object that is to be intercepted
+ * @param context - The IFluidDataStoreContext that will be used to call orderSequentially
+ * @param setInterceptionCallback - The interception callback to be called
+ *
+ * @returns A new IDirectory object that intercepts the set method and calls the setInterceptionCallback.
+ * @internal
+ */
+export declare function createDirectoryWithInterception<T extends IDirectory>(baseDirectory: T, context: IFluidDataStoreContext, setInterceptionCallback: (baseDirectory: IDirectory, subDirectory: IDirectory, key: string, value: any) => void): T;
+//# sourceMappingURL=sharedDirectoryWithInterception.d.ts.map

package/lib/map/sharedDirectoryWithInterception.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sharedDirectoryWithInterception.d.ts","sourceRoot":"","sources":["../../src/map/sharedDirectoryWithInterception.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AA+H7E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,+BAA+B,CAAC,CAAC,SAAS,UAAU,EACnE,aAAa,EAAE,CAAC,EAChB,OAAO,EAAE,sBAAsB,EAC/B,uBAAuB,EAAE,CACxB,aAAa,EAAE,UAAU,EACzB,YAAY,EAAE,UAAU,EACxB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,GAAG,KACN,IAAI,GACP,CAAC,CAOH"}