@ardrive/turbo-sdk 1.13.0 → 1.14.0-alpha.1

package/README.md

@@ -69,6 +69,7 @@ Welcome to the `@ardrive/turbo-sdk`! This SDK provides functionality for interac
       - [`balance`](#balance)
       - [`top-up`](#top-up)
       - [`crypto-fund`](#crypto-fund)
+      - [`upload-folder`](#upload-folder)
 - [Developers](#developers)
   - [Requirements](#requirements)
   - [Setup & Build](#setup--build)
@@ -737,6 +738,24 @@ e.g:
 turbo crypto-fund --value 0.0001 --token kyve --private-key 'b27...45c'
 ```
 
+##### `upload-folder`
+
+Upload a folder of files and create and upload a manifest file for the folder upload to the Turbo Upload Service.
+
+Command Options:
+
+- `-f, --folder-path <folderPath>` - Path to the folder to upload
+- `--index-file <indexFile>` - File to use for the "index" path in the resulting manifest
+- `--fallback-file <fallbackFile>` - File to use for the "fallback" path in the resulting manifest
+- `--no-manifest` - Disable manifest creation
+- `--max-concurrency <maxConcurrency>` - Maximum number of concurrent uploads
+
+e.g:
+
+```shell
+turbo upload-folder --folder-path '../path/to/my/folder' --token solana --wallet-file ../path/to/sol/sec/key.json
+```
+
 ## Developers
 
 ### Requirements

package/bundles/web.bundle.min.js

@@ -312251,7 +312251,7 @@ var import_winston = __toESM(require_winston(), 1);
 init_dirname();
 init_buffer2();
 init_process2();
-var version16 = "1.13.0-alpha.2";
+var version16 = "1.13.0";
 
 // src/common/logger.ts
 var TurboWinstonLogger = class _TurboWinstonLogger {

package/lib/cjs/cli/cli.js

@@ -21,38 +21,20 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const commander_1 = require("commander");
 const version_js_1 = require("../version.js");
 const commands_js_1 = require("./commands.js");
+const options_js_1 = require("./options.js");
 const utils_js_1 = require("./utils.js");
 (0, utils_js_1.applyOptions)(commander_1.program
     .name('turbo')
     .version(version_js_1.version)
     .description('Turbo CLI')
-    .helpCommand(true), utils_js_1.globalOptions);
-function exitWithErrorLog(error) {
-    console.error(error instanceof Error ? error.message : error);
-    process.exit(1);
-}
-(0, utils_js_1.applyOptions)(commander_1.program.command('balance').description('Get balance of a Turbo address'), [utils_js_1.optionMap.address, ...utils_js_1.walletOptions]).action(async (_commandOptions, command) => {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const options = command.optsWithGlobals();
-    try {
-        await (0, commands_js_1.getBalance)(options);
-        process.exit(0);
-    }
-    catch (error) {
-        exitWithErrorLog(error);
-    }
+    .helpCommand(true), options_js_1.globalOptions);
+(0, utils_js_1.applyOptions)(commander_1.program.command('balance').description('Get balance of a Turbo address'), [options_js_1.optionMap.address, ...options_js_1.walletOptions]).action(async (_commandOptions, command) => {
+    await (0, utils_js_1.runCommand)(command, commands_js_1.getBalance);
 });
-(0, utils_js_1.applyOptions)(commander_1.program.command('top-up').description('Top up a Turbo address with Fiat'), [...utils_js_1.walletOptions, utils_js_1.optionMap.address, utils_js_1.optionMap.value, utils_js_1.optionMap.currency]).action(async (_commandOptions, command) => {
-    const options = command.optsWithGlobals();
-    try {
-        await (0, commands_js_1.topUp)(options);
-        process.exit(0);
-    }
-    catch (error) {
-        exitWithErrorLog(error);
-    }
+(0, utils_js_1.applyOptions)(commander_1.program.command('top-up').description('Top up a Turbo address with Fiat'), [...options_js_1.walletOptions, options_js_1.optionMap.address, options_js_1.optionMap.value, options_js_1.optionMap.currency]).action(async (_commandOptions, command) => {
+    await (0, utils_js_1.runCommand)(command, commands_js_1.topUp);
 });
-(0, utils_js_1.applyOptions)(commander_1.program.command('crypto-fund').description('Top up a wallet with crypto'), [...utils_js_1.walletOptions, utils_js_1.optionMap.value]).action(async (_commandOptions, command) => {
+(0, utils_js_1.applyOptions)(commander_1.program.command('crypto-fund').description('Top up a wallet with crypto'), [...options_js_1.walletOptions, options_js_1.optionMap.value]).action(async (_commandOptions, command) => {
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     const options = command.optsWithGlobals();
     const token = (0, utils_js_1.tokenFromOptions)(options);
@@ -64,14 +46,11 @@ function exitWithErrorLog(error) {
         process.exit(0);
     }
     catch (error) {
-        exitWithErrorLog(error);
+        (0, utils_js_1.exitWithErrorLog)(error);
     }
 });
-(0, utils_js_1.applyOptions)(commander_1.program
-    .command('upload-folder')
-    .description('Upload a folder to a Turbo address')
-    .argument('<folderPath>', 'Directory to upload'), [...utils_js_1.walletOptions, utils_js_1.optionMap.token]).action((directory, options) => {
-    console.log('upload-folder TODO', directory, options);
+(0, utils_js_1.applyOptions)(commander_1.program.command('upload-folder').description('Upload a folder using Turbo'), options_js_1.uploadFolderOptions).action(async (_commandOptions, command) => {
+    await (0, utils_js_1.runCommand)(command, commands_js_1.uploadFolder);
 });
 if (process.argv[1].includes('bin/turbo') || // Running from global .bin
     process.argv[1].includes('cli/cli') // Running from source

package/lib/cjs/cli/commands.js

@@ -1,10 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.addressOrPrivateKeyFromOptions = addressOrPrivateKeyFromOptions;
 exports.getBalance = getBalance;
 exports.cryptoFund = cryptoFund;
 exports.topUp = topUp;
 exports.openUrl = openUrl;
+exports.uploadFolder = uploadFolder;
 /**
  * Copyright (C) 2022-2024 Permanent Data Solutions, Inc. All Rights Reserved.
  *
@@ -24,19 +24,11 @@ exports.openUrl = openUrl;
 const node_child_process_1 = require("node:child_process");
 const index_js_1 = require("../node/index.js");
 const common_js_1 = require("../utils/common.js");
+const version_js_1 = require("../version.js");
 const utils_js_1 = require("./utils.js");
-async function addressOrPrivateKeyFromOptions(options) {
-    if (options.address !== undefined) {
-        return { address: options.address, privateKey: undefined };
-    }
-    return {
-        address: undefined,
-        privateKey: await (0, utils_js_1.optionalPrivateKeyFromOptions)(options),
-    };
-}
 async function getBalance(options) {
     const config = (0, utils_js_1.configFromOptions)(options);
-    const { address, privateKey } = await addressOrPrivateKeyFromOptions(options);
+    const { address, privateKey } = await (0, utils_js_1.addressOrPrivateKeyFromOptions)(options);
     if (address !== undefined) {
         const turbo = index_js_1.TurboFactory.unauthenticated(config);
         const { winc } = await turbo.getBalance(address);
@@ -67,7 +59,7 @@ async function cryptoFund({ value, privateKey, token, config, }) {
 }
 async function topUp(options) {
     const config = (0, utils_js_1.configFromOptions)(options);
-    const { address, privateKey } = await addressOrPrivateKeyFromOptions(options);
+    const { address, privateKey } = await (0, utils_js_1.addressOrPrivateKeyFromOptions)(options);
     const value = options.value;
     if (value === undefined) {
         throw new Error('Must provide a --value to top up');
@@ -120,3 +112,27 @@ function openUrl(url) {
         open(url);
     }
 }
+const turboCliTags = [
+    { name: 'App-Name', value: 'Turbo-CLI' },
+    { name: 'App-Version', value: version_js_1.version },
+    { name: 'App-Platform', value: process.platform },
+];
+async function uploadFolder(options) {
+    const privateKey = await (0, utils_js_1.privateKeyFromOptions)(options);
+    const turbo = index_js_1.TurboFactory.authenticated({
+        ...(0, utils_js_1.configFromOptions)(options),
+        privateKey,
+    });
+    const { disableManifest, fallbackFile, folderPath, indexFile, maxConcurrentUploads, } = (0, utils_js_1.getUploadFolderOptions)(options);
+    const result = await turbo.uploadFolder({
+        folderPath: folderPath,
+        dataItemOpts: { tags: [...turboCliTags] }, // TODO: Inject user tags
+        manifestOptions: {
+            disableManifest,
+            indexFile,
+            fallbackFile,
+        },
+        maxConcurrentUploads,
+    });
+    console.log('Uploaded folder:', JSON.stringify(result, null, 2));
+}

package/lib/cjs/cli/options.js

@@ -0,0 +1,114 @@
+"use strict";
+/**
+ * Copyright (C) 2022-2024 Permanent Data Solutions, Inc. All Rights Reserved.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uploadFolderOptions = exports.globalOptions = exports.walletOptions = exports.optionMap = void 0;
+exports.optionMap = {
+    token: {
+        alias: '-t, --token <type>',
+        description: 'Crypto token type for wallet or action',
+        default: 'arweave',
+    },
+    currency: {
+        alias: '-c, --currency <currency>',
+        description: 'Fiat currency type to use for the action',
+        default: 'usd',
+    },
+    address: {
+        alias: '-a, --address <nativeAddress>',
+        description: 'Native address to use for action',
+    },
+    value: {
+        alias: '-v, --value <value>',
+        description: 'Value of fiat currency or crypto token for action. e.g: 10.50 for $10.50 USD or 0.0001 for 0.0001 AR',
+    },
+    walletFile: {
+        alias: '-w, --wallet-file <filePath>',
+        description: 'Wallet file to use with the action. Formats accepted: JWK.json, KYVE or ETH private key as a string, or SOL Secret Key as a Uint8Array',
+    },
+    mnemonic: {
+        alias: '-m, --mnemonic <phrase>',
+        description: 'Mnemonic to use with the action',
+    },
+    privateKey: {
+        alias: '-p, --private-key <key>',
+        description: 'Private key to use with the action',
+    },
+    gateway: {
+        alias: '-g, --gateway <url>',
+        description: 'Set a custom crypto gateway URL',
+        default: undefined,
+    },
+    dev: {
+        alias: '--dev',
+        description: 'Enable development endpoints',
+        default: false,
+    },
+    debug: {
+        // TODO: Implement
+        alias: '--debug',
+        description: 'Enable verbose logging',
+        default: false,
+    },
+    quiet: {
+        // TODO: Implement
+        alias: '--quiet',
+        description: 'Disable logging',
+        default: false,
+    },
+    folderPath: {
+        alias: '-f, --folder-path <folderPath>',
+        description: 'Directory to upload',
+    },
+    indexFile: {
+        alias: '--index-file <indexFile>',
+        description: 'Index file to use in the manifest created for folder upload',
+    },
+    fallbackFile: {
+        alias: '--fallback-file <fallbackFile>',
+        description: 'Fallback file to use in the manifest created for folder upload',
+    },
+    manifest: {
+        alias: '--no-manifest',
+        description: 'Disable manifest creation with --no-manifest',
+        default: false,
+    },
+    maxConcurrency: {
+        alias: '--max-concurrency <maxConcurrency>',
+        description: 'Maximum number of concurrent uploads',
+    },
+};
+exports.walletOptions = [
+    exports.optionMap.walletFile,
+    exports.optionMap.mnemonic,
+    exports.optionMap.privateKey,
+];
+exports.globalOptions = [
+    exports.optionMap.dev,
+    exports.optionMap.gateway,
+    exports.optionMap.debug,
+    exports.optionMap.quiet,
+    exports.optionMap.token,
+];
+exports.uploadFolderOptions = [
+    ...exports.walletOptions,
+    exports.optionMap.folderPath,
+    exports.optionMap.indexFile,
+    exports.optionMap.fallbackFile,
+    exports.optionMap.manifest,
+    exports.optionMap.maxConcurrency,
+];

package/lib/cjs/cli/utils.js

@@ -3,13 +3,17 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.globalOptions = exports.walletOptions = exports.optionMap = void 0;
+exports.exitWithErrorLog = exitWithErrorLog;
+exports.runCommand = runCommand;
 exports.applyOptions = applyOptions;
 exports.tokenFromOptions = tokenFromOptions;
 exports.valueFromOptions = valueFromOptions;
+exports.getFolderPathFromOptions = getFolderPathFromOptions;
+exports.addressOrPrivateKeyFromOptions = addressOrPrivateKeyFromOptions;
 exports.optionalPrivateKeyFromOptions = optionalPrivateKeyFromOptions;
 exports.privateKeyFromOptions = privateKeyFromOptions;
 exports.configFromOptions = configFromOptions;
+exports.getUploadFolderOptions = getUploadFolderOptions;
 /**
  * Copyright (C) 2022-2024 Permanent Data Solutions, Inc. All Rights Reserved.
  *
@@ -30,72 +34,20 @@ const bs58_1 = __importDefault(require("bs58"));
 const fs_1 = require("fs");
 const index_js_1 = require("../node/index.js");
 const errors_js_1 = require("./errors.js");
-exports.optionMap = {
-    token: {
-        alias: '-t, --token <type>',
-        description: 'Crypto token type for wallet or action',
-        default: 'arweave',
-    },
-    currency: {
-        alias: '-c, --currency <currency>',
-        description: 'Fiat currency type to use for the action',
-        default: 'usd',
-    },
-    address: {
-        alias: '-a, --address <nativeAddress>',
-        description: 'Native address to use for action',
-    },
-    value: {
-        alias: '-v, --value <value>',
-        description: 'Value of fiat currency or crypto token for action. e.g: 10.50 for $10.50 USD or 0.0001 for 0.0001 AR',
-    },
-    walletFile: {
-        alias: '-w, --wallet-file <filePath>',
-        description: 'Wallet file to use with the action. Formats accepted: JWK.json, KYVE or ETH private key as a string, or SOL Secret Key as a Uint8Array',
-    },
-    mnemonic: {
-        alias: '-m, --mnemonic <phrase>',
-        description: 'Mnemonic to use with the action',
-    },
-    privateKey: {
-        alias: '-p, --private-key <key>',
-        description: 'Private key to use with the action',
-    },
-    gateway: {
-        alias: '-g, --gateway <url>',
-        description: 'Set a custom crypto gateway URL',
-        default: undefined,
-    },
-    dev: {
-        alias: '--dev',
-        description: 'Enable development endpoints',
-        default: false,
-    },
-    debug: {
-        // TODO: Implement
-        alias: '--debug',
-        description: 'Enable verbose logging',
-        default: false,
-    },
-    quiet: {
-        // TODO: Implement
-        alias: '--quiet',
-        description: 'Disable logging',
-        default: false,
-    },
-};
-exports.walletOptions = [
-    exports.optionMap.walletFile,
-    exports.optionMap.mnemonic,
-    exports.optionMap.privateKey,
-];
-exports.globalOptions = [
-    exports.optionMap.dev,
-    exports.optionMap.gateway,
-    exports.optionMap.debug,
-    exports.optionMap.quiet,
-    exports.optionMap.token,
-];
+function exitWithErrorLog(error) {
+    console.error(error instanceof Error ? error.message : error);
+    process.exit(1);
+}
+async function runCommand(command, action) {
+    const options = command.optsWithGlobals();
+    try {
+        await action(options);
+        process.exit(0);
+    }
+    catch (error) {
+        exitWithErrorLog(error);
+    }
+}
 function applyOptions(command, options) {
     [...options].forEach((option) => {
         command.option(option.alias, option.description, option.default);
@@ -119,6 +71,27 @@ function valueFromOptions(options) {
     }
     return value;
 }
+function getFolderPathFromOptions(options) {
+    const folderPath = options.folderPath;
+    if (folderPath === undefined) {
+        throw new Error('Folder path is required. Use --folderPath <path>');
+    }
+    // Check if path exists and is a directory
+    const stats = (0, fs_1.statSync)(folderPath);
+    if (!stats.isDirectory()) {
+        throw new Error('Folder path is not a directory');
+    }
+    return folderPath;
+}
+async function addressOrPrivateKeyFromOptions(options) {
+    if (options.address !== undefined) {
+        return { address: options.address, privateKey: undefined };
+    }
+    return {
+        address: undefined,
+        privateKey: await optionalPrivateKeyFromOptions(options),
+    };
+}
 async function optionalPrivateKeyFromOptions(options) {
     try {
         const key = await privateKeyFromOptions(options);
@@ -157,6 +130,7 @@ const tokenToDevGatewayMap = {
     solana: 'https://api.devnet.solana.com',
     ethereum: 'https://ethereum-holesky-rpc.publicnode.com',
     kyve: 'https://api.korellia.kyve.network',
+    // matic: 'https://rpc-amoy.polygon.technology',
 };
 function configFromOptions({ gateway, dev, token, }) {
     let config = {};
@@ -174,3 +148,12 @@ function configFromOptions({ gateway, dev, token, }) {
     config.token = token;
     return config;
 }
+function getUploadFolderOptions(options) {
+    return {
+        folderPath: options.folderPath,
+        indexFile: options.indexFile,
+        fallbackFile: options.fallbackFile,
+        disableManifest: !options.manifest,
+        maxConcurrentUploads: +(options.maxConcurrency ?? 1),
+    };
+}

package/lib/cjs/node/upload.js

@@ -32,6 +32,9 @@ class TurboAuthenticatedUploadService extends upload_js_1.TurboAuthenticatedBase
         // Walk the directory and add all file paths to the array
         const files = await fs_1.promises.readdir(folderPath);
         for (const file of files) {
+            if (file === '.DS_Store') {
+                continue;
+            }
             const absoluteFilePath = (0, path_1.join)(folderPath, file);
             const stat = await fs_1.promises.stat(absoluteFilePath);
             if (stat.isDirectory()) {

package/lib/cjs/version.js

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

package/lib/esm/cli/cli.js

@@ -18,37 +18,19 @@
 // eslint-disable-next-line header/header -- This is a CLI file
 import { program } from 'commander';
 import { version } from '../version.js';
-import { cryptoFund, getBalance, topUp } from './commands.js';
-import { applyOptions, configFromOptions, globalOptions, optionMap, privateKeyFromOptions, tokenFromOptions, valueFromOptions, walletOptions, } from './utils.js';
+import { cryptoFund, getBalance, topUp, uploadFolder } from './commands.js';
+import { globalOptions, optionMap, uploadFolderOptions, walletOptions, } from './options.js';
+import { applyOptions, configFromOptions, exitWithErrorLog, privateKeyFromOptions, runCommand, tokenFromOptions, valueFromOptions, } from './utils.js';
 applyOptions(program
     .name('turbo')
     .version(version)
     .description('Turbo CLI')
     .helpCommand(true), globalOptions);
-function exitWithErrorLog(error) {
-    console.error(error instanceof Error ? error.message : error);
-    process.exit(1);
-}
 applyOptions(program.command('balance').description('Get balance of a Turbo address'), [optionMap.address, ...walletOptions]).action(async (_commandOptions, command) => {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const options = command.optsWithGlobals();
-    try {
-        await getBalance(options);
-        process.exit(0);
-    }
-    catch (error) {
-        exitWithErrorLog(error);
-    }
+    await runCommand(command, getBalance);
 });
 applyOptions(program.command('top-up').description('Top up a Turbo address with Fiat'), [...walletOptions, optionMap.address, optionMap.value, optionMap.currency]).action(async (_commandOptions, command) => {
-    const options = command.optsWithGlobals();
-    try {
-        await topUp(options);
-        process.exit(0);
-    }
-    catch (error) {
-        exitWithErrorLog(error);
-    }
+    await runCommand(command, topUp);
 });
 applyOptions(program.command('crypto-fund').description('Top up a wallet with crypto'), [...walletOptions, optionMap.value]).action(async (_commandOptions, command) => {
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -65,11 +47,8 @@ applyOptions(program.command('crypto-fund').description('Top up a wallet with cr
         exitWithErrorLog(error);
     }
 });
-applyOptions(program
-    .command('upload-folder')
-    .description('Upload a folder to a Turbo address')
-    .argument('<folderPath>', 'Directory to upload'), [...walletOptions, optionMap.token]).action((directory, options) => {
-    console.log('upload-folder TODO', directory, options);
+applyOptions(program.command('upload-folder').description('Upload a folder using Turbo'), uploadFolderOptions).action(async (_commandOptions, command) => {
+    await runCommand(command, uploadFolder);
 });
 if (process.argv[1].includes('bin/turbo') || // Running from global .bin
     process.argv[1].includes('cli/cli') // Running from source

package/lib/esm/cli/commands.js

@@ -17,16 +17,8 @@
 import { exec } from 'node:child_process';
 import { TurboFactory, currencyMap, fiatCurrencyTypes, isCurrency, tokenToBaseMap, } from '../node/index.js';
 import { sleep } from '../utils/common.js';
-import { configFromOptions, optionalPrivateKeyFromOptions } from './utils.js';
-export async function addressOrPrivateKeyFromOptions(options) {
-    if (options.address !== undefined) {
-        return { address: options.address, privateKey: undefined };
-    }
-    return {
-        address: undefined,
-        privateKey: await optionalPrivateKeyFromOptions(options),
-    };
-}
+import { version } from '../version.js';
+import { addressOrPrivateKeyFromOptions, configFromOptions, getUploadFolderOptions, privateKeyFromOptions, } from './utils.js';
 export async function getBalance(options) {
     const config = configFromOptions(options);
     const { address, privateKey } = await addressOrPrivateKeyFromOptions(options);
@@ -113,3 +105,27 @@ export function openUrl(url) {
         open(url);
     }
 }
+const turboCliTags = [
+    { name: 'App-Name', value: 'Turbo-CLI' },
+    { name: 'App-Version', value: version },
+    { name: 'App-Platform', value: process.platform },
+];
+export async function uploadFolder(options) {
+    const privateKey = await privateKeyFromOptions(options);
+    const turbo = TurboFactory.authenticated({
+        ...configFromOptions(options),
+        privateKey,
+    });
+    const { disableManifest, fallbackFile, folderPath, indexFile, maxConcurrentUploads, } = getUploadFolderOptions(options);
+    const result = await turbo.uploadFolder({
+        folderPath: folderPath,
+        dataItemOpts: { tags: [...turboCliTags] }, // TODO: Inject user tags
+        manifestOptions: {
+            disableManifest,
+            indexFile,
+            fallbackFile,
+        },
+        maxConcurrentUploads,
+    });
+    console.log('Uploaded folder:', JSON.stringify(result, null, 2));
+}

package/lib/esm/cli/options.js

@@ -0,0 +1,111 @@
+/**
+ * Copyright (C) 2022-2024 Permanent Data Solutions, Inc. All Rights Reserved.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+export const optionMap = {
+    token: {
+        alias: '-t, --token <type>',
+        description: 'Crypto token type for wallet or action',
+        default: 'arweave',
+    },
+    currency: {
+        alias: '-c, --currency <currency>',
+        description: 'Fiat currency type to use for the action',
+        default: 'usd',
+    },
+    address: {
+        alias: '-a, --address <nativeAddress>',
+        description: 'Native address to use for action',
+    },
+    value: {
+        alias: '-v, --value <value>',
+        description: 'Value of fiat currency or crypto token for action. e.g: 10.50 for $10.50 USD or 0.0001 for 0.0001 AR',
+    },
+    walletFile: {
+        alias: '-w, --wallet-file <filePath>',
+        description: 'Wallet file to use with the action. Formats accepted: JWK.json, KYVE or ETH private key as a string, or SOL Secret Key as a Uint8Array',
+    },
+    mnemonic: {
+        alias: '-m, --mnemonic <phrase>',
+        description: 'Mnemonic to use with the action',
+    },
+    privateKey: {
+        alias: '-p, --private-key <key>',
+        description: 'Private key to use with the action',
+    },
+    gateway: {
+        alias: '-g, --gateway <url>',
+        description: 'Set a custom crypto gateway URL',
+        default: undefined,
+    },
+    dev: {
+        alias: '--dev',
+        description: 'Enable development endpoints',
+        default: false,
+    },
+    debug: {
+        // TODO: Implement
+        alias: '--debug',
+        description: 'Enable verbose logging',
+        default: false,
+    },
+    quiet: {
+        // TODO: Implement
+        alias: '--quiet',
+        description: 'Disable logging',
+        default: false,
+    },
+    folderPath: {
+        alias: '-f, --folder-path <folderPath>',
+        description: 'Directory to upload',
+    },
+    indexFile: {
+        alias: '--index-file <indexFile>',
+        description: 'Index file to use in the manifest created for folder upload',
+    },
+    fallbackFile: {
+        alias: '--fallback-file <fallbackFile>',
+        description: 'Fallback file to use in the manifest created for folder upload',
+    },
+    manifest: {
+        alias: '--no-manifest',
+        description: 'Disable manifest creation with --no-manifest',
+        default: false,
+    },
+    maxConcurrency: {
+        alias: '--max-concurrency <maxConcurrency>',
+        description: 'Maximum number of concurrent uploads',
+    },
+};
+export const walletOptions = [
+    optionMap.walletFile,
+    optionMap.mnemonic,
+    optionMap.privateKey,
+];
+export const globalOptions = [
+    optionMap.dev,
+    optionMap.gateway,
+    optionMap.debug,
+    optionMap.quiet,
+    optionMap.token,
+];
+export const uploadFolderOptions = [
+    ...walletOptions,
+    optionMap.folderPath,
+    optionMap.indexFile,
+    optionMap.fallbackFile,
+    optionMap.manifest,
+    optionMap.maxConcurrency,
+];

package/lib/esm/cli/utils.js

@@ -15,75 +15,23 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 import bs58 from 'bs58';
-import { readFileSync } from 'fs';
+import { readFileSync, statSync } from 'fs';
 import { defaultTurboConfiguration, developmentTurboConfiguration, isTokenType, privateKeyFromKyveMnemonic, } from '../node/index.js';
 import { NoWalletProvidedError } from './errors.js';
-export const optionMap = {
-    token: {
-        alias: '-t, --token <type>',
-        description: 'Crypto token type for wallet or action',
-        default: 'arweave',
-    },
-    currency: {
-        alias: '-c, --currency <currency>',
-        description: 'Fiat currency type to use for the action',
-        default: 'usd',
-    },
-    address: {
-        alias: '-a, --address <nativeAddress>',
-        description: 'Native address to use for action',
-    },
-    value: {
-        alias: '-v, --value <value>',
-        description: 'Value of fiat currency or crypto token for action. e.g: 10.50 for $10.50 USD or 0.0001 for 0.0001 AR',
-    },
-    walletFile: {
-        alias: '-w, --wallet-file <filePath>',
-        description: 'Wallet file to use with the action. Formats accepted: JWK.json, KYVE or ETH private key as a string, or SOL Secret Key as a Uint8Array',
-    },
-    mnemonic: {
-        alias: '-m, --mnemonic <phrase>',
-        description: 'Mnemonic to use with the action',
-    },
-    privateKey: {
-        alias: '-p, --private-key <key>',
-        description: 'Private key to use with the action',
-    },
-    gateway: {
-        alias: '-g, --gateway <url>',
-        description: 'Set a custom crypto gateway URL',
-        default: undefined,
-    },
-    dev: {
-        alias: '--dev',
-        description: 'Enable development endpoints',
-        default: false,
-    },
-    debug: {
-        // TODO: Implement
-        alias: '--debug',
-        description: 'Enable verbose logging',
-        default: false,
-    },
-    quiet: {
-        // TODO: Implement
-        alias: '--quiet',
-        description: 'Disable logging',
-        default: false,
-    },
-};
-export const walletOptions = [
-    optionMap.walletFile,
-    optionMap.mnemonic,
-    optionMap.privateKey,
-];
-export const globalOptions = [
-    optionMap.dev,
-    optionMap.gateway,
-    optionMap.debug,
-    optionMap.quiet,
-    optionMap.token,
-];
+export function exitWithErrorLog(error) {
+    console.error(error instanceof Error ? error.message : error);
+    process.exit(1);
+}
+export async function runCommand(command, action) {
+    const options = command.optsWithGlobals();
+    try {
+        await action(options);
+        process.exit(0);
+    }
+    catch (error) {
+        exitWithErrorLog(error);
+    }
+}
 export function applyOptions(command, options) {
     [...options].forEach((option) => {
         command.option(option.alias, option.description, option.default);
@@ -107,6 +55,27 @@ export function valueFromOptions(options) {
     }
     return value;
 }
+export function getFolderPathFromOptions(options) {
+    const folderPath = options.folderPath;
+    if (folderPath === undefined) {
+        throw new Error('Folder path is required. Use --folderPath <path>');
+    }
+    // Check if path exists and is a directory
+    const stats = statSync(folderPath);
+    if (!stats.isDirectory()) {
+        throw new Error('Folder path is not a directory');
+    }
+    return folderPath;
+}
+export async function addressOrPrivateKeyFromOptions(options) {
+    if (options.address !== undefined) {
+        return { address: options.address, privateKey: undefined };
+    }
+    return {
+        address: undefined,
+        privateKey: await optionalPrivateKeyFromOptions(options),
+    };
+}
 export async function optionalPrivateKeyFromOptions(options) {
     try {
         const key = await privateKeyFromOptions(options);
@@ -145,6 +114,7 @@ const tokenToDevGatewayMap = {
     solana: 'https://api.devnet.solana.com',
     ethereum: 'https://ethereum-holesky-rpc.publicnode.com',
     kyve: 'https://api.korellia.kyve.network',
+    // matic: 'https://rpc-amoy.polygon.technology',
 };
 export function configFromOptions({ gateway, dev, token, }) {
     let config = {};
@@ -162,3 +132,12 @@ export function configFromOptions({ gateway, dev, token, }) {
     config.token = token;
     return config;
 }
+export function getUploadFolderOptions(options) {
+    return {
+        folderPath: options.folderPath,
+        indexFile: options.indexFile,
+        fallbackFile: options.fallbackFile,
+        disableManifest: !options.manifest,
+        maxConcurrentUploads: +(options.maxConcurrency ?? 1),
+    };
+}

package/lib/esm/node/upload.js

@@ -29,6 +29,9 @@ export class TurboAuthenticatedUploadService extends TurboAuthenticatedBaseUploa
         // Walk the directory and add all file paths to the array
         const files = await promises.readdir(folderPath);
         for (const file of files) {
+            if (file === '.DS_Store') {
+                continue;
+            }
             const absoluteFilePath = join(folderPath, file);
             const stat = await promises.stat(absoluteFilePath);
             if (stat.isDirectory()) {

package/lib/esm/version.js

@@ -15,4 +15,4 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 // AUTOMATICALLY GENERATED FILE - DO NOT TOUCH
-export const version = '1.13.0';
+export const version = '1.14.0-alpha.1';

package/lib/types/cli/commands.d.ts

@@ -1,9 +1,5 @@
 import { TokenType, TurboUnauthenticatedConfiguration, TurboWallet } from '../node/index.js';
-import { AddressOptions, TopUpOptions } from './types.js';
-export declare function addressOrPrivateKeyFromOptions(options: AddressOptions): Promise<{
-    address: string | undefined;
-    privateKey: string | undefined;
-}>;
+import { AddressOptions, TopUpOptions, UploadFolderOptions } from './types.js';
 export declare function getBalance(options: AddressOptions): Promise<void>;
 export interface CryptoFundParams {
     token: TokenType;
@@ -15,4 +11,5 @@ export interface CryptoFundParams {
 export declare function cryptoFund({ value, privateKey, token, config, }: CryptoFundParams): Promise<void>;
 export declare function topUp(options: TopUpOptions): Promise<void>;
 export declare function openUrl(url: string): void;
+export declare function uploadFolder(options: UploadFolderOptions): Promise<void>;
 //# sourceMappingURL=commands.d.ts.map

package/lib/types/cli/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../src/cli/commands.ts"],"names":[],"mappings":"AAkBA,OAAO,EACL,SAAS,EAET,iCAAiC,EACjC,WAAW,EAKZ,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1D,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC;IACT,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC,CAAC,CASD;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE,cAAc,iBAgCvD;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,WAAW,CAAC;IACxB,MAAM,EAAE,iCAAiC,CAAC;CAC3C;AACD,4CAA4C;AAC5C,wBAAsB,UAAU,CAAC,EAC/B,KAAK,EACL,UAAU,EACV,KAAK,EACL,MAAM,GACP,EAAE,gBAAgB,iBAelB;AAED,wBAAsB,KAAK,CAAC,OAAO,EAAE,YAAY,iBA4DhD;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,QAWlC"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../src/cli/commands.ts"],"names":[],"mappings":"AAkBA,OAAO,EACL,SAAS,EAET,iCAAiC,EACjC,WAAW,EAKZ,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAQ/E,wBAAsB,UAAU,CAAC,OAAO,EAAE,cAAc,iBAgCvD;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,WAAW,CAAC;IACxB,MAAM,EAAE,iCAAiC,CAAC;CAC3C;AACD,4CAA4C;AAC5C,wBAAsB,UAAU,CAAC,EAC/B,KAAK,EACL,UAAU,EACV,KAAK,EACL,MAAM,GACP,EAAE,gBAAgB,iBAelB;AAED,wBAAsB,KAAK,CAAC,OAAO,EAAE,YAAY,iBA4DhD;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,QAWlC;AAQD,wBAAsB,YAAY,CAChC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CA4Bf"}

package/lib/types/cli/options.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Copyright (C) 2022-2024 Permanent Data Solutions, Inc. All Rights Reserved.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+export declare const optionMap: {
+    readonly token: {
+        readonly alias: "-t, --token <type>";
+        readonly description: "Crypto token type for wallet or action";
+        readonly default: "arweave";
+    };
+    readonly currency: {
+        readonly alias: "-c, --currency <currency>";
+        readonly description: "Fiat currency type to use for the action";
+        readonly default: "usd";
+    };
+    readonly address: {
+        readonly alias: "-a, --address <nativeAddress>";
+        readonly description: "Native address to use for action";
+    };
+    readonly value: {
+        readonly alias: "-v, --value <value>";
+        readonly description: "Value of fiat currency or crypto token for action. e.g: 10.50 for $10.50 USD or 0.0001 for 0.0001 AR";
+    };
+    readonly walletFile: {
+        readonly alias: "-w, --wallet-file <filePath>";
+        readonly description: "Wallet file to use with the action. Formats accepted: JWK.json, KYVE or ETH private key as a string, or SOL Secret Key as a Uint8Array";
+    };
+    readonly mnemonic: {
+        readonly alias: "-m, --mnemonic <phrase>";
+        readonly description: "Mnemonic to use with the action";
+    };
+    readonly privateKey: {
+        readonly alias: "-p, --private-key <key>";
+        readonly description: "Private key to use with the action";
+    };
+    readonly gateway: {
+        readonly alias: "-g, --gateway <url>";
+        readonly description: "Set a custom crypto gateway URL";
+        readonly default: undefined;
+    };
+    readonly dev: {
+        readonly alias: "--dev";
+        readonly description: "Enable development endpoints";
+        readonly default: false;
+    };
+    readonly debug: {
+        readonly alias: "--debug";
+        readonly description: "Enable verbose logging";
+        readonly default: false;
+    };
+    readonly quiet: {
+        readonly alias: "--quiet";
+        readonly description: "Disable logging";
+        readonly default: false;
+    };
+    readonly folderPath: {
+        readonly alias: "-f, --folder-path <folderPath>";
+        readonly description: "Directory to upload";
+    };
+    readonly indexFile: {
+        readonly alias: "--index-file <indexFile>";
+        readonly description: "Index file to use in the manifest created for folder upload";
+    };
+    readonly fallbackFile: {
+        readonly alias: "--fallback-file <fallbackFile>";
+        readonly description: "Fallback file to use in the manifest created for folder upload";
+    };
+    readonly manifest: {
+        readonly alias: "--no-manifest";
+        readonly description: "Disable manifest creation with --no-manifest";
+        readonly default: false;
+    };
+    readonly maxConcurrency: {
+        readonly alias: "--max-concurrency <maxConcurrency>";
+        readonly description: "Maximum number of concurrent uploads";
+    };
+};
+export declare const walletOptions: ({
+    readonly alias: "-w, --wallet-file <filePath>";
+    readonly description: "Wallet file to use with the action. Formats accepted: JWK.json, KYVE or ETH private key as a string, or SOL Secret Key as a Uint8Array";
+} | {
+    readonly alias: "-m, --mnemonic <phrase>";
+    readonly description: "Mnemonic to use with the action";
+} | {
+    readonly alias: "-p, --private-key <key>";
+    readonly description: "Private key to use with the action";
+})[];
+export declare const globalOptions: ({
+    readonly alias: "-t, --token <type>";
+    readonly description: "Crypto token type for wallet or action";
+    readonly default: "arweave";
+} | {
+    readonly alias: "-g, --gateway <url>";
+    readonly description: "Set a custom crypto gateway URL";
+    readonly default: undefined;
+} | {
+    readonly alias: "--dev";
+    readonly description: "Enable development endpoints";
+    readonly default: false;
+} | {
+    readonly alias: "--debug";
+    readonly description: "Enable verbose logging";
+    readonly default: false;
+} | {
+    readonly alias: "--quiet";
+    readonly description: "Disable logging";
+    readonly default: false;
+})[];
+export declare const uploadFolderOptions: ({
+    readonly alias: "-w, --wallet-file <filePath>";
+    readonly description: "Wallet file to use with the action. Formats accepted: JWK.json, KYVE or ETH private key as a string, or SOL Secret Key as a Uint8Array";
+} | {
+    readonly alias: "-m, --mnemonic <phrase>";
+    readonly description: "Mnemonic to use with the action";
+} | {
+    readonly alias: "-p, --private-key <key>";
+    readonly description: "Private key to use with the action";
+} | {
+    readonly alias: "-f, --folder-path <folderPath>";
+    readonly description: "Directory to upload";
+} | {
+    readonly alias: "--index-file <indexFile>";
+    readonly description: "Index file to use in the manifest created for folder upload";
+} | {
+    readonly alias: "--fallback-file <fallbackFile>";
+    readonly description: "Fallback file to use in the manifest created for folder upload";
+} | {
+    readonly alias: "--no-manifest";
+    readonly description: "Disable manifest creation with --no-manifest";
+    readonly default: false;
+} | {
+    readonly alias: "--max-concurrency <maxConcurrency>";
+    readonly description: "Maximum number of concurrent uploads";
+})[];
+//# sourceMappingURL=options.d.ts.map

package/lib/types/cli/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../src/cli/options.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8EZ,CAAC;AAEX,eAAO,MAAM,aAAa;;;;;;;;;IAIzB,CAAC;AAEF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;IAMzB,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;IAO/B,CAAC"}

package/lib/types/cli/types.d.ts

@@ -34,4 +34,11 @@ export type TopUpOptions = AddressOptions & {
     value: string | undefined;
     currency: string | undefined;
 };
+export type UploadFolderOptions = WalletOptions & {
+    folderPath: string;
+    indexFile: string | undefined;
+    fallbackFile: string | undefined;
+    manifest: boolean;
+    maxConcurrency: number | undefined;
+};
 //# sourceMappingURL=types.d.ts.map

package/lib/types/cli/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/cli/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,SAAS,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG;IAC1C,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG;IAC3C,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,cAAc,GAAG;IAC1C,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/cli/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,SAAS,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG;IAC1C,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG;IAC3C,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,cAAc,GAAG;IAC1C,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,aAAa,GAAG;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC,CAAC"}

package/lib/types/cli/utils.d.ts

@@ -1,99 +1,30 @@
-import { Command } from 'commander';
+import { Command, OptionValues } from 'commander';
 import { TokenType, TurboUnauthenticatedConfiguration } from '../node/index.js';
-import { GlobalOptions, WalletOptions } from './types.js';
+import { AddressOptions, GlobalOptions, UploadFolderOptions, WalletOptions } from './types.js';
+export declare function exitWithErrorLog(error: unknown): void;
+export declare function runCommand<O extends OptionValues>(command: Command, action: (options: O) => Promise<void>): Promise<void>;
 interface CommanderOption {
     alias: string;
     description: string;
     default?: string | boolean;
 }
-export declare const optionMap: {
-    readonly token: {
-        readonly alias: "-t, --token <type>";
-        readonly description: "Crypto token type for wallet or action";
-        readonly default: "arweave";
-    };
-    readonly currency: {
-        readonly alias: "-c, --currency <currency>";
-        readonly description: "Fiat currency type to use for the action";
-        readonly default: "usd";
-    };
-    readonly address: {
-        readonly alias: "-a, --address <nativeAddress>";
-        readonly description: "Native address to use for action";
-    };
-    readonly value: {
-        readonly alias: "-v, --value <value>";
-        readonly description: "Value of fiat currency or crypto token for action. e.g: 10.50 for $10.50 USD or 0.0001 for 0.0001 AR";
-    };
-    readonly walletFile: {
-        readonly alias: "-w, --wallet-file <filePath>";
-        readonly description: "Wallet file to use with the action. Formats accepted: JWK.json, KYVE or ETH private key as a string, or SOL Secret Key as a Uint8Array";
-    };
-    readonly mnemonic: {
-        readonly alias: "-m, --mnemonic <phrase>";
-        readonly description: "Mnemonic to use with the action";
-    };
-    readonly privateKey: {
-        readonly alias: "-p, --private-key <key>";
-        readonly description: "Private key to use with the action";
-    };
-    readonly gateway: {
-        readonly alias: "-g, --gateway <url>";
-        readonly description: "Set a custom crypto gateway URL";
-        readonly default: undefined;
-    };
-    readonly dev: {
-        readonly alias: "--dev";
-        readonly description: "Enable development endpoints";
-        readonly default: false;
-    };
-    readonly debug: {
-        readonly alias: "--debug";
-        readonly description: "Enable verbose logging";
-        readonly default: false;
-    };
-    readonly quiet: {
-        readonly alias: "--quiet";
-        readonly description: "Disable logging";
-        readonly default: false;
-    };
-};
-export declare const walletOptions: ({
-    readonly alias: "-w, --wallet-file <filePath>";
-    readonly description: "Wallet file to use with the action. Formats accepted: JWK.json, KYVE or ETH private key as a string, or SOL Secret Key as a Uint8Array";
-} | {
-    readonly alias: "-m, --mnemonic <phrase>";
-    readonly description: "Mnemonic to use with the action";
-} | {
-    readonly alias: "-p, --private-key <key>";
-    readonly description: "Private key to use with the action";
-})[];
-export declare const globalOptions: ({
-    readonly alias: "-t, --token <type>";
-    readonly description: "Crypto token type for wallet or action";
-    readonly default: "arweave";
-} | {
-    readonly alias: "-g, --gateway <url>";
-    readonly description: "Set a custom crypto gateway URL";
-    readonly default: undefined;
-} | {
-    readonly alias: "--dev";
-    readonly description: "Enable development endpoints";
-    readonly default: false;
-} | {
-    readonly alias: "--debug";
-    readonly description: "Enable verbose logging";
-    readonly default: false;
-} | {
-    readonly alias: "--quiet";
-    readonly description: "Disable logging";
-    readonly default: false;
-})[];
 export declare function applyOptions(command: Command, options: CommanderOption[]): Command;
 export declare function tokenFromOptions(options: unknown): TokenType;
 export declare function valueFromOptions(options: unknown): string;
+export declare function getFolderPathFromOptions(options: unknown): string;
+export declare function addressOrPrivateKeyFromOptions(options: AddressOptions): Promise<{
+    address: string | undefined;
+    privateKey: string | undefined;
+}>;
 export declare function optionalPrivateKeyFromOptions(options: WalletOptions): Promise<string | undefined>;
 export declare function privateKeyFromOptions({ mnemonic, privateKey, walletFile, token, }: WalletOptions): Promise<string>;
 export declare function configFromOptions({ gateway, dev, token, }: GlobalOptions): TurboUnauthenticatedConfiguration;
+export declare function getUploadFolderOptions(options: UploadFolderOptions): {
+    folderPath: string;
+    indexFile: string | undefined;
+    fallbackFile: string | undefined;
+    disableManifest: boolean;
+    maxConcurrentUploads: number;
+};
 export {};
 //# sourceMappingURL=utils.d.ts.map

package/lib/types/cli/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/cli/utils.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EACL,SAAS,EACT,iCAAiC,EAKlC,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE1D,UAAU,eAAe;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAC5B;AAED,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwDZ,CAAC;AAEX,eAAO,MAAM,aAAa;;;;;;;;;IAIzB,CAAC;AAEF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;IAMzB,CAAC;AAEF,wBAAgB,YAAY,CAC1B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,eAAe,EAAE,GACzB,OAAO,CAKT;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAU5D;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAMzD;AAED,wBAAsB,6BAA6B,CAAC,OAAO,EAAE,aAAa,+BAUzE;AAED,wBAAsB,qBAAqB,CAAC,EAC1C,QAAQ,EACR,UAAU,EACV,UAAU,EACV,KAAK,GACN,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAqBjC;AASD,wBAAgB,iBAAiB,CAAC,EAChC,OAAO,EACP,GAAG,EACH,KAAK,GACN,EAAE,aAAa,GAAG,iCAAiC,CAkBnD"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/cli/utils.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAGlD,OAAO,EACL,SAAS,EACT,iCAAiC,EAKlC,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,QAG9C;AAED,wBAAsB,UAAU,CAAC,CAAC,SAAS,YAAY,EACrD,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,iBAUtC;AAED,UAAU,eAAe;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAC5B;AAED,wBAAgB,YAAY,CAC1B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,eAAe,EAAE,GACzB,OAAO,CAKT;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAU5D;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAMzD;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAajE;AAED,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC;IACT,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC,CAAC,CASD;AAED,wBAAsB,6BAA6B,CAAC,OAAO,EAAE,aAAa,+BAUzE;AAED,wBAAsB,qBAAqB,CAAC,EAC1C,QAAQ,EACR,UAAU,EACV,UAAU,EACV,KAAK,GACN,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAqBjC;AAUD,wBAAgB,iBAAiB,CAAC,EAChC,OAAO,EACP,GAAG,EACH,KAAK,GACN,EAAE,aAAa,GAAG,iCAAiC,CAkBnD;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,mBAAmB,GAAG;IACpE,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,eAAe,EAAE,OAAO,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;CAC9B,CAQA"}

package/lib/types/node/upload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../../src/node/upload.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC,OAAO,EACL,mCAAmC,EAEpC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAEL,4CAA4C,EAC5C,uBAAuB,EAExB,MAAM,aAAa,CAAC;AAErB,qBAAa,+BAAgC,SAAQ,mCAAmC;gBAC1E,EACV,GAA6B,EAC7B,WAAW,EACX,MAAM,EACN,MAAM,EACN,KAAK,GACN,EAAE,4CAA4C;YAIjC,8BAA8B;IAqB5C,QAAQ,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAO5D,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;IAI5C,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIjC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIjC,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,uBAAuB,GAAG,MAAM;IAOtE,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAKzC,oBAAoB,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ;CAGvD"}
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../../src/node/upload.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC,OAAO,EACL,mCAAmC,EAEpC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAEL,4CAA4C,EAC5C,uBAAuB,EAExB,MAAM,aAAa,CAAC;AAErB,qBAAa,+BAAgC,SAAQ,mCAAmC;gBAC1E,EACV,GAA6B,EAC7B,WAAW,EACX,MAAM,EACN,MAAM,EACN,KAAK,GACN,EAAE,4CAA4C;YAIjC,8BAA8B;IAyB5C,QAAQ,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAO5D,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;IAI5C,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIjC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIjC,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,uBAAuB,GAAG,MAAM;IAOtE,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAKzC,oBAAoB,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ;CAGvD"}

package/lib/types/version.d.ts

@@ -14,5 +14,5 @@
  * You should have received a copy of the GNU Affero General Public License
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
-export declare const version = "1.13.0-alpha.2";
+export declare const version = "1.13.0";
 //# sourceMappingURL=version.d.ts.map

package/lib/types/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,eAAO,MAAM,OAAO,mBAAmB,CAAC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,eAAO,MAAM,OAAO,WAAW,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ardrive/turbo-sdk",
-  "version": "1.13.0",
+  "version": "1.14.0-alpha.1",
   "main": "./lib/cjs/node/index.js",
   "types": "./lib/types/node/index.d.ts",
   "module": "./lib/esm/node/index.js",