@atcute/uint8array 1.0.0

package/LICENSE

@@ -0,0 +1,17 @@
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,3 @@
+# @atcute/uint8array
+
+uint8array utilities

package/dist/index.bun.d.ts

@@ -0,0 +1,9 @@
+export declare const alloc: (size: number) => Uint8Array;
+export declare const allocUnsafe: (size: number) => Uint8Array;
+export declare const compare: (a: Uint8Array, b: Uint8Array) => number;
+export declare const equals: (a: Uint8Array, b: Uint8Array) => boolean;
+export declare const timingSafeEquals: (a: Uint8Array, b: Uint8Array) => boolean;
+export declare const concat: (arrays: Uint8Array[], size?: number) => Uint8Array;
+export declare const encodeUtf8Into: (to: Uint8Array, str: string, offset?: number, length?: number) => number;
+export declare const decodeUtf8From: (from: Uint8Array, offset?: number, length?: number) => string;
+export declare const toSha256: (buffer: Uint8Array) => Promise<Uint8Array>;

package/dist/index.bun.js

@@ -0,0 +1,39 @@
+import { allocUnsafe as _allocUnsafe, concatArrayBuffers as _concat } from 'bun';
+import { Buffer as NodeBuffer } from 'node:buffer';
+import { hash as _hash, timingSafeEqual as _timingSafeEqual } from 'node:crypto';
+const _compare = /*#__PURE__*/ NodeBuffer.prototype.compare;
+const _equals = /*#__PURE__*/ NodeBuffer.prototype.equals;
+const _utf8Slice = /*#__PURE__*/ NodeBuffer.prototype.utf8Slice;
+const _utf8Write = /*#__PURE__*/ NodeBuffer.prototype.utf8Write;
+const toUint8Array = (buffer) => {
+    return new Uint8Array(buffer.buffer, buffer.byteOffset, buffer.byteLength);
+};
+export const alloc = (size) => {
+    return new Uint8Array(size);
+};
+export const allocUnsafe = (size) => {
+    return _allocUnsafe(size);
+};
+export const compare = (a, b) => {
+    return _compare.call(a, b);
+};
+export const equals = (a, b) => {
+    return _equals.call(a, b);
+};
+export const timingSafeEquals = (a, b) => {
+    return _timingSafeEqual(a, b);
+};
+export const concat = (arrays, size) => {
+    // Bun's typings is slightly wrong, *you can* pass `size: undefined` with `asUint8Array: true`
+    return _concat(arrays, size, true);
+};
+export const encodeUtf8Into = (to, str, offset, length) => {
+    return _utf8Write.call(to, str, offset, length);
+};
+export const decodeUtf8From = (from, offset = 0, length = from.length) => {
+    return _utf8Slice.call(from, offset, offset + length);
+};
+export const toSha256 = async (buffer) => {
+    return toUint8Array(_hash('SHA-256', buffer, 'buffer'));
+};
+//# sourceMappingURL=index.bun.js.map

