applesauce-relay 0.0.0-next-20250828145754 → 0.0.0-next-20250913205403

package/dist/group.d.ts

@@ -1,19 +1,27 @@
 import { type NostrEvent } from "nostr-tools";
 import { Observable } from "rxjs";
+import { IEventStoreActions } from "applesauce-core";
 import { FilterInput, IGroup, IRelay, PublishOptions, PublishResponse, RequestOptions, SubscriptionOptions, SubscriptionResponse } from "./types.js";
 export declare class RelayGroup implements IGroup {
     relays: IRelay[];
     constructor(relays: IRelay[]);
     /** Takes an array of observables and only emits EOSE when all observables have emitted EOSE */
-    protected mergeEOSE(...requests: Observable<SubscriptionResponse>[]): Observable<import("nostr-tools").Event | "EOSE">;
-    /** Make a request to all relays */
+    protected mergeEOSE(requests: Observable<SubscriptionResponse>[], eventStore?: IEventStoreActions): Observable<import("nostr-tools").Event | "EOSE">;
+    /**
+     * Make a request to all relays
+     * @note This does not deduplicate events
+     */
     req(filters: FilterInput, id?: string): Observable<SubscriptionResponse>;
     /** Send an event to all relays */
     event(event: NostrEvent): Observable<PublishResponse>;
     /** Publish an event to all relays with retries ( default 3 retries ) */
     publish(event: NostrEvent, opts?: PublishOptions): Promise<PublishResponse[]>;
     /** Request events from all relays with retries ( default 3 retries ) */
-    request(filters: FilterInput, opts?: RequestOptions): Observable<NostrEvent>;
+    request(filters: FilterInput, opts?: RequestOptions & {
+        eventStore?: IEventStoreActions;
+    }): Observable<NostrEvent>;
     /** Open a subscription to all relays with retries ( default 3 retries ) */
-    subscription(filters: FilterInput, opts?: SubscriptionOptions): Observable<SubscriptionResponse>;
+    subscription(filters: FilterInput, opts?: SubscriptionOptions & {
+        eventStore?: IEventStoreActions;
+    }): Observable<SubscriptionResponse>;
 }

package/dist/group.js

@@ -1,5 +1,6 @@
 import { nanoid } from "nanoid";
