@fluidframework/driver-utils 2.0.0-internal.5.1.0 → 2.0.0-internal.5.2.0

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # @fluidframework/driver-utils
 
+## 2.0.0-internal.5.2.0
+
+Dependency updates only.
+
 ## 2.0.0-internal.5.1.0
 
 Dependency updates only.

package/dist/adapters/compression/compressionTypes.d.ts

@@ -0,0 +1,17 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+export declare enum SummaryCompressionAlgorithm {
+    None = 0,
+    LZ4 = 1
+}
+export interface ICompressionStorageConfig {
+    algorithm: SummaryCompressionAlgorithm;
+    minSizeToCompress: number;
+}
+export declare const DefaultCompressionStorageConfig: {
+    algorithm: SummaryCompressionAlgorithm;
+    minSizeToCompress: number;
+};
+//# sourceMappingURL=compressionTypes.d.ts.map

package/dist/adapters/compression/compressionTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compressionTypes.d.ts","sourceRoot":"","sources":["../../../src/adapters/compression/compressionTypes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,oBAAY,2BAA2B;IACtC,IAAI,IAAI;IACR,GAAG,IAAI;CACP;AAED,MAAM,WAAW,yBAAyB;IACzC,SAAS,EAAE,2BAA2B,CAAC;IACvC,iBAAiB,EAAE,MAAM,CAAC;CAC1B;AAED,eAAO,MAAM,+BAA+B;;;CAG3C,CAAC"}

package/dist/adapters/compression/compressionTypes.js

@@ -0,0 +1,17 @@
+"use strict";
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefaultCompressionStorageConfig = exports.SummaryCompressionAlgorithm = void 0;
+var SummaryCompressionAlgorithm;
+(function (SummaryCompressionAlgorithm) {
+    SummaryCompressionAlgorithm[SummaryCompressionAlgorithm["None"] = 0] = "None";
+    SummaryCompressionAlgorithm[SummaryCompressionAlgorithm["LZ4"] = 1] = "LZ4";
+})(SummaryCompressionAlgorithm = exports.SummaryCompressionAlgorithm || (exports.SummaryCompressionAlgorithm = {}));
+exports.DefaultCompressionStorageConfig = {
+    algorithm: SummaryCompressionAlgorithm.LZ4,
+    minSizeToCompress: 500,
+};
+//# sourceMappingURL=compressionTypes.js.map

package/dist/adapters/compression/compressionTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compressionTypes.js","sourceRoot":"","sources":["../../../src/adapters/compression/compressionTypes.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,IAAY,2BAGX;AAHD,WAAY,2BAA2B;IACtC,6EAAQ,CAAA;IACR,2EAAO,CAAA;AACR,CAAC,EAHW,2BAA2B,GAA3B,mCAA2B,KAA3B,mCAA2B,QAGtC;AAOY,QAAA,+BAA+B,GAAG;IAC9C,SAAS,EAAE,2BAA2B,CAAC,GAAG;IAC1C,iBAAiB,EAAE,GAAG;CACtB,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nexport enum SummaryCompressionAlgorithm {\n\tNone = 0,\n\tLZ4 = 1,\n}\n\nexport interface ICompressionStorageConfig {\n\talgorithm: SummaryCompressionAlgorithm;\n\tminSizeToCompress: number;\n}\n\nexport const DefaultCompressionStorageConfig = {\n\talgorithm: SummaryCompressionAlgorithm.LZ4,\n\tminSizeToCompress: 500,\n};\n"]}

package/dist/adapters/compression/documentServiceCompressionAdapter.d.ts

@@ -0,0 +1,13 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { IDocumentService, IDocumentStorageService } from "@fluidframework/driver-definitions";
+import { DocumentServiceProxy } from "../../documentServiceProxy";
+import { ICompressionStorageConfig } from "./compressionTypes";
+export declare class DocumentServiceCompressionAdapter extends DocumentServiceProxy {
+    private readonly _config;
+    constructor(service: IDocumentService, _config: ICompressionStorageConfig);
+    connectToStorage(): Promise<IDocumentStorageService>;
+}
+//# sourceMappingURL=documentServiceCompressionAdapter.d.ts.map

