@ardrive/turbo-sdk 1.27.0-alpha.2 → 1.27.0-alpha.4

package/README.md

@@ -352,6 +352,34 @@ const { winc, actualTokenAmount, equivalentWincTokenAmount } =
   });
 ```
 
+#### `getFiatEstimateForBytes({ byteCount, currency })`
+
+Get the current price from the Turbo Payment Service, denominated in the specified fiat currency, for uploading a specified number of bytes to Turbo.
+
+```typescript
+const turbo = TurboFactory.unauthenticated();
+const { amount } = await turbo.getFiatEstimateForBytes({
+  byteCount: 1024 * 1024 * 1024,
+  currency: 'usd', // specify the currency for the price
+});
+
+console.log(amount); // Estimated usd price for 1 GiB
+```
+
+<details>
+  <summary>Example Output</summary>
+
+```json
+{
+  "byteCount": 1073741824,
+  "amount": 20.58,
+  "currency": "usd",
+  "winc": "2402378997310"
+}
+```
+
+</details>
+
 #### `getTokenPriceForBytes({ byteCount })`
 
 Get the current price from the Turbo Payment Service, denominated in the specified token, for uploading a specified number of bytes to Turbo.
@@ -994,6 +1022,7 @@ Command Options:
 
 - `--value <value>` - Value to get the price for. e.g: 10.50 for $10.50 USD, 1024 for 1 KiB, 1.1 for 1.1 AR
 - `--type <type>` - Type of price to get. e.g: 'bytes', 'arweave', 'usd', 'kyve'. Default: 'bytes'
+- `--currency <currency>` - Currency unit of the reported price (e.g: 'usd', 'eur', 'gbp').
 
 e.g:
 
@@ -1009,13 +1038,28 @@ turbo price --value 1024 --type bytes
 turbo price --value 1.1 --type arweave
 ```
 
+##### `fiat-estimate`
+
+Get the current fiat estimation from the Turbo Payment Service, denominated in the specified fiat currency, for uploading a specified number of bytes to Turbo.
+
+Command Options:
+
+- `--byte-count <byteCount>` - Byte count of data to get the fiat estimate for
+- `--currency <currency>` - Currency unit of the reported price (e.g: 'usd', 'eur', 'gbp')
+
+e.g:
+
+```shell
+turbo fiat-estimate --byte-count 102400 --currency usd
+```
+
 ##### `token-price`
 
 Get the current price from the Turbo Payment Service, denominated in the specified token, for uploading a specified number of bytes to Turbo.
 
 Command Options:
 
-- `--byte-count <byteCount>` - Byte value to get the token price for
+- `--byte-count <byteCount>` - Byte count of data to get the token price for
 
 e.g:
 

package/bundles/web.bundle.min.js

@@ -111649,39 +111649,39 @@ function dew$63() {
     return Link2;
   }(events_1.EventEmitter);
   exports$83.Link = Link;
