@fluid-internal/client-utils 2.0.0-dev-rc.1.0.0.224419

package/lib/indexBrowser.mjs

@@ -0,0 +1,8 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+export { bufferToString, isArrayBuffer, IsoBuffer, stringToBuffer, Uint8ArrayToString, } from "./bufferBrowser.mjs";
+export { gitHashFile, hashFile } from "./hashFileBrowser.mjs";
+export { performance } from "./performanceIsomorphic.mjs";
+//# sourceMappingURL=indexBrowser.mjs.map

package/lib/indexBrowser.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexBrowser.mjs","sourceRoot":"","sources":["../src/indexBrowser.ts"],"names":[],"mappings":"AAAA;;;GAGG;OAEI,EACN,cAAc,EACd,aAAa,EACb,SAAS,EACT,cAAc,EACd,kBAAkB,GAClB;OACM,EAAE,WAAW,EAAE,QAAQ,EAAE;OACzB,EAAE,WAAW,EAAE","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nexport {\n\tbufferToString,\n\tisArrayBuffer,\n\tIsoBuffer,\n\tstringToBuffer,\n\tUint8ArrayToString,\n} from \"./bufferBrowser\";\nexport { gitHashFile, hashFile } from \"./hashFileBrowser\";\nexport { performance } from \"./performanceIsomorphic\";\n"]}

package/lib/indexNode.d.mts

@@ -0,0 +1,8 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+export { Buffer, bufferToString, IsoBuffer, stringToBuffer, Uint8ArrayToString, } from "./bufferNode.mjs";
+export { gitHashFile, hashFile } from "./hashFileNode.mjs";
+export { performance } from "./performanceIsomorphic.mjs";
+//# sourceMappingURL=indexNode.d.ts.map

package/lib/indexNode.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexNode.d.ts","sourceRoot":"","sources":["../src/indexNode.ts"],"names":[],"mappings":"AAAA;;;GAGG;OAEI,EACN,MAAM,EACN,cAAc,EACd,SAAS,EACT,cAAc,EACd,kBAAkB,GAClB;OACM,EAAE,WAAW,EAAE,QAAQ,EAAE;OACzB,EAAE,WAAW,EAAE"}

package/lib/indexNode.mjs

@@ -0,0 +1,8 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+export { Buffer, bufferToString, IsoBuffer, stringToBuffer, Uint8ArrayToString, } from "./bufferNode.mjs";
+export { gitHashFile, hashFile } from "./hashFileNode.mjs";
+export { performance } from "./performanceIsomorphic.mjs";
+//# sourceMappingURL=indexNode.mjs.map

package/lib/indexNode.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexNode.mjs","sourceRoot":"","sources":["../src/indexNode.ts"],"names":[],"mappings":"AAAA;;;GAGG;OAEI,EACN,MAAM,EACN,cAAc,EACd,SAAS,EACT,cAAc,EACd,kBAAkB,GAClB;OACM,EAAE,WAAW,EAAE,QAAQ,EAAE;OACzB,EAAE,WAAW,EAAE","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nexport {\n\tBuffer,\n\tbufferToString,\n\tIsoBuffer,\n\tstringToBuffer,\n\tUint8ArrayToString,\n} from \"./bufferNode\";\nexport { gitHashFile, hashFile } from \"./hashFileNode\";\nexport { performance } from \"./performanceIsomorphic\";\n"]}

package/lib/performanceIsomorphic.d.mts

@@ -0,0 +1,21 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+/**
+ * This type contains all browser performance properties as optional, and some
+ * of the intersecting properties of node and browser performance as required.
+ *
+ * @internal
+ */
+export type IsomorphicPerformance = Partial<Performance> & Pick<Performance, "clearMarks" | "mark" | "measure" | "now">;
+/**
+ * This exported "performance" member masks the built-in globalThis.performance object
+ * as an IsomorphicPerformance, which hides all of its features that aren't compatible
+ * between Node and browser implementations.  Anything exposed on this performance object
+ * is considered safe to use regarless of the environment it runs in.
+ *
+ * @internal
+ */
+export declare const performance: IsomorphicPerformance;
+//# sourceMappingURL=performanceIsomorphic.d.ts.map