package/dist/adapters/compression/documentServiceCompressionAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentServiceCompressionAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/compression/documentServiceCompressionAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAC/F,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAElE,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAE/D,qBAAa,iCAAkC,SAAQ,oBAAoB;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAnD,OAAO,EAAE,gBAAgB,EAAmB,OAAO,EAAE,yBAAyB;IAI7E,gBAAgB,IAAI,OAAO,CAAC,uBAAuB,CAAC;CASjE"}

package/dist/adapters/compression/documentServiceCompressionAdapter.js

@@ -0,0 +1,23 @@
+"use strict";
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DocumentServiceCompressionAdapter = void 0;
+const documentServiceProxy_1 = require("../../documentServiceProxy");
+const summaryblob_1 = require("./summaryblob");
+class DocumentServiceCompressionAdapter extends documentServiceProxy_1.DocumentServiceProxy {
+    constructor(service, _config) {
+        super(service);
+        this._config = _config;
+    }
+    async connectToStorage() {
+        const storage = await super.connectToStorage();
+        const wrapped = new summaryblob_1.DocumentStorageServiceCompressionAdapter(storage, this._config);
+        await wrapped.getSnapshotTree();
+        return wrapped;
+    }
+}
+exports.DocumentServiceCompressionAdapter = DocumentServiceCompressionAdapter;
+//# sourceMappingURL=documentServiceCompressionAdapter.js.map

package/dist/adapters/compression/documentServiceCompressionAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentServiceCompressionAdapter.js","sourceRoot":"","sources":["../../../src/adapters/compression/documentServiceCompressionAdapter.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAGH,qEAAkE;AAClE,+CAAgI;AAGhI,MAAa,iCAAkC,SAAQ,2CAAoB;IAC1E,YAAY,OAAyB,EAAmB,OAAkC;QACzF,KAAK,CAAC,OAAO,CAAC,CAAC;QADwC,YAAO,GAAP,OAAO,CAA2B;IAE1F,CAAC;IAEM,KAAK,CAAC,gBAAgB;QAC5B,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,gBAAgB,EAAE,CAAC;QAC/C,MAAM,OAAO,GAAG,IAAI,sDAAmD,CACtE,OAAO,EACP,IAAI,CAAC,OAAO,CACZ,CAAC;QACF,MAAM,OAAO,CAAC,eAAe,EAAE,CAAC;QAChC,OAAO,OAAO,CAAC;IAChB,CAAC;CACD;AAdD,8EAcC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { IDocumentService, IDocumentStorageService } from \"@fluidframework/driver-definitions\";\nimport { DocumentServiceProxy } from \"../../documentServiceProxy\";\nimport { DocumentStorageServiceCompressionAdapter as DocumentStorageServiceSummaryBlobCompressionAdapter } from \"./summaryblob\";\nimport { ICompressionStorageConfig } from \"./compressionTypes\";\n\nexport class DocumentServiceCompressionAdapter extends DocumentServiceProxy {\n\tconstructor(service: IDocumentService, private readonly _config: ICompressionStorageConfig) {\n\t\tsuper(service);\n\t}\n\n\tpublic async connectToStorage(): Promise<IDocumentStorageService> {\n\t\tconst storage = await super.connectToStorage();\n\t\tconst wrapped = new DocumentStorageServiceSummaryBlobCompressionAdapter(\n\t\t\tstorage,\n\t\t\tthis._config,\n\t\t);\n\t\tawait wrapped.getSnapshotTree();\n\t\treturn wrapped;\n\t}\n}\n"]}

package/dist/adapters/compression/documentServiceFactoryCompressionAdapter.d.ts

@@ -0,0 +1,16 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { ITelemetryBaseLogger } from "@fluidframework/common-definitions";
+import { IDocumentService, IDocumentServiceFactory, IResolvedUrl } from "@fluidframework/driver-definitions";
+import { ISummaryTree } from "@fluidframework/protocol-definitions";
+import { DocumentServiceFactoryProxy } from "../../documentServiceFactoryProxy";
+import { ICompressionStorageConfig } from "..";
+export declare class DocumentServiceFactoryCompressionAdapter extends DocumentServiceFactoryProxy {
+    private readonly _config;
+    constructor(serviceFactory: IDocumentServiceFactory, _config: ICompressionStorageConfig);
+    createContainer(createNewSummary: ISummaryTree | undefined, createNewResolvedUrl: IResolvedUrl, logger?: ITelemetryBaseLogger, clientIsSummarizer?: boolean): Promise<IDocumentService>;
+    createDocumentService(resolvedUrl: IResolvedUrl): Promise<IDocumentService>;
+}
+//# sourceMappingURL=documentServiceFactoryCompressionAdapter.d.ts.map

