@ardrive/turbo-sdk 1.0.0-alpha.2 → 1.0.0-alpha.21

package/lib/cjs/common/upload.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TurboAuthenticatedUploadService = exports.TurboUnauthenticatedUploadService = void 0;
+const http_js_1 = require("./http.js");
+class TurboUnauthenticatedUploadService {
+    constructor({ url = 'https://upload.ardrive.dev', retryConfig, }) {
+        this.httpService = new http_js_1.TurboHTTPService({
+            url: `${url}/v1`,
+            retryConfig,
+        });
+    }
+    async uploadSignedDataItem({ dataItemStreamFactory, signal, }) {
+        // TODO: add p-limit constraint or replace with separate upload class
+        return this.httpService.post({
+            endpoint: `/tx`,
+            signal,
+            data: dataItemStreamFactory(),
+            headers: {
+                'content-type': 'application/octet-stream',
+            },
+        });
+    }
+}
+exports.TurboUnauthenticatedUploadService = TurboUnauthenticatedUploadService;
+// NOTE: to avoid redundancy, we use inheritance here - but generally prefer composition over inheritance
+class TurboAuthenticatedUploadService extends TurboUnauthenticatedUploadService {
+    constructor({ url = 'https://upload.ardrive.dev', retryConfig, signer, }) {
+        super({ url, retryConfig });
+        this.signer = signer;
+    }
+    async uploadFile({ fileStreamFactory, signal, }) {
+        const signedDataItem = await this.signer.signDataItem({
+            fileStreamFactory,
+        });
+        // TODO: add p-limit constraint or replace with separate upload class
+        return this.httpService.post({
+            endpoint: `/tx`,
+            signal,
+            data: signedDataItem,
+            headers: {
+                'content-type': 'application/octet-stream',
+            },
+        });
+    }
+}
+exports.TurboAuthenticatedUploadService = TurboAuthenticatedUploadService;

package/lib/cjs/node/factory.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TurboFactory = void 0;
+/**
+ * Copyright (C) 2022-2023 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/>.
+ */
+const factory_js_1 = require("../common/factory.js");
+const index_js_1 = require("../common/index.js");
+const signer_js_1 = require("./signer.js");
+class TurboFactory extends factory_js_1.TurboBaseFactory {
+    static authenticated({ privateKey, paymentServiceConfig = {}, uploadServiceConfig = {}, }) {
+        const signer = new signer_js_1.TurboNodeArweaveSigner({ privateKey });
+        const paymentService = new index_js_1.TurboAuthenticatedPaymentService({
+            ...paymentServiceConfig,
+            signer,
+        });
+        const uploadService = new index_js_1.TurboAuthenticatedUploadService({
+            ...uploadServiceConfig,
+            signer,
+        });
+        return new index_js_1.TurboAuthenticatedClient({
+            uploadService,
+            paymentService,
+        });
+    }
+}
+exports.TurboFactory = TurboFactory;

package/lib/cjs/node/index.js

@@ -0,0 +1,36 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Copyright (C) 2022-2023 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/>.
+ */
+__exportStar(require("./factory.js"), exports);
+__exportStar(require("./signer.js"), exports);
+__exportStar(require("../types.js"), exports);
+__exportStar(require("../common/index.js"), exports);

package/lib/cjs/node/signer.js

@@ -0,0 +1,50 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TurboNodeArweaveSigner = void 0;
+/**
+ * Copyright (C) 2022-2023 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/>.
+ */
+const arbundles_1 = require("arbundles");
+const index_js_1 = __importDefault(require("arweave/node/index.js"));
+const node_crypto_1 = require("node:crypto");
+const base64_js_1 = require("../utils/base64.js");
+class TurboNodeArweaveSigner {
+    // TODO: replace with internal signer class
+    constructor({ privateKey }) {
+        this.privateKey = privateKey;
+        this.signer = new arbundles_1.ArweaveSigner(this.privateKey);
+    }
+    signDataItem({ fileStreamFactory, }) {
+        // TODO: replace with our own signer implementation
+        const [stream1, stream2] = [fileStreamFactory(), fileStreamFactory()];
+        return (0, arbundles_1.streamSigner)(stream1, stream2, this.signer);
+    }
+    // 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() {
+        const nonce = (0, node_crypto_1.randomBytes)(16).toString('hex');
+        const buffer = Buffer.from(nonce);
+        const signature = await index_js_1.default.crypto.sign(this.privateKey, buffer);
+        return {
+            'x-public-key': this.privateKey.n,
+            'x-nonce': nonce,
+            'x-signature': (0, base64_js_1.toB64Url)(Buffer.from(signature)),
+        };
+    }
+}
+exports.TurboNodeArweaveSigner = TurboNodeArweaveSigner;

