@ar.io/wayfinder-core 0.0.4-alpha.0 → 0.0.4-alpha.1

package/dist/wayfinder.d.ts

@@ -118,18 +118,12 @@ export declare function sandboxFromId(id: string): string;
  * @param resolveUrl - the function to construct the redirect url for ar:// requests
  * @returns a wrapped fetch function that supports ar:// protocol and always returns Response
  */
-export declare const wayfinderRequest: ({ getGateways, resolveUrl, verifyData, selectGateway, emitter, logger, strict, }: {
-    getGateways: GatewaysProvider["getGateways"];
-    selectGateway: RoutingStrategy["selectGateway"];
-    resolveUrl: (params: {
-        originalUrl: string;
-        selectedGateway: URL;
-        logger?: Logger;
-    }) => URL;
-    verifyData?: VerificationStrategy["verifyData"];
+export declare const wayfinderFetch: ({ emitter, logger, gatewaysProvider, verificationSettings, routingSettings, }: {
     logger?: Logger;
     emitter?: WayfinderEmitter;
-    strict?: boolean;
+    gatewaysProvider: GatewaysProvider;
+    verificationSettings: NonNullable<WayfinderOptions["verificationSettings"]>;
+    routingSettings: NonNullable<WayfinderOptions["routingSettings"]>;
 }) => (input: URL | RequestInfo, init?: RequestInit) => Promise<Response>;
 /**
  * Configuration options for the Wayfinder
@@ -149,10 +143,18 @@ export interface WayfinderOptions {
      */
     verificationSettings?: {
         /**
-         * Whether verification is enabled. If false, verification will be skipped for all requests.
+         * Whether verification is enabled. If false, verification will be skipped for all requests. If true, strategy must be provided.
          * @default true
          */
         enabled?: boolean;
+        /**
+         * The events to use for verification
+         */
+        events?: WayfinderVerificationEventArgs | undefined;
+        /**
+         * The verification strategy to use for verifying data
+         */
+        strategy: VerificationStrategy;
         /**
          * Whether verification should be strict (blocking)
          * If true, verification failures will cause requests to fail
@@ -160,27 +162,19 @@ export interface WayfinderOptions {
          * @default false
          */
         strict?: boolean;
-        /**
-         * The events to use for verification
-         */
-        events?: WayfinderVerificationEventArgs;
-        /**
-         * The verification strategy to use for verifying data
-         */
-        strategy?: VerificationStrategy;
     };
     /**
      * The routing settings to use for routing requests
      */
     routingSettings?: {
-        /**
-         * The routing strategy to use for routing requests
-         */
-        strategy?: RoutingStrategy;
         /**
          * The events to use for routing requests
          */
         events?: WayfinderRoutingEventArgs;
+        /**
+         * The routing strategy to use for routing requests
+         */
+        strategy: RoutingStrategy;
     };
 }
 /**
@@ -200,13 +194,15 @@ export declare class Wayfinder {
      */
     readonly gatewaysProvider: GatewaysProvider;
     /**
-     * The routing strategy to use when routing requests.
+     * The routing settings to use when routing requests.
+     * This includes the routing strategy and event handlers for routing events.
+     * If not provided, the default FastestPingRoutingStrategy will be used.
      */
-    readonly routingStrategy: RoutingStrategy;
+    readonly routingSettings: NonNullable<WayfinderOptions['routingSettings']>;
     /**
-     * The verification strategy to use when verifying data.
+     * The verification settings to use when verifying data.
      */
-    readonly verificationStrategy: VerificationStrategy;
+    readonly verificationSettings: WayfinderOptions['verificationSettings'];
     /**
      * A helper function that resolves the redirect url for ar:// requests to a target gateway.
      *
@@ -255,23 +251,11 @@ export declare class Wayfinder {
      *   console.error('Verification failed', error);
      * }
      */
-    readonly request: WayfinderHttpClient;
-    /**
-     * The function that verifies the data hash for a given transaction id.
-     *
-     * @example
-     * const wayfinder = new Wayfinder({
-     *   verifyData: (data, txId) => {
-     *     // some custom verification logic
-     *     return true;
-     *   },
-     * });
-     */
-    readonly verifyData: VerificationStrategy['verifyData'];
+    request: WayfinderHttpClient;
     /**
      * The logger used by this Wayfinder instance
      */
-    readonly logger: Logger;
+    protected logger: Logger;
     /**
      * The event emitter for wayfinder that emits routing and verification events.
      *
@@ -331,7 +315,8 @@ export declare class Wayfinder {
      * The constructor for the wayfinder
      * @param options - Wayfinder configuration options
      */
-    constructor({ logger, gatewaysProvider, verificationSettings, routingSettings, }: WayfinderOptions);
+    constructor({ logger, gatewaysProvider, // forcing it to be required to avoid making ar-io-sdk a dependency
+    verificationSettings, routingSettings, }: WayfinderOptions);
 }
 export {};
 //# 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