package/lib/performanceIsomorphic.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performanceIsomorphic.d.ts","sourceRoot":"","sources":["../src/performanceIsomorphic.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAAG,OAAO,CAAC,WAAW,CAAC,GACvD,IAAI,CAAC,WAAW,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,KAAK,CAAC,CAAC;AAE9D;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,EAAE,qBAA8C,CAAC"}

package/lib/performanceIsomorphic.mjs

@@ -0,0 +1,14 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+/**
+ * This exported "performance" member masks the built-in globalThis.performance object
+ * as an IsomorphicPerformance, which hides all of its features that aren't compatible
+ * between Node and browser implementations.  Anything exposed on this performance object
+ * is considered safe to use regarless of the environment it runs in.
+ *
+ * @internal
+ */
+export const performance = globalThis.performance;
+//# sourceMappingURL=performanceIsomorphic.mjs.map

package/lib/performanceIsomorphic.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"performanceIsomorphic.mjs","sourceRoot":"","sources":["../src/performanceIsomorphic.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,WAAW,GAA0B,UAAU,CAAC,WAAW,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\n/**\n * This type contains all browser performance properties as optional, and some\n * of the intersecting properties of node and browser performance as required.\n *\n * @internal\n */\nexport type IsomorphicPerformance = Partial<Performance> &\n\tPick<Performance, \"clearMarks\" | \"mark\" | \"measure\" | \"now\">;\n\n/**\n * This exported \"performance\" member masks the built-in globalThis.performance object\n * as an IsomorphicPerformance, which hides all of its features that aren't compatible\n * between Node and browser implementations.  Anything exposed on this performance object\n * is considered safe to use regarless of the environment it runs in.\n *\n * @internal\n */\nexport const performance: IsomorphicPerformance = globalThis.performance;\n"]}

package/lib/trace.d.mts

@@ -0,0 +1,40 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+/**
+ * Helper class for tracing performance of events
+ * Time measurements are in milliseconds as a floating point with a decimal
+ *
+ * @internal
+ */
+export declare class Trace {
+    readonly startTick: number;
+    static start(): Trace;
+    protected lastTick: number;
+    protected constructor(startTick: number);
+    trace(): ITraceEvent;
+}
+/**
+ * Event in a performance trace including time elapsed.
+ *
+ * @internal
+ */
+export interface ITraceEvent {
+    /**
+     * Total time elapsed since the start of the Trace.
+     * Measured in milliseconds as a floating point with a decimal
+     */
+    readonly totalTimeElapsed: number;
+    /**
+     * Time elapsed since the last trace event.
+     * Measured in milliseconds as a floating point with a decimal
+     */
+    readonly duration: number;
+    /**
+     * This number represents a relative time which should
+     * be consistent for all trace ticks.
+     */
+    readonly tick: number;
+}
+//# sourceMappingURL=trace.d.ts.map

package/lib/trace.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../src/trace.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;;;GAKG;AACH,qBAAa,KAAK;aAOqB,SAAS,EAAE,MAAM;WANzC,KAAK,IAAI,KAAK;IAK5B,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC3B,SAAS,aAA6B,SAAS,EAAE,MAAM;IAIhD,KAAK,IAAI,WAAW;CAU3B;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC3B;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACtB"}

package/lib/trace.mjs

@@ -0,0 +1,32 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { performance } from "./indexNode.mjs";
+/**
+ * Helper class for tracing performance of events
+ * Time measurements are in milliseconds as a floating point with a decimal
+ *
+ * @internal
+ */
+export class Trace {
+    static start() {
+        const startTick = performance.now();
+        return new Trace(startTick);
+    }
+    constructor(startTick) {
+        this.startTick = startTick;
+        this.lastTick = startTick;
+    }
+    trace() {
+        const tick = performance.now();
+        const event = {
+            totalTimeElapsed: tick - this.startTick,
+            duration: tick - this.lastTick,
+            tick,
+        };
+        this.lastTick = tick;
+        return event;
+    }
+}
+//# sourceMappingURL=trace.mjs.map

