@ar.io/wayfinder-core 0.0.5-alpha.2 → 0.0.5-alpha.4

package/dist/telemetry.d.ts

@@ -0,0 +1,33 @@
+/**
+ * WayFinder
+ * Copyright (C) 2022-2025 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 { Span, type Tracer } from '@opentelemetry/api';
+import type { GatewaysProvider, TelemetryConfig, WayfinderOptions } from './types.js';
+import { WayfinderEmitter } from './wayfinder.js';
+export declare const initTelemetry: (config?: TelemetryConfig) => Tracer | undefined;
+export declare const startRequestSpans: ({ originalUrl, emitter, tracer, verificationSettings, routingSettings, gatewaysProvider, }?: {
+    originalUrl?: string;
+    emitter?: WayfinderEmitter;
+    tracer?: Tracer;
+    verificationSettings?: WayfinderOptions["verificationSettings"];
+    routingSettings?: WayfinderOptions["routingSettings"];
+    gatewaysProvider?: GatewaysProvider;
+}) => {
+    parentSpan: Span | undefined;
+    routingSpan: Span | undefined;
+    verificationSpan: Span | undefined;
+};
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAGL,IAAI,EACJ,KAAK,MAAM,EAIZ,MAAM,oBAAoB,CAAC;AAc5B,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,eAAO,MAAM,aAAa,GACxB,SAAQ,eAIP,KACA,MAAM,GAAG,SAmCX,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,6FAO/B;IACD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oBAAoB,CAAC,EAAE,gBAAgB,CAAC,sBAAsB,CAAC,CAAC;IAChE,eAAe,CAAC,EAAE,gBAAgB,CAAC,iBAAiB,CAAC,CAAC;IACtD,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CAChC;;;;CA+DL,CAAC"}

package/dist/telemetry.js

@@ -0,0 +1,115 @@
+/**
+ * WayFinder
+ * Copyright (C) 2022-2025 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 { DiagConsoleLogger, DiagLogLevel, context, diag, trace, } from '@opentelemetry/api';
+import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';
+import { resourceFromAttributes } from '@opentelemetry/resources';
+import { BatchSpanProcessor, TraceIdRatioBasedSampler, } from '@opentelemetry/sdk-trace-base';
+import { NodeTracerProvider } from '@opentelemetry/sdk-trace-node';
+import { WebTracerProvider } from '@opentelemetry/sdk-trace-web';
+import { ATTR_SERVICE_NAME, ATTR_SERVICE_VERSION, } from '@opentelemetry/semantic-conventions';
+export const initTelemetry = (config = {
+    enabled: false,
+    sampleRate: 0,
+    serviceName: 'wayfinder-core',
+}) => {
+    if (config.enabled === false)
+        return undefined;
+    diag.setLogger(new DiagConsoleLogger(), DiagLogLevel.ERROR);
+    const exporter = new OTLPTraceExporter({
+        url: config.exporterUrl ?? 'https://api.honeycomb.io',
+        headers: {
+            'x-honeycomb-team': config.apiKey ?? '',
+            'x-honeycomb-dataset': 'wayfinder-dev',
+        },
+    });
+    const isBrowser = typeof window !== 'undefined';
+    const spanProcessor = new BatchSpanProcessor(exporter);
+    const sampler = new TraceIdRatioBasedSampler(config.sampleRate ?? 1);
+    const resource = resourceFromAttributes({
+        [ATTR_SERVICE_NAME]: 'wayfinder-core',
+        [ATTR_SERVICE_VERSION]: 'v0.0.5-alpha.5', // hard coded for now as importing JSON breaks wayfinder-react
+    });
+    const provider = isBrowser
+        ? new WebTracerProvider({
+            sampler,
+            resource,
+            spanProcessors: [spanProcessor],
+        })
+        : new NodeTracerProvider({
+            sampler,
+            resource,
+            spanProcessors: [spanProcessor],
+        });
+    provider.register();
+    return trace.getTracer('wayfinder-core');
+};
+export const startRequestSpans = ({ originalUrl, emitter, tracer, verificationSettings, routingSettings, gatewaysProvider, } = {}) => {
+    const activeContext = context.active();
+    const parentSpan = tracer?.startSpan('wayfinder.request', {
+        attributes: {
+            originalUrl: originalUrl ?? 'undefined',
+            'verification.enabled': verificationSettings?.enabled ?? false,
+            'verification.strategy': verificationSettings?.strategy?.constructor.name ?? 'undefined',
+            'verification.strict': verificationSettings?.strict ?? false,
+            'verification.trustedGateways': verificationSettings?.strategy?.trustedGateways
+                ?.map((gateway) => gateway.toString())
+                .join(','),
+            'routing.strategy': routingSettings?.strategy?.constructor.name ?? 'undefined',
+            gatewaysProvider: gatewaysProvider?.constructor.name,
+        },
+    }, activeContext);
+    const parentContext = parentSpan
+        ? trace.setSpan(context.active(), parentSpan)
+        : context.active();
+    let routingSpan;
+    let verificationSpan;
+    // add listeners on the emitter to the span
+    emitter?.on('routing-started', () => {
+        if (parentSpan && !routingSpan) {
+            context.with(parentContext, () => {
+                routingSpan = tracer?.startSpan('wayfinder.routing');
+            });
+        }
+    });
+    emitter?.on('routing-skipped', () => {
+        parentSpan?.setAttribute('routing.skipped', true);
+        routingSpan?.end();
+        parentSpan?.end();
+    });
+    emitter?.on('routing-succeeded', () => {
+        parentSpan?.setAttribute('routing.succeeded', true);
+        routingSpan?.end();
+    });
+    emitter?.on('verification-progress', () => {
+        if (parentSpan && !verificationSpan) {
+            context.with(parentContext, () => {
+                verificationSpan = tracer?.startSpan('wayfinder.verification');
+            });
+        }
+    });
+    emitter?.on('verification-succeeded', () => {
+        parentSpan?.setAttribute('verification.succeeded', true);
+        verificationSpan?.end();
+        parentSpan?.end();
+    });
+    emitter?.on('verification-failed', () => {
+        parentSpan?.setAttribute('verification.failed', true);
+        verificationSpan?.end();
+        parentSpan?.end();
+    });
+    return { parentSpan, routingSpan, verificationSpan };
+};

package/dist/types.d.ts

@@ -0,0 +1,170 @@
+/**
+ * WayFinder
+ * Copyright (C) 2022-2025 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 type { WayfinderEmitter } from './wayfinder.js';
+/**
+ * This is an extension of the fetch function that allows for overriding the verification and routing settings for a single request.
+ */
+export type WayfinderFetch = (input: URL | RequestInfo, init?: RequestInit & {
+    verificationSettings?: WayfinderOptions['verificationSettings'];
+    routingSettings?: WayfinderOptions['routingSettings'];
+}) => Promise<Response>;
+export type WayfinderEvent = {
+    'routing-started': {
+        originalUrl: string;
+    };
+    'routing-skipped': {
+        originalUrl: string;
+    };
+    'routing-succeeded': {
+        originalUrl: string;
+        selectedGateway: string;
+        redirectUrl: string;
+    };
+    'routing-failed': Error;
+    'verification-succeeded': {
+        txId: string;
+    };
+    'verification-failed': Error;
+    'verification-skipped': {
+        originalUrl: string;
+    };
+    'verification-progress': {
+        txId: string;
+        processedBytes: number;
+        totalBytes: number;
+    };
+};
+/**
+ * Simple logger interface that Wayfinder will use
+ * This allows users to provide their own logger implementation
+ */
+export interface Logger {
+    debug: (message: string, ...args: any[]) => void;
+    info: (message: string, ...args: any[]) => void;
+    warn: (message: string, ...args: any[]) => void;
+    error: (message: string, ...args: any[]) => void;
+}
+export interface WayfinderRoutingEventArgs {
+    onRoutingStarted?: (payload: WayfinderEvent['routing-started']) => void;
+    onRoutingSkipped?: (payload: WayfinderEvent['routing-skipped']) => void;
+    onRoutingSucceeded?: (payload: WayfinderEvent['routing-succeeded']) => void;
+}
+export interface WayfinderVerificationEventArgs {
+    onVerificationSucceeded?: (payload: WayfinderEvent['verification-succeeded']) => void;
+    onVerificationFailed?: (payload: WayfinderEvent['verification-failed']) => void;
+    onVerificationProgress?: (payload: WayfinderEvent['verification-progress']) => void;
+}
+export interface WayfinderEventArgs {
+    verification?: WayfinderVerificationEventArgs;
+    routing?: WayfinderRoutingEventArgs;
+    parentEmitter?: WayfinderEmitter;
+}
+/**
+ * Configuration options for the Wayfinder
+ */
+export interface WayfinderOptions {
+    /**
+     * Logger to use for logging
+     * @default defaultLogger (standard console logger)
+     */
+    logger?: Logger;
+    /**
+     * The gateways provider to use for routing requests.
+     */
+    gatewaysProvider: GatewaysProvider;
+    /**
+     * The verification settings to use for verifying data
+     */
+    verificationSettings?: {
+        /**
+         * 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
+         * If false, verification will be performed asynchronously with events emitted
+         * @default false
+         */
+        strict?: boolean;
+    };
+    /**
+     * The routing settings to use for routing requests
+     */
+    routingSettings?: {
+        /**
+         * The events to use for routing requests
+         */
+        events?: WayfinderRoutingEventArgs;
+        /**
+         * The routing strategy to use for routing requests
+         */
+        strategy?: RoutingStrategy;
+    };
+    /**
+     * Telemetry configuration used to initialize OpenTelemetry tracing
+     */
+    telemetrySettings?: TelemetryConfig;
+}
+export interface TelemetryConfig {
+    /** Enable or disable telemetry collection */
+    enabled: boolean;
+    /** Sampling ratio between 0 and 1 */
+    sampleRate: number;
+    /** Honeycomb API key */
+    apiKey?: string;
+    /** Optional custom OTLP exporter URL */
+    exporterUrl?: string;
+    /** Service name used for traces */
+    serviceName: string;
+}
+export type DataStream = ReadableStream<Uint8Array> | AsyncIterable<Uint8Array>;
+export interface GatewaysProvider {
+    getGateways(params?: {
+        path?: string;
+        subdomain?: string;
+    }): Promise<URL[]>;
+}
+export interface RoutingStrategy {
+    selectGateway(params: {
+        gateways: URL[];
+        path?: string;
+        subdomain?: string;
+    }): Promise<URL>;
+}
+export interface VerificationStrategy {
+    trustedGateways: URL[];
+    verifyData(params: {
+        data: DataStream;
+        txId: string;
+    }): Promise<void>;
+}
+export interface DataClassifier {
+    classify(params: {
+        txId: string;
+    }): Promise<'ans104' | 'transaction'>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,17 @@
+/**
+ * WayFinder
+ * Copyright (C) 2022-2025 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.
+ */
+export {};

package/dist/utils/hash.d.ts

@@ -1,5 +1,4 @@
-import { DataStream } from '../../types/wayfinder.js';
-import { Logger } from '../logger.js';
+import type { DataStream, Logger } from '../types.js';
 export declare function isAsyncIterable(obj: unknown): obj is AsyncIterable<Uint8Array>;
 export declare function readableStreamToAsyncIterable(stream: ReadableStream<Uint8Array>): AsyncIterable<Uint8Array>;
 export declare function hashDataStreamToB64Url({ stream, algorithm, logger, }: {

package/dist/utils/hash.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/utils/hash.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,MAAM,EAAiB,MAAM,cAAc,CAAC;AAGrD,wBAAgB,eAAe,CAC7B,GAAG,EAAE,OAAO,GACX,GAAG,IAAI,aAAa,CAAC,UAAU,CAAC,CAQlC;AAED,wBAAuB,6BAA6B,CAClD,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,GACjC,aAAa,CAAC,UAAU,CAAC,CAa3B;AAED,wBAAsB,sBAAsB,CAAC,EAC3C,MAAM,EACN,SAAoB,EACpB,MAAsB,GACvB,EAAE;IACD,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA2C9B"}
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/utils/hash.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGtD,wBAAgB,eAAe,CAC7B,GAAG,EAAE,OAAO,GACX,GAAG,IAAI,aAAa,CAAC,UAAU,CAAC,CAQlC;AAED,wBAAuB,6BAA6B,CAClD,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,GACjC,aAAa,CAAC,UAAU,CAAC,CAa3B;AAED,wBAAsB,sBAAsB,CAAC,EAC3C,MAAM,EACN,SAAoB,EACpB,MAAsB,GACvB,EAAE;IACD,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA2C9B"}

package/dist/verification/data-root-verifier.d.ts

@@ -1,10 +1,9 @@
-import { DataClassifier, DataStream, VerificationStrategy } from '../../types/wayfinder.js';
-import { Logger } from '../logger.js';
+import { DataClassifier, DataStream, Logger, VerificationStrategy } from '../types.js';
 export declare const convertDataStreamToDataRoot: ({ stream, }: {
     stream: DataStream;
 }) => Promise<string>;
 export declare class DataRootVerificationStrategy implements VerificationStrategy {
-    private readonly trustedGateways;
+    readonly trustedGateways: URL[];
     private readonly maxConcurrency;
     private readonly logger;
     private readonly classifier;

package/dist/verification/data-root-verifier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data-root-verifier.d.ts","sourceRoot":"","sources":["../../src/verification/data-root-verifier.ts"],"names":[],"mappings":"AA0BA,OAAO,EACL,cAAc,EACd,UAAU,EACV,oBAAoB,EACrB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,MAAM,EAAiB,MAAM,cAAc,CAAC;AAOrD,eAAO,MAAM,2BAA2B,GAAU,aAE/C;IACD,MAAM,EAAE,UAAU,CAAC;CACpB,KAAG,OAAO,CAAC,MAAM,CAwDjB,CAAC;AAGF,qBAAa,4BAA6B,YAAW,oBAAoB;IACvE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAQ;IACxC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiB;gBAChC,EACV,eAAe,EACf,cAAkB,EAClB,MAAsB,EACtB,UAA0C,GAC3C,EAAE;QACD,eAAe,EAAE,GAAG,EAAE,CAAC;QACvB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,cAAc,CAAC;KAC7B;IAOD;;;;OAIG;IACG,WAAW,CAAC,EAAE,IAAI,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAuCxD,UAAU,CAAC,EACf,IAAI,EACJ,IAAI,GACL,EAAE;QACD,IAAI,EAAE,UAAU,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC,IAAI,CAAC;CA0BlB"}
+{"version":3,"file":"data-root-verifier.d.ts","sourceRoot":"","sources":["../../src/verification/data-root-verifier.ts"],"names":[],"mappings":"AA4BA,OAAO,EACL,cAAc,EACd,UAAU,EACV,MAAM,EACN,oBAAoB,EACrB,MAAM,aAAa,CAAC;AAOrB,eAAO,MAAM,2BAA2B,GAAU,aAE/C;IACD,MAAM,EAAE,UAAU,CAAC;CACpB,KAAG,OAAO,CAAC,MAAM,CAwDjB,CAAC;AAGF,qBAAa,4BAA6B,YAAW,oBAAoB;IACvE,SAAgB,eAAe,EAAE,GAAG,EAAE,CAAC;IACvC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiB;gBAChC,EACV,eAAe,EACf,cAAkB,EAClB,MAAsB,EACtB,UAA0C,GAC3C,EAAE;QACD,eAAe,EAAE,GAAG,EAAE,CAAC;QACvB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,cAAc,CAAC;KAC7B;IAOD;;;;OAIG;IACG,WAAW,CAAC,EAAE,IAAI,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAuCxD,UAAU,CAAC,EACf,IAAI,EACJ,IAAI,GACL,EAAE;QACD,IAAI,EAAE,UAAU,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC,IAAI,CAAC;CA0BlB"}

package/dist/verification/hash-verifier.d.ts

@@ -1,7 +1,6 @@
-import { DataStream, VerificationStrategy } from '../../types/wayfinder.js';
-import { Logger } from '../logger.js';
+import type { DataStream, Logger, VerificationStrategy } from '../types.js';
 export declare class HashVerificationStrategy implements VerificationStrategy {
-    private readonly trustedGateways;
+    readonly trustedGateways: URL[];
     private readonly maxConcurrency;
     private readonly logger;
     constructor({ trustedGateways, maxConcurrency, logger, }: {

package/dist/verification/hash-verifier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hash-verifier.d.ts","sourceRoot":"","sources":["../../src/verification/hash-verifier.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,EAAE,MAAM,EAAiB,MAAM,cAAc,CAAC;AAKrD,qBAAa,wBAAyB,YAAW,oBAAoB;IACnE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAQ;IACxC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBACpB,EACV,eAAe,EACf,cAAkB,EAClB,MAAsB,GACvB,EAAE;QACD,eAAe,EAAE,GAAG,EAAE,CAAC;QACvB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;IAMD;;;;OAIG;IACG,SAAS,CAAC,EACd,IAAI,GACL,EAAE;QACD,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,QAAQ,CAAA;KAAE,CAAC;IAqE5C,UAAU,CAAC,EACf,IAAI,EACJ,IAAI,GACL,EAAE;QACD,IAAI,EAAE,UAAU,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC,IAAI,CAAC;CAgBlB"}
+{"version":3,"file":"hash-verifier.d.ts","sourceRoot":"","sources":["../../src/verification/hash-verifier.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAK5E,qBAAa,wBAAyB,YAAW,oBAAoB;IACnE,SAAgB,eAAe,EAAE,GAAG,EAAE,CAAC;IACvC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBACpB,EACV,eAAe,EACf,cAAkB,EAClB,MAAsB,GACvB,EAAE;QACD,eAAe,EAAE,GAAG,EAAE,CAAC;QACvB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;IAMD;;;;OAIG;IACG,SAAS,CAAC,EACd,IAAI,GACL,EAAE;QACD,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,QAAQ,CAAA;KAAE,CAAC;IAqE5C,UAAU,CAAC,EACf,IAAI,EACJ,IAAI,GACL,EAAE;QACD,IAAI,EAAE,UAAU,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC,IAAI,CAAC;CAgBlB"}

package/dist/verification/signature-verifier.d.ts

@@ -1,11 +1,10 @@
-import { DataClassifier, DataStream, VerificationStrategy } from '../../types/wayfinder.js';
-import { Logger } from '../logger.js';
+import type { DataClassifier, DataStream, Logger, VerificationStrategy } from '../types.js';
 /**
  * Implementation of DataVerificationStrategy that verifies data item signatures
  * using trusted gateways to provide the metadata needed for verification.
  */
 export declare class Ans104SignatureVerificationStrategy implements VerificationStrategy {
-    private readonly trustedGateways;
+    readonly trustedGateways: URL[];
     private readonly maxConcurrency;
     private readonly logger;
     constructor({ trustedGateways, maxConcurrency, logger, }: {
@@ -59,7 +58,7 @@ export declare class Ans104SignatureVerificationStrategy implements Verification
  * from a trusted gateway's /tx/<tx-id>/signature endpoint.
  */
 export declare class TransactionSignatureVerificationStrategy implements VerificationStrategy {
-    private readonly trustedGateways;
+    readonly trustedGateways: URL[];
     private readonly logger;
     constructor({ trustedGateways, logger, }: {
         trustedGateways: URL[];
@@ -103,6 +102,7 @@ export declare class SignatureVerificationStrategy {
     private readonly ans104;
     private readonly transaction;
     private readonly classifier;
+    readonly trustedGateways: URL[];
     constructor({ trustedGateways, maxConcurrency, logger, classifier, }: {
         trustedGateways: URL[];
         maxConcurrency?: number;

package/dist/verification/signature-verifier.d.ts.map

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

package/dist/verification/signature-verifier.js

@@ -334,7 +334,9 @@ export class SignatureVerificationStrategy {
     ans104;
     transaction;
     classifier;
+    trustedGateways;
     constructor({ trustedGateways, maxConcurrency = 1, logger = defaultLogger, classifier = new GqlClassifier({ logger }), }) {
+        this.trustedGateways = trustedGateways;
         this.ans104 = new Ans104SignatureVerificationStrategy({
             trustedGateways,
             maxConcurrency,

package/dist/wayfinder.d.ts

@@ -15,8 +15,8 @@
  * limitations under the License.
  */
 import { EventEmitter } from 'eventemitter3';
-import { Logger } from './logger.js';
-import { GatewaysProvider, RoutingStrategy, VerificationStrategy, WayfinderFetch } from '../types/wayfinder.js';
+import { type Tracer } from '@opentelemetry/api';
+import type { GatewaysProvider, Logger, TelemetryConfig, VerificationStrategy, WayfinderEvent, WayfinderEventArgs, WayfinderFetch, WayfinderOptions } from './types.js';
 export declare const arnsRegex: RegExp;
 export declare const txIdRegex: RegExp;
 /**
@@ -30,56 +30,8 @@ export declare const resolveWayfinderUrl: ({ originalUrl, selectedGateway, logge
     selectedGateway: URL;
     logger?: Logger;
 }) => URL;
-/**
- * Wayfinder event emitter with verification events
- */
-export type WayfinderEvent = {
-    'verification-succeeded': {
-        txId: string;
-    };
-    'verification-failed': Error;
-    'verification-skipped': {
-        originalUrl: string;
-    };
-    'verification-progress': {
-        txId: string;
-        processedBytes: number;
-        totalBytes: number;
-    };
-    'routing-started': {
-        originalUrl: string;
-    };
-    'routing-skipped': {
-        originalUrl: string;
-    };
-    'routing-succeeded': {
-        originalUrl: string;
-        selectedGateway: string;
-        redirectUrl: string;
-    };
-    'routing-failed': Error;
-    'identified-transaction-id': {
-        originalUrl: string;
-        selectedGateway: string;
-        txId: string;
-    };
-};
-export interface WayfinderRoutingEventArgs {
-    onRoutingStarted?: (payload: WayfinderEvent['routing-started']) => void;
-    onRoutingSkipped?: (payload: WayfinderEvent['routing-skipped']) => void;
-    onRoutingSucceeded?: (payload: WayfinderEvent['routing-succeeded']) => void;
-}
-export interface WayfinderVerificationEventArgs {
-    onVerificationSucceeded?: (payload: WayfinderEvent['verification-succeeded']) => void;
-    onVerificationFailed?: (payload: WayfinderEvent['verification-failed']) => void;
-    onVerificationProgress?: (payload: WayfinderEvent['verification-progress']) => void;
-}
-export interface WayfinderEventArgs {
-    verification?: WayfinderVerificationEventArgs;
-    routing?: WayfinderRoutingEventArgs;
-}
 export declare class WayfinderEmitter extends EventEmitter<WayfinderEvent> {
-    constructor({ verification, routing }?: WayfinderEventArgs);
+    constructor({ verification, routing, parentEmitter, }?: WayfinderEventArgs);
 }
 export declare function tapAndVerifyReadableStream({ originalStream, contentLength, verifyData, txId, emitter, strict, }: {
     originalStream: ReadableStream;
@@ -100,65 +52,17 @@ export declare function tapAndVerifyReadableStream({ originalStream, contentLeng
  * @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 wayfinderFetch: ({ emitter, logger, gatewaysProvider, verificationSettings, routingSettings, }: {
+export declare const wayfinderFetch: ({ logger, gatewaysProvider, verificationSettings, routingSettings, emitter, tracer, }: {
     logger?: Logger;
-    emitter?: WayfinderEmitter;
     gatewaysProvider: GatewaysProvider;
     verificationSettings: NonNullable<WayfinderOptions["verificationSettings"]>;
     routingSettings: NonNullable<WayfinderOptions["routingSettings"]>;
-}) => (input: URL | RequestInfo, init?: RequestInit) => Promise<Response>;
-/**
- * Configuration options for the Wayfinder
- */
-export interface WayfinderOptions {
-    /**
-     * Logger to use for logging
-     * @default defaultLogger (standard console logger)
-     */
-    logger?: Logger;
-    /**
-     * The gateways provider to use for routing requests.
-     */
-    gatewaysProvider: GatewaysProvider;
-    /**
-     * The verification settings to use for verifying data
-     */
-    verificationSettings?: {
-        /**
-         * 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
-         * If false, verification will be performed asynchronously with events emitted
-         * @default false
-         */
-        strict?: boolean;
-    };
-    /**
-     * The routing settings to use for routing requests
-     */
-    routingSettings?: {
-        /**
-         * The events to use for routing requests
-         */
-        events?: WayfinderRoutingEventArgs;
-        /**
-         * The routing strategy to use for routing requests
-         */
-        strategy: RoutingStrategy;
-    };
-}
+    emitter?: WayfinderEmitter;
+    tracer?: Tracer;
+}) => (input: URL | RequestInfo, init?: RequestInit & {
+    verificationSettings?: NonNullable<WayfinderOptions["verificationSettings"]>;
+    routingSettings?: NonNullable<WayfinderOptions["routingSettings"]>;
+}) => Promise<Response>;
 /**
  * The main class for the wayfinder
  */
@@ -180,11 +84,19 @@ export declare class Wayfinder {
      * This includes the routing strategy and event handlers for routing events.
      * If not provided, the default FastestPingRoutingStrategy will be used.
      */
-    readonly routingSettings: NonNullable<WayfinderOptions['routingSettings']>;
+    readonly routingSettings: Required<NonNullable<WayfinderOptions['routingSettings']>>;
     /**
      * The verification settings to use when verifying data.
      */
     readonly verificationSettings: WayfinderOptions['verificationSettings'];
+    /**
+     * Telemetry configuration used for OpenTelemetry tracing
+     */
+    readonly telemetrySettings: TelemetryConfig;
+    /**
+     * OpenTelemetry tracer instance
+     */
+    protected tracer?: Tracer;
     /**
      * A helper function that resolves the redirect url for ar:// requests to a target gateway.
      *
@@ -239,7 +151,13 @@ export declare class Wayfinder {
      */
     protected logger: Logger;
     /**
-     * The event emitter for wayfinder that emits routing and verification events.
+     * The event emitter for wayfinder that emits routing and verification events for all requests.
+     *
+     * This is useful for tracking all requests and their statuses, and is updated for each request.
+     *
+     * If you prefer request-specific events, you can pass in the events to the `request` function.
+     *
+     * @example
      *
      * const wayfinder = new Wayfinder()
      *
@@ -266,10 +184,8 @@ export declare class Wayfinder {
      *         console.log('Verification passed!', event);
      *       },
      *       onVerificationFailed: (event) => {
-     *       console.log('Verification failed!', event);
-     *     },
-     *     onVerificationProgress: (event) => {
-     *       console.log('Verification progress!', event);
+     *         console.log('Verification failed!', event);
+     *       },
      *     },
      *   }
      *   routingSettings: {
@@ -298,6 +214,6 @@ export declare class Wayfinder {
      * @param options - Wayfinder configuration options
      */
     constructor({ logger, gatewaysProvider, // forcing it to be required to avoid making ar-io-sdk a dependency
-    verificationSettings, routingSettings, }: WayfinderOptions);
+    verificationSettings, routingSettings, telemetrySettings, }: WayfinderOptions);
 }
 //# sourceMappingURL=wayfinder.d.ts.map