@ethersphere/bee-js 10.0.1 → 10.1.0

package/dist/mjs/utils/duration.js

@@ -27,6 +27,32 @@ export 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(Dates.make(duration) / 1000);
+  }
   toSeconds() {
     return this.seconds;
   }

package/dist/mjs/utils/size.js

@@ -25,6 +25,31 @@ export 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(Numbers.makeStorage(size, 1000));
+  }
   toBytes() {
     return this.bytes;
   }

package/dist/types/utils/duration.d.ts

@@ -9,6 +9,30 @@ export declare class Duration {
     static fromWeeks(weeks: number): Duration;
     static fromYears(years: number): Duration;
     static fromEndDate(endDate: Date, startDate?: Date): Duration;
+    /**
+     * 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: string): Duration;
     toSeconds(): number;
     toHours(): number;
     toDays(): number;

package/dist/types/utils/size.d.ts

@@ -12,6 +12,29 @@ export declare class Size {
     static fromKilobytes(kilobytes: number): Size;
     static fromMegabytes(megabytes: number): Size;
     static fromGigabytes(gigabytes: number): Size;
+    /**
+     * 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: string): Size;
     toBytes(): number;
     toGigabytes(): number;
     toFormattedString(): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ethersphere/bee-js",
-  "version": "10.0.1",
+  "version": "10.1.0",
   "description": "Javascript client for Bee",
   "keywords": [
     "bee",
@@ -62,7 +62,7 @@
   },
   "dependencies": {
     "axios": "^0.30.0",
-    "cafe-utility": "^31.0.0",
+    "cafe-utility": "^32.2.0",
     "debug": "^4.4.1",
     "isomorphic-ws": "^4.0.1",
     "semver": "^7.3.5",