package/dist/adapters/compression/documentServiceFactoryCompressionAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentServiceFactoryCompressionAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/compression/documentServiceFactoryCompressionAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EACN,gBAAgB,EAChB,uBAAuB,EACvB,YAAY,EACZ,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACpE,OAAO,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AAChF,OAAO,EAAE,yBAAyB,EAAE,MAAM,IAAI,CAAC;AAI/C,qBAAa,wCAAyC,SAAQ,2BAA2B;IAGvF,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADxB,cAAc,EAAE,uBAAuB,EACtB,OAAO,EAAE,yBAAyB;IAKvC,eAAe,CAC3B,gBAAgB,EAAE,YAAY,GAAG,SAAS,EAC1C,oBAAoB,EAAE,YAAY,EAClC,MAAM,CAAC,EAAE,oBAAoB,EAC7B,kBAAkB,CAAC,EAAE,OAAO,GAC1B,OAAO,CAAC,gBAAgB,CAAC;IA2Bf,qBAAqB,CAAC,WAAW,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAIxF"}

package/dist/adapters/compression/documentServiceFactoryCompressionAdapter.js

@@ -0,0 +1,36 @@
+"use strict";
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DocumentServiceFactoryCompressionAdapter = void 0;
+const documentServiceFactoryProxy_1 = require("../../documentServiceFactoryProxy");
+const summaryblob_1 = require("./summaryblob");
+const documentServiceCompressionAdapter_1 = require("./documentServiceCompressionAdapter");
+class DocumentServiceFactoryCompressionAdapter extends documentServiceFactoryProxy_1.DocumentServiceFactoryProxy {
+    constructor(serviceFactory, _config) {
+        super(serviceFactory);
+        this._config = _config;
+    }
+    async createContainer(createNewSummary, createNewResolvedUrl, logger, clientIsSummarizer) {
+        if (createNewSummary !== undefined) {
+            // TODO : this is a hack to make sure that the initial summary is not compressed
+            // We must prevent the initial summary from being compressed because
+            // of the hack at packages/drivers/routerlicious-driver/src/createNewUtils.ts
+            // where the binary blob is converted to a string using UTF-8 encoding
+            // which is producing incorrect results for compressed data.
+            const configForInitial = Object.assign(Object.assign({}, this._config), { minSizeToCompress: Number.POSITIVE_INFINITY });
+            const newAppSumary = summaryblob_1.DocumentStorageServiceCompressionAdapter.compressSummary(createNewSummary.tree[".app"], configForInitial);
+            createNewSummary.tree[".app"] = newAppSumary;
+        }
+        const service = await this.serviceFactory.createContainer(createNewSummary, createNewResolvedUrl, logger, clientIsSummarizer);
+        return new documentServiceCompressionAdapter_1.DocumentServiceCompressionAdapter(service, this._config);
+    }
+    async createDocumentService(resolvedUrl) {
+        const service = await this.serviceFactory.createDocumentService(resolvedUrl);
+        return new documentServiceCompressionAdapter_1.DocumentServiceCompressionAdapter(service, this._config);
+    }
+}
+exports.DocumentServiceFactoryCompressionAdapter = DocumentServiceFactoryCompressionAdapter;
+//# sourceMappingURL=documentServiceFactoryCompressionAdapter.js.map

