@ar.io/wayfinder-core 1.7.1-alpha.2 → 1.7.2-alpha.0

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAUH,OAAO,KAAK,EACV,gBAAgB,EAChB,MAAM,EACN,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAKpB,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAI3C;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAAI,yCAInC;IACD,QAAQ,EAAE,aAAa,CAAC;IACxB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,KAAG,eAgBH,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,0BAA0B,GAAI,wCAIxC;IACD,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,GAAG,EAAE,CAAC;CACzB,KAAG,oBAQH,CAAC;AAqCF;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,GAAE,gBAAqB,GAC7B,SAAS,CA+BX;AAED,eAAO,MAAM,eAAe,8BAAwB,CAAC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAUH,OAAO,KAAK,EACV,gBAAgB,EAChB,MAAM,EACN,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAKpB,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAI3C;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAAI,yCAInC;IACD,QAAQ,EAAE,aAAa,CAAC;IACxB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,KAAG,eAuBH,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,0BAA0B,GAAI,wCAIxC;IACD,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,GAAG,EAAE,CAAC;CACzB,KAAG,oBAQH,CAAC;AAqCF;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,GAAE,gBAAqB,GAC7B,SAAS,CA+BX;AAED,eAAO,MAAM,eAAe,8BAAwB,CAAC"}

package/dist/client.js

@@ -33,19 +33,23 @@ const DEFAULT_TRUSTED_GATEWAY = 'https://permagate.io';
  */
 export const createRoutingStrategy = ({ strategy, gatewaysProvider, logger, }) => {
     const baseConfig = { gatewaysProvider, logger };
-    const routingMap = {
-        random: new RandomRoutingStrategy(baseConfig),
-        fastest: new FastestPingRoutingStrategy(baseConfig),
-        balanced: new RoundRobinRoutingStrategy(baseConfig),
-        preferred: new PreferredWithFallbackRoutingStrategy({
-            preferredGateway: 'https://arweave.net',
-            fallbackStrategy: createRoutingStrategy({
-                ...baseConfig,
-                strategy: 'fastest',
-            }),
-        }),
-    };
-    return routingMap[strategy];
+    switch (strategy) {
+        case 'random':
+            return new RandomRoutingStrategy(baseConfig);
+        case 'fastest':
+            return new FastestPingRoutingStrategy(baseConfig);
+        case 'balanced':
+            return new RoundRobinRoutingStrategy(baseConfig);
+        case 'preferred':
+            return new PreferredWithFallbackRoutingStrategy({
+                preferredGateway: 'https://arweave.net',
+                fallbackStrategy: createRoutingStrategy({
+                    strategy: 'fastest',
+                    gatewaysProvider,
+                    logger,
+                }),
+            });
+    }
 };
 /**
  * Helper function to construct a verification strategy

package/dist/constants.d.ts

@@ -0,0 +1,59 @@
+/**
+ * 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 declare const arnsRegex: RegExp;
+export declare const txIdRegex: RegExp;
+export declare const arioHeaderNames: {
+    hops: string;
+    origin: string;
+    originNodeRelease: string;
+    digest: string;
+    contentDigest: string;
+    expectedDigest: string;
+    stable: string;
+    verified: string;
+    trusted: string;
+    cache: string;
+    chunkSourceType: string;
+    chunkHost: string;
+    chunkDataPath: string;
+    chunkDataRoot: string;
+    chunkStartOffset: string;
+    chunkRelativeStartOffset: string;
+    chunkReadOffset: string;
+    chunkTxDataSize: string;
+    chunkTxPath: string;
+    chunkTxId: string;
+    chunkTxStartOffset: string;
+    rootTransactionId: string;
+    dataItemDataOffset: string;
+    dataItemRootParentOffset: string;
+    dataItemOffset: string;
+    dataItemSize: string;
+    rootDataItemOffset: string;
+    rootDataOffset: string;
+    arnsTtlSeconds: string;
+    arnsName: string;
+    arnsBasename: string;
+    arnsRecord: string;
+    arnsResolvedId: string;
+    dataId: string;
+    arnsProcessId: string;
+    arnsResolvedAt: string;
+    arnsLimit: string;
+    arnsIndex: string;
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,eAAO,MAAM,SAAS,QAA2C,CAAC;AAClE,eAAO,MAAM,SAAS,QAAwB,CAAC;AAG/C,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuC3B,CAAC"}

package/dist/constants.js

@@ -0,0 +1,60 @@
+/**
+ * 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.
+ */
+// known regexes for wayfinder urls
+export const arnsRegex = /^[a-z0-9_-]{1,42}$|^[a-z0-9_-]{44,51}$/;
+export const txIdRegex = /^[A-Za-z0-9_-]{43}$/;
+// ar.io gateway header names
+export const arioHeaderNames = {
+    hops: 'X-AR-IO-Hops',
+    origin: 'X-AR-IO-Origin',
+    originNodeRelease: 'X-AR-IO-Origin-Node-Release',
+    digest: 'X-AR-IO-Digest',
+    contentDigest: 'Content-Digest',
+    expectedDigest: 'X-AR-IO-Expected-Digest',
+    stable: 'X-AR-IO-Stable',
+    verified: 'X-AR-IO-Verified',
+    trusted: 'X-AR-IO-Trusted',
+    cache: 'X-Cache',
+    chunkSourceType: 'X-AR-IO-Chunk-Source-Type',
+    chunkHost: 'X-AR-IO-Chunk-Host',
+    chunkDataPath: 'X-Arweave-Chunk-Data-Path',
+    chunkDataRoot: 'X-Arweave-Chunk-Data-Root',
+    chunkStartOffset: 'X-Arweave-Chunk-Start-Offset',
+    chunkRelativeStartOffset: 'X-Arweave-Chunk-Relative-Start-Offset',
+    chunkReadOffset: 'X-Arweave-Chunk-Read-Offset',
+    chunkTxDataSize: 'X-Arweave-Chunk-Tx-Data-Size',
+    chunkTxPath: 'X-Arweave-Chunk-Tx-Path',
+    chunkTxId: 'X-Arweave-Chunk-Tx-Id',
+    chunkTxStartOffset: 'X-Arweave-Chunk-Tx-Start-Offset',
+    rootTransactionId: 'X-AR-IO-Root-Transaction-Id',
+    dataItemDataOffset: 'X-AR-IO-Data-Item-Data-Offset',
+    dataItemRootParentOffset: 'X-AR-IO-Data-Item-Root-Parent-Offset',
+    dataItemOffset: 'X-AR-IO-Data-Item-Offset',
+    dataItemSize: 'X-AR-IO-Data-Item-Size',
+    rootDataItemOffset: 'X-AR-IO-Root-Data-Item-Offset',
+    rootDataOffset: 'X-AR-IO-Root-Data-Offset',
+    arnsTtlSeconds: 'X-ArNS-TTL-Seconds',
+    arnsName: 'X-ArNS-Name',
+    arnsBasename: 'X-ArNS-Basename',
+    arnsRecord: 'X-ArNS-Record',
+    arnsResolvedId: 'X-ArNS-Resolved-Id',
+    dataId: 'X-AR-IO-Data-Id',
+    arnsProcessId: 'X-ArNS-Process-Id',
+    arnsResolvedAt: 'X-ArNS-Resolved-At',
+    arnsLimit: 'X-ArNS-Undername-Limit',
+    arnsIndex: 'X-ArNS-Record-Index',
+};