package/lib/cjs/package.json

@@ -0,0 +1 @@
+{"type": "commonjs"}

package/lib/cjs/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/cjs/utils/axiosClient.js

@@ -0,0 +1,69 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAxiosInstance = void 0;
+/**
+ * Copyright (C) 2022-2023 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/>.
+ */
+const axios_1 = __importStar(require("axios"));
+const axios_retry_1 = __importDefault(require("axios-retry"));
+const createAxiosInstance = ({ axiosConfig = {}, retryConfig = {
+    retryDelay: axios_retry_1.default.exponentialDelay,
+    retries: 3,
+    retryCondition: (error) => {
+        return (!(error instanceof axios_1.CanceledError) &&
+            axios_retry_1.default.isNetworkOrIdempotentRequestError(error));
+    },
+    onRetry: (retryCount, error) => {
+        console.debug(`Request failed, ${error}. Retry attempt #${retryCount}...`);
+    },
+}, }) => {
+    const axiosInstance = axios_1.default.create({
+        ...axiosConfig,
+        validateStatus: () => true, // don't throw on non-200 status codes
+    });
+    // eslint-disable-next-line
+    if (retryConfig.retries && retryConfig.retries > 0) {
+        (0, axios_retry_1.default)(axiosInstance, retryConfig);
+    }
+    return axiosInstance;
+};
+exports.createAxiosInstance = createAxiosInstance;

package/lib/cjs/utils/base64.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sha256B64Url = exports.toB64Url = exports.fromB64Url = exports.ownerToAddress = exports.jwkToPublicArweaveAddress = exports.base64URLRegex = void 0;
+/**
+ * Copyright (C) 2022-2023 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/>.
+ */
+const utils_js_1 = require("arweave/node/lib/utils.js");
+const crypto_1 = require("crypto");
+exports.base64URLRegex = /^[a-zA-Z0-9_-]{43}$/;
+function jwkToPublicArweaveAddress(jwk) {
+    return ownerToAddress(jwk.n);
+}
+exports.jwkToPublicArweaveAddress = jwkToPublicArweaveAddress;
+function ownerToAddress(owner) {
+    return sha256B64Url(fromB64Url(owner));
+}
+exports.ownerToAddress = ownerToAddress;
+function fromB64Url(input) {
+    const paddingLength = input.length % 4 === 0 ? 0 : 4 - (input.length % 4);
+    const base64 = input
+        .replace(/-/g, '+')
+        .replace(/_/g, '/')
+        .concat('='.repeat(paddingLength));
+    return Buffer.from(base64, 'base64');
+}
+exports.fromB64Url = fromB64Url;
+function toB64Url(buffer) {
+    return (0, utils_js_1.bufferTob64Url)(buffer);
+}
+exports.toB64Url = toB64Url;
+function sha256B64Url(input) {
+    return toB64Url((0, crypto_1.createHash)('sha256').update(input).digest());
+}
+exports.sha256B64Url = sha256B64Url;

package/lib/cjs/utils/errors.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FailedRequestError = exports.UnauthenticatedRequestError = void 0;
+/**
+ * Copyright (C) 2022-2023 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/>.
+ */
+class UnauthenticatedRequestError extends Error {
+    constructor() {
+        super('Failed authentication. JWK is required.');
+        this.name = 'UnauthenticatedRequestError';
+    }
+}
+exports.UnauthenticatedRequestError = UnauthenticatedRequestError;
+class FailedRequestError extends Error {
+    constructor(status, message) {
+        super(`Failed request: ${status}: ${message}`);
+        this.name = 'FailedRequestError';
+    }
+}
+exports.FailedRequestError = FailedRequestError;

package/lib/cjs/utils/readableStream.js

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

