@fluid-internal/client-utils 2.118.1 → 3.0.1

package/lib/base64EncodingBrowser.js

@@ -2,7 +2,7 @@
  * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
  * Licensed under the MIT License.
  */
-// This file is a Node.js-specific implementation of the base64 encoding functions.
+// This file is a browser-specific implementation of the base64 encoding functions.
 // Aside from the below import statement, this file should be identical to the
 // base64EncodingNode.ts.
 //

package/lib/base64EncodingBrowser.js.map

@@ -1 +1 @@
-{"version":3,"file":"base64EncodingBrowser.js","sourceRoot":"","sources":["../src/base64EncodingBrowser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mFAAmF;AACnF,8EAA8E;AAC9E,yBAAyB;AACzB,EAAE;AACF,4DAA4D;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAa,EAAU,EAAE,CACzD,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAElD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAa,EAAU,EAAE,CACzD,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,KAAa,EAAE,QAAgB,EAAU,EAAE;IACjE,QAAQ,QAAQ,EAAE,CAAC;QAClB,KAAK,MAAM,CAAC;QACZ,8GAA8G;QAC9G,KAAK,OAAO,CAAC,CAAC,CAAC;YACd,OAAO,KAAK,CAAC;QACd,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACT,OAAO,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC;QACnD,CAAC;IACF,CAAC;AACF,CAAC,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\n// This file is a Node.js-specific implementation of the base64 encoding functions.\n// Aside from the below import statement, this file should be identical to the\n// base64EncodingNode.ts.\n//\n// (See 'Isomorphic Code' section in the package README.md.)\nimport { IsoBuffer } from \"./bufferBrowser.js\";\n\n/**\n * Converts the provided {@link https://en.wikipedia.org/wiki/Base64 | base64}-encoded string\n * to {@link https://en.wikipedia.org/wiki/UTF-8 | utf-8}.\n *\n * @internal\n */\nexport const fromBase64ToUtf8 = (input: string): string =>\n\tIsoBuffer.from(input, \"base64\").toString(\"utf8\");\n\n/**\n * Converts the provided {@link https://en.wikipedia.org/wiki/UTF-8 | utf-8}-encoded string\n * to {@link https://en.wikipedia.org/wiki/Base64 | base64}.\n *\n * @internal\n */\nexport const fromUtf8ToBase64 = (input: string): string =>\n\tIsoBuffer.from(input, \"utf8\").toString(\"base64\");\n\n/**\n * Convenience function to convert unknown encoding to utf8 that avoids\n * buffer copies/encode ops when no conversion is needed.\n * @param input - The source string to convert.\n * @param encoding - The source string's encoding.\n *\n * @internal\n */\nexport const toUtf8 = (input: string, encoding: string): string => {\n\tswitch (encoding) {\n\t\tcase \"utf8\":\n\t\t// eslint-disable-next-line unicorn/text-encoding-identifier-case -- this value is supported, just discouraged\n\t\tcase \"utf-8\": {\n\t\t\treturn input;\n\t\t}\n\t\tdefault: {\n\t\t\treturn IsoBuffer.from(input, encoding).toString();\n\t\t}\n\t}\n};\n"]}
+{"version":3,"file":"base64EncodingBrowser.js","sourceRoot":"","sources":["../src/base64EncodingBrowser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,mFAAmF;AACnF,8EAA8E;AAC9E,yBAAyB;AACzB,EAAE;AACF,4DAA4D;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAa,EAAU,EAAE,CACzD,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAElD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAa,EAAU,EAAE,CACzD,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,KAAa,EAAE,QAA2B,EAAU,EAAE;IAC5E,QAAQ,QAAQ,EAAE,CAAC;QAClB,KAAK,MAAM,CAAC;QACZ,8GAA8G;QAC9G,KAAK,OAAO,CAAC,CAAC,CAAC;YACd,OAAO,KAAK,CAAC;QACd,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACT,OAAO,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC;QACnD,CAAC;IACF,CAAC;AACF,CAAC,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport type { IsoBufferEncoding } from \"./buffer.js\";\n// This file is a browser-specific implementation of the base64 encoding functions.\n// Aside from the below import statement, this file should be identical to the\n// base64EncodingNode.ts.\n//\n// (See 'Isomorphic Code' section in the package README.md.)\nimport { IsoBuffer } from \"./bufferBrowser.js\";\n\n/**\n * Converts the provided {@link https://en.wikipedia.org/wiki/Base64 | base64}-encoded string\n * to {@link https://en.wikipedia.org/wiki/UTF-8 | utf-8}.\n *\n * @internal\n */\nexport const fromBase64ToUtf8 = (input: string): string =>\n\tIsoBuffer.from(input, \"base64\").toString(\"utf8\");\n\n/**\n * Converts the provided {@link https://en.wikipedia.org/wiki/UTF-8 | utf-8}-encoded string\n * to {@link https://en.wikipedia.org/wiki/Base64 | base64}.\n *\n * @internal\n */\nexport const fromUtf8ToBase64 = (input: string): string =>\n\tIsoBuffer.from(input, \"utf8\").toString(\"base64\");\n\n/**\n * Convenience function to convert unknown encoding to utf8 that avoids\n * buffer copies/encode ops when no conversion is needed.\n * @param input - The source string to convert.\n * @param encoding - The source string's encoding.\n *\n * @internal\n */\nexport const toUtf8 = (input: string, encoding: IsoBufferEncoding): string => {\n\tswitch (encoding) {\n\t\tcase \"utf8\":\n\t\t// eslint-disable-next-line unicorn/text-encoding-identifier-case -- this value is supported, just discouraged\n\t\tcase \"utf-8\": {\n\t\t\treturn input;\n\t\t}\n\t\tdefault: {\n\t\t\treturn IsoBuffer.from(input, encoding).toString();\n\t\t}\n\t}\n};\n"]}

package/lib/base64EncodingNode.d.ts

@@ -2,6 +2,7 @@
  * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
  * Licensed under the MIT License.
  */
+import type { IsoBufferEncoding } from "./buffer.js";
 /**
  * Converts the provided {@link https://en.wikipedia.org/wiki/Base64 | base64}-encoded string
  * to {@link https://en.wikipedia.org/wiki/UTF-8 | utf-8}.
@@ -24,5 +25,5 @@ export declare const fromUtf8ToBase64: (input: string) => string;
  *
  * @internal
  */
-export declare const toUtf8: (input: string, encoding: string) => string;
+export declare const toUtf8: (input: string, encoding: IsoBufferEncoding) => string;
 //# sourceMappingURL=base64EncodingNode.d.ts.map

