@fluidframework/tool-utils 2.0.2 → 2.1.0-276326

package/src/odspTokenManager.ts

@@ -4,10 +4,12 @@
  */
 
 import { unreachableCase } from "@fluidframework/core-utils/internal";
-import {
+import type {
 	IPublicClientConfig,
 	IOdspTokens,
 	TokenRequestCredentials,
+} from "@fluidframework/odsp-doclib-utils/internal";
+import {
 	fetchTokens,
 	getLoginPageUrl,
 	getOdspScope,
@@ -18,18 +20,22 @@ import { Mutex } from "async-mutex";
 import { jwtDecode } from "jwt-decode";
 
 import { debug } from "./debug.js";
-import { IAsyncCache, loadRC, lockRC, saveRC } from "./fluidToolRC.js";
+import type { IAsyncCache, IResources } from "./fluidToolRc.js";
+import { loadRC, lockRC, saveRC } from "./fluidToolRc.js";
 import { endResponse, serverListenAndHandle } from "./httpHelpers.js";
 
 const odspAuthRedirectPort = 7000;
 const odspAuthRedirectOrigin = `http://localhost:${odspAuthRedirectPort}`;
 const odspAuthRedirectUri = new URL("/auth/callback", odspAuthRedirectOrigin).href;
 
+// TODO: Add documentation
+// eslint-disable-next-line jsdoc/require-description
 /**
  * @internal
  */
 export const getMicrosoftConfiguration = (): IPublicClientConfig => ({
-	get clientId() {
+	get clientId(): string {
+		// eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
 		if (!process.env.login__microsoft__clientId) {
 			throw new Error("Client ID environment variable not set: login__microsoft__clientId.");
 		}
@@ -60,18 +66,18 @@ export interface IOdspTokenManagerCacheKey {
 	readonly userOrServer: string;
 }
 
-const isValidToken = (token: string) => {
+const isValidToken = (token: string): boolean => {
 	// Return false for undefined or empty tokens.
 	if (!token || token.length === 0) {
 		return false;
 	}
 
-	const decodedToken = jwtDecode<any>(token);
+	const decodedToken = jwtDecode<{ exp: number }>(token);
 	// Give it a 60s buffer
-	return decodedToken.exp - 60 >= new Date().getTime() / 1000;
+	return decodedToken.exp - 60 >= Date.now() / 1000;
 };
 
-const cacheKeyToString = (key: IOdspTokenManagerCacheKey) => {
+const cacheKeyToString = (key: IOdspTokenManagerCacheKey): string => {
 	return `${key.userOrServer}${key.isPush ? "[Push]" : ""}`;
 };
 
@@ -82,11 +88,14 @@ export class OdspTokenManager {
 	private readonly storageCache = new Map<string, IOdspTokens>();
 	private readonly pushCache = new Map<string, IOdspTokens>();
 	private readonly cacheMutex = new Mutex();
-	constructor(
+	public constructor(
 		private readonly tokenCache?: IAsyncCache<IOdspTokenManagerCacheKey, IOdspTokens>,
 	) {}
 
-	public async updateTokensCache(key: IOdspTokenManagerCacheKey, value: IOdspTokens) {
+	public async updateTokensCache(
+		key: IOdspTokenManagerCacheKey,
+		value: IOdspTokens,
+	): Promise<void> {
 		await this.cacheMutex.runExclusive(async () => {
 			await this.updateTokensCacheWithoutLock(key, value);
 		});
@@ -95,7 +104,7 @@ export class OdspTokenManager {
 	private async updateTokensCacheWithoutLock(
 		key: IOdspTokenManagerCacheKey,
 		value: IOdspTokens,
-	) {
+	): Promise<void> {
 		debug(`${cacheKeyToString(key)}: Saving tokens`);
 		const memoryCache = key.isPush ? this.pushCache : this.storageCache;
 		memoryCache.set(key.userOrServer, value);
@@ -124,7 +133,9 @@ export class OdspTokenManager {
 		return this.getTokens(true, server, clientConfig, tokenConfig, forceRefresh, forceReauth);
 	}
 
-	private async getTokenFromCache(cacheKey: IOdspTokenManagerCacheKey) {
+	private async getTokenFromCache(
+		cacheKey: IOdspTokenManagerCacheKey,
+	): Promise<IOdspTokens | undefined> {
 		const memoryCache = cacheKey.isPush ? this.pushCache : this.storageCache;
 		const memoryToken = memoryCache.get(cacheKey.userOrServer);
 		if (memoryToken) {
@@ -159,7 +170,7 @@ export class OdspTokenManager {
 		forceRefresh: boolean,
 		forceReauth: boolean,
 	): Promise<IOdspTokens> {
-		const invokeGetTokensCore = async () => {
+		const invokeGetTokensCore = async (): Promise<IOdspTokens> => {
 			// Don't solely rely on tokenCache lock, ensure serialized execution of
 			// cache update to avoid multiple fetch.
 			return this.cacheMutex.runExclusive(async () => {
@@ -198,8 +209,8 @@ export class OdspTokenManager {
 		server: string,
 		clientConfig: IPublicClientConfig,
 		tokenConfig: OdspTokenConfig,
-		forceRefresh,
-		forceReauth,
+		forceRefresh: boolean,
+		forceReauth: boolean,
 	): Promise<IOdspTokens> {
 		const scope = isPush ? pushScope : getOdspScope(server);
 		const cacheKey = OdspTokenManager.getCacheKey(isPush, tokenConfig, server);
@@ -229,7 +240,7 @@ export class OdspTokenManager {
 		}
 
 		switch (tokenConfig.type) {
-			case "password":
+			case "password": {
 				tokens = await this.acquireTokensWithPassword(
 					server,
 					scope,
@@ -238,7 +249,8 @@ export class OdspTokenManager {
 					tokenConfig.password,
 				);
 				break;
-			case "browserLogin":
+			}
+			case "browserLogin": {
 				tokens = await this.acquireTokensViaBrowserLogin(
 					getLoginPageUrl(server, clientConfig, scope, odspAuthRedirectUri),
 					server,
@@ -248,8 +260,10 @@ export class OdspTokenManager {
 					tokenConfig.redirectUriCallback,
 				);
 				break;
-			default:
+			}
+			default: {
 				unreachableCase(tokenConfig);
+			}
 		}
 
 		await this.updateTokensCacheWithoutLock(cacheKey, tokens);
@@ -310,7 +324,10 @@ export class OdspTokenManager {
 		return odspTokens;
 	}
 
-	private async onTokenRetrievalFromCache(config: OdspTokenConfig, tokens: IOdspTokens) {
+	private async onTokenRetrievalFromCache(
+		config: OdspTokenConfig,
+		tokens: IOdspTokens,
+	): Promise<void> {
 		if (config.type === "browserLogin" && config.redirectUriCallback) {
 			config.navigator(await config.redirectUriCallback(tokens));
 		}
@@ -318,22 +335,23 @@ export class OdspTokenManager {
 
 	private extractAuthorizationCode(relativeUrl: string | undefined): string {
 		if (relativeUrl === undefined) {
-			throw Error("Failed to get authorization");
+			throw new Error("Failed to get authorization");
 		}
 		const parsedUrl = new URL(relativeUrl, odspAuthRedirectOrigin);
 		const code = parsedUrl.searchParams.get("code");
-		if (!code) {
-			throw Error("Failed to get authorization");
+		if (code === null || code === undefined) {
+			throw new Error("Failed to get authorization");
 		}
 		return code;
 	}
 }
 
-async function loadAndPatchRC() {
+async function loadAndPatchRC(): Promise<IResources> {
 	const rc = await loadRC();
 	if (rc.tokens && rc.tokens.version === undefined) {
 		// Clean up older versions
-		delete (rc as any).tokens;
+		delete rc.tokens;
+		// eslint-disable-next-line @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-explicit-any
 		delete (rc as any).pushTokens;
 	}
 	return rc;

package/src/packageVersion.ts

@@ -6,4 +6,4 @@
  */
 
 export const pkgName = "@fluidframework/tool-utils";
-export const pkgVersion = "2.0.2";
+export const pkgVersion = "2.1.0-276326";

package/src/snapshotNormalizer.ts

@@ -3,15 +3,19 @@
  * Licensed under the MIT License.
  */
 
-import { ITree, ITreeEntry, TreeEntry } from "@fluidframework/driver-definitions/internal";
+import type { ITree, ITreeEntry } from "@fluidframework/driver-definitions/internal";
+import { TreeEntry } from "@fluidframework/driver-definitions/internal";
 import {
 	AttachmentTreeEntry,
 	BlobTreeEntry,
 	TreeTreeEntry,
 } from "@fluidframework/driver-utils/internal";
 
-/** The name of the metadata blob added to the root of the container runtime. */
+/**
+ * The name of the metadata blob added to the root of the container runtime.
+ */
 const metadataBlobName = ".metadata";
+
 /**
  * The prefix that all GC blob names start with.
  *
@@ -33,12 +37,18 @@ export interface ISnapshotNormalizerConfig {
 	excludedChannelContentTypes?: string[];
 }
 
+const sortStringified = (elem1: unknown, elem2: unknown): number => {
+	const serializedElem1 = JSON.stringify(elem1);
+	const serializedElem2 = JSON.stringify(elem2);
+	return serializedElem1.localeCompare(serializedElem2);
+};
+
 /**
  * Function that deep sorts an array. It handles cases where array elements are objects or arrays.
  * @returns the sorted array.
  */
-function getDeepSortedArray(array: any[]): any[] {
-	const sortedArray: any[] = [];
+function getDeepSortedArray(array: unknown[]): unknown[] {
+	const sortedArray: unknown[] = [];
 	// Sort arrays and objects, if any, in the array.
 	for (const element of array) {
 		if (Array.isArray(element)) {
@@ -52,25 +62,20 @@ function getDeepSortedArray(array: any[]): any[] {
 
 	// Now that all the arrays and objects in this array's elements have been sorted, sort it by comparing each
 	// element's stringified version.
-	const sortFn = (elem1: any, elem2: any) => {
-		const serializedElem1 = JSON.stringify(elem1);
-		const serializedElem2 = JSON.stringify(elem2);
-		return serializedElem1.localeCompare(serializedElem2);
-	};
-
-	return sortedArray.sort(sortFn);
+	return sortedArray.sort(sortStringified);
 }
 
 /**
  * Function that deep sorts an object. It handles cases where object properties are arrays or objects.
  * @returns the sorted object.
  */
-function getDeepSortedObject(obj: any): any {
-	const sortedObj: any = {};
+function getDeepSortedObject<T extends object>(obj: T): T {
+	// eslint-disable-next-line @typescript-eslint/consistent-type-assertions
+	const sortedObj: T = {} as T;
 	// Sort the object keys first. Then sort arrays and objects, if any, in the object.
 	const keys = Object.keys(obj).sort();
 	for (const key of keys) {
-		const value = obj[key];
+		const value: unknown = obj[key];
 		if (Array.isArray(value)) {
 			sortedObj[key] = getDeepSortedArray(value);
 		} else if (value instanceof Object) {
@@ -91,10 +96,16 @@ function getDeepSortedObject(obj: any): any {
 function getNormalizedBlobContent(blobContent: string, blobName: string): string {
 	let content = blobContent;
 	if (blobName.startsWith(gcBlobPrefix)) {
+		// The following code parses JSON and makes some assumptions about the type of data within. There does not appear to
+		// be a better type than `any` to use here, so the lint rules are disabled.
+
+		/* eslint-disable @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access */
+
 		// GC blobs may contain `unreferencedTimestampMs` for node that became unreferenced. This is the timestamp
 		// of the last op processed or current timestamp and can differ between clients depending on when GC was run.
 		// So, remove it for the purposes of comparing snapshots.
-		const gcState = JSON.parse(content);
+		const gcState: any = JSON.parse(content);
+		// eslint-disable-next-line @typescript-eslint/no-unsafe-argument
 		for (const [, data] of Object.entries(gcState.gcNodes)) {
 			delete (data as any).unreferencedTimestampMs;
 		}
@@ -135,7 +146,12 @@ function getNormalizedBlobContent(blobContent: string, blobName: string): string
 			contentObj = getDeepSortedObject(contentObj);
 		}
 		content = JSON.stringify(contentObj);
-	} catch {}
+	} catch {
+		// Do nothing
+	}
+
+	/* eslint-enable @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access */
+
 	return content;
 }
 
@@ -195,6 +211,8 @@ function normalizeMatrix(value: ITree): ITree {
 		return value;
 	}
 
+	/* eslint-disable @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access */
+
 	const contents = JSON.parse(header?.value.contents);
 
 	for (const segment of contents.segments) {
@@ -209,6 +227,8 @@ function normalizeMatrix(value: ITree): ITree {
 
 	header.value.contents = JSON.stringify(contents);
 
+	/* eslint-enable @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access */
+
 	return value;
 }
 
@@ -221,8 +241,7 @@ function normalizeEntry(
 			let contents = entry.value.contents;
 			// If this blob has to be normalized or it's a GC blob, parse and sort the blob contents first.
 			if (
-				// eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing -- ?? is not logically equivalent when .includes returns false.
-				config?.blobsToNormalize?.includes(entry.path) ||
+				(config?.blobsToNormalize?.includes(entry.path) ?? false) ||
 				entry.path.startsWith(gcBlobPrefix)
 			) {
 				contents = getNormalizedBlobContent(contents, entry.path);
@@ -236,6 +255,7 @@ function normalizeEntry(
 						maybeAttributes.type === TreeEntry.Blob &&
 						maybeAttributes.path === ".attributes"
 					) {
+						// eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
 						const parsed: { type?: string } = JSON.parse(maybeAttributes.value.contents);
 						if (parsed.type === "https://graph.microsoft.com/types/sharedmatrix") {
 							return new TreeTreeEntry(
@@ -260,7 +280,8 @@ function normalizeEntry(
 			return new AttachmentTreeEntry(entry.path, entry.value.id);
 		}
 
-		default:
+		default: {
 			throw new Error("Unknown entry type");
+		}
 	}
 }

package/dist/fluidToolRC.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"fluidToolRC.d.ts","sourceRoot":"","sources":["../src/fluidToolRC.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,EAAE,WAAW,EAAE,MAAM,4CAA4C,CAAC;AAGzE;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,IAAI,EAAE,MAAM;IACxC,GAAG,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC5C,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,MAAM,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE;YACL,CAAC,GAAG,EAAE,MAAM,GAAG;gBACd,OAAO,CAAC,EAAE,WAAW,CAAC;gBACtB,IAAI,CAAC,EAAE,WAAW,CAAC;aACnB,CAAC;SACF,CAAC;KACF,CAAC;CACF;AAID;;GAEG;AACH,wBAAsB,MAAM,IAAI,OAAO,CAAC,UAAU,CAAC,CAclD;AAED;;GAEG;AACH,wBAAsB,MAAM,CAAC,EAAE,EAAE,UAAU,iBAI1C;AAED;;GAEG;AACH,wBAAsB,MAAM,iBAS3B"}

package/dist/fluidToolRC.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"fluidToolRC.js","sourceRoot":"","sources":["../src/fluidToolRC.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;AAEH,4CAAoB;AACpB,4CAAoB;AACpB,gDAAwB;AACxB,gDAAwB;AAGxB,qDAAuC;AA0BvC,MAAM,aAAa,GAAG,GAAG,EAAE,CAAC,cAAI,CAAC,IAAI,CAAC,YAAE,CAAC,OAAO,EAAE,EAAE,cAAc,CAAC,CAAC;AAEpE;;GAEG;AACI,KAAK,UAAU,MAAM;IAC3B,MAAM,QAAQ,GAAG,cAAI,CAAC,SAAS,CAAC,YAAE,CAAC,QAAQ,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,cAAI,CAAC,SAAS,CAAC,YAAE,CAAC,MAAM,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,aAAa,EAAE,CAAC;IACjC,IAAI,MAAM,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACrC,IAAI,CAAC;YACJ,+DAA+D;YAC/D,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACZ,UAAU;QACX,CAAC;IACF,CAAC;IACD,OAAO,EAAE,CAAC;AACX,CAAC;AAdD,wBAcC;AAED;;GAEG;AACI,KAAK,UAAU,MAAM,CAAC,EAAc;IAC1C,MAAM,SAAS,GAAG,cAAI,CAAC,SAAS,CAAC,YAAE,CAAC,SAAS,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;IACjD,OAAO,SAAS,CAAC,aAAa,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AACjE,CAAC;AAJD,wBAIC;AAED;;GAEG;AACI,KAAK,UAAU,MAAM;IAC3B,+DAA+D;IAC/D,OAAO,IAAA,sBAAI,EAAC,aAAa,EAAE,EAAE;QAC5B,OAAO,EAAE;YACR,OAAO,EAAE,IAAI;SACb;QACD,KAAK,EAAE,KAAK;QACZ,QAAQ,EAAE,KAAK;KACf,CAAC,CAAC;AACJ,CAAC;AATD,wBASC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport fs from \"fs\";\nimport os from \"os\";\nimport path from \"path\";\nimport util from \"util\";\n\nimport { IOdspTokens } from \"@fluidframework/odsp-doclib-utils/internal\";\nimport { lock } from \"proper-lockfile\";\n\n/**\n * @internal\n */\nexport interface IAsyncCache<TKey, TValue> {\n\tget(key: TKey): Promise<TValue | undefined>;\n\tsave(key: TKey, value: TValue): Promise<void>;\n\tlock<T>(callback: () => Promise<T>): Promise<T>;\n}\n\n/**\n * @internal\n */\nexport interface IResources {\n\ttokens?: {\n\t\tversion?: number;\n\t\tdata: {\n\t\t\t[key: string]: {\n\t\t\t\tstorage?: IOdspTokens;\n\t\t\t\tpush?: IOdspTokens;\n\t\t\t};\n\t\t};\n\t};\n}\n\nconst getRCFileName = () => path.join(os.homedir(), \".fluidtoolrc\");\n\n/**\n * @internal\n */\nexport async function loadRC(): Promise<IResources> {\n\tconst readFile = util.promisify(fs.readFile);\n\tconst exists = util.promisify(fs.exists);\n\tconst fileName = getRCFileName();\n\tif (await exists(fileName)) {\n\t\tconst buf = await readFile(fileName);\n\t\ttry {\n\t\t\t// eslint-disable-next-line @typescript-eslint/no-unsafe-return\n\t\t\treturn JSON.parse(buf.toString(\"utf8\"));\n\t\t} catch (e) {\n\t\t\t// Nothing\n\t\t}\n\t}\n\treturn {};\n}\n\n/**\n * @internal\n */\nexport async function saveRC(rc: IResources) {\n\tconst writeFile = util.promisify(fs.writeFile);\n\tconst content = JSON.stringify(rc, undefined, 2);\n\treturn writeFile(getRCFileName(), Buffer.from(content, \"utf8\"));\n}\n\n/**\n * @internal\n */\nexport async function lockRC() {\n\t// eslint-disable-next-line @typescript-eslint/no-unsafe-return\n\treturn lock(getRCFileName(), {\n\t\tretries: {\n\t\t\tforever: true,\n\t\t},\n\t\tstale: 60000,\n\t\trealpath: false,\n\t});\n}\n"]}

package/lib/fluidToolRC.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"fluidToolRC.d.ts","sourceRoot":"","sources":["../src/fluidToolRC.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,EAAE,WAAW,EAAE,MAAM,4CAA4C,CAAC;AAGzE;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,IAAI,EAAE,MAAM;IACxC,GAAG,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC5C,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,MAAM,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE;YACL,CAAC,GAAG,EAAE,MAAM,GAAG;gBACd,OAAO,CAAC,EAAE,WAAW,CAAC;gBACtB,IAAI,CAAC,EAAE,WAAW,CAAC;aACnB,CAAC;SACF,CAAC;KACF,CAAC;CACF;AAID;;GAEG;AACH,wBAAsB,MAAM,IAAI,OAAO,CAAC,UAAU,CAAC,CAclD;AAED;;GAEG;AACH,wBAAsB,MAAM,CAAC,EAAE,EAAE,UAAU,iBAI1C;AAED;;GAEG;AACH,wBAAsB,MAAM,iBAS3B"}

package/lib/fluidToolRC.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"fluidToolRC.js","sourceRoot":"","sources":["../src/fluidToolRC.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AA0BvC,MAAM,aAAa,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,cAAc,CAAC,CAAC;AAEpE;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM;IAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,aAAa,EAAE,CAAC;IACjC,IAAI,MAAM,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACrC,IAAI,CAAC;YACJ,+DAA+D;YAC/D,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACZ,UAAU;QACX,CAAC;IACF,CAAC;IACD,OAAO,EAAE,CAAC;AACX,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,EAAc;IAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;IACjD,OAAO,SAAS,CAAC,aAAa,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AACjE,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM;IAC3B,+DAA+D;IAC/D,OAAO,IAAI,CAAC,aAAa,EAAE,EAAE;QAC5B,OAAO,EAAE;YACR,OAAO,EAAE,IAAI;SACb;QACD,KAAK,EAAE,KAAK;QACZ,QAAQ,EAAE,KAAK;KACf,CAAC,CAAC;AACJ,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport fs from \"fs\";\nimport os from \"os\";\nimport path from \"path\";\nimport util from \"util\";\n\nimport { IOdspTokens } from \"@fluidframework/odsp-doclib-utils/internal\";\nimport { lock } from \"proper-lockfile\";\n\n/**\n * @internal\n */\nexport interface IAsyncCache<TKey, TValue> {\n\tget(key: TKey): Promise<TValue | undefined>;\n\tsave(key: TKey, value: TValue): Promise<void>;\n\tlock<T>(callback: () => Promise<T>): Promise<T>;\n}\n\n/**\n * @internal\n */\nexport interface IResources {\n\ttokens?: {\n\t\tversion?: number;\n\t\tdata: {\n\t\t\t[key: string]: {\n\t\t\t\tstorage?: IOdspTokens;\n\t\t\t\tpush?: IOdspTokens;\n\t\t\t};\n\t\t};\n\t};\n}\n\nconst getRCFileName = () => path.join(os.homedir(), \".fluidtoolrc\");\n\n/**\n * @internal\n */\nexport async function loadRC(): Promise<IResources> {\n\tconst readFile = util.promisify(fs.readFile);\n\tconst exists = util.promisify(fs.exists);\n\tconst fileName = getRCFileName();\n\tif (await exists(fileName)) {\n\t\tconst buf = await readFile(fileName);\n\t\ttry {\n\t\t\t// eslint-disable-next-line @typescript-eslint/no-unsafe-return\n\t\t\treturn JSON.parse(buf.toString(\"utf8\"));\n\t\t} catch (e) {\n\t\t\t// Nothing\n\t\t}\n\t}\n\treturn {};\n}\n\n/**\n * @internal\n */\nexport async function saveRC(rc: IResources) {\n\tconst writeFile = util.promisify(fs.writeFile);\n\tconst content = JSON.stringify(rc, undefined, 2);\n\treturn writeFile(getRCFileName(), Buffer.from(content, \"utf8\"));\n}\n\n/**\n * @internal\n */\nexport async function lockRC() {\n\t// eslint-disable-next-line @typescript-eslint/no-unsafe-return\n\treturn lock(getRCFileName(), {\n\t\tretries: {\n\t\t\tforever: true,\n\t\t},\n\t\tstale: 60000,\n\t\trealpath: false,\n\t});\n}\n"]}