package/dist/index.bun.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.bun.js","sourceRoot":"","sources":["../lib/index.bun.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,IAAI,YAAY,EAAE,kBAAkB,IAAI,OAAO,EAAE,MAAM,KAAK,CAAC;AAEjF,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,IAAI,IAAI,KAAK,EAAE,eAAe,IAAI,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEjF,MAAM,QAAQ,GAAG,aAAa,CAAC,UAAU,CAAC,SAAS,CAAC,OAAO,CAAC;AAC5D,MAAM,OAAO,GAAG,aAAa,CAAC,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC;AAC1D,MAAM,UAAU,GAAG,aAAa,CAAC,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC;AAChE,MAAM,UAAU,GAAG,aAAa,CAAC,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC;AAEhE,MAAM,YAAY,GAAG,CAAC,MAAkB,EAAE,EAAE;IAC3C,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;AAC5E,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,IAAY,EAAc,EAAE;IACjD,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAY,EAAc,EAAE;IACvD,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAa,EAAE,CAAa,EAAU,EAAE;IAC/D,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC5B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAa,EAAE,CAAa,EAAW,EAAE;IAC/D,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC3B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAa,EAAE,CAAa,EAAW,EAAE;IACzE,OAAO,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,MAAoB,EAAE,IAAa,EAAc,EAAE;IACzE,8FAA8F;IAC9F,OAAO,OAAO,CAAC,MAAM,EAAE,IAAc,EAAE,IAAI,CAAC,CAAC;AAC9C,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,EAAc,EAAE,GAAW,EAAE,MAAe,EAAE,MAAe,EAAU,EAAE;IACvG,OAAO,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AACjD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAC7B,IAAgB,EAChB,SAAiB,CAAC,EAClB,SAAiB,IAAI,CAAC,MAAM,EACnB,EAAE;IACX,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;AACvD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,EAAE,MAAkB,EAAuB,EAAE;IACzE,OAAO,YAAY,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;AACzD,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * creates an Uint8Array of the requested size, with the contents zeroed
+ */
+export declare const alloc: (size: number) => Uint8Array;
+/**
+ * creates an Uint8Array of the requested size, where the contents may not be
+ * zeroed out. only use if you're certain that the contents will be overwritten
+ */
+export declare const allocUnsafe: (size: number) => Uint8Array;
+/**
+ * compares two Uint8Array buffers
+ */
+export declare const compare: (a: Uint8Array, b: Uint8Array) => number;
+/**
+ * checks if the two Uint8Array buffers are equal
+ */
+export declare const equals: (a: Uint8Array, b: Uint8Array) => boolean;
+/**
+ * checks if the two Uint8Array buffers are equal, timing-safe version
+ */
+export declare const timingSafeEquals: (a: Uint8Array, b: Uint8Array) => boolean;
+/**
+ * concatenates multiple Uint8Array buffers into one
+ */
+export declare const concat: (arrays: Uint8Array[], size?: number) => Uint8Array;
+/**
+ * encodes a UTF-8 string into the buffer
+ */
+export declare const encodeUtf8Into: (to: Uint8Array, str: string, offset?: number, length?: number) => number;
+/**
+ * decodes a UTF-8 string from a buffer
+ */
+export declare const decodeUtf8From: (from: Uint8Array, offset?: number, length?: number) => string;
+/**
+ * get a SHA-256 digest of this buffer
+ */
+export declare const toSha256: (buffer: Uint8Array) => Promise<Uint8Array>;

package/dist/index.js