package/lib/trace.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.mjs","sourceRoot":"","sources":["../src/trace.ts"],"names":[],"mappings":"AAAA;;;GAGG;OAEI,EAAE,WAAW,EAAE;AAEtB;;;;;GAKG;AACH,MAAM,OAAO,KAAK;IACV,MAAM,CAAC,KAAK;QAClB,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QACpC,OAAO,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC;IAC7B,CAAC;IAGD,YAAsC,SAAiB;QAAjB,cAAS,GAAT,SAAS,CAAQ;QACtD,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;IAC3B,CAAC;IAEM,KAAK;QACX,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG;YACb,gBAAgB,EAAE,IAAI,GAAG,IAAI,CAAC,SAAS;YACvC,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAC,QAAQ;YAC9B,IAAI;SACJ,CAAC;QACF,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,OAAO,KAAK,CAAC;IACd,CAAC;CACD","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { performance } from \"./indexNode\";\n\n/**\n * Helper class for tracing performance of events\n * Time measurements are in milliseconds as a floating point with a decimal\n *\n * @internal\n */\nexport class Trace {\n\tpublic static start(): Trace {\n\t\tconst startTick = performance.now();\n\t\treturn new Trace(startTick);\n\t}\n\n\tprotected lastTick: number;\n\tprotected constructor(public readonly startTick: number) {\n\t\tthis.lastTick = startTick;\n\t}\n\n\tpublic trace(): ITraceEvent {\n\t\tconst tick = performance.now();\n\t\tconst event = {\n\t\t\ttotalTimeElapsed: tick - this.startTick,\n\t\t\tduration: tick - this.lastTick,\n\t\t\ttick,\n\t\t};\n\t\tthis.lastTick = tick;\n\t\treturn event;\n\t}\n}\n\n/**\n * Event in a performance trace including time elapsed.\n *\n * @internal\n */\nexport interface ITraceEvent {\n\t/**\n\t * Total time elapsed since the start of the Trace.\n\t * Measured in milliseconds as a floating point with a decimal\n\t */\n\treadonly totalTimeElapsed: number;\n\t/**\n\t * Time elapsed since the last trace event.\n\t * Measured in milliseconds as a floating point with a decimal\n\t */\n\treadonly duration: number;\n\t/**\n\t * This number represents a relative time which should\n\t * be consistent for all trace ticks.\n\t */\n\treadonly tick: number;\n}\n"]}

package/lib/typedEventEmitter.d.mts

@@ -0,0 +1,36 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+/// <reference types="node" />
+import { EventEmitter } from "events";
+import { IEvent, TransformedEvent, IEventTransformer, IEventProvider } from "@fluidframework/core-interfaces";
+/**
+ * The event emitter polyfill and the node event emitter have different event types:
+ * string | symbol vs. string | number
+ *
+ * This type allow us to correctly handle either type
+ * @public
+ */
+export type EventEmitterEventType = EventEmitter extends {
+    on(event: infer E, listener: any): any;
+} ? E : never;
+/**
+ * @public
+ */
+export type TypedEventTransform<TThis, TEvent> = TransformedEvent<TThis, "newListener" | "removeListener", Parameters<(event: string, listener: (...args: any[]) => void) => void>> & IEventTransformer<TThis, TEvent & IEvent> & TransformedEvent<TThis, EventEmitterEventType, any[]>;
+/**
+ * Event Emitter helper class the supports emitting typed events
+ * @public
+ */
+export declare class TypedEventEmitter<TEvent> extends EventEmitter implements IEventProvider<TEvent & IEvent> {
+    constructor();
+    readonly addListener: TypedEventTransform<this, TEvent>;
+    readonly on: TypedEventTransform<this, TEvent>;
+    readonly once: TypedEventTransform<this, TEvent>;
+    readonly prependListener: TypedEventTransform<this, TEvent>;
+    readonly prependOnceListener: TypedEventTransform<this, TEvent>;
+    readonly removeListener: TypedEventTransform<this, TEvent>;
+    readonly off: TypedEventTransform<this, TEvent>;
+}
+//# sourceMappingURL=typedEventEmitter.d.ts.map

