@seedprotocol/arweave 0.5.1 → 0.5.3

package/dist/ArweaveClient/BaseArweaveClient.d.ts

@@ -13,16 +13,25 @@ export declare abstract class BaseArweaveClient {
         host: string;
     };
     /**
-     * Get the current Arweave host (hostname, optionally with port — no URL scheme)
-     * @returns The Arweave host (e.g. 'arweave.net' or 'localhost:1984')
+     * Get the current Arweave host (hostname, optionally with port and path prefix — no URL scheme)
+     * @returns The Arweave host (e.g. 'arweave.net', 'localhost:1984', or 'app.example.com/api/seed-gateway')
      */
     static getHost(): string;
+    /**
+     * Hostname (+ optional port) without a path prefix — safe for the `arweave` npm client's `init({ host })`.
+     */
+    static getArweaveSdkHost(): string;
+    /**
+     * Path prefix on the gateway origin (e.g. `/api/seed-gateway`), or empty.
+     */
+    static getGatewayPath(): string;
     /**
      * Get whether requests use http or https
      */
     static getProtocol(): 'http' | 'https';
     /**
-     * Base URL for the configured gateway (e.g. https://arweave.net or http://localhost:1984)
+     * Base URL for the configured gateway (e.g. https://arweave.net, http://localhost:1984,
+     * or https://app.example.com/api/seed-gateway)
      */
     static getBaseUrl(): string;
     /**

package/dist/ArweaveClient/BaseArweaveClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BaseArweaveClient.d.ts","sourceRoot":"","sources":["../../src/ArweaveClient/BaseArweaveClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,wBAAwB,EACzB,MAAM,qBAAqB,CAAA;AAE5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAoBzD,8BAAsB,iBAAiB;IACrC,OAAO,CAAC,MAAM,CAAC,KAAK,CAA8B;IAElD,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAS5C,OAAO,CAAC,MAAM,CAAC,WAAW;IAS1B;;OAEG;IACH,MAAM,CAAC,cAAc,IAAI;QAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IAYrE;;;OAGG;IACH,MAAM,CAAC,OAAO,IAAI,MAAM;IAIxB;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,MAAM,GAAG,OAAO;IAItC;;OAEG;IACH,MAAM,CAAC,UAAU,IAAI,MAAM;IAK3B;;;OAGG;IACH,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQlC;;OAEG;IACH,MAAM,CAAC,mBAAmB,IAAI,OAAO;IAIrC;;OAEG;IACH,MAAM,CAAC,sCAAsC,IAAI,IAAI;IAIrD;;;OAGG;IACH,MAAM,CAAC,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOlD;;OAEG;IACH,MAAM,CAAC,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQjD;;;OAGG;IACH,MAAM,CAAC,WAAW,IAAI,MAAM;IAI5B;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM;IAI/C;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM;IAQlD,MAAM,CAAC,gBAAgB,IAAI,aAAa;IAIxC,MAAM,CAAC,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAI9E,MAAM,CAAC,kBAAkB,CACvB,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,GAAG,MAAM,CAAC;IAI/B,MAAM,CAAC,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAI3E,MAAM,CAAC,iBAAiB,CACtB,IAAI,EAAE,MAAM,GAAG,UAAU,EACzB,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,GAAG,CAAC;IAIf,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;CAG7E"}
+{"version":3,"file":"BaseArweaveClient.d.ts","sourceRoot":"","sources":["../../src/ArweaveClient/BaseArweaveClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,wBAAwB,EACzB,MAAM,qBAAqB,CAAA;AAE5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAoBzD,8BAAsB,iBAAiB;IACrC,OAAO,CAAC,MAAM,CAAC,KAAK,CAA8B;IAElD,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAS5C,OAAO,CAAC,MAAM,CAAC,WAAW;IAS1B;;OAEG;IACH,MAAM,CAAC,cAAc,IAAI;QAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IAYrE;;;OAGG;IACH,MAAM,CAAC,OAAO,IAAI,MAAM;IAIxB;;OAEG;IACH,MAAM,CAAC,iBAAiB,IAAI,MAAM;IAMlC;;OAEG;IACH,MAAM,CAAC,cAAc,IAAI,MAAM;IAO/B;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,MAAM,GAAG,OAAO;IAItC;;;OAGG;IACH,MAAM,CAAC,UAAU,IAAI,MAAM;IAK3B;;;OAGG;IACH,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQlC;;OAEG;IACH,MAAM,CAAC,mBAAmB,IAAI,OAAO;IAIrC;;OAEG;IACH,MAAM,CAAC,sCAAsC,IAAI,IAAI;IAIrD;;;OAGG;IACH,MAAM,CAAC,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOlD;;OAEG;IACH,MAAM,CAAC,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQjD;;;OAGG;IACH,MAAM,CAAC,WAAW,IAAI,MAAM;IAI5B;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM;IAI/C;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM;IAQlD,MAAM,CAAC,gBAAgB,IAAI,aAAa;IAIxC,MAAM,CAAC,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAI9E,MAAM,CAAC,kBAAkB,CACvB,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,GAAG,MAAM,CAAC;IAI/B,MAAM,CAAC,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAI3E,MAAM,CAAC,iBAAiB,CACtB,IAAI,EAAE,MAAM,GAAG,UAAU,EACzB,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,GAAG,CAAC;IAIf,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;CAG7E"}

package/dist/easAttestationUrl.d.ts

@@ -0,0 +1,5 @@
+/**
+ * True when `url` points at an EAS attestation explorer HTML page (not fetchable media).
+ */
+export declare function isEasAttestationExplorerUrl(url: string): boolean;
+//# sourceMappingURL=easAttestationUrl.d.ts.map