package/dist/utils/verify-stream.d.ts

@@ -0,0 +1,40 @@
+/**
+ * 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 { WayfinderEmitter } from '../index.js';
+import { VerificationStrategy } from '../types.js';
+/**
+ * Utility to tap a ReadableStream for verification while passing through data to the client.
+ *
+ * @param originalStream The original ReadableStream from the fetch response.
+ * @param contentLength The total content length of the stream, used for progress reporting.
+ * @param verifyData The verification function to process the tapped stream.
+ * @param txId The transaction ID associated with the data.
+ * @param emitter Optional WayfinderEmitter to emit verification events.
+ * @param headers Optional headers to pass to the verification function.
+ * @param strict If true, the client stream will error if verification fails; otherwise, verification runs asynchronously.
+ * @returns A ReadableStream that passes through data to the client while verifying in parallel.
+ */
+export declare const tapAndVerifyReadableStream: ({ originalStream, contentLength, verifyData, txId, emitter, headers, strict, }: {
+    originalStream: ReadableStream;
+    contentLength: number;
+    headers?: Record<string, string>;
+    verifyData: VerificationStrategy["verifyData"];
+    txId: string;
+    emitter?: WayfinderEmitter;
+    strict?: boolean;
+}) => ReadableStream;
+//# sourceMappingURL=verify-stream.d.ts.map

package/dist/utils/verify-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-stream.d.ts","sourceRoot":"","sources":["../../src/utils/verify-stream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,0BAA0B,GAAI,gFAQxC;IACD,cAAc,EAAE,cAAc,CAAC;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,UAAU,EAAE,oBAAoB,CAAC,YAAY,CAAC,CAAC;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,KAAG,cAkFH,CAAC"}