package/lib/typedEventEmitter.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typedEventEmitter.d.ts","sourceRoot":"","sources":["../src/typedEventEmitter.ts"],"names":[],"mappings":"AAAA;;;GAGG;;OAII,EAAE,YAAY,EAAE,MAAM,QAAQ;OAC9B,EACN,MAAM,EACN,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,MAAM,iCAAiC;AAExC;;;;;;GAMG;AAEH,MAAM,MAAM,qBAAqB,GAAG,YAAY,SAAS;IAAE,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,GAAG,OAAC;CAAE,GAC3F,CAAC,GACD,KAAK,CAAC;AAET;;GAEG;AACH,MAAM,MAAM,mBAAmB,CAAC,KAAK,EAAE,MAAM,IAK5C,gBAAgB,CACf,KAAK,EACL,aAAa,GAAG,gBAAgB,EAEhC,UAAU,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,KAAK,IAAI,CAAC,CACvE,GAEA,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,GAGzC,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,EAAE,GAAG,EAAE,CAAC,CAAC;AAExD;;;GAGG;AACH,qBAAa,iBAAiB,CAAC,MAAM,CACpC,SAAQ,YACR,YAAW,cAAc,CAAC,MAAM,GAAG,MAAM,CAAC;;IAkB1C,QAAQ,CAAC,WAAW,EAAE,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxD,QAAQ,CAAC,EAAE,EAAE,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC/C,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACjD,QAAQ,CAAC,eAAe,EAAE,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC5D,QAAQ,CAAC,mBAAmB,EAAE,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAChE,QAAQ,CAAC,cAAc,EAAE,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC3D,QAAQ,CAAC,GAAG,EAAE,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;CAChD"}

package/lib/typedEventEmitter.mjs

@@ -0,0 +1,22 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { EventEmitter } from "events";
+/**
+ * Event Emitter helper class the supports emitting typed events
+ * @public
+ */
+export class TypedEventEmitter extends EventEmitter {
+    constructor() {
+        super();
+        this.addListener = super.addListener.bind(this);
+        this.on = super.on.bind(this);
+        this.once = super.once.bind(this);
+        this.prependListener = super.prependListener.bind(this);
+        this.prependOnceListener = super.prependOnceListener.bind(this);
+        this.removeListener = super.removeListener.bind(this);
+        this.off = super.off.bind(this);
+    }
+}
+//# sourceMappingURL=typedEventEmitter.mjs.map

package/lib/typedEventEmitter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"typedEventEmitter.mjs","sourceRoot":"","sources":["../src/typedEventEmitter.ts"],"names":[],"mappings":"AAAA;;;GAGG;OAII,EAAE,YAAY,EAAE,MAAM,QAAQ;AAwCrC;;;GAGG;AACH,MAAM,OAAO,iBACZ,SAAQ,YAAY;IAGpB;QACC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAsC,CAAC;QACrF,IAAI,CAAC,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAsC,CAAC;QACnE,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAsC,CAAC;QACvE,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAGrD,CAAC;QACF,IAAI,CAAC,mBAAmB,GAAG,KAAK,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAG7D,CAAC;QACF,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAsC,CAAC;QAC3F,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAsC,CAAC;IACtE,CAAC;CAQD","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\n// False positive: this is an import from the `events` package, not from Node.\n// eslint-disable-next-line unicorn/prefer-node-protocol\nimport { EventEmitter } from \"events\";\nimport {\n\tIEvent,\n\tTransformedEvent,\n\tIEventTransformer,\n\tIEventProvider,\n} from \"@fluidframework/core-interfaces\";\n\n/**\n * The event emitter polyfill and the node event emitter have different event types:\n * string | symbol vs. string | number\n *\n * This type allow us to correctly handle either type\n * @public\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type EventEmitterEventType = EventEmitter extends { on(event: infer E, listener: any) }\n\t? E\n\t: never;\n\n/**\n * @public\n */\nexport type TypedEventTransform<TThis, TEvent> =\n\t// Event emitter supports some special events for the emitter itself to use\n\t// this exposes those events for the TypedEventEmitter.\n\t// Since we know what the shape of these events are, we can describe them directly via a TransformedEvent\n\t// which easier than trying to extend TEvent directly\n\tTransformedEvent<\n\t\tTThis,\n\t\t\"newListener\" | \"removeListener\",\n\t\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\t\tParameters<(event: string, listener: (...args: any[]) => void) => void>\n\t> &\n\t\t// Expose all the events provides by TEvent\n\t\tIEventTransformer<TThis, TEvent & IEvent> &\n\t\t// Add the default overload so this is covertable to EventEmitter regardless of environment\n\t\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\t\tTransformedEvent<TThis, EventEmitterEventType, any[]>;\n\n/**\n * Event Emitter helper class the supports emitting typed events\n * @public\n */\nexport class TypedEventEmitter<TEvent>\n\textends EventEmitter\n\timplements IEventProvider<TEvent & IEvent>\n{\n\tconstructor() {\n\t\tsuper();\n\t\tthis.addListener = super.addListener.bind(this) as TypedEventTransform<this, TEvent>;\n\t\tthis.on = super.on.bind(this) as TypedEventTransform<this, TEvent>;\n\t\tthis.once = super.once.bind(this) as TypedEventTransform<this, TEvent>;\n\t\tthis.prependListener = super.prependListener.bind(this) as TypedEventTransform<\n\t\t\tthis,\n\t\t\tTEvent\n\t\t>;\n\t\tthis.prependOnceListener = super.prependOnceListener.bind(this) as TypedEventTransform<\n\t\t\tthis,\n\t\t\tTEvent\n\t\t>;\n\t\tthis.removeListener = super.removeListener.bind(this) as TypedEventTransform<this, TEvent>;\n\t\tthis.off = super.off.bind(this) as TypedEventTransform<this, TEvent>;\n\t}\n\treadonly addListener: TypedEventTransform<this, TEvent>;\n\treadonly on: TypedEventTransform<this, TEvent>;\n\treadonly once: TypedEventTransform<this, TEvent>;\n\treadonly prependListener: TypedEventTransform<this, TEvent>;\n\treadonly prependOnceListener: TypedEventTransform<this, TEvent>;\n\treadonly removeListener: TypedEventTransform<this, TEvent>;\n\treadonly off: TypedEventTransform<this, TEvent>;\n}\n"]}