package/lib/base64EncodingNode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base64EncodingNode.d.ts","sourceRoot":"","sources":["../src/base64EncodingNode.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,UAAW,MAAM,KAAG,MACA,CAAC;AAElD;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,UAAW,MAAM,KAAG,MACA,CAAC;AAElD;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM,UAAW,MAAM,YAAY,MAAM,KAAG,MAWxD,CAAC"}
+{"version":3,"file":"base64EncodingNode.d.ts","sourceRoot":"","sources":["../src/base64EncodingNode.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAQrD;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO,MAAM,KAAG,MACA,CAAC;AAElD;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO,MAAM,KAAG,MACA,CAAC;AAElD;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM,GAAI,OAAO,MAAM,EAAE,UAAU,iBAAiB,KAAG,MAWnE,CAAC"}

package/lib/base64EncodingNode.js.map

@@ -1 +1 @@
-{"version":3,"file":"base64EncodingNode.js","sourceRoot":"","sources":["../src/base64EncodingNode.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mFAAmF;AACnF,8EAA8E;AAC9E,4BAA4B;AAC5B,EAAE;AACF,4DAA4D;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAa,EAAU,EAAE,CACzD,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAElD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAa,EAAU,EAAE,CACzD,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,KAAa,EAAE,QAAgB,EAAU,EAAE;IACjE,QAAQ,QAAQ,EAAE,CAAC;QAClB,KAAK,MAAM,CAAC;QACZ,8GAA8G;QAC9G,KAAK,OAAO,CAAC,CAAC,CAAC;YACd,OAAO,KAAK,CAAC;QACd,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACT,OAAO,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC;QACnD,CAAC;IACF,CAAC;AACF,CAAC,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\n// This file is a Node.js-specific implementation of the base64 encoding functions.\n// Aside from the below import statement, this file should be identical to the\n// base64EncodingBrowser.ts.\n//\n// (See 'Isomorphic Code' section in the package README.md.)\nimport { IsoBuffer } from \"./bufferNode.js\";\n\n/**\n * Converts the provided {@link https://en.wikipedia.org/wiki/Base64 | base64}-encoded string\n * to {@link https://en.wikipedia.org/wiki/UTF-8 | utf-8}.\n *\n * @internal\n */\nexport const fromBase64ToUtf8 = (input: string): string =>\n\tIsoBuffer.from(input, \"base64\").toString(\"utf8\");\n\n/**\n * Converts the provided {@link https://en.wikipedia.org/wiki/UTF-8 | utf-8}-encoded string\n * to {@link https://en.wikipedia.org/wiki/Base64 | base64}.\n *\n * @internal\n */\nexport const fromUtf8ToBase64 = (input: string): string =>\n\tIsoBuffer.from(input, \"utf8\").toString(\"base64\");\n\n/**\n * Convenience function to convert unknown encoding to utf8 that avoids\n * buffer copies/encode ops when no conversion is needed.\n * @param input - The source string to convert.\n * @param encoding - The source string's encoding.\n *\n * @internal\n */\nexport const toUtf8 = (input: string, encoding: string): string => {\n\tswitch (encoding) {\n\t\tcase \"utf8\":\n\t\t// eslint-disable-next-line unicorn/text-encoding-identifier-case -- this value is supported, just discouraged\n\t\tcase \"utf-8\": {\n\t\t\treturn input;\n\t\t}\n\t\tdefault: {\n\t\t\treturn IsoBuffer.from(input, encoding).toString();\n\t\t}\n\t}\n};\n"]}
+{"version":3,"file":"base64EncodingNode.js","sourceRoot":"","sources":["../src/base64EncodingNode.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,mFAAmF;AACnF,8EAA8E;AAC9E,4BAA4B;AAC5B,EAAE;AACF,4DAA4D;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAa,EAAU,EAAE,CACzD,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAElD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAa,EAAU,EAAE,CACzD,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,KAAa,EAAE,QAA2B,EAAU,EAAE;IAC5E,QAAQ,QAAQ,EAAE,CAAC;QAClB,KAAK,MAAM,CAAC;QACZ,8GAA8G;QAC9G,KAAK,OAAO,CAAC,CAAC,CAAC;YACd,OAAO,KAAK,CAAC;QACd,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACT,OAAO,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC;QACnD,CAAC;IACF,CAAC;AACF,CAAC,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport type { IsoBufferEncoding } from \"./buffer.js\";\n// This file is a Node.js-specific implementation of the base64 encoding functions.\n// Aside from the below import statement, this file should be identical to the\n// base64EncodingBrowser.ts.\n//\n// (See 'Isomorphic Code' section in the package README.md.)\nimport { IsoBuffer } from \"./bufferNode.js\";\n\n/**\n * Converts the provided {@link https://en.wikipedia.org/wiki/Base64 | base64}-encoded string\n * to {@link https://en.wikipedia.org/wiki/UTF-8 | utf-8}.\n *\n * @internal\n */\nexport const fromBase64ToUtf8 = (input: string): string =>\n\tIsoBuffer.from(input, \"base64\").toString(\"utf8\");\n\n/**\n * Converts the provided {@link https://en.wikipedia.org/wiki/UTF-8 | utf-8}-encoded string\n * to {@link https://en.wikipedia.org/wiki/Base64 | base64}.\n *\n * @internal\n */\nexport const fromUtf8ToBase64 = (input: string): string =>\n\tIsoBuffer.from(input, \"utf8\").toString(\"base64\");\n\n/**\n * Convenience function to convert unknown encoding to utf8 that avoids\n * buffer copies/encode ops when no conversion is needed.\n * @param input - The source string to convert.\n * @param encoding - The source string's encoding.\n *\n * @internal\n */\nexport const toUtf8 = (input: string, encoding: IsoBufferEncoding): string => {\n\tswitch (encoding) {\n\t\tcase \"utf8\":\n\t\t// eslint-disable-next-line unicorn/text-encoding-identifier-case -- this value is supported, just discouraged\n\t\tcase \"utf-8\": {\n\t\t\treturn input;\n\t\t}\n\t\tdefault: {\n\t\t\treturn IsoBuffer.from(input, encoding).toString();\n\t\t}\n\t}\n};\n"]}

package/lib/buffer.d.ts

@@ -0,0 +1,93 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+/**
+ * Declare the subset of node:Buffer functionality we want to make available instead of
+ * exposing the entirely of Node's typings.  These serve as the public interface
+ * of the browser and node implementation.
+ */
+/**
+ * Set of supported encodings for string to buffer conversion.
+ *
+ * @internal
+ */
+export type IsoBufferEncoding = "utf8" | "utf-8" | "base64";
+/**
+ * Minimal Buffer interface for our usages in the browser or Node environments.
+ *
+ * @internal
+ */
+export interface IsoBuffer<TArrayBuffer extends ArrayBufferLike> extends Uint8Array<TArrayBuffer> {
+    /**
+     * 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.
+     */
+    toString(encoding?: IsoBufferEncoding): string;
+}
+/**
+ * Constructor for {@link (IsoBuffer:type)}.
+ *
+ * @internal
+ */
+export interface IsoBufferConstructor {
+    readonly prototype: IsoBuffer<ArrayBufferLike>;
+    new (length: number): IsoBuffer<ArrayBuffer>;
+    new (array: ArrayLike<number>): IsoBuffer<ArrayBuffer>;
+    new <TArrayBuffer extends ArrayBufferLike = ArrayBuffer>(buffer: TArrayBuffer, byteOffset?: number, length?: number): IsoBuffer<TArrayBuffer>;
+    /**
+     * Creates a new `IsoBuffer` containing `string`. The `encoding` parameter identifies
+     * the character encoding to be used when converting `string` into bytes.
+     *
+     * @param string - A string to encode.
+     * @param encoding - The encoding of `string`. **Default:** `'utf8'`.
+     *
+     * @privateRemarks
+     * Node buffer.buffer.d.ts declaration:
+     * `from(string: WithImplicitCoercion<string>, encoding?: IsoBufferEncoding): Buffer<ArrayBuffer>;`
+     */
+    from(string: string, encoding?: IsoBufferEncoding): IsoBuffer<ArrayBuffer>;
+    /**
+     * Allocates a new `IsoBuffer` using an `array` of bytes in the range `0` – `255`.
+     * Array entries outside that range will be truncated to fit into it.
+     *
+     * @param value - `Uint8Array`.
+     *
+     * @remarks
+     * This is limited to `Uint8Array` input to match Node implementation that
+     * takes `ArrayLike<number>` and returns `IsoBuffer<ArrayBuffer>`.
+     *
+     * @privateRemarks
+     * Node buffer.buffer.d.ts declaration:
+     * `from(array: WithImplicitCoercion<ArrayLike<number>>): IsoBuffer<ArrayBuffer>;`
+     */
+    from(array: Uint8Array): IsoBuffer<ArrayBuffer>;
+    /**
+     * This creates a view of the `ArrayBuffer` without copying the underlying
+     * memory. For example, when passed a reference to the `.buffer` property of a
+     * `TypedArray` instance, the newly created `Buffer` will share the same
+     * allocated memory as the `TypedArray`'s underlying `ArrayBuffer`.
+     *
+     * @param arrayBuffer - An `ArrayBuffer`, `SharedArrayBuffer`, for example the
+     * `.buffer` property of a `TypedArray`.
+     * @param byteOffset - Index of first byte to expose. **Default:** `0`.
+     * @param length - Number of bytes to expose. **Default:**
+     * `arrayBuffer.byteLength - byteOffset`.
+     *
+     * @privateRemarks
+     * Node buffer.buffer.d.ts declaration:
+     * ```
+     * public static from<TArrayBuffer extends WithImplicitCoercion<ArrayBufferLike>>(
+     * 		arrayBuffer: TArrayBuffer,
+     * 		byteOffset?: number,
+     * 		length?: number,
+     * ): Buffer<ImplicitArrayBuffer<TArrayBuffer>>;
+     * ```
+     */
+    from<TArrayBuffer extends ArrayBufferLike>(arrayBuffer: TArrayBuffer, byteOffset?: number, length?: number): IsoBuffer<TArrayBuffer>;
+    isBuffer(obj: unknown): obj is IsoBuffer<ArrayBufferLike>;
+}
+//# sourceMappingURL=buffer.d.ts.map

package/lib/buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer.d.ts","sourceRoot":"","sources":["../src/buffer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AAEH;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAC1B,MAAM,GAEN,OAAO,GACP,QAAQ,CAAC;AAEZ;;;;GAIG;AACH,MAAM,WAAW,SAAS,CAAC,YAAY,SAAS,eAAe,CAC9D,SAAQ,UAAU,CAAC,YAAY,CAAC;IAChC;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAAC;CAC/C;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,eAAe,CAAC,CAAC;IAE/C,KAAK,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;IAC7C,KAAK,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;IACvD,KAAK,YAAY,SAAS,eAAe,GAAG,WAAW,EACtD,MAAM,EAAE,YAAY,EACpB,UAAU,CAAC,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,MAAM,GACb,SAAS,CAAC,YAAY,CAAC,CAAC;IAE3B;;;;;;;;;;OAUG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;IAC3E;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;IAChD;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,IAAI,CAAC,YAAY,SAAS,eAAe,EACxC,WAAW,EAAE,YAAY,EACzB,UAAU,CAAC,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,MAAM,GACb,SAAS,CAAC,YAAY,CAAC,CAAC;IAE3B,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,SAAS,CAAC,eAAe,CAAC,CAAC;CAC1D"}

package/lib/buffer.js

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

package/lib/buffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer.js","sourceRoot":"","sources":["../src/buffer.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\n/**\n * Declare the subset of node:Buffer functionality we want to make available instead of\n * exposing the entirely of Node's typings.  These serve as the public interface\n * of the browser and node implementation.\n */\n\n/**\n * Set of supported encodings for string to buffer conversion.\n *\n * @internal\n */\nexport type IsoBufferEncoding =\n\t| \"utf8\"\n\t// eslint-disable-next-line unicorn/text-encoding-identifier-case -- \"utf-8\" value is supported, just discouraged\n\t| \"utf-8\"\n\t| \"base64\";\n\n/**\n * Minimal Buffer interface for our usages in the browser or Node environments.\n *\n * @internal\n */\nexport interface IsoBuffer<TArrayBuffer extends ArrayBufferLike>\n\textends Uint8Array<TArrayBuffer> {\n\t/**\n\t * Convert the buffer to a string.\n\t * Only supports encoding the whole string (unlike the Node `Buffer` equivalent)\n\t * and only utf8 and base64 encodings.\n\t *\n\t * @param encoding - The encoding to use.\n\t */\n\ttoString(encoding?: IsoBufferEncoding): string;\n}\n\n/**\n * Constructor for {@link (IsoBuffer:type)}.\n *\n * @internal\n */\nexport interface IsoBufferConstructor {\n\treadonly prototype: IsoBuffer<ArrayBufferLike>;\n\n\tnew (length: number): IsoBuffer<ArrayBuffer>;\n\tnew (array: ArrayLike<number>): IsoBuffer<ArrayBuffer>;\n\tnew <TArrayBuffer extends ArrayBufferLike = ArrayBuffer>(\n\t\tbuffer: TArrayBuffer,\n\t\tbyteOffset?: number,\n\t\tlength?: number,\n\t): IsoBuffer<TArrayBuffer>;\n\n\t/**\n\t * Creates a new `IsoBuffer` containing `string`. The `encoding` parameter identifies\n\t * the character encoding to be used when converting `string` into bytes.\n\t *\n\t * @param string - A string to encode.\n\t * @param encoding - The encoding of `string`. **Default:** `'utf8'`.\n\t *\n\t * @privateRemarks\n\t * Node buffer.buffer.d.ts declaration:\n\t * `from(string: WithImplicitCoercion<string>, encoding?: IsoBufferEncoding): Buffer<ArrayBuffer>;`\n\t */\n\tfrom(string: string, encoding?: IsoBufferEncoding): IsoBuffer<ArrayBuffer>;\n\t/**\n\t * Allocates a new `IsoBuffer` using an `array` of bytes in the range `0` – `255`.\n\t * Array entries outside that range will be truncated to fit into it.\n\t *\n\t * @param value - `Uint8Array`.\n\t *\n\t * @remarks\n\t * This is limited to `Uint8Array` input to match Node implementation that\n\t * takes `ArrayLike<number>` and returns `IsoBuffer<ArrayBuffer>`.\n\t *\n\t * @privateRemarks\n\t * Node buffer.buffer.d.ts declaration:\n\t * `from(array: WithImplicitCoercion<ArrayLike<number>>): IsoBuffer<ArrayBuffer>;`\n\t */\n\tfrom(array: Uint8Array): IsoBuffer<ArrayBuffer>;\n\t/**\n\t * This creates a view of the `ArrayBuffer` without copying the underlying\n\t * memory. For example, when passed a reference to the `.buffer` property of a\n\t * `TypedArray` instance, the newly created `Buffer` will share the same\n\t * allocated memory as the `TypedArray`'s underlying `ArrayBuffer`.\n\t *\n\t * @param arrayBuffer - An `ArrayBuffer`, `SharedArrayBuffer`, for example the\n\t * `.buffer` property of a `TypedArray`.\n\t * @param byteOffset - Index of first byte to expose. **Default:** `0`.\n\t * @param length - Number of bytes to expose. **Default:**\n\t * `arrayBuffer.byteLength - byteOffset`.\n\t *\n\t * @privateRemarks\n\t * Node buffer.buffer.d.ts declaration:\n\t * ```\n\t * public static from<TArrayBuffer extends WithImplicitCoercion<ArrayBufferLike>>(\n\t * \t\tarrayBuffer: TArrayBuffer,\n\t * \t\tbyteOffset?: number,\n\t * \t\tlength?: number,\n\t * ): Buffer<ImplicitArrayBuffer<TArrayBuffer>>;\n\t * ```\n\t */\n\tfrom<TArrayBuffer extends ArrayBufferLike>(\n\t\tarrayBuffer: TArrayBuffer,\n\t\tbyteOffset?: number,\n\t\tlength?: number,\n\t): IsoBuffer<TArrayBuffer>;\n\n\tisBuffer(obj: unknown): obj is IsoBuffer<ArrayBufferLike>;\n}\n"]}