@@ -0,0 +1,130 @@
+const textEncoder = new TextEncoder();
+const textDecoder = new TextDecoder();
+const subtle = /*#__PURE__*/ crypto.subtle;
+/**
+ * creates an Uint8Array of the requested size, with the contents zeroed
+ */
+export const alloc = (size) => {
+    return new Uint8Array(size);
+};
+/**
+ * creates an Uint8Array of the requested size, where the contents may not be
+ * zeroed out. only use if you're certain that the contents will be overwritten
+ */
+export const allocUnsafe = alloc;
+/**
+ * compares two Uint8Array buffers
+ */
+export const compare = (a, b) => {
+    const alen = a.length;
+    const blen = b.length;
+    if (alen > blen) {
+        return 1;
+    }
+    if (alen < blen) {
+        return -1;
+    }
+    for (let i = 0; i < alen; i++) {
+        const ax = a[i];
+        const bx = b[i];
+        if (ax < bx) {
+            return -1;
+        }
+        if (ax > bx) {
+            return 1;
+        }
+    }
+    return 0;
+};
+/**
+ * checks if the two Uint8Array buffers are equal
+ */
+export const equals = (a, b) => {
+    if (a === b) {
+        return true;
+    }
+    let len;
+    if ((len = a.length) === b.length) {
+        while (len--) {
+            if (a[len] !== b[len]) {
+                return false;
+            }
+        }
+    }
+    return len === -1;
+};
+/**
+ * checks if the two Uint8Array buffers are equal, timing-safe version
+ */
+export const timingSafeEquals = (a, b) => {
+    let len;
+    let out = 0;
+    if ((len = a.length) === b.length) {
+        while (len--) {
+            out |= a[len] ^ b[len];
+        }
+    }
+    return len === -1 && out === 0;
+};
+/**
+ * concatenates multiple Uint8Array buffers into one
+ */
+export const concat = (arrays, size) => {
+    let written = 0;
+    let len = arrays.length;
+    let idx;
+    if (size === undefined) {
+        for (idx = size = 0; idx < len; idx++) {
+            const chunk = arrays[idx];
+            size += chunk.length;
+        }
+    }
+    const buffer = new Uint8Array(size);
+    for (idx = 0; idx < len; idx++) {
+        const chunk = arrays[idx];
+        buffer.set(chunk, written);
+        written += chunk.length;
+    }
+    return buffer;
+};
+/**
+ * encodes a UTF-8 string into the buffer
+ */
+export const encodeUtf8Into = (to, str, offset, length) => {
+    let buffer;
+    if (offset === undefined) {
+        buffer = to;
+    }
+    else if (length === undefined) {
+        buffer = to.subarray(offset);
+    }
+    else {
+        buffer = to.subarray(offset, offset + length);
+    }
+    const result = textEncoder.encodeInto(str, buffer);
+    return result.written;
+};
+/**
+ * decodes a UTF-8 string from a buffer
+ */
+export const decodeUtf8From = (from, offset, length) => {
+    let buffer;
+    if (offset === undefined) {
+        buffer = from;
+    }
+    else if (length === undefined) {
+        buffer = from.subarray(offset);
+    }
+    else {
+        buffer = from.subarray(offset, offset + length);
+    }
+    const result = textDecoder.decode(buffer);
+    return result;
+};
+/**
+ * get a SHA-256 digest of this buffer
+ */
+export const toSha256 = async (buffer) => {
+    return new Uint8Array(await subtle.digest('SHA-256', buffer));
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"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"}

package/dist/index.node.d.ts

@@ -0,0 +1,9 @@
+export declare const alloc: (size: number) => Uint8Array;
+export declare const allocUnsafe: (size: number) => Uint8Array;
+export declare const compare: (a: Uint8Array, b: Uint8Array) => number;
+export declare const equals: (a: Uint8Array, b: Uint8Array) => boolean;
+export declare const timingSafeEquals: (a: Uint8Array, b: Uint8Array) => boolean;
+export declare const concat: (arrays: Uint8Array[], size?: number) => Uint8Array;
+export declare const encodeUtf8Into: (to: Uint8Array, str: string, offset?: number, length?: number) => number;
+export declare const decodeUtf8From: (from: Uint8Array, offset?: number, length?: number) => string;
+export declare const toSha256: (buffer: Uint8Array) => Promise<Uint8Array>;

package/dist/index.node.js

@@ -0,0 +1,40 @@
+import { Buffer as NodeBuffer } from 'node:buffer';
+import { hash as _hash, timingSafeEqual as _timingSafeEqual } from 'node:crypto';
+const _alloc = /*#__PURE__*/ NodeBuffer.alloc;
+const _allocUnsafe = /*#__PURE__*/ NodeBuffer.allocUnsafe;
+const _concat = /*#__PURE__*/ NodeBuffer.concat;
+const _compare = /*#__PURE__*/ NodeBuffer.prototype.compare;
+const _equals = /*#__PURE__*/ NodeBuffer.prototype.equals;
+const _utf8Slice = /*#__PURE__*/ NodeBuffer.prototype.utf8Slice;
+const _utf8Write = /*#__PURE__*/ NodeBuffer.prototype.utf8Write;
+const toUint8Array = (buffer) => {
+    return new Uint8Array(buffer.buffer, buffer.byteOffset, buffer.byteLength);
+};
+export const alloc = (size) => {
+    return toUint8Array(_alloc(size));
+};
+export const allocUnsafe = (size) => {
+    return toUint8Array(_allocUnsafe(size));
+};
+export const compare = (a, b) => {
+    return _compare.call(a, b);
+};
+export const equals = (a, b) => {
+    return _equals.call(a, b);
+};
+export const timingSafeEquals = (a, b) => {
+    return _timingSafeEqual(a, b);
+};
+export const concat = (arrays, size) => {
+    return toUint8Array(_concat(arrays, size));
+};
+export const encodeUtf8Into = (to, str, offset, length) => {
+    return _utf8Write.call(to, str, offset, length);
+};
+export const decodeUtf8From = (from, offset = 0, length = from.length) => {
+    return _utf8Slice.call(from, offset, offset + length);
+};
+export const toSha256 = async (buffer) => {
+    return toUint8Array(_hash('SHA-256', buffer, 'buffer'));
+};
+//# sourceMappingURL=index.node.js.map