package/package.json

@@ -0,0 +1,138 @@
+{
+  "name": "@fluid-internal/client-utils",
+  "version": "2.0.0-dev-rc.1.0.0.224419",
+  "description": "Not intended for use outside the Fluid Framework.",
+  "homepage": "https://fluidframework.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/microsoft/FluidFramework.git",
+    "directory": "packages/common/client-utils"
+  },
+  "license": "MIT",
+  "author": "Microsoft and contributors",
+  "sideEffects": false,
+  "main": "dist/index.cjs",
+  "module": "lib/index.mjs",
+  "browser": {
+    "./dist/indexNode.cjs": "./dist/indexBrowser.cjs",
+    "./lib/indexNode.mjs": "./lib/indexBrowser.mjs"
+  },
+  "types": "dist/index.d.ts",
+  "c8": {
+    "all": true,
+    "cache-dir": "nyc/.cache",
+    "exclude": [
+      "src/test/**/*.*ts",
+      "dist/test/**/*.*js"
+    ],
+    "exclude-after-remap": false,
+    "include": [
+      "src/**/*.*ts",
+      "dist/**/*.*js"
+    ],
+    "report-dir": "nyc/report",
+    "reporter": [
+      "cobertura",
+      "html",
+      "text"
+    ],
+    "temp-directory": "nyc/.nyc_output"
+  },
+  "dependencies": {
+    "@fluidframework/core-interfaces": "2.0.0-dev-rc.1.0.0.224419",
+    "@fluidframework/core-utils": "2.0.0-dev-rc.1.0.0.224419",
+    "@types/events": "^3.0.0",
+    "base64-js": "^1.5.1",
+    "buffer": "^6.0.3",
+    "events": "^3.1.0",
+    "lodash": "^4.17.21",
+    "sha.js": "^2.4.11"
+  },
+  "devDependencies": {
+    "@arethetypeswrong/cli": "^0.13.3",
+    "@fluid-internal/client-utils-previous": "npm:@fluid-internal/client-utils@2.0.0-internal.7.3.0",
+    "@fluid-tools/build-cli": "0.29.0-222379",
+    "@fluidframework/build-common": "^2.0.3",
+    "@fluidframework/build-tools": "0.29.0-222379",
+    "@fluidframework/eslint-config-fluid": "^3.1.0",
+    "@fluidframework/mocha-test-setup": "2.0.0-dev-rc.1.0.0.224419",
+    "@microsoft/api-extractor": "^7.38.3",
+    "@types/base64-js": "^1.3.0",
+    "@types/jest": "29.5.3",
+    "@types/jest-environment-puppeteer": "2.2.0",
+    "@types/mocha": "^9.1.1",
+    "@types/node": "^18.19.0",
+    "@types/puppeteer": "1.3.0",
+    "@types/rewire": "^2.5.28",
+    "@types/sha.js": "^2.4.4",
+    "@types/sinon": "^7.0.13",
+    "c8": "^7.7.1",
+    "concurrently": "^8.2.1",
+    "copyfiles": "^2.4.1",
+    "cross-env": "^7.0.3",
+    "eslint": "~8.50.0",
+    "eslint-config-prettier": "~9.0.0",
+    "jest": "^29.6.2",
+    "jest-junit": "^10.0.0",
+    "jest-puppeteer": "^6.2.0",
+    "mocha": "^10.2.0",
+    "mocha-json-output-reporter": "^2.0.1",
+    "mocha-multi-reporters": "^1.5.1",
+    "moment": "^2.21.0",
+    "prettier": "~3.0.3",
+    "puppeteer": "^17.1.3",
+    "renamer": "^4.0.0",
+    "rewire": "^5.0.0",
+    "rimraf": "^4.4.0",
+    "sinon": "^7.4.2",
+    "ts-jest": "^29.1.1",
+    "ts-node": "^10.9.1",
+    "tsc-multi": "^1.1.0",
+    "typescript": "~5.1.6"
+  },
+  "fluidBuild": {
+    "tasks": {
+      "build:docs": {
+        "dependsOn": [
+          "...",
+          "api-extractor:commonjs",
+          "api-extractor:esnext"
+        ],
+        "script": false
+      }
+    }
+  },
+  "typeValidation": {
+    "broken": {}
+  },
+  "scripts": {
+    "api": "fluid-build . --task api",
+    "api-extractor:commonjs": "api-extractor run --local",
+    "api-extractor:esnext": "copyfiles -u 1 \"dist/**/*-@(alpha|beta|public|untrimmed).d.ts\" lib",
+    "build": "fluid-build . --task build",
+    "build:commonjs": "fluid-build . --task commonjs",
+    "build:compile": "fluid-build . --task compile",
+    "build:docs": "fluid-build . --task api",
+    "build:esnext": "tsc-multi --config ../../../common/build/build-common/tsc-multi.esm.json",
+    "build:rename-types": "renamer \"lib/**\" -f .d.ts -r .d.mts --force",
+    "build:test": "tsc-multi --config ./tsc-multi.test.json",
+    "check:are-the-types-wrong": "attw --pack",
+    "check:release-tags": "api-extractor run --local --config ./api-extractor-lint.json",
+    "ci:build:docs": "api-extractor run",
+    "clean": "rimraf --glob _api-extractor-temp dist lib \"**/*.tsbuildinfo\" \"**/*.build.log\" nyc",
+    "eslint": "eslint --format stylish src",
+    "eslint:fix": "eslint --format stylish src --fix --fix-type problem,suggestion,layout",
+    "format": "npm run prettier:fix",
+    "lint": "npm run prettier && npm run check:release-tags && npm run eslint",
+    "lint:fix": "npm run prettier:fix && npm run eslint:fix",
+    "prettier": "prettier --check . --cache --ignore-path ../../../.prettierignore",
+    "prettier:fix": "prettier --write . --cache --ignore-path ../../../.prettierignore",
+    "test": "npm run test:mocha && npm run test:jest",
+    "test:coverage": "c8 npm test",
+    "test:jest": "jest",
+    "test:mocha": "mocha  --recursive \"dist/test/mocha/**/*.spec.?js\" --exit --project test/tsconfig.json",
+    "tsc": "tsc-multi --config ../../../common/build/build-common/tsc-multi.cjs.json",
+    "typetests:gen": "fluid-type-test-generator",
+    "typetests:prepare": "flub typetests --dir . --reset --previous --normalize"
+  }
+}