package/dist/utils/verify-stream.js

@@ -0,0 +1,106 @@
+/**
+ * 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.
+ */
+/**
+ * Utility to tap a ReadableStream for verification while passing through data to the client.
+ *
+ * @param originalStream The original ReadableStream from the fetch response.
+ * @param contentLength The total content length of the stream, used for progress reporting.
+ * @param verifyData The verification function to process the tapped stream.
+ * @param txId The transaction ID associated with the data.
+ * @param emitter Optional WayfinderEmitter to emit verification events.
+ * @param headers Optional headers to pass to the verification function.
+ * @param strict If true, the client stream will error if verification fails; otherwise, verification runs asynchronously.
+ * @returns A ReadableStream that passes through data to the client while verifying in parallel.
+ */
+export const tapAndVerifyReadableStream = ({ originalStream, contentLength, verifyData, txId, emitter, headers = {}, strict = false, }) => {
+    if (originalStream instanceof ReadableStream &&
+        typeof originalStream.tee === 'function') {
+        /**
+         * NOTE: tee requires the streams both streams to be consumed, so we need to make sure we consume the client branch
+         * by the caller. This means when `request` is called, the client stream must be consumed by the caller via await request.text()
+         * for verification to complete.
+         *
+         * It is feasible to make the verification stream not to depend on the client branch being consumed, should the DX not be obvious.
+         */
+        const [verifyBranch, clientBranch] = originalStream.tee();
+        // setup our promise to verify the data
+        const verificationPromise = verifyData({
+            data: verifyBranch,
+            txId,
+            headers,
+        });
+        let bytesProcessed = 0;
+        const reader = clientBranch.getReader();
+        const clientStreamWithVerification = new ReadableStream({
+            async pull(controller) {
+                const { done, value } = await reader.read();
+                if (done) {
+                    if (strict) {
+                        // in strict mode, we wait for verification to complete before closing the controller
+                        try {
+                            await verificationPromise;
+                            emitter?.emit('verification-succeeded', { txId });
+                            controller.close();
+                        }
+                        catch (err) {
+                            // emit the verification failed event
+                            emitter?.emit('verification-failed', err);
+                            // In strict mode, we report the error to the client stream
+                            controller.error(new Error('Verification failed', { cause: err }));
+                        }
+                    }
+                    else {
+                        // in non-strict mode, we close the controller immediately and handle verification asynchronously
+                        controller.close();
+                        // trigger the verification promise and emit events for the result
+                        verificationPromise
+                            .then(() => {
+                            emitter?.emit('verification-succeeded', { txId });
+                        })
+                            .catch((error) => {
+                            emitter?.emit('verification-failed', error);
+                        });
+                    }
+                }
+                else {
+                    bytesProcessed += value.length;
+                    emitter?.emit('verification-progress', {
+                        txId,
+                        totalBytes: contentLength,
+                        processedBytes: bytesProcessed,
+                    });
+                    controller.enqueue(value);
+                }
+            },
+            cancel(reason) {
+                // cancel the reader regardless of verification status
+                reader.cancel(reason);
+                // emit the verification cancellation event
+                emitter?.emit('verification-failed', {
+                    txId,
+                    error: new Error('Verification cancelled', {
+                        cause: {
+                            reason,
+                        },
+                    }),
+                });
+            },
+        });
+        return clientStreamWithVerification;
+    }
+    throw new Error('Unsupported body type for cloning');
+};

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.7.1-alpha.2";
+export declare const WAYFINDER_CORE_VERSION = "v1.7.2-alpha.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.7.1-alpha.2';
+export const WAYFINDER_CORE_VERSION = 'v1.7.2-alpha.0';

package/dist/wayfinder.d.ts