package/lib/bufferBrowser.d.ts

@@ -2,9 +2,20 @@
  * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
  * Licensed under the MIT License.
  */
+import type { IsoBufferConstructor, IsoBufferEncoding, IsoBuffer as IsoBufferInterface } from "./buffer.js";
+export type { IsoBufferConstructor, IsoBufferEncoding, } from "./buffer.js";
 /**
- * Converts a Uint8Array to a string of the provided encoding
- * Useful when the array might be an {@link IsoBuffer}.
+ * Minimal `Buffer` interface for our usages in the browser or Node.js environments.
+ *
+ * @internal
+ *
+ * @privateRemarks
+ * This type is exported specifically from here to respect combo type+value of same name rules.
+ */
+export type IsoBuffer<TArrayBuffer extends ArrayBufferLike = ArrayBufferLike> = IsoBufferInterface<TArrayBuffer>;
+/**
+ * Converts a `Uint8Array` to a string of the provided encoding
+ * Useful when the array might be an {@link (IsoBuffer:type)}.
  *
  * @param arr - The array to convert.
  * @param encoding - Optional target encoding; only "utf8" and "base64" are
@@ -13,7 +24,7 @@
  *
  * @internal
  */
-export declare function Uint8ArrayToString(arr: Uint8Array, encoding?: "utf8" | "utf-8" | "base64"): string;
+export declare function Uint8ArrayToString(arr: Uint8Array, encoding?: IsoBufferEncoding): string;
 /**
  * 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.
@@ -22,7 +33,7 @@ export declare function Uint8ArrayToString(arr: Uint8Array, encoding?: "utf8" |
  *
  * @internal
  */