package/prettier.config.cjs

@@ -0,0 +1,8 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+
+module.exports = {
+	...require("@fluidframework/build-common/prettier.config.cjs"),
+};

package/src/base64Encoding.ts

@@ -0,0 +1,45 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+
+import { IsoBuffer } from "./indexNode";
+
+/**
+ * Converts the provided {@link https://en.wikipedia.org/wiki/Base64 | base64}-encoded string
+ * to {@link https://en.wikipedia.org/wiki/UTF-8 | utf-8}.
+ *
+ * @internal
+ */
+export const fromBase64ToUtf8 = (input: string): string =>
+	IsoBuffer.from(input, "base64").toString("utf8");
+
+/**
+ * Converts the provided {@link https://en.wikipedia.org/wiki/UTF-8 | utf-8}-encoded string
+ * to {@link https://en.wikipedia.org/wiki/Base64 | base64}.
+ *
+ * @internal
+ */
+export const fromUtf8ToBase64 = (input: string): string =>
+	IsoBuffer.from(input, "utf8").toString("base64");
+
+/**
+ * Convenience function to convert unknown encoding to utf8 that avoids
+ * buffer copies/encode ops when no conversion is needed.
+ * @param input - The source string to convert.
+ * @param encoding - The source string's encoding.
+ *
+ * @internal
+ */
+export const toUtf8 = (input: string, encoding: string): string => {
+	switch (encoding) {
+		case "utf8":
+		// eslint-disable-next-line unicorn/text-encoding-identifier-case -- this value is supported, just discouraged
+		case "utf-8": {
+			return input;
+		}
+		default: {
+			return IsoBuffer.from(input, encoding).toString();
+		}
+	}
+};

