@ardrive/turbo-sdk 1.0.0-beta.1 → 1.0.0-beta.3

package/lib/cjs/common/payment.js

@@ -1,30 +1,32 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TurboAuthenticatedPaymentService = exports.TurboUnauthenticatedPaymentService = void 0;
+exports.TurboAuthenticatedPaymentService = exports.TurboUnauthenticatedPaymentService = exports.defaultPaymentServiceURL = exports.developmentPaymentServiceURL = void 0;
 const http_js_1 = require("./http.js");
+exports.developmentPaymentServiceURL = 'https://payment.ardrive.dev';
+exports.defaultPaymentServiceURL = 'https://payment.ardrive.io';
 class TurboUnauthenticatedPaymentService {
-    constructor({ url = 'https://payment.ardrive.dev', retryConfig, }) {
+    constructor({ url = exports.defaultPaymentServiceURL, retryConfig, }) {
         this.httpService = new http_js_1.TurboHTTPService({
             url: `${url}/v1`,
             retryConfig,
         });
     }
-    async getFiatRates() {
+    getFiatRates() {
         return this.httpService.get({
             endpoint: '/rates',
         });
     }
-    async getFiatToAR({ currency, }) {
+    getFiatToAR({ currency, }) {
         return this.httpService.get({
             endpoint: `/rates/${currency}`,
         });
     }
-    async getSupportedCountries() {
+    getSupportedCountries() {
         return this.httpService.get({
             endpoint: '/countries',
         });
     }
-    async getSupportedCurrencies() {
+    getSupportedCurrencies() {
         return this.httpService.get({
             endpoint: '/currencies',
         });
@@ -36,16 +38,39 @@ class TurboUnauthenticatedPaymentService {
         const wincCostsForBytes = await Promise.all(fetchPricePromises);
         return wincCostsForBytes;
     }
-    async getWincForFiat({ amount, currency }) {
+    getWincForFiat({ amount, }) {
+        const { amount: paymentAmount, type: currencyType } = amount;
         return this.httpService.get({
-            endpoint: `/price/${currency}/${amount}`,
+            endpoint: `/price/${currencyType}/${paymentAmount}`,
         });
     }
+    appendPromoCodesToQuery(promoCodes) {
+        const promoCodesQuery = promoCodes.join(',');
+        return promoCodesQuery ? `?promoCode=${promoCodesQuery}` : '';
+    }
+    async getCheckout({ amount, owner, promoCodes = [] }, headers) {
+        const { amount: paymentAmount, type: currencyType } = amount;
+        const endpoint = `/top-up/checkout-session/${owner}/${currencyType}/${paymentAmount}${this.appendPromoCodesToQuery(promoCodes)}`;
+        const { adjustments, paymentSession, topUpQuote } = await this.httpService.get({
+            endpoint,
+            headers,
+        });
+        return {
+            winc: topUpQuote.winstonCreditAmount,
+            adjustments,
+            url: paymentSession.url,
+            paymentAmount: topUpQuote.paymentAmount,
+            quotedPaymentAmount: topUpQuote.quotedPaymentAmount,
+        };
+    }
+    createCheckoutSession(params) {
+        return this.getCheckout(params);
+    }
 }
 exports.TurboUnauthenticatedPaymentService = TurboUnauthenticatedPaymentService;
 // NOTE: to avoid redundancy, we use inheritance here - but generally prefer composition over inheritance
 class TurboAuthenticatedPaymentService extends TurboUnauthenticatedPaymentService {
-    constructor({ url = 'https://payment.ardrive.dev', retryConfig, signer, }) {
+    constructor({ url = exports.defaultPaymentServiceURL, retryConfig, signer, }) {
         super({ url, retryConfig });
         this.signer = signer;
     }
@@ -59,5 +84,14 @@ class TurboAuthenticatedPaymentService extends TurboUnauthenticatedPaymentServic
         // 404's don't return a balance, so default to 0
         return balance.winc ? balance : { winc: '0' };
     }
+    async getWincForFiat({ amount, promoCodes = [], }) {
+        return this.httpService.get({
+            endpoint: `/price/${amount.type}/${amount.amount}${this.appendPromoCodesToQuery(promoCodes)}`,
+            headers: await this.signer.generateSignedRequestHeaders(),
+        });
+    }
+    async createCheckoutSession(params) {
+        return this.getCheckout(params, await this.signer.generateSignedRequestHeaders());
+    }
 }
 exports.TurboAuthenticatedPaymentService = TurboAuthenticatedPaymentService;

package/lib/cjs/common/turbo.js

@@ -1,8 +1,30 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TurboAuthenticatedClient = exports.TurboUnauthenticatedClient = void 0;
+exports.TurboAuthenticatedClient = exports.TurboUnauthenticatedClient = exports.defaultTurboConfiguration = exports.developmentTurboConfiguration = void 0;
 const payment_js_1 = require("./payment.js");
 const upload_js_1 = require("./upload.js");
+/**
+ * Testing configuration.
+ */
+exports.developmentTurboConfiguration = {
+    paymentServiceConfig: {
+        url: payment_js_1.developmentPaymentServiceURL,
+    },
+    uploadServiceConfig: {
+        url: upload_js_1.developmentUploadServiceURL,
+    },
+};
+/**
+ * Production configuration.
+ */
+exports.defaultTurboConfiguration = {
+    paymentServiceConfig: {
+        url: payment_js_1.defaultPaymentServiceURL,
+    },
+    uploadServiceConfig: {
+        url: upload_js_1.defaultUploadServiceURL,
+    },
+};
 class TurboUnauthenticatedClient {
     constructor({ uploadService = new upload_js_1.TurboUnauthenticatedUploadService({}), paymentService = new payment_js_1.TurboUnauthenticatedPaymentService({}), }) {
         this.paymentService = paymentService;
@@ -11,7 +33,7 @@ class TurboUnauthenticatedClient {
     /**
      * Returns the supported fiat currency conversion rate for 1AR based on current market prices.
      */
-    async getFiatToAR({ currency, }) {
+    getFiatToAR({ currency, }) {
         return this.paymentService.getFiatToAR({ currency });
     }
     /**
@@ -20,42 +42,49 @@ class TurboUnauthenticatedClient {
      * Note: this does not take into account varying adjustments and promotions for different sizes of data. If you want to calculate the total
      * cost in 'winc' for a given number of bytes, use getUploadCosts.
      */
-    async getFiatRates() {
+    getFiatRates() {
         return this.paymentService.getFiatRates();
     }
     /**
      * Returns a comprehensive list of supported countries that can purchase credits through the Turbo Payment Service.
      */
-    async getSupportedCountries() {
+    getSupportedCountries() {
         return this.paymentService.getSupportedCountries();
     }
     /**
      * Returns a list of all supported fiat currencies.
      */
-    async getSupportedCurrencies() {
+    getSupportedCurrencies() {
         return this.paymentService.getSupportedCurrencies();
     }
     /**
      * Determines the price in 'winc' to upload one data item of a specific size in bytes, including all Turbo cost adjustments and fees.
      */
-    async getUploadCosts({ bytes, }) {
+    getUploadCosts({ bytes, }) {
         return this.paymentService.getUploadCosts({ bytes });
     }
     /**
      * Determines the amount of 'winc' that would be returned for a given currency and amount, including all Turbo cost adjustments and fees.
      */
-    async getWincForFiat({ amount, currency, }) {
-        return this.paymentService.getWincForFiat({ amount, currency });
+    getWincForFiat(params) {
+        return this.paymentService.getWincForFiat(params);
     }
     /**
      * Uploads a signed data item to the Turbo Upload Service.
      */
-    async uploadSignedDataItem({ dataItemStreamFactory, signal, }) {
+    uploadSignedDataItem({ dataItemStreamFactory, dataItemSizeFactory, signal, }) {
         return this.uploadService.uploadSignedDataItem({
             dataItemStreamFactory,
+            dataItemSizeFactory,
             signal,
         });
     }
+    /**
+     * Creates a Turbo Checkout Session for a given amount and currency.
+     */
+    createCheckoutSession(params) {
+        return this.paymentService.createCheckoutSession(params);
+    }
 }
 exports.TurboUnauthenticatedClient = TurboUnauthenticatedClient;
 class TurboAuthenticatedClient extends TurboUnauthenticatedClient {
@@ -65,14 +94,18 @@ class TurboAuthenticatedClient extends TurboUnauthenticatedClient {
     /**
      * Returns the current balance of the user's wallet in 'winc'.
      */
-    async getBalance() {
+    getBalance() {
         return this.paymentService.getBalance();
     }
     /**
      * Signs and uploads raw data to the Turbo Upload Service.
      */
-    async uploadFile({ fileStreamFactory, signal, }) {
-        return this.uploadService.uploadFile({ fileStreamFactory, signal });
+    uploadFile({ fileStreamFactory, fileSizeFactory, signal, }) {
+        return this.uploadService.uploadFile({
+            fileStreamFactory,
+            fileSizeFactory,
+            signal,
+        });
     }
 }
 exports.TurboAuthenticatedClient = TurboAuthenticatedClient;

package/lib/cjs/common/upload.js

@@ -1,15 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TurboAuthenticatedUploadService = exports.TurboUnauthenticatedUploadService = void 0;
+exports.TurboAuthenticatedUploadService = exports.TurboUnauthenticatedUploadService = exports.developmentUploadServiceURL = exports.defaultUploadServiceURL = void 0;
 const http_js_1 = require("./http.js");
+exports.defaultUploadServiceURL = 'https://upload.ardrive.io';
+exports.developmentUploadServiceURL = 'https://upload.ardrive.dev';
 class TurboUnauthenticatedUploadService {
-    constructor({ url = 'https://upload.ardrive.dev', retryConfig, }) {
+    constructor({ url = exports.defaultUploadServiceURL, retryConfig, }) {
         this.httpService = new http_js_1.TurboHTTPService({
             url: `${url}/v1`,
             retryConfig,
         });
     }
-    async uploadSignedDataItem({ dataItemStreamFactory, signal, }) {
+    async uploadSignedDataItem({ dataItemStreamFactory, dataItemSizeFactory, signal, }) {
+        const fileSize = dataItemSizeFactory();
         // TODO: add p-limit constraint or replace with separate upload class
         return this.httpService.post({
             endpoint: `/tx`,
@@ -17,6 +20,7 @@ class TurboUnauthenticatedUploadService {
             data: dataItemStreamFactory(),
             headers: {
                 'content-type': 'application/octet-stream',
+                'content-length': `${fileSize}`,
             },
         });
     }
@@ -28,10 +32,13 @@ class TurboAuthenticatedUploadService extends TurboUnauthenticatedUploadService
         super({ url, retryConfig });
         this.signer = signer;
     }
-    async uploadFile({ fileStreamFactory, signal, }) {
-        const signedDataItem = await this.signer.signDataItem({
+    async uploadFile({ fileStreamFactory, fileSizeFactory, signal, }) {
+        const { dataItemStreamFactory, dataItemSizeFactory } = await this.signer.signDataItem({
             fileStreamFactory,
+            fileSizeFactory,
         });
+        const signedDataItem = dataItemStreamFactory();
+        const fileSize = dataItemSizeFactory();
         // TODO: add p-limit constraint or replace with separate upload class
         return this.httpService.post({
             endpoint: `/tx`,
@@ -39,6 +46,7 @@ class TurboAuthenticatedUploadService extends TurboUnauthenticatedUploadService
             data: signedDataItem,
             headers: {
                 'content-type': 'application/octet-stream',
+                'content-length': `${fileSize}`,
             },
         });
     }

package/lib/cjs/node/signer.js

@@ -30,10 +30,18 @@ class TurboNodeArweaveSigner {
         this.privateKey = privateKey;
         this.signer = new arbundles_1.ArweaveSigner(this.privateKey);
     }
-    signDataItem({ fileStreamFactory, }) {
+    async signDataItem({ fileStreamFactory, fileSizeFactory, }) {
         // TODO: replace with our own signer implementation
         const [stream1, stream2] = [fileStreamFactory(), fileStreamFactory()];
-        return (0, arbundles_1.streamSigner)(stream1, stream2, this.signer);
+        const signedDataItem = await (0, arbundles_1.streamSigner)(stream1, stream2, this.signer);
+        // TODO: support target, anchor, and tags
+        const signedDataItemSize = this.calculateSignedDataHeadersSize({
+            dataSize: fileSizeFactory(),
+        });
+        return {
+            dataItemStreamFactory: () => signedDataItem,
+            dataItemSizeFactory: () => signedDataItemSize,
+        };
     }
     // NOTE: this might be better in a parent class or elsewhere - easy enough to leave in here now and does require specific environment version of crypto
     async generateSignedRequestHeaders() {
@@ -46,5 +54,28 @@ class TurboNodeArweaveSigner {
             'x-signature': (0, base64_js_1.toB64Url)(Buffer.from(signature)),
         };
     }
+    // TODO: make dynamic that accepts anchor and target and tags to return the size of the headers + data
+    // reference https://github.com/ArweaveTeam/arweave-standards/blob/master/ans/ANS-104.md#13-dataitem-format
+    calculateSignedDataHeadersSize({ dataSize }) {
+        const anchor = 1; // + whatever they provide (max of 33)
+        const target = 1; // + whatever they provide (max of 33)
+        const tags = 0;
+        const signatureLength = 512;
+        const ownerLength = 512;
+        const signatureTypeLength = 2;
+        const numOfTagsLength = 8; // https://github.com/Bundlr-Network/arbundles/blob/master/src/tags.ts#L191-L198
+        const numOfTagsBytesLength = 8;
+        return [
+            anchor,
+            target,
+            tags,
+            signatureLength,
+            ownerLength,
+            signatureTypeLength,
+            numOfTagsLength,
+            numOfTagsBytesLength,
+            dataSize,
+        ].reduce((totalSize, currentSize) => (totalSize += currentSize));
+    }
 }
 exports.TurboNodeArweaveSigner = TurboNodeArweaveSigner;

package/lib/cjs/utils/readableStream.js

@@ -1,17 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.readableStreamToBuffer = void 0;
-async function readableStreamToBuffer({ stream, }) {
+async function readableStreamToBuffer({ stream, size, }) {
     const reader = stream.getReader();
-    const chunks = [];
+    const buffer = Buffer.alloc(size);
+    let offset = 0;
     let done = false;
     while (!done) {
         const { done: streamDone, value } = await reader.read();
         done = streamDone;
         if (!done) {
-            chunks.push(value);
+            buffer.set(value, offset);
+            offset += value.byteLength;
         }
     }
-    return Buffer.concat(chunks);
+    return buffer;
 }
 exports.readableStreamToBuffer = readableStreamToBuffer;

package/lib/cjs/web/signer.js

@@ -30,15 +30,20 @@ class TurboWebArweaveSigner {
         this.privateKey = privateKey;
         this.signer = new arbundles_1.ArweaveSigner(this.privateKey);
     }
-    async signDataItem({ fileStreamFactory, }) {
+    async signDataItem({ fileStreamFactory, fileSizeFactory, }) {
         // TODO: converts the readable stream to a buffer bc incrementally signing ReadableStreams is not trivial
         const buffer = await (0, readableStream_js_1.readableStreamToBuffer)({
             stream: fileStreamFactory(),
-            // TODO: add payload size to get performance improvements
+            size: fileSizeFactory(),
         });
-        const signedDataItem = (0, arbundles_1.createData)(buffer, this.signer);
+        // TODO: support target, anchor and tags for upload
+        const signedDataItem = (0, arbundles_1.createData)(buffer, this.signer, {});
         await signedDataItem.sign(this.signer);
-        return signedDataItem.getRaw();
+        return {
+            // while this returns a Buffer - it needs to match our return type for uploading
+            dataItemStreamFactory: () => signedDataItem.getRaw(),
+            dataItemSizeFactory: () => signedDataItem.getRaw().length,
+        };
     }
     // NOTE: this might be better in a parent class or elsewhere - easy enough to leave in here now and does require specific environment version of crypto
     async generateSignedRequestHeaders() {

package/lib/esm/common/currency.js

@@ -0,0 +1,27 @@
+export class ZeroDecimalCurrency {
+    constructor(amount, type) {
+        this.amount = amount;
+        this.type = type;
+    }
+}
+export class TwoDecimalCurrency {
+    constructor(a, type) {
+        this.a = a;
+        this.type = type;
+    }
+    get amount() {
+        return this.a * 100;
+    }
+}
+// Two decimal currencies that are supported by the Turbo API
+export const USD = (usd) => new TwoDecimalCurrency(usd, 'usd');
+export const EUR = (eur) => new TwoDecimalCurrency(eur, 'eur');
+export const GBP = (gbp) => new TwoDecimalCurrency(gbp, 'gbp');
+export const CAD = (cad) => new TwoDecimalCurrency(cad, 'cad');
+export const AUD = (aud) => new TwoDecimalCurrency(aud, 'aud');
+export const INR = (inr) => new TwoDecimalCurrency(inr, 'inr');
+export const SGD = (sgd) => new TwoDecimalCurrency(sgd, 'sgd');
+export const HKD = (hkd) => new TwoDecimalCurrency(hkd, 'hkd');
+export const BRL = (brl) => new TwoDecimalCurrency(brl, 'brl');
+// Zero decimal currencies that are supported by the Turbo API
+export const JPY = (jpy) => new ZeroDecimalCurrency(jpy, 'jpy');

package/lib/esm/common/index.js

@@ -17,3 +17,4 @@
 export * from './upload.js';
 export * from './payment.js';
 export * from './turbo.js';
+export * from './currency.js';

package/lib/esm/common/payment.js

@@ -1,27 +1,29 @@
 import { TurboHTTPService } from './http.js';
+export const developmentPaymentServiceURL = 'https://payment.ardrive.dev';
+export const defaultPaymentServiceURL = 'https://payment.ardrive.io';
 export class TurboUnauthenticatedPaymentService {
-    constructor({ url = 'https://payment.ardrive.dev', retryConfig, }) {
+    constructor({ url = defaultPaymentServiceURL, retryConfig, }) {
         this.httpService = new TurboHTTPService({
             url: `${url}/v1`,
             retryConfig,
         });
     }
-    async getFiatRates() {
+    getFiatRates() {
         return this.httpService.get({
             endpoint: '/rates',
         });
     }
-    async getFiatToAR({ currency, }) {
+    getFiatToAR({ currency, }) {
         return this.httpService.get({
             endpoint: `/rates/${currency}`,
         });
     }
-    async getSupportedCountries() {
+    getSupportedCountries() {
         return this.httpService.get({
             endpoint: '/countries',
         });
     }
-    async getSupportedCurrencies() {
+    getSupportedCurrencies() {
         return this.httpService.get({
             endpoint: '/currencies',
         });
@@ -33,15 +35,38 @@ export class TurboUnauthenticatedPaymentService {
         const wincCostsForBytes = await Promise.all(fetchPricePromises);
         return wincCostsForBytes;
     }
-    async getWincForFiat({ amount, currency }) {
+    getWincForFiat({ amount, }) {
+        const { amount: paymentAmount, type: currencyType } = amount;
         return this.httpService.get({
-            endpoint: `/price/${currency}/${amount}`,
+            endpoint: `/price/${currencyType}/${paymentAmount}`,
         });
     }
+    appendPromoCodesToQuery(promoCodes) {
+        const promoCodesQuery = promoCodes.join(',');
+        return promoCodesQuery ? `?promoCode=${promoCodesQuery}` : '';
+    }
+    async getCheckout({ amount, owner, promoCodes = [] }, headers) {
+        const { amount: paymentAmount, type: currencyType } = amount;
+        const endpoint = `/top-up/checkout-session/${owner}/${currencyType}/${paymentAmount}${this.appendPromoCodesToQuery(promoCodes)}`;
+        const { adjustments, paymentSession, topUpQuote } = await this.httpService.get({
+            endpoint,
+            headers,
+        });
+        return {
+            winc: topUpQuote.winstonCreditAmount,
+            adjustments,
+            url: paymentSession.url,
+            paymentAmount: topUpQuote.paymentAmount,
+            quotedPaymentAmount: topUpQuote.quotedPaymentAmount,
+        };
+    }
+    createCheckoutSession(params) {
+        return this.getCheckout(params);
+    }
 }
 // NOTE: to avoid redundancy, we use inheritance here - but generally prefer composition over inheritance
 export class TurboAuthenticatedPaymentService extends TurboUnauthenticatedPaymentService {
-    constructor({ url = 'https://payment.ardrive.dev', retryConfig, signer, }) {
+    constructor({ url = defaultPaymentServiceURL, retryConfig, signer, }) {
         super({ url, retryConfig });
         this.signer = signer;
     }
@@ -55,4 +80,13 @@ export class TurboAuthenticatedPaymentService extends TurboUnauthenticatedPaymen
         // 404's don't return a balance, so default to 0
         return balance.winc ? balance : { winc: '0' };
     }
+    async getWincForFiat({ amount, promoCodes = [], }) {
+        return this.httpService.get({
+            endpoint: `/price/${amount.type}/${amount.amount}${this.appendPromoCodesToQuery(promoCodes)}`,
+            headers: await this.signer.generateSignedRequestHeaders(),
+        });
+    }
+    async createCheckoutSession(params) {
+        return this.getCheckout(params, await this.signer.generateSignedRequestHeaders());
+    }
 }

package/lib/esm/common/turbo.js

@@ -1,5 +1,27 @@
-import { TurboUnauthenticatedPaymentService } from './payment.js';
-import { TurboUnauthenticatedUploadService } from './upload.js';
+import { TurboUnauthenticatedPaymentService, defaultPaymentServiceURL, developmentPaymentServiceURL, } from './payment.js';
+import { TurboUnauthenticatedUploadService, defaultUploadServiceURL, developmentUploadServiceURL, } from './upload.js';
+/**
+ * Testing configuration.
+ */
+export const developmentTurboConfiguration = {
+    paymentServiceConfig: {
+        url: developmentPaymentServiceURL,
+    },
+    uploadServiceConfig: {
+        url: developmentUploadServiceURL,
+    },
+};
+/**
+ * Production configuration.
+ */
+export const defaultTurboConfiguration = {
+    paymentServiceConfig: {
+        url: defaultPaymentServiceURL,
+    },
+    uploadServiceConfig: {
+        url: defaultUploadServiceURL,
+    },
+};
 export class TurboUnauthenticatedClient {
     constructor({ uploadService = new TurboUnauthenticatedUploadService({}), paymentService = new TurboUnauthenticatedPaymentService({}), }) {
         this.paymentService = paymentService;
@@ -8,7 +30,7 @@ export class TurboUnauthenticatedClient {
     /**
      * Returns the supported fiat currency conversion rate for 1AR based on current market prices.
      */
-    async getFiatToAR({ currency, }) {
+    getFiatToAR({ currency, }) {
         return this.paymentService.getFiatToAR({ currency });
     }
     /**
@@ -17,42 +39,49 @@ export class TurboUnauthenticatedClient {
      * Note: this does not take into account varying adjustments and promotions for different sizes of data. If you want to calculate the total
      * cost in 'winc' for a given number of bytes, use getUploadCosts.
      */
-    async getFiatRates() {
+    getFiatRates() {
         return this.paymentService.getFiatRates();
     }
     /**
      * Returns a comprehensive list of supported countries that can purchase credits through the Turbo Payment Service.
      */
-    async getSupportedCountries() {
+    getSupportedCountries() {
         return this.paymentService.getSupportedCountries();
     }
     /**
      * Returns a list of all supported fiat currencies.
      */
-    async getSupportedCurrencies() {
+    getSupportedCurrencies() {
         return this.paymentService.getSupportedCurrencies();
     }
     /**
      * Determines the price in 'winc' to upload one data item of a specific size in bytes, including all Turbo cost adjustments and fees.
      */
-    async getUploadCosts({ bytes, }) {
+    getUploadCosts({ bytes, }) {
         return this.paymentService.getUploadCosts({ bytes });
     }
     /**
      * Determines the amount of 'winc' that would be returned for a given currency and amount, including all Turbo cost adjustments and fees.
      */
-    async getWincForFiat({ amount, currency, }) {
-        return this.paymentService.getWincForFiat({ amount, currency });
+    getWincForFiat(params) {
+        return this.paymentService.getWincForFiat(params);
     }
     /**
      * Uploads a signed data item to the Turbo Upload Service.
      */
-    async uploadSignedDataItem({ dataItemStreamFactory, signal, }) {
+    uploadSignedDataItem({ dataItemStreamFactory, dataItemSizeFactory, signal, }) {
         return this.uploadService.uploadSignedDataItem({
             dataItemStreamFactory,
+            dataItemSizeFactory,
             signal,
         });
     }
+    /**
+     * Creates a Turbo Checkout Session for a given amount and currency.
+     */
+    createCheckoutSession(params) {
+        return this.paymentService.createCheckoutSession(params);
+    }
 }
 export class TurboAuthenticatedClient extends TurboUnauthenticatedClient {
     constructor({ paymentService, uploadService, }) {
@@ -61,13 +90,17 @@ export class TurboAuthenticatedClient extends TurboUnauthenticatedClient {
     /**
      * Returns the current balance of the user's wallet in 'winc'.
      */
-    async getBalance() {
+    getBalance() {
         return this.paymentService.getBalance();
     }
     /**
      * Signs and uploads raw data to the Turbo Upload Service.
      */
-    async uploadFile({ fileStreamFactory, signal, }) {
-        return this.uploadService.uploadFile({ fileStreamFactory, signal });
+    uploadFile({ fileStreamFactory, fileSizeFactory, signal, }) {
+        return this.uploadService.uploadFile({
+            fileStreamFactory,
+            fileSizeFactory,
+            signal,
+        });
     }
 }

package/lib/esm/common/upload.js

@@ -1,12 +1,15 @@
 import { TurboHTTPService } from './http.js';
+export const defaultUploadServiceURL = 'https://upload.ardrive.io';
+export const developmentUploadServiceURL = 'https://upload.ardrive.dev';
 export class TurboUnauthenticatedUploadService {
-    constructor({ url = 'https://upload.ardrive.dev', retryConfig, }) {
+    constructor({ url = defaultUploadServiceURL, retryConfig, }) {
         this.httpService = new TurboHTTPService({
             url: `${url}/v1`,
             retryConfig,
         });
     }
-    async uploadSignedDataItem({ dataItemStreamFactory, signal, }) {
+    async uploadSignedDataItem({ dataItemStreamFactory, dataItemSizeFactory, signal, }) {
+        const fileSize = dataItemSizeFactory();
         // TODO: add p-limit constraint or replace with separate upload class
         return this.httpService.post({
             endpoint: `/tx`,
@@ -14,6 +17,7 @@ export class TurboUnauthenticatedUploadService {
             data: dataItemStreamFactory(),
             headers: {
                 'content-type': 'application/octet-stream',
+                'content-length': `${fileSize}`,
             },
         });
     }
@@ -24,10 +28,13 @@ export class TurboAuthenticatedUploadService extends TurboUnauthenticatedUploadS
         super({ url, retryConfig });
         this.signer = signer;
     }
-    async uploadFile({ fileStreamFactory, signal, }) {
-        const signedDataItem = await this.signer.signDataItem({
+    async uploadFile({ fileStreamFactory, fileSizeFactory, signal, }) {
+        const { dataItemStreamFactory, dataItemSizeFactory } = await this.signer.signDataItem({
             fileStreamFactory,
+            fileSizeFactory,
         });
+        const signedDataItem = dataItemStreamFactory();
+        const fileSize = dataItemSizeFactory();
         // TODO: add p-limit constraint or replace with separate upload class
         return this.httpService.post({
             endpoint: `/tx`,
@@ -35,6 +42,7 @@ export class TurboAuthenticatedUploadService extends TurboUnauthenticatedUploadS
             data: signedDataItem,
             headers: {
                 'content-type': 'application/octet-stream',
+                'content-length': `${fileSize}`,
             },
         });
     }