package/dist/index.node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.node.js","sourceRoot":"","sources":["../lib/index.node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,IAAI,IAAI,KAAK,EAAE,eAAe,IAAI,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEjF,MAAM,MAAM,GAAG,aAAa,CAAC,UAAU,CAAC,KAAK,CAAC;AAC9C,MAAM,YAAY,GAAG,aAAa,CAAC,UAAU,CAAC,WAAW,CAAC;AAC1D,MAAM,OAAO,GAAG,aAAa,CAAC,UAAU,CAAC,MAAM,CAAC;AAEhD,MAAM,QAAQ,GAAG,aAAa,CAAC,UAAU,CAAC,SAAS,CAAC,OAAO,CAAC;AAC5D,MAAM,OAAO,GAAG,aAAa,CAAC,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC;AAC1D,MAAM,UAAU,GAAG,aAAa,CAAC,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC;AAChE,MAAM,UAAU,GAAG,aAAa,CAAC,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC;AAEhE,MAAM,YAAY,GAAG,CAAC,MAAkB,EAAE,EAAE;IAC3C,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;AAC5E,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,IAAY,EAAc,EAAE;IACjD,OAAO,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;AACnC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAY,EAAc,EAAE;IACvD,OAAO,YAAY,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;AACzC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAa,EAAE,CAAa,EAAU,EAAE;IAC/D,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC5B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAa,EAAE,CAAa,EAAW,EAAE;IAC/D,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC3B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAa,EAAE,CAAa,EAAW,EAAE;IACzE,OAAO,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,MAAoB,EAAE,IAAa,EAAc,EAAE;IACzE,OAAO,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;AAC5C,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,EAAc,EAAE,GAAW,EAAE,MAAe,EAAE,MAAe,EAAU,EAAE;IACvG,OAAO,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AACjD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAC7B,IAAgB,EAChB,SAAiB,CAAC,EAClB,SAAiB,IAAI,CAAC,MAAM,EACnB,EAAE;IACX,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;AACvD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,EAAE,MAAkB,EAAuB,EAAE;IACzE,OAAO,YAAY,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;AACzD,CAAC,CAAC"}

package/lib/index.bun.ts

@@ -0,0 +1,54 @@
+import { allocUnsafe as _allocUnsafe, concatArrayBuffers as _concat } from 'bun';
+
+import { Buffer as NodeBuffer } from 'node:buffer';
+import { hash as _hash, timingSafeEqual as _timingSafeEqual } from 'node:crypto';
+
+const _compare = /*#__PURE__*/ NodeBuffer.prototype.compare;
+const _equals = /*#__PURE__*/ NodeBuffer.prototype.equals;
+const _utf8Slice = /*#__PURE__*/ NodeBuffer.prototype.utf8Slice;
+const _utf8Write = /*#__PURE__*/ NodeBuffer.prototype.utf8Write;
+
+const toUint8Array = (buffer: NodeBuffer) => {
+	return new Uint8Array(buffer.buffer, buffer.byteOffset, buffer.byteLength);
+};
+
+export const alloc = (size: number): Uint8Array => {
+	return new Uint8Array(size);
+};
+
+export const allocUnsafe = (size: number): Uint8Array => {
+	return _allocUnsafe(size);
+};
+
+export const compare = (a: Uint8Array, b: Uint8Array): number => {
+	return _compare.call(a, b);
+};
+
+export const equals = (a: Uint8Array, b: Uint8Array): boolean => {
+	return _equals.call(a, b);
+};
+
+export const timingSafeEquals = (a: Uint8Array, b: Uint8Array): boolean => {
+	return _timingSafeEqual(a, b);
+};
+
+export const concat = (arrays: Uint8Array[], size?: number): Uint8Array => {
+	// Bun's typings is slightly wrong, *you can* pass `size: undefined` with `asUint8Array: true`
+	return _concat(arrays, size as number, true);
+};
+
+export const encodeUtf8Into = (to: Uint8Array, str: string, offset?: number, length?: number): number => {
+	return _utf8Write.call(to, str, offset, length);
+};
+
+export const decodeUtf8From = (
+	from: Uint8Array,
+	offset: number = 0,
+	length: number = from.length,
+): string => {
+	return _utf8Slice.call(from, offset, offset + length);
+};
+
+export const toSha256 = async (buffer: Uint8Array): Promise<Uint8Array> => {
+	return toUint8Array(_hash('SHA-256', buffer, 'buffer'));
+};