package/dist/adapters/compression/documentServiceFactoryCompressionAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentServiceFactoryCompressionAdapter.js","sourceRoot":"","sources":["../../../src/adapters/compression/documentServiceFactoryCompressionAdapter.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AASH,mFAAgF;AAEhF,+CAAgI;AAChI,2FAAwF;AAExF,MAAa,wCAAyC,SAAQ,yDAA2B;IACxF,YACC,cAAuC,EACtB,OAAkC;QAEnD,KAAK,CAAC,cAAc,CAAC,CAAC;QAFL,YAAO,GAAP,OAAO,CAA2B;IAGpD,CAAC;IAEM,KAAK,CAAC,eAAe,CAC3B,gBAA0C,EAC1C,oBAAkC,EAClC,MAA6B,EAC7B,kBAA4B;QAE5B,IAAI,gBAAgB,KAAK,SAAS,EAAE;YACnC,gFAAgF;YAChF,oEAAoE;YACpE,6EAA6E;YAC7E,sEAAsE;YACtE,4DAA4D;YAC5D,MAAM,gBAAgB,mCAClB,IAAI,CAAC,OAAO,KACf,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,GAC3C,CAAC;YACF,MAAM,YAAY,GACjB,sDAAmD,CAAC,eAAe,CAClE,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAiB,EAC7C,gBAAgB,CAChB,CAAC;YACH,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,YAAY,CAAC;SAC7C;QACD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,eAAe,CACxD,gBAAgB,EAChB,oBAAoB,EACpB,MAAM,EACN,kBAAkB,CAClB,CAAC;QACF,OAAO,IAAI,qEAAiC,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACrE,CAAC;IAEM,KAAK,CAAC,qBAAqB,CAAC,WAAyB;QAC3D,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,qBAAqB,CAAC,WAAW,CAAC,CAAC;QAC7E,OAAO,IAAI,qEAAiC,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACrE,CAAC;CACD;AA5CD,4FA4CC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { ITelemetryBaseLogger } from \"@fluidframework/common-definitions\";\nimport {\n\tIDocumentService,\n\tIDocumentServiceFactory,\n\tIResolvedUrl,\n} from \"@fluidframework/driver-definitions\";\nimport { ISummaryTree } from \"@fluidframework/protocol-definitions\";\nimport { DocumentServiceFactoryProxy } from \"../../documentServiceFactoryProxy\";\nimport { ICompressionStorageConfig } from \"..\";\nimport { DocumentStorageServiceCompressionAdapter as DocumentStorageServiceSummaryBlobCompressionAdapter } from \"./summaryblob\";\nimport { DocumentServiceCompressionAdapter } from \"./documentServiceCompressionAdapter\";\n\nexport class DocumentServiceFactoryCompressionAdapter extends DocumentServiceFactoryProxy {\n\tconstructor(\n\t\tserviceFactory: IDocumentServiceFactory,\n\t\tprivate readonly _config: ICompressionStorageConfig,\n\t) {\n\t\tsuper(serviceFactory);\n\t}\n\n\tpublic async createContainer(\n\t\tcreateNewSummary: ISummaryTree | undefined,\n\t\tcreateNewResolvedUrl: IResolvedUrl,\n\t\tlogger?: ITelemetryBaseLogger,\n\t\tclientIsSummarizer?: boolean,\n\t): Promise<IDocumentService> {\n\t\tif (createNewSummary !== undefined) {\n\t\t\t// TODO : this is a hack to make sure that the initial summary is not compressed\n\t\t\t// We must prevent the initial summary from being compressed because\n\t\t\t// of the hack at packages/drivers/routerlicious-driver/src/createNewUtils.ts\n\t\t\t// where the binary blob is converted to a string using UTF-8 encoding\n\t\t\t// which is producing incorrect results for compressed data.\n\t\t\tconst configForInitial = {\n\t\t\t\t...this._config,\n\t\t\t\tminSizeToCompress: Number.POSITIVE_INFINITY,\n\t\t\t};\n\t\t\tconst newAppSumary =\n\t\t\t\tDocumentStorageServiceSummaryBlobCompressionAdapter.compressSummary(\n\t\t\t\t\tcreateNewSummary.tree[\".app\"] as ISummaryTree,\n\t\t\t\t\tconfigForInitial,\n\t\t\t\t);\n\t\t\tcreateNewSummary.tree[\".app\"] = newAppSumary;\n\t\t}\n\t\tconst service = await this.serviceFactory.createContainer(\n\t\t\tcreateNewSummary,\n\t\t\tcreateNewResolvedUrl,\n\t\t\tlogger,\n\t\t\tclientIsSummarizer,\n\t\t);\n\t\treturn new DocumentServiceCompressionAdapter(service, this._config);\n\t}\n\n\tpublic async createDocumentService(resolvedUrl: IResolvedUrl): Promise<IDocumentService> {\n\t\tconst service = await this.serviceFactory.createDocumentService(resolvedUrl);\n\t\treturn new DocumentServiceCompressionAdapter(service, this._config);\n\t}\n}\n"]}