@@ -25,8 +25,6 @@ export declare const createWayfinderRequestHeaders: ({ traceId, }: {
     'x-ar-io-trace-id'?: string | undefined;
     'x-ar-io-component': string;
 };
-export declare const arnsRegex: RegExp;
-export declare const txIdRegex: RegExp;
 /**
  * Parses the original URL from the params and returns a WayfinderURL (e.g. ar://<txId>)
  * @param params - The params to parse
@@ -55,15 +53,6 @@ export declare const constructGatewayUrl: ({ selectedGateway, subdomain, path, }
     subdomain: string;
     path: string;
 }) => URL;
-export declare function tapAndVerifyReadableStream({ originalStream, contentLength, verifyData, txId, emitter, headers, strict, }: {
-    originalStream: ReadableStream;
-    contentLength: number;
-    headers?: Record<string, string>;
-    verifyData: VerificationStrategy['verifyData'];
-    txId: string;
-    emitter?: WayfinderEmitter;
-    strict?: boolean;
-}): ReadableStream;
 /**
  * Creates a wrapped fetch function that supports ar:// protocol
  *

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

@@ -16,6 +16,7 @@
  */
 import { defaultLogger } from './logger.js';
 import { context, trace } from '@opentelemetry/api';
+import { arnsRegex, txIdRegex } from './constants.js';
 import { WayfinderEmitter } from './emitter.js';
 import { createBaseFetch } from './fetch.js';
 import { TrustedPeersGatewaysProvider } from './gateways/trusted-peers.js';
@@ -23,6 +24,7 @@ import { PingRoutingStrategy } from './routing/ping.js';
 import { RandomRoutingStrategy } from './routing/random.js';
 import { initTelemetry, startRequestSpans } from './telemetry.js';
 import { sandboxFromId } from './utils/base64.js';
+import { tapAndVerifyReadableStream } from './utils/verify-stream.js';
 import { HashVerificationStrategy } from './verification/hash-verification.js';
 // headers
 export const createWayfinderRequestHeaders = ({ traceId, }) => {
@@ -32,9 +34,6 @@ export const createWayfinderRequestHeaders = ({ traceId, }) => {
         ...(traceId ? { 'x-ar-io-trace-id': traceId } : {}),
     };
 };
-// known regexes for wayfinder urls
-export const arnsRegex = /^[a-z0-9_-]{1,51}$/;
-export const txIdRegex = /^[A-Za-z0-9_-]{43}$/;
 /**
  * Parses the original URL from the params and returns a WayfinderURL (e.g. ar://<txId>)
  * @param params - The params to parse
@@ -132,84 +131,6 @@ export const constructGatewayUrl = ({ selectedGateway, subdomain, path, }) => {
     }
     return gatewayUrl;
 };
-export function tapAndVerifyReadableStream({ originalStream, contentLength, verifyData, txId, emitter, headers = {}, strict = false, }) {
-    if (originalStream instanceof ReadableStream &&
-        typeof originalStream.tee === 'function') {
-        /**
-         * NOTE: tee requires the streams both streams to be consumed, so we need to make sure we consume the client branch
-         * by the caller. This means when `request` is called, the client stream must be consumed by the caller via await request.text()
-         * for verification to complete.
-         *
-         * It is feasible to make the verification stream not to depend on the client branch being consumed, should the DX not be obvious.
-         */
-        const [verifyBranch, clientBranch] = originalStream.tee();
-        // setup our promise to verify the data
-        const verificationPromise = verifyData({
-            data: verifyBranch,
-            txId,
-            headers,
-        });
-        let bytesProcessed = 0;
-        const reader = clientBranch.getReader();
-        const clientStreamWithVerification = new ReadableStream({
-            async pull(controller) {
-                const { done, value } = await reader.read();
-                if (done) {
-                    if (strict) {
-                        // in strict mode, we wait for verification to complete before closing the controller
-                        try {
-                            await verificationPromise;
-                            emitter?.emit('verification-succeeded', { txId });
-                            controller.close();
-                        }
-                        catch (err) {
-                            // emit the verification failed event
-                            emitter?.emit('verification-failed', err);
-                            // In strict mode, we report the error to the client stream
-                            controller.error(new Error('Verification failed', { cause: err }));
-                        }
-                    }
-                    else {
-                        // trigger the verification promise and emit events for the result
-                        verificationPromise
-                            .then(() => {
-                            emitter?.emit('verification-succeeded', { txId });
-                        })
-                            .catch((error) => {
-                            emitter?.emit('verification-failed', error);
-                        });
-                        // in non-strict mode, we close the controller immediately and handle verification asynchronously
-                        controller.close();
-                    }
-                }
-                else {
-                    bytesProcessed += value.length;
-                    emitter?.emit('verification-progress', {
-                        txId,
-                        totalBytes: contentLength,
-                        processedBytes: bytesProcessed,
-                    });
-                    controller.enqueue(value);
-                }
-            },
-            cancel(reason) {
-                // cancel the reader regardless of verification status
-                reader.cancel(reason);
-                // emit the verification cancellation event
-                emitter?.emit('verification-failed', {
-                    txId,
-                    error: new Error('Verification cancelled', {
-                        cause: {
-                            reason,
-                        },
-                    }),
-                });
-            },
-        });
-        return clientStreamWithVerification;
-    }
-    throw new Error('Unsupported body type for cloning');
-}
 /**
  * Creates a wrapped fetch function that supports ar:// protocol
  *

package/package.json

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