@ar.io/sdk 3.10.0-alpha.6 → 3.11.0-alpha.1

package/lib/cjs/utils/arweave.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.removeEligibleRewardsFromEpochData = exports.sortAndPaginateEpochDataIntoEligibleDistributions = exports.epochDistributionNoticeGqlQueryFallback = exports.epochDistributionNoticeGqlQuery = exports.getEpochDataFromGqlFallback = exports.getEpochDataFromGqlWithCUFallback = exports.getEpochDataFromGql = exports.paginationParamsToTags = exports.pruneTags = exports.isBlockHeight = exports.validateArweaveId = void 0;
+exports.epochDistributionNoticeGqlQueryFallback = exports.epochDistributionNoticeGqlQuery = exports.getEpochDataFromGqlFallback = exports.getEpochDataFromGqlWithCUFallback = exports.getEpochDataFromGql = exports.paginationParamsToTags = exports.pruneTags = exports.validateArweaveId = void 0;
+exports.isBlockHeight = isBlockHeight;
+exports.sortAndPaginateEpochDataIntoEligibleDistributions = sortAndPaginateEpochDataIntoEligibleDistributions;
+exports.removeEligibleRewardsFromEpochData = removeEligibleRewardsFromEpochData;
 const constants_js_1 = require("../constants.js");
 const io_js_1 = require("../types/io.js");
 const ao_js_1 = require("./ao.js");
@@ -11,7 +14,6 @@ exports.validateArweaveId = validateArweaveId;
 function isBlockHeight(height) {
     return height !== undefined && !isNaN(parseInt(height.toString()));
 }
-exports.isBlockHeight = isBlockHeight;
 /**
  * Prune tags that are undefined or empty.
  * @param tags - The tags to prune.
@@ -251,7 +253,6 @@ function sortAndPaginateEpochDataIntoEligibleDistributions(epochData, params) {
         sortBy,
     };
 }
-exports.sortAndPaginateEpochDataIntoEligibleDistributions = sortAndPaginateEpochDataIntoEligibleDistributions;
 function removeEligibleRewardsFromEpochData(epochData) {
     if (!(0, io_js_1.isDistributedEpoch)(epochData)) {
         return epochData;
@@ -268,4 +269,3 @@ function removeEligibleRewardsFromEpochData(epochData) {
         },
     };
 }
-exports.removeEligibleRewardsFromEpochData = removeEligibleRewardsFromEpochData;

package/lib/cjs/utils/base64.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getRandomText = exports.sha256B64Url = exports.toB64Url = exports.fromB64Url = void 0;
+exports.fromB64Url = fromB64Url;
+exports.toB64Url = toB64Url;
+exports.sha256B64Url = sha256B64Url;
+exports.getRandomText = getRandomText;
 /**
  * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
  *
@@ -42,16 +45,13 @@ function fromB64Url(str) {
     const b64Str = base64urlToBase64(str);
     return Buffer.from(b64Str, 'base64');
 }
-exports.fromB64Url = fromB64Url;
 function toB64Url(buffer) {
     const b64Str = buffer.toString('base64');
     return base64urlFromBase64(b64Str);
 }
-exports.toB64Url = toB64Url;
 function sha256B64Url(input) {
     return toB64Url((0, crypto_1.createHash)('sha256').update(Uint8Array.from(input)).digest());
 }
-exports.sha256B64Url = sha256B64Url;
 function getRandomText(length = 32) {
     // Generate a buffer of random bytes
     const buffer = (0, crypto_1.randomBytes)(length);
@@ -60,4 +60,3 @@ function getRandomText(length = 32) {
         .join('')
         .slice(0, length);
 }
-exports.getRandomText = getRandomText;

package/lib/cjs/utils/json.js

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.safeDecode = void 0;
+exports.safeDecode = safeDecode;
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 function safeDecode(data) {
     try {
@@ -25,4 +25,3 @@ function safeDecode(data) {
         return data;
     }
 }
-exports.safeDecode = safeDecode;

package/lib/cjs/utils/random.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.randomInt = void 0;
+/**
+ * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+const crypto_1 = require("crypto");
+/**
+ * Cryptographically secure helper for randomness, does not support seeding
+ * @param min - the minimum value
+ * @param max - the maximum value
+ * @returns a random integer between min and max
+ */
+const randomInt = (min, max) => {
+    const [rand] = crypto_1.webcrypto.getRandomValues(new Uint32Array(1));
+    return min + (rand % (max - min));
+};
+exports.randomInt = randomInt;