package/dist/adapters/compression/index.d.ts

@@ -0,0 +1,8 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+export { SummaryCompressionAlgorithm, ICompressionStorageConfig, DefaultCompressionStorageConfig, } from "./compressionTypes";
+export { DocumentServiceFactoryCompressionAdapter } from "./documentServiceFactoryCompressionAdapter";
+export { blobHeadersBlobName } from "./summaryblob";
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/compression/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/compression/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACN,2BAA2B,EAC3B,yBAAyB,EACzB,+BAA+B,GAC/B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,wCAAwC,EAAE,MAAM,4CAA4C,CAAC;AACtG,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC"}

package/dist/adapters/compression/index.js

@@ -0,0 +1,15 @@
+"use strict";
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.blobHeadersBlobName = exports.DocumentServiceFactoryCompressionAdapter = exports.DefaultCompressionStorageConfig = exports.SummaryCompressionAlgorithm = void 0;
+var compressionTypes_1 = require("./compressionTypes");
+Object.defineProperty(exports, "SummaryCompressionAlgorithm", { enumerable: true, get: function () { return compressionTypes_1.SummaryCompressionAlgorithm; } });
+Object.defineProperty(exports, "DefaultCompressionStorageConfig", { enumerable: true, get: function () { return compressionTypes_1.DefaultCompressionStorageConfig; } });
+var documentServiceFactoryCompressionAdapter_1 = require("./documentServiceFactoryCompressionAdapter");
+Object.defineProperty(exports, "DocumentServiceFactoryCompressionAdapter", { enumerable: true, get: function () { return documentServiceFactoryCompressionAdapter_1.DocumentServiceFactoryCompressionAdapter; } });
+var summaryblob_1 = require("./summaryblob");
+Object.defineProperty(exports, "blobHeadersBlobName", { enumerable: true, get: function () { return summaryblob_1.blobHeadersBlobName; } });
+//# sourceMappingURL=index.js.map

package/dist/adapters/compression/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/compression/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,uDAI4B;AAH3B,+HAAA,2BAA2B,OAAA;AAE3B,mIAAA,+BAA+B,OAAA;AAEhC,uGAAsG;AAA7F,oKAAA,wCAAwC,OAAA;AACjD,6CAAoD;AAA3C,kHAAA,mBAAmB,OAAA","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nexport {\n\tSummaryCompressionAlgorithm,\n\tICompressionStorageConfig,\n\tDefaultCompressionStorageConfig,\n} from \"./compressionTypes\";\nexport { DocumentServiceFactoryCompressionAdapter } from \"./documentServiceFactoryCompressionAdapter\";\nexport { blobHeadersBlobName } from \"./summaryblob\";\n"]}

package/dist/adapters/compression/summaryblob/documentStorageServiceSummaryBlobCompressionAdapter.d.ts

