@ar.io/wayfinder-core 1.0.7 → 1.1.0

package/dist/version.d.ts

@@ -14,5 +14,5 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-export declare const WAYFINDER_CORE_VERSION = "v1.0.7";
+export declare const WAYFINDER_CORE_VERSION = "v1.1.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -14,4 +14,4 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-export const WAYFINDER_CORE_VERSION = 'v1.0.7';
+export const WAYFINDER_CORE_VERSION = 'v1.1.0';

package/dist/wayfinder.d.ts

@@ -18,7 +18,7 @@ import { type Tracer } from '@opentelemetry/api';
 import { NodeTracerProvider } from '@opentelemetry/sdk-trace-node';
 import { WebTracerProvider } from '@opentelemetry/sdk-trace-web';
 import { WayfinderEmitter } from './emitter.js';
-import type { GatewaysProvider, Logger, TelemetrySettings, VerificationStrategy, WayfinderFetch, WayfinderOptions, WayfinderURL, WayfinderURLParams } from './types.js';
+import type { GatewaysProvider, Logger, RoutingStrategy, TelemetrySettings, VerificationStrategy, WayfinderOptions, WayfinderURL, WayfinderURLParams } from './types.js';
 export declare const wayfinderRequestHeaders: ({ traceId, }: {
     traceId?: string;
 }) => {
@@ -124,70 +124,6 @@ export declare class Wayfinder {
      * OpenTelemetry tracer instance
      */
     protected tracer?: Tracer;
-    /**
-     * A helper function that resolves a provided url to a target gateway.
-     *
-     * Note: no verification is done when calling this function.
-     * It just generates the redirect url based on the routing strategy.
-     * In order to verify the data, you must use the `request` function or request the data and
-     * verify it yourself via the `verifyData` function.
-     *
-     * @example
-     * const { resolveUrl } = new Wayfinder();
-     *
-     * // returns the redirected URL based on the routing strategy and the original url
-     * const redirectUrl = await resolveUrl({
-     *   originalUrl: 'https://arweave.net/<txId>',
-     * });
-     *
-     * // returns the redirected URL based on the routing strategy and the provided arns name
-     * const redirectUrl = await resolveUrl({
-     *   arnsName: 'ardrive',
-     * });
-     *
-     * // returns the redirected URL based on the routing strategy and the provided wayfinder url
-     * const redirectUrl = await resolveUrl({
-     *   wayfinderUrl: 'ar://1234567890',
-     * });
-     *
-     * // returns the redirected URL based on the routing strategy and the provided txId
-     * const redirectUrl = await resolveUrl({
-     *   txId: '1234567890',
-     * });
-     *
-     * window.open(redirectUrl.toString(), '_blank');
-     */
-    readonly resolveUrl: (params: WayfinderURLParams) => Promise<URL>;
-    /**
-     * A wrapped fetch function that supports ar:// protocol. If a verification strategy is provided,
-     * the request will be verified and events will be emitted as the request is processed.
-     *
-     * @example
-     * const wayfinder = new Wayfinder({
-     *   verificationStrategy: new HashVerificationStrategy({
-     *     trustedGateways: [new URL('https://permagate.io')],
-     *   }),
-     * })
-     *
-     * // request an arns name
-     * const response = await wayfinder.request('ar://ardrive')
-     *
-     * // request a transaction id
-     * const response = await wayfinder.request('ar://1234567890')
-     *
-     * // Set strict mode to true to make verification blocking
-     * const wayfinder = new Wayfinder({
-     *   strict: true,
-     * });
-     *
-     * // This will throw an error if verification fails
-     * try {
-     *   const response = await wayfinder.request('ar://1234567890');
-     * } catch (error) {
-     *   console.error('Verification failed', error);
-     * }
-     */
-    request: WayfinderFetch;
     /**
      * The logger used by this Wayfinder instance
      */
@@ -256,5 +192,131 @@ export declare class Wayfinder {
      * @param options - Wayfinder configuration options
      */
     constructor({ logger, gatewaysProvider, verificationSettings, routingSettings, telemetrySettings, }?: WayfinderOptions);
+    /**
+     * Sets the routing strategy to use for routing requests.
+     *
+     * @example
+     * const wayfinder = new Wayfinder();
+     * wayfinder.setRoutingStrategy(new RandomRoutingStrategy());
+     *
+     * @param strategy - The routing strategy to use
+     */
+    setRoutingStrategy(strategy: RoutingStrategy): void;
+    /**
+     * Sets the verification strategy to use for verifying requests.
+     *
+     * @example
+     * const wayfinder = new Wayfinder();
+     * wayfinder.setVerificationStrategy(new HashVerificationStrategy({
+     *   trustedGateways: [new URL('https://permagate.io')],
+     * }));
+     *
+     * @param strategy - The verification strategy to use
+     */
+    setVerificationStrategy(strategy: VerificationStrategy): void;
+    /**
+     * Disables verification for requests.
+     *
+     * @example
+     * const wayfinder = new Wayfinder({
+     *   verificationSettings: {
+     *     enabled: true,
+     *   },
+     * });
+     *
+     * // disable verification
+     * wayfinder.disableVerification();
+     *
+     * // enable verification with strict mode
+     * wayfinder.enableVerification({ strict: true });
+     */
+    disableVerification(): void;
+    /**
+     * Enables verification for requests.
+     *
+     * @example
+     * const wayfinder = new Wayfinder({
+     *   verificationSettings: {
+     *     enabled: false,
+     *   },
+     * });
+     *
+     * // enable verification with strict mode
+     * wayfinder.enableVerification({ strict: true });
+     *
+     * // enable verification without strict mode
+     * wayfinder.enableVerification();
+     * @param strict - Whether to make verification strict
+     */
+    enableVerification({ strict, }?: {
+        strict?: boolean;
+    }): void;
+    /**
+     * A wrapped fetch function that supports ar:// protocol. If a verification strategy is provided,
+     * the request will be verified and events will be emitted as the request is processed.
+     *
+     * @example
+     * const wayfinder = new Wayfinder({
+     *   verificationStrategy: new HashVerificationStrategy({
+     *     trustedGateways: [new URL('https://permagate.io')],
+     *   }),
+     * })
+     *
+     * // request an arns name
+     * const response = await wayfinder.request('ar://ardrive')
+     *
+     * // request a transaction id
+     * const response = await wayfinder.request('ar://1234567890')
+     *
+     * // Set strict mode to true to make verification blocking
+     * const wayfinder = new Wayfinder({
+     *   strict: true,
+     * });
+     *
+     * // This will throw an error if verification fails
+     * try {
+     *   const response = await wayfinder.request('ar://1234567890');
+     * } catch (error) {
+     *   console.error('Verification failed', error);
+     * }
+     */
+    request(input: URL | RequestInfo, init?: RequestInit & {
+        verificationSettings?: NonNullable<WayfinderOptions['verificationSettings']>;
+        routingSettings?: NonNullable<WayfinderOptions['routingSettings']>;
+    }): Promise<Response>;
+    /**
+     * A helper function that resolves a provided url to a target gateway using the current routing strategy.
+     *
+     * Note: no verification is done when calling this function.
+     * It just generates the redirect url based on the routing strategy.
+     * In order to verify the data, you must use the `request` function or request the data and
+     * verify it yourself via the `verifyData` function.
+     *
+     * @example
+     * const { resolveUrl } = new Wayfinder();
+     *
+     * // returns the redirected URL based on the routing strategy and the original url
+     * const redirectUrl = await resolveUrl({
+     *   originalUrl: 'https://arweave.net/<txId>',
+     * });
+     *
+     * // returns the redirected URL based on the routing strategy and the provided arns name
+     * const redirectUrl = await resolveUrl({
+     *   arnsName: 'ardrive',
+     * });
+     *
+     * // returns the redirected URL based on the routing strategy and the provided wayfinder url
+     * const redirectUrl = await resolveUrl({
+     *   wayfinderUrl: 'ar://1234567890',
+     * });
+     *
+     * // returns the redirected URL based on the routing strategy and the provided txId
+     * const redirectUrl = await resolveUrl({
+     *   txId: '1234567890',
+     * });
+     *
+     * window.open(redirectUrl.toString(), '_blank');
+     */
+    resolveUrl(params: WayfinderURLParams): Promise<URL>;
 }
 //# sourceMappingURL=wayfinder.d.ts.map

package/dist/wayfinder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wayfinder.d.ts","sourceRoot":"","sources":["../src/wayfinder.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"wayfinder.d.ts","sourceRoot":"","sources":["../src/wayfinder.ts"],"names":[],"mappings":"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"}

package/dist/wayfinder.js

@@ -449,70 +449,6 @@ export class Wayfinder {
      * OpenTelemetry tracer instance
      */
     tracer;
-    /**
-     * A helper function that resolves a provided url to a target gateway.
-     *
-     * Note: no verification is done when calling this function.
-     * It just generates the redirect url based on the routing strategy.
-     * In order to verify the data, you must use the `request` function or request the data and
-     * verify it yourself via the `verifyData` function.
-     *
-     * @example
-     * const { resolveUrl } = new Wayfinder();
-     *
-     * // returns the redirected URL based on the routing strategy and the original url
-     * const redirectUrl = await resolveUrl({
-     *   originalUrl: 'https://arweave.net/<txId>',
-     * });
-     *
-     * // returns the redirected URL based on the routing strategy and the provided arns name
-     * const redirectUrl = await resolveUrl({
-     *   arnsName: 'ardrive',
-     * });
-     *
-     * // returns the redirected URL based on the routing strategy and the provided wayfinder url
-     * const redirectUrl = await resolveUrl({
-     *   wayfinderUrl: 'ar://1234567890',
-     * });
-     *
-     * // returns the redirected URL based on the routing strategy and the provided txId
-     * const redirectUrl = await resolveUrl({
-     *   txId: '1234567890',
-     * });
-     *
-     * window.open(redirectUrl.toString(), '_blank');
-     */
-    resolveUrl;
-    /**
-     * A wrapped fetch function that supports ar:// protocol. If a verification strategy is provided,
-     * the request will be verified and events will be emitted as the request is processed.
-     *
-     * @example
-     * const wayfinder = new Wayfinder({
-     *   verificationStrategy: new HashVerificationStrategy({
-     *     trustedGateways: [new URL('https://permagate.io')],
-     *   }),
-     * })
-     *
-     * // request an arns name
-     * const response = await wayfinder.request('ar://ardrive')
-     *
-     * // request a transaction id
-     * const response = await wayfinder.request('ar://1234567890')
-     *
-     * // Set strict mode to true to make verification blocking
-     * const wayfinder = new Wayfinder({
-     *   strict: true,
-     * });
-     *
-     * // This will throw an error if verification fails
-     * try {
-     *   const response = await wayfinder.request('ar://1234567890');
-     * } catch (error) {
-     *   console.error('Verification failed', error);
-     * }
-     */
-    request;
     /**
      * The logger used by this Wayfinder instance
      */
@@ -630,56 +566,10 @@ export class Wayfinder {
         const { tracerProvider, tracer } = initTelemetry(this.telemetrySettings) ?? {};
         this.tracerProvider = tracerProvider;
         this.tracer = tracer;
-        this.request = wayfinderFetch({
-            logger: this.logger,
-            emitter: this.emitter,
-            gatewaysProvider: this.gatewaysProvider,
-            routingSettings: this.routingSettings,
-            verificationSettings: this.verificationSettings,
-            tracer: this.tracer,
-        });
-        this.resolveUrl = async (params) => {
-            // create a span for the resolveUrl function
-            const resolveUrlSpan = this.tracer?.startSpan('wayfinder.resolveUrl', {
-                attributes: {
-                    ...Object.entries(params).reduce((acc, [key, value]) => ({
-                        ...acc,
-                        [`params.${key}`]: value,
-                        gatewaysProvider: this.gatewaysProvider.constructor.name,
-                        'routing.strategy': this.routingSettings.strategy?.constructor.name,
-                    }), {}),
-                },
-            });
-            // parse url span that uses the resolveUrl as the parent span
-            const wayfinderUrl = createWayfinderUrl(params);
-            resolveUrlSpan?.setAttribute('wayfinderUrl', wayfinderUrl);
-            // extract routing information from the original URL
-            const { subdomain, path } = extractRoutingInfo(wayfinderUrl);
-            resolveUrlSpan?.setAttribute('subdomain', subdomain);
-            resolveUrlSpan?.setAttribute('path', path);
-            const gateways = await this.gatewaysProvider.getGateways();
-            resolveUrlSpan?.setAttribute('gatewaysCount', gateways.length);
-            const selectedGateway = await this.routingSettings.strategy.selectGateway({
-                gateways,
-                path,
-                subdomain,
-            });
-            resolveUrlSpan?.setAttribute('selectedGateway', selectedGateway.toString());
-            const constructedGatewayUrl = constructGatewayUrl({
-                selectedGateway,
-                subdomain,
-                path,
-            });
-            resolveUrlSpan?.setAttribute('constructedGatewayUrl', constructedGatewayUrl.toString());
-            resolveUrlSpan?.end();
-            // return the constructed gateway url
-            return constructedGatewayUrl;
-        };
         // send an event that the wayfinder is initialized
         this.tracer
             ?.startSpan('wayfinder.initialized', {
             attributes: {
-                gatewaysProvider: this.gatewaysProvider.constructor.name,
                 'verification.strategy': this.verificationSettings.strategy?.constructor.name,
                 'verification.enabled': this.verificationSettings.enabled,
                 'verification.trustedGateways': this.verificationSettings.strategy?.trustedGateways.map((gateway) => gateway.toString()),
@@ -690,4 +580,175 @@ export class Wayfinder {
         })
             .end();
     }
+    /**
+     * Sets the routing strategy to use for routing requests.
+     *
+     * @example
+     * const wayfinder = new Wayfinder();
+     * wayfinder.setRoutingStrategy(new RandomRoutingStrategy());
+     *
+     * @param strategy - The routing strategy to use
+     */
+    setRoutingStrategy(strategy) {
+        this.routingSettings.strategy = strategy;
+    }
+    /**
+     * Sets the verification strategy to use for verifying requests.
+     *
+     * @example
+     * const wayfinder = new Wayfinder();
+     * wayfinder.setVerificationStrategy(new HashVerificationStrategy({
+     *   trustedGateways: [new URL('https://permagate.io')],
+     * }));
+     *
+     * @param strategy - The verification strategy to use
+     */
+    setVerificationStrategy(strategy) {
+        this.verificationSettings.strategy = strategy;
+    }
+    /**
+     * Disables verification for requests.
+     *
+     * @example
+     * const wayfinder = new Wayfinder({
+     *   verificationSettings: {
+     *     enabled: true,
+     *   },
+     * });
+     *
+     * // disable verification
+     * wayfinder.disableVerification();
+     *
+     * // enable verification with strict mode
+     * wayfinder.enableVerification({ strict: true });
+     */
+    disableVerification() {
+        this.verificationSettings.enabled = false;
+    }
+    /**
+     * Enables verification for requests.
+     *
+     * @example
+     * const wayfinder = new Wayfinder({
+     *   verificationSettings: {
+     *     enabled: false,
+     *   },
+     * });
+     *
+     * // enable verification with strict mode
+     * wayfinder.enableVerification({ strict: true });
+     *
+     * // enable verification without strict mode
+     * wayfinder.enableVerification();
+     * @param strict - Whether to make verification strict
+     */
+    enableVerification({ strict = false, } = {}) {
+        this.verificationSettings.enabled = true;
+        this.verificationSettings.strict = strict;
+    }
+    /**
+     * A wrapped fetch function that supports ar:// protocol. If a verification strategy is provided,
+     * the request will be verified and events will be emitted as the request is processed.
+     *
+     * @example
+     * const wayfinder = new Wayfinder({
+     *   verificationStrategy: new HashVerificationStrategy({
+     *     trustedGateways: [new URL('https://permagate.io')],
+     *   }),
+     * })
+     *
+     * // request an arns name
+     * const response = await wayfinder.request('ar://ardrive')
+     *
+     * // request a transaction id
+     * const response = await wayfinder.request('ar://1234567890')
+     *
+     * // Set strict mode to true to make verification blocking
+     * const wayfinder = new Wayfinder({
+     *   strict: true,
+     * });
+     *
+     * // This will throw an error if verification fails
+     * try {
+     *   const response = await wayfinder.request('ar://1234567890');
+     * } catch (error) {
+     *   console.error('Verification failed', error);
+     * }
+     */
+    request(input, init) {
+        return wayfinderFetch({
+            logger: this.logger,
+            gatewaysProvider: this.gatewaysProvider,
+            emitter: this.emitter,
+            routingSettings: this.routingSettings,
+            verificationSettings: this.verificationSettings,
+            tracer: this.tracer,
+        })(input, init);
+    }
+    /**
+     * A helper function that resolves a provided url to a target gateway using the current routing strategy.
+     *
+     * Note: no verification is done when calling this function.
+     * It just generates the redirect url based on the routing strategy.
+     * In order to verify the data, you must use the `request` function or request the data and
+     * verify it yourself via the `verifyData` function.
+     *
+     * @example
+     * const { resolveUrl } = new Wayfinder();
+     *
+     * // returns the redirected URL based on the routing strategy and the original url
+     * const redirectUrl = await resolveUrl({
+     *   originalUrl: 'https://arweave.net/<txId>',
+     * });
+     *
+     * // returns the redirected URL based on the routing strategy and the provided arns name
+     * const redirectUrl = await resolveUrl({
+     *   arnsName: 'ardrive',
+     * });
+     *
+     * // returns the redirected URL based on the routing strategy and the provided wayfinder url
+     * const redirectUrl = await resolveUrl({
+     *   wayfinderUrl: 'ar://1234567890',
+     * });
+     *
+     * // returns the redirected URL based on the routing strategy and the provided txId
+     * const redirectUrl = await resolveUrl({
+     *   txId: '1234567890',
+     * });
+     *
+     * window.open(redirectUrl.toString(), '_blank');
+     */
+    async resolveUrl(params) {
+        // create a span for the resolveUrl function
+        const resolveUrlSpan = this.tracer?.startSpan('wayfinder.resolveUrl', {
+            attributes: {
+                ...Object.entries(params).reduce((acc, [key, value]) => ({
+                    ...acc,
+                    [`params.${key}`]: value,
+                    'routing.strategy': this.routingSettings.strategy?.constructor.name,
+                }), {}),
+            },
+        });
+        // parse url span that uses the resolveUrl as the parent span
+        const wayfinderUrl = createWayfinderUrl(params);
+        resolveUrlSpan?.setAttribute('wayfinderUrl', wayfinderUrl);
+        // extract routing information from the original URL
+        const { subdomain, path } = extractRoutingInfo(wayfinderUrl);
+        resolveUrlSpan?.setAttribute('subdomain', subdomain);
+        resolveUrlSpan?.setAttribute('path', path);
+        const selectedGateway = await this.routingSettings.strategy.selectGateway({
+            path,
+            subdomain,
+        });
+        resolveUrlSpan?.setAttribute('selectedGateway', selectedGateway.toString());
+        const constructedGatewayUrl = constructGatewayUrl({
+            selectedGateway,
+            subdomain,
+            path,
+        });
+        resolveUrlSpan?.setAttribute('constructedGatewayUrl', constructedGatewayUrl.toString());
+        resolveUrlSpan?.end();
+        // return the constructed gateway url
+        return constructedGatewayUrl;
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ar.io/wayfinder-core",
-  "version": "1.0.7",
+  "version": "1.1.0",
   "description": "WayFinder core library for intelligently routing to optimal AR.IO gateways",
   "main": "dist/index.js",
   "module": "dist/index.js",