-  var File = function() {
-    function File2(link2, node, flags, fd) {
+  var File2 = function() {
+    function File3(link2, node, flags, fd) {
       this.position = 0;
       this.link = link2;
       this.node = node;
       this.flags = flags;
       this.fd = fd;
     }
-    File2.prototype.getString = function(encoding) {
+    File3.prototype.getString = function(encoding) {
       return this.node.getString();
     };
-    File2.prototype.setString = function(str) {
+    File3.prototype.setString = function(str) {
       this.node.setString(str);
     };
-    File2.prototype.getBuffer = function() {
+    File3.prototype.getBuffer = function() {
       return this.node.getBuffer();
     };
-    File2.prototype.setBuffer = function(buf) {
+    File3.prototype.setBuffer = function(buf) {
       this.node.setBuffer(buf);
     };
-    File2.prototype.getSize = function() {
+    File3.prototype.getSize = function() {
       return this.node.getSize();
     };
-    File2.prototype.truncate = function(len) {
+    File3.prototype.truncate = function(len) {
       this.node.truncate(len);
     };
-    File2.prototype.seekTo = function(position) {
+    File3.prototype.seekTo = function(position) {
       this.position = position;
     };
-    File2.prototype.stats = function() {
+    File3.prototype.stats = function() {
       return Stats_1.default.build(this.node);
     };
-    File2.prototype.write = function(buf, offset2, length, position) {
+    File3.prototype.write = function(buf, offset2, length, position) {
       if (offset2 === void 0) {
         offset2 = 0;
       }
@@ -111696,7 +111696,7 @@ function dew$63() {
       this.position = position + bytes4;
       return bytes4;
     };
-    File2.prototype.read = function(buf, offset2, length, position) {
+    File3.prototype.read = function(buf, offset2, length, position) {
       if (offset2 === void 0) {
         offset2 = 0;
       }
@@ -111709,15 +111709,15 @@ function dew$63() {
       this.position = position + bytes4;
       return bytes4;
     };
-    File2.prototype.chmod = function(perm) {
+    File3.prototype.chmod = function(perm) {
       this.node.chmod(perm);
     };
-    File2.prototype.chown = function(uid, gid) {
+    File3.prototype.chown = function(uid, gid) {
       this.node.chown(uid, gid);
     };
-    return File2;
+    return File3;
   }();
-  exports$83.File = File;
+  exports$83.File = File2;
   return exports$83;
 }
 function dew$53() {
@@ -122098,11 +122098,11 @@ var require_file = __commonJS({
     var os2 = (init_os(), __toCommonJS(os_exports));
     var tailFile = require_tail_file();
     module3.exports = /* @__PURE__ */ function(_TransportStream) {
-      function File() {
+      function File2() {
         var _this;
         var options = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
-        _classCallCheck(this, File);
-        _this = _callSuper(this, File, [options]);
+        _classCallCheck(this, File2);
+        _this = _callSuper(this, File2, [options]);
         _this.name = options.name || "file";
         function throwIf(target) {
           for (var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
@@ -122152,8 +122152,8 @@ var require_file = __commonJS({
           _this.open();
         return _this;
       }
-      _inherits(File, _TransportStream);
-      return _createClass(File, [{
+      _inherits(File2, _TransportStream);
+      return _createClass(File2, [{
         key: "finishIfEnding",
         value: function finishIfEnding() {
           var _this2 = this;
@@ -314072,7 +314072,7 @@ var import_winston = __toESM(require_winston(), 1);
 init_dirname();
 init_buffer2();
 init_process2();
-var version16 = "1.27.0-alpha.1";
+var version16 = "1.27.0-alpha.3";
 
 // src/common/logger.ts
 var TurboWinstonLogger = class _TurboWinstonLogger {
@@ -367056,6 +367056,23 @@ var TurboUnauthenticatedPaymentService = class {
     }
     return response;
   }
+  async getFiatEstimateForBytes({
+    byteCount,
+    currency
+  }) {
+    const wincPriceForGivenBytes = await this.getUploadCosts({
+      bytes: [byteCount]
+    });
+    const { winc: wincPriceForOneGiB, fiat: fiatPricesForOneGiB } = await this.getFiatRates();
+    const fiatPriceForGivenBytes = new BigNumber5(wincPriceForGivenBytes[0].winc).dividedBy(new BigNumber5(wincPriceForOneGiB)).times(fiatPricesForOneGiB[currency]);
+    const formattedFiatPrice = currency === "jpy" ? +fiatPriceForGivenBytes.integerValue(BigNumber5.ROUND_CEIL) : +fiatPriceForGivenBytes.decimalPlaces(2, BigNumber5.ROUND_CEIL);
+    return {
+      byteCount,
+      amount: formattedFiatPrice,
+      currency,
+      winc: wincPriceForGivenBytes[0].winc
+    };
+  }
   async getTokenPriceForBytes({
     byteCount
   }) {
@@ -367517,6 +367534,12 @@ function createStreamWithSigningEvents({
 }
 
 // src/common/upload.ts
+function isTurboUploadFileWithStreamFactoryParams(params) {
+  return "fileStreamFactory" in params;
+}
+function isTurboUploadFileWithFileOrPathParams(params) {
+  return "file" in params;
+}
 var creditSharingTagNames = {
   shareCredits: "x-approve-payment",
   sharedWincAmount: "x-amount",
@@ -367623,13 +367646,29 @@ var TurboAuthenticatedBaseUploadService = class extends TurboUnauthenticatedUplo
       events
     });
   }
-  async uploadFile({
-    fileStreamFactory,
-    fileSizeFactory,
-    signal,
-    dataItemOpts,
-    events = {}
-  }) {
+  resolveUploadFileConfig(params) {
+    let fileStreamFactory;
+    let fileSizeFactory;
+    if (isTurboUploadFileWithStreamFactoryParams(params)) {
+      fileStreamFactory = params.fileStreamFactory;
+      fileSizeFactory = params.fileSizeFactory;
+    } else if (isTurboUploadFileWithFileOrPathParams(params)) {
+      const file = params.file;
+      fileStreamFactory = file instanceof File ? () => this.getFileStreamForFile(file) : () => this.getFileStreamForFile(file);
+      fileSizeFactory = () => this.getFileSize(params.file);
+    } else {
+      throw new TypeError(
+        "Invalid upload file params. Must be either TurboUploadFileWithStreamFactoryParams or TurboUploadFileWithFileOrPathParams"
+      );
+    }
+    return {
+      fileStreamFactory,
+      fileSizeFactory,
+      ...params
+    };
+  }
+  async uploadFile(params) {
+    const { signal, dataItemOpts, events, fileStreamFactory, fileSizeFactory } = this.resolveUploadFileConfig(params);
     let retries = 0;
     const maxRetries = this.retryConfig.retries ?? 3;
     const retryDelay = this.retryConfig.retryDelay ?? ((retryNumber) => retryNumber * 1e3);
@@ -367732,6 +367771,7 @@ ${lastError instanceof Error ? lastError.message : lastError}`;
   }
   /**
    * TODO: add events to the uploadFolder method
+   * TODO: create resolveUploadFolderConfig() function
    * could be a predicate with a resolveConfig() function, eg: events: ({...file ctx}) => ({
    *   onProgress: (progress) => {
    *     console.log('progress', progress);
@@ -367963,6 +368003,18 @@ var TurboUnauthenticatedClient = class {
   getWincForToken(params) {
     return this.paymentService.getWincForToken(params);
   }
+  /**
+   * Determines the fiat estimate for a given byte count in a specific currency, including all Turbo cost adjustments and fees.
+   */
+  getFiatEstimateForBytes({
+    byteCount,
+    currency
+  }) {
+    return this.paymentService.getFiatEstimateForBytes({
+      byteCount,
+      currency
+    });
+  }
   /**
    * Determines the price in the instantiated token to upload one data item of a specific size in bytes, including all Turbo cost adjustments and fees.
    */
@@ -368046,23 +368098,8 @@ var TurboAuthenticatedClient = class extends TurboUnauthenticatedClient {
   }) {
     return this.uploadService.upload({ data, dataItemOpts, signal, events });
   }
-  /**
-   * Signs and uploads raw file data to the Turbo Upload Service.
-   */
-  uploadFile({
-    fileStreamFactory,
-    fileSizeFactory,
-    signal,
-    dataItemOpts,
-    events
-  }) {
-    return this.uploadService.uploadFile({
-      fileStreamFactory,
-      fileSizeFactory,
-      signal,
-      dataItemOpts,
-      events
-    });
+  uploadFile(params) {
+    return this.uploadService.uploadFile(params);
   }
   uploadFolder(p9) {
     return this.uploadService.uploadFolder(p9);

package/lib/cjs/cli/cli.js

@@ -20,6 +20,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 // eslint-disable-next-line header/header -- This is a CLI file
 const commander_1 = require("commander");
 const version_js_1 = require("../version.js");
+const fiatEstimate_js_1 = require("./commands/fiatEstimate.js");
 const index_js_1 = require("./commands/index.js");
 const listShares_js_1 = require("./commands/listShares.js");
 const revokeCredits_js_1 = require("./commands/revokeCredits.js");
@@ -49,14 +50,19 @@ const utils_js_1 = require("./utils.js");
 });
 (0, utils_js_1.applyOptions)(commander_1.program
     .command('price')
-    .description('Get the current Credits estimate for byte, crypto, or fiat value'), [options_js_1.optionMap.value, options_js_1.optionMap.type]).action(async (_commandOptions, command) => {
+    .description('Get the current Credits estimate for byte, crypto, or fiat value'), [options_js_1.optionMap.value, options_js_1.optionMap.type, options_js_1.optionMap.currency]).action(async (_commandOptions, command) => {
     await (0, utils_js_1.runCommand)(command, index_js_1.price);
 });
 (0, utils_js_1.applyOptions)(commander_1.program
     .command('token-price')
-    .description('Get the current token price for provided byte value'), [options_js_1.optionMap.byteCount]).action(async (_commandOptions, command) => {
+    .description('Get the current token price for provided byte count'), [options_js_1.optionMap.byteCount]).action(async (_commandOptions, command) => {
     await (0, utils_js_1.runCommand)(command, tokenPrice_js_1.tokenPrice);
 });
+(0, utils_js_1.applyOptions)(commander_1.program
+    .command('fiat-estimate')
+    .description('Get the current token price for provided byte count'), [options_js_1.optionMap.byteCount, options_js_1.optionMap.currency]).action(async (_commandOptions, command) => {
+    await (0, utils_js_1.runCommand)(command, fiatEstimate_js_1.fiatEstimate);
+});
 (0, utils_js_1.applyOptions)(commander_1.program
     .command('share-credits')
     .description('Create a Turbo credit share approval'), options_js_1.shareCreditsOptions).action(async (_commandOptions, command) => {

package/lib/cjs/cli/commands/fiatEstimate.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fiatEstimate = fiatEstimate;
+/**
+ * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+const index_js_1 = require("../../node/index.js");
+const utils_js_1 = require("../utils.js");
+async function fiatEstimate(options) {
+    const byteCount = (0, utils_js_1.requiredByteCountFromOptions)(options);
+    const currency = (0, utils_js_1.currencyFromOptions)(options) ?? 'usd';
+    const turbo = index_js_1.TurboFactory.unauthenticated((0, utils_js_1.configFromOptions)(options));
+    const result = await turbo.getFiatEstimateForBytes({
+        byteCount,
+        currency,
+    });
+    const output = {
+        ...result,
+        message: `The current price estimate for ${byteCount} bytes is ${result.amount} ${currency}`,
+    };
+    console.log(JSON.stringify(output, null, 2));
+}

package/lib/cjs/cli/commands/price.js

@@ -22,12 +22,19 @@ const factory_js_1 = require("../../node/factory.js");
 const types_js_1 = require("../../types.js");
 const constants_js_1 = require("../constants.js");
 const utils_js_1 = require("../utils.js");
+const fiatEstimate_js_1 = require("./fiatEstimate.js");
 async function price(options) {
     const value = options.value;
     if (value === undefined || +value <= 0 || isNaN(+value)) {
         throw new Error('Must provide a positive number --value to get price');
     }
     const type = options.type ?? 'bytes';
+    const currency = (0, utils_js_1.currencyFromOptions)(options);
+    if (currency !== undefined && type === 'bytes') {
+        // User supplied --type bytes --currency <currency> --value <bytes>
+        // This is a special case where we will provide a fiat estimate for the bytes value
+        return (0, fiatEstimate_js_1.fiatEstimate)({ ...options, byteCount: value });
+    }
     const winc = await (async () => {
         if ((0, index_js_1.isTokenType)(type)) {
             const turbo = factory_js_1.TurboFactory.unauthenticated({

package/lib/cjs/cli/commands/tokenPrice.js

@@ -21,13 +21,7 @@ const factory_js_1 = require("../../node/factory.js");
 const types_js_1 = require("../../types.js");
 const utils_js_1 = require("../utils.js");
 async function tokenPrice(options) {
-    const byteCount = options.byteCount !== undefined ? +options.byteCount : undefined;
-    if (byteCount === undefined ||
-        byteCount <= 0 ||
-        isNaN(byteCount) ||
-        !Number.isInteger(byteCount)) {
-        throw new Error('Must provide a positive number for byte to get price.\nFor example, to get the SOL price for 100 MiB use the following:\nturbo token-price --token solana --byte-count 1048576000');
-    }
+    const byteCount = (0, utils_js_1.requiredByteCountFromOptions)(options);
     const token = options.token;
     if (!(0, index_js_1.isTokenType)(token)) {
         throw new Error(`Invalid token type ${token}. Must be one of ${types_js_1.tokenTypes.join(', ')}`);

package/lib/cjs/cli/commands/topUp.js

@@ -19,7 +19,6 @@ exports.topUp = topUp;
 const child_process_1 = require("child_process");
 const currency_js_1 = require("../../common/currency.js");
 const factory_js_1 = require("../../node/factory.js");
-const types_js_1 = require("../../types.js");
 const common_js_1 = require("../../utils/common.js");
 const utils_js_1 = require("../utils.js");
 function openUrl(url) {
@@ -43,10 +42,7 @@ async function topUp(options) {
     if (value === undefined) {
         throw new Error('Must provide a --value to top up');
     }
-    const currency = (options.currency ?? 'usd').toLowerCase();
-    if (!(0, types_js_1.isCurrency)(currency)) {
-        throw new Error(`Invalid fiat currency type ${currency}!\nPlease use one of these:\n${JSON.stringify(types_js_1.fiatCurrencyTypes, null, 2)}`);
-    }
+    const currency = (0, utils_js_1.currencyFromOptions)(options) ?? 'usd';
     // TODO: Pay in CLI prompts via --cli options
     const { url, paymentAmount, winc } = await (async () => {
         const amount = currency_js_1.currencyMap[currency](+value);

package/lib/cjs/cli/utils.js

@@ -18,6 +18,8 @@ exports.paidByFromOptions = paidByFromOptions;
 exports.getUploadFolderOptions = getUploadFolderOptions;
 exports.parseTags = parseTags;
 exports.getTagsFromOptions = getTagsFromOptions;
+exports.currencyFromOptions = currencyFromOptions;
+exports.requiredByteCountFromOptions = requiredByteCountFromOptions;
 /**
  * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
  *
@@ -258,3 +260,20 @@ function parseTags(tagsArr) {
 function getTagsFromOptions(options) {
     return parseTags(options.tags);
 }
+function currencyFromOptions(options) {
+    const currency = options.currency?.toLowerCase();
+    if (!(0, index_js_1.isCurrency)(currency)) {
+        throw new Error(`Invalid fiat currency type ${currency}!\nPlease use one of these:\n${JSON.stringify(index_js_1.fiatCurrencyTypes, null, 2)}`);
+    }
+    return currency;
+}
+function requiredByteCountFromOptions({ byteCount, }) {
+    const byteCountValue = byteCount !== undefined ? +byteCount : undefined;
+    if (byteCountValue === undefined ||
+        isNaN(byteCountValue) ||
+        !Number.isInteger(byteCountValue) ||
+        byteCountValue <= 0) {
+        throw new Error('Must provide a positive number for byte count.');
+    }
+    return byteCountValue;
+}

package/lib/cjs/common/payment.js

@@ -178,6 +178,29 @@ class TurboUnauthenticatedPaymentService {
         }
         return response;
     }
+    async getFiatEstimateForBytes({ byteCount, currency, }) {
+        // Step 1: Get the estimated winc cost for the given byte count -- W
+        const wincPriceForGivenBytes = await this.getUploadCosts({
+            bytes: [byteCount],
+        });
+        // Step 2: Get the winc-to-fiat conversion rates for 1 GiB
+        const { winc: wincPriceForOneGiB, fiat: fiatPricesForOneGiB } = await this.getFiatRates();
+        // Step 3: Convert the WINC cost of the given bytes into fiat:
+        //  (W / W1GiB) * Fiat1GiB = FiatCostForBytes
+        const fiatPriceForGivenBytes = new bignumber_js_1.BigNumber(wincPriceForGivenBytes[0].winc)
+            .dividedBy(new bignumber_js_1.BigNumber(wincPriceForOneGiB))
+            .times(fiatPricesForOneGiB[currency]);
+        // Step 4: Format and round up so the estimated cost is always enough to cover the upload
+        const formattedFiatPrice = currency === 'jpy'
+            ? +fiatPriceForGivenBytes.integerValue(bignumber_js_1.BigNumber.ROUND_CEIL) // no decimals for JPY
+            : +fiatPriceForGivenBytes.decimalPlaces(2, bignumber_js_1.BigNumber.ROUND_CEIL); // 2 decimal precision
+        return {
+            byteCount,
+            amount: formattedFiatPrice,
+            currency,
+            winc: wincPriceForGivenBytes[0].winc,
+        };
+    }
     async getTokenPriceForBytes({ byteCount, }) {
         const wincPriceForOneToken = (await this.getWincForToken({
             tokenAmount: index_js_1.tokenToBaseMap[this.token](1),

package/lib/cjs/common/turbo.js

@@ -78,6 +78,15 @@ class TurboUnauthenticatedClient {
     getWincForToken(params) {
         return this.paymentService.getWincForToken(params);
     }
+    /**
+     * Determines the fiat estimate for a given byte count in a specific currency, including all Turbo cost adjustments and fees.
+     */
+    getFiatEstimateForBytes({ byteCount, currency, }) {
+        return this.paymentService.getFiatEstimateForBytes({
+            byteCount,
+            currency,
+        });
+    }
     /**
      * Determines the price in the instantiated token to upload one data item of a specific size in bytes, including all Turbo cost adjustments and fees.
      */
@@ -146,17 +155,8 @@ class TurboAuthenticatedClient extends TurboUnauthenticatedClient {
     upload({ data, dataItemOpts, signal, events, }) {
         return this.uploadService.upload({ data, dataItemOpts, signal, events });
     }
-    /**
-     * Signs and uploads raw file data to the Turbo Upload Service.
-     */
-    uploadFile({ fileStreamFactory, fileSizeFactory, signal, dataItemOpts, events, }) {
-        return this.uploadService.uploadFile({
-            fileStreamFactory,
-            fileSizeFactory,
-            signal,
-            dataItemOpts,
-            events,
-        });
+    uploadFile(params) {
+        return this.uploadService.uploadFile(params);
     }
     uploadFolder(p) {
         return this.uploadService.uploadFolder(p);

package/lib/cjs/common/upload.js

@@ -24,6 +24,12 @@ const errors_js_1 = require("../utils/errors.js");
 const events_js_1 = require("./events.js");
 const http_js_1 = require("./http.js");
 const logger_js_1 = require("./logger.js");
+function isTurboUploadFileWithStreamFactoryParams(params) {
+    return 'fileStreamFactory' in params;
+}
+function isTurboUploadFileWithFileOrPathParams(params) {
+    return 'file' in params;
+}
 exports.creditSharingTagNames = {
     shareCredits: 'x-approve-payment',
     sharedWincAmount: 'x-amount',
@@ -119,7 +125,36 @@ class TurboAuthenticatedBaseUploadService extends TurboUnauthenticatedUploadServ
             events,
         });
     }
-    async uploadFile({ fileStreamFactory, fileSizeFactory, signal, dataItemOpts, events = {}, }) {
+    resolveUploadFileConfig(params) {
+        let fileStreamFactory;
+        let fileSizeFactory;
+        if (isTurboUploadFileWithStreamFactoryParams(params)) {
+            fileStreamFactory = params.fileStreamFactory;
+            fileSizeFactory = params.fileSizeFactory;
+        }
+        else if (isTurboUploadFileWithFileOrPathParams(params)) {
+            const file = params.file;
+            /**
+             * this is pretty gross, but it's the only way to get the type inference to work without overhauling
+             * the abstract method to accept a generic, which we would need to perform a check on anyways.
+             */
+            fileStreamFactory =
+                file instanceof File
+                    ? () => this.getFileStreamForFile(file)
+                    : () => this.getFileStreamForFile(file);
+            fileSizeFactory = () => this.getFileSize(params.file);
+        }
+        else {
+            throw new TypeError('Invalid upload file params. Must be either TurboUploadFileWithStreamFactoryParams or TurboUploadFileWithFileOrPathParams');
+        }
+        return {
+            fileStreamFactory,
+            fileSizeFactory,
+            ...params,
+        };
+    }
+    async uploadFile(params) {
+        const { signal, dataItemOpts, events, fileStreamFactory, fileSizeFactory } = this.resolveUploadFileConfig(params);
         let retries = 0;
         const maxRetries = this.retryConfig.retries ?? 3;
         const retryDelay = this.retryConfig.retryDelay ??
@@ -223,6 +258,7 @@ class TurboAuthenticatedBaseUploadService extends TurboUnauthenticatedUploadServ
     }
     /**
      * TODO: add events to the uploadFolder method
+     * TODO: create resolveUploadFolderConfig() function
      * could be a predicate with a resolveConfig() function, eg: events: ({...file ctx}) => ({
      *   onProgress: (progress) => {
      *     console.log('progress', progress);

package/lib/cjs/version.js

@@ -17,4 +17,4 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.version = void 0;
 // AUTOMATICALLY GENERATED FILE - DO NOT TOUCH
-exports.version = '1.27.0-alpha.2';
+exports.version = '1.27.0-alpha.4';

package/lib/esm/cli/cli.js

@@ -18,6 +18,7 @@
 // eslint-disable-next-line header/header -- This is a CLI file
 import { program } from 'commander';
 import { version } from '../version.js';
+import { fiatEstimate } from './commands/fiatEstimate.js';
 import { balance, cryptoFund, price, topUp, uploadFile, uploadFolder, } from './commands/index.js';
 import { listShares } from './commands/listShares.js';
 import { revokeCredits } from './commands/revokeCredits.js';
@@ -47,14 +48,19 @@ applyOptions(program.command('upload-file').description('Upload a file using Tur
 });
 applyOptions(program
     .command('price')
-    .description('Get the current Credits estimate for byte, crypto, or fiat value'), [optionMap.value, optionMap.type]).action(async (_commandOptions, command) => {
+    .description('Get the current Credits estimate for byte, crypto, or fiat value'), [optionMap.value, optionMap.type, optionMap.currency]).action(async (_commandOptions, command) => {
     await runCommand(command, price);
 });
 applyOptions(program
     .command('token-price')
-    .description('Get the current token price for provided byte value'), [optionMap.byteCount]).action(async (_commandOptions, command) => {
+    .description('Get the current token price for provided byte count'), [optionMap.byteCount]).action(async (_commandOptions, command) => {
     await runCommand(command, tokenPrice);
 });
+applyOptions(program
+    .command('fiat-estimate')
+    .description('Get the current token price for provided byte count'), [optionMap.byteCount, optionMap.currency]).action(async (_commandOptions, command) => {
+    await runCommand(command, fiatEstimate);
+});
 applyOptions(program
     .command('share-credits')
     .description('Create a Turbo credit share approval'), shareCreditsOptions).action(async (_commandOptions, command) => {

package/lib/esm/cli/commands/fiatEstimate.js

@@ -0,0 +1,31 @@
+/**
+ * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { TurboFactory } from '../../node/index.js';
+import { configFromOptions, currencyFromOptions, requiredByteCountFromOptions, } from '../utils.js';
+export async function fiatEstimate(options) {
+    const byteCount = requiredByteCountFromOptions(options);
+    const currency = currencyFromOptions(options) ?? 'usd';
+    const turbo = TurboFactory.unauthenticated(configFromOptions(options));
+    const result = await turbo.getFiatEstimateForBytes({
+        byteCount,
+        currency,
+    });
+    const output = {
+        ...result,
+        message: `The current price estimate for ${byteCount} bytes is ${result.amount} ${currency}`,
+    };
+    console.log(JSON.stringify(output, null, 2));
+}