applesauce-core 0.10.0 → 0.11.0

package/dist/helpers/hidden-tags.js

@@ -1,5 +1,7 @@
-import { unixNow } from "applesauce-core/helpers";
 import { kinds } from "nostr-tools";
+import { GROUPS_LIST_KIND } from "./groups.js";
+import { unixNow } from "./time.js";
+import { isEvent } from "./event.js";
 export const HiddenTagsSymbol = Symbol.for("hidden-tags");
 /** Various event kinds that can have encrypted tags in their content and which encryption method they use */
 export const EventEncryptionMethod = {
@@ -12,6 +14,7 @@ export const EventEncryptionMethod = {
     [kinds.CommunitiesList]: "nip04",
     [kinds.PublicChatsList]: "nip04",
     [kinds.SearchRelaysList]: "nip04",
+    [GROUPS_LIST_KIND]: "nip04",
     // NIP-51 sets
     [kinds.Bookmarksets]: "nip04",
     [kinds.Relaysets]: "nip04",
@@ -35,7 +38,8 @@ export function getHiddenTags(event) {
 export function isHiddenTagsLocked(event) {
     return hasHiddenTags(event) && getHiddenTags(event) === undefined;
 }
-function getEventEncryption(kind, signer) {
+/** Returns either nip04 or nip44 encryption method depending on list kind */
+export function getListEncryptionMethods(kind, signer) {
     const method = EventEncryptionMethod[kind];
     const encryption = signer[method];
     if (!encryption)
@@ -52,7 +56,7 @@ function getEventEncryption(kind, signer) {
 export async function unlockHiddenTags(event, signer, store) {
     if (!canHaveHiddenTags(event.kind))
         throw new Error("Event kind does not support hidden tags");
-    const encryption = getEventEncryption(event.kind, signer);
+    const encryption = getListEncryptionMethods(event.kind, signer);
     const plaintext = await encryption.decrypt(event.pubkey, event.content);
     const parsed = JSON.parse(plaintext);
     if (!Array.isArray(parsed))
@@ -60,36 +64,10 @@ export async function unlockHiddenTags(event, signer, store) {
     // Convert array to tags array string[][]
     const tags = parsed.filter((t) => Array.isArray(t)).map((t) => t.map((v) => String(v)));
     Reflect.set(event, HiddenTagsSymbol, tags);
-    if (store)
+    if (store && isEvent(event))
         store.update(event);
     return event;
 }
-/**
- * Modifies tags and returns an EventTemplate
- * @param event Event to modify
- * @param operations Operations for hidden and public tags
- * @param signer A signer to use to decrypt the tags
- * @throws
- */
-export async function modifyEventTags(event, operations, signer) {
-    const draft = { content: event.content, tags: event.tags, kind: event.kind, created_at: unixNow() };
-    if (operations.public) {
-        draft.tags = operations.public(event.tags);
-    }
-    if (operations.hidden) {
-        if (!signer)
-            throw new Error("Missing signer for hidden tags");
-        if (!canHaveHiddenTags(event.kind))
-            throw new Error("Event kind does not support hidden tags");
-        const hidden = hasHiddenTags(event) ? getHiddenTags(event) : [];
-        if (!hidden)
-            throw new Error("Hidden tags are locked");
-        const newHidden = operations.hidden(hidden);
-        const encryption = getEventEncryption(event.kind, signer);
-        draft.content = await encryption.encrypt(event.pubkey, JSON.stringify(newHidden));
-    }
-    return draft;
-}
 /**
  * Override the hidden tags in an event
  * @throws
@@ -97,7 +75,7 @@ export async function modifyEventTags(event, operations, signer) {
 export async function overrideHiddenTags(event, hidden, signer) {
     if (!canHaveHiddenTags(event.kind))
         throw new Error("Event kind does not support hidden tags");
-    const encryption = getEventEncryption(event.kind, signer);
+    const encryption = getListEncryptionMethods(event.kind, signer);
     const ciphertext = await encryption.encrypt(event.pubkey, JSON.stringify(hidden));
     return {
         kind: event.kind,

package/dist/helpers/index.d.ts

@@ -1,24 +1,36 @@
+export * from "./blossom.js";
 export * from "./bolt11.js";
+export * from "./bookmarks.js";
 export * from "./cache.js";
+export * from "./channels.js";
 export * from "./comment.js";
+export * from "./contacts.js";
 export * from "./content.js";
 export * from "./delete.js";
+export * from "./dns-identity.js";
 export * from "./emoji.js";
 export * from "./event.js";
 export * from "./external-id.js";
+export * from "./file-metadata.js";
 export * from "./filter.js";
+export * from "./groups.js";
 export * from "./hashtag.js";
 export * from "./hidden-tags.js";
+export * from "./json.js";
+export * from "./lists.js";
 export * from "./lnurl.js";
 export * from "./lru.js";
 export * from "./mailboxes.js";
-export * from "./media-attachment.js";
+export * from "./mutes.js";
+export * from "./picture-post.js";
 export * from "./pointers.js";
 export * from "./profile.js";
 export * from "./relays.js";
+export * from "./share.js";
 export * from "./string.js";
 export * from "./tags.js";
 export * from "./threading.js";
 export * from "./time.js";
 export * from "./url.js";
+export * from "./user-status.js";
 export * from "./zap.js";

package/dist/helpers/index.js

@@ -1,24 +1,36 @@
+export * from "./blossom.js";
 export * from "./bolt11.js";
+export * from "./bookmarks.js";
 export * from "./cache.js";
+export * from "./channels.js";
 export * from "./comment.js";
+export * from "./contacts.js";
 export * from "./content.js";
 export * from "./delete.js";
+export * from "./dns-identity.js";
 export * from "./emoji.js";
 export * from "./event.js";
 export * from "./external-id.js";
+export * from "./file-metadata.js";
 export * from "./filter.js";
+export * from "./groups.js";
 export * from "./hashtag.js";
 export * from "./hidden-tags.js";
+export * from "./json.js";
+export * from "./lists.js";
 export * from "./lnurl.js";
 export * from "./lru.js";
 export * from "./mailboxes.js";
-export * from "./media-attachment.js";
+export * from "./mutes.js";
+export * from "./picture-post.js";
 export * from "./pointers.js";
 export * from "./profile.js";
 export * from "./relays.js";
+export * from "./share.js";
 export * from "./string.js";
 export * from "./tags.js";
 export * from "./threading.js";
 export * from "./time.js";
 export * from "./url.js";
+export * from "./user-status.js";
 export * from "./zap.js";

package/dist/helpers/lists.d.ts

@@ -0,0 +1,28 @@
+import { AddressPointer, EventPointer, ProfilePointer } from "nostr-tools/nip19";
+import { NostrEvent } from "nostr-tools";
+/**
+ * Checks if an event pointer is anywhere in a list or set
+ * NOTE: Ignores the `relay` field in EventPointer
+ * NOTE: This will check the hidden tags if the list has hidden tags and they are unlocked
+ */
+export declare function isEventPointerInList(list: NostrEvent, pointer: string | EventPointer): boolean;
+/**
+ * Checks if an address pointer is anywhere in a list or set
+ * NOTE: Ignores the `relay` field in AddressPointer
+ * NOTE: This will check the hidden tags if the list has hidden tags and they are unlocked
+ */
+export declare function isAddressPointerInList(list: NostrEvent, pointer: string | AddressPointer): boolean;
+/**
+ * Checks if an profile pointer is anywhere in a list or set
+ * NOTE: Ignores the `relay` field in ProfilePointer
+ * NOTE: This will check the hidden tags if the list has hidden tags and they are unlocked
+ */
+export declare function isProfilePointerInList(list: NostrEvent, pointer: string | ProfilePointer): boolean;
+/** Returns all the EventPointer in a list or set */
+export declare function getEventPointersFromList(list: NostrEvent): EventPointer[];
+/** Returns all the AddressPointer in a list or set */
+export declare function getAddressPointersFromList(list: NostrEvent): AddressPointer[];
+/** Returns all the ProfilePointer in a list or set */
+export declare function getProfilePointersFromList(list: NostrEvent): ProfilePointer[];
+/** Returns if an event is a valid list or set */
+export declare function isValidList(event: NostrEvent): boolean;

package/dist/helpers/lists.js

@@ -0,0 +1,65 @@
+import { isParameterizedReplaceableKind, isReplaceableKind } from "nostr-tools/kinds";
+import { getHiddenTags } from "./hidden-tags.js";
+import { getAddressPointerFromATag, getCoordinateFromAddressPointer, getEventPointerFromETag, getProfilePointerFromPTag, } from "./pointers.js";
+import { isATag, isETag, isPTag, processTags } from "./tags.js";
+import { getReplaceableIdentifier } from "./event.js";
+function listGetAllTags(list) {
+    const hidden = getHiddenTags(list);
+    return hidden ? [...hidden, ...list.tags] : list.tags;
+}
+/**
+ * Checks if an event pointer is anywhere in a list or set
+ * NOTE: Ignores the `relay` field in EventPointer
+ * NOTE: This will check the hidden tags if the list has hidden tags and they are unlocked
+ */
+export function isEventPointerInList(list, pointer) {
+    const id = typeof pointer === "string" ? pointer : pointer.id;
+    return listGetAllTags(list).some((t) => t[0] === "e" && t[1] === id);
+}
+/**
+ * Checks if an address pointer is anywhere in a list or set
+ * NOTE: Ignores the `relay` field in AddressPointer
+ * NOTE: This will check the hidden tags if the list has hidden tags and they are unlocked
+ */
+export function isAddressPointerInList(list, pointer) {
+    const cord = typeof pointer === "string" ? pointer : getCoordinateFromAddressPointer(pointer);
+    return listGetAllTags(list).some((t) => t[0] === "a" && t[1] === cord);
+}
+/**
+ * Checks if an profile pointer is anywhere in a list or set
+ * NOTE: Ignores the `relay` field in ProfilePointer
+ * NOTE: This will check the hidden tags if the list has hidden tags and they are unlocked
+ */
+export function isProfilePointerInList(list, pointer) {
+    const pubkey = typeof pointer === "string" ? pointer : pointer.pubkey;
+    return listGetAllTags(list).some((t) => t[0] === "p" && t[1] === pubkey);
+}
+/** Returns all the EventPointer in a list or set */
+export function getEventPointersFromList(list) {
+    return processTags(listGetAllTags(list), (tag) => (isETag(tag) ? tag : undefined), getEventPointerFromETag);
+}
+/** Returns all the AddressPointer in a list or set */
+export function getAddressPointersFromList(list) {
+    return processTags(listGetAllTags(list), (t) => (isATag(t) ? t : undefined), getAddressPointerFromATag);
+}
+/** Returns all the ProfilePointer in a list or set */
+export function getProfilePointersFromList(list) {
+    return processTags(listGetAllTags(list), (t) => (isPTag(t) ? t : undefined), getProfilePointerFromPTag);
+}
+/** Returns if an event is a valid list or set */
+export function isValidList(event) {
+    try {
+        if (isParameterizedReplaceableKind(event.kind)) {
+            // event is a set
+            // ensure the set has an identifier
+            getReplaceableIdentifier(event);
+            return true;
+        }
+        else if (isReplaceableKind(event.kind) && event.kind >= 10000 && event.kind < 20000) {
+            // event is a list
+            return true;
+        }
+    }
+    catch (error) { }
+    return false;
+}

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.js

@@ -1,8 +1,8 @@
 import { naddrEncode, neventEncode, noteEncode, nprofileEncode, npubEncode, nsecEncode, } from "nostr-tools/nip19";
 import { getPublicKey, kinds } from "nostr-tools";
-import { safeRelayUrls } from "./relays.js";
-import { getTagValue } from "./index.js";
+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]);
@@ -74,8 +74,8 @@ 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;
 }
 /**
@@ -86,8 +86,8 @@ export function getEventPointerFromQTag(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]];
     if (tag[3] && tag[3].length === 64)
         pointer.author = tag[3];
     return pointer;
@@ -100,8 +100,8 @@ 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;
 }
 /**
@@ -112,8 +112,8 @@ 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 */
@@ -148,7 +148,7 @@ export function isEventPointer(pointer) {
 }
 /** 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;
 }
 /**
  * Returns an AddressPointer for a replaceable event
@@ -157,9 +157,7 @@ export function getCoordinateFromAddressPointer(pointer) {
 export function getAddressPointerForEvent(event, relays) {
     if (!isParameterizedReplaceableKind(event.kind))
         throw new Error("Cant get AddressPointer for non-replaceable event");
-    const d = getTagValue(event, "d");
-    if (!d)
-        throw new Error("Event missing identifier");
+    const d = getReplaceableIdentifier(event);
     return {
         identifier: d,
         kind: event.kind,
@@ -182,9 +180,7 @@ export function getEventPointerForEvent(event, relays) {
 /** Returns a pointer for a given event */
 export function getPointerForEvent(event, relays) {
     if (kinds.isParameterizedReplaceableKind(event.kind)) {
-        const d = getTagValue(event, "d");
-        if (!d)
-            throw new Error("Event missing identifier");
+        const d = getReplaceableIdentifier(event);
         return {
             type: "naddr",
             data: {

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

@@ -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/tags.d.ts

@@ -1,3 +1,7 @@
+/** 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 */
@@ -10,3 +14,16 @@ export declare function isDTag(tag: string[]): tag is ["d", string, ...string[]]
 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,24 +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);
+};