utilium 3.8.0 → 3.9.0

package/dist/numbers.d.ts

@@ -9,3 +9,7 @@ export declare const formatCompact: {
 };
 export type ToNumber<T extends CoercibleToString> = `${T}` extends `${infer U extends number}` ? U : never;
 export type ToBigInt<T extends CoercibleToString> = `${T}` extends `${infer U extends bigint}` ? U : never;
+/**
+ * Parse a string containing some number of bytes, e.g. `1 GiB` or `99.4kb`
+ */
+export declare function parseBytes(input: string): bigint | null;

package/dist/numbers.js

@@ -15,3 +15,23 @@ export function toRadians(degrees) {
 }
 const __formatter = Intl.NumberFormat('en', { notation: 'compact' });
 export const formatCompact = __formatter.format.bind(__formatter);
+const byteSizePattern = /^(?<size>\d+(?:\.\d+)?)\s*(?<unit>\w*)$/i;
+const units = ['', 'K', 'M', 'G', 'T', 'P', 'E'];
+/**
+ * Parse a string containing some number of bytes, e.g. `1 GiB` or `99.4kb`
+ */
+export function parseBytes(input) {
+    const match = byteSizePattern.exec(input.trim());
+    if (!match)
+        return null;
+    const size = BigInt(match.groups.size);
+    let unit = match.groups.unit.toUpperCase();
+    if (unit.at(-1) == 'B')
+        unit = unit.slice(0, -1);
+    if (unit.at(-1) == 'I')
+        unit = unit.slice(0, -1);
+    const unitIndex = BigInt(units.indexOf(unit));
+    if (unitIndex === -1n)
+        return null;
+    return size * 1024n ** unitIndex;
+}

package/package.json

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