utilium 1.9.0 → 1.10.1

package/dist/misc.d.ts

@@ -9,3 +9,13 @@ export declare function canary(error?: Error): () => void;
  * @see https://github.com/tc39/proposal-throw-expressions
  */
 export declare function _throw(e: unknown): never;
+interface MemoizeMetadata extends DecoratorMetadata {
+    memoized?: Record<PropertyKey, any>;
+}
+/**
+ * Decorator for memoizing the result of a getter.
+ */
+export declare function memoize<T, This>(get: () => T, context: ClassGetterDecoratorContext<This, T> & {
+    metadata?: MemoizeMetadata;
+}): (this: This) => T;
+export {};

package/dist/misc.js

@@ -46,3 +46,20 @@ export function canary(error = new Error()) {
 export function _throw(e) {
     throw e;
 }
+/**
+ * Decorator for memoizing the result of a getter.
+ */
+export function memoize(get, context) {
+    if (context.kind != 'getter')
+        throw new Error('@memoize can only be used on getters');
+    return function () {
+        context.metadata ??= {};
+        const { memoized = {} } = context.metadata;
+        if (context.name in memoized) {
+            console.log('Using cached value for', context.name, JSON.stringify(memoized[context.name]));
+            return memoized[context.name];
+        }
+        memoized[context.name] = get.call(this);
+        return memoized[context.name];
+    };
+}

package/dist/string.js

@@ -16,7 +16,13 @@ const decoder = new TextDecoder();
  * Decodes a UTF-8 string from a buffer
  */
 export function decodeUTF8(input) {
-    return decoder.decode(input);
+    if (!input)
+        return '';
+    if (input.buffer instanceof ArrayBuffer && !input.buffer.resizable)
+        return decoder.decode(input);
+    const buffer = new Uint8Array(input.byteLength);
+    buffer.set(input);
+    return decoder.decode(buffer);
 }
 export function encodeASCII(input) {
     const data = new Uint8Array(input.length);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "utilium",
-	"version": "1.9.0",
+	"version": "1.10.1",
 	"description": "Typescript utilities",
 	"funding": {
 		"type": "individual",

package/src/misc.ts

@@ -52,3 +52,29 @@ export function canary(error: Error = new Error()) {
 export function _throw(e: unknown): never {
 	throw e;
 }
+
+interface MemoizeMetadata extends DecoratorMetadata {
+	memoized?: Record<PropertyKey, any>;
+}
+
+/**
+ * Decorator for memoizing the result of a getter.
+ */
+export function memoize<T, This>(
+	get: () => T,
+	context: ClassGetterDecoratorContext<This, T> & { metadata?: MemoizeMetadata }
+) {
+	if (context.kind != 'getter') throw new Error('@memoize can only be used on getters');
+
+	return function (this: This): T {
+		context.metadata ??= {};
+		const { memoized = {} } = context.metadata;
+
+		if (context.name in memoized) {
+			console.log('Using cached value for', context.name, JSON.stringify(memoized[context.name]));
+			return memoized[context.name];
+		}
+		memoized[context.name] = get.call(this);
+		return memoized[context.name];
+	};
+}

package/src/string.ts

@@ -36,7 +36,13 @@ const decoder = new TextDecoder();
  * Decodes a UTF-8 string from a buffer
  */
 export function decodeUTF8(input?: Uint8Array): string {
-	return decoder.decode(input);
+	if (!input) return '';
+
+	if (input.buffer instanceof ArrayBuffer && !input.buffer.resizable) return decoder.decode(input);
+
+	const buffer = new Uint8Array(input.byteLength);
+	buffer.set(input);
+	return decoder.decode(buffer);
 }
 
 export function encodeASCII(input: string): Uint8Array {