package/lib/index.node.ts

@@ -0,0 +1,55 @@
+import { Buffer as NodeBuffer } from 'node:buffer';
+import { hash as _hash, timingSafeEqual as _timingSafeEqual } from 'node:crypto';
+
+const _alloc = /*#__PURE__*/ NodeBuffer.alloc;
+const _allocUnsafe = /*#__PURE__*/ NodeBuffer.allocUnsafe;
+const _concat = /*#__PURE__*/ NodeBuffer.concat;
+
+const _compare = /*#__PURE__*/ NodeBuffer.prototype.compare;
+const _equals = /*#__PURE__*/ NodeBuffer.prototype.equals;
+const _utf8Slice = /*#__PURE__*/ NodeBuffer.prototype.utf8Slice;
+const _utf8Write = /*#__PURE__*/ NodeBuffer.prototype.utf8Write;
+
+const toUint8Array = (buffer: NodeBuffer) => {
+	return new Uint8Array(buffer.buffer, buffer.byteOffset, buffer.byteLength);
+};
+
+export const alloc = (size: number): Uint8Array => {
+	return toUint8Array(_alloc(size));
+};
+
+export const allocUnsafe = (size: number): Uint8Array => {
+	return toUint8Array(_allocUnsafe(size));
+};
+
+export const compare = (a: Uint8Array, b: Uint8Array): number => {
+	return _compare.call(a, b);
+};
+
+export const equals = (a: Uint8Array, b: Uint8Array): boolean => {
+	return _equals.call(a, b);
+};
+
+export const timingSafeEquals = (a: Uint8Array, b: Uint8Array): boolean => {
+	return _timingSafeEqual(a, b);
+};
+
+export const concat = (arrays: Uint8Array[], size?: number): Uint8Array => {
+	return toUint8Array(_concat(arrays, size));
+};
+
+export const encodeUtf8Into = (to: Uint8Array, str: string, offset?: number, length?: number): number => {
+	return _utf8Write.call(to, str, offset, length);
+};
+
+export const decodeUtf8From = (
+	from: Uint8Array,
+	offset: number = 0,
+	length: number = from.length,
+): string => {
+	return _utf8Slice.call(from, offset, offset + length);
+};
+
+export const toSha256 = async (buffer: Uint8Array): Promise<Uint8Array> => {
+	return toUint8Array(_hash('SHA-256', buffer, 'buffer'));
+};

package/lib/index.ts