package/lib/cjs/web/factory.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TurboFactory = void 0;
+/**
+ * Copyright (C) 2022-2023 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/>.
+ */
+const factory_js_1 = require("../common/factory.js");
+const index_js_1 = require("../common/index.js");
+const signer_js_1 = require("./signer.js");
+class TurboFactory extends factory_js_1.TurboBaseFactory {
+    static authenticated({ privateKey, paymentServiceConfig = {}, uploadServiceConfig = {}, }) {
+        const signer = new signer_js_1.TurboWebArweaveSigner({ privateKey });
+        const paymentService = new index_js_1.TurboAuthenticatedPaymentService({
+            ...paymentServiceConfig,
+            signer,
+        });
+        const uploadService = new index_js_1.TurboAuthenticatedUploadService({
+            ...uploadServiceConfig,
+            signer,
+        });
+        return new index_js_1.TurboAuthenticatedClient({
+            uploadService,
+            paymentService,
+        });
+    }
+}
+exports.TurboFactory = TurboFactory;

package/lib/cjs/web/index.js

@@ -0,0 +1,36 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Copyright (C) 2022-2023 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/>.
+ */
+__exportStar(require("./factory.js"), exports);
+__exportStar(require("./signer.js"), exports);
+__exportStar(require("../common/index.js"), exports);
+__exportStar(require("../types.js"), exports);

package/lib/cjs/web/signer.js

@@ -0,0 +1,57 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TurboWebArweaveSigner = void 0;
+/**
+ * Copyright (C) 2022-2023 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/>.
+ */
+const arbundles_1 = require("arbundles");
+const arweave_1 = __importDefault(require("arweave"));
+const node_crypto_1 = require("node:crypto");
+const base64_js_1 = require("../utils/base64.js");
+const readableStream_js_1 = require("../utils/readableStream.js");
+class TurboWebArweaveSigner {
+    constructor({ privateKey }) {
+        this.privateKey = privateKey;
+        this.signer = new arbundles_1.ArweaveSigner(this.privateKey);
+    }
+    async signDataItem({ fileStreamFactory, }) {
+        // 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
+        });
+        const signedDataItem = (0, arbundles_1.createData)(buffer, this.signer);
+        await signedDataItem.sign(this.signer);
+        return signedDataItem.getRaw();
+    }
+    // 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() {
+        // a bit hacky - but arweave exports cause issues in tests vs. browser
+        const arweave = arweave_1.default.default ?? arweave_1.default;
+        const nonce = (0, node_crypto_1.randomBytes)(16).toString('hex');
+        const buffer = Buffer.from(nonce);
+        const signature = await arweave.crypto.sign(this.privateKey, buffer, {});
+        return {
+            'x-public-key': this.privateKey.n,
+            'x-nonce': nonce,
+            'x-signature': (0, base64_js_1.toB64Url)(Buffer.from(signature)),
+        };
+    }
+}
+exports.TurboWebArweaveSigner = TurboWebArweaveSigner;

package/lib/{common → esm/common}/factory.js

