@ethersphere/bee-js 6.5.0 → 6.6.0

package/dist/mjs/utils/data.js

@@ -1,28 +1,3 @@
-import BlobPolyfill from 'fetch-blob';
-import { isNodeReadable, isReadableStream, readableWebToNode } from "./stream.js";
-/**
- * Prepare data for valid input for node-fetch.
- *
- * node-fetch is not using WHATWG ReadableStream but NodeJS Readable so we need to convert in case of ReadableStream,
- * but the typings are set to use ReadableStream so hence why type conversion here.
- *
- * @param data any string, ArrayBuffer, Uint8Array or Readable
- */
-export async function prepareData(data) {
-  if (typeof data === 'string') return new BlobPolyfill([data], {
-    type: 'text/plain'
-  });
-  if (data instanceof Uint8Array || data instanceof ArrayBuffer) {
-    return new BlobPolyfill([data], {
-      type: 'application/octet-stream'
-    });
-  }
-  if (data instanceof BlobPolyfill || isNodeReadable(data)) return data;
-  if (isReadableStream(data)) {
-    return readableWebToNode(data);
-  }
-  throw new TypeError('unknown data type');
-}
 function isBufferArray(buffer) {
   return Array.isArray(buffer) && buffer.length > 0 && buffer.every(data => data instanceof Buffer);
 }

package/dist/mjs/utils/error.js

@@ -8,4 +8,15 @@ export class BeeArgumentError extends BeeError {
     super(message);
     this.value = value;
   }
+}
+export class BeeResponseError extends BeeError {
+  constructor(message, code, axiosStatus, status, config, request, response) {
+    super(message);
+    this.code = code;
+    this.axiosStatus = axiosStatus;
+    this.status = status;
+    this.config = config;
+    this.request = request;
+    this.response = response;
+  }
 }

package/dist/mjs/utils/expose.js

@@ -6,4 +6,4 @@ export { ethToSwarmAddress, fromLittleEndian, isHexEthAddress, makeEthAddress, m
 export { isNodeReadable, isReadable, isReadableStream, normalizeToReadableStream, readableNodeToWeb, readableWebToNode } from "./stream.js";
 export { keccak256Hash } from "./hash.js";
 export { makeMaxTarget } from "./pss.js";
-export { getStampCostInBzz, getStampCostInPlur, getStampMaximumCapacityBytes, getStampTtlSeconds, getStampUsage } from "./stamps.js";
+export { getAmountForTtl, getDepthForCapacity, getStampCostInBzz, getStampCostInPlur, getStampMaximumCapacityBytes, getStampTtlSeconds, getStampUsage } from "./stamps.js";

package/dist/mjs/utils/http.js

@@ -1,9 +1,12 @@
-import axios from 'axios';
+import axios, { AxiosError } from 'axios';
 import { Objects, Strings } from 'cafe-utility';
+import { BeeResponseError } from "../index.js";
 export const DEFAULT_HTTP_CONFIG = {
   headers: {
     accept: 'application/json, text/plain, */*'
-  }
+  },
+  maxBodyLength: Infinity,
+  maxContentLength: Infinity
 };
 /**
  * Main function to make HTTP requests.
@@ -17,6 +20,9 @@ export async function http(options, config) {
     const response = await axios(requestConfig);
     return response;
   } catch (e) {
+    if (e instanceof AxiosError) {
+      throw new BeeResponseError(e.message, e.code, e.status, e.response?.status, e.config, e.request, e.response);
+    }
     throw e;
   }
 }

package/dist/mjs/utils/stamps.js

@@ -44,4 +44,27 @@ export function getStampCostInBzz(depth, amount) {
  */
 export function getStampTtlSeconds(amount, pricePerBlock = 24000, blockTime = 5) {
   return amount * blockTime / pricePerBlock;
+}
+/**
+ * Utility function that calculates the amount of tokens required to maintain a given Time To Live (TTL) for a postage batch.
+ *
+ * This function estimates the required amount based on the provided TTL in days.
+ *
+ * @param {number} days - The Time To Live (TTL) in days.
+ * @returns {NumberString} The estimated amount of tokens needed for the specified TTL.
+ */
+export function getAmountForTtl(days) {
+  // 414720000 = (24 * 60 * 60 * 24_000) / 5
+  return ((days <= 0 ? 1 : days) * 414720000).toString();
+}
+/**
+ * Utility function that calculates the depth required for a postage batch to achieve the specified capacity in gigabytes.
+ *
+ * The depth is determined based on the given gigabytes, and the result is adjusted to a minimum depth of 18.
+ *
+ * @param {number} gigabytes - The desired capacity of the postage batch in gigabytes.
+ * @returns {number} The calculated depth necessary to achieve the specified capacity.
+ */
+export function getDepthForCapacity(gigabytes) {
+  return gigabytes <= 1 ? 18 : Math.ceil(Math.log2(Math.ceil(gigabytes)) + 18);
 }