@@ -0,0 +1,161 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { IDocumentStorageService, ISummaryContext } from "@fluidframework/driver-definitions";
+import { ISnapshotTree, ISummaryHandle, ISummaryTree, IVersion } from "@fluidframework/protocol-definitions";
+import { DocumentStorageServiceProxy } from "../../../documentStorageServiceProxy";
+import { ICompressionStorageConfig } from "../";
+export declare const blobHeadersBlobName = ".metadata.blobHeaders";
+/**
+ * This class is a proxy for the IDocumentStorageService that compresses and decompresses blobs in the summary.
+ * The identification of the compressed blobs is done by adding a compression markup blob to the summary.
+ * Even if the markup blob is present, it does not mean that all blobs are compressed. The blob,
+ * which is compressed also contain the compression algorithm enumerated value from the
+ * SummaryCompressionAlgorithm enumeration in the first byte . If the blob is not
+ * commpressed, it contains the first byte equals to SummaryCompressionAlgorithm.None .
+ * In case, the markup blob is present, it is expected that the first byte of the markup blob
+ * will contain the info about the compression. If the first byte is not present, it is assumed
+ * that the compression is not enabled and no first prefix byte is present in the blobs.
+ */
+export declare class DocumentStorageServiceCompressionAdapter extends DocumentStorageServiceProxy {
+    private readonly _config;
+    private _isCompressionEnabled;
+    constructor(service: IDocumentStorageService, _config: ICompressionStorageConfig);
+    get service(): IDocumentStorageService;
+    /**
+     * This method returns true if there is a compression markup byte in the blob, otherwise false.
+     * @param blob - The blob to compress.
+     * @returns - True if there is a compression markup byte in the blob, otherwise false.
+     */
+    private static hasPrefix;
+    /**
+     * This method reads the first byte from the given blob and maps that byte to the compression algorithm.
+     * @param blob - The maybe compressed blob.
+     */
+    private static readAlgorithmFromBlob;
+    /**
+     * This method writes the given algorithm to the blob as the first byte.
+     * @param blob - The blob to write the algorithm to.
+     * @param algorithm - The algorithm to write.
+     * @returns - The blob with the algorithm as the first byte.
+     */
+    private static writeAlgorithmToBlob;
+    /**
+     * This method removes the algorithm markup prefix from the blob (1 byte)
+     * @param blob - The blob to remove the prefix from.
+     * @returns - The blob without the prefix.
+     */
+    private static removePrefixFromBlobIfPresent;
+    /**
+     * This method converts the given argument to Uint8Array. If the parameter is already Uint8Array,
+     * it is just returned as is. If the parameter is string, it is converted to Uint8Array using
+     * TextEncoder.
+     * @param input - The input to convert to Uint8Array.
+     * @returns - The Uint8Array representation of the input.
+     */
+    private static toBinaryArray;
+    /**
+     * This method encodes the blob inside the given summary object of the SummaryType.Blob type using the given config
+     * containing  the compression algorithm.
+     * @param input - The summary object to encode.
+     * @param config - The config containing the compression algorithm.
+     * @returns - The summary object with the encoded blob.
+     */
+    private static readonly blobEncoder;
+    /**
+     * This method decodes the blob inside the given summary object of the SummaryType.Blob type.
+     * @param input - The summary object to decode.
+     * @returns - The summary object with the decoded blob.
+     */
+    private static readonly blobDecoder;
+    /**
+     * This method encodes the given blob according to the given config.
+     * @param file - The blob to encode.
+     * @param config - The config to use for encoding.
+     * @returns - The encoded blob.
+     */
+    private static encodeBlob;
+    /**
+     * This method decodes the given blob.
+     * @param file - The blob to decode.
+     * @returns - The decoded blob.
+     */
+    private static decodeBlob;
+    /**
+     * This method traverses the SummaryObject recursively. If it finds the ISummaryBlob object,
+     * it applies encoding/decoding on it according to the given isEncode flag.
+     * @param isEncode - True if the encoding should be applied, false if the decoding should be applied.
+     * @param input - The summary object to traverse.
+     * @param encoder - The encoder function to use.
+     * @param decoder - The decoder function to use.
+     * @param config - The config to use for encoding.
+     * @param context - The summary context.
+     * @returns - The summary object with the encoded/decoded blob.
+     */
+    private static recursivelyReplace;
+    /**
+     * This method traverses the SummaryTree recursively. If it finds the ISummaryBlob object with the key '.metadata',
+     * it returns the summary tree containing that blob.
+     *
+     * @param summary - The summary tree to traverse.
+     * @returns - The summary tree containing the metadata blob.
+     */
+    private static findMetadataHolderSummary;
+    /**
+     * This method obtains the summary tree containing the metadata blob. It returns the content
+     * of the tree atribute.
+     * @param summary - The summary tree to traverse.
+     * @returns - The content of the tree attribute of the summary tree containing the metadata blob.
+     */
+    private static getMetadataHolderTree;
+    /**
+     * This method adds the compression markup blob to the nested summary tree containing the metadata blob.
+     * @param summary - The top summary tree to put the compression markup blob into.
+     */
+    private static putCompressionMarkup;
+    /**
+     * This method traverses the SnapshotTree recursively. If it finds the ISummaryBlob object with the key '.metadata',
+     * it checks, if the SummaryTree holder of that object also contains the compression markup blob. If it is found,
+     * it returns true, otherwise false.
+     * @param snapshot - The snapshot tree to traverse.
+     * @returns - True if the compression markup blob is found, otherwise false.
+     */
+    private static hasCompressionMarkup;
+    /**
+     * This method performs compression of the blobs in the summary tree.
+     * @param summary - The summary tree to compress.
+     * @param config - The compression config.
+     * @returns - The compressed summary tree.
+     */
+    static compressSummary(summary: ISummaryTree, config: ICompressionStorageConfig): ISummaryTree;
+    /**
+     * This method read blob from the storage and decompresses it if it is compressed.
+     * @param id - The id of the blob to read.
+     * @returns - The decompressed blob.
+     */
+    readBlob(id: string): Promise<ArrayBufferLike>;
+    /**
+     * This method loads the snapshot tree from the server. It also checks, if the compression markup blob is present
+     * and setups the compression flag accordingly. It also identifies the blobs that are not compressed and do not contain
+     * algorithm byte prefix and store them.
+     * @param version - The version of the snapshot tree to load.
+     * @param scenarioName - The scenario name of the snapshot tree to load.
+     * @returns - The snapshot tree.
+     */
+    getSnapshotTree(version?: IVersion | undefined, scenarioName?: string | undefined): Promise<ISnapshotTree | null>;
+    /**
+     * This method uploads the summary to the storage. It performs compression of the blobs in the summary tree.
+     * @param summary - The summary tree to upload.
+     * @param context - The summary context.
+     * @returns - The ID of the uploaded summary.
+     */
+    uploadSummaryWithContext(summary: ISummaryTree, context: ISummaryContext): Promise<string>;
+    /**
+     * This method downloads the summary from the storage and then applies decompression on the compressed blobs.
+     * @param id - The ID of the summary to be downloaded
+     * @returns - The summary with decompressed blobs
+     */
+    downloadSummary(id: ISummaryHandle): Promise<ISummaryTree>;
+}
+//# sourceMappingURL=documentStorageServiceSummaryBlobCompressionAdapter.d.ts.map