package/lib/cjs/utils/schema.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseSchemaResult = void 0;
+exports.parseSchemaResult = parseSchemaResult;
 /**
  * @param schema - zod schema
  * @param v - value to parse
@@ -13,4 +13,3 @@ function parseSchemaResult(schema, v) {
     }
     return schemaResult;
 }
-exports.parseSchemaResult = parseSchemaResult;

package/lib/cjs/utils/utils.test.js

@@ -2,8 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const node_assert_1 = require("node:assert");
 const node_test_1 = require("node:test");
+const ao_js_1 = require("./ao.js");
 const arweave_js_1 = require("./arweave.js");
-const index_js_1 = require("./index.js");
 (0, node_test_1.describe)('pruneTags', () => {
     (0, node_test_1.it)('should remove tags with undefined values', () => {
         const tags = [
@@ -45,7 +45,7 @@ const index_js_1 = require("./index.js");
         const output = {
             Error: 'Error message',
         };
-        const errorMessage = (0, index_js_1.errorMessageFromOutput)(output);
+        const errorMessage = (0, ao_js_1.errorMessageFromOutput)(output);
         node_assert_1.strict.equal(errorMessage, 'Error message');
     });
     (0, node_test_1.it)('should return error message from Error tag', () => {
@@ -56,7 +56,7 @@ const index_js_1 = require("./index.js");
                 },
             ],
         };
-        const errorMessage = (0, index_js_1.errorMessageFromOutput)(output);
+        const errorMessage = (0, ao_js_1.errorMessageFromOutput)(output);
         node_assert_1.strict.equal(errorMessage, 'Error message');
     });
     (0, node_test_1.it)('should return error message from Error tag if Error field is undefined', () => {
@@ -67,7 +67,7 @@ const index_js_1 = require("./index.js");
                 },
             ],
         };
-        const errorMessage = (0, index_js_1.errorMessageFromOutput)(output);
+        const errorMessage = (0, ao_js_1.errorMessageFromOutput)(output);
         node_assert_1.strict.equal(errorMessage, 'Error message');
     });
     (0, node_test_1.it)('should return undefined if no error message is present', () => {
@@ -78,21 +78,21 @@ const index_js_1 = require("./index.js");
                 },
             ],
         };
-        const errorMessage = (0, index_js_1.errorMessageFromOutput)(output);
+        const errorMessage = (0, ao_js_1.errorMessageFromOutput)(output);
         node_assert_1.strict.equal(errorMessage, undefined);
     });
     (0, node_test_1.it)('should return error message with line number', () => {
         const output = {
             Error: '[string "aos"]:123: Error message',
         };
-        const errorMessage = (0, index_js_1.errorMessageFromOutput)(output);
+        const errorMessage = (0, ao_js_1.errorMessageFromOutput)(output);
         node_assert_1.strict.equal(errorMessage, 'Error message (line 123)');
     });
     (0, node_test_1.it)('should return error message with line number and remove unicode', () => {
         const output = {
             Error: '[string "aos"]:123: Error message\u001b[0m',
         };
-        const errorMessage = (0, index_js_1.errorMessageFromOutput)(output);
+        const errorMessage = (0, ao_js_1.errorMessageFromOutput)(output);
         node_assert_1.strict.equal(errorMessage, 'Error message (line 123)');
     });
     const knownErrorMessages = '\u001b[31mError\u001b[90m handling message with Action = Register\u001b[0m\n\u001b[32m[string ".handlers"]:723: [string "aos"]:128: Already registered\u001b[0m\n\n\u001b[90mstack traceback:\n\t[string ".process"]:871: in function \'.process.handle\'\u001b[0m\n\n\u001b[31merror:\n\u001b[0m[string ".handlers"]:723: [string "aos"]:128: Already registered';
@@ -100,7 +100,7 @@ const index_js_1 = require("./index.js");
         const output = {
             Error: knownErrorMessages,
         };
-        const errorMessage = (0, index_js_1.errorMessageFromOutput)(output);
+        const errorMessage = (0, ao_js_1.errorMessageFromOutput)(output);
         node_assert_1.strict.equal(errorMessage, 'Already registered (line 128)');
     });
 });

package/lib/cjs/version.js

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

package/lib/esm/common/wayfinder/routers/priority.js

@@ -1,4 +1,4 @@
-import { randomInt } from '../wayfinder.js';
+import { randomInt } from '../../../utils/random.js';
 // TODO: one of N where N are in the last time window have met certain performance thresholds
 // TODO: look at bitorrent routing protocols for inspiration
 // TODO: router that looks at local stats/metrics and adjusts based on those

package/lib/esm/common/wayfinder/routers/random.js

@@ -1,4 +1,4 @@
-import { randomInt } from '../wayfinder.js';
+import { randomInt } from '../../../utils/random.js';
 export class RandomGatewayRouter {
     name = 'random';
     gatewaysProvider;

package/lib/esm/common/wayfinder/wayfinder.js

@@ -1,35 +1,9 @@
-/**
- * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-import { webcrypto } from 'crypto';
 import { ARIO } from '../io.js';
 import { ARIOGatewaysProvider } from './gateways.js';
 import { RandomGatewayRouter } from './routers/random.js';
 // known regexes for wayfinder urls
 export const arnsRegex = /^[a-z0-9_-]{1,51}$/;
 export const txIdRegex = /^[a-z0-9]{43}$/;
-/**
- * Cryptographically secure helper for randomness, does not support seeding
- * @param min - the minimum value
- * @param max - the maximum value
- * @returns a random integer between min and max
- */
-export const randomInt = (min, max) => {
-    const [rand] = webcrypto.getRandomValues(new Uint32Array(1));
-    return min + (rand % (max - min));
-};
 /**
  * Core function to resolve a wayfinder url against a target gateway
  * @param originalUrl - the wayfinder url to resolve

package/lib/esm/common/wayfinder/wayfinder.test.js

@@ -219,31 +219,30 @@ describe('Wayfinder', () => {
                 assert.strictEqual(response.data, nativeAxios.data);
             });
         });
-    });
-    describe('got', () => {
-        let wayfinder;
-        before(() => {
-            wayfinder = new Wayfinder({
-                httpClient: got,
-                router: new RandomGatewayRouter({
-                    gatewaysProvider: stubbedGatewaysProvider,
-                }),
+        describe('got', () => {
+            let wayfinder;
+            before(() => {
+                wayfinder = new Wayfinder({
+                    httpClient: got,
+                    router: new RandomGatewayRouter({
+                        gatewaysProvider: stubbedGatewaysProvider,
+                    }),
+                });
+            });
+            it('should fetch the data using the got default function against the target gateway', async () => {
+                const [nativeGot, response] = await Promise.all([
+                    got('https://ao.arweave.net'),
+                    wayfinder.request('ar://ao'),
+                ]);
+                assert.strictEqual(response.statusCode, 200);
+                assert.strictEqual(response.statusCode, nativeGot.statusCode);
+                assert.deepStrictEqual(response.body, nativeGot.body);
+            });
+            it('should stream the data using got.stream against the selected target gateway', async () => {
+                const nativeBuffer = await buffer(await got.stream('https://ao.arweave.net', { decompress: false }));
+                const wayfinderBuffer = await buffer(await wayfinder.request.stream('ar://ao', { decompress: false }));
+                assert.deepStrictEqual(wayfinderBuffer, nativeBuffer);
             });
-        });
-        it('should fetch the data using the got default function against the target gateway', async () => {
-            const [nativeGot, response] = await Promise.all([
-                got('https://ao.arweave.net'),
-                wayfinder.request('ar://ao'),
-            ]);
-            assert.strictEqual(response.statusCode, 200);
-            assert.strictEqual(response.statusCode, nativeGot.statusCode);
-            assert.deepStrictEqual(response.body, nativeGot.body);
-        });
-        it('should stream the data using got.stream against the selected target gateway', async () => {
-            const nativeBuffer = await buffer(await got.stream('https://ao.arweave.net', { decompress: false }));
-            const wayfinderBuffer = await buffer(await wayfinder.request.stream('ar://ao', { decompress: false }));
-            assert.deepStrictEqual(wayfinderBuffer, nativeBuffer);
         });
     });
-    // TODO: streaming support using got.stream and got()
 });

package/lib/esm/utils/random.js

@@ -0,0 +1,26 @@
+/**
+ * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { webcrypto } from 'crypto';
+/**
+ * Cryptographically secure helper for randomness, does not support seeding
+ * @param min - the minimum value
+ * @param max - the maximum value
+ * @returns a random integer between min and max
+ */
+export const randomInt = (min, max) => {
+    const [rand] = webcrypto.getRandomValues(new Uint32Array(1));
+    return min + (rand % (max - min));
+};

