@ethersphere/bee-js 7.1.0 → 7.1.2

package/README.md

@@ -15,6 +15,22 @@
 
 > Intended to be used with Bee version 2.1.0.
 
+## Quick start
+
+Start a Swarm project using TypeScript:
+
+```sh
+npm init swarm-app@latest my-dapp node-ts
+```
+
+or using Vite and TypeScript:
+
+```sh
+npm init swarm-app@latest my-dapp vite-tsx
+```
+
+Supported types are `node`, `node-esm`, `node-ts` and `vite-tsx`. Replace `my-dapp` with your project name.
+
 ## Install
 
 ```sh

package/dist/cjs/bee.js

@@ -97,7 +97,7 @@ 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) {
@@ -114,7 +114,7 @@ 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) {
@@ -129,7 +129,7 @@ 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) {
@@ -145,7 +145,7 @@ 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) {
@@ -170,8 +170,8 @@ 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) {
         (0, type_2.assertRequestOptions)(options);
@@ -189,9 +189,9 @@ 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) {
@@ -228,8 +228,8 @@ 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) {
         (0, type_2.assertRequestOptions)(options);
@@ -245,8 +245,8 @@ 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) {
         (0, type_2.assertRequestOptions)(options);
@@ -265,9 +265,9 @@ 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) {
         (0, type_2.assertBatchId)(postageBatchId);
@@ -305,9 +305,9 @@ 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) {
         (0, type_2.assertBatchId)(postageBatchId);
@@ -320,7 +320,7 @@ 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) {
@@ -336,7 +336,7 @@ 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) {
@@ -351,7 +351,7 @@ 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)
      *
      */
@@ -368,7 +368,7 @@ 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) {
@@ -388,7 +388,7 @@ 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) {
@@ -404,7 +404,7 @@ 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) {
         (0, type_2.assertRequestOptions)(options);
@@ -418,7 +418,7 @@ 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) {
         (0, type_2.assertRequestOptions)(options);
@@ -429,7 +429,7 @@ 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) {
         (0, type_2.assertRequestOptions)(options);
@@ -443,7 +443,7 @@ 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) {
         (0, type_2.assertRequestOptions)(options);
@@ -535,7 +535,7 @@ 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) {
@@ -565,7 +565,7 @@ 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) {
@@ -627,7 +627,7 @@ 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) {
@@ -672,7 +672,7 @@ 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) {
@@ -692,7 +692,7 @@ 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) {
         (0, type_2.assertRequestOptions)(options);
@@ -709,7 +709,7 @@ 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) {
         (0, type_2.assertRequestOptions)(options);
@@ -734,7 +734,7 @@ 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) {
         (0, type_2.assertRequestOptions)(options, 'JsonFeedOptions');
@@ -761,7 +761,7 @@ 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) {
         (0, type_2.assertRequestOptions)(options, 'JsonFeedOptions');
@@ -806,7 +806,7 @@ 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) {
         (0, type_2.assertRequestOptions)(options);
@@ -821,7 +821,7 @@ 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) {
         (0, type_2.assertRequestOptions)(options);
@@ -872,7 +872,7 @@ 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)
      *
      */
@@ -1170,7 +1170,7 @@ 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**
      *
@@ -1180,7 +1180,7 @@ 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) {
@@ -1206,7 +1206,7 @@ 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**
      *
@@ -1214,7 +1214,7 @@ 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) {
@@ -1228,7 +1228,7 @@ 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**
      *
@@ -1236,7 +1236,7 @@ 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) {
@@ -1250,7 +1250,7 @@ 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) {
@@ -1263,7 +1263,7 @@ 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) {
@@ -1274,7 +1274,7 @@ 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/cjs/utils/pss.js

@@ -7,7 +7,7 @@ const types_1 = require("../types");
  * 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)
  */
 function makeMaxTarget(target) {
     if (typeof target !== 'string') {

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

@@ -5,7 +5,7 @@ const file_1 = require("./file");
 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 (0, file_1.fileArrayBuffer)(item.file)));
             await tarStream.endFile();
         }

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

@@ -4,7 +4,7 @@ exports.writeTar = void 0;
 const fs_1 = require("fs");
 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 = (0, fs_1.createReadStream)(item.fsPath);
             for await (const chunk of stream) {

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

@@ -14,7 +14,7 @@ class TarStream {
             return newAcc;
         });
     }
-    async beginFile(path, size) {
+    beginFile(path, size) {
         const header = createHeader(path, size);
         this.pieces.push(header);
         this.currentFileSize = 0;
@@ -24,8 +24,10 @@ 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());
@@ -33,30 +35,37 @@ class TarStream {
 }
 exports.TarStream = TarStream;
 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/cjs/utils/tar.js

@@ -7,43 +7,67 @@ class TarStream {
         this.output = new stream_1.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();
+            });
+        });
     }
 }
 exports.TarStream = TarStream;
 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() {