-export declare const stringToBuffer: (input: string, encoding: string) => ArrayBuffer;
+export declare const stringToBuffer: (input: string, encoding: IsoBufferEncoding) => ArrayBuffer;
 /**
  * Convert binary blob to string format
  *
@@ -32,53 +43,11 @@ export declare const stringToBuffer: (input: string, encoding: string) => ArrayB
  *
  * @internal
  */
-export declare const bufferToString: (blob: ArrayBufferLike, encoding: "utf8" | "utf-8" | "base64") => string;
-/**
- * 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 declare function isArrayBuffer(obj: unknown): obj is ArrayBuffer;
+export declare const bufferToString: (blob: ArrayBufferLike | Uint8Array, encoding: IsoBufferEncoding) => string;
 /**
- * Minimal implementation of Buffer for our usages in the browser environment.
+ * Minimal implementation of `Buffer` for our usages in the browser environment.
  *
  * @internal
  */
-export declare 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.
-     */
-    toString(encoding?: "utf8" | "utf-8" | "base64"): string;
-    /**
-     * Static constructor
-     * @param value - (string | ArrayBuffer)
-     * @param encodingOrOffset - (string | number)
-     * @param length - (number)
-     *
-     * @privateRemarks TODO: Use actual types
-     */
-    static from(value: any, encodingOrOffset?: any, length?: any): IsoBuffer;
-    static fromArrayBuffer(arrayBuffer: ArrayBuffer, byteOffset?: number, byteLength?: number): IsoBuffer;
-    static fromString(str: string, encoding?: string): IsoBuffer;
-    static isBuffer(obj: unknown): boolean;
-    /**
-     * 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;
-}
+export declare const IsoBuffer: IsoBufferConstructor;
 //# sourceMappingURL=bufferBrowser.d.ts.map

package/lib/bufferBrowser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bufferBrowser.d.ts","sourceRoot":"","sources":["../src/bufferBrowser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CACjC,GAAG,EAAE,UAAU,EAEf,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GACpC,MAAM,CAeR;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,UAAW,MAAM,YAAY,MAAM,KAAG,WAC1B,CAAC;AAExC;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,SACpB,eAAe,YAEX,MAAM,GAAG,OAAO,GAAG,QAAQ,KACnC,MAAiD,CAAC;AAErD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,WAAW,CAW9D;AAED;;;;GAIG;AACH,qBAAa,SAAU,SAAQ,UAAU;IACxC;;;;;;OAMG;IAEI,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM;IAI/D;;;;;;;OAOG;WAEW,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,gBAAgB,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,GAAG,GAAG,SAAS;WAsBjE,eAAe,CAC5B,WAAW,EAAE,WAAW,EACxB,UAAU,CAAC,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,GACjB,SAAS;WAeE,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS;WAoBrD,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO;IAI7C;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;CAkB7B"}
+{"version":3,"file":"bufferBrowser.d.ts","sourceRoot":"","sources":["../src/bufferBrowser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EACX,oBAAoB,EACpB,iBAAiB,EACjB,SAAS,IAAI,kBAAkB,EAC/B,MAAM,aAAa,CAAC;AAErB,YAAY,EACX,oBAAoB,EACpB,iBAAiB,GACjB,MAAM,aAAa,CAAC;AACrB;;;;;;;GAOG;AACH,MAAM,MAAM,SAAS,CAAC,YAAY,SAAS,eAAe,GAAG,eAAe,IAC3E,kBAAkB,CAAC,YAAY,CAAC,CAAC;AAElC;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAexF;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,EAAE,UAAU,iBAAiB,KAAG,WACrC,CAAC;AAExC;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,GAC1B,MAAM,eAAe,GAAG,UAAU,EAClC,UAAU,iBAAiB,KACzB,MACoF,CAAC;AAiCxF;;;;GAIG;AAEH,eAAO,MAAM,SAAS,EAAE,oBA8HQ,CAAC"}

package/lib/bufferBrowser.js

@@ -4,8 +4,8 @@
  */
 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}.
+ * Converts a `Uint8Array` to a string of the provided encoding
+ * Useful when the array might be an {@link (IsoBuffer:type)}.
  *
  * @param arr - The array to convert.
  * @param encoding - Optional target encoding; only "utf8" and "base64" are
@@ -14,9 +14,7 @@ import * as base64js from "base64-js";
  *
  * @internal
  */