package/lib/esm/utils/utils.test.js

@@ -1,7 +1,7 @@
 import { strict as assert } from 'node:assert';
 import { describe, it } from 'node:test';
+import { errorMessageFromOutput } from './ao.js';
 import { pruneTags, sortAndPaginateEpochDataIntoEligibleDistributions, } from './arweave.js';
-import { errorMessageFromOutput } from './index.js';
 describe('pruneTags', () => {
     it('should remove tags with undefined values', () => {
         const tags = [

package/lib/esm/version.js

@@ -14,4 +14,4 @@
  * limitations under the License.
  */
 // AUTOMATICALLY GENERATED FILE - DO NOT TOUCH
-export const version = '3.10.0-alpha.6';
+export const version = '3.11.0-alpha.1';

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

@@ -54,11 +54,11 @@ export declare function getCostDetails(o: GlobalCLIOptions & CLIOptionsFromAoPar
     message: string;
     tokenCost: number;
     discounts: import("../../types/io.js").CostDiscount[];
-    returnedNameDetails?: (import("../../types/io.js").AoReturnedName & {
+    returnedNameDetails?: import("../../types/io.js").AoReturnedName & {
         basePrice: number;
-    }) | undefined;
-    fundingPlan?: import("../../types/io.js").AoFundingPlan | undefined;
-    wincQty?: string | undefined;
+    };
+    fundingPlan?: import("../../types/io.js").AoFundingPlan;
+    wincQty?: string;
 }>;
 export declare function getPrimaryName(o: AddressAndNameCLIOptions): Promise<import("../../types/common.js").AoPrimaryName>;
 export declare function getGatewayVaults(o: PaginationAddressCLIOptions): Promise<import("../../types/io.js").PaginationResult<AoGatewayVault> | {

package/lib/types/common/http.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="node" />
 import { HTTPClient } from '../types/index.js';
 import { ILogger } from './logger.js';
 export declare class AxiosHTTPService implements HTTPClient {

package/lib/types/common/wayfinder/routers/fixed.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="node" />
 /**
  * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
  *

package/lib/types/common/wayfinder/routers/priority.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="node" />
 /**
  * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
  *

package/lib/types/common/wayfinder/routers/random.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="node" />
 /**
  * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
  *

package/lib/types/common/wayfinder/routers/simple-cache.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="node" />
 /**
  * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
  *

package/lib/types/common/wayfinder/wayfinder.d.ts

@@ -1,16 +1,23 @@
-/// <reference types="node" />
+/**
+ * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
 import { WayfinderRouter } from '../../types/wayfinder.js';
 type AnyFunction = (...args: [string, ...unknown[]]) => unknown;
 type WayfinderHttpClient<T extends AnyFunction> = T;
 export declare const arnsRegex: RegExp;
 export declare const txIdRegex: RegExp;
-/**
- * Cryptographically secure helper for randomness, does not support seeding
- * @param min - the minimum value
- * @param max - the maximum value
- * @returns a random integer between min and max
- */
-export declare const randomInt: (min: number, max: number) => number;
 /**
  * Core function to resolve a wayfinder url against a target gateway
  * @param originalUrl - the wayfinder url to resolve

package/lib/types/types/common.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="node" />
 /**
  * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
  *

package/lib/types/types/io.d.ts

@@ -301,7 +301,7 @@ export type AoRedelegateStakeParams = {
 export declare const validIntents: readonly ["Buy-Name", "Buy-Record", "Extend-Lease", "Increase-Undername-Limit", "Upgrade-Name", "Primary-Name-Request"];
 export declare const intentsUsingYears: readonly ["Buy-Record", "Buy-Name", "Extend-Lease"];
 export type Intent = (typeof validIntents)[number];
-export declare const isValidIntent: (intent: string) => intent is "Buy-Name" | "Buy-Record" | "Extend-Lease" | "Increase-Undername-Limit" | "Upgrade-Name" | "Primary-Name-Request";
+export declare const isValidIntent: (intent: string) => intent is Intent;
 export type AoTokenCostParams = {
     intent: Intent;
     type?: 'permabuy' | 'lease';
@@ -312,7 +312,7 @@ export type AoTokenCostParams = {
 };
 export declare const fundFromOptions: readonly ["balance", "stakes", "any", "turbo"];
 export type FundFrom = (typeof fundFromOptions)[number];
-export declare const isValidFundFrom: (fundFrom: string) => fundFrom is "balance" | "stakes" | "any" | "turbo";
+export declare const isValidFundFrom: (fundFrom: string) => fundFrom is FundFrom;
 export type AoGetCostDetailsParams = AoTokenCostParams & {
     fundFrom?: FundFrom;
 };

package/lib/types/types/token.d.ts

@@ -1,5 +1,3 @@
-/// <reference types="node" />
-/// <reference types="node" />
 interface Equatable<T> {
     equals(other: T): boolean;
 }

package/lib/types/types/wayfinder.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="node" />
 /**
  * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
  *

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

@@ -1,5 +1,3 @@
-/// <reference types="node" />
-/// <reference types="node" />
 export declare function fromB64Url(str: string): Buffer;
 export declare function toB64Url(buffer: Buffer): string;
 export declare function sha256B64Url(input: Buffer): string;

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

@@ -0,0 +1,7 @@
+/**
+ * Cryptographically secure helper for randomness, does not support seeding
+ * @param min - the minimum value
+ * @param max - the maximum value
+ * @returns a random integer between min and max
+ */
+export declare const randomInt: (min: number, max: number) => number;

package/lib/types/version.d.ts

@@ -13,4 +13,4 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-export declare const version = "3.10.0-alpha.5";
+export declare const version = "3.10.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ar.io/sdk",
-  "version": "3.10.0-alpha.6",
+  "version": "3.11.0-alpha.1",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ar-io/ar-io-sdk.git"
@@ -72,7 +72,7 @@
     "test:cjs": "yarn build:cjs && yarn link && cd ./tests/e2e/cjs && yarn && yarn test",
     "test:esm": "yarn build:esm && yarn link && cd ./tests/e2e/esm && yarn && yarn test",
     "test:web": "yarn build:esm && yarn link && cd ./tests/e2e/web && yarn && yarn test",
-    "test:unit": "node --import=./register.mjs --test --test-reporter=spec 'src/**/*.test.ts'",
+    "test:unit": "node --import=./register.mjs --test --test-reporter=spec --enable-source-maps --trace-warnings 'src/**/*.test.ts'",
     "test:link": "yarn build && yarn link",
     "test:e2e": "yarn test:cjs && yarn test:esm && yarn test:web",
     "test:integration": "yarn build:esm && yarn link && cd ./tests/integration && yarn && yarn test",
@@ -91,6 +91,7 @@
     "@semantic-release/exec": "^6.0.3",
     "@semantic-release/git": "^10.0.1",
     "@semantic-release/npm": "^11.0.3",
+    "@swc/core": "^1.11.22",
     "@trivago/prettier-plugin-sort-imports": "^4.2.0",
     "@types/node": "^22.14.1",
     "@types/prompts": "^2.4.9",
@@ -134,7 +135,6 @@
     "eventemitter3": "^5.0.1",
     "plimit-lit": "^3.0.1",
     "prompts": "^2.4.2",
-    "uuid": "^11.1.0",
     "winston": "^3.13.0",
     "zod": "^3.23.8"
   },