@ethersphere/bee-js 10.0.0 → 10.1.0

package/dist/cjs/utils/bytes.js

@@ -1,11 +1,19 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseSizeToBytes = exports.Bytes = void 0;
 const cafe_utility_1 = require("cafe-utility");
+const debug_1 = __importDefault(require("debug"));
+const debug = (0, debug_1.default)('bee-js:bytes');
 const DECODER = new TextDecoder();
 const ENCODER = new TextEncoder();
 class Bytes {
     constructor(bytes, byteLength) {
+        if (!bytes) {
+            throw Error(`Bytes#constructor: constructor parameter is falsy: ${bytes}`);
+        }
         if (bytes instanceof Bytes) {
             this.bytes = bytes.bytes;
         }
@@ -15,9 +23,21 @@ class Bytes {
         else if (bytes instanceof ArrayBuffer) {
             this.bytes = new Uint8Array(bytes);
         }
-        else {
+        else if (bytes instanceof Uint8Array) {
             this.bytes = bytes;
         }
+        else {
+            const unknownInput = bytes;
+            const toHex = cafe_utility_1.Objects.getDeep(unknownInput, 'toHex');
+            if (cafe_utility_1.Types.isFunction(toHex)) {
+                const hex = toHex.call(unknownInput);
+                this.bytes = cafe_utility_1.Binary.hexToUint8Array(cafe_utility_1.Types.asHexString(hex, { name: 'Bytes#constructor(bytes)' }));
+            }
+            else {
+                debug('bytes', bytes);
+                throw new Error(`Bytes#constructor: unsupported type: ${typeof bytes}`);
+            }
+        }
         this.length = this.bytes.length;
         if (byteLength) {
             if (Array.isArray(byteLength)) {

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;
     }