package/dist/easAttestationUrl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"easAttestationUrl.d.ts","sourceRoot":"","sources":["../src/easAttestationUrl.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAYhE"}

package/dist/gateway/resolveSeedGatewayEndpoints.d.ts

@@ -1,15 +1,30 @@
 import type { ResolvedSeedGatewayEndpoints, SeedGatewayConfig } from '../types/gateway.js';
-/** Clears cached sidecar probe (tests / forced re-probe). */
+/** Clears cached sidecar / proxy probes (tests / forced re-probe). */
 export declare function invalidateSidecarProbeCache(): void;
+/**
+ * Resolve `proxyBaseUrl` to an absolute origin+path (no trailing slash).
+ * Relative paths require a browser `window.location.origin` or {@link ResolveSeedGatewayEndpointsOptions.origin}.
+ */
+export declare function resolveProxyBaseUrl(proxyBaseUrl: string, options?: {
+    origin?: string;
+}): string;
 export type ResolveSeedGatewayEndpointsOptions = {
     signal?: AbortSignal;
-    /** Skip cache and probe sidecar again (hybrid). */
+    /** Skip cache and probe sidecar / proxy again. */
     forceSidecarProbe?: boolean;
+    /**
+     * Origin used to resolve relative `proxyBaseUrl` (e.g. `https://app.example.com`).
+     * Defaults to `window.location.origin` in browsers.
+     */
+    origin?: string;
 };
 /**
  * Resolve effective gateway + upload API URLs for the configured transport mode.
+ *
+ * Preference when a proxy and/or sidecar may apply:
+ * configured + healthy `proxyBaseUrl` → local Hyper sidecar → public HTTP gateway.
  */
 export declare function resolveSeedGatewayEndpoints(config: SeedGatewayConfig, options?: ResolveSeedGatewayEndpointsOptions): Promise<ResolvedSeedGatewayEndpoints>;
-/** Build ordered gateway host list for read fallback (sidecar first in hybrid when active). */
+/** Build ordered gateway host list for read fallback (sidecar/proxy first when active). */
 export declare function getReadGatewayHostsForConfig(resolved: ResolvedSeedGatewayEndpoints, _defaults?: readonly string[]): string[];
 //# sourceMappingURL=resolveSeedGatewayEndpoints.d.ts.map