package/src/bufferBrowser.ts

@@ -0,0 +1,208 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+
+import * as base64js from "base64-js";
+
+/**
+ * Converts a Uint8Array to a string of the provided encoding
+ * Useful when the array might be an {@link IsoBuffer}.
+ *
+ * @param arr - The array to convert.
+ * @param encoding - Optional target encoding; only "utf8" and "base64" are
+ * supported, with "utf8" being default.
+ * @returns The converted string.
+ *
+ * @internal
+ */
+export function Uint8ArrayToString(
+	arr: Uint8Array,
+	// eslint-disable-next-line unicorn/text-encoding-identifier-case -- this value is supported, just discouraged
+	encoding?: "utf8" | "utf-8" | "base64",
+): string {
+	switch (encoding) {
+		case "base64": {
+			return base64js.fromByteArray(arr);
+		}
+		case "utf8":
+		// eslint-disable-next-line unicorn/text-encoding-identifier-case -- this value is supported, just discouraged
+		case "utf-8":
+		case undefined: {
+			return new TextDecoder().decode(arr);
+		}
+		default: {
+			throw new Error("invalid/unsupported encoding");
+		}
+	}
+}
+
+/**
+ * Converts a {@link https://en.wikipedia.org/wiki/Base64 | base64} or
+ * {@link https://en.wikipedia.org/wiki/UTF-8 | utf-8} string to array buffer.
+ *
+ * @param encoding - The input string's encoding.
+ *
+ * @internal
+ */
+export const stringToBuffer = (input: string, encoding: string): ArrayBufferLike =>
+	IsoBuffer.from(input, encoding).buffer;
+
+/**
+ * Convert binary blob to string format
+ *
+ * @param blob - the binary blob
+ * @param encoding - output string's encoding
+ * @returns the blob in string format
+ *
+ * @alpha
+ */
+export const bufferToString = (
+	blob: ArrayBufferLike,
+	// eslint-disable-next-line unicorn/text-encoding-identifier-case -- this value is supported, just discouraged
+	encoding: "utf8" | "utf-8" | "base64",
+): string => IsoBuffer.from(blob).toString(encoding);
+
+/**
+ * Determines if an object is an array buffer.
+ *
+ * @remarks Will detect and reject TypedArrays, like Uint8Array.
+ * Reason - they can be viewport into Array, they can be accepted, but caller has to deal with
+ * math properly (i.e. Take into account byteOffset at minimum).
+ * For example, construction of new TypedArray can be in the form of new TypedArray(typedArray) or
+ * new TypedArray(buffer, byteOffset, length), but passing TypedArray will result in fist path (and
+ * ignoring byteOffice, length).
+ *
+ * @param obj - The object to determine if it is an ArrayBuffer.
+ *
+ * @internal
+ */
+export function isArrayBuffer(obj: unknown): obj is ArrayBuffer {
+	const maybe = obj as (Partial<ArrayBuffer> & Partial<Uint8Array>) | undefined;
+	return (
+		obj instanceof ArrayBuffer ||
+		(typeof maybe === "object" &&
+			maybe !== null &&
+			typeof maybe.byteLength === "number" &&
+			typeof maybe.slice === "function" &&
+			maybe.byteOffset === undefined &&
+			maybe.buffer === undefined)
+	);
+}
+
+/**
+ * Minimal implementation of Buffer for our usages in the browser environment.
+ *
+ * @internal
+ */
+export class IsoBuffer extends Uint8Array {
+	/**
+	 * Convert the buffer to a string.
+	 * Only supports encoding the whole string (unlike the Node Buffer equivalent)
+	 * and only utf8 and base64 encodings.
+	 *
+	 * @param encoding - The encoding to use.
+	 */
+	// eslint-disable-next-line unicorn/text-encoding-identifier-case -- this value is supported, just discouraged
+	public toString(encoding?: "utf8" | "utf-8" | "base64"): string {
+		return Uint8ArrayToString(this, encoding);
+	}
+
+	/**
+	 * Static constructor
+	 * @param value - (string | ArrayBuffer)
+	 * @param encodingOrOffset - (string | number)
+	 * @param length - (number)
+	 *
+	 * @privateRemarks TODO: Use actual types
+	 */
+	// eslint-disable-next-line @typescript-eslint/explicit-module-boundary-types, @typescript-eslint/no-explicit-any
+	static from(value: any, encodingOrOffset?: any, length?: any): IsoBuffer {
+		if (typeof value === "string") {
+			return IsoBuffer.fromString(value, encodingOrOffset as string | undefined);
+			// Capture any typed arrays, including Uint8Array (and thus - IsoBuffer!)
+			// eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
+		} else if (value !== null && typeof value === "object" && isArrayBuffer(value.buffer)) {
+			// The version of the from function for the node buffer, which takes a buffer or typed array
+			// as first parameter, does not have any offset or length parameters. Those are just silently
+			// ignored and not taken into account
+			// eslint-disable-next-line @typescript-eslint/no-unsafe-argument, @typescript-eslint/no-unsafe-member-access
+			return IsoBuffer.fromArrayBuffer(value.buffer, value.byteOffset, value.byteLength);
+		} else if (isArrayBuffer(value)) {
+			return IsoBuffer.fromArrayBuffer(
+				value,
+				encodingOrOffset as number | undefined,
+				length as number,
+			);
+		} else {
+			throw new TypeError("Input value was neither a string nor an ArrayBuffer.");
+		}
+	}
+
+	static fromArrayBuffer(
+		arrayBuffer: ArrayBuffer,
+		byteOffset?: number,
+		byteLength?: number,
+	): IsoBuffer {
+		const offset = byteOffset ?? 0;
+		const validLength = byteLength ?? arrayBuffer.byteLength - offset;
+		if (
+			offset < 0 ||
+			offset > arrayBuffer.byteLength ||
+			validLength < 0 ||
+			validLength + offset > arrayBuffer.byteLength
+		) {
+			throw new RangeError("Invalid range specified.");
+		}
+
+		return new IsoBuffer(arrayBuffer, offset, validLength);
+	}
+
+	static fromString(str: string, encoding?: string): IsoBuffer {
+		switch (encoding) {
+			case "base64": {
+				const sanitizedString = this.sanitizeBase64(str);
+				const encoded = base64js.toByteArray(sanitizedString);
+				return new IsoBuffer(encoded.buffer);
+			}
+			case "utf8":
+			// eslint-disable-next-line unicorn/text-encoding-identifier-case -- this value is supported, just discouraged
+			case "utf-8":
+			case undefined: {
+				const encoded = new TextEncoder().encode(str);
+				return new IsoBuffer(encoded.buffer);
+			}
+			default: {
+				throw new Error("invalid/unsupported encoding");
+			}
+		}
+	}
+
+	static isBuffer(obj: unknown): boolean {
+		throw new Error("unimplemented");
+	}
+
+	/**
+	 * Sanitize a base64 string to provide to base64-js library.
+	 * {@link https://www.npmjs.com/package/base64-js} is not as tolerant of the same malformed base64 as Node'
+	 * Buffer is.
+	 */
+	private static sanitizeBase64(str: string): string {
+		let sanitizedStr = str;
+		// Remove everything after padding - Node buffer ignores everything
+		// after any padding whereas base64-js does not
+		sanitizedStr = sanitizedStr.split("=")[0];
+
+		// Remove invalid characters - Node buffer strips invalid characters
+		// whereas base64-js replaces them with "A"
+		sanitizedStr = sanitizedStr.replace(/[^\w+-/]/g, "");
+
+		// Check for missing padding - Node buffer tolerates missing padding
+		// whereas base64-js does not
+		if (sanitizedStr.length % 4 !== 0) {
+			const paddingArray = ["", "===", "==", "="];
+			sanitizedStr += paddingArray[sanitizedStr.length % 4];
+		}
+		return sanitizedStr;
+	}
+}