@ethersphere/bee-js 12.0.0 → 12.2.0

package/dist/mjs/bee.js

@@ -1733,16 +1733,15 @@ export class Bee {
   /**
    * Calculates the `amount` and expected duration extension for topping up a postage batch with a given BZZ value.
    *
-   * @param postageBatchId
+   * @param depth Depth of the postage batch to top up.
    * @param bzz The amount of BZZ to spend on the top-up.
    * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
    * @returns An object with `amount` (to pass to {@link topUpBatch}) and `duration` (the expected TTL extension).
    */
-  async calculateTopUpForBzz(postageBatchId, bzz, requestOptions) {
-    const batch = await this.getPostageBatch(postageBatchId, requestOptions);
+  async calculateTopUpForBzz(depth, bzz, requestOptions) {
     const chainState = await this.getChainState(requestOptions);
     const blockTime = this.network === 'gnosis' ? 5 : 15;
-    const amount = bzz.toPLURBigInt() / 2n ** BigInt(batch.depth);
+    const amount = bzz.toPLURBigInt() / 2n ** BigInt(depth);
     const duration = getStampDuration(amount, chainState.currentPrice, blockTime);
     return {
       amount,

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

@@ -12,10 +12,20 @@ export class TarStream {
     });
   }
   beginFile(path, size) {
-    if (path.length > 100) {
-      throw new Error(`File name too long: ${path}`);
+    const {
+      name,
+      prefix,
+      longLink
+    } = splitPath(path);
+    if (longLink) {
+      const encoder = new TextEncoder();
+      const pathData = encoder.encode(path + '\0');
+      this.pieces.push(createLongLinkHeader(pathData.length));
+      this.pieces.push(pathData);
+      const padding = pathData.length % 512 === 0 ? 0 : 512 - pathData.length % 512;
+      if (padding > 0) this.pieces.push(new Uint8Array(padding));
     }
-    const header = createHeader(path, size);
+    const header = createHeader(name, prefix, size);
     this.pieces.push(header);
     this.currentFileSize = 0;
   }
@@ -33,7 +43,55 @@ export class TarStream {
     this.pieces.push(createEndOfArchive());
   }
 }
-function createHeader(path, size) {
+function splitPath(path) {
+  if (path.length <= 100) return {
+    name: path,
+    prefix: '',
+    longLink: false
+  };
+  for (let i = path.length - 1; i >= 0; i--) {
+    if (path[i] === '/') {
+      const name = path.substring(i + 1);
+      const prefix = path.substring(0, i);
+      if (name.length <= 100 && prefix.length <= 155) return {
+        name,
+        prefix,
+        longLink: false
+      };
+    }
+  }
+  // Filename itself is > 100 chars or path > 255 chars — use GNU LongLink
+  const lastSlash = path.lastIndexOf('/');
+  const truncatedName = (lastSlash >= 0 ? path.substring(lastSlash + 1) : path).slice(0, 100);
+  return {
+    name: truncatedName,
+    prefix: '',
+    longLink: true
+  };
+}
+function createLongLinkHeader(size) {
+  const encoder = new TextEncoder();
+  function writeToBuffer(str, offset, length) {
+    const bytes = encoder.encode(str);
+    header.set(bytes.slice(0, length), offset);
+  }
+  const header = new Uint8Array(512);
+  header.fill(0);
+  writeToBuffer('././@LongLink', 0, 100);
+  writeToBuffer('0000644\0', 100, 8);
+  writeToBuffer('0000000\0', 108, 8);
+  writeToBuffer('0000000\0', 116, 8);
+  writeToBuffer(size.toString(8).padStart(11, '0') + '\0', 124, 12);
+  writeToBuffer('00000000000\0', 136, 12);
+  writeToBuffer('        ', 148, 8);
+  writeToBuffer('L', 156, 1);
+  writeToBuffer('ustar\0\0', 257, 8);
+  let checksum = 0;
+  for (let i = 0; i < 512; i++) checksum += header[i];
+  writeToBuffer(checksum.toString(8).padStart(6, '0') + '\0 ', 148, 8);
+  return header;
+}
+function createHeader(name, prefix, size) {
   const encoder = new TextEncoder();
   function writeToBuffer(str, offset, length) {
     const bytes = encoder.encode(str);
@@ -43,7 +101,7 @@ function createHeader(path, size) {
   const header = new Uint8Array(512);
   header.fill(0, 0, 512);
   // File name, truncated to 100 characters if necessary
-  writeToBuffer(path.slice(0, 100).padEnd(100, '\0'), 0, 100);
+  writeToBuffer(name.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
@@ -60,11 +118,11 @@ function createHeader(path, size) {
   writeToBuffer('0', 156, 1);
   // USTAR magic and version
   writeToBuffer('ustar\0\0', 257, 8);
+  // UStar prefix field (offset 345, 155 bytes) — used when path > 100 but fits split
+  if (prefix) writeToBuffer(prefix.slice(0, 155).padEnd(155, '\0'), 345, 155);
   // Calculate checksum
   let checksum = 0;
-  for (let i = 0; i < 512; i++) {
-    checksum += header[i];
-  }
+  for (let i = 0; i < 512; i++) checksum += header[i];
   writeToBuffer(checksum.toString(8).padStart(6, '0') + '\0 ', 148, 8);
   return header;
 }

package/dist/mjs/utils/tar.js

@@ -5,10 +5,19 @@ export class TarStream {
     this.currentFileSize = 0;
   }
   beginFile(path, size) {
-    if (path.length > 100) {
-      throw new Error(`File name too long: ${path}`);
+    const {
+      name,
+      prefix,
+      longLink
+    } = splitPath(path);
+    if (longLink) {
+      const pathData = Buffer.from(path + '\0');
+      this.output.write(createLongLinkHeader(pathData.length));
+      this.output.write(pathData);
+      const padding = pathData.length % 512 === 0 ? 0 : 512 - pathData.length % 512;
+      if (padding > 0) this.output.write(Buffer.alloc(padding, 0));
     }
-    const header = createHeader(path, size);
+    const header = createHeader(name, prefix, size);
     this.output.write(header);
     this.currentFileSize = 0;
   }
@@ -39,11 +48,53 @@ export class TarStream {
     });
   }
 }
-function createHeader(path, size) {
+function splitPath(path) {
+  if (path.length <= 100) return {
+    name: path,
+    prefix: '',
+    longLink: false
+  };
+  for (let i = path.length - 1; i >= 0; i--) {
+    if (path[i] === '/') {
+      const name = path.substring(i + 1);
+      const prefix = path.substring(0, i);
+      if (name.length <= 100 && prefix.length <= 155) return {
+        name,
+        prefix,
+        longLink: false
+      };
+    }
+  }
+  // Filename itself is > 100 chars or path > 255 chars — use GNU LongLink
+  const lastSlash = path.lastIndexOf('/');
+  const truncatedName = (lastSlash >= 0 ? path.substring(lastSlash + 1) : path).slice(0, 100);
+  return {
+    name: truncatedName,
+    prefix: '',
+    longLink: true
+  };
+}
+function createLongLinkHeader(size) {
+  const header = Buffer.alloc(512, 0);
+  header.write('././@LongLink', 0, 100);
+  header.write('0000644\0', 100, 8);
+  header.write('0000000\0', 108, 8);
+  header.write('0000000\0', 116, 8);
+  header.write(size.toString(8).padStart(11, '0') + '\0', 124, 12);
+  header.write('00000000000\0', 136, 12);
+  header.write('        ', 148, 8);
+  header.write('L', 156, 1);
+  header.write('ustar\0\0', 257, 8);
+  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 createHeader(name, prefix, size) {
   // 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);
+  header.write(name.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
@@ -60,11 +111,11 @@ function createHeader(path, size) {
   header.write('0', 156, 1);
   // USTAR magic and version
   header.write('ustar\0\0', 257, 8);
+  // UStar prefix field (offset 345, 155 bytes) — used when path > 100 but fits split
+  if (prefix) header.write(prefix.slice(0, 155).padEnd(155, '\0'), 345, 155);
   // Calculate checksum
   let checksum = 0;
-  for (let i = 0; i < 512; i++) {
-    checksum += header[i];
-  }
+  for (let i = 0; i < 512; i++) checksum += header[i];
   header.write(checksum.toString(8).padStart(6, '0') + '\0 ', 148, 8);
   return header;
 }

package/dist/mjs/utils/tokens.js

@@ -9,6 +9,9 @@ export class BZZ {
   static fromPLUR(plur) {
     return new BZZ(new FixedPointNumber(plur, BZZ.DIGITS));
   }
+  static fromFloat(float) {
+    return new BZZ(FixedPointNumber.fromFloat(float, BZZ.DIGITS));
+  }
   toPLURString() {
     return this.state.toString();
   }
@@ -18,6 +21,9 @@ export class BZZ {
   toDecimalString() {
     return this.state.toDecimalString();
   }
+  toFloat() {
+    return this.state.toFloat();
+  }
   toSignificantDigits(digits) {
     return this.toDecimalString().slice(0, this.toDecimalString().indexOf('.') + digits + 1);
   }
@@ -78,6 +84,9 @@ export class DAI {
   static fromWei(wei) {
     return new DAI(new FixedPointNumber(wei, DAI.DIGITS));
   }
+  static fromFloat(float) {
+    return new DAI(FixedPointNumber.fromFloat(float, DAI.DIGITS));
+  }
   toWeiString() {
     return this.state.toString();
   }
@@ -90,6 +99,9 @@ export class DAI {
   toSignificantDigits(digits) {
     return this.toDecimalString().slice(0, this.toDecimalString().indexOf('.') + digits + 1);
   }
+  toFloat() {
+    return this.state.toFloat();
+  }
   /**
    * Does not mutate the current DAI instance.
    *

package/dist/types/bee.d.ts

@@ -1157,12 +1157,12 @@ export declare class Bee {
     /**
      * Calculates the `amount` and expected duration extension for topping up a postage batch with a given BZZ value.
      *
-     * @param postageBatchId
+     * @param depth Depth of the postage batch to top up.
      * @param bzz The amount of BZZ to spend on the top-up.
      * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
      * @returns An object with `amount` (to pass to {@link topUpBatch}) and `duration` (the expected TTL extension).
      */
-    calculateTopUpForBzz(postageBatchId: BatchId | Uint8Array | string, bzz: BZZ, requestOptions?: BeeRequestOptions): Promise<{
+    calculateTopUpForBzz(depth: number, bzz: BZZ, requestOptions?: BeeRequestOptions): Promise<{
         amount: bigint;
         duration: Duration;
     }>;

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

@@ -5,9 +5,11 @@ export declare class BZZ {
     private constructor();
     static fromDecimalString(string: string): BZZ;
     static fromPLUR(plur: NumberString | string | bigint): BZZ;
+    static fromFloat(float: number): BZZ;
     toPLURString(): string;
     toPLURBigInt(): bigint;
     toDecimalString(): string;
+    toFloat(): number;
     toSignificantDigits(digits: number): string;
     /**
      * Does not mutate the current BZZ instance.
@@ -43,10 +45,12 @@ export declare class DAI {
     private constructor();
     static fromDecimalString(string: string): DAI;
     static fromWei(wei: NumberString | string | bigint): DAI;
+    static fromFloat(float: number): DAI;
     toWeiString(): string;
     toWeiBigInt(): bigint;
     toDecimalString(): string;
     toSignificantDigits(digits: number): string;
+    toFloat(): number;
     /**
      * Does not mutate the current DAI instance.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ethersphere/bee-js",
-  "version": "12.0.0",
+  "version": "12.2.0",
   "description": "Javascript client for Bee",
   "keywords": [
     "bee",
@@ -44,7 +44,9 @@
     "./dist/cjs/utils/chunk-stream.js": "./dist/cjs/utils/chunk-stream.browser.js",
     "./dist/mjs/utils/chunk-stream.js": "./dist/mjs/utils/chunk-stream.browser.js",
     "./dist/cjs/utils/collection.node.js": "./dist/cjs/utils/collection.browser.js",
-    "./dist/mjs/utils/collection.node.js": "./dist/mjs/utils/collection.browser.js"
+    "./dist/mjs/utils/collection.node.js": "./dist/mjs/utils/collection.browser.js",
+    "./dist/cjs/utils/tar.js": "./dist/cjs/utils/tar.browser.js",
+    "./dist/mjs/utils/tar.js": "./dist/mjs/utils/tar.browser.js"
   },
   "files": [
     "dist"
@@ -56,13 +58,14 @@
     "build:types": "tsc --emitDeclarationOnly --declaration --outDir dist/types",
     "build:browser": "webpack --progress",
     "test": "TS_NODE_PROJECT=tsconfig.test.json jest --runInBand --verbose --forceExit",
+    "test:browser": "TS_NODE_PROJECT=tsconfig.test.json jest --config jest.browser.config.js --runInBand --verbose --forceExit",
     "check": "tsc --project tsconfig.test.json",
     "lint": "eslint \"src/**/*.ts\" \"test/**/*.ts\" && prettier --check \"src/**/*.ts\" \"test/**/*.ts\"",
     "depcheck": "depcheck ."
   },
   "dependencies": {
     "axios": "^1.15.1",
-    "cafe-utility": "^33.6.1",
+    "cafe-utility": "^33.9.0",
     "debug": "^4.4.1",
     "isomorphic-ws": "^4.0.1",
     "semver": "^7.3.5",
@@ -93,6 +96,7 @@
     "eslint-plugin-unused-imports": "^2.0.0",
     "husky": "^8.0.1",
     "jest": "^30.2.0",
+    "jest-environment-jsdom": "^30.4.1",
     "prettier": "^2.6.2",
     "rimraf": "^3.0.2",
     "terser-webpack-plugin": "^5.3.1",