applesauce-core 0.9.0 → 0.11.0

package/dist/helpers/lnurl.js

@@ -0,0 +1,40 @@
+import { bech32 } from "@scure/base";
+import { parseBolt11 } from "./bolt11.js";
+const decoder = new TextDecoder();
+export function parseLightningAddress(address) {
+    let [name, domain] = address.split("@");
+    if (!name || !domain)
+        return;
+    return new URL(`https://${domain}/.well-known/lnurlp/${name}`);
+}
+export function decodeLNURL(lnurl) {
+    try {
+        const { words, prefix } = bech32.decode(lnurl);
+        if (prefix !== "lnurl")
+            return;
+        const str = decoder.decode(bech32.fromWords(words));
+        return new URL(str);
+    }
+    catch (error) { }
+    return undefined;
+}
+export function parseLNURLOrAddress(addressOrLNURL) {
+    if (addressOrLNURL.includes("@")) {
+        return parseLightningAddress(addressOrLNURL);
+    }
+    return decodeLNURL(addressOrLNURL);
+}
+export async function getInvoice(callback) {
+    const { pr: payRequest } = await fetch(callback).then((res) => res.json());
+    const amount = callback.searchParams.get("amount");
+    if (!amount)
+        throw new Error("Missing amount");
+    if (payRequest) {
+        const parsed = parseBolt11(payRequest);
+        if (parsed.amount !== parseInt(amount))
+            throw new Error("Incorrect amount");
+        return payRequest;
+    }
+    else
+        throw new Error("Failed to get invoice");
+}

package/dist/helpers/mailboxes.js

@@ -1,5 +1,6 @@
-import { safeRelayUrl } from "./relays.js";
 import { getOrComputeCachedValue } from "./cache.js";
+import { isSafeRelayURL } from "./relays.js";
+import { normalizeURL } from "./url.js";
 export const MailboxesInboxesSymbol = Symbol.for("mailboxes-inboxes");
 export const MailboxesOutboxesSymbol = Symbol.for("mailboxes-outboxes");
 /**
@@ -9,10 +10,13 @@ export function getInboxes(event) {
     return getOrComputeCachedValue(event, MailboxesInboxesSymbol, () => {
         const inboxes = [];
         for (const tag of event.tags) {
-            if (tag[0] === "r" && tag[1] && (tag[2] === "read" || tag[2] === undefined)) {
-                const url = safeRelayUrl(tag[1]);
-                if (url && !inboxes.includes(url))
-                    inboxes.push(url);
+            const [name, url, mode] = tag;
+            if (name === "r" &&
+                url &&
+                isSafeRelayURL(url) &&
+                !inboxes.includes(url) &&
+                (mode === "read" || mode === undefined)) {
+                inboxes.push(normalizeURL(url));
             }
         }
         return inboxes;
@@ -25,10 +29,13 @@ export function getOutboxes(event) {
     return getOrComputeCachedValue(event, MailboxesOutboxesSymbol, () => {
         const outboxes = [];
         for (const tag of event.tags) {
-            if (tag[0] === "r" && tag[1] && (tag[2] === "write" || tag[2] === undefined)) {
-                const url = safeRelayUrl(tag[1]);
-                if (url && !outboxes.includes(url))
-                    outboxes.push(url);
+            const [name, url, mode] = tag;
+            if (name === "r" &&
+                url &&
+                isSafeRelayURL(url) &&
+                !outboxes.includes(url) &&
+                (mode === "write" || mode === undefined)) {
+                outboxes.push(normalizeURL(url));
             }
         }
         return outboxes;

package/dist/helpers/mutes.d.ts

@@ -0,0 +1,14 @@
+import { NostrEvent } from "nostr-tools";
+export declare const MutePublicSymbol: unique symbol;
+export declare const MuteHiddenSymbol: unique symbol;
+export type Mutes = {
+    pubkeys: Set<string>;
+    threads: Set<string>;
+    hashtags: Set<string>;
+    words: Set<string>;
+};
+export declare function parseMutedTags(tags: string[][]): Mutes;
+/** Returns muted things */
+export declare function getMutedThings(mute: NostrEvent): Mutes;
+/** Returns the hidden muted content if the event is unlocked */
+export declare function getHiddenMutedThings(mute: NostrEvent): Mutes | undefined;