@@ -198,12 +198,9 @@ export function sandboxFromId(id) {
  * @param resolveUrl - the function to construct the redirect url for ar:// requests
  * @returns a wrapped fetch function that supports ar:// protocol and always returns Response
  */
-export const wayfinderRequest = ({ getGateways, resolveUrl, verifyData, selectGateway, emitter = new WayfinderEmitter(), logger = defaultLogger, strict = false, }) => {
+export const wayfinderFetch = ({ emitter = new WayfinderEmitter(), logger = defaultLogger, gatewaysProvider, verificationSettings, routingSettings, }) => {
     return async (input, init) => {
         const url = input instanceof URL ? input.toString() : input.toString();
-        console.log('URL', {
-            url,
-        });
         if (!url.toString().startsWith('ar://')) {
             logger?.debug('URL is not a wayfinder url, skipping routing', {
                 input,
@@ -221,17 +218,20 @@ export const wayfinderRequest = ({ getGateways, resolveUrl, verifyData, selectGa
         for (let i = 0; i < maxRetries; i++) {
             try {
                 // select the target gateway
-                const selectedGateway = await selectGateway({
-                    gateways: await getGateways(),
+                const selectedGateway = await routingSettings.strategy?.selectGateway({
+                    gateways: await gatewaysProvider.getGateways(),
                     path: url.split('/').slice(1).join('/'), // everything after the first /
                     subdomain: '',
                 });
+                if (!selectedGateway) {
+                    throw new Error('Failed to select a gateway');
+                }
                 logger?.debug('Selected gateway', {
                     originalUrl: url,
-                    selectedGateway: selectedGateway.toString(),
+                    selectedGateway: selectedGateway?.toString(),
                 });
                 // route the request to the target gateway
-                const redirectUrl = resolveUrl({
+                const redirectUrl = await resolveWayfinderUrl({
                     originalUrl: url.toString(),
                     selectedGateway,
                     logger,
@@ -258,7 +258,8 @@ export const wayfinderRequest = ({ getGateways, resolveUrl, verifyData, selectGa
                 });
                 // only verify data if the redirect url is different from the original url
                 if (redirectUrl.toString() !== url) {
-                    if (verifyData) {
+                    if (verificationSettings.enabled &&
+                        verificationSettings.strategy?.verifyData) {
                         const headers = response.headers;
                         // transaction id is either in the response headers or the path of the request as the first parameter
                         const txId = headers.get('x-arns-resolved-id') ??
@@ -285,10 +286,10 @@ export const wayfinderRequest = ({ getGateways, resolveUrl, verifyData, selectGa
                             const newClientStream = tapAndVerifyReadableStream({
                                 originalStream: response.body,
                                 contentLength,
-                                verifyData,
+                                verifyData: verificationSettings.strategy?.verifyData.bind(verificationSettings.strategy),
                                 txId,
                                 emitter,
-                                strict,
+                                strict: verificationSettings.strict,
                             });
                             return new Response(newClientStream, {
                                 status: response.status,
@@ -347,13 +348,15 @@ export class Wayfinder {
      */
     gatewaysProvider;
     /**
-     * The routing strategy to use when routing requests.
+     * The routing settings to use when routing requests.
+     * This includes the routing strategy and event handlers for routing events.
+     * If not provided, the default FastestPingRoutingStrategy will be used.
      */
-    routingStrategy;
+    routingSettings;
     /**
-     * The verification strategy to use when verifying data.
+     * The verification settings to use when verifying data.
      */
-    verificationStrategy;
+    verificationSettings;
     /**
      * A helper function that resolves the redirect url for ar:// requests to a target gateway.
      *
@@ -400,18 +403,6 @@ export class Wayfinder {
      * }
      */
     request;
-    /**
-     * The function that verifies the data hash for a given transaction id.
-     *
-     * @example
-     * const wayfinder = new Wayfinder({
-     *   verifyData: (data, txId) => {
-     *     // some custom verification logic
-     *     return true;
-     *   },
-     * });
-     */
-    verifyData;
     /**
      * The logger used by this Wayfinder instance
      */
@@ -475,61 +466,64 @@ export class Wayfinder {
      * The constructor for the wayfinder
      * @param options - Wayfinder configuration options
      */
-    constructor({ logger = defaultLogger, gatewaysProvider, verificationSettings = {
-        enabled: true,
-        strict: false,
-        strategy: new HashVerificationStrategy({
-            trustedGateways: [new URL('https://permagate.io')],
-        }),
-        events: {
-            onVerificationProgress: (event) => {
-                logger.debug('Verification progress!', event);
-            },
-            onVerificationSucceeded: (event) => {
-                logger.debug('Verification succeeded!', event);
-            },
-            onVerificationFailed: (event) => {
-                logger.error('Verification failed!', event);
-            },
-        },
-    }, routingSettings = {
-        strategy: new FastestPingRoutingStrategy({
-            timeoutMs: 1000,
-            logger,
-        }),
-        events: {
-            onRoutingStarted: (event) => {
-                logger.debug('Routing started!', event);
-            },
-            onRoutingSkipped: (event) => {
-                logger.debug('Routing skipped!', event);
-            },
-            onRoutingSucceeded: (event) => {
-                logger.debug('Routing succeeded!', event);
-            },
-        },
-    }, }) {
+    constructor({ logger = defaultLogger, gatewaysProvider, // forcing it to be required to avoid making ar-io-sdk a dependency
+    verificationSettings, routingSettings, }) {
         this.logger = logger;
-        this.routingStrategy =
-            routingSettings.strategy ??
-                new FastestPingRoutingStrategy({
-                    timeoutMs: 1000,
-                    logger,
-                });
-        this.verificationStrategy =
-            verificationSettings.strategy ??
-                new HashVerificationStrategy({
-                    trustedGateways: [new URL('https://permagate.io')],
-                });
         this.gatewaysProvider = gatewaysProvider;
         this.emitter = new WayfinderEmitter({
-            verification: verificationSettings.events,
-            routing: routingSettings.events,
+            verification: verificationSettings?.events,
+            routing: routingSettings?.events,
+        });
+        // default verification settings
+        this.verificationSettings = {
+            enabled: verificationSettings?.enabled ??
+                verificationSettings?.strategy !== undefined,
+            strategy: new HashVerificationStrategy({
+                trustedGateways: [new URL('https://permagate.io')],
+            }),
+            events: {
+                onVerificationFailed: (event) => {
+                    this.logger.error('Verification failed', event);
+                },
+                onVerificationSucceeded: (event) => {
+                    this.logger.info('Verification succeeded', event);
+                },
+                onVerificationProgress: (event) => {
+                    this.logger.info('Verification progress', event);
+                },
+            },
+            // overwrite the default settings with the provided ones
+            ...verificationSettings,
+        };
+        // default routing settings
+        this.routingSettings = {
+            strategy: new FastestPingRoutingStrategy({
+                timeoutMs: 1000,
+                logger: defaultLogger,
+            }),
+            events: {
+                onRoutingStarted: (event) => {
+                    this.logger.debug('Routing started', event);
+                },
+                onRoutingSkipped: (event) => {
+                    this.logger.debug('Routing skipped', event);
+                },
+                onRoutingSucceeded: (event) => {
+                    this.logger.debug('Routing succeeded', event);
+                },
+            },
+            // overwrite the default settings with the provided ones
+            ...routingSettings,
+        };
+        this.request = wayfinderFetch({
+            logger: this.logger,
+            emitter: this.emitter,
+            gatewaysProvider: this.gatewaysProvider,
+            routingSettings: this.routingSettings,
+            verificationSettings: this.verificationSettings,
         });
-        this.verifyData = this.verificationStrategy.verifyData.bind(this.verificationStrategy);
-        // top level function to easily resolve wayfinder urls using the routing strategy and gateways provider
         this.resolveUrl = async ({ originalUrl, logger = this.logger }) => {
-            const selectedGateway = await this.routingStrategy.selectGateway({
+            const selectedGateway = await this.routingSettings.strategy.selectGateway({
                 gateways: await this.gatewaysProvider.getGateways(),
             });
             return resolveWayfinderUrl({
@@ -538,16 +532,6 @@ export class Wayfinder {
                 logger,
             });
         };
-        // create a wayfinder request function with the routing strategy and gateways provider
-        this.request = wayfinderRequest({
-            getGateways: this.gatewaysProvider.getGateways.bind(this.gatewaysProvider),
-            verifyData: this.verifyData,
-            selectGateway: this.routingStrategy.selectGateway.bind(this.routingStrategy),
-            resolveUrl: resolveWayfinderUrl,
-            emitter: this.emitter,
-            logger: this.logger,
-            strict: verificationSettings.strict,
-        });
-        logger.debug(`Wayfinder initialized with ${this.routingStrategy.constructor.name} routing strategy`);
+        logger.debug(`Wayfinder initialized with ${this.routingSettings.strategy?.constructor.name} routing strategy`);
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ar.io/wayfinder-core",
-  "version": "0.0.4-alpha.0",
+  "version": "0.0.4-alpha.1",
   "description": "WayFinder core library for intelligently routing to optimal AR.IO gateways",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -41,11 +41,11 @@
     "build": "npm run clean && tsc",
     "clean": "rimraf dist",
     "test": "npm run test:unit",
-    "test:unit": "c8 tsx --enable-source-maps --trace-uncaught --trace-warnings --trace-deprecation src/**/*.test.ts",
-    "lint:fix": "biome check --write --unsafe",
-    "lint:check": "biome check --unsafe",
-    "format:fix": "biome format --write",
-    "format:check": "biome format"
+    "test:unit": "c8 tsx --test 'src/**/*.test.ts'",
+    "lint:fix": "biome check --write --unsafe --config-path=../../biome.json",
+    "lint:check": "biome check --unsafe --config-path=../../biome.json",
+    "format:fix": "biome format --write --config-path=../../biome.json",
+    "format:check": "biome format --config-path=../../biome.json"
   },
   "dependencies": {
     "@dha-team/arbundles": "^1.0.3",