@@ -0,0 +1,155 @@
+const textEncoder = new TextEncoder();
+const textDecoder = new TextDecoder();
+
+const subtle = /*#__PURE__*/ crypto.subtle;
+
+/**
+ * creates an Uint8Array of the requested size, with the contents zeroed
+ */
+export const alloc = (size: number): Uint8Array => {
+	return new Uint8Array(size);
+};
+
+/**
+ * creates an Uint8Array of the requested size, where the contents may not be
+ * zeroed out. only use if you're certain that the contents will be overwritten
+ */
+export const allocUnsafe = alloc;
+
+/**
+ * compares two Uint8Array buffers
+ */
+export const compare = (a: Uint8Array, b: Uint8Array): number => {
+	const alen = a.length;
+	const blen = b.length;
+
+	if (alen > blen) {
+		return 1;
+	}
+	if (alen < blen) {
+		return -1;
+	}
+
+	for (let i = 0; i < alen; i++) {
+		const ax = a[i];
+		const bx = b[i];
+
+		if (ax < bx) {
+			return -1;
+		}
+
+		if (ax > bx) {
+			return 1;
+		}
+	}
+
+	return 0;
+};
+
+/**
+ * checks if the two Uint8Array buffers are equal
+ */
+export const equals = (a: Uint8Array, b: Uint8Array): boolean => {
+	if (a === b) {
+		return true;
+	}
+
+	let len: number;
+	if ((len = a.length) === b.length) {
+		while (len--) {
+			if (a[len] !== b[len]) {
+				return false;
+			}
+		}
+	}
+
+	return len === -1;
+};
+
+/**
+ * checks if the two Uint8Array buffers are equal, timing-safe version
+ */
+export const timingSafeEquals = (a: Uint8Array, b: Uint8Array): boolean => {
+	let len: number;
+	let out = 0;
+	if ((len = a.length) === b.length) {
+		while (len--) {
+			out |= a[len] ^ b[len];
+		}
+	}
+
+	return len === -1 && out === 0;
+};
+
+/**
+ * concatenates multiple Uint8Array buffers into one
+ */
+export const concat = (arrays: Uint8Array[], size?: number): Uint8Array => {
+	let written = 0;
+
+	let len = arrays.length;
+	let idx: number;
+
+	if (size === undefined) {
+		for (idx = size = 0; idx < len; idx++) {
+			const chunk = arrays[idx];
+			size += chunk.length;
+		}
+	}
+
+	const buffer = new Uint8Array(size);
+
+	for (idx = 0; idx < len; idx++) {
+		const chunk = arrays[idx];
+
+		buffer.set(chunk, written);
+		written += chunk.length;
+	}
+
+	return buffer;
+};
+
+/**
+ * encodes a UTF-8 string into the buffer
+ */
+export const encodeUtf8Into = (to: Uint8Array, str: string, offset?: number, length?: number): number => {
+	let buffer: Uint8Array;
+
+	if (offset === undefined) {
+		buffer = to;
+	} else if (length === undefined) {
+		buffer = to.subarray(offset);
+	} else {
+		buffer = to.subarray(offset, offset + length);
+	}
+
+	const result = textEncoder.encodeInto(str, buffer);
+
+	return result.written;
+};
+
+/**
+ * decodes a UTF-8 string from a buffer
+ */
+export const decodeUtf8From = (from: Uint8Array, offset?: number, length?: number): string => {
+	let buffer: Uint8Array;
+
+	if (offset === undefined) {
+		buffer = from;
+	} else if (length === undefined) {
+		buffer = from.subarray(offset);
+	} else {
+		buffer = from.subarray(offset, offset + length);
+	}
+
+	const result = textDecoder.decode(buffer);
+
+	return result;
+};
+
+/**
+ * get a SHA-256 digest of this buffer
+ */
+export const toSha256 = async (buffer: Uint8Array): Promise<Uint8Array> => {
+	return new Uint8Array(await subtle.digest('SHA-256', buffer));
+};

package/package.json

@@ -0,0 +1,33 @@
+{
+  "type": "module",
+  "name": "@atcute/uint8array",
+  "version": "1.0.0",
+  "description": "uint8array utilities",
+  "license": "MIT",
+  "repository": {
+    "url": "https://github.com/mary-ext/atcute",
+    "directory": "packages/utilities/uint8array"
+  },
+  "files": [
+    "dist/",
+    "lib/",
+    "!lib/**/*.bench.ts",
+    "!lib/**/*.test.ts"
+  ],
+  "exports": {
+    ".": {
+      "bun": "./dist/index.bun.js",
+      "node": "./dist/index.node.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "sideEffects": false,
+  "devDependencies": {
+    "@types/bun": "^1.1.14"
+  },
+  "scripts": {
+    "build": "tsc --project tsconfig.build.json",
+    "test": "bun test --coverage",
+    "prepublish": "rm -rf dist; pnpm run build"
+  }
+}