-export function Uint8ArrayToString(arr, 
-// eslint-disable-next-line unicorn/text-encoding-identifier-case -- this value is supported, just discouraged
-encoding) {
+export function Uint8ArrayToString(arr, encoding) {
     switch (encoding) {
         case "base64": {
             return base64js.fromByteArray(arr);
@@ -50,9 +48,7 @@ export const stringToBuffer = (input, encoding) => IsoBuffer.from(input, encodin
  *
  * @internal
  */
-export const bufferToString = (blob, 
-// eslint-disable-next-line unicorn/text-encoding-identifier-case -- this value is supported, just discouraged
-encoding) => IsoBuffer.from(blob).toString(encoding);
+export const bufferToString = (blob, encoding) => Uint8ArrayToString(blob instanceof Uint8Array ? blob : IsoBuffer.from(blob), encoding);
 /**
  * Determines if an object is an array buffer.
  *
@@ -63,11 +59,15 @@ encoding) => IsoBuffer.from(blob).toString(encoding);
  * 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.
+ * @param obj - The object to determine if it is `ArrayBufferLike`.
  *
- * @internal
+ * @privateRemarks
+ * This function preserves runtime functionality as it has been in the past.
+ * Typing has been adjusted to reflect the only use that remains and (assuming
+ * is called as expected) will always return true as the input is already
+ * expected to be `ArrayBufferLike`.
  */
-export function isArrayBuffer(obj) {
+function isArrayBufferLike(obj) {
     const maybe = obj;
     return (obj instanceof ArrayBuffer ||
         (typeof maybe === "object" &&
@@ -78,49 +78,36 @@ export function isArrayBuffer(obj) {
             maybe.buffer === undefined));
 }
 /**
- * Minimal implementation of Buffer for our usages in the browser environment.
+ * 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
+// eslint-disable-next-line @typescript-eslint/no-shadow -- Preserve the public constructor name at runtime.
+export const IsoBuffer = class IsoBuffer extends Uint8Array {
+    constructor(value, byteOffset, length) {
+        super(value, byteOffset, length);
+    }
     toString(encoding) {
         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, encodingOrOffset, length) {
         if (typeof value === "string") {
             return IsoBuffer.fromString(value, encodingOrOffset);
             // 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)) {
+        else if (value instanceof Uint8Array) {
             // 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);
+            const copy = new Uint8Array(value.byteLength);
+            copy.set(value);
+            return new IsoBuffer(copy.buffer);
         }
-        else if (isArrayBuffer(value)) {
+        else if (isArrayBufferLike(value)) {
             return IsoBuffer.fromArrayBuffer(value, encodingOrOffset, length);
         }
         else {
-            throw new TypeError("Input value was neither a string nor an ArrayBuffer.");
+            throw new TypeError("Input value was neither a string, a Uint8Array, nor an ArrayBuffer.");
         }
     }
     static fromArrayBuffer(arrayBuffer, byteOffset, byteLength) {
@@ -138,15 +125,17 @@ export class IsoBuffer extends Uint8Array {
         switch (encoding) {
             case "base64": {
                 const sanitizedString = this.sanitizeBase64(str);
+                // base64-js will always return a Uint8Array<ArrayBuffer>, but typing has not
+                // been updated to reflect that yet.  Cast to the correct type here.
                 const encoded = base64js.toByteArray(sanitizedString);
-                return new IsoBuffer(encoded.buffer);
+                return new IsoBuffer(encoded.buffer, encoded.byteOffset, encoded.byteLength);
             }
             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);
+                return new IsoBuffer(encoded.buffer, encoded.byteOffset, encoded.byteLength);
             }
             default: {
                 throw new Error("invalid/unsupported encoding");
@@ -154,7 +143,7 @@ export class IsoBuffer extends Uint8Array {
         }
     }
     static isBuffer(obj) {
-        throw new Error("unimplemented");
+        return obj instanceof IsoBuffer;
     }
     /**
      * Sanitize a base64 string to provide to base64-js library.
@@ -177,5 +166,5 @@ export class IsoBuffer extends Uint8Array {
         }
         return sanitizedStr;
     }
-}
+};
 //# sourceMappingURL=bufferBrowser.js.map

package/lib/bufferBrowser.js.map

@@ -1 +1 @@
-{"version":3,"file":"bufferBrowser.js","sourceRoot":"","sources":["../src/bufferBrowser.ts"],"names":[],"mappings":"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","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport * as base64js from \"base64-js\";\n\n/**\n * Converts a Uint8Array to a string of the provided encoding\n * Useful when the array might be an {@link IsoBuffer}.\n *\n * @param arr - The array to convert.\n * @param encoding - Optional target encoding; only \"utf8\" and \"base64\" are\n * supported, with \"utf8\" being default.\n * @returns The converted string.\n *\n * @internal\n */\nexport function Uint8ArrayToString(\n\tarr: Uint8Array,\n\t// eslint-disable-next-line unicorn/text-encoding-identifier-case -- this value is supported, just discouraged\n\tencoding?: \"utf8\" | \"utf-8\" | \"base64\",\n): string {\n\tswitch (encoding) {\n\t\tcase \"base64\": {\n\t\t\treturn base64js.fromByteArray(arr);\n\t\t}\n\t\tcase \"utf8\":\n\t\t// eslint-disable-next-line unicorn/text-encoding-identifier-case -- this value is supported, just discouraged\n\t\tcase \"utf-8\":\n\t\tcase undefined: {\n\t\t\treturn new TextDecoder().decode(arr);\n\t\t}\n\t\tdefault: {\n\t\t\tthrow new Error(\"invalid/unsupported encoding\");\n\t\t}\n\t}\n}\n\n/**\n * Converts a {@link https://en.wikipedia.org/wiki/Base64 | base64} or\n * {@link https://en.wikipedia.org/wiki/UTF-8 | utf-8} string to array buffer.\n *\n * @param encoding - The input string's encoding.\n *\n * @internal\n */\nexport const stringToBuffer = (input: string, encoding: string): ArrayBuffer =>\n\tIsoBuffer.from(input, encoding).buffer;\n\n/**\n * Convert binary blob to string format\n *\n * @param blob - the binary blob\n * @param encoding - output string's encoding\n * @returns the blob in string format\n *\n * @internal\n */\nexport const bufferToString = (\n\tblob: ArrayBufferLike,\n\t// eslint-disable-next-line unicorn/text-encoding-identifier-case -- this value is supported, just discouraged\n\tencoding: \"utf8\" | \"utf-8\" | \"base64\",\n): string => IsoBuffer.from(blob).toString(encoding);\n\n/**\n * Determines if an object is an array buffer.\n *\n * @remarks Will detect and reject TypedArrays, like Uint8Array.\n * Reason - they can be viewport into Array, they can be accepted, but caller has to deal with\n * math properly (i.e. Take into account byteOffset at minimum).\n * For example, construction of new TypedArray can be in the form of new TypedArray(typedArray) or\n * new TypedArray(buffer, byteOffset, length), but passing TypedArray will result in fist path (and\n * ignoring byteOffice, length).\n *\n * @param obj - The object to determine if it is an ArrayBuffer.\n *\n * @internal\n */\nexport function isArrayBuffer(obj: unknown): obj is ArrayBuffer {\n\tconst maybe = obj as (Partial<ArrayBuffer> & Partial<Uint8Array>) | undefined;\n\treturn (\n\t\tobj instanceof ArrayBuffer ||\n\t\t(typeof maybe === \"object\" &&\n\t\t\tmaybe !== null &&\n\t\t\ttypeof maybe.byteLength === \"number\" &&\n\t\t\ttypeof maybe.slice === \"function\" &&\n\t\t\tmaybe.byteOffset === undefined &&\n\t\t\tmaybe.buffer === undefined)\n\t);\n}\n\n/**\n * Minimal implementation of Buffer for our usages in the browser environment.\n *\n * @internal\n */\nexport class IsoBuffer extends Uint8Array {\n\t/**\n\t * Convert the buffer to a string.\n\t * Only supports encoding the whole string (unlike the Node Buffer equivalent)\n\t * and only utf8 and base64 encodings.\n\t *\n\t * @param encoding - The encoding to use.\n\t */\n\t// eslint-disable-next-line unicorn/text-encoding-identifier-case -- this value is supported, just discouraged\n\tpublic toString(encoding?: \"utf8\" | \"utf-8\" | \"base64\"): string {\n\t\treturn Uint8ArrayToString(this, encoding);\n\t}\n\n\t/**\n\t * Static constructor\n\t * @param value - (string | ArrayBuffer)\n\t * @param encodingOrOffset - (string | number)\n\t * @param length - (number)\n\t *\n\t * @privateRemarks TODO: Use actual types\n\t */\n\t// eslint-disable-next-line @typescript-eslint/explicit-module-boundary-types, @typescript-eslint/no-explicit-any\n\tpublic static from(value: any, encodingOrOffset?: any, length?: any): IsoBuffer {\n\t\tif (typeof value === \"string\") {\n\t\t\treturn IsoBuffer.fromString(value, encodingOrOffset as string | undefined);\n\t\t\t// Capture any typed arrays, including Uint8Array (and thus - IsoBuffer!)\n\t\t\t// eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\n\t\t} else if (value !== null && typeof value === \"object\" && isArrayBuffer(value.buffer)) {\n\t\t\t// The version of the from function for the node buffer, which takes a buffer or typed array\n\t\t\t// as first parameter, does not have any offset or length parameters. Those are just silently\n\t\t\t// ignored and not taken into account\n\t\t\t// eslint-disable-next-line @typescript-eslint/no-unsafe-argument, @typescript-eslint/no-unsafe-member-access\n\t\t\treturn IsoBuffer.fromArrayBuffer(value.buffer, value.byteOffset, value.byteLength);\n\t\t} else if (isArrayBuffer(value)) {\n\t\t\treturn IsoBuffer.fromArrayBuffer(\n\t\t\t\tvalue,\n\t\t\t\tencodingOrOffset as number | undefined,\n\t\t\t\tlength as number,\n\t\t\t);\n\t\t} else {\n\t\t\tthrow new TypeError(\"Input value was neither a string nor an ArrayBuffer.\");\n\t\t}\n\t}\n\n\tpublic static fromArrayBuffer(\n\t\tarrayBuffer: ArrayBuffer,\n\t\tbyteOffset?: number,\n\t\tbyteLength?: number,\n\t): IsoBuffer {\n\t\tconst offset = byteOffset ?? 0;\n\t\tconst validLength = byteLength ?? arrayBuffer.byteLength - offset;\n\t\tif (\n\t\t\toffset < 0 ||\n\t\t\toffset > arrayBuffer.byteLength ||\n\t\t\tvalidLength < 0 ||\n\t\t\tvalidLength + offset > arrayBuffer.byteLength\n\t\t) {\n\t\t\tthrow new RangeError(\"Invalid range specified.\");\n\t\t}\n\n\t\treturn new IsoBuffer(arrayBuffer, offset, validLength);\n\t}\n\n\tpublic static fromString(str: string, encoding?: string): IsoBuffer {\n\t\tswitch (encoding) {\n\t\t\tcase \"base64\": {\n\t\t\t\tconst sanitizedString = this.sanitizeBase64(str);\n\t\t\t\tconst encoded = base64js.toByteArray(sanitizedString);\n\t\t\t\treturn new IsoBuffer(encoded.buffer);\n\t\t\t}\n\t\t\tcase \"utf8\":\n\t\t\t// eslint-disable-next-line unicorn/text-encoding-identifier-case -- this value is supported, just discouraged\n\t\t\tcase \"utf-8\":\n\t\t\tcase undefined: {\n\t\t\t\tconst encoded = new TextEncoder().encode(str);\n\t\t\t\treturn new IsoBuffer(encoded.buffer);\n\t\t\t}\n\t\t\tdefault: {\n\t\t\t\tthrow new Error(\"invalid/unsupported encoding\");\n\t\t\t}\n\t\t}\n\t}\n\n\tpublic static isBuffer(obj: unknown): boolean {\n\t\tthrow new Error(\"unimplemented\");\n\t}\n\n\t/**\n\t * Sanitize a base64 string to provide to base64-js library.\n\t * {@link https://www.npmjs.com/package/base64-js} is not as tolerant of the same malformed base64 as Node'\n\t * Buffer is.\n\t */\n\tprivate static sanitizeBase64(str: string): string {\n\t\tlet sanitizedStr = str;\n\t\t// Remove everything after padding - Node buffer ignores everything\n\t\t// after any padding whereas base64-js does not\n\t\tsanitizedStr = sanitizedStr.split(\"=\")[0];\n\n\t\t// Remove invalid characters - Node buffer strips invalid characters\n\t\t// whereas base64-js replaces them with \"A\"\n\t\tsanitizedStr = sanitizedStr.replace(/[^\\w+-/]/g, \"\");\n\n\t\t// Check for missing padding - Node buffer tolerates missing padding\n\t\t// whereas base64-js does not\n\t\tif (sanitizedStr.length % 4 !== 0) {\n\t\t\tconst paddingArray = [\"\", \"===\", \"==\", \"=\"];\n\t\t\tsanitizedStr += paddingArray[sanitizedStr.length % 4];\n\t\t}\n\t\treturn sanitizedStr;\n\t}\n}\n"]}
+{"version":3,"file":"bufferBrowser.js","sourceRoot":"","sources":["../src/bufferBrowser.ts"],"names":[],"mappings":"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","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport * as base64js from \"base64-js\";\n\nimport type {\n\tIsoBufferConstructor,\n\tIsoBufferEncoding,\n\tIsoBuffer as IsoBufferInterface,\n} from \"./buffer.js\";\n\nexport type {\n\tIsoBufferConstructor,\n\tIsoBufferEncoding,\n} from \"./buffer.js\";\n/**\n * Minimal `Buffer` interface for our usages in the browser or Node.js environments.\n *\n * @internal\n *\n * @privateRemarks\n * This type is exported specifically from here to respect combo type+value of same name rules.\n */\nexport type IsoBuffer<TArrayBuffer extends ArrayBufferLike = ArrayBufferLike> =\n\tIsoBufferInterface<TArrayBuffer>;\n\n/**\n * Converts a `Uint8Array` to a string of the provided encoding\n * Useful when the array might be an {@link (IsoBuffer:type)}.\n *\n * @param arr - The array to convert.\n * @param encoding - Optional target encoding; only \"utf8\" and \"base64\" are\n * supported, with \"utf8\" being default.\n * @returns The converted string.\n *\n * @internal\n */\nexport function Uint8ArrayToString(arr: Uint8Array, encoding?: IsoBufferEncoding): string {\n\tswitch (encoding) {\n\t\tcase \"base64\": {\n\t\t\treturn base64js.fromByteArray(arr);\n\t\t}\n\t\tcase \"utf8\":\n\t\t// eslint-disable-next-line unicorn/text-encoding-identifier-case -- this value is supported, just discouraged\n\t\tcase \"utf-8\":\n\t\tcase undefined: {\n\t\t\treturn new TextDecoder().decode(arr);\n\t\t}\n\t\tdefault: {\n\t\t\tthrow new Error(\"invalid/unsupported encoding\");\n\t\t}\n\t}\n}\n\n/**\n * Converts a {@link https://en.wikipedia.org/wiki/Base64 | base64} or\n * {@link https://en.wikipedia.org/wiki/UTF-8 | utf-8} string to array buffer.\n *\n * @param encoding - The input string's encoding.\n *\n * @internal\n */\nexport const stringToBuffer = (input: string, encoding: IsoBufferEncoding): ArrayBuffer =>\n\tIsoBuffer.from(input, encoding).buffer;\n\n/**\n * Convert binary blob to string format\n *\n * @param blob - the binary blob\n * @param encoding - output string's encoding\n * @returns the blob in string format\n *\n * @internal\n */\nexport const bufferToString = (\n\tblob: ArrayBufferLike | Uint8Array,\n\tencoding: IsoBufferEncoding,\n): string =>\n\tUint8ArrayToString(blob instanceof Uint8Array ? blob : IsoBuffer.from(blob), encoding);\n\n/**\n * Determines if an object is an array buffer.\n *\n * @remarks Will detect and reject TypedArrays, like Uint8Array.\n * Reason - they can be viewport into Array, they can be accepted, but caller has to deal with\n * math properly (i.e. Take into account byteOffset at minimum).\n * For example, construction of new TypedArray can be in the form of new TypedArray(typedArray) or\n * new TypedArray(buffer, byteOffset, length), but passing TypedArray will result in fist path (and\n * ignoring byteOffice, length).\n *\n * @param obj - The object to determine if it is `ArrayBufferLike`.\n *\n * @privateRemarks\n * This function preserves runtime functionality as it has been in the past.\n * Typing has been adjusted to reflect the only use that remains and (assuming\n * is called as expected) will always return true as the input is already\n * expected to be `ArrayBufferLike`.\n */\nfunction isArrayBufferLike(obj: ArrayBufferLike): obj is ArrayBufferLike {\n\tconst maybe = obj as (Partial<ArrayBufferLike> & Partial<Uint8Array>) | undefined;\n\treturn (\n\t\tobj instanceof ArrayBuffer ||\n\t\t(typeof maybe === \"object\" &&\n\t\t\tmaybe !== null &&\n\t\t\ttypeof maybe.byteLength === \"number\" &&\n\t\t\ttypeof maybe.slice === \"function\" &&\n\t\t\tmaybe.byteOffset === undefined &&\n\t\t\tmaybe.buffer === undefined)\n\t);\n}\n\n/**\n * Minimal implementation of `Buffer` for our usages in the browser environment.\n *\n * @internal\n */\n// eslint-disable-next-line @typescript-eslint/no-shadow -- Preserve the public constructor name at runtime.\nexport const IsoBuffer: IsoBufferConstructor = class IsoBuffer<\n\t\tTArrayBuffer extends ArrayBufferLike = ArrayBufferLike,\n\t>\n\textends Uint8Array<TArrayBuffer>\n\timplements IsoBufferInterface<TArrayBuffer>\n{\n\tpublic constructor(\n\t\tvalue: number | ArrayLike<number> | TArrayBuffer,\n\t\tbyteOffset?: number,\n\t\tlength?: number,\n\t) {\n\t\tsuper(value as TArrayBuffer, byteOffset, length);\n\t}\n\n\tpublic toString(encoding?: IsoBufferEncoding): string {\n\t\treturn Uint8ArrayToString(this, encoding);\n\t}\n\n\tpublic static from(\n\t\tvalue: string,\n\t\tencoding?: IsoBufferEncoding,\n\t): IsoBufferInterface<ArrayBuffer>;\n\tpublic static from(value: Uint8Array): IsoBufferInterface<ArrayBuffer>;\n\tpublic static from<TFArrayBuffer extends ArrayBufferLike>(\n\t\tvalue: TFArrayBuffer,\n\t\tbyteOffset?: number,\n\t\tlength?: number,\n\t): IsoBufferInterface<TFArrayBuffer>;\n\tpublic static from<TFArrayBuffer extends ArrayBufferLike>(\n\t\tvalue: string | Uint8Array | TFArrayBuffer,\n\t\tencodingOrOffset?: IsoBufferEncoding | number,\n\t\tlength?: number,\n\t): IsoBufferInterface<ArrayBufferLike> {\n\t\tif (typeof value === \"string\") {\n\t\t\treturn IsoBuffer.fromString(\n\t\t\t\tvalue,\n\t\t\t\tencodingOrOffset as IsoBufferEncoding | undefined,\n\t\t\t) satisfies IsoBufferInterface<ArrayBuffer>;\n\t\t\t// Capture any typed arrays, including Uint8Array (and thus - IsoBuffer!)\n\t\t} else if (value instanceof Uint8Array) {\n\t\t\t// The version of the from function for the node buffer, which takes a buffer or typed array\n\t\t\t// as first parameter, does not have any offset or length parameters. Those are just silently\n\t\t\t// ignored and not taken into account\n\t\t\tconst copy = new Uint8Array(value.byteLength);\n\t\t\tcopy.set(value);\n\t\t\treturn new IsoBuffer<ArrayBuffer>(copy.buffer) satisfies IsoBufferInterface<ArrayBuffer>;\n\t\t} else if (isArrayBufferLike(value)) {\n\t\t\treturn IsoBuffer.fromArrayBuffer(value, encodingOrOffset as number | undefined, length);\n\t\t} else {\n\t\t\tthrow new TypeError(\n\t\t\t\t\"Input value was neither a string, a Uint8Array, nor an ArrayBuffer.\",\n\t\t\t);\n\t\t}\n\t}\n\n\tpublic static fromArrayBuffer<TFArrayBuffer extends ArrayBufferLike>(\n\t\tarrayBuffer: TFArrayBuffer,\n\t\tbyteOffset?: number,\n\t\tbyteLength?: number,\n\t): IsoBufferInterface<TFArrayBuffer> {\n\t\tconst offset = byteOffset ?? 0;\n\t\tconst validLength = byteLength ?? arrayBuffer.byteLength - offset;\n\t\tif (\n\t\t\toffset < 0 ||\n\t\t\toffset > arrayBuffer.byteLength ||\n\t\t\tvalidLength < 0 ||\n\t\t\tvalidLength + offset > arrayBuffer.byteLength\n\t\t) {\n\t\t\tthrow new RangeError(\"Invalid range specified.\");\n\t\t}\n\n\t\treturn new IsoBuffer<TFArrayBuffer>(arrayBuffer, offset, validLength);\n\t}\n\n\tpublic static fromString(\n\t\tstr: string,\n\t\tencoding?: IsoBufferEncoding,\n\t): IsoBufferInterface<ArrayBuffer> {\n\t\tswitch (encoding) {\n\t\t\tcase \"base64\": {\n\t\t\t\tconst sanitizedString = this.sanitizeBase64(str);\n\t\t\t\t// base64-js will always return a Uint8Array<ArrayBuffer>, but typing has not\n\t\t\t\t// been updated to reflect that yet.  Cast to the correct type here.\n\t\t\t\tconst encoded = base64js.toByteArray(sanitizedString) as Uint8Array<ArrayBuffer>;\n\t\t\t\treturn new IsoBuffer(encoded.buffer, encoded.byteOffset, encoded.byteLength);\n\t\t\t}\n\t\t\tcase \"utf8\":\n\t\t\t// eslint-disable-next-line unicorn/text-encoding-identifier-case -- this value is supported, just discouraged\n\t\t\tcase \"utf-8\":\n\t\t\tcase undefined: {\n\t\t\t\tconst encoded = new TextEncoder().encode(str);\n\t\t\t\treturn new IsoBuffer(encoded.buffer, encoded.byteOffset, encoded.byteLength);\n\t\t\t}\n\t\t\tdefault: {\n\t\t\t\tthrow new Error(\"invalid/unsupported encoding\");\n\t\t\t}\n\t\t}\n\t}\n\n\tpublic static isBuffer(obj: unknown): obj is IsoBuffer {\n\t\treturn obj instanceof IsoBuffer;\n\t}\n\n\t/**\n\t * Sanitize a base64 string to provide to base64-js library.\n\t * {@link https://www.npmjs.com/package/base64-js} is not as tolerant of the same malformed base64 as Node'\n\t * Buffer is.\n\t */\n\tprivate static sanitizeBase64(str: string): string {\n\t\tlet sanitizedStr = str;\n\t\t// Remove everything after padding - Node buffer ignores everything\n\t\t// after any padding whereas base64-js does not\n\t\tsanitizedStr = sanitizedStr.split(\"=\")[0];\n\n\t\t// Remove invalid characters - Node buffer strips invalid characters\n\t\t// whereas base64-js replaces them with \"A\"\n\t\tsanitizedStr = sanitizedStr.replace(/[^\\w+-/]/g, \"\");\n\n\t\t// Check for missing padding - Node buffer tolerates missing padding\n\t\t// whereas base64-js does not\n\t\tif (sanitizedStr.length % 4 !== 0) {\n\t\t\tconst paddingArray = [\"\", \"===\", \"==\", \"=\"];\n\t\t\tsanitizedStr += paddingArray[sanitizedStr.length % 4];\n\t\t}\n\t\treturn sanitizedStr;\n\t}\n} satisfies IsoBufferConstructor;\n"]}

package/lib/bufferNode.d.ts

@@ -2,38 +2,86 @@
  * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
  * Licensed under the MIT License.
  */
+import type { IsoBufferConstructor, IsoBufferEncoding, IsoBuffer as IsoBufferInterface } from "./buffer.js";
+export type { IsoBufferConstructor, IsoBufferEncoding } from "./buffer.js";
+/**
+ * Minimal `Buffer` interface for our usages in the browser or Node.js environments.
+ *
+ * @internal
+ *
+ * @privateRemarks
+ * This type is exported specifically from here to respect combo type+value of same name rules.
+ */
+export type IsoBuffer<TArrayBuffer extends ArrayBufferLike = ArrayBufferLike> = IsoBufferInterface<TArrayBuffer>;
 /**
  * Declare the subset of Buffer functionality we want to make available instead of
  * exposing the entirely of Node's typings.  This should match the public interface
- * of the browser implementation, so any changes made in one should be made in both.
+ * of the browser implementation -- see {@link (IsoBuffer:type)} and {@link IsoBufferConstructor}.
  *
  * @internal
  */
-export declare class Buffer extends Uint8Array {
-    toString(encoding?: "utf8" | "utf-8" | "base64"): string;
+export declare class Buffer<TArrayBuffer extends ArrayBufferLike = ArrayBufferLike> extends Uint8Array<TArrayBuffer> implements IsoBuffer<TArrayBuffer> {
+    /**
+     * Creates a new `IsoBuffer` containing `string`. The `encoding` parameter identifies
+     * the character encoding to be used when converting `string` into bytes.
+     *
+     * @param string - A string to encode.
+     * @param encoding - The encoding of `string`. **Default:** `'utf8'`.
+     *
+     * @privateRemarks
+     * Node buffer.buffer.d.ts declaration:
+     * `from(string: WithImplicitCoercion<string>, encoding?: IsoBufferEncoding): Buffer<ArrayBuffer>;`
+     */
+    static from(string: string, encoding?: IsoBufferEncoding): IsoBuffer<ArrayBuffer>;
     /**
-     * Static constructor
+     * Allocates a new `IsoBuffer` using an `array` of bytes in the range `0` – `255`.
+     * Array entries outside that range will be truncated to fit into it.
      *
-     * @param value - (string | ArrayBuffer).
-     * @param encodingOrOffset - (string | number).
-     * @param length - (number).
+     * @param value - `Uint8Array`.
      *
-     * @privateRemarks TODO: Use actual types
+     * @remarks
+     * This is limited to `Uint8Array` input to match Node implementation that
+     * takes `ArrayLike<number>` and returns `IsoBuffer<ArrayBuffer>`.
+     *
+     * @privateRemarks
+     * Node buffer.buffer.d.ts declaration:
+     * `from(array: WithImplicitCoercion<ArrayLike<number>>): IsoBuffer<ArrayBuffer>;`
+     */
+    static from(array: Uint8Array): IsoBuffer<ArrayBuffer>;
+    /**
+     * This creates a view of the `ArrayBuffer` without copying the underlying
+     * memory. For example, when passed a reference to the `.buffer` property of a
+     * `TypedArray` instance, the newly created `Buffer` will share the same
+     * allocated memory as the `TypedArray`'s underlying `ArrayBuffer`.
+     *
+     * @param arrayBuffer - An `ArrayBuffer`, `SharedArrayBuffer`, for example the
+     * `.buffer` property of a `TypedArray`.
+     * @param byteOffset - Index of first byte to expose. **Default:** `0`.
+     * @param length - Number of bytes to expose. **Default:**
+     * `arrayBuffer.byteLength - byteOffset`.
+     *
+     * @privateRemarks
+     * Node buffer.buffer.d.ts declaration:
+     * ```
+     * public static from<TArrayBuffer extends WithImplicitCoercion<ArrayBufferLike>>(
+     * 		arrayBuffer: TArrayBuffer,
+     * 		byteOffset?: number,
+     * 		length?: number,
+     * ): Buffer<ImplicitArrayBuffer<TArrayBuffer>>;
+     * ```
      */
-    static from(value: unknown, encodingOrOffset?: unknown, length?: unknown): IsoBuffer;
+    static from<TArrayBuffer extends ArrayBufferLike>(arrayBuffer: TArrayBuffer, byteOffset?: number, length?: number): IsoBuffer<TArrayBuffer>;
     static isBuffer(obj: unknown): obj is Buffer;
 }
 /**
+ * The native Node.js Buffer implementation.
+ *
  * @internal
  */
-export declare const IsoBuffer: typeof Buffer;
-/**
- * @internal
- */
-export type IsoBuffer = Buffer;
+export declare const IsoBuffer: IsoBufferConstructor;
 /**
- * Converts a Uint8Array to a string of the provided encoding.
- * @remarks Useful when the array might be an IsoBuffer.
+ * Converts a `Uint8Array` to a string of the provided encoding.
+ * @remarks Useful when the array might be an `IsoBuffer`.
  * @param arr - The array to convert.
  * @param encoding - Optional target encoding; only "utf8" and "base64" are
  * supported, with "utf8" being default.
@@ -41,14 +89,14 @@ export type IsoBuffer = Buffer;
  *
  * @internal
  */
-export declare function Uint8ArrayToString(arr: Uint8Array, encoding?: "utf8" | "utf-8" | "base64"): string;
+export declare function Uint8ArrayToString(arr: Uint8Array, encoding?: IsoBufferEncoding): string;
 /**
  * Convert base64 or utf8 string to array buffer.
  * @param encoding - The input string's encoding.
  *
  * @internal
  */
-export declare function stringToBuffer(input: string, encoding: string): ArrayBuffer;
+export declare function stringToBuffer(input: string, encoding: IsoBufferEncoding): ArrayBuffer;
 /**
  * Convert binary blob to string format
  *
@@ -58,5 +106,5 @@ export declare function stringToBuffer(input: string, encoding: string): ArrayBu
  *
  * @internal
  */
-export declare const bufferToString: (blob: ArrayBufferLike, encoding: "utf8" | "utf-8" | "base64") => string;
+export declare const bufferToString: (blob: ArrayBufferLike | Uint8Array, encoding: IsoBufferEncoding) => string;
 //# sourceMappingURL=bufferNode.d.ts.map

package/lib/bufferNode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bufferNode.d.ts","sourceRoot":"","sources":["../src/bufferNode.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,MAAO,SAAQ,UAAU;IAEtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM;IAE/D;;;;;;;;OAQG;WACW,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,gBAAgB,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS;WAC7E,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,MAAM;CACnD;AAED;;GAEG;AACH,eAAO,MAAM,SAAS,eAAS,CAAC;AAEhC;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAE/B;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CACjC,GAAG,EAAE,UAAU,EAEf,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GACpC,MAAM,CAIR;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,CAQ3E;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,SACpB,eAAe,YAEX,MAAM,GAAG,OAAO,GAAG,QAAQ,KACnC,MAAiD,CAAC"}
+{"version":3,"file":"bufferNode.d.ts","sourceRoot":"","sources":["../src/bufferNode.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACX,oBAAoB,EACpB,iBAAiB,EACjB,SAAS,IAAI,kBAAkB,EAC/B,MAAM,aAAa,CAAC;AAErB,YAAY,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC3E;;;;;;;GAOG;AACH,MAAM,MAAM,SAAS,CAAC,YAAY,SAAS,eAAe,GAAG,eAAe,IAC3E,kBAAkB,CAAC,YAAY,CAAC,CAAC;AAElC;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,MAAM,CAAC,YAAY,SAAS,eAAe,GAAG,eAAe,CACjF,SAAQ,UAAU,CAAC,YAAY,CAC/B,YAAW,SAAS,CAAC,YAAY,CAAC;IAElC;;;;;;;;;;OAUG;WACW,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC,WAAW,CAAC;IACxF;;;;;;;;;;;;;OAaG;WACW,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,CAAC,WAAW,CAAC;IAC7D;;;;;;;;;;;;;;;;;;;;;OAqBG;WACW,IAAI,CAAC,YAAY,SAAS,eAAe,EACtD,WAAW,EAAE,YAAY,EACzB,UAAU,CAAC,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,MAAM,GACb,SAAS,CAAC,YAAY,CAAC;WAEZ,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,MAAM;CACnD;AAED;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,oBAA6B,CAAC;AAEtD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAIxF;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,WAAW,CAQtF;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,GAC1B,MAAM,eAAe,GAAG,UAAU,EAClC,UAAU,iBAAiB,KACzB,MACoF,CAAC"}