applesauce-common 0.0.0-next-20251220152312 → 0.0.0-next-20251231055351

package/README.md

@@ -1,11 +1,33 @@
 # applesauce-common
 
-AppleSauce is a collection of utilities for building reactive nostr applications. The common package provides NIP-specific helpers and models for working with various Nostr Improvement Proposals (NIPs).
+AppleSauce is a collection of utilities for building reactive nostr applications. The common package provides NIP-specific helpers, models, operations, and utilities for working with various Nostr Improvement Proposals (NIPs). This package contains all the extra functionality that applications can use with nostr events that is not directly related to the core protocol.
+
+## Installation
+
+```bash
+npm install applesauce-common
+```
+
+or
+
+```bash
+yarn add applesauce-common
+```
+
+or
+
+```bash
+pnpm add applesauce-common
+```
 
 ## Key Components
 
 - **Helpers**: NIP-specific utility methods for parsing and extracting data from nostr events
-- **Models**: Complex subscriptions for NIP-specific nostr data patterns
+- **Models**: Complex reactive subscriptions for NIP-specific nostr data patterns
+- **Operations**: Functions for creating and constructing nostr events according to various NIPs
+- **Blueprints**: Event blueprints and templates for creating properly formatted nostr events
+- **Casts**: Type casting utilities for converting between different event representations
+- **Observable**: Observable utilities and operators for working with reactive streams of nostr events
 
 ## Documentation
 
@@ -48,12 +70,31 @@ thread.subscribe((thread) => {
 
 ## Supported NIPs
 
-This package includes helpers and models for various NIPs including:
+This package includes helpers, models, and operations for various NIPs including:
 
 - NIP-10 (Threading)
+- NIP-18 (Reposts)
 - NIP-22 (Comments)
-- NIP-53 (Streams)
 - NIP-23 (Articles)
+- NIP-25 (Reactions)
+- NIP-28 (Channels)
 - NIP-52 (Calendar Events)
+- NIP-53 (Streams)
+- NIP-57 (Zaps)
 - NIP-88 (Polls)
 - And many more...
+
+## Exports
+
+The package provides several export paths:
+
+- `applesauce-common` - Main exports (Helpers, Models, Operations, etc.)
+- `applesauce-common/helpers` - All helper functions
+- `applesauce-common/helpers/*` - Individual helper modules
+- `applesauce-common/models` - All model functions
+- `applesauce-common/models/*` - Individual model modules
+- `applesauce-common/operations` - All operation functions
+- `applesauce-common/operations/*` - Individual operation modules
+- `applesauce-common/blueprints` - Event blueprints
+- `applesauce-common/casts` - Type casting utilities
+- `applesauce-common/observable` - Observable utilities

package/dist/blueprints/__register__.d.ts

@@ -4,3 +4,4 @@ import "./note.js";
 import "./reaction.js";
 import "./share.js";
 import "./poll.js";
+import "./torrent.js";

package/dist/blueprints/__register__.js

@@ -5,3 +5,4 @@ import "./note.js";
 import "./reaction.js";
 import "./share.js";
 import "./poll.js";
+import "./torrent.js";

package/dist/blueprints/comment.d.ts

@@ -1,12 +1,13 @@
 import { NostrEvent, EventTemplate } from "applesauce-core/helpers/event";
 import { TextContentOptions } from "applesauce-core/operations/content";
 import { MetaTagOptions } from "applesauce-core/operations/event";
+import { CommentPointer } from "../helpers/comment.js";
 export type CommentBlueprintOptions = TextContentOptions & MetaTagOptions;
 /** A blueprint to create a NIP-22 comment event */
-export declare function CommentBlueprint(parent: NostrEvent, content: string, options?: CommentBlueprintOptions): import("applesauce-core/event-factory").EventBlueprint;
+export declare function CommentBlueprint(parent: NostrEvent | CommentPointer, content: string, options?: CommentBlueprintOptions): import("applesauce-core/event-factory").EventBlueprint;
 declare module "applesauce-core/event-factory" {
     interface EventFactory {
         /** Create a NIP-22 comment event */
-        comment(parent: NostrEvent, content: string, options?: CommentBlueprintOptions): Promise<EventTemplate>;
+        comment(parent: NostrEvent | CommentPointer, content: string, options?: CommentBlueprintOptions): Promise<EventTemplate>;
     }
 }

package/dist/blueprints/torrent.d.ts

@@ -1,3 +1,4 @@
+import { EventTemplate } from "applesauce-core/helpers/event";
 import { MetaTagOptions } from "applesauce-core/operations/event";
 import { TorrentExternalIdentifier, TorrentFile } from "../helpers/torrent.js";
 export type TorrentBlueprintOptions = MetaTagOptions & {
@@ -21,3 +22,9 @@ export type TorrentBlueprintOptions = MetaTagOptions & {
  * Creates a torrent event with info hash and optional metadata
  */
 export declare function TorrentBlueprint(infoHash: string, content: string, options?: TorrentBlueprintOptions): import("applesauce-core/event-factory").EventBlueprint;
+declare module "applesauce-core/event-factory" {
+    interface EventFactory {
+        /** Create a NIP-35 torrent event (kind 2003) */
+        torrent(infoHash: string, content: string, options?: TorrentBlueprintOptions): Promise<EventTemplate>;
+    }
+}

package/dist/blueprints/torrent.js

@@ -1,4 +1,4 @@
-import { blueprint } from "applesauce-core/event-factory";
+import { blueprint, EventFactory } from "applesauce-core/event-factory";
 import { eventPipe } from "applesauce-core/helpers/pipeline";
 import { setContent } from "applesauce-core/operations/content";
 import { setMetaTags } from "applesauce-core/operations/event";
@@ -23,3 +23,7 @@ export function TorrentBlueprint(infoHash, content, options) {
         ? eventPipe(...options.externalIdentifiers.map((id) => addTorrentExternalIdentifier(id)))
         : undefined, setMetaTags({ ...options, alt: options?.alt ?? `Torrent: ${options?.title ?? infoHash}` }));
 }
+// Register this blueprint with EventFactory
+EventFactory.prototype.torrent = function (infoHash, content, options) {
+    return this.create(TorrentBlueprint, infoHash, content, options);
+};

package/dist/casts/article.d.ts

@@ -1,6 +1,7 @@
 import { NostrEvent } from "applesauce-core/helpers";
 import { ArticleEvent } from "../helpers/article.js";
 import { CastRefEventStore, EventCast } from "./cast.js";
+import { Reaction } from "./reaction.js";
 export declare class Article extends EventCast<ArticleEvent> {
     constructor(event: NostrEvent, store: CastRefEventStore);
     get title(): string;
@@ -14,4 +15,5 @@ export declare class Article extends EventCast<ArticleEvent> {
     get address(): `naddr1${string}`;
     /** An observable of the address with relay hints from the authors outboxes */
     get address$(): import("applesauce-core").Observable<`naddr1${string}`>;
+    get reactions$(): import("../observable/chainable.js").ChainableObservable<Reaction[]>;
 }

package/dist/casts/article.js

@@ -2,7 +2,10 @@ import { withImmediateValueOrDefault } from "applesauce-core";
 import { addRelayHintsToPointer, getAddressPointerForEvent, naddrEncode } from "applesauce-core/helpers";
 import { map } from "rxjs";
 import { getArticleImage, getArticlePublished, getArticleSummary, getArticleTitle, isValidArticle, } from "../helpers/article.js";
+import { ReactionsModel } from "../models/reactions.js";
+import { castTimelineStream } from "../observable/cast-stream.js";
 import { EventCast } from "./cast.js";
+import { Reaction } from "./reaction.js";
 export class Article extends EventCast {
     constructor(event, store) {
         if (!isValidArticle(event))
@@ -38,4 +41,7 @@ export class Article extends EventCast {
     get address$() {
         return this.pointer$.pipe(map((pointer) => naddrEncode(pointer)));
     }
+    get reactions$() {
+        return this.$$ref("reactions$", (store) => store.model(ReactionsModel, this.event).pipe(castTimelineStream(Reaction, store)));
+    }
 }

package/dist/casts/bookmarks.d.ts

@@ -14,9 +14,9 @@ declare class BookmarksListBase<T extends BookmarkListEvent | BookmarkSetEvent>
     /** Get the unlocked hidden bookmarks */
     get hidden(): import("../helpers/bookmark.js").BookmarkPointer[] | undefined;
     /** An observable that updates when hidden bookmarks are unlocked */
-    get hidden$(): import("../observable/chainable.js").ChainableObservable<import("../helpers/bookmark.js").BookmarkPointer[]>;
-    get hiddenNotes$(): import("../observable/chainable.js").ChainableObservable<Note[]>;
-    get hiddenArticles$(): import("../observable/chainable.js").ChainableObservable<Article[]>;
+    get hidden$(): import("../observable/chainable.js").ChainableObservable<import("../helpers/bookmark.js").BookmarkPointer[] | undefined>;
+    get hiddenNotes$(): import("../observable/chainable.js").ChainableObservable<Note[] | undefined>;
+    get hiddenArticles$(): import("../observable/chainable.js").ChainableObservable<Article[] | undefined>;
     /** Whether the bookmark set has hidden bookmarks */
     get hasHidden(): boolean;
     /** Whether the bookmark set is unlocked */

package/dist/casts/bookmarks.js

@@ -1,5 +1,5 @@
 import { hasHiddenContent, isAddressPointer, isEventPointer, } from "applesauce-core/helpers";
-import { defined, watchEventUpdates } from "applesauce-core/observable";
+import { watchEventUpdates } from "applesauce-core/observable";
 import { combineLatest, map, of, switchMap } from "rxjs";
 import { getBookmarks, getHiddenBookmarks, isHiddenBookmarksUnlocked, isValidBookmarkList, isValidBookmarkSet, unlockHiddenBookmarks, } from "../helpers/bookmark.js";
 import { castTimelineStream } from "../observable/cast-stream.js";
@@ -38,15 +38,27 @@ class BookmarksListBase extends EventCast {
         // Watch for event updates
         watchEventUpdates(store), 
         // Get hidden bookmarks
-        map((event) => event && getHiddenBookmarks(event)), 
-        /** Only emit when the hidden bookmarks are unlocked */
-        defined()));
+        map((event) => event && getHiddenBookmarks(event))));
     }
     get hiddenNotes$() {
-        return this.$$ref("hiddenNotes$", (store) => this.hidden$.pipe(switchMap((hidden) => combineLatest(hidden.filter((pointer) => isEventPointer(pointer)).map((pointer) => store.event(pointer)))), map((arr) => arr.filter((e) => !!e)), castTimelineStream(Note, store)));
+        return this.$$ref("hiddenNotes$", (store) => this.hidden$.pipe(switchMap((hidden) => {
+            if (hidden === undefined)
+                return of(undefined);
+            const eventPointers = hidden.filter((pointer) => isEventPointer(pointer));
+            if (eventPointers.length === 0)
+                return of([]);
+            return combineLatest(eventPointers.map((pointer) => store.event(pointer))).pipe(map((arr) => arr.filter((e) => !!e)), castTimelineStream(Note, store));
+        })));
     }
     get hiddenArticles$() {
-        return this.$$ref("hiddenArticles$", (store) => this.hidden$.pipe(switchMap((hidden) => combineLatest(hidden.filter((pointer) => isAddressPointer(pointer)).map((pointer) => store.replaceable(pointer)))), map((arr) => arr.filter((e) => !!e)), castTimelineStream(Article, store)));
+        return this.$$ref("hiddenArticles$", (store) => this.hidden$.pipe(switchMap((hidden) => {
+            if (hidden === undefined)
+                return of(undefined);
+            const addressPointers = hidden.filter((pointer) => isAddressPointer(pointer));
+            if (addressPointers.length === 0)
+                return of([]);
+            return combineLatest(addressPointers.map((pointer) => store.replaceable(pointer))).pipe(map((arr) => arr.filter((e) => !!e)), castTimelineStream(Article, store));
+        })));
     }
     /** Whether the bookmark set has hidden bookmarks */
     get hasHidden() {

package/dist/casts/comment.d.ts

@@ -1,6 +1,7 @@
 import { NostrEvent } from "applesauce-core/helpers/event";
 import { CommentEvent } from "../helpers/comment.js";
 import { CastRefEventStore, EventCast } from "./cast.js";
+import { Reaction } from "./reaction.js";
 import { Zap } from "./zap.js";
 /** Cast a kind 1111 event to a Comment */
 export declare class Comment extends EventCast<CommentEvent> {
@@ -13,4 +14,5 @@ export declare class Comment extends EventCast<CommentEvent> {
     get parent$(): import("../observable/chainable.js").ChainableObservable<import("nostr-tools").Event | undefined>;
     get zaps$(): import("../observable/chainable.js").ChainableObservable<Zap[]>;
     get replies$(): import("../observable/chainable.js").ChainableObservable<Comment[]>;
+    get reactions$(): import("../observable/chainable.js").ChainableObservable<Reaction[]>;
 }

package/dist/casts/comment.js

@@ -1,9 +1,11 @@
 import { of } from "rxjs";
 import { getCommentReplyPointer, getCommentRootPointer, isValidComment } from "../helpers/comment.js";
 import { CommentsModel } from "../models/comments.js";
+import { ReactionsModel } from "../models/reactions.js";
 import { EventZapsModel } from "../models/zaps.js";
 import { castTimelineStream } from "../observable/cast-stream.js";
 import { EventCast } from "./cast.js";
+import { Reaction } from "./reaction.js";
 import { Zap } from "./zap.js";
 /** Cast a kind 1111 event to a Comment */
 export class Comment extends EventCast {
@@ -46,4 +48,7 @@ export class Comment extends EventCast {
     get replies$() {
         return this.$$ref("replies$", (store) => store.model(CommentsModel, this.event).pipe(castTimelineStream(Comment, store)));
     }
+    get reactions$() {
+        return this.$$ref("reactions$", (store) => store.model(ReactionsModel, this.event).pipe(castTimelineStream(Reaction, store)));
+    }
 }

package/dist/casts/groups.d.ts

@@ -0,0 +1,19 @@
+import { HiddenContentSigner } from "applesauce-core/helpers";
+import { KnownEvent, NostrEvent } from "applesauce-core/helpers/event";
+import { GROUPS_LIST_KIND } from "../helpers/groups.js";
+import { CastRefEventStore, EventCast } from "./cast.js";
+export declare class GroupsList extends EventCast<KnownEvent<typeof GROUPS_LIST_KIND>> {
+    constructor(event: NostrEvent, store: CastRefEventStore);
+    /** The public groups in the list */
+    get groups(): import("../helpers/groups.js").GroupPointer[];
+    /** Get the unlocked hidden groups */
+    get hidden(): import("../helpers/groups.js").GroupPointer[] | undefined;
+    /** An observable that updates when hidden groups are unlocked */
+    get hidden$(): import("../observable/chainable.js").ChainableObservable<import("../helpers/groups.js").GroupPointer[] | undefined>;
+    /** Whether the groups list has hidden groups */
+    get hasHidden(): boolean;
+    /** Whether the groups list is unlocked */
+    get unlocked(): boolean;
+    /** Unlocks the hidden groups on the groups list */
+    unlock(signer: HiddenContentSigner): Promise<import("../helpers/groups.js").GroupPointer[]>;
+}

package/dist/casts/groups.js

@@ -0,0 +1,43 @@
+import { hasHiddenContent } from "applesauce-core/helpers";
+import { watchEventUpdates } from "applesauce-core/observable";
+import { map, of } from "rxjs";
+import { getHiddenGroups, getPublicGroups, GROUPS_LIST_KIND, isHiddenGroupsUnlocked, unlockHiddenGroups, } from "../helpers/groups.js";
+import { EventCast } from "./cast.js";
+function isValidGroupsList(event) {
+    return event.kind === GROUPS_LIST_KIND;
+}
+export class GroupsList extends EventCast {
+    constructor(event, store) {
+        if (!isValidGroupsList(event))
+            throw new Error("Invalid groups list");
+        super(event, store);
+    }
+    /** The public groups in the list */
+    get groups() {
+        return getPublicGroups(this.event);
+    }
+    /** Get the unlocked hidden groups */
+    get hidden() {
+        return getHiddenGroups(this.event);
+    }
+    /** An observable that updates when hidden groups are unlocked */
+    get hidden$() {
+        return this.$$ref("hidden$", (store) => of(this.event).pipe(
+        // Watch for event updates
+        watchEventUpdates(store), 
+        // Get hidden groups
+        map((event) => event && getHiddenGroups(event))));
+    }
+    /** Whether the groups list has hidden groups */
+    get hasHidden() {
+        return hasHiddenContent(this.event);
+    }
+    /** Whether the groups list is unlocked */
+    get unlocked() {
+        return isHiddenGroupsUnlocked(this.event);
+    }
+    /** Unlocks the hidden groups on the groups list */
+    async unlock(signer) {
+        return unlockHiddenGroups(this.event, signer);
+    }
+}

package/dist/casts/index.d.ts

@@ -2,11 +2,17 @@ export * from "./article.js";
 export * from "./bookmarks.js";
 export * from "./cast.js";
 export * from "./comment.js";
+export * from "./groups.js";
 export * from "./mutes.js";
 export * from "./note.js";
 export * from "./profile.js";
+export * from "./reaction.js";
+export * from "./relay-discovery.js";
 export * from "./relay-lists.js";
+export * from "./relay-monitor.js";
+export * from "./report.js";
 export * from "./share.js";
 export * from "./stream.js";
+export * from "./torrent.js";
 export * from "./user.js";
 export * from "./zap.js";

package/dist/casts/index.js

@@ -2,11 +2,17 @@ export * from "./article.js";
 export * from "./bookmarks.js";
 export * from "./cast.js";
 export * from "./comment.js";
+export * from "./groups.js";
 export * from "./mutes.js";
 export * from "./note.js";
 export * from "./profile.js";
+export * from "./reaction.js";
+export * from "./relay-discovery.js";
 export * from "./relay-lists.js";
+export * from "./relay-monitor.js";
+export * from "./report.js";
 export * from "./share.js";
 export * from "./stream.js";
+export * from "./torrent.js";
 export * from "./user.js";
 export * from "./zap.js";

package/dist/casts/note.d.ts

@@ -1,6 +1,7 @@
 import { EventPointer, KnownEvent, NostrEvent } from "applesauce-core/helpers";
 import { CastRefEventStore, EventCast } from "./cast.js";
 import { Comment } from "./comment.js";
+import { Reaction } from "./reaction.js";
 import { Share } from "./share.js";
 import { Zap } from "./zap.js";
 export declare class Note extends EventCast<KnownEvent<1>> {
@@ -10,8 +11,15 @@ export declare class Note extends EventCast<KnownEvent<1>> {
     get isRoot(): boolean;
     /** An array of events that this note is quoting */
     get quotePointers(): EventPointer[];
+    /** Gets the NIP-10 root event */
+    get threadRoot$(): import("../observable/chainable.js").ChainableObservable<import("nostr-tools").Event | undefined>;
+    /** Gets the NIP-10 reply event */
+    get replyingTo$(): import("../observable/chainable.js").ChainableObservable<import("nostr-tools").Event | undefined>;
+    /** Gets the NIP-10 replies to this event */
     get replies$(): import("../observable/chainable.js").ChainableObservable<Note[]>;
+    /** Gets the NIP-22 comments to this event */
     get comments$(): import("../observable/chainable.js").ChainableObservable<Comment[]>;
     get zaps$(): import("../observable/chainable.js").ChainableObservable<Zap[]>;
     get shares$(): import("../observable/chainable.js").ChainableObservable<Share[]>;
+    get reactions$(): import("../observable/chainable.js").ChainableObservable<Reaction[]>;
 }

package/dist/casts/note.js

@@ -1,14 +1,17 @@
 import { getEventPointerFromQTag, isQTag, kinds, processTags, } from "applesauce-core/helpers";
 import { getNip10References } from "../helpers/threading.js";
 import { CommentsModel } from "../models/comments.js";
+import { ReactionsModel } from "../models/reactions.js";
 import { SharesModel } from "../models/shares.js";
 import { RepliesModel } from "../models/thread.js";
 import { EventZapsModel } from "../models/zaps.js";
 import { castTimelineStream } from "../observable/cast-stream.js";
 import { EventCast } from "./cast.js";
 import { Comment } from "./comment.js";
+import { Reaction } from "./reaction.js";
 import { Share } from "./share.js";
 import { Zap } from "./zap.js";
+import { of } from "rxjs";
 function isValidNote(event) {
     return event.kind === kinds.ShortTextNote;
 }
@@ -31,9 +34,33 @@ export class Note extends EventCast {
     get quotePointers() {
         return processTags(this.event.tags, (t) => (isQTag(t) ? t : undefined), (t) => getEventPointerFromQTag(t) ?? undefined);
     }
+    /** Gets the NIP-10 root event */
+    get threadRoot$() {
+        return this.$$ref("threadRoot$", (store) => {
+            const pointer = this.references.root;
+            // Return undefined if no root reference
+            if (pointer === undefined)
+                return of(undefined);
+            // Get the event by either the address or event pointer
+            return store.event(pointer.a ?? pointer.e);
+        });
+    }
+    /** Gets the NIP-10 reply event */
+    get replyingTo$() {
+        return this.$$ref("replyingTo$", (store) => {
+            const pointer = this.references.reply;
+            // Return undefined if no reply reference
+            if (pointer === undefined)
+                return of(undefined);
+            // Get the event by either the address or event pointer
+            return store.event(pointer.a ?? pointer.e);
+        });
+    }
+    /** Gets the NIP-10 replies to this event */
     get replies$() {
         return this.$$ref("replies$", (store) => store.model(RepliesModel, this.event, [kinds.ShortTextNote]).pipe(castTimelineStream(Note, store)));
     }
+    /** Gets the NIP-22 comments to this event */
     get comments$() {
         return this.$$ref("comments$", (store) => store.model(CommentsModel, this.event).pipe(castTimelineStream(Comment, store)));
     }
@@ -43,4 +70,7 @@ export class Note extends EventCast {
     get shares$() {
         return this.$$ref("shares$", (store) => store.model(SharesModel, this.event).pipe(castTimelineStream(Share, store)));
     }
+    get reactions$() {
+        return this.$$ref("reactions$", (store) => store.model(ReactionsModel, this.event).pipe(castTimelineStream(Reaction, store)));
+    }
 }

package/dist/casts/profile.d.ts

@@ -8,9 +8,17 @@ export declare class Profile extends EventCast<ProfileEvent> {
     get displayName(): string | undefined;
     get about(): string | undefined;
     get picture(): string | undefined;
+    get banner(): string | undefined;
     get dnsIdentity(): string | undefined;
     get website(): string | undefined;
     get lud16(): string | undefined;
     get lud06(): string | undefined;
     get lightningAddress(): string | undefined;
+    get bot(): boolean | undefined;
+    get birthday(): {
+        year?: number;
+        month?: number;
+        day?: number;
+    } | undefined;
+    get languages(): string[] | undefined;
 }

package/dist/casts/profile.js

@@ -22,6 +22,9 @@ export class Profile extends EventCast {
     get picture() {
         return getProfilePicture(this.metadata);
     }
+    get banner() {
+        return this.metadata.banner;
+    }
     get dnsIdentity() {
         return this.metadata.nip05;
     }
@@ -37,4 +40,13 @@ export class Profile extends EventCast {
     get lightningAddress() {
         return this.metadata.lud16 || this.metadata.lud06;
     }
+    get bot() {
+        return this.metadata.bot;
+    }
+    get birthday() {
+        return this.metadata.birthday;
+    }
+    get languages() {
+        return this.metadata.languages;
+    }
 }

package/dist/casts/reaction.d.ts

@@ -0,0 +1,17 @@
+import { KnownEvent, NostrEvent } from "applesauce-core/helpers/event";
+import { CastRefEventStore, EventCast } from "./cast.js";
+export declare class Reaction extends EventCast<KnownEvent<7>> {
+    constructor(event: NostrEvent, store: CastRefEventStore);
+    /** Get the emoji content of the reaction (defaults to "+" if empty) */
+    get content(): string;
+    /** Get the custom emoji if this reaction uses a custom emoji */
+    get emoji(): import("../helpers/emoji.js").Emoji | undefined;
+    /** Get the event pointer for the event being reacted to */
+    get eventPointer(): import("nostr-tools/nip19").EventPointer | undefined;
+    /** Get the address pointer for the event being reacted to (for replaceable events) */
+    get addressPointer(): import("nostr-tools/nip19").AddressPointer | undefined;
+    /** Get the pointer (event or address) for the event being reacted to */
+    get pointer(): import("nostr-tools/nip19").EventPointer | import("nostr-tools/nip19").AddressPointer | undefined;
+    /** Get the event that this reaction is reacting to */
+    get reactedTo$(): import("../observable/chainable.js").ChainableObservable<import("nostr-tools").Event | undefined>;
+}

package/dist/casts/reaction.js

@@ -0,0 +1,46 @@
+import { kinds } from "applesauce-core/helpers/event";
+import { of } from "rxjs";
+import { getReactionEmoji } from "../helpers/emoji.js";
+import { getReactionAddressPointer, getReactionEventPointer } from "../helpers/reaction.js";
+import { EventCast } from "./cast.js";
+import { addRelayHintsToPointer } from "applesauce-core/helpers";
+function isValidReaction(event) {
+    return event.kind === kinds.Reaction;
+}
+export class Reaction extends EventCast {
+    constructor(event, store) {
+        if (!isValidReaction(event))
+            throw new Error("Invalid reaction");
+        super(event, store);
+    }
+    /** Get the emoji content of the reaction (defaults to "+" if empty) */
+    get content() {
+        return this.event.content || "+";
+    }
+    /** Get the custom emoji if this reaction uses a custom emoji */
+    get emoji() {
+        return getReactionEmoji(this.event);
+    }
+    /** Get the event pointer for the event being reacted to */
+    get eventPointer() {
+        return getReactionEventPointer(this.event);
+    }
+    /** Get the address pointer for the event being reacted to (for replaceable events) */
+    get addressPointer() {
+        return getReactionAddressPointer(this.event);
+    }
+    /** Get the pointer (event or address) for the event being reacted to */
+    get pointer() {
+        return this.addressPointer || this.eventPointer;
+    }
+    /** Get the event that this reaction is reacting to */
+    get reactedTo$() {
+        return this.$$ref("reactedTo$", (store) => {
+            const pointer = this.pointer;
+            if (!pointer)
+                return of(undefined);
+            else
+                return store.event(addRelayHintsToPointer(pointer, this.seen));
+        });
+    }
+}

package/dist/casts/relay-discovery.d.ts

@@ -0,0 +1,29 @@
+import { NostrEvent } from "applesauce-core/helpers";
+import { RelayDiscoveryEvent } from "../helpers/relay-discovery.js";
+import { CastRefEventStore, EventCast } from "./cast.js";
+/** Cast a kind 30166 event to a RelayDiscovery */
+export declare class RelayDiscovery extends EventCast<RelayDiscoveryEvent> {
+    constructor(event: NostrEvent, store: CastRefEventStore);
+    /** Gets the relay URL from this discovery event (from the `d` tag) */
+    get url(): string | undefined;
+    /** Gets the round-trip time (RTT) for opening the relay connection (in milliseconds) */
+    get rttOpen(): number | undefined;
+    /** Gets the round-trip time (RTT) for reading from the relay (in milliseconds) */
+    get rttRead(): number | undefined;
+    /** Gets the round-trip time (RTT) for writing to the relay (in milliseconds) */
+    get rttWrite(): number | undefined;
+    /** Gets the network type from this discovery event (clearnet, tor, i2p, loki) */
+    get networkType(): string | undefined;
+    /** Gets all relay attributes from this discovery event (from `W` tags) */
+    get attributes(): string[];
+    /** Gets all supported NIPs from this discovery event (from `N` tags) */
+    get supportedNIPs(): string[];
+    /** Gets all requirements from this discovery event (from `R` tags) */
+    get requirements(): string[];
+    /** Gets all topics from this discovery event (from `t` tags) */
+    get topics(): string[];
+    /** Gets all accepted and unaccepted kinds from this discovery event (from `k` tags) */
+    get acceptedKinds(): string[];
+    /** Gets the geohash from this discovery event (NIP-52 geohash) */
+    get geohash(): string | undefined;
+}

package/dist/casts/relay-discovery.js

@@ -0,0 +1,54 @@
+import { getRelayDiscoveryAcceptedKinds, getRelayDiscoveryAttributes, getRelayDiscoveryGeohash, getRelayDiscoveryNetworkType, getRelayDiscoveryRequirements, getRelayDiscoveryRTT, getRelayDiscoverySupportedNIPs, getRelayDiscoveryTopics, getRelayDiscoveryURL, isValidRelayDiscovery, } from "../helpers/relay-discovery.js";
+import { EventCast } from "./cast.js";
+/** Cast a kind 30166 event to a RelayDiscovery */
+export class RelayDiscovery extends EventCast {
+    constructor(event, store) {
+        if (!isValidRelayDiscovery(event))
+            throw new Error("Invalid relay discovery event");
+        super(event, store);
+    }
+    /** Gets the relay URL from this discovery event (from the `d` tag) */
+    get url() {
+        return getRelayDiscoveryURL(this.event);
+    }
+    /** Gets the round-trip time (RTT) for opening the relay connection (in milliseconds) */
+    get rttOpen() {
+        return getRelayDiscoveryRTT(this.event, "open");
+    }
+    /** Gets the round-trip time (RTT) for reading from the relay (in milliseconds) */
+    get rttRead() {
+        return getRelayDiscoveryRTT(this.event, "read");
+    }
+    /** Gets the round-trip time (RTT) for writing to the relay (in milliseconds) */
+    get rttWrite() {
+        return getRelayDiscoveryRTT(this.event, "write");
+    }
+    /** Gets the network type from this discovery event (clearnet, tor, i2p, loki) */
+    get networkType() {
+        return getRelayDiscoveryNetworkType(this.event);
+    }
+    /** Gets all relay attributes from this discovery event (from `W` tags) */
+    get attributes() {
+        return getRelayDiscoveryAttributes(this.event);
+    }
+    /** Gets all supported NIPs from this discovery event (from `N` tags) */
+    get supportedNIPs() {
+        return getRelayDiscoverySupportedNIPs(this.event);
+    }
+    /** Gets all requirements from this discovery event (from `R` tags) */
+    get requirements() {
+        return getRelayDiscoveryRequirements(this.event);
+    }
+    /** Gets all topics from this discovery event (from `t` tags) */
+    get topics() {
+        return getRelayDiscoveryTopics(this.event);
+    }
+    /** Gets all accepted and unaccepted kinds from this discovery event (from `k` tags) */
+    get acceptedKinds() {
+        return getRelayDiscoveryAcceptedKinds(this.event);
+    }
+    /** Gets the geohash from this discovery event (NIP-52 geohash) */
+    get geohash() {
+        return getRelayDiscoveryGeohash(this.event);
+    }
+}