package/dist/helpers/mutes.js

@@ -0,0 +1,23 @@
+import { isETag, isPTag, isTTag } from "./tags.js";
+import { getOrComputeCachedValue } from "./cache.js";
+import { getHiddenTags } from "./hidden-tags.js";
+export const MutePublicSymbol = Symbol.for("mute-public");
+export const MuteHiddenSymbol = Symbol.for("mute-hidden");
+export function parseMutedTags(tags) {
+    const pubkeys = new Set(tags.filter(isPTag).map((t) => t[1]));
+    const threads = new Set(tags.filter(isETag).map((t) => t[1]));
+    const hashtags = new Set(tags.filter(isTTag).map((t) => t[1].toLocaleLowerCase()));
+    const words = new Set(tags.filter((t) => t[0] === "word" && t[1]).map((t) => t[1].toLocaleLowerCase()));
+    return { pubkeys, threads, hashtags, words };
+}
+/** Returns muted things */
+export function getMutedThings(mute) {
+    return getOrComputeCachedValue(mute, MutePublicSymbol, (e) => parseMutedTags(e.tags));
+}
+/** Returns the hidden muted content if the event is unlocked */
+export function getHiddenMutedThings(mute) {
+    return getOrComputeCachedValue(mute, MuteHiddenSymbol, () => {
+        const tags = getHiddenTags(mute);
+        return tags && parseMutedTags(tags);
+    });
+}

package/dist/helpers/picture-post.d.ts

@@ -0,0 +1,4 @@
+import { NostrEvent } from "nostr-tools";
+export declare const PICTURE_POST_KIND = 20;
+/** Return the media attachments from a kind 20 media post */
+export declare function getPicturePostAttachments(post: NostrEvent): import("./file-metadata.js").FileMetadata[];

package/dist/helpers/picture-post.js

@@ -0,0 +1,6 @@
+import { getMediaAttachments } from "./file-metadata.js";
+export const PICTURE_POST_KIND = 20;
+/** Return the media attachments from a kind 20 media post */
+export function getPicturePostAttachments(post) {
+    return getMediaAttachments(post);
+}

package/dist/helpers/pointers.d.ts

@@ -1,7 +1,9 @@
 import { AddressPointer, DecodeResult, EventPointer, ProfilePointer } from "nostr-tools/nip19";
+import { NostrEvent } from "nostr-tools";
 export type AddressPointerWithoutD = Omit<AddressPointer, "identifier"> & {
     identifier?: string;
 };
+/** Parse the value of an "a" tag into an AddressPointer */
 export declare function parseCoordinate(a: string): AddressPointerWithoutD | null;
 export declare function parseCoordinate(a: string, requireD: false): AddressPointerWithoutD | null;
 export declare function parseCoordinate(a: string, requireD: true): AddressPointer | null;
