@fluidframework/driver-utils 2.0.0-internal.3.4.2 → 2.0.0-internal.4.0.1

package/src/multiDocumentServiceFactory.ts

@@ -1,109 +0,0 @@
-/*!
- * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
- * Licensed under the MIT License.
- */
-
-import { parse } from "url";
-import {
-	IDocumentServiceFactory,
-	IResolvedUrl,
-	IDocumentService,
-} from "@fluidframework/driver-definitions";
-import { ISummaryTree } from "@fluidframework/protocol-definitions";
-import { ITelemetryBaseLogger } from "@fluidframework/common-definitions";
-import { ensureFluidResolvedUrl } from "./fluidResolvedUrl";
-
-/**
- * @deprecated 2.0.0-internal.3.2.0 Not recommended for general purpose use.
- */
-export class MultiDocumentServiceFactory implements IDocumentServiceFactory {
-	/**
-	 * @deprecated 2.0.0-internal.3.2.0 Not recommended for general purpose use.
-	 */
-	public static create(
-		documentServiceFactory: IDocumentServiceFactory | IDocumentServiceFactory[],
-	) {
-		if (Array.isArray(documentServiceFactory)) {
-			const factories: IDocumentServiceFactory[] = [];
-			documentServiceFactory.forEach((factory) => {
-				const maybeMulti = factory as MultiDocumentServiceFactory;
-				if (maybeMulti.protocolToDocumentFactoryMap !== undefined) {
-					factories.push(...maybeMulti.protocolToDocumentFactoryMap.values());
-				} else {
-					factories.push(factory);
-				}
-			});
-			if (factories.length === 1) {
-				return factories[0];
-			}
-			return new MultiDocumentServiceFactory(factories);
-		}
-		return documentServiceFactory;
-	}
-
-	private readonly protocolToDocumentFactoryMap: Map<string, IDocumentServiceFactory>;
-
-	/**
-	 * @deprecated 2.0.0-internal.3.2.0 Not recommended for general purpose use.
-	 */
-	constructor(documentServiceFactories: IDocumentServiceFactory[]) {
-		this.protocolToDocumentFactoryMap = new Map();
-		documentServiceFactories.forEach((factory: IDocumentServiceFactory) => {
-			this.protocolToDocumentFactoryMap.set(factory.protocolName, factory);
-		});
-	}
-	/**
-	 * @deprecated 2.0.0-internal.3.2.0 Not recommended for general purpose use.
-	 */
-	public readonly protocolName = "none:";
-	/**
-	 * @deprecated 2.0.0-internal.3.2.0 Not recommended for general purpose use.
-	 */
-	async createDocumentService(
-		resolvedUrl: IResolvedUrl,
-		logger?: ITelemetryBaseLogger,
-		clientIsSummarizer?: boolean,
-	): Promise<IDocumentService> {
-		ensureFluidResolvedUrl(resolvedUrl);
-		const urlObj = parse(resolvedUrl.url);
-		if (urlObj.protocol === undefined || urlObj.protocol === null) {
-			throw new Error("No protocol provided");
-		}
-		const factory: IDocumentServiceFactory | undefined = this.protocolToDocumentFactoryMap.get(
-			urlObj.protocol,
-		);
-		if (factory === undefined) {
-			throw new Error("Unknown Fluid protocol");
-		}
-
-		return factory.createDocumentService(resolvedUrl, logger, clientIsSummarizer);
-	}
-
-	/**
-	 * @deprecated 2.0.0-internal.3.2.0 Not recommended for general purpose use.
-	 */
-	public async createContainer(
-		createNewSummary: ISummaryTree,
-		createNewResolvedUrl: IResolvedUrl,
-		logger?: ITelemetryBaseLogger,
-		clientIsSummarizer?: boolean,
-	): Promise<IDocumentService> {
-		ensureFluidResolvedUrl(createNewResolvedUrl);
-		const urlObj = parse(createNewResolvedUrl.url);
-		if (urlObj.protocol === undefined || urlObj.protocol === null) {
-			throw new Error("No protocol provided");
-		}
-		const factory: IDocumentServiceFactory | undefined = this.protocolToDocumentFactoryMap.get(
-			urlObj.protocol,
-		);
-		if (factory === undefined) {
-			throw new Error("Unknown Fluid protocol");
-		}
-		return factory.createContainer(
-			createNewSummary,
-			createNewResolvedUrl,
-			logger,
-			clientIsSummarizer,
-		);
-	}
-}

package/src/multiUrlResolver.ts