package/dist/gateway/resolveSeedGatewayEndpoints.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolveSeedGatewayEndpoints.d.ts","sourceRoot":"","sources":["../../src/gateway/resolveSeedGatewayEndpoints.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,4BAA4B,EAC5B,iBAAiB,EAElB,MAAM,qBAAqB,CAAA;AAM5B,6DAA6D;AAC7D,wBAAgB,2BAA2B,IAAI,IAAI,CAElD;AAyED,MAAM,MAAM,kCAAkC,GAAG;IAC/C,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,mDAAmD;IACnD,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B,CAAA;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,iBAAiB,EACzB,OAAO,CAAC,EAAE,kCAAkC,GAC3C,OAAO,CAAC,4BAA4B,CAAC,CAuCvC;AAED,+FAA+F;AAC/F,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,4BAA4B,EACtC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,GAC5B,MAAM,EAAE,CAKV"}
+{"version":3,"file":"resolveSeedGatewayEndpoints.d.ts","sourceRoot":"","sources":["../../src/gateway/resolveSeedGatewayEndpoints.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,4BAA4B,EAC5B,iBAAiB,EAElB,MAAM,qBAAqB,CAAA;AAO5B,sEAAsE;AACtE,wBAAgB,2BAA2B,IAAI,IAAI,CAGlD;AAsCD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5B,MAAM,CAkBR;AA+ED,MAAM,MAAM,kCAAkC,GAAG;IAC/C,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,kDAAkD;IAClD,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAkBD;;;;;GAKG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,iBAAiB,EACzB,OAAO,CAAC,EAAE,kCAAkC,GAC3C,OAAO,CAAC,4BAA4B,CAAC,CAyDvC;AAED,2FAA2F;AAC3F,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,4BAA4B,EACtC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,GAC5B,MAAM,EAAE,CAKV"}

package/dist/gateway/seedGatewayConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"seedGatewayConfig.d.ts","sourceRoot":"","sources":["../../src/gateway/seedGatewayConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EACzB,sBAAsB,EACtB,iBAAiB,EAClB,MAAM,wBAAwB,CAAA;AAG/B,uEAAuE;AACvE,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,sBAAsB,GAC7B,iBAAiB,CAiBnB;AAED,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,yBAAyB,GACjC,iBAAiB,CAYnB"}
+{"version":3,"file":"seedGatewayConfig.d.ts","sourceRoot":"","sources":["../../src/gateway/seedGatewayConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EACzB,sBAAsB,EACtB,iBAAiB,EAClB,MAAM,wBAAwB,CAAA;AAG/B,uEAAuE;AACvE,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,sBAAsB,GAC7B,iBAAiB,CAkBnB;AAED,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,yBAAyB,GACjC,iBAAiB,CAanB"}

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 export * from './constants.js';
+export * from './easAttestationUrl.js';
 export * from './mediaRef.js';
+export * from './resolveSeedRssImageRelationRef.js';
 export * from './relationSeedRef.js';
 export * from './types/gateway.js';
 export * from './types/arweave.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,YAAY,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAA;AAC9F,cAAc,4BAA4B,CAAA;AAC1C,cAAc,sCAAsC,CAAA;AACpD,OAAO,EAAE,iBAAiB,IAAI,aAAa,EAAE,MAAM,sCAAsC,CAAA;AACzF,YAAY,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAA;AACvE,cAAc,sCAAsC,CAAA;AACpD,cAAc,0CAA0C,CAAA;AACxD,cAAc,uCAAuC,CAAA;AACrD,cAAc,2BAA2B,CAAA;AACzC,cAAc,0CAA0C,CAAA;AACxD,cAAc,gCAAgC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,wBAAwB,CAAA;AACtC,cAAc,eAAe,CAAA;AAC7B,cAAc,qCAAqC,CAAA;AACnD,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,YAAY,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAA;AAC9F,cAAc,4BAA4B,CAAA;AAC1C,cAAc,sCAAsC,CAAA;AACpD,OAAO,EAAE,iBAAiB,IAAI,aAAa,EAAE,MAAM,sCAAsC,CAAA;AACzF,YAAY,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAA;AACvE,cAAc,sCAAsC,CAAA;AACpD,cAAc,0CAA0C,CAAA;AACxD,cAAc,uCAAuC,CAAA;AACrD,cAAc,2BAA2B,CAAA;AACzC,cAAc,0CAA0C,CAAA;AACxD,cAAc,gCAAgC,CAAA"}