@@ -9,14 +11,45 @@ export declare function parseCoordinate(a: string, requireD: false, silent: fals
 export declare function parseCoordinate(a: string, requireD: true, silent: false): AddressPointer;
 export declare function parseCoordinate(a: string, requireD: true, silent: true): AddressPointer | null;
 export declare function parseCoordinate(a: string, requireD: false, silent: true): AddressPointerWithoutD | null;
+/** Extra a pubkey from the result of nip19.decode */
 export declare function getPubkeyFromDecodeResult(result?: DecodeResult): string | undefined;
+/** Encodes the result of nip19.decode */
 export declare function encodeDecodeResult(result: DecodeResult): "" | `nprofile1${string}` | `nevent1${string}` | `naddr1${string}` | `nsec1${string}` | `npub1${string}` | `note1${string}`;
-export declare function getEventPointerFromTag(tag: string[]): EventPointer;
-export declare function getAddressPointerFromTag(tag: string[]): AddressPointer;
-export declare function getProfilePointerFromTag(tag: string[]): ProfilePointer;
+/**
+ * Gets an EventPointer form a common "e" tag
+ * @throws
+ */
+export declare function getEventPointerFromETag(tag: string[]): EventPointer;
+/**
+ * Gets an EventPointer form a "q" tag
+ * @throws
+ */
+export declare function getEventPointerFromQTag(tag: string[]): EventPointer;
+/**
+ * Get an AddressPointer from an "a" tag
+ * @throws
+ */
+export declare function getAddressPointerFromATag(tag: string[]): AddressPointer;
+/**
+ * Gets a ProfilePointer from a "p" tag
+ * @throws
+ */
+export declare function getProfilePointerFromPTag(tag: string[]): ProfilePointer;
+/** Parses "e", "a", "p", and "q" tags into a pointer */
 export declare function getPointerFromTag(tag: string[]): DecodeResult | null;
 export declare function isAddressPointer(pointer: DecodeResult["data"]): pointer is AddressPointer;
 export declare function isEventPointer(pointer: DecodeResult["data"]): pointer is EventPointer;
+/** Returns the coordinate string for an AddressPointer */
 export declare function getCoordinateFromAddressPointer(pointer: AddressPointer): string;
-export declare function getATagFromAddressPointer(pointer: AddressPointer): ["a", ...string[]];
-export declare function getETagFromEventPointer(pointer: EventPointer): ["e", ...string[]];
+/**
+ * Returns an AddressPointer for a replaceable event
+ * @throws
+ */
+export declare function getAddressPointerForEvent(event: NostrEvent, relays?: string[]): AddressPointer;
+/**
+ * Returns an EventPointer for an event
+ * @throws
+ */
+export declare function getEventPointerForEvent(event: NostrEvent, relays?: string[]): EventPointer;
+/** Returns a pointer for a given event */
+export declare function getPointerForEvent(event: NostrEvent, relays?: string[]): DecodeResult;

package/dist/helpers/pointers.js

@@ -1,6 +1,8 @@
 import { naddrEncode, neventEncode, noteEncode, nprofileEncode, npubEncode, nsecEncode, } from "nostr-tools/nip19";
-import { getPublicKey } from "nostr-tools";
-import { safeRelayUrls } from "./relays.js";
+import { getPublicKey, kinds } from "nostr-tools";
+import { getReplaceableIdentifier } from "./event.js";
+import { isParameterizedReplaceableKind } from "nostr-tools/kinds";
+import { isSafeRelayURL } from "./relays.js";
 export function parseCoordinate(a, requireD = false, silent = true) {
     const parts = a.split(":");
     const kind = parts[0] && parseInt(parts[0]);
@@ -30,6 +32,7 @@ export function parseCoordinate(a, requireD = false, silent = true) {
         identifier: d,
     };
 }
+/** Extra a pubkey from the result of nip19.decode */
 export function getPubkeyFromDecodeResult(result) {
     if (!result)
         return;
@@ -45,6 +48,7 @@ export function getPubkeyFromDecodeResult(result) {
             return undefined;
     }
 }
+/** Encodes the result of nip19.decode */
 export function encodeDecodeResult(result) {
     switch (result.type) {
         case "naddr":
@@ -62,42 +66,72 @@ export function encodeDecodeResult(result) {
     }
     return "";
 }
-export function getEventPointerFromTag(tag) {
+/**
+ * Gets an EventPointer form a common "e" tag
+ * @throws
+ */
+export function getEventPointerFromETag(tag) {
     if (!tag[1])
         throw new Error("Missing event id in tag");
     let pointer = { id: tag[1] };
-    if (tag[2])
-        pointer.relays = safeRelayUrls([tag[2]]);
+    if (tag[2] && isSafeRelayURL(tag[2]))
+        pointer.relays = [tag[2]];
     return pointer;
 }
-export function getAddressPointerFromTag(tag) {
+/**
+ * Gets an EventPointer form a "q" tag
+ * @throws
+ */
+export function getEventPointerFromQTag(tag) {
+    if (!tag[1])
+        throw new Error("Missing event id in tag");
+    let pointer = { id: tag[1] };
+    if (tag[2] && isSafeRelayURL(tag[2]))
+        pointer.relays = [tag[2]];
+    if (tag[3] && tag[3].length === 64)
+        pointer.author = tag[3];
+    return pointer;
+}
+/**
+ * Get an AddressPointer from an "a" tag
+ * @throws
+ */
+export function getAddressPointerFromATag(tag) {
     if (!tag[1])
         throw new Error("Missing coordinate in tag");
     const pointer = parseCoordinate(tag[1], true, false);
-    if (tag[2])
-        pointer.relays = safeRelayUrls([tag[2]]);
+    if (tag[2] && isSafeRelayURL(tag[2]))
+        pointer.relays = [tag[2]];
     return pointer;
 }
-export function getProfilePointerFromTag(tag) {
+/**
+ * Gets a ProfilePointer from a "p" tag
+ * @throws
+ */
+export function getProfilePointerFromPTag(tag) {
     if (!tag[1])
         throw new Error("Missing pubkey in tag");
     const pointer = { pubkey: tag[1] };
-    if (tag[2])
-        pointer.relays = safeRelayUrls([tag[2]]);
+    if (tag[2] && isSafeRelayURL(tag[2]))
+        pointer.relays = [tag[2]];
     return pointer;
 }
+/** Parses "e", "a", "p", and "q" tags into a pointer */
 export function getPointerFromTag(tag) {
     try {
         switch (tag[0]) {
             case "e":
-                return { type: "nevent", data: getEventPointerFromTag(tag) };
+                return { type: "nevent", data: getEventPointerFromETag(tag) };
             case "a":
                 return {
                     type: "naddr",
-                    data: getAddressPointerFromTag(tag),
+                    data: getAddressPointerFromATag(tag),
                 };
             case "p":
-                return { type: "nprofile", data: getProfilePointerFromTag(tag) };
+                return { type: "nprofile", data: getProfilePointerFromPTag(tag) };
+            // NIP-18 quote tags
+            case "q":
+                return { type: "nevent", data: getEventPointerFromETag(tag) };
         }
     }
     catch (error) { }
@@ -105,21 +139,67 @@ export function getPointerFromTag(tag) {
 }
 export function isAddressPointer(pointer) {
     return (typeof pointer !== "string" &&
-        Object.hasOwn(pointer, "identifier") &&
-        Object.hasOwn(pointer, "pubkey") &&
-        Object.hasOwn(pointer, "kind"));
+        Reflect.has(pointer, "identifier") &&
+        Reflect.has(pointer, "pubkey") &&
+        Reflect.has(pointer, "kind"));
 }
 export function isEventPointer(pointer) {
-    return typeof pointer !== "string" && Object.hasOwn(pointer, "id");
+    return typeof pointer !== "string" && Reflect.has(pointer, "id");
 }
+/** Returns the coordinate string for an AddressPointer */
 export function getCoordinateFromAddressPointer(pointer) {
-    return `${pointer.kind}:${pointer.pubkey}:${pointer.identifier}`;
+    return pointer.kind + ":" + pointer.pubkey + ":" + pointer.identifier;
 }
-export function getATagFromAddressPointer(pointer) {
-    const relay = pointer.relays?.[0];
-    const coordinate = getCoordinateFromAddressPointer(pointer);
-    return relay ? ["a", coordinate, relay] : ["a", coordinate];
+/**
+ * Returns an AddressPointer for a replaceable event
+ * @throws
+ */
+export function getAddressPointerForEvent(event, relays) {
+    if (!isParameterizedReplaceableKind(event.kind))
+        throw new Error("Cant get AddressPointer for non-replaceable event");
+    const d = getReplaceableIdentifier(event);
+    return {
+        identifier: d,
+        kind: event.kind,
+        pubkey: event.pubkey,
+        relays,
+    };
+}
+/**
+ * Returns an EventPointer for an event
+ * @throws
+ */
+export function getEventPointerForEvent(event, relays) {
+    return {
+        id: event.id,
+        kind: event.kind,
+        author: event.pubkey,
+        relays,
+    };
 }
-export function getETagFromEventPointer(pointer) {
-    return pointer.relays?.length ? ["e", pointer.id, pointer.relays[0]] : ["e", pointer.id];
+/** Returns a pointer for a given event */
+export function getPointerForEvent(event, relays) {
+    if (kinds.isParameterizedReplaceableKind(event.kind)) {
+        const d = getReplaceableIdentifier(event);
+        return {
+            type: "naddr",
+            data: {
+                identifier: d,
+                kind: event.kind,
+                pubkey: event.pubkey,
+                relays,
+            },
+        };
+    }
+    else {
+        return {
+            type: "nevent",
+            data: {
+                id: event.id,
+                kind: event.kind,
+                author: event.pubkey,
+                relays,
+            },
+        };
+    }
 }

package/dist/helpers/profile.d.ts

@@ -2,10 +2,13 @@ import { NostrEvent } from "nostr-tools";
 export declare const ProfileContentSymbol: unique symbol;
 export type ProfileContent = {
     name?: string;
+    /** @deprecated use name instead */
+    username?: string;
     display_name?: string;
+    /** @deprecated use display_name instead */
     displayName?: string;
     about?: string;
-    /** @deprecated */
+    /** @deprecated use picture instead */
     image?: string;
     picture?: string;
     banner?: string;
@@ -18,3 +21,5 @@ export type ProfileContent = {
 export declare function getProfileContent(event: NostrEvent): ProfileContent;
 /** Checks if the content of the kind 0 event is valid JSON */
 export declare function isValidProfile(profile?: NostrEvent): boolean;
+/** Gets the display name from a profile with fallbacks */
+export declare function getDisplayName(metadata?: ProfileContent): string | undefined;

package/dist/helpers/profile.js

@@ -9,7 +9,7 @@ export function getProfileContent(event) {
         if (profile.nip05 && typeof profile.nip05 !== "string")
             profile.nip05 = String(profile.nip05);
         // add missing protocol to website
-        if (profile.website?.startsWith("http") === false) {
+        if (profile.website && profile.website?.length > 0 && profile.website?.startsWith("http") === false) {
             profile.website = "https://" + profile.website;
         }
         return profile;
@@ -29,3 +29,7 @@ export function isValidProfile(profile) {
         return false;
     }
 }
+/** Gets the display name from a profile with fallbacks */
+export function getDisplayName(metadata) {
+    return metadata?.display_name || metadata?.displayName || metadata?.name;
+}

package/dist/helpers/relays.d.ts

@@ -5,8 +5,11 @@ declare module "nostr-tools" {
         [SeenRelaysSymbol]?: Set<string>;
     }
 }
+/** Marks an event as being seen on a relay */
 export declare function addSeenRelay(event: NostrEvent, relay: string): Set<string>;
+/** Returns the set of relays this event was seen on */
 export declare function getSeenRelays(event: NostrEvent): Set<string> | undefined;
-export declare function validateRelayURL(relay: string | URL): URL;
-export declare function safeRelayUrl(relayUrl: string | URL): string | null;
-export declare function safeRelayUrls(urls: Iterable<string>): string[];
+/** A fast check to make sure relay hints are safe to connect to */
+export declare function isSafeRelayURL(relay: string): boolean;
+/** Merge multiple sets of relays and remove duplicates (ignores invalid URLs) */
+export declare function mergeRelaySets(...sources: (Iterable<string> | undefined)[]): string[];

package/dist/helpers/relays.js

@@ -1,31 +1,38 @@
+import { normalizeURL } from "./url.js";
 export const SeenRelaysSymbol = Symbol.for("seen-relays");
-// Seen relays
+/** Marks an event as being seen on a relay */
 export function addSeenRelay(event, relay) {
     if (!event[SeenRelaysSymbol])
         event[SeenRelaysSymbol] = new Set();
     event[SeenRelaysSymbol].add(relay);
     return event[SeenRelaysSymbol];
 }
+/** Returns the set of relays this event was seen on */
 export function getSeenRelays(event) {
     return event[SeenRelaysSymbol];
 }
-// Relay URLs
-export function validateRelayURL(relay) {
-    if (typeof relay === "string" && relay.includes(",ws"))
-        throw new Error("Can not have multiple relays in one string");
-    const url = typeof relay === "string" ? new URL(relay) : relay;
-    if (url.protocol !== "wss:" && url.protocol !== "ws:")
-        throw new Error("Incorrect protocol");
-    return url;
+const WEBSOCKET_URL_CHECK = /^wss?:\/\/([-a-zA-Z0-9@:%._\+~#=]{1,256}\.[a-zA-Z0-9()]{1,6}|localhost)\b([-a-zA-Z0-9()@:%_\+.~#?&\/\/=]*)$/;
+/** A fast check to make sure relay hints are safe to connect to */
+export function isSafeRelayURL(relay) {
+    // anything smaller than 8 is not a URL
+    return relay.length >= 8 && WEBSOCKET_URL_CHECK.test(relay);
 }
-export function safeRelayUrl(relayUrl) {
-    try {
-        return validateRelayURL(relayUrl).toString();
+/** Merge multiple sets of relays and remove duplicates (ignores invalid URLs) */
+export function mergeRelaySets(...sources) {
+    const set = new Set();
+    for (const src of sources) {
+        if (!src)
+            continue;
+        for (const url of src) {
+            try {
+                const safe = normalizeURL(url).toString();
+                if (safe)
+                    set.add(safe);
+            }
+            catch (error) {
+                // failed to parse URL, ignore
+            }
+        }
     }
-    catch (e) {
-        return null;
-    }
-}
-export function safeRelayUrls(urls) {
-    return Array.from(urls).map(safeRelayUrl).filter(Boolean);
+    return Array.from(set);
 }

package/dist/helpers/share.d.ts

@@ -0,0 +1,4 @@
+import { NostrEvent } from "nostr-tools";
+export declare const SharedEventSymbol: unique symbol;
+/** Returns the stringified event in the content of a kind 6 or 16 share event */
+export declare function parseSharedEvent(event: NostrEvent): NostrEvent | undefined;

package/dist/helpers/share.js

@@ -0,0 +1,12 @@
+import { safeParse } from "./json.js";
+import { getOrComputeCachedValue } from "./cache.js";
+export const SharedEventSymbol = Symbol.for("shared-event");
+/** Returns the stringified event in the content of a kind 6 or 16 share event */
+export function parseSharedEvent(event) {
+    return getOrComputeCachedValue(event, SharedEventSymbol, () => {
+        const json = safeParse(event.content);
+        if (!json)
+            return;
+        return json;
+    });
+}

package/dist/helpers/string.d.ts

@@ -1,4 +1,10 @@
+/** Tests if a string is hex */
 export declare function isHex(str?: string): boolean;
+/** Tests if a string is a 64 length hex string */
 export declare function isHexKey(key?: string): boolean;
+/**
+ * Remove invisible characters from a string
+ * @see read more https://www.regular-expressions.info/unicode.html#category
+ */
 export declare function stripInvisibleChar(str: string): string;
 export declare function stripInvisibleChar(str?: string | undefined): string | undefined;

package/dist/helpers/string.js

@@ -1,8 +1,10 @@
+/** Tests if a string is hex */
 export function isHex(str) {
     if (str?.match(/^[0-9a-f]+$/i))
         return true;
     return false;
 }
+/** Tests if a string is a 64 length hex string */
 export function isHexKey(key) {
     if (key?.toLowerCase()?.match(/^[0-9a-f]{64}$/))
         return true;

package/dist/helpers/tags.d.ts

@@ -1,6 +1,29 @@
+/** A tag with at least two indexes, the first being the name, the second the value */
+export type NameValueTag<Name extends string = string> = [Name, string, ...string[]];
+/** Tests if a tag has at least two indexes, and optionally the value of the first */
+export declare function isNameValueTag<Name extends string>(tag: string[], name?: Name): tag is NameValueTag<Name>;
+/** Checks if tag is an "e" tag and has at least one value */
 export declare function isETag(tag: string[]): tag is ["e", string, ...string[]];
+/** Checks if tag is an "p" tag and has at least one value */
 export declare function isPTag(tag: string[]): tag is ["p", string, ...string[]];
+/** Checks if tag is an "r" tag and has at least one value */
 export declare function isRTag(tag: string[]): tag is ["r", string, ...string[]];
+/** Checks if tag is an "d" tag and has at least one value */
 export declare function isDTag(tag: string[]): tag is ["d", string, ...string[]];
+/** Checks if tag is an "a" tag and has at least one value */
 export declare function isATag(tag: string[]): tag is ["a", string, ...string[]];
+/** Checks if tag is an "a" tag and has at least one value */
 export declare function isTTag(tag: string[]): tag is ["t", string, ...string[]];
+/** A pipeline that filters and maps each tag */
+type TagPipe = {
+    <A>(tags: string[][], ta: (tag: string[]) => A | undefined): A[];
+    <A, B>(tags: string[][], ta: (tag: string[]) => A | undefined, ab: (a: A) => B | undefined): B[];
+    <A, B, C>(tags: string[][], ta: (tag: string[]) => A | undefined, ab: (a: A) => B | undefined, bc: (b: B) => C | undefined): C[];
+    <A, B, C, D>(tags: string[][], ta: (tag: string[]) => A | undefined, ab: (a: A) => B | undefined, bc: (b: B) => C | undefined, cd: (c: C) => D | undefined): D[];
+    <A, B, C, D, E>(tags: string[][], ta: (tag: string[]) => A | undefined, ab: (a: A) => B | undefined, bc: (b: B) => C | undefined, cd: (c: C) => D | undefined, de: (d: D) => E | undefined): E[];
+    <A, B, C, D, E, F>(tags: string[][], ta: (tag: string[]) => A | undefined, ab: (a: A) => B | undefined, bc: (b: B) => C | undefined, cd: (c: C) => D | undefined, de: (d: D) => E | undefined, ef: (e: E) => F | undefined): F[];
+    <A, B, C, D, E, F, G>(tags: string[][], ta: (tag: string[]) => A | undefined, ab: (a: A) => B | undefined, bc: (b: B) => C | undefined, cd: (c: C) => D | undefined, de: (d: D) => E | undefined, ef: (e: E) => F | undefined, fg: (f: F) => G | undefined): G[];
+};
+/** Filter and transform tags */
+export declare const processTags: TagPipe;
+export {};

package/dist/helpers/tags.js

@@ -1,18 +1,46 @@
+/** Tests if a tag has at least two indexes, and optionally the value of the first */
+export function isNameValueTag(tag, name) {
+    return tag[0] !== undefined && tag[1] !== undefined && (name ? tag[0] === name : true);
+}
+/** Checks if tag is an "e" tag and has at least one value */
 export function isETag(tag) {
-    return tag[0] === "e" && tag[1] !== undefined;
+    return isNameValueTag(tag, "e");
 }
+/** Checks if tag is an "p" tag and has at least one value */
 export function isPTag(tag) {
-    return tag[0] === "p" && tag[1] !== undefined;
+    return isNameValueTag(tag, "p");
 }
+/** Checks if tag is an "r" tag and has at least one value */
 export function isRTag(tag) {
-    return tag[0] === "r" && tag[1] !== undefined;
+    return isNameValueTag(tag, "r");
 }
+/** Checks if tag is an "d" tag and has at least one value */
 export function isDTag(tag) {
-    return tag[0] === "d" && tag[1] !== undefined;
+    return isNameValueTag(tag, "d");
 }
+/** Checks if tag is an "a" tag and has at least one value */
 export function isATag(tag) {
-    return tag[0] === "a" && tag[1] !== undefined;
+    return isNameValueTag(tag, "a");
 }
+/** Checks if tag is an "a" tag and has at least one value */
 export function isTTag(tag) {
-    return tag[0] === "a" && tag[1] !== undefined;
+    return isNameValueTag(tag, "t");
 }
+/** Filter and transform tags */
+export const processTags = (tags, ...fns) => {
+    return fns.reduce((step, fn) => {
+        const next = [];
+        for (const value of step) {
+            try {
+                const result = fn(value);
+                if (result === undefined)
+                    continue; // value is undefined, ignore
+                next.push(result);
+            }
+            catch (error) {
+                // failed to process value, ignore
+            }
+        }
+        return next;
+    }, tags);
+};

package/dist/helpers/threading.d.ts

@@ -23,13 +23,13 @@ export type ThreadReferences = {
     };
 };
 export declare const Nip10ThreadRefsSymbol: unique symbol;
-declare module "nostr-tools" {
-    interface Event {
-        [Nip10ThreadRefsSymbol]?: ThreadReferences;
-    }
-}
+/**
+ * Gets an EventPointer form a NIP-10 threading "e" tag
+ * @throws
+ */
+export declare function getEventPointerFromThreadTag(tag: string[]): EventPointer;
 /** Parses NIP-10 tags and handles legacy behavior */
-export declare function interpretThreadTags(event: NostrEvent | EventTemplate): {
+export declare function interpretThreadTags(tags: string[][]): {
     root?: {
         e: string[];
         a: undefined;