-import { catchError, EMPTY, endWith, ignoreElements, merge, of } from "rxjs";
+import { catchError, EMPTY, endWith, identity, ignoreElements, merge, of } from "rxjs";
+import { filterDuplicateEvents } from "applesauce-core";
 import { completeOnEose } from "./operators/complete-on-eose.js";
 import { onlyEvents } from "./operators/only-events.js";
 export class RelayGroup {
@@ -8,9 +9,13 @@ export class RelayGroup {
         this.relays = relays;
     }
     /** Takes an array of observables and only emits EOSE when all observables have emitted EOSE */
-    mergeEOSE(...requests) {
+    mergeEOSE(requests, eventStore) {
         // Create stream of events only
-        const events = merge(...requests).pipe(onlyEvents());
+        const events = merge(...requests).pipe(
+        // Ignore non event responses
+        onlyEvents(), 
+        // If an event store is provided, filter duplicate events
+        eventStore ? filterDuplicateEvents(eventStore) : identity);
         // Create stream that emits EOSE when all relays have sent EOSE
         const eose = merge(
         // Create a new map of requests that only emits EOSE
@@ -19,13 +24,16 @@ export class RelayGroup {
         endWith("EOSE"));
         return merge(events, eose);
     }
-    /** Make a request to all relays */
+    /**
+     * Make a request to all relays
+     * @note This does not deduplicate events
+     */
     req(filters, id = nanoid(8)) {
         const requests = this.relays.map((relay) => relay.req(filters, id).pipe(
         // Ignore connection errors
         catchError(() => of("EOSE"))));
         // Merge events and the single EOSE stream
-        return this.mergeEOSE(...requests);
+        return this.mergeEOSE(requests);
     }
     /** Send an event to all relays */
     event(event) {
@@ -43,12 +51,16 @@ export class RelayGroup {
     request(filters, opts) {
         return merge(...this.relays.map((relay) => relay.request(filters, opts).pipe(
         // Ignore individual connection errors
-        catchError(() => EMPTY))));
+        catchError(() => EMPTY)))).pipe(
+        // If an event store is provided, filter duplicate events
+        opts?.eventStore ? filterDuplicateEvents(opts.eventStore) : identity);
     }
     /** Open a subscription to all relays with retries ( default 3 retries ) */
     subscription(filters, opts) {
-        return this.mergeEOSE(...this.relays.map((relay) => relay.subscription(filters, opts).pipe(
+        return this.mergeEOSE(this.relays.map((relay) => relay.subscription(filters, opts).pipe(
         // Ignore individual connection errors
-        catchError(() => EMPTY))));
+        catchError(() => EMPTY))), 
+        // Pass event store so that duplicate events are removed
+        opts?.eventStore);
     }
 }

package/dist/pool.d.ts

@@ -2,7 +2,7 @@ import { type NostrEvent } from "nostr-tools";
 import { BehaviorSubject, Observable } from "rxjs";
 import { RelayGroup } from "./group.js";
 import { Relay, RelayOptions } from "./relay.js";
-import { IPool, PublishResponse, PublishOptions, RequestOptions, SubscriptionOptions, SubscriptionResponse, FilterInput, IRelay } from "./types.js";
+import { FilterInput, IPool, IRelay, PublishResponse, SubscriptionResponse } from "./types.js";
 export declare class RelayPool implements IPool {
     options?: RelayOptions | undefined;
     groups$: BehaviorSubject<Map<string, RelayGroup>>;
@@ -24,9 +24,9 @@ export declare class RelayPool implements IPool {
     /** Send an EVENT message to multiple relays */
     event(relays: string[], event: NostrEvent): Observable<PublishResponse>;
     /** Publish an event to multiple relays */
-    publish(relays: string[], event: NostrEvent, opts?: PublishOptions): Promise<PublishResponse[]>;
+    publish(relays: string[], event: Parameters<RelayGroup["publish"]>[0], opts?: Parameters<RelayGroup["publish"]>[1]): Promise<PublishResponse[]>;
     /** Request events from multiple relays */
-    request(relays: string[], filters: FilterInput, opts?: RequestOptions): Observable<NostrEvent>;
+    request(relays: string[], filters: Parameters<RelayGroup["request"]>[0], opts?: Parameters<RelayGroup["request"]>[1]): Observable<NostrEvent>;
     /** Open a subscription to multiple relays */
-    subscription(relays: string[], filters: FilterInput, opts?: SubscriptionOptions): Observable<SubscriptionResponse>;
+    subscription(relays: string[], filters: Parameters<RelayGroup["subscription"]>[0], opts?: Parameters<RelayGroup["subscription"]>[1]): Observable<SubscriptionResponse>;
 }

package/dist/pool.js

@@ -1,7 +1,7 @@
 import { BehaviorSubject } from "rxjs";
+import { normalizeURL } from "applesauce-core/helpers";
 import { RelayGroup } from "./group.js";
 import { Relay } from "./relay.js";
-import { normalizeURL } from "applesauce-core/helpers";
 export class RelayPool {
     options;
     groups$ = new BehaviorSubject(new Map());

package/dist/relay.d.ts

@@ -109,6 +109,10 @@ export declare class Relay implements IRelay {
     publish(event: NostrEvent, opts?: PublishOptions): Promise<PublishResponse>;
     /** Force close the connection */
     close(): void;
+    /** An async method that returns the NIP-11 information document for the relay */
+    getInformation(): Promise<RelayInformation | null>;
+    /** An async method that returns the NIP-11 limitations for the relay */
+    getLimitations(): Promise<RelayInformation["limitation"] | null>;
     /** Static method to fetch the NIP-11 information document for a relay */
     static fetchInformationDocument(url: string): Observable<RelayInformation | null>;
     /** Static method to create a reconnection method for each relay */

package/dist/relay.js

@@ -3,7 +3,7 @@ import { ensureHttpURL } from "applesauce-core/helpers";
 import { simpleTimeout } from "applesauce-core/observable";
 import { nanoid } from "nanoid";
 import { nip42 } from "nostr-tools";
-import { BehaviorSubject, catchError, combineLatest, defer, endWith, filter, finalize, from, identity, ignoreElements, isObservable, lastValueFrom, map, merge, mergeMap, mergeWith, NEVER, of, repeat, retry, scan, share, shareReplay, Subject, switchMap, take, takeUntil, tap, throwError, timeout, timer, } from "rxjs";
+import { BehaviorSubject, catchError, combineLatest, defer, endWith, filter, finalize, firstValueFrom, from, identity, ignoreElements, isObservable, lastValueFrom, map, merge, mergeMap, mergeWith, NEVER, of, repeat, retry, scan, share, shareReplay, Subject, switchMap, take, takeUntil, tap, throwError, timeout, timer, } from "rxjs";
 import { webSocket } from "rxjs/webSocket";
 import { completeOnEose } from "./operators/complete-on-eose.js";
 import { markFromRelay } from "./operators/mark-from-relay.js";
@@ -145,10 +145,10 @@ export class Relay {
         }).pipe(
         // if the fetch fails, return null
         catchError(() => of(null)), 
-        // cache the result
-        shareReplay(1), 
         // update the internal state
-        tap((info) => (this._nip11 = info)));
+        tap((info) => (this._nip11 = info)), 
+        // cache the result
+        shareReplay(1));
         this.limitations$ = this.information$.pipe(map((info) => info?.limitation));
         // Create observables that track if auth is required for REQ or EVENT
         this.authRequiredForRead$ = this.receivedAuthRequiredForReq.pipe(tap((required) => required && this.log("Auth required for REQ")), shareReplay(1));
@@ -417,6 +417,14 @@ export class Relay {
     close() {
         this.socket.unsubscribe();
     }
+    /** An async method that returns the NIP-11 information document for the relay */
+    async getInformation() {
+        return firstValueFrom(this.information$);
+    }
+    /** An async method that returns the NIP-11 limitations for the relay */
+    async getLimitations() {
+        return firstValueFrom(this.limitations$);
+    }
     /** Static method to fetch the NIP-11 information document for a relay */
     static fetchInformationDocument(url) {
         return from(fetch(ensureHttpURL(url), { headers: { Accept: "application/nostr+json" } }).then((res) => res.json())).pipe(

package/dist/types.d.ts

@@ -103,9 +103,9 @@ export interface IPool {
     /** Send an EVENT message */
     event(relays: string[], event: NostrEvent): Observable<PublishResponse>;
     /** Send an EVENT message to relays with retries */
-    publish(relays: string[], event: NostrEvent, opts?: PublishOptions): Promise<PublishResponse[]>;
+    publish(relays: string[], event: Parameters<IGroup["publish"]>[0], opts?: Parameters<IGroup["publish"]>[1]): Promise<PublishResponse[]>;
     /** Send a REQ message to relays with retries */
-    request(relays: string[], filters: FilterInput, opts?: RequestOptions): Observable<NostrEvent>;
+    request(relays: string[], filters: Parameters<IGroup["request"]>[0], opts?: Parameters<IGroup["request"]>[1]): Observable<NostrEvent>;
     /** Open a subscription to relays with retries */
-    subscription(relays: string[], filters: FilterInput, opts?: SubscriptionOptions): Observable<SubscriptionResponse>;
+    subscription(relays: string[], filters: Parameters<IGroup["subscription"]>[0], opts?: Parameters<IGroup["subscription"]>[1]): Observable<SubscriptionResponse>;
 }

package/package.json

@@ -1,19 +1,17 @@
 {
   "name": "applesauce-relay",
-  "version": "0.0.0-next-20250828145754",
+  "version": "0.0.0-next-20250913205403",
   "description": "nostr relay communication framework built on rxjs",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "keywords": [
-    "nostr",
-    "applesauce"
+    "nostr"
   ],
   "author": "hzrd149",
   "license": "MIT",
   "files": [
-    "dist",
-    "applesauce"
+    "dist"
   ],
   "exports": {
     ".": {
@@ -54,17 +52,16 @@
   },
   "dependencies": {
     "@noble/hashes": "^1.7.1",
-    "applesauce-core": "0.0.0-next-20250828145754",
+    "applesauce-core": "0.0.0-next-20250913205403",
     "nanoid": "^5.0.9",
     "nostr-tools": "~2.15",
     "rxjs": "^7.8.1"
   },
   "devDependencies": {
     "@hirez_io/observer-spy": "^2.2.0",
-    "applesauce-signers": "0.0.0-next-20250828145754",
-    "@vitest/expect": "^3.1.1",
+    "applesauce-signers": "0.0.0-next-20250913205403",
     "typescript": "^5.7.3",
-    "vitest": "^3.2.3",
+    "vitest": "^3.2.4",
     "vitest-websocket-mock": "^0.5.0"
   },
   "funding": {