@upcoming/bee-js 0.3.0 → 0.5.0

package/dist/mjs/utils/type.js

@@ -1,8 +1,8 @@
 import { Types } from 'cafe-utility';
 import * as stream from 'stream';
 import { TAGS_LIMIT_MAX, TAGS_LIMIT_MIN } from "../types/index.js";
-import { BeeArgumentError } from "./error.js";
 import { isFile } from "./file.js";
+import { PublicKey, Reference } from "./typed-bytes.js";
 export function isReadable(obj) {
   return typeof stream.Readable !== 'undefined' && obj instanceof stream.Readable;
 }
@@ -12,153 +12,204 @@ export function asNumberString(value, options) {
   }
   return Types.asIntegerString(value, options);
 }
-export function isInteger(value) {
-  return typeof value === 'string' && /^-?(0|[1-9][0-9]*)$/g.test(value) || typeof value === 'number' && value > Number.MIN_SAFE_INTEGER && value < Number.MAX_SAFE_INTEGER && Number.isInteger(value);
-}
-export function isObject(value) {
-  return value !== null && typeof value === 'object';
-}
-export function isStrictlyObject(value) {
-  return isObject(value) && !Array.isArray(value);
-}
-export function assertStrictlyObject(value, name = 'value') {
-  if (!isStrictlyObject(value)) {
-    throw new TypeError(`${name} has to be an object that is not null nor array!`);
-  }
-}
-export function assertBoolean(value, name = 'value') {
-  if (value !== true && value !== false) throw new TypeError(`${name} is not boolean`);
-}
-export function assertInteger(value, name = 'value') {
-  if (!isInteger(value)) throw new TypeError(`${name} is not integer`);
+export function prepareBeeRequestOptions(value) {
+  const object = Types.asObject(value, {
+    name: 'BeeRequestOptions'
+  });
+  return {
+    baseURL: Types.asOptional(x => Types.asString(x, {
+      name: 'baseURL'
+    }), object.baseURL),
+    timeout: Types.asOptional(x => Types.asInteger(x, {
+      name: 'timeout',
+      min: 0
+    }), object.timeout),
+    headers: Types.asOptional(x => Types.asStringMap(x, {
+      name: 'headers'
+    }), object.headers),
+    onRequest: Types.asOptional(x => Types.asFunction(x, {
+      name: 'onRequest'
+    }), object.onRequest),
+    httpAgent: object.httpAgent,
+    httpsAgent: object.httpsAgent,
+    endlesslyRetry: Types.asOptional(x => Types.asBoolean(x, {
+      name: 'endlesslyRetry'
+    }), object.endlesslyRetry)
+  };
 }
-export function assertNonNegativeInteger(value, name = 'Value') {
-  assertInteger(value, name);
-  if (Number(value) < 0) throw new BeeArgumentError(`${name} has to be bigger or equal to zero`, value);
+export function prepareDownloadOptions(value) {
+  const object = Types.asObject(value, {
+    name: 'DownloadOptions'
+  });
+  return {
+    redundancyStrategy: Types.asOptional(x => Types.asInteger(x, {
+      name: 'redundancyStrategy'
+    }), object.redundancyStrategy),
+    fallback: Types.asOptional(x => Types.asBoolean(x, {
+      name: 'fallback'
+    }), object.fallback),
+    timeoutMs: Types.asOptional(x => Types.asInteger(x, {
+      name: 'timeoutMs',
+      min: 0
+    }), object.timeoutMs),
+    actPublisher: Types.asOptional(x => new PublicKey(x), object.actPublisher),
+    actHistoryAddress: Types.asOptional(x => new Reference(x), object.actHistoryAddress),
+    actTimestamp: Types.asOptional(x => Types.asNumber(x, {
+      name: 'actTimestamp'
+    }), object.actTimestamp)
+  };
 }
-export function assertRequestOptions(value, name = 'RequestOptions') {
-  if (value === undefined) {
-    return;
-  }
-  if (!isStrictlyObject(value)) {
-    throw new TypeError(`${name} has to be an object!`);
-  }
-  const options = value;
-  if (options.timeout) {
-    assertNonNegativeInteger(options.timeout, `${name}.timeout`);
-  }
+export function prepareUploadOptions(value, name = 'UploadOptions') {
+  const object = Types.asObject(value, {
+    name
+  });
+  return {
+    act: Types.asOptional(x => Types.asBoolean(x, {
+      name: 'act'
+    }), object.act),
+    deferred: Types.asOptional(x => Types.asBoolean(x, {
+      name: 'deferred'
+    }), object.deferred),
+    encrypt: Types.asOptional(x => Types.asBoolean(x, {
+      name: 'encrypt'
+    }), object.encrypt),
+    pin: Types.asOptional(x => Types.asBoolean(x, {
+      name: 'pin'
+    }), object.pin),
+    tag: Types.asOptional(x => Types.asInteger(x, {
+      name: 'tag',
+      min: 0
+    }), object.tag)
+  };
 }
-export function assertUploadOptions(value, name = 'UploadOptions') {
-  if (!isStrictlyObject(value)) {
-    throw new TypeError(`${name} has to be an object!`);
-  }
-  assertRequestOptions(value, name);
-  const options = value;
-  if (options.pin && typeof options.pin !== 'boolean') {
-    throw new TypeError(`options.pin property in ${name} has to be boolean or undefined!`);
-  }
-  if (options.encrypt && typeof options.encrypt !== 'boolean') {
-    throw new TypeError(`options.encrypt property in ${name} has to be boolean or undefined!`);
-  }
-  if (options.tag) {
-    if (typeof options.tag !== 'number') {
-      throw new TypeError(`options.tag property in ${name} has to be number or undefined!`);
-    }
-    assertNonNegativeInteger(options.tag, 'options.tag');
-  }
+export function prepareRedundantUploadOptions(value, name = 'UploadOptions') {
+  const uploadOptions = prepareUploadOptions(value, name);
+  const object = Types.asObject(value, {
+    name
+  });
+  return {
+    ...uploadOptions,
+    redundancyLevel: Types.asOptional(x => Types.asInteger(x, {
+      name: 'redundancyLevel',
+      min: 0
+    }), object.redundancyLevel)
+  };
 }
-export function assertFileUploadOptions(value) {
-  assertUploadOptions(value, 'FileUploadOptions');
-  const options = value;
-  if (options.size) {
-    if (typeof options.size !== 'number') {
-      throw new TypeError('tag property in FileUploadOptions has to be number or undefined!');
-    }
-    assertNonNegativeInteger(options.size, 'options.size');
-  }
-  if (options.contentType && typeof options.contentType !== 'string') {
-    throw new TypeError('contentType property in FileUploadOptions has to be string or undefined!');
-  }
+export function prepareFileUploadOptions(value) {
+  const uploadOptions = prepareUploadOptions(value, 'FileUploadOptions');
+  const object = Types.asObject(value, {
+    name: 'FileUploadOptions'
+  });
+  return {
+    ...uploadOptions,
+    size: Types.asOptional(x => Types.asInteger(x, {
+      name: 'size',
+      min: 0
+    }), object.size),
+    contentType: Types.asOptional(x => Types.asString(x, {
+      name: 'contentType'
+    }), object.contentType),
+    redundancyLevel: Types.asOptional(x => Types.asInteger(x, {
+      name: 'redundancyLevel',
+      min: 0
+    }), object.redundancyLevel)
+  };
 }
-export function assertCollectionUploadOptions(value) {
-  assertUploadOptions(value, 'CollectionUploadOptions');
-  const options = value;
-  if (options.indexDocument && typeof options.indexDocument !== 'string') {
-    throw new TypeError('indexDocument property in CollectionUploadOptions has to be string or undefined!');
-  }
-  if (options.errorDocument && typeof options.errorDocument !== 'string') {
-    throw new TypeError('errorDocument property in CollectionUploadOptions has to be string or undefined!');
-  }
+export function prepareCollectionUploadOptions(value) {
+  const uploadOptions = prepareUploadOptions(value, 'CollectionUploadOptions');
+  const object = Types.asObject(value, {
+    name: 'CollectionUploadOptions'
+  });
+  return {
+    ...uploadOptions,
+    errorDocument: Types.asOptional(x => Types.asString(x, {
+      name: 'errorDocument'
+    }), object.errorDocument),
+    indexDocument: Types.asOptional(x => Types.asString(x, {
+      name: 'indexDocument'
+    }), object.indexDocument),
+    redundancyLevel: Types.asOptional(x => Types.asInteger(x, {
+      name: 'redundancyLevel',
+      min: 0
+    }), object.redundancyLevel)
+  };
 }
 export function isTag(value) {
-  if (!isStrictlyObject(value)) {
+  try {
+    const object = Types.asObject(value, {
+      name: 'Tag'
+    });
+    Types.asInteger(object.uid, {
+      name: 'Tag.uid'
+    });
+    return true;
+  } catch {
     return false;
   }
-  return Boolean(value.uid);
 }
-export function assertPssMessageHandler(value) {
+export function preparePssMessageHandler(value) {
   const object = Types.asObject(value, {
     name: 'PssMessageHandler'
   });
-  Types.asFunction(object.onMessage, {
-    name: 'onMessage'
-  });
-  Types.asFunction(object.onError, {
-    name: 'onError'
-  });
+  return {
+    onMessage: Types.asFunction(object.onMessage, {
+      name: 'onMessage'
+    }),
+    onError: Types.asFunction(object.onError, {
+      name: 'onError'
+    })
+  };
 }
-export function assertGsocMessageHandler(value) {
+export function prepareGsocMessageHandler(value) {
   const object = Types.asObject(value, {
     name: 'GsocMessageHandler'
   });
-  Types.asFunction(object.onMessage, {
-    name: 'onMessage'
-  });
-  Types.asFunction(object.onError, {
-    name: 'onError'
-  });
-}
-export function assertPostageBatchOptions(value) {
-  if (value === undefined) {
-    return;
-  }
-  assertStrictlyObject(value);
-  const options = value;
-  assertRequestOptions(options, 'PostageBatchOptions');
-  if (options?.gasPrice) {
-    assertNonNegativeInteger(options.gasPrice);
-  }
-  if (options?.immutableFlag !== undefined) {
-    assertBoolean(options.immutableFlag);
-  }
-  if (options?.waitForUsable !== undefined) {
-    assertBoolean(options.waitForUsable);
-  }
-  if (options?.waitForUsableTimeout !== undefined) {
-    assertNonNegativeInteger(options.waitForUsableTimeout, 'options.waitForUsableTimeout');
-  }
+  return {
+    onMessage: Types.asFunction(object.onMessage, {
+      name: 'onMessage'
+    }),
+    onError: Types.asFunction(object.onError, {
+      name: 'onError'
+    })
+  };
 }
-export function assertTransactionOptions(value, name = 'TransactionOptions') {
-  if (value === undefined) {
-    return;
-  }
-  assertStrictlyObject(value, name);
-  const options = value;
-  if (options?.gasLimit) {
-    assertNonNegativeInteger(options.gasLimit, name);
-  }
-  if (options?.gasPrice) {
-    assertNonNegativeInteger(options.gasPrice, name);
-  }
+export function preparePostageBatchOptions(value) {
+  const object = Types.asObject(value, {
+    name: 'PostageBatchOptions'
+  });
+  return {
+    gasPrice: Types.asOptional(x => asNumberString(x, {
+      name: 'gasPrice'
+    }), object.gasPrice),
+    immutableFlag: Types.asOptional(x => Types.asBoolean(x, {
+      name: 'immutableFlag'
+    }), object.immutableFlag),
+    label: Types.asOptional(x => Types.asString(x, {
+      name: 'label'
+    }), object.label),
+    waitForUsable: Types.asOptional(x => Types.asBoolean(x, {
+      name: 'waitForUsable'
+    }), object.waitForUsable),
+    waitForUsableTimeout: Types.asOptional(x => Types.asInteger(x, {
+      name: 'waitForUsableTimeout',
+      min: 0
+    }), object.waitForUsableTimeout)
+  };
 }
-export function assertCashoutOptions(value) {
-  if (value === undefined) {
-    return;
-  }
-  assertStrictlyObject(value);
-  const options = value;
-  assertRequestOptions(options, 'CashoutOptions');
-  assertTransactionOptions(options, 'CashoutOptions');
+export function prepareTransactionOptions(value, name = 'TransactionOptions') {
+  const object = Types.asObject(value, {
+    name
+  });
+  return {
+    gasLimit: Types.asOptional(x => asNumberString(x, {
+      name: 'gasLimit',
+      min: 0n
+    }), object.gasLimit),
+    gasPrice: Types.asOptional(x => asNumberString(x, {
+      name: 'gasPrice',
+      min: 0n
+    }), object.gasPrice)
+  };
 }
 /**
  * Check whether the given parameter is valid data to upload
@@ -184,26 +235,21 @@ export function assertFileData(value) {
  * Checks whether optional options for AllTags query are valid
  * @param options
  */
-export function assertAllTagsOptions(entry) {
-  if (entry !== undefined && !isStrictlyObject(entry)) {
-    throw new TypeError('options has to be an object or undefined!');
-  }
-  assertRequestOptions(entry, 'AllTagsOptions');
-  const options = entry;
-  if (options?.limit !== undefined) {
-    if (typeof options.limit !== 'number') {
-      throw new TypeError('AllTagsOptions.limit has to be a number or undefined!');
-    }
-    if (options.limit < TAGS_LIMIT_MIN) {
-      throw new BeeArgumentError(`AllTagsOptions.limit has to be at least ${TAGS_LIMIT_MIN}`, options.limit);
-    }
-    if (options.limit > TAGS_LIMIT_MAX) {
-      throw new BeeArgumentError(`AllTagsOptions.limit has to be at most ${TAGS_LIMIT_MAX}`, options.limit);
-    }
-  }
-  if (options?.offset !== undefined) {
-    assertNonNegativeInteger(options.offset, 'AllTagsOptions.offset');
-  }
+export function prepareAllTagsOptions(value) {
+  const object = Types.asObject(value, {
+    name: 'AllTagsOptions'
+  });
+  return {
+    limit: Types.asOptional(x => Types.asInteger(x, {
+      name: 'limit',
+      min: TAGS_LIMIT_MIN,
+      max: TAGS_LIMIT_MAX
+    }), object.limit),
+    offset: Types.asOptional(x => Types.asInteger(x, {
+      name: 'offset',
+      min: 0
+    }), object.offset)
+  };
 }
 /**
  * Utility functions that return Tag UID
@@ -211,22 +257,15 @@ export function assertAllTagsOptions(entry) {
  */
 export function makeTagUid(tagUid) {
   if (tagUid === undefined || tagUid === null) {
-    throw new TypeError('TagUid was expected but got undefined or null instead!');
+    throw new TypeError(`Expected number | Tag | string from tagUid, got: ${tagUid}`);
   }
   if (isTag(tagUid)) {
     return tagUid.uid;
-  } else if (typeof tagUid === 'number') {
-    assertNonNegativeInteger(tagUid, 'UID');
-    return tagUid;
-  } else if (typeof tagUid === 'string') {
-    const int = parseInt(tagUid);
-    if (isNaN(int)) {
-      throw new TypeError('Passed tagUid string is not valid integer!');
-    }
-    if (int < 0) {
-      throw new TypeError(`TagUid was expected to be positive non-negative integer! Got ${int}`);
-    }
-    return int;
+  } else if (typeof tagUid === 'number' || typeof tagUid === 'string') {
+    return Types.asNumber(tagUid, {
+      name: 'tagUid',
+      min: 0
+    });
   }
-  throw new TypeError('tagUid has to be either Tag or a number (UID)!');
+  throw new TypeError(`Expected number | Tag | string from tagUid, got: ${tagUid}`);
 }

package/dist/types/bee-dev.d.ts

@@ -0,0 +1,5 @@
+import { Bee, BeeRequestOptions, NodeAddresses, Topology } from '.';
+export declare class BeeDev extends Bee {
+    getNodeAddresses(options?: BeeRequestOptions): Promise<NodeAddresses>;
+    getTopology(options?: BeeRequestOptions): Promise<Topology>;
+}

package/dist/types/bee.d.ts

@@ -1,8 +1,8 @@
 /// <reference types="node" />
 import { Readable } from 'stream';
 import { Chunk } from './chunk/cac';
-import type { AllSettlements, BalanceResponse, BeeOptions, BeeRequestOptions, BeeVersions, ChainState, ChequebookAddressResponse, ChequebookBalanceResponse, CollectionUploadOptions, DebugStatus, EnvelopeWithBatchId, FeedReader, FeedWriter, FileData, FileUploadOptions, GetGranteesResult, GlobalPostageBatch, GranteesResult, GsocMessageHandler, GsocSubscription, Health, LastCashoutActionResponse, LastChequesForPeerResponse, LastChequesResponse, NodeAddresses, NodeInfo, NumberString, Peer, PeerBalance, Pin, PingResponse, PostageBatch, PostageBatchBuckets, PssMessageHandler, PssSubscription, Readiness, RedistributionState, ReferenceInformation, RemovePeerResponse, ReserveState, SOCReader, SOCWriter, Settlements, Tag, Topology, TransactionInfo, UploadOptions, UploadRedundancyOptions, WalletBalance } from './types';
-import { AllTagsOptions, CashoutOptions, Collection, PostageBatchOptions, TransactionOptions, UploadResult } from './types';
+import type { AllSettlements, BalanceResponse, BeeOptions, BeeRequestOptions, BeeVersions, ChainState, ChequebookAddressResponse, ChequebookBalanceResponse, CollectionUploadOptions, DebugStatus, DownloadOptions, EnvelopeWithBatchId, FeedReader, FeedWriter, FileData, FileUploadOptions, GetGranteesResult, GlobalPostageBatch, GranteesResult, GsocMessageHandler, GsocSubscription, Health, LastCashoutActionResponse, LastChequesForPeerResponse, LastChequesResponse, NodeAddresses, NodeInfo, NumberString, Peer, PeerBalance, Pin, PingResponse, PostageBatch, PostageBatchBuckets, PssMessageHandler, PssSubscription, Readiness, RedistributionState, RedundantUploadOptions, ReferenceInformation, RemovePeerResponse, ReserveState, SOCReader, SOCWriter, Settlements, Tag, Topology, TransactionInfo, UploadOptions, WalletBalance } from './types';
+import { AllTagsOptions, Collection, PostageBatchOptions, TransactionOptions, UploadResult } from './types';
 import { Bytes } from './utils/bytes';
 import { BZZ } from './utils/tokens';
 import { BatchId, EthAddress, FeedIndex, Identifier, PeerAddress, PrivateKey, PublicKey, Reference, Topic, TransactionId } from './utils/typed-bytes';
@@ -43,7 +43,7 @@ export declare class Bee {
      * @see [Bee docs - Upload and download](https://docs.ethswarm.org/docs/develop/access-the-swarm/upload-and-download)
      * @see [Bee API reference - `POST /bytes`](https://docs.ethswarm.org/api/#tag/Bytes/paths/~1bytes/post)
      */
-    uploadData(postageBatchId: BatchId | Uint8Array | string, data: string | Uint8Array, options?: UploadOptions & UploadRedundancyOptions, requestOptions?: BeeRequestOptions): Promise<UploadResult>;
+    uploadData(postageBatchId: BatchId | Uint8Array | string, data: string | Uint8Array, options?: RedundantUploadOptions, requestOptions?: BeeRequestOptions): Promise<UploadResult>;
     /**
      * Requests content length for a `/bytes` reference
      *
@@ -60,7 +60,7 @@ export declare class Bee {
      * @see [Bee docs - Upload and download](https://docs.ethswarm.org/docs/develop/access-the-swarm/upload-and-download)
      * @see [Bee API reference - `GET /bytes`](https://docs.ethswarm.org/api/#tag/Bytes/paths/~1bytes~1{reference}/get)
      */
-    downloadData(reference: Reference | string | Uint8Array, options?: BeeRequestOptions): Promise<Bytes>;
+    downloadData(reference: Reference | string | Uint8Array, options?: DownloadOptions, requestOptions?: BeeRequestOptions): Promise<Bytes>;
     /**
      * Download data as a Readable stream
      *
@@ -71,7 +71,7 @@ export declare class Bee {
      * @see [Bee docs - Upload and download](https://docs.ethswarm.org/docs/develop/access-the-swarm/upload-and-download)
      * @see [Bee API reference - `GET /bytes`](https://docs.ethswarm.org/api/#tag/Bytes/paths/~1bytes~1{reference}/get)
      */
-    downloadReadableData(reference: Reference | Uint8Array | string, options?: BeeRequestOptions): Promise<ReadableStream<Uint8Array>>;
+    downloadReadableData(reference: Reference | Uint8Array | string, options?: DownloadOptions, requestOptions?: BeeRequestOptions): Promise<ReadableStream<Uint8Array>>;
     /**
      * Upload chunk to a Bee node
      *
@@ -94,7 +94,7 @@ export declare class Bee {
      * @see [Bee docs - Upload and download](https://docs.ethswarm.org/docs/develop/access-the-swarm/upload-and-download)
      * @see [Bee API reference - `GET /chunks`](https://docs.ethswarm.org/api/#tag/Chunk/paths/~1chunks~1{address}/get)
      */
-    downloadChunk(reference: Reference | Uint8Array | string, options?: BeeRequestOptions): Promise<Uint8Array>;
+    downloadChunk(reference: Reference | Uint8Array | string, options?: DownloadOptions, requestOptions?: BeeRequestOptions): Promise<Uint8Array>;
     /**
      * Create a grantees list from the given array of public keys.
      *
@@ -105,7 +105,7 @@ export declare class Bee {
      * @param requestOptions - Optional request options.
      * @returns A promise that resolves to a `GranteesResult` object.
      */
-    createGrantees(postageBatchId: BatchId | Uint8Array | string, grantees: string[], requestOptions?: BeeRequestOptions): Promise<GranteesResult>;
+    createGrantees(postageBatchId: BatchId | Uint8Array | string, grantees: PublicKey[] | Uint8Array[] | string[], requestOptions?: BeeRequestOptions): Promise<GranteesResult>;
     /**
      * Retrieves the grantees for a given reference.
      *
@@ -113,7 +113,7 @@ export declare class Bee {
      * @param requestOptions - Optional request options.
      * @returns A promise that resolves to a `GetGranteesResult` object.
      */
-    getGrantees(reference: Reference | string, requestOptions?: BeeRequestOptions): Promise<GetGranteesResult>;
+    getGrantees(reference: Reference | Uint8Array | string, requestOptions?: BeeRequestOptions): Promise<GetGranteesResult>;
     /**
      * Updates the grantees of a specific reference and history.
      *
@@ -125,8 +125,8 @@ export declare class Bee {
      * @returns A Promise that resolves to to a `GranteesResult` object.
      */
     patchGrantees(postageBatchId: BatchId | Uint8Array | string, reference: Reference | Uint8Array | string, history: Reference | Uint8Array | string, grantees: {
-        add?: string[];
-        revoke?: string[];
+        add?: PublicKey[] | Uint8Array[] | string[];
+        revoke?: PublicKey[] | Uint8Array[] | string[];
     }, requestOptions?: BeeRequestOptions): Promise<GranteesResult>;
     /**
      * Upload single file to a Bee node.
@@ -141,7 +141,7 @@ export declare class Bee {
      * @see [Bee API reference - `POST /bzz`](https://docs.ethswarm.org/api/#tag/BZZ/paths/~1bzz/post)
      * @returns reference is a content hash of the file
      */
-    uploadFile(postageBatchId: BatchId | Uint8Array | string, data: string | Uint8Array | Readable | File, name?: string, options?: FileUploadOptions & UploadRedundancyOptions, requestOptions?: BeeRequestOptions): Promise<UploadResult>;
+    uploadFile(postageBatchId: BatchId | Uint8Array | string, data: string | Uint8Array | Readable | File, name?: string, options?: FileUploadOptions, requestOptions?: BeeRequestOptions): Promise<UploadResult>;
     /**
      * Download single file.
      *
@@ -154,7 +154,7 @@ export declare class Bee {
      * @see [Bee docs - Upload and download](https://docs.ethswarm.org/docs/develop/access-the-swarm/upload-and-download)
      * @see [Bee API reference - `GET /bzz`](https://docs.ethswarm.org/api/#tag/BZZ/paths/~1bzz~1%7Breference%7D~1%7Bpath%7D/get)
      */
-    downloadFile(reference: Reference | Uint8Array | string, path?: string, options?: BeeRequestOptions): Promise<FileData<Bytes>>;
+    downloadFile(reference: Reference | Uint8Array | string, path?: string, options?: DownloadOptions, requestOptions?: BeeRequestOptions): Promise<FileData<Bytes>>;
     /**
      * Download single file as a readable stream
      *
@@ -167,7 +167,7 @@ export declare class Bee {
      * @see [Bee docs - Upload and download](https://docs.ethswarm.org/docs/develop/access-the-swarm/upload-and-download)
      * @see [Bee API reference - `GET /bzz`](https://docs.ethswarm.org/api/#tag/BZZ/paths/~1bzz~1%7Breference%7D~1%7Bpath%7D/get)
      */
-    downloadReadableFile(reference: Reference | Uint8Array | string, path?: string, options?: BeeRequestOptions): Promise<FileData<ReadableStream<Uint8Array>>>;
+    downloadReadableFile(reference: Reference | Uint8Array | string, path?: string, options?: DownloadOptions, requestOptions?: BeeRequestOptions): Promise<FileData<ReadableStream<Uint8Array>>>;
     /**
      * Upload collection of files to a Bee node
      *
@@ -184,7 +184,7 @@ export declare class Bee {
      * @see [Bee docs - Upload directory](https://docs.ethswarm.org/docs/develop/access-the-swarm/upload-and-download#upload-a-directory)
      * @see [Bee API reference - `POST /bzz`](https://docs.ethswarm.org/api/#tag/BZZ/paths/~1bzz/post)
      */
-    uploadFiles(postageBatchId: BatchId | Uint8Array | string, fileList: FileList | File[], options?: CollectionUploadOptions & UploadRedundancyOptions, requestOptions?: BeeRequestOptions): Promise<UploadResult>;
+    uploadFiles(postageBatchId: BatchId | Uint8Array | string, fileList: FileList | File[], options?: CollectionUploadOptions, requestOptions?: BeeRequestOptions): Promise<UploadResult>;
     hashDirectory(dir: string): Promise<Reference>;
     streamDirectory(postageBatchId: BatchId | Uint8Array | string, dir: string, onUploadProgress?: (progress: UploadProgress) => void, options?: UploadOptions, requestOptions?: BeeRequestOptions): Promise<Reference>;
     streamFiles(postageBatchId: BatchId | Uint8Array | string, files: File[] | FileList, onUploadProgress?: (progress: UploadProgress) => void, options?: UploadOptions): Promise<Reference>;
@@ -198,7 +198,7 @@ export declare class Bee {
      * @param collection
      * @param options Collections and request options
      */
-    uploadCollection(postageBatchId: BatchId | Uint8Array | string, collection: Collection, options?: CollectionUploadOptions & UploadRedundancyOptions, requestOptions?: BeeRequestOptions): Promise<UploadResult>;
+    uploadCollection(postageBatchId: BatchId | Uint8Array | string, collection: Collection, options?: CollectionUploadOptions, requestOptions?: BeeRequestOptions): Promise<UploadResult>;
     /**
      * Upload collection of files.
      *
@@ -215,7 +215,7 @@ export declare class Bee {
      * @see [Bee docs - Upload directory](https://docs.ethswarm.org/docs/develop/access-the-swarm/upload-and-download#upload-a-directory)
      * @see [Bee API reference - `POST /bzz`](https://docs.ethswarm.org/api/#tag/BZZ/paths/~1bzz/post)
      */
-    uploadFilesFromDirectory(postageBatchId: BatchId | Uint8Array | string, dir: string, options?: CollectionUploadOptions & UploadRedundancyOptions, requestOptions?: BeeRequestOptions): Promise<UploadResult>;
+    uploadFilesFromDirectory(postageBatchId: BatchId | Uint8Array | string, dir: string, options?: CollectionUploadOptions, requestOptions?: BeeRequestOptions): Promise<UploadResult>;
     /**
      * Create a new Tag which is meant for tracking progres of syncing data across network.
      *
@@ -353,7 +353,7 @@ export declare class Bee {
      * @param index
      * @param options
      */
-    isFeedRetrievable(owner: EthAddress | Uint8Array | string, topic: Topic | Uint8Array | string, index?: FeedIndex, options?: BeeRequestOptions): Promise<boolean>;
+    isFeedRetrievable(owner: EthAddress | Uint8Array | string, topic: Topic | Uint8Array | string, index?: FeedIndex, options?: DownloadOptions, requestOptions?: BeeRequestOptions): Promise<boolean>;
     /**
      * Send data to recipient or target with Postal Service for Swarm.
      *
@@ -549,7 +549,7 @@ export declare class Bee {
      * @param options.gasPrice Gas price for the cashout transaction in WEI
      * @param options.gasLimit Gas limit for the cashout transaction in WEI
      */
-    cashoutLastCheque(address: PeerAddress | string, options?: CashoutOptions, requestOptions?: BeeRequestOptions): Promise<TransactionId>;
+    cashoutLastCheque(address: PeerAddress | string, options?: TransactionOptions, requestOptions?: BeeRequestOptions): Promise<TransactionId>;
     /**
      * Deposit tokens from overlay address into chequebook
      *
@@ -661,7 +661,7 @@ export declare class Bee {
      * @see [Bee docs - Keep your data alive / Postage stamps](https://docs.ethswarm.org/docs/develop/access-the-swarm/introduction/#keep-your-data-alive)
      * @see [Bee Debug API reference - `PATCH /stamps/topup/${id}/${amount}`](https://docs.ethswarm.org/debug-api/#tag/Postage-Stamps/paths/~1stamps~1topup~1{id}~1{amount}/patch)
      */
-    topUpBatch(postageBatchId: BatchId | Uint8Array | string, amount: NumberString | string | bigint, options?: BeeRequestOptions): Promise<void>;
+    topUpBatch(postageBatchId: BatchId | Uint8Array | string, amount: NumberString | string | bigint, options?: BeeRequestOptions): Promise<BatchId>;
     /**
      * Dilute given Postage Batch with new depth (that has to be bigger then the original depth), which allows
      * the Postage Batch to be used for more chunks.
@@ -678,7 +678,7 @@ export declare class Bee {
      * @see [Bee docs - Keep your data alive / Postage stamps](https://docs.ethswarm.org/docs/develop/access-the-swarm/introduction/#keep-your-data-alive)
      * @see [Bee Debug API reference - `PATCH /stamps/topup/${id}/${amount}`](https://docs.ethswarm.org/debug-api/#tag/Postage-Stamps/paths/~1stamps~1topup~1{id}~1{amount}/patch)
      */
-    diluteBatch(postageBatchId: BatchId | Uint8Array | string, depth: number, options?: BeeRequestOptions): Promise<void>;
+    diluteBatch(postageBatchId: BatchId | Uint8Array | string, depth: number, options?: BeeRequestOptions): Promise<BatchId>;
     /**
      * Return details for specific postage batch.
      *
@@ -752,5 +752,5 @@ export declare class Bee {
      */
     getRedistributionState(options?: BeeRequestOptions): Promise<RedistributionState>;
     private waitForUsablePostageStamp;
-    private getRequestOptionsForCall;
+    protected getRequestOptionsForCall(options?: BeeRequestOptions): BeeRequestOptions;
 }

package/dist/types/feed/retrievable.d.ts

@@ -1,4 +1,4 @@
 import { Bee } from '../bee';
-import { BeeRequestOptions } from '../types';
+import { BeeRequestOptions, DownloadOptions } from '../types';
 import { EthAddress, FeedIndex, Topic } from '../utils/typed-bytes';
-export declare function areAllSequentialFeedsUpdateRetrievable(bee: Bee, owner: EthAddress, topic: Topic, index: FeedIndex, requestOptions: BeeRequestOptions): Promise<boolean>;
+export declare function areAllSequentialFeedsUpdateRetrievable(bee: Bee, owner: EthAddress, topic: Topic, index: FeedIndex, options: DownloadOptions | undefined, requestOptions: BeeRequestOptions): Promise<boolean>;

package/dist/types/index.d.ts

@@ -1,4 +1,5 @@
 import { Bee } from './bee';
+import { BeeDev } from './bee-dev';
 export { MerkleTree } from 'cafe-utility';
 export { MantarayNode } from './manifest/manifest';
 export { SUPPORTED_BEE_VERSION, SUPPORTED_BEE_VERSION_EXACT } from './modules/debug/status';
@@ -9,11 +10,12 @@ export * from './utils/error';
 export * as Utils from './utils/expose';
 export * from './utils/tokens';
 export * from './utils/typed-bytes';
-export { Bee };
+export { Bee, BeeDev };
 declare global {
     interface Window {
         BeeJs: {
             Bee: typeof import('./bee').Bee;
+            BeeDev: typeof import('./bee-dev').BeeDev;
             Utils: typeof import('./utils/expose');
             BeeError: typeof import('./utils/error').BeeError;
             BeeArgumentError: typeof import('./utils/error').BeeArgumentError;