@ethersphere/bee-js 7.1.1 → 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/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() {