@ethersphere/bee-js 10.0.1 → 10.1.0

package/dist/cjs/utils/duration.js

@@ -30,6 +30,32 @@ class Duration {
     static fromEndDate(endDate, startDate) {
         return new Duration((endDate.getTime() - (startDate ?? new Date()).getTime()) / 1000);
     }
+    /**
+     * Parses a duration string and returns a `Duration` instance.
+     *
+     * Case insensitive. E.g. both `"28h"` and `"1D"` are valid.
+     *
+     * Whitespaces are ignored. E.g. both `"5 d"` and `"2weeks"` are valid.
+     *
+     * Decimal numbers are supported. E.g. `"1.5h"` is valid.
+     *
+     * Supported units:
+     *
+     * - ms, milli, millis, millisecond, milliseconds
+     * - s, sec, second, seconds
+     * - m, min, minute, minutes
+     * - h, hour, hours
+     * - d, day, days
+     * - w, week, weeks
+     * - month, months
+     * - y, year, years
+     *
+     * @param duration - A string representing a duration
+     * @returns a `Duration` instance
+     */
+    static parseFromString(duration) {
+        return Duration.fromSeconds(cafe_utility_1.Dates.make(duration) / 1000);
+    }
     toSeconds() {
         return this.seconds;
     }

package/dist/cjs/utils/size.js

@@ -28,6 +28,31 @@ class Size {
     static fromGigabytes(gigabytes) {
         return new Size(gigabytes * 1000 * 1000 * 1000);
     }
+    /**
+     * Parses a size string and returns a `Size` instance.
+     *
+     * Case insensitive. E.g. both `"28MB"` and `"1gb"` are valid.
+     *
+     * Whitespaces are ignored. E.g. both `"512 kb"` and `"2megabytes"` are valid.
+     *
+     * Decimal numbers are supported. E.g. `"1.5gb"` is valid.
+     *
+     * Uses 1000 as the base for conversions. E.g. 1kb = 1000 bytes.
+     * This is consistent with the effective stamp utilization table.
+     *
+     * Supported units:
+     * - b, byte, bytes
+     * - kb, kilobyte, kilobytes
+     * - mb, megabyte, megabytes
+     * - gb, gigabyte, gigabytes
+     * - tb, terabyte, terabytes
+     *
+     * @param size - A string representing a size
+     * @returns a `Size` instance
+     */
+    static parseFromString(size) {
+        return Size.fromBytes(cafe_utility_1.Numbers.makeStorage(size, 1000));
+    }
     toBytes() {
         return this.bytes;
     }