package/dist/types/index.d.ts

@@ -13,6 +13,7 @@ declare global {
             Utils: typeof import('./utils/expose');
             BeeError: typeof import('./utils/error').BeeError;
             BeeArgumentError: typeof import('./utils/error').BeeArgumentError;
+            BeeResponseError: typeof import('./utils/error').BeeResponseError;
         };
     }
 }

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

@@ -1,13 +1,3 @@
-import type { Data } from 'ws';
 import BlobPolyfill from 'fetch-blob';
-import { Readable } from '../types';
-/**
- * Prepare data for valid input for node-fetch.
- *
- * node-fetch is not using WHATWG ReadableStream but NodeJS Readable so we need to convert in case of ReadableStream,
- * but the typings are set to use ReadableStream so hence why type conversion here.
- *
- * @param data any string, ArrayBuffer, Uint8Array or Readable
- */
-export declare function prepareData(data: string | ArrayBuffer | Uint8Array | Readable): Promise<Blob | ReadableStream<Uint8Array> | never>;
+import type { Data } from 'ws';
 export declare function prepareWebsocketData(data: Data | BlobPolyfill): Promise<Uint8Array> | never;

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

@@ -1,3 +1,4 @@
+import { AxiosRequestConfig, AxiosResponse } from 'axios';
 export declare class BeeError extends Error {
     constructor(message: string);
 }
@@ -5,3 +6,12 @@ export declare class BeeArgumentError extends BeeError {
     readonly value: unknown;
     constructor(message: string, value: unknown);
 }
+export declare class BeeResponseError extends BeeError {
+    code?: string | undefined;
+    axiosStatus?: string | undefined;
+    status?: number | undefined;
+    config?: AxiosRequestConfig<any> | undefined;
+    request?: any;
+    response?: AxiosResponse<any, any> | undefined;
+    constructor(message: string, code?: string | undefined, axiosStatus?: string | undefined, status?: number | undefined, config?: AxiosRequestConfig<any> | undefined, request?: any, response?: AxiosResponse<any, any> | undefined);
+}

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

@@ -6,4 +6,4 @@ export { EthAddress, ethToSwarmAddress, fromLittleEndian, isHexEthAddress, makeE
 export { isNodeReadable, isReadable, isReadableStream, normalizeToReadableStream, readableNodeToWeb, readableWebToNode, } from './stream';
 export { keccak256Hash } from './hash';
 export { makeMaxTarget } from './pss';
-export { getStampCostInBzz, getStampCostInPlur, getStampMaximumCapacityBytes, getStampTtlSeconds, getStampUsage, } from './stamps';
+export { getAmountForTtl, getDepthForCapacity, getStampCostInBzz, getStampCostInPlur, getStampMaximumCapacityBytes, getStampTtlSeconds, getStampUsage, } from './stamps';

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

@@ -1,10 +1,6 @@
 import { AxiosRequestConfig, AxiosResponse } from 'axios';
 import { BeeRequestOptions } from '../index';
-export declare const DEFAULT_HTTP_CONFIG: {
-    headers: {
-        accept: string;
-    };
-};
+export declare const DEFAULT_HTTP_CONFIG: AxiosRequestConfig;
 /**
  * Main function to make HTTP requests.
  * @param options User defined settings

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

@@ -1,3 +1,4 @@
+import { NumberString } from '../types';
 /**
  * Utility function that calculates usage of postage batch based on its utilization, depth and bucket depth.
  *
@@ -34,3 +35,21 @@ export declare function getStampCostInBzz(depth: number, amount: number): number
  * @returns {number} The TTL of the postage batch in seconds.
  */
 export declare function getStampTtlSeconds(amount: number, pricePerBlock?: number, blockTime?: number): number;
+/**
+ * Utility function that calculates the amount of tokens required to maintain a given Time To Live (TTL) for a postage batch.
+ *
+ * This function estimates the required amount based on the provided TTL in days.
+ *
+ * @param {number} days - The Time To Live (TTL) in days.
+ * @returns {NumberString} The estimated amount of tokens needed for the specified TTL.
+ */
+export declare function getAmountForTtl(days: number): NumberString;
+/**
+ * Utility function that calculates the depth required for a postage batch to achieve the specified capacity in gigabytes.
+ *
+ * The depth is determined based on the given gigabytes, and the result is adjusted to a minimum depth of 18.
+ *
+ * @param {number} gigabytes - The desired capacity of the postage batch in gigabytes.
+ * @returns {number} The calculated depth necessary to achieve the specified capacity.
+ */
+export declare function getDepthForCapacity(gigabytes: number): number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ethersphere/bee-js",
-  "version": "6.5.0",
+  "version": "6.6.0",
   "description": "Javascript client for Bee",
   "keywords": [
     "bee",