@@ -3,8 +3,12 @@ import { TurboUnauthenticatedClient } from './turbo.js';
 import { TurboUnauthenticatedUploadService } from './upload.js';
 export class TurboBaseFactory {
     static unauthenticated({ paymentServiceConfig = {}, uploadServiceConfig = {}, } = {}) {
-        const paymentService = new TurboUnauthenticatedPaymentService(Object.assign({}, paymentServiceConfig));
-        const uploadService = new TurboUnauthenticatedUploadService(Object.assign({}, uploadServiceConfig));
+        const paymentService = new TurboUnauthenticatedPaymentService({
+            ...paymentServiceConfig,
+        });
+        const uploadService = new TurboUnauthenticatedUploadService({
+            ...uploadServiceConfig,
+        });
         return new TurboUnauthenticatedClient({
             uploadService,
             paymentService,

package/lib/esm/common/http.js

@@ -0,0 +1,32 @@
+import { createAxiosInstance } from '../utils/axiosClient.js';
+import { FailedRequestError } from '../utils/errors.js';
+export class TurboHTTPService {
+    constructor({ url, retryConfig, }) {
+        this.axios = createAxiosInstance({
+            axiosConfig: {
+                baseURL: url,
+            },
+            retryConfig,
+        });
+    }
+    async get({ endpoint, signal, allowedStatuses = [200, 202], headers, }) {
+        const { status, statusText, data } = await this.axios.get(endpoint, {
+            headers,
+            signal,
+        });
+        if (!allowedStatuses.includes(status)) {
+            throw new FailedRequestError(status, statusText);
+        }
+        return data;
+    }
+    async post({ endpoint, signal, allowedStatuses = [200, 202], headers, data, }) {
+        const { status, statusText, data: response, } = await this.axios.post(endpoint, data, {
+            headers,
+            signal,
+        });
+        if (!allowedStatuses.includes(status)) {
+            throw new FailedRequestError(status, statusText);
+        }
+        return response;
+    }
+}

package/lib/esm/common/payment.js

@@ -0,0 +1,58 @@
+import { TurboHTTPService } from './http.js';
+export class TurboUnauthenticatedPaymentService {
+    constructor({ url = 'https://payment.ardrive.dev', retryConfig, }) {
+        this.httpService = new TurboHTTPService({
+            url: `${url}/v1`,
+            retryConfig,
+        });
+    }
+    async getFiatRates() {
+        return this.httpService.get({
+            endpoint: '/rates',
+        });
+    }
+    async getFiatToAR({ currency, }) {
+        return this.httpService.get({
+            endpoint: `/rates/${currency}`,
+        });
+    }
+    async getSupportedCountries() {
+        return this.httpService.get({
+            endpoint: '/countries',
+        });
+    }
+    async getSupportedCurrencies() {
+        return this.httpService.get({
+            endpoint: '/currencies',
+        });
+    }
+    async getUploadCosts({ bytes, }) {
+        const fetchPricePromises = bytes.map((byteCount) => this.httpService.get({
+            endpoint: `/price/bytes/${byteCount}`,
+        }));
+        const wincCostsForBytes = await Promise.all(fetchPricePromises);
+        return wincCostsForBytes;
+    }
+    async getWincForFiat({ amount, currency }) {
+        return this.httpService.get({
+            endpoint: `/price/${currency}/${amount}`,
+        });
+    }
+}
+// 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, }) {
+        super({ url, retryConfig });
+        this.signer = signer;
+    }
+    async getBalance() {
+        const headers = await this.signer.generateSignedRequestHeaders();
+        const balance = await this.httpService.get({
+            endpoint: '/balance',
+            headers,
+            allowedStatuses: [200, 404],
+        });
+        // 404's don't return a balance, so default to 0
+        return balance.winc ? balance : { winc: '0' };
+    }
+}

package/lib/esm/common/turbo.js

@@ -0,0 +1,73 @@
+import { TurboUnauthenticatedPaymentService } from './payment.js';
+import { TurboUnauthenticatedUploadService } from './upload.js';
+export class TurboUnauthenticatedClient {
+    constructor({ uploadService = new TurboUnauthenticatedUploadService({}), paymentService = new TurboUnauthenticatedPaymentService({}), }) {
+        this.paymentService = paymentService;
+        this.uploadService = uploadService;
+    }
+    /**
+     * Returns the supported fiat currency conversion rate for 1AR based on current market prices.
+     */
+    async getFiatToAR({ currency, }) {
+        return this.paymentService.getFiatToAR({ currency });
+    }
+    /**
+     * Returns the latest conversion rates to purchase 1GiB of data for all supported currencies, including all adjustments and fees.
+     *
+     * 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() {
+        return this.paymentService.getFiatRates();
+    }
+    /**
+     * Returns a comprehensive list of supported countries that can purchase credits through the Turbo Payment Service.
+     */
+    async getSupportedCountries() {
+        return this.paymentService.getSupportedCountries();
+    }
+    /**
+     * Returns a list of all supported fiat currencies.
+     */
+    async 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, }) {
+        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 });
+    }
+    /**
+     * Uploads a signed data item to the Turbo Upload Service.
+     */
+    async uploadSignedDataItem({ dataItemStreamFactory, signal, }) {
+        return this.uploadService.uploadSignedDataItem({
+            dataItemStreamFactory,
+            signal,
+        });
+    }
+}
+export class TurboAuthenticatedClient extends TurboUnauthenticatedClient {
+    constructor({ paymentService, uploadService, }) {
+        super({ paymentService, uploadService });
+    }
+    /**
+     * Returns the current balance of the user's wallet in 'winc'.
+     */
+    async 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 });
+    }
+}