package/dist/adapters/compression/summaryblob/documentStorageServiceSummaryBlobCompressionAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentStorageServiceSummaryBlobCompressionAdapter.d.ts","sourceRoot":"","sources":["../../../../src/adapters/compression/summaryblob/documentStorageServiceSummaryBlobCompressionAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC9F,OAAO,EACN,aAAa,EAEb,cAAc,EACd,YAAY,EACZ,QAAQ,EAGR,MAAM,sCAAsC,CAAC;AAE9C,OAAO,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,EAAE,yBAAyB,EAA+B,MAAM,KAAK,CAAC;AAE7E,eAAO,MAAM,mBAAmB,0BAA0B,CAAC;AAG3D;;;;;;;;;;GAUG;AACH,qBAAa,wCAAyC,SAAQ,2BAA2B;IAKvF,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJzB,OAAO,CAAC,qBAAqB,CAAkB;gBAG9C,OAAO,EAAE,uBAAuB,EACf,OAAO,EAAE,yBAAyB;IAKpD,IAAW,OAAO,IAAI,uBAAuB,CAE5C;IAED;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,SAAS;IAMxB;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAOpC;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAmBnC;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,6BAA6B;IAK5C;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAI5B;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAoBjC;IAEF;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAgBjC;IAEF;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,UAAU;IAwBzB;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,UAAU;IAqBzB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAoCjC;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,yBAAyB;IAkBxC;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAOpC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IASnC;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAsBnC;;;;;OAKG;WACW,eAAe,CAC5B,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,yBAAyB,GAC/B,YAAY;IAaf;;;;OAIG;IACmB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAYpE;;;;;;;OAOG;IACmB,eAAe,CACpC,OAAO,CAAC,EAAE,QAAQ,GAAG,SAAS,EAC9B,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,GAE/B,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAShC;;;;;OAKG;IACmB,wBAAwB,CAC7C,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,eAAe,GACtB,OAAO,CAAC,MAAM,CAAC;IAQlB;;;;OAIG;IACmB,eAAe,CAAC,EAAE,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;CAYhF"}