@@ -1,62 +0,0 @@
-/*!
- * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
- * Licensed under the MIT License.
- */
-
-import { IRequest } from "@fluidframework/core-interfaces";
-import { IResolvedUrl, IUrlResolver } from "@fluidframework/driver-definitions";
-
-/**
- * Resolver that takes a list of url resolvers and then try each of them to resolve the url.
- * @param resolversList - List of url resolvers to be used to resolve the request.
- * @param request - Request to be resolved.
- *
- * @deprecated 2.0.0-internal.3.2.0 Not recommended for general purpose use.
- */
-export async function configurableUrlResolver(
-	resolversList: IUrlResolver[],
-	request: IRequest,
-): Promise<IResolvedUrl | undefined> {
-	let resolved: IResolvedUrl | undefined;
-	for (const resolver of resolversList) {
-		resolved = await resolver.resolve({ ...request });
-		if (resolved !== undefined) {
-			return resolved;
-		}
-	}
-	return undefined;
-}
-
-/**
- * @deprecated 2.0.0-internal.3.2.0 Not recommended for general purpose use.
- */
-export class MultiUrlResolver implements IUrlResolver {
-	/**
-	 * @deprecated 2.0.0-internal.3.2.0 Not recommended for general purpose use.
-	 */
-	public static create(urlResolver: IUrlResolver | IUrlResolver[]) {
-		if (Array.isArray(urlResolver)) {
-			if (urlResolver.length === 1) {
-				return urlResolver[0];
-			}
-			return new MultiUrlResolver(urlResolver);
-		}
-		return urlResolver;
-	}
-
-	private constructor(private readonly urlResolvers: IUrlResolver[]) {}
-
-	/**
-	 * @deprecated 2.0.0-internal.3.2.0 Not recommended for general purpose use.
-	 */
-	async resolve(request: IRequest): Promise<IResolvedUrl | undefined> {
-		return configurableUrlResolver(this.urlResolvers, request);
-	}
-
-	/**
-	 * @deprecated 2.0.0-internal.3.2.0 Not recommended for general purpose use.
-	 */
-	public async getAbsoluteUrl(resolvedUrl: IResolvedUrl, relativeUrl: string): Promise<string> {
-		throw new Error("Not implmented");
-	}
-}

package/src/treeUtils.ts

@@ -1,128 +0,0 @@
-/*!
- * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
- * Licensed under the MIT License.
- */
-
-import { assert, IsoBuffer } from "@fluidframework/common-utils";
-import {
-	SummaryType,
-	ISnapshotTree,
-	ISummaryTree,
-	SummaryObject,
-} from "@fluidframework/protocol-definitions";
-
-/**
- * Summary tree assembler props
- *
- * @deprecated 2.0.0-internal.3.2.0 Not recommended for general purpose use.
- */
-export interface ISummaryTreeAssemblerProps {
-	/**
-	 * Indicates that this tree is unreferenced. If this is not present, the tree is considered referenced.
-	 *
-	 * @deprecated 2.0.0-internal.3.2.0 Not recommended for general purpose use.
-	 */
-	unreferenced?: true;
-}
-
-/**
- * Summary tree assembler (without stats collection).
- *
- * @deprecated 2.0.0-internal.3.2.0 Not recommended for general purpose use.
- */
-export class SummaryTreeAssembler {
-	private attachmentCounter: number = 0;
-	private readonly summaryTree: { [path: string]: SummaryObject } = {};
-
-	/**
-	 * @deprecated 2.0.0-internal.3.2.0 Not recommended for general purpose use.
-	 */
-	constructor(private readonly props?: ISummaryTreeAssemblerProps) {}
-
-	/**
-	 * Get final summary
-	 *
-	 * @deprecated 2.0.0-internal.3.2.0 Not recommended for general purpose use.
-	 */
-	public get summary(): ISummaryTree {
-		return {
-			type: SummaryType.Tree,
-			tree: { ...this.summaryTree },
-			unreferenced: this.props?.unreferenced,
-		};
-	}
-
-	/**
-	 * Add blob to summary
-	 *
-	 * @deprecated 2.0.0-internal.3.2.0 Not recommended for general purpose use.
-	 */
-	public addBlob(key: string, content: string | Uint8Array): void {
-		this.summaryTree[key] = {
-			type: SummaryType.Blob,
-			content,
-		};
-	}
-
-	/**
-	 * Add handle to summary
-	 *
-	 * @deprecated 2.0.0-internal.3.2.0 Not recommended for general purpose use.
-	 */
-	public addHandle(
-		key: string,
-		handleType: SummaryType.Tree | SummaryType.Blob | SummaryType.Attachment,
-		handle: string,
-	): void {
-		this.summaryTree[key] = {
-			type: SummaryType.Handle,
-			handleType,
-			handle,
-		};
-	}
-
-	/**
-	 * Add tree to summary
-	 *
-	 * @deprecated 2.0.0-internal.3.2.0 Not recommended for general purpose use.
-	 */
-	public addTree(key: string, summary: ISummaryTree): void {
-		this.summaryTree[key] = summary;
-	}
-
-	/**
-	 * Add attachment to summary
-	 *
-	 * @deprecated 2.0.0-internal.3.2.0 Not recommended for general purpose use.
-	 */
-	public addAttachment(id: string) {
-		this.summaryTree[this.attachmentCounter++] = { id, type: SummaryType.Attachment };
-	}
-}
-
-/**
- * Helper function that converts ISnapshotTree and blobs to ISummaryTree
- * @param snapshot - Source snapshot tree
- * @param blobs - Blobs cache
- * @returns Converted snapshot in ISummaryTree format
- *
- * @deprecated 2.0.0-internal.3.2.0 Not recommended for general purpose use.
- */
-export function convertSnapshotAndBlobsToSummaryTree(
-	snapshot: ISnapshotTree,
-	blobs: Map<string, ArrayBuffer>,
-): ISummaryTree {
-	const assembler = new SummaryTreeAssembler({
-		unreferenced: snapshot.unreferenced,
-	});
-	for (const [path, id] of Object.entries(snapshot.blobs)) {
-		const blob = blobs.get(id);
-		assert(blob !== undefined, 0x2dd /* "Cannot find blob for a given id" */);
-		assembler.addBlob(path, IsoBuffer.from(blob).toString("utf-8"));
-	}
-	for (const [key, tree] of Object.entries(snapshot.trees)) {
-		const subtree = convertSnapshotAndBlobsToSummaryTree(tree, blobs);
-		assembler.addTree(key, subtree);
-	}
-	return assembler.summary;
-}