@ethersphere/bee-js 7.1.0 → 7.1.2

package/dist/mjs/bee.js

@@ -71,7 +71,7 @@ export class Bee {
    * @param options Additional options like tag, encryption, pinning, content-type and request options
    *
    * @returns reference is a content hash of the data
-   * @see [Bee docs - Upload and download](https://docs.ethswarm.org/docs/access-the-swarm/upload-and-download)
+   * @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)
    */
   async uploadData(postageBatchId, data, options, requestOptions) {
@@ -87,7 +87,7 @@ export class Bee {
    * @param options Options that affects the request behavior
    * @throws TypeError if some of the input parameters is not expected type
    * @throws BeeArgumentError if there is passed ENS domain with invalid unicode characters
-   * @see [Bee docs - Upload and download](https://docs.ethswarm.org/docs/access-the-swarm/upload-and-download)
+   * @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)
    */
   async downloadData(reference, options) {
@@ -102,7 +102,7 @@ export class Bee {
    * @param options Options that affects the request behavior
    * @throws TypeError if some of the input parameters is not expected type
    * @throws BeeArgumentError if there is passed ENS domain with invalid unicode characters
-   * @see [Bee docs - Upload and download](https://docs.ethswarm.org/docs/access-the-swarm/upload-and-download)
+   * @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)
    */
   async downloadReadableData(reference, options) {
@@ -118,7 +118,7 @@ export class Bee {
    * @param options Additional options like tag, encryption, pinning, content-type and request options
    *
    * @returns reference is a content hash of the data
-   * @see [Bee docs - Upload and download](https://docs.ethswarm.org/docs/access-the-swarm/upload-and-download)
+   * @see [Bee docs - Upload and download](https://docs.ethswarm.org/docs/develop/access-the-swarm/upload-and-download)
    * @see [Bee API reference - `POST /chunks`](https://docs.ethswarm.org/api/#tag/Chunk/paths/~1chunks/post)
    */
   async uploadChunk(postageBatchId, data, options, requestOptions) {
@@ -142,8 +142,8 @@ export class Bee {
    * @param options Options that affects the request behavior
    * @throws TypeError if some of the input parameters is not expected type
    * @throws BeeArgumentError if there is passed ENS domain with invalid unicode characters
-   * @see [Bee docs - Upload and download](https://docs.ethswarm.org/docs/access-the-swarm/upload-and-download)
-   * @see [Bee API reference - `GET /chunks`](https://docs.ethswarm.org/api/#tag/Chunk/paths/~1chunks~1{reference}/get)
+   * @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)
    */
   async downloadChunk(reference, options) {
     assertRequestOptions(options);
@@ -161,9 +161,9 @@ export class Bee {
    * @param name    Optional name of the uploaded file
    * @param options Additional options like tag, encryption, pinning, content-type and request options
    *
-   * @see [Bee docs - Keep your data alive / Postage stamps](https://docs.ethswarm.org/docs/access-the-swarm/keep-your-data-alive)
-   * @see [Bee docs - Upload and download](https://docs.ethswarm.org/docs/access-the-swarm/upload-and-download)
-   * @see [Bee API reference - `POST /bzz`](https://docs.ethswarm.org/api/#tag/File/paths/~1bzz/post)
+   * @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 docs - Upload and download](https://docs.ethswarm.org/docs/develop/access-the-swarm/upload-and-download)
+   * @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
    */
   async uploadFile(postageBatchId, data, name, options, requestOptions) {
@@ -200,8 +200,8 @@ export class Bee {
    * @throws TypeError if some of the input parameters is not expected type
    * @throws BeeArgumentError if there is passed ENS domain with invalid unicode characters
    * @see Data
-   * @see [Bee docs - Upload and download](https://docs.ethswarm.org/docs/access-the-swarm/upload-and-download)
-   * @see [Bee API reference - `GET /bzz`](https://docs.ethswarm.org/api/#tag/Collection/paths/~1bzz~1{reference}~1{path}/get)
+   * @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)
    */
   async downloadFile(reference, path = '', options) {
     assertRequestOptions(options);
@@ -217,8 +217,8 @@ export class Bee {
    * @throws TypeError if some of the input parameters is not expected type
    * @throws BeeArgumentError if there is passed ENS domain with invalid unicode characters
    *
-   * @see [Bee docs - Upload and download](https://docs.ethswarm.org/docs/access-the-swarm/upload-and-download)
-   * @see [Bee API reference - `GET /bzz`](https://docs.ethswarm.org/api/#tag/Collection/paths/~1bzz~1{reference}~1{path}/get)
+   * @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)
    */
   async downloadReadableFile(reference, path = '', options) {
     assertRequestOptions(options);
@@ -237,9 +237,9 @@ export class Bee {
    * @param fileList list of files to be uploaded
    * @param options Additional options like tag, encryption, pinning and request options
    *
-   * @see [Bee docs - Keep your data alive / Postage stamps](https://docs.ethswarm.org/docs/access-the-swarm/keep-your-data-alive)
-   * @see [Bee docs - Upload directory](https://docs.ethswarm.org/docs/access-the-swarm/upload-a-directory/)
-   * @see [Bee API reference - `POST /bzz`](https://docs.ethswarm.org/api/#tag/Collection/paths/~1bzz/post)
+   * @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 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)
    */
   async uploadFiles(postageBatchId, fileList, options, requestOptions) {
     assertBatchId(postageBatchId);
@@ -275,9 +275,9 @@ export class Bee {
    * @param dir the path of the files to be uploaded
    * @param options Additional options like tag, encryption, pinning and request options
    *
-   * @see [Bee docs - Keep your data alive / Postage stamps](https://docs.ethswarm.org/docs/access-the-swarm/keep-your-data-alive)
-   * @see [Bee docs - Upload directory](https://docs.ethswarm.org/docs/access-the-swarm/upload-a-directory/)
-   * @see [Bee API reference - `POST /bzz`](https://docs.ethswarm.org/api/#tag/Collection/paths/~1bzz/post)
+   * @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 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)
    */
   async uploadFilesFromDirectory(postageBatchId, dir, options, requestOptions) {
     assertBatchId(postageBatchId);
@@ -289,7 +289,7 @@ export class Bee {
    * Create a new Tag which is meant for tracking progres of syncing data across network.
    *
    * @param options Options that affects the request behavior
-   * @see [Bee docs - Syncing / Tags](https://docs.ethswarm.org/docs/access-the-swarm/syncing)
+   * @see [Bee docs - Syncing / Tags](https://docs.ethswarm.org/docs/develop/access-the-swarm/syncing)
    * @see [Bee API reference - `POST /tags`](https://docs.ethswarm.org/api/#tag/Tag/paths/~1tags/post)
    */
   async createTag(options) {
@@ -305,7 +305,7 @@ export class Bee {
    * @throws TypeError if limit or offset are not numbers or undefined
    * @throws BeeArgumentError if limit or offset have invalid options
    *
-   * @see [Bee docs - Syncing / Tags](https://docs.ethswarm.org/docs/access-the-swarm/syncing)
+   * @see [Bee docs - Syncing / Tags](https://docs.ethswarm.org/docs/develop/access-the-swarm/syncing)
    * @see [Bee API reference - `GET /tags`](https://docs.ethswarm.org/api/#tag/Tag/paths/~1tags/get)
    */
   async getAllTags(options) {
@@ -320,7 +320,7 @@ export class Bee {
    * @param options Options that affects the request behavior
    * @throws TypeError if tagUid is in not correct format
    *
-   * @see [Bee docs - Syncing / Tags](https://docs.ethswarm.org/docs/access-the-swarm/syncing)
+   * @see [Bee docs - Syncing / Tags](https://docs.ethswarm.org/docs/develop/access-the-swarm/syncing)
    * @see [Bee API reference - `GET /tags/{uid}`](https://docs.ethswarm.org/api/#tag/Tag/paths/~1tags~1{uid}/get)
    *
    */
@@ -337,7 +337,7 @@ export class Bee {
    * @throws TypeError if tagUid is in not correct format
    * @throws BeeResponse error if something went wrong on the Bee node side while deleting the tag.
    *
-   * @see [Bee docs - Syncing / Tags](https://docs.ethswarm.org/docs/access-the-swarm/syncing)
+   * @see [Bee docs - Syncing / Tags](https://docs.ethswarm.org/docs/develop/access-the-swarm/syncing)
    * @see [Bee API reference - `DELETE /tags/{uid}`](https://docs.ethswarm.org/api/#tag/Tag/paths/~1tags~1{uid}/delete)
    */
   async deleteTag(tagUid, options) {
@@ -357,7 +357,7 @@ export class Bee {
    * @throws TypeError if tagUid is in not correct format
    * @throws BeeResponse error if something went wrong on the Bee node side while deleting the tag.
    *
-   * @see [Bee docs - Syncing / Tags](https://docs.ethswarm.org/docs/access-the-swarm/syncing)
+   * @see [Bee docs - Syncing / Tags](https://docs.ethswarm.org/docs/develop/access-the-swarm/syncing)
    * @see [Bee API reference - `PATCH /tags/{uid}`](https://docs.ethswarm.org/api/#tag/Tag/paths/~1tags~1{uid}/patch)
    */
   async updateTag(tagUid, reference, options) {
@@ -373,7 +373,7 @@ export class Bee {
    * @param options Options that affects the request behavior
    * @throws TypeError if reference is in not correct format
    *
-   * @see [Bee docs - Pinning](https://docs.ethswarm.org/docs/access-the-swarm/pinning)
+   * @see [Bee docs - Pinning](https://docs.ethswarm.org/docs/develop/access-the-swarm/pinning)
    */
   async pin(reference, options) {
     assertRequestOptions(options);
@@ -387,7 +387,7 @@ export class Bee {
    * @param options Options that affects the request behavior
    * @throws TypeError if reference is in not correct format
    *
-   * @see [Bee docs - Pinning](https://docs.ethswarm.org/docs/access-the-swarm/pinning)
+   * @see [Bee docs - Pinning](https://docs.ethswarm.org/docs/develop/access-the-swarm/pinning)
    */
   async unpin(reference, options) {
     assertRequestOptions(options);
@@ -398,7 +398,7 @@ export class Bee {
    * Get list of all locally pinned references
    *
    * @param options Options that affects the request behavior
-   * @see [Bee docs - Pinning](https://docs.ethswarm.org/docs/access-the-swarm/pinning)
+   * @see [Bee docs - Pinning](https://docs.ethswarm.org/docs/develop/access-the-swarm/pinning)
    */
   async getAllPins(options) {
     assertRequestOptions(options);
@@ -412,7 +412,7 @@ export class Bee {
    * @throws TypeError if some of the input parameters is not expected type
    * @throws BeeArgumentError if there is passed ENS domain with invalid unicode characters
    *
-   * @see [Bee docs - Pinning](https://docs.ethswarm.org/docs/access-the-swarm/pinning)
+   * @see [Bee docs - Pinning](https://docs.ethswarm.org/docs/develop/access-the-swarm/pinning)
    */
   async getPin(reference, options) {
     assertRequestOptions(options);
@@ -503,7 +503,7 @@ export class Bee {
    * @param options Options that affects the request behavior
    * @throws TypeError if `data`, `batchId`, `target` or `recipient` are in invalid format
    *
-   * @see [Bee docs - PSS](https://docs.ethswarm.org/docs/dapps-on-swarm/pss)
+   * @see [Bee docs - PSS](https://docs.ethswarm.org/docs/develop/tools-and-features/pss)
    * @see [Bee API reference - `POST /pss`](https://docs.ethswarm.org/api/#tag/Postal-Service-for-Swarm/paths/~1pss~1send~1{topic}~1{targets}/post)
    */
   async pssSend(postageBatchId, topic, target, data, recipient, options) {
@@ -532,7 +532,7 @@ export class Bee {
    *
    * @returns Subscription to a given topic
    *
-   * @see [Bee docs - PSS](https://docs.ethswarm.org/docs/dapps-on-swarm/pss)
+   * @see [Bee docs - PSS](https://docs.ethswarm.org/docs/develop/tools-and-features/pss)
    * @see [Bee API reference - `GET /pss`](https://docs.ethswarm.org/api/#tag/Postal-Service-for-Swarm/paths/~1pss~1subscribe~1{topic}/get)
    */
   pssSubscribe(topic, handler) {
@@ -551,7 +551,6 @@ export class Bee {
         if (ws.terminate) ws.terminate();else ws.close(); // standard Websocket in browser does not have terminate function
       }
     };
-
     const subscription = {
       topic,
       cancel
@@ -592,7 +591,7 @@ export class Bee {
    *
    * @returns Message in byte array
    *
-   * @see [Bee docs - PSS](https://docs.ethswarm.org/docs/dapps-on-swarm/pss)
+   * @see [Bee docs - PSS](https://docs.ethswarm.org/docs/develop/tools-and-features/pss)
    * @see [Bee API reference - `GET /pss`](https://docs.ethswarm.org/api/#tag/Postal-Service-for-Swarm/paths/~1pss~1subscribe~1{topic}/get)
    */
   async pssReceive(topic, timeoutMsec = 0) {
@@ -637,7 +636,7 @@ export class Bee {
    * @param owner           Owner's ethereum address in hex or bytes
    * @param options Options that affects the request behavior
    *
-   * @see [Bee docs - Feeds](https://docs.ethswarm.org/docs/dapps-on-swarm/feeds)
+   * @see [Bee docs - Feeds](https://docs.ethswarm.org/docs/develop/tools-and-features/feeds)
    * @see [Bee API reference - `POST /feeds`](https://docs.ethswarm.org/api/#tag/Feed/paths/~1feeds~1{owner}~1{topic}/post)
    */
   async createFeedManifest(postageBatchId, type, topic, owner, options) {
@@ -659,7 +658,7 @@ export class Bee {
    * @param owner   Owner's ethereum address in hex or bytes
    * @param options Options that affects the request behavior
    *
-   * @see [Bee docs - Feeds](https://docs.ethswarm.org/docs/dapps-on-swarm/feeds)
+   * @see [Bee docs - Feeds](https://docs.ethswarm.org/docs/develop/tools-and-features/feeds)
    */
   makeFeedReader(type, topic, owner, options) {
     assertRequestOptions(options);
@@ -676,7 +675,7 @@ export class Bee {
    * @param signer  The signer's private key or a Signer instance that can sign data
    * @param options Options that affects the request behavior
    *
-   * @see [Bee docs - Feeds](https://docs.ethswarm.org/docs/dapps-on-swarm/feeds)
+   * @see [Bee docs - Feeds](https://docs.ethswarm.org/docs/develop/tools-and-features/feeds)
    */
   makeFeedWriter(type, topic, signer, options) {
     assertRequestOptions(options);
@@ -701,7 +700,7 @@ export class Bee {
    *
    * @throws BeeError if `options.signer` is not specified nor the default Signer on Bee's instance is specified.
    *
-   * @see [Bee docs - Feeds](https://docs.ethswarm.org/docs/dapps-on-swarm/feeds)
+   * @see [Bee docs - Feeds](https://docs.ethswarm.org/docs/develop/tools-and-features/feeds)
    */
   async setJsonFeed(postageBatchId, topic, data, options, requestOptions) {
     assertRequestOptions(options, 'JsonFeedOptions');
@@ -728,7 +727,7 @@ export class Bee {
    * @param options.address Ethereum address of owner of the feed that signed it. This option is exclusive with `signer` option.
    * @param options.type Type of Feed
    *
-   * @see [Bee docs - Feeds](https://docs.ethswarm.org/docs/dapps-on-swarm/feeds)
+   * @see [Bee docs - Feeds](https://docs.ethswarm.org/docs/develop/tools-and-features/feeds)
    */
   async getJsonFeed(topic, options) {
     assertRequestOptions(options, 'JsonFeedOptions');
@@ -770,7 +769,7 @@ export class Bee {
    *
    * @param ownerAddress The ethereum address of the owner
    * @param options Options that affects the request behavior
-   * @see [Bee docs - Chunk Types](https://docs.ethswarm.org/docs/dapps-on-swarm/chunk-types#single-owner-chunks)
+   * @see [Bee docs - Chunk Types](https://docs.ethswarm.org/docs/develop/tools-and-features/chunk-types#single-owner-chunks)
    */
   makeSOCReader(ownerAddress, options) {
     assertRequestOptions(options);
@@ -785,7 +784,7 @@ export class Bee {
    *
    * @param signer The signer's private key or a Signer instance that can sign data
    * @param options Options that affects the request behavior
-   * @see [Bee docs - Chunk Types](https://docs.ethswarm.org/docs/dapps-on-swarm/chunk-types#single-owner-chunks)
+   * @see [Bee docs - Chunk Types](https://docs.ethswarm.org/docs/develop/tools-and-features/chunk-types#single-owner-chunks)
    */
   makeSOCWriter(signer, options) {
     assertRequestOptions(options);
@@ -835,7 +834,7 @@ export class Bee {
    * @param tagUid UID or tag object to be retrieved
    * @throws TypeError if tagUid is in not correct format
    *
-   * @see [Bee docs - Syncing / Tags](https://docs.ethswarm.org/docs/access-the-swarm/syncing)
+   * @see [Bee docs - Syncing / Tags](https://docs.ethswarm.org/docs/develop/access-the-swarm/syncing)
    * @see [Bee API reference - `GET /tags/{uid}`](https://docs.ethswarm.org/debug-api/#tag/Tag)
    *
    */
@@ -1131,7 +1130,7 @@ export class Bee {
    * Creates new postage batch from the funds that the node has available in its Ethereum account.
    *
    * For better understanding what each parameter means and what are the optimal values please see
-   * [Bee docs - Keep your data alive / Postage stamps](https://docs.ethswarm.org/docs/access-the-swarm/keep-your-data-alive).
+   * [Bee docs - Keep your data alive / Postage stamps](https://docs.ethswarm.org/docs/develop/access-the-swarm/introduction#keep-your-data-alive).
    *
    * **WARNING: THIS CREATES TRANSACTIONS THAT SPENDS MONEY**
    *
@@ -1141,7 +1140,7 @@ export class Bee {
    * @throws BeeArgumentError when negative amount or depth is specified
    * @throws TypeError if non-integer value is passed to amount or depth
    *
-   * @see [Bee docs - Keep your data alive / Postage stamps](https://docs.ethswarm.org/docs/access-the-swarm/keep-your-data-alive)
+   * @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 - `POST /stamps`](https://docs.ethswarm.org/debug-api/#tag/Postage-Stamps/paths/~1stamps~1{amount}~1{depth}/post)
    */
   async createPostageBatch(amount, depth, options, requestOptions) {
@@ -1167,7 +1166,7 @@ export class Bee {
    * Topup a fresh amount of BZZ to given Postage Batch.
    *
    * For better understanding what each parameter means and what are the optimal values please see
-   * [Bee docs - Keep your data alive / Postage stamps](https://docs.ethswarm.org/docs/access-the-swarm/keep-your-data-alive).
+   * [Bee docs - Keep your data alive / Postage stamps](https://docs.ethswarm.org/docs/develop/access-the-swarm/introduction/#keep-your-data-alive).
    *
    * **WARNING: THIS CREATES TRANSACTIONS THAT SPENDS MONEY**
    *
@@ -1175,7 +1174,7 @@ export class Bee {
    * @param amount Amount to be added to the batch
    * @param options Request options
    *
-   * @see [Bee docs - Keep your data alive / Postage stamps](https://docs.ethswarm.org/docs/access-the-swarm/keep-your-data-alive)
+   * @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)
    */
   async topUpBatch(postageBatchId, amount, options) {
@@ -1189,7 +1188,7 @@ export class Bee {
    * the Postage Batch to be used for more chunks.
    *
    * For better understanding what each parameter means and what are the optimal values please see
-   * [Bee docs - Keep your data alive / Postage stamps](https://docs.ethswarm.org/docs/access-the-swarm/keep-your-data-alive).
+   * [Bee docs - Keep your data alive / Postage stamps](https://docs.ethswarm.org/docs/develop/access-the-swarm/introduction/#keep-your-data-alive).
    *
    * **WARNING: THIS CREATES TRANSACTIONS THAT SPENDS MONEY**
    *
@@ -1197,7 +1196,7 @@ export class Bee {
    * @param depth Amount to be added to the batch
    * @param options Request options
    *
-   * @see [Bee docs - Keep your data alive / Postage stamps](https://docs.ethswarm.org/docs/access-the-swarm/keep-your-data-alive)
+   * @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)
    */
   async diluteBatch(postageBatchId, depth, options) {
@@ -1211,7 +1210,7 @@ export class Bee {
    *
    * @param postageBatchId Batch ID
    *
-   * @see [Bee docs - Keep your data alive / Postage stamps](https://docs.ethswarm.org/docs/access-the-swarm/keep-your-data-alive)
+   * @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 - `GET /stamps/${id}`](https://docs.ethswarm.org/debug-api/#tag/Postage-Stamps/paths/~1stamps~1{id}/get)
    */
   async getPostageBatch(postageBatchId, options) {
@@ -1224,7 +1223,7 @@ export class Bee {
    *
    * @param postageBatchId Batch ID
    *
-   * @see [Bee docs - Keep your data alive / Postage stamps](https://docs.ethswarm.org/docs/access-the-swarm/keep-your-data-alive)
+   * @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 - `GET /stamps/${id}/buckets`](https://docs.ethswarm.org/debug-api/#tag/Postage-Stamps/paths/~1stamps~1{id}~1buckets/get)
    */
   async getPostageBatchBuckets(postageBatchId, options) {
@@ -1235,7 +1234,7 @@ export class Bee {
   /**
    * Return all postage batches that has the node available.
    *
-   * @see [Bee docs - Keep your data alive / Postage stamps](https://docs.ethswarm.org/docs/access-the-swarm/keep-your-data-alive)
+   * @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 - `GET /stamps`](https://docs.ethswarm.org/debug-api/#tag/Postage-Stamps/paths/~1stamps/get)
    */
   async getAllPostageBatch(options) {

package/dist/mjs/utils/pss.js

@@ -4,7 +4,7 @@ import { PSS_TARGET_HEX_LENGTH_MAX } from "../types/index.js";
  * target that Bee node will except.
  *
  * @param target is a non-prefixed hex string Bee address
- * @see [Bee docs - PSS](https://docs.ethswarm.org/docs/dapps-on-swarm/pss)
+ * @see [Bee docs - PSS](https://docs.ethswarm.org/docs/develop/tools-and-features/pss)
  */
 export function makeMaxTarget(target) {
   if (typeof target !== 'string') {

package/dist/mjs/utils/tar-writer.browser.js

@@ -2,7 +2,7 @@ import { fileArrayBuffer } from "./file.js";
 export async function writeTar(collection, tarStream) {
   for (const item of collection) {
     if (item.file) {
-      await tarStream.beginFile(item.path, item.file.size);
+      tarStream.beginFile(item.path, item.file.size);
       await tarStream.appendFile(new Uint8Array(await fileArrayBuffer(item.file)));
       await tarStream.endFile();
     } else {

package/dist/mjs/utils/tar-writer.js

@@ -1,7 +1,7 @@
 import { createReadStream } from 'fs';
 export async function writeTar(collection, tarStream) {
   for (const item of collection) {
-    await tarStream.beginFile(item.path, item.size);
+    tarStream.beginFile(item.path, item.size);
     if (item.fsPath) {
       const stream = createReadStream(item.fsPath);
       for await (const chunk of stream) {

package/dist/mjs/utils/tar.browser.js

@@ -11,7 +11,7 @@ export class TarStream {
       return newAcc;
     });
   }
-  async beginFile(path, size) {
+  beginFile(path, size) {
     const header = createHeader(path, size);
     this.pieces.push(header);
     this.currentFileSize = 0;
@@ -21,38 +21,47 @@ export class TarStream {
     this.currentFileSize += data.length;
   }
   async endFile() {
-    const padding = 512 - this.currentFileSize % 512;
-    this.pieces.push(new Uint8Array(padding));
+    const padding = this.currentFileSize % 512 === 0 ? 0 : 512 - this.currentFileSize % 512;
+    if (padding > 0) {
+      this.pieces.push(new Uint8Array(padding));
+    }
   }
   async end() {
     this.pieces.push(createEndOfArchive());
   }
 }
 function createHeader(path, size) {
-  const header = new Uint8Array(512); // Initialize header with zeros
   const encoder = new TextEncoder();
   function writeToBuffer(str, offset, length) {
     const bytes = encoder.encode(str);
     header.set(bytes.slice(0, length), offset);
   }
-  writeToBuffer(path, 0, 100); // File name
-  writeToBuffer('0000777', 100, 8); // File mode
-  writeToBuffer('0001750', 108, 8); // UID
-  writeToBuffer('0001750', 116, 8); // GID
-  writeToBuffer(size.toString(8).padStart(11, '0') + ' ', 124, 12); // File size
-  writeToBuffer(Math.floor(Date.now() / 1000).toString(8) + ' ', 136, 12); // Mod time
-  writeToBuffer('        ', 148, 8); // Checksum placeholder
-  writeToBuffer('0', 156, 1); // Typeflag
-  writeToBuffer('ustar  ', 257, 8); // Magic and version
-  for (let i = 345; i < 512; i++) {
-    header[i] = 0; // Fill remaining with zeros
-  }
+  // Initialize header with zeros
+  const header = new Uint8Array();
+  header.fill(0, 0, 512);
+  // File name, truncated to 100 characters if necessary
+  writeToBuffer(path.slice(0, 100).padEnd(100, '\0'), 0, 100);
+  // File mode (octal) and null-terminated
+  writeToBuffer('0000777\0', 100, 8);
+  // UID and GID (octal) and null-terminated
+  writeToBuffer('0001750\0', 108, 8); // UID
+  writeToBuffer('0001750\0', 116, 8); // GID
+  // File size in octal (11 chars) and null-terminated
+  writeToBuffer(size.toString(8).padStart(11, '0') + '\0', 124, 12);
+  // Modification time in octal and null-terminated
+  const modTime = Math.floor(new Date().getTime() / 1000);
+  writeToBuffer(modTime.toString(8).padStart(11, '0') + '\0', 136, 12);
+  // Checksum placeholder (8 spaces)
+  writeToBuffer('        ', 148, 8);
+  // Typeflag (normal file)
+  writeToBuffer('0', 156, 1);
+  // USTAR magic and version
+  writeToBuffer('ustar\0\0', 257, 8);
   // Calculate checksum
   let checksum = 0;
   for (let i = 0; i < 512; i++) {
     checksum += header[i];
   }
-  // Write checksum
   writeToBuffer(checksum.toString(8).padStart(6, '0') + '\0 ', 148, 8);
   return header;
 }

package/dist/mjs/utils/tar.js

@@ -4,42 +4,65 @@ export class TarStream {
     this.output = new PassThrough();
     this.currentFileSize = 0;
   }
-  async beginFile(path, size) {
+  beginFile(path, size) {
     const header = createHeader(path, size);
     this.output.write(header);
     this.currentFileSize = 0;
   }
   async appendFile(data) {
     return new Promise(resolve => {
-      this.output.write(data, () => {
+      if (!this.output.write(data)) {
+        this.output.once('drain', () => {
+          resolve();
+        });
+      } else {
         resolve();
-      });
+      }
       this.currentFileSize += data.length;
     });
   }
   async endFile() {
-    const padding = 512 - this.currentFileSize % 512;
-    this.output.write(Buffer.alloc(padding, 0));
+    const padding = this.currentFileSize % 512 === 0 ? 0 : 512 - this.currentFileSize % 512;
+    if (padding > 0) {
+      this.output.write(Buffer.alloc(padding, 0));
+    }
   }
   async end() {
-    this.output.write(createEndOfArchive());
-    this.output.end();
+    return new Promise(resolve => {
+      this.output.write(createEndOfArchive());
+      this.output.end(() => {
+        resolve();
+      });
+    });
   }
 }
 function createHeader(path, size) {
-  const header = Buffer.alloc(512, 0); // Initialize header with zeros
-  header.write(path, 0, 100); // File name
-  header.write('0000777', 100, 8); // File mode
-  header.write('0001750', 108, 8); // UID
-  header.write('0001750', 116, 8); // GID
-  header.write(size.toString(8).padStart(11, '0') + ' ', 124, 12); // File size
-  header.write(Math.floor(new Date().getTime() / 1000).toString(8) + ' ', 136, 12); // Mod time
-  header.write('        ', 148, 8); // Checksum placeholder
-  header.write('0', 156, 1); // Typeflag
-  header.write('ustar  ', 257, 8); // Magic and version
-  header.write('0'.repeat(8 * 12), 345, 8 * 12); // Fill remaining with zeros
-  const checksum = header.reduce((sum, elem) => sum + elem, 0);
-  header.write(checksum.toString(8).padStart(6, '0') + '\0 ', 148, 8); // Write checksum
+  // Initialize header with zeros
+  const header = Buffer.alloc(512, 0);
+  // File name, truncated to 100 characters if necessary
+  header.write(path.slice(0, 100).padEnd(100, '\0'), 0, 100);
+  // File mode (octal) and null-terminated
+  header.write('0000777\0', 100, 8);
+  // UID and GID (octal) and null-terminated
+  header.write('0001750\0', 108, 8); // UID
+  header.write('0001750\0', 116, 8); // GID
+  // File size in octal (11 chars) and null-terminated
+  header.write(size.toString(8).padStart(11, '0') + '\0', 124, 12);
+  // Modification time in octal and null-terminated
+  const modTime = Math.floor(new Date().getTime() / 1000);
+  header.write(modTime.toString(8).padStart(11, '0') + '\0', 136, 12);
+  // Checksum placeholder (8 spaces)
+  header.write('        ', 148, 8);
+  // Typeflag (normal file)
+  header.write('0', 156, 1);
+  // USTAR magic and version
+  header.write('ustar\0\0', 257, 8);
+  // Calculate checksum
+  let checksum = 0;
+  for (let i = 0; i < 512; i++) {
+    checksum += header[i];
+  }
+  header.write(checksum.toString(8).padStart(6, '0') + '\0 ', 148, 8);
   return header;
 }
 function createEndOfArchive() {