applesauce-extra 0.0.0-next-20251009095925

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 hzrd149
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,29 @@
+# Applesauce Extra
+
+A collection of stuff that doesn't fit into any applesauce package.
+
+## PrimalCache
+
+Extended relay interface for Primal's caching server. Provides access to Primal's enhanced API endpoints for content discovery, user recommendations, trending hashtags, notifications, and more. Includes methods for:
+
+- Content exploration and scoring
+- User search and recommendations
+- Trending hashtags and images
+- Notification management
+- Advanced search and feeds
+- Media metadata retrieval
+
+**Code:** [`src/primal.ts`](src/primal.ts)
+**Upstream:** [PrimalHQ/primal-server](https://github.com/PrimalHQ/primal-server)
+
+## Vertex
+
+Extended relay interface for the Vertex relay (relay.vertexlab.io). Provides reputation-based user discovery and verification services. Includes methods for:
+
+- Profile lookup with reputation scoring
+- Reputation verification
+- Credit balance checking
+- Automatic authentication handling
+
+**Code:** [`src/vertex.ts`](src/vertex.ts)
+**Upstream:** [vertexlab.io](https://vertexlab.io/docs/services/)

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./vertex.js";
+export * from "./primal.js";

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from "./vertex.js";
+export * from "./primal.js";

package/dist/primal.d.ts

@@ -0,0 +1,413 @@
+import type { NostrEvent } from "applesauce-core/helpers";
+import { Relay, type RelayOptions } from "applesauce-relay";
+import { Observable } from "rxjs";
+export declare const DEFAULT_PRIMAL_RELAY = "wss://cache2.primal.net/v1";
+export type ExploreLegendCounts = {
+    req: ["explore_legend_counts", {
+        pubkey: string;
+    }];
+    event: NostrEvent;
+};
+export type Explore = {
+    req: [
+        "explore",
+        {
+            timeframe: "popular" | "trending" | "recent";
+            pubkeys?: string[];
+            limit?: number;
+            created_after?: number;
+            since?: number;
+            until?: number;
+            offset?: number;
+            group_by_pubkey?: boolean;
+            user_pubkey?: string;
+            include_top_zaps?: boolean;
+            apply_humaness_check?: boolean;
+            gm_mode?: boolean;
+        }
+    ];
+    event: NostrEvent;
+};
+export type ExploreGlobalTrending24h = {
+    req: ["explore_global_trending_24h", {
+        limit?: number;
+    }];
+    event: NostrEvent;
+};
+export type ExploreGlobalMostZapped4h = {
+    req: ["explore_global_mostzapped_4h", {
+        limit?: number;
+    }];
+    event: NostrEvent;
+};
+export type Scored = {
+    req: [
+        "scored",
+        {
+            timeframe: "popular" | "trending" | "recent";
+            pubkeys?: string[];
+            limit?: number;
+            created_after?: number;
+            since?: number;
+            until?: number;
+            offset?: number;
+            group_by_pubkey?: boolean;
+            user_pubkey?: string;
+            include_top_zaps?: boolean;
+            apply_humaness_check?: boolean;
+            gm_mode?: boolean;
+        }
+    ];
+    event: NostrEvent;
+};
+export type ScoredUsers = {
+    req: ["scored_users", {
+        limit?: number;
+    }];
+    event: NostrEvent;
+};
+export type ScoredUsers24h = {
+    req: ["scored_users_24h", {
+        limit?: number;
+    }];
+    event: NostrEvent;
+};
+export type GetDefaultRelays = {
+    req: ["get_default_relays", {}];
+    event: NostrEvent;
+};
+export type GetRecommendedUsers = {
+    req: ["get_recommended_users", {
+        limit?: number;
+    }];
+    event: NostrEvent;
+};
+export type GetSuggestedUsers = {
+    req: ["get_suggested_users", {
+        limit?: number;
+    }];
+    event: NostrEvent;
+};
+export type UserProfileScoredContent = {
+    req: [
+        "user_profile_scored_content",
+        {
+            pubkey: string;
+            limit?: number;
+            created_after?: number;
+            since?: number;
+            until?: number;
+            offset?: number;
+        }
+    ];
+    event: NostrEvent;
+};
+export type UserProfileScoredMediaThumbnails = {
+    req: [
+        "user_profile_scored_media_thumbnails",
+        {
+            pubkey: string;
+            limit?: number;
+            created_after?: number;
+            since?: number;
+            until?: number;
+            offset?: number;
+        }
+    ];
+    event: NostrEvent;
+};
+export type Search = {
+    req: [
+        "search",
+        {
+            query: string;
+            limit?: number;
+            since?: number;
+            until?: number;
+            offset?: number;
+        }
+    ];
+    event: NostrEvent;
+};
+export type AdvancedSearch = {
+    req: [
+        "advanced_search",
+        {
+            query: string;
+            limit?: number;
+            since?: number;
+            until?: number;
+            offset?: number;
+            sort?: "latest" | "popular" | "trending";
+        }
+    ];
+    event: NostrEvent;
+};
+export type AdvancedFeed = {
+    req: [
+        "advanced_feed",
+        {
+            feed_type: string;
+            limit?: number;
+            since?: number;
+            until?: number;
+            offset?: number;
+        }
+    ];
+    event: NostrEvent;
+};
+export type Relays = {
+    req: ["relays", {}];
+    event: NostrEvent;
+};
+export type GetNotifications = {
+    req: [
+        "get_notifications",
+        {
+            pubkey: string;
+            limit?: number;
+            since?: number;
+            until?: number;
+            offset?: number;
+        }
+    ];
+    event: NostrEvent;
+};
+export type SetNotificationsSeen = {
+    req: ["set_notifications_seen", {
+        pubkey: string;
+        until: number;
+    }];
+    event: NostrEvent;
+};
+export type GetNotificationsSeen = {
+    req: ["get_notifications_seen", {
+        pubkey: string;
+    }];
+    event: NostrEvent;
+};
+export type UserSearch = {
+    req: ["user_search", {
+        query: string;
+        limit?: number;
+    }];
+    event: NostrEvent;
+};
+export type FeedDirective = {
+    req: [
+        "feed_directive",
+        {
+            pubkey: string;
+            feed_type: string;
+            limit?: number;
+            since?: number;
+            until?: number;
+            offset?: number;
+        }
+    ];
+    event: NostrEvent;
+};
+export type FeedDirective2 = {
+    req: [
+        "feed_directive_2",
+        {
+            pubkey: string;
+            feed_type: string;
+            limit?: number;
+            since?: number;
+            until?: number;
+            offset?: number;
+        }
+    ];
+    event: NostrEvent;
+};
+export type GetAdvancedFeeds = {
+    req: ["get_advanced_feeds", {}];
+    event: NostrEvent;
+};
+export type TrendingHashtags = {
+    req: ["trending_hashtags", {
+        limit?: number;
+    }];
+    event: NostrEvent;
+};
+export type TrendingHashtags4h = {
+    req: ["trending_hashtags_4h", {
+        limit?: number;
+    }];
+    event: NostrEvent;
+};
+export type TrendingHashtags7d = {
+    req: ["trending_hashtags_7d", {
+        limit?: number;
+    }];
+    event: NostrEvent;
+};
+export type TrendingImages = {
+    req: ["trending_images", {
+        limit?: number;
+    }];
+    event: NostrEvent;
+};
+export type TrendingImages4h = {
+    req: ["trending_images_4h", {
+        limit?: number;
+    }];
+    event: NostrEvent;
+};
+export type ReportUser = {
+    req: ["report_user", {
+        pubkey: string;
+        reason: string;
+    }];
+    event: NostrEvent;
+};
+export type ReportNote = {
+    req: ["report_note", {
+        event_id: string;
+        reason: string;
+    }];
+    event: NostrEvent;
+};
+export type GetFilterlist = {
+    req: ["get_filterlist", {}];
+    event: NostrEvent;
+};
+export type CheckFilterlist = {
+    req: ["check_filterlist", {
+        pubkeys: string[];
+    }];
+    event: NostrEvent;
+};
+export type BroadcastReply = {
+    req: ["broadcast_reply", {
+        event: NostrEvent;
+    }];
+    event: NostrEvent;
+};
+export type BroadcastEvents = {
+    req: ["broadcast_events", {
+        events: NostrEvent[];
+        relays: string[];
+    }];
+    event: NostrEvent;
+};
+export type TrustedUsers = {
+    req: ["trusted_users", {
+        limit?: number;
+        extended_response?: boolean;
+    }];
+    event: NostrEvent;
+};
+export type NoteMentions = {
+    req: [
+        "note_mentions",
+        {
+            event_id?: string;
+            pubkey?: string;
+            identifier?: string;
+            limit?: number;
+            offset?: number;
+            user_pubkey?: string;
+        }
+    ];
+    event: NostrEvent;
+};
+export type NoteMentionsCount = {
+    req: ["note_mentions_count", {
+        event_id: string;
+    }];
+    event: NostrEvent;
+};
+export type GetMediaMetadata = {
+    req: ["get_media_metadata", {
+        urls: string[];
+    }];
+    event: NostrEvent;
+};
+export type CacheRequest = ExploreLegendCounts | Explore | ExploreGlobalTrending24h | ExploreGlobalMostZapped4h | Scored | ScoredUsers | ScoredUsers24h | GetDefaultRelays | GetRecommendedUsers | GetSuggestedUsers | UserProfileScoredContent | UserProfileScoredMediaThumbnails | Search | AdvancedSearch | AdvancedFeed | Relays | GetNotifications | SetNotificationsSeen | GetNotificationsSeen | UserSearch | FeedDirective | FeedDirective2 | GetAdvancedFeeds | TrendingHashtags | TrendingHashtags4h | TrendingHashtags7d | TrendingImages | TrendingImages4h | ReportUser | ReportNote | GetFilterlist | CheckFilterlist | BroadcastReply | BroadcastEvents | TrustedUsers | NoteMentions | NoteMentionsCount | GetMediaMetadata;
+/**
+ * Extended relay interface for primal caching server
+ * @see https://github.com/PrimalHQ/primal-server/blob/main/src/app_ext.jl
+ */
+export declare class PrimalCache extends Relay {
+    constructor(url?: string, opts?: RelayOptions);
+    /** Make a "cache" request to the caching server */
+    cacheRequest<R extends CacheRequest>(request: CacheRequest["req"]): Observable<R["event"]>;
+    /** Get legend counts for explore page */
+    exploreLegendCounts(pubkey: string): Promise<ExploreLegendCounts["event"][]>;
+    /** Explore content with various filters */
+    explore(params: Explore["req"][1]): Promise<Explore["event"][]>;
+    /** Get global trending content from last 24 hours */
+    exploreGlobalTrending24h(limit?: number): Promise<ExploreGlobalTrending24h["event"][]>;
+    /** Get global most zapped content from last 4 hours */
+    exploreGlobalMostZapped4h(limit?: number): Promise<ExploreGlobalMostZapped4h["event"][]>;
+    /** Get scored content */
+    scored(params: Scored["req"][1]): Promise<Scored["event"][]>;
+    /** Get scored users */
+    scoredUsers(limit?: number): Promise<ScoredUsers["event"][]>;
+    /** Get scored users from last 24 hours */
+    scoredUsers24h(limit?: number): Promise<ScoredUsers24h["event"][]>;
+    /** Get default relays */
+    getDefaultRelays(): Promise<GetDefaultRelays["event"][]>;
+    /** Get recommended users */
+    getRecommendedUsers(limit?: number): Promise<GetRecommendedUsers["event"][]>;
+    /** Get suggested users */
+    getSuggestedUsers(limit?: number): Promise<GetSuggestedUsers["event"][]>;
+    /** Search for users by query */
+    userSearch(query: string, limit?: number): Promise<UserSearch["event"][]>;
+    /** Get trusted users */
+    trustedUsers(limit?: number, extendedResponse?: boolean): Promise<TrustedUsers["event"][]>;
+    /** Get user profile scored content */
+    userProfileScoredContent(params: UserProfileScoredContent["req"][1]): Promise<UserProfileScoredContent["event"][]>;
+    /** Get user profile scored media thumbnails */
+    userProfileScoredMediaThumbnails(params: UserProfileScoredMediaThumbnails["req"][1]): Promise<UserProfileScoredMediaThumbnails["event"][]>;
+    /** Search content */
+    search(params: Search["req"][1]): Promise<Search["event"][]>;
+    /** Advanced search */
+    advancedSearch(params: AdvancedSearch["req"][1]): Promise<AdvancedSearch["event"][]>;
+    /** Advanced feed */
+    advancedFeed(params: AdvancedFeed["req"][1]): Promise<AdvancedFeed["event"][]>;
+    /** Feed directive */
+    feedDirective(params: FeedDirective["req"][1]): Promise<FeedDirective["event"][]>;
+    /** Feed directive v2 */
+    feedDirective2(params: FeedDirective2["req"][1]): Promise<FeedDirective2["event"][]>;
+    /** Get advanced feeds */
+    getAdvancedFeeds(): Promise<GetAdvancedFeeds["event"][]>;
+    /** Get trending hashtags */
+    trendingHashtags(limit?: number): Promise<TrendingHashtags["event"][]>;
+    /** Get trending hashtags from last 4 hours */
+    trendingHashtags4h(limit?: number): Promise<TrendingHashtags4h["event"][]>;
+    /** Get trending hashtags from last 7 days */
+    trendingHashtags7d(limit?: number): Promise<TrendingHashtags7d["event"][]>;
+    /** Get trending images */
+    trendingImages(limit?: number): Promise<TrendingImages["event"][]>;
+    /** Get trending images from last 4 hours */
+    trendingImages4h(limit?: number): Promise<TrendingImages4h["event"][]>;
+    /** Get notifications */
+    getNotifications(params: GetNotifications["req"][1]): Promise<GetNotifications["event"][]>;
+    /** Set notifications as seen */
+    setNotificationsSeen(pubkey: string, until: number): Promise<SetNotificationsSeen["event"][]>;
+    /** Get notifications seen status */
+    getNotificationsSeen(pubkey: string): Promise<GetNotificationsSeen["event"][]>;
+    /** Get relays */
+    relays(): Promise<Relays["event"][]>;
+    /** Report user */
+    reportUser(pubkey: string, reason: string): Promise<ReportUser["event"][]>;
+    /** Report note */
+    reportNote(eventId: string, reason: string): Promise<ReportNote["event"][]>;
+    /** Get filterlist */
+    getFilterlist(): Promise<GetFilterlist["event"][]>;
+    /** Check filterlist */
+    checkFilterlist(pubkeys: string[]): Promise<CheckFilterlist["event"][]>;
+    /** Broadcast reply */
+    broadcastReply(event: NostrEvent): Promise<BroadcastReply["event"][]>;
+    /** Broadcast events */
+    broadcastEvents(events: NostrEvent[], relays: string[]): Promise<BroadcastEvents["event"][]>;
+    /** Get note mentions */
+    noteMentions(params: NoteMentions["req"][1]): Promise<NoteMentions["event"][]>;
+    /** Get note mentions count */
+    noteMentionsCount(eventId: string): Promise<NoteMentionsCount["event"][]>;
+    /** Get media metadata */
+    getMediaMetadata(urls: string[]): Promise<GetMediaMetadata["event"][]>;
+}

package/dist/primal.js

@@ -0,0 +1,190 @@
+import { mapEventsToTimeline } from "applesauce-core";
+import { completeOnEose, Relay } from "applesauce-relay";
+import { lastValueFrom } from "rxjs";
+export const DEFAULT_PRIMAL_RELAY = "wss://cache2.primal.net/v1";
+/**
+ * Extended relay interface for primal caching server
+ * @see https://github.com/PrimalHQ/primal-server/blob/main/src/app_ext.jl
+ */
+export class PrimalCache extends Relay {
+    constructor(url = DEFAULT_PRIMAL_RELAY, opts) {
+        super(url, opts);
+    }
+    /** Make a "cache" request to the caching server */
+    cacheRequest(request) {
+        return this.req({
+            // @ts-expect-error
+            cache: request,
+        }).pipe(completeOnEose());
+    }
+    // ===== EXPLORE METHODS =====
+    /** Get legend counts for explore page */
+    exploreLegendCounts(pubkey) {
+        return lastValueFrom(this.cacheRequest(["explore_legend_counts", { pubkey }]).pipe(mapEventsToTimeline()));
+    }
+    /** Explore content with various filters */
+    explore(params) {
+        return lastValueFrom(this.cacheRequest(["explore", params]).pipe(mapEventsToTimeline()));
+    }
+    /** Get global trending content from last 24 hours */
+    exploreGlobalTrending24h(limit = 20) {
+        return lastValueFrom(this.cacheRequest(["explore_global_trending_24h", { limit }]).pipe(mapEventsToTimeline()));
+    }
+    /** Get global most zapped content from last 4 hours */
+    exploreGlobalMostZapped4h(limit = 20) {
+        return lastValueFrom(this.cacheRequest(["explore_global_mostzapped_4h", { limit }]).pipe(mapEventsToTimeline()));
+    }
+    // ===== SCORED CONTENT METHODS =====
+    /** Get scored content */
+    scored(params) {
+        return lastValueFrom(this.cacheRequest(["scored", params]).pipe(mapEventsToTimeline()));
+    }
+    /** Get scored users */
+    scoredUsers(limit = 20) {
+        return lastValueFrom(this.cacheRequest(["scored_users", { limit }]).pipe(mapEventsToTimeline()));
+    }
+    /** Get scored users from last 24 hours */
+    scoredUsers24h(limit = 20) {
+        return lastValueFrom(this.cacheRequest(["scored_users_24h", { limit }]).pipe(mapEventsToTimeline()));
+    }
+    // ===== RELAY METHODS =====
+    /** Get default relays */
+    getDefaultRelays() {
+        return lastValueFrom(this.cacheRequest(["get_default_relays", {}]).pipe(mapEventsToTimeline()));
+    }
+    // ===== USER METHODS =====
+    /** Get recommended users */
+    getRecommendedUsers(limit = 20) {
+        return lastValueFrom(this.cacheRequest(["get_recommended_users", { limit }]).pipe(mapEventsToTimeline()));
+    }
+    /** Get suggested users */
+    getSuggestedUsers(limit = 20) {
+        return lastValueFrom(this.cacheRequest(["get_suggested_users", { limit }]).pipe(mapEventsToTimeline()));
+    }
+    /** Search for users by query */
+    userSearch(query, limit = 10) {
+        return lastValueFrom(this.cacheRequest(["user_search", { query, limit }]).pipe(mapEventsToTimeline()));
+    }
+    /** Get trusted users */
+    trustedUsers(limit = 500, extendedResponse = true) {
+        return lastValueFrom(this.cacheRequest([
+            "trusted_users",
+            { limit, extended_response: extendedResponse },
+        ]).pipe(mapEventsToTimeline()));
+    }
+    // ===== PROFILE METHODS =====
+    /** Get user profile scored content */
+    userProfileScoredContent(params) {
+        return lastValueFrom(this.cacheRequest(["user_profile_scored_content", params]).pipe(mapEventsToTimeline()));
+    }
+    /** Get user profile scored media thumbnails */
+    userProfileScoredMediaThumbnails(params) {
+        return lastValueFrom(this.cacheRequest(["user_profile_scored_media_thumbnails", params]).pipe(mapEventsToTimeline()));
+    }
+    // ===== SEARCH METHODS =====
+    /** Search content */
+    search(params) {
+        return lastValueFrom(this.cacheRequest(["search", params]).pipe(mapEventsToTimeline()));
+    }
+    /** Advanced search */
+    advancedSearch(params) {
+        return lastValueFrom(this.cacheRequest(["advanced_search", params]).pipe(mapEventsToTimeline()));
+    }
+    // ===== FEED METHODS =====
+    /** Advanced feed */
+    advancedFeed(params) {
+        return lastValueFrom(this.cacheRequest(["advanced_feed", params]).pipe(mapEventsToTimeline()));
+    }
+    /** Feed directive */
+    feedDirective(params) {
+        return lastValueFrom(this.cacheRequest(["feed_directive", params]).pipe(mapEventsToTimeline()));
+    }
+    /** Feed directive v2 */
+    feedDirective2(params) {
+        return lastValueFrom(this.cacheRequest(["feed_directive_2", params]).pipe(mapEventsToTimeline()));
+    }
+    /** Get advanced feeds */
+    getAdvancedFeeds() {
+        return lastValueFrom(this.cacheRequest(["get_advanced_feeds", {}]).pipe(mapEventsToTimeline()));
+    }
+    // ===== TRENDING METHODS =====
+    /** Get trending hashtags */
+    trendingHashtags(limit = 20) {
+        return lastValueFrom(this.cacheRequest(["trending_hashtags", { limit }]).pipe(mapEventsToTimeline()));
+    }
+    /** Get trending hashtags from last 4 hours */
+    trendingHashtags4h(limit = 20) {
+        return lastValueFrom(this.cacheRequest(["trending_hashtags_4h", { limit }]).pipe(mapEventsToTimeline()));
+    }
+    /** Get trending hashtags from last 7 days */
+    trendingHashtags7d(limit = 20) {
+        return lastValueFrom(this.cacheRequest(["trending_hashtags_7d", { limit }]).pipe(mapEventsToTimeline()));
+    }
+    /** Get trending images */
+    trendingImages(limit = 20) {
+        return lastValueFrom(this.cacheRequest(["trending_images", { limit }]).pipe(mapEventsToTimeline()));
+    }
+    /** Get trending images from last 4 hours */
+    trendingImages4h(limit = 20) {
+        return lastValueFrom(this.cacheRequest(["trending_images_4h", { limit }]).pipe(mapEventsToTimeline()));
+    }
+    // ===== NOTIFICATION METHODS =====
+    /** Get notifications */
+    getNotifications(params) {
+        return lastValueFrom(this.cacheRequest(["get_notifications", params]).pipe(mapEventsToTimeline()));
+    }
+    /** Set notifications as seen */
+    setNotificationsSeen(pubkey, until) {
+        return lastValueFrom(this.cacheRequest(["set_notifications_seen", { pubkey, until }]).pipe(mapEventsToTimeline()));
+    }
+    /** Get notifications seen status */
+    getNotificationsSeen(pubkey) {
+        return lastValueFrom(this.cacheRequest(["get_notifications_seen", { pubkey }]).pipe(mapEventsToTimeline()));
+    }
+    // ===== RELAY METHODS =====
+    /** Get relays */
+    relays() {
+        return lastValueFrom(this.cacheRequest(["relays", {}]).pipe(mapEventsToTimeline()));
+    }
+    // ===== REPORT METHODS =====
+    /** Report user */
+    reportUser(pubkey, reason) {
+        return lastValueFrom(this.cacheRequest(["report_user", { pubkey, reason }]).pipe(mapEventsToTimeline()));
+    }
+    /** Report note */
+    reportNote(eventId, reason) {
+        return lastValueFrom(this.cacheRequest(["report_note", { event_id: eventId, reason }]).pipe(mapEventsToTimeline()));
+    }
+    // ===== FILTERLIST METHODS =====
+    /** Get filterlist */
+    getFilterlist() {
+        return lastValueFrom(this.cacheRequest(["get_filterlist", {}]).pipe(mapEventsToTimeline()));
+    }
+    /** Check filterlist */
+    checkFilterlist(pubkeys) {
+        return lastValueFrom(this.cacheRequest(["check_filterlist", { pubkeys }]).pipe(mapEventsToTimeline()));
+    }
+    // ===== BROADCAST METHODS =====
+    /** Broadcast reply */
+    broadcastReply(event) {
+        return lastValueFrom(this.cacheRequest(["broadcast_reply", { event }]).pipe(mapEventsToTimeline()));
+    }
+    /** Broadcast events */
+    broadcastEvents(events, relays) {
+        return lastValueFrom(this.cacheRequest(["broadcast_events", { events, relays }]).pipe(mapEventsToTimeline()));
+    }
+    // ===== MENTION METHODS =====
+    /** Get note mentions */
+    noteMentions(params) {
+        return lastValueFrom(this.cacheRequest(["note_mentions", params]).pipe(mapEventsToTimeline()));
+    }
+    /** Get note mentions count */
+    noteMentionsCount(eventId) {
+        return lastValueFrom(this.cacheRequest(["note_mentions_count", { event_id: eventId }]).pipe(mapEventsToTimeline()));
+    }
+    // ===== MEDIA METHODS =====
+    /** Get media metadata */
+    getMediaMetadata(urls) {
+        return lastValueFrom(this.cacheRequest(["get_media_metadata", { urls }]).pipe(mapEventsToTimeline()));
+    }
+}

package/dist/vertex.d.ts

@@ -0,0 +1,36 @@
+import { ProfilePointer } from "applesauce-core/helpers/pointers";
+import { Relay, type RelayOptions } from "applesauce-relay";
+import { type ISigner } from "applesauce-signers";
+export declare const VERTEX_RELAY = "wss://relay.vertexlab.io";
+export declare const VERTEX_SEARCH_KIND = 5315;
+export declare const VERTEX_VERIFY_REPUTATION_KIND = 5312;
+export type SortMethod = "globalPagerank" | "personalizedPagerank" | "followerCount";
+export type SearchProfileResult = ProfilePointer & {
+    rank: number;
+};
+export type VerifyReputationResult = {
+    pubkey: string;
+    rank: number;
+    follows?: number;
+    followers?: number;
+};
+export type VerifyReputationOptions = {
+    target: string;
+    sort?: SortMethod;
+    source?: string;
+    limit?: number;
+};
+/** Extended relay class for interacting with the vertex relay */
+export declare class Vertex extends Relay {
+    private signer;
+    private autoAuth;
+    constructor(signer: ISigner, relay?: string, opts?: RelayOptions);
+    /** Lookup user profiles by search query */
+    lookupProfiles(query: string, sortMethod?: SortMethod, limit?: number): Promise<ProfilePointer[]>;
+    /** Verify reputation of a pubkey */
+    verifyReputation(options: VerifyReputationOptions): Promise<VerifyReputationResult[]>;
+    /** Method to get credit balance on vertex */
+    getCreditBalance(): Promise<number>;
+    /** Close the connection to the relay */
+    close(): void;
+}

package/dist/vertex.js

@@ -0,0 +1,111 @@
+import { getTagValue, hasNameValueTag, unixNow } from "applesauce-core/helpers";
+import { onlyEvents, Relay } from "applesauce-relay";
+import { combineLatest, filter, firstValueFrom, map, take } from "rxjs";
+export const VERTEX_RELAY = "wss://relay.vertexlab.io";
+export const VERTEX_SEARCH_KIND = 5315;
+export const VERTEX_VERIFY_REPUTATION_KIND = 5312;
+/** Extended relay class for interacting with the vertex relay */
+export class Vertex extends Relay {
+    signer;
+    autoAuth;
+    constructor(signer, relay = VERTEX_RELAY, opts) {
+        super(relay, opts);
+        this.signer = signer;
+        // Automatically authenticate to the relay when a challenge is received
+        this.autoAuth = combineLatest([this.challenge$, this.authenticated$]).subscribe(([challenge, authenticated]) => {
+            if (challenge && !authenticated) {
+                console.info("[VERTEX] Authenticating to relay");
+                this.authenticate(this.signer);
+            }
+        });
+    }
+    /** Lookup user profiles by search query */
+    async lookupProfiles(query, sortMethod = "globalPagerank", limit = 10) {
+        // Create request
+        const request = await this.signer.signEvent({
+            kind: VERTEX_SEARCH_KIND,
+            tags: [
+                ["param", "search", query],
+                ["param", "limit", limit.toString()],
+                ["param", "source", await this.signer.getPublicKey()],
+                ["param", "sort", sortMethod],
+            ],
+            created_at: unixNow(),
+            content: "",
+        });
+        // send request
+        await this.publish(request);
+        // Wait for response
+        const response = await firstValueFrom(this.subscription({
+            kinds: [VERTEX_SEARCH_KIND + 1000, 7000],
+            "#e": [request.id],
+            "#p": [request.pubkey],
+        }).pipe(onlyEvents(), 
+        // Only select response events
+        filter((event) => hasNameValueTag(event, "e", request.id)), 
+        // Only accept error events for response
+        filter((event) => (event.kind === 7000 ? getTagValue(event, "status") === "error" : true))));
+        const error = response.kind === 7000 ? response.tags.find((t) => t[0] === "status" && t[1] === "error")?.[2] : undefined;
+        // Throw vertex error
+        if (error)
+            throw new Error(error);
+        const pointers = JSON.parse(response.content)
+            // Sort by rank descending
+            .sort((a, b) => b.rank - a.rank)
+            // Convert to profile pointers
+            .map(({ pubkey }) => ({
+            pubkey,
+            relays: [VERTEX_RELAY],
+        }));
+        return pointers;
+    }
+    /** Verify reputation of a pubkey */
+    async verifyReputation(options) {
+        const { target, sort = "globalPagerank", source, limit = 5 } = options;
+        // Create request
+        const request = await this.signer.signEvent({
+            kind: VERTEX_VERIFY_REPUTATION_KIND,
+            tags: [
+                ["param", "target", target],
+                ["param", "sort", sort],
+                ["param", "limit", limit.toString()],
+                ...(source ? [["param", "source", source]] : []),
+            ],
+            created_at: unixNow(),
+            content: "",
+        });
+        // Send request
+        await this.publish(request);
+        // Wait for response
+        const response = await firstValueFrom(this.subscription({
+            kinds: [VERTEX_VERIFY_REPUTATION_KIND + 1000, 7000],
+            "#e": [request.id],
+            "#p": [request.pubkey],
+        }).pipe(onlyEvents(), 
+        // Only select response events
+        filter((event) => hasNameValueTag(event, "e", request.id)), 
+        // Only accept error events for response
+        filter((event) => (event.kind === 7000 ? getTagValue(event, "status") === "error" : true))));
+        const error = response.kind === 7000 ? response.tags.find((t) => t[0] === "status" && t[1] === "error")?.[2] : undefined;
+        // Throw vertex error
+        if (error)
+            throw new Error(error);
+        // Parse and return the results
+        const results = JSON.parse(response.content);
+        return results;
+    }
+    /** Method to get credit balance on vertex */
+    async getCreditBalance() {
+        return firstValueFrom(this.request({ kinds: [22243] }).pipe(take(1), map((e) => {
+            const tag = e.tags.find((t) => t[0] === "credits");
+            if (!tag)
+                throw new Error("No credits tag found");
+            return parseInt(tag?.[1] || "0");
+        })));
+    }
+    /** Close the connection to the relay */
+    close() {
+        this.autoAuth.unsubscribe();
+        super.close();
+    }
+}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "applesauce-extra",
+  "version": "0.0.0-next-20251009095925",
+  "description": "",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "keywords": [
+    "nostr",
+    "applesauce",
+    "vertex",
+    "primal"
+  ],
+  "author": "hzrd149",
+  "license": "MIT",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "rxjs": "^7.8.2",
+    "applesauce-core": "^4.0.0",
+    "applesauce-relay": "^4.0.0",
+    "applesauce-signers": "^0.0.0-next-20251009095925"
+  },
+  "devDependencies": {
+    "@hirez_io/observer-spy": "^2.2.0",
+    "rimraf": "^6.0.1",
+    "typescript": "^5.8.3",
+    "vitest": "^3.2.4"
+  },
+  "funding": {
+    "type": "lightning",
+    "url": "lightning:nostrudel@geyser.fund"
+  },
+  "scripts": {
+    "prebuild": "rimraf dist",
+    "build": "tsc",
+    "watch:build": "tsc --watch > /dev/null",
+    "test": "vitest run --passWithNoTests",
+    "watch:test": "vitest"
+  }
+}