applesauce-common 0.0.0-next-20251203172109

package/dist/operations/index.d.ts

@@ -0,0 +1,28 @@
+export * as AppData from "./app-data.js";
+export * as Calendar from "./calendar.js";
+export * as CalendarEvent from "./calendar-event.js";
+export * as CalendarRsvp from "./calendar-rsvp.js";
+export * as Channel from "./channel.js";
+export * as Client from "./client.js";
+export * as Comment from "./comment.js";
+export * as FileMetadata from "./file-metadata.js";
+export * as Geohash from "./geohash.js";
+export * as GiftWrap from "./gift-wrap.js";
+export * as Groups from "./group.js";
+export * as Hashtags from "./hashtags.js";
+export * as Highlight from "./highlight.js";
+export * as LegacyMessage from "./legacy-message.js";
+export * as List from "./list.js";
+export * as LiveStream from "./live-stream.js";
+export * as MediaAttachment from "./media-attachment.js";
+export * as Note from "./note.js";
+export * as PicturePost from "./picture-post.js";
+export * as Poll from "./poll.js";
+export * as PollResponse from "./poll-response.js";
+export * as Reaction from "./reaction.js";
+export * as Stream from "./stream.js";
+export * as StreamChat from "./stream-chat.js";
+export * as Torrent from "./torrent.js";
+export * as WrappedMessage from "./wrapped-message.js";
+export * as Zap from "./zap-split.js";
+export * as TagOperations from "./tag/index.js";

package/dist/operations/index.js

@@ -0,0 +1,28 @@
+export * as AppData from "./app-data.js";
+export * as Calendar from "./calendar.js";
+export * as CalendarEvent from "./calendar-event.js";
+export * as CalendarRsvp from "./calendar-rsvp.js";
+export * as Channel from "./channel.js";
+export * as Client from "./client.js";
+export * as Comment from "./comment.js";
+export * as FileMetadata from "./file-metadata.js";
+export * as Geohash from "./geohash.js";
+export * as GiftWrap from "./gift-wrap.js";
+export * as Groups from "./group.js";
+export * as Hashtags from "./hashtags.js";
+export * as Highlight from "./highlight.js";
+export * as LegacyMessage from "./legacy-message.js";
+export * as List from "./list.js";
+export * as LiveStream from "./live-stream.js";
+export * as MediaAttachment from "./media-attachment.js";
+export * as Note from "./note.js";
+export * as PicturePost from "./picture-post.js";
+export * as Poll from "./poll.js";
+export * as PollResponse from "./poll-response.js";
+export * as Reaction from "./reaction.js";
+export * as Stream from "./stream.js";
+export * as StreamChat from "./stream-chat.js";
+export * as Torrent from "./torrent.js";
+export * as WrappedMessage from "./wrapped-message.js";
+export * as Zap from "./zap-split.js";
+export * as TagOperations from "./tag/index.js";

package/dist/operations/legacy-message.d.ts

@@ -0,0 +1,6 @@
+import { EventOperation } from "applesauce-core/event-factory";
+import { NostrEvent } from "applesauce-core/helpers/event";
+/** Includes the nip-04 direct message "p" tag */
+export declare function setMessageAddress(pubkey: string): EventOperation;
+/** Includes the "e" tag for legacy message replies */
+export declare function setMessageParent(parent: string | NostrEvent): EventOperation;

package/dist/operations/legacy-message.js

@@ -0,0 +1,13 @@
+import { includeNameValueTag } from "applesauce-core/operations/tags";
+import { kinds } from "applesauce-core/helpers/event";
+/** Includes the nip-04 direct message "p" tag */
+export function setMessageAddress(pubkey) {
+    return includeNameValueTag(["p", pubkey]);
+}
+/** Includes the "e" tag for legacy message replies */
+export function setMessageParent(parent) {
+    if (typeof parent !== "string" && parent.kind !== kinds.EncryptedDirectMessage)
+        throw new Error("Legacy messages can only reply to other legacy messages");
+    const id = typeof parent === "string" ? parent : parent.id;
+    return includeNameValueTag(["e", id]);
+}

package/dist/operations/list.d.ts

@@ -0,0 +1,7 @@
+import { EventOperation } from "applesauce-core/event-factory";
+/** Sets or removes the "title" tag on a NIP-51 list */
+export declare function setTitle(title: string | null): EventOperation;
+/** Sets or removes the "image" tag on a NIP-51 list */
+export declare function setImage(image: string | null): EventOperation;
+/** Sets or removes the "description" tag on a NIP-51 list */
+export declare function setDescription(description: string | null): EventOperation;

package/dist/operations/list.js

@@ -0,0 +1,14 @@
+import { removeSingletonTag, setSingletonTag } from "applesauce-core/operations/tag/common";
+import { modifyPublicTags } from "applesauce-core/operations/tags";
+/** Sets or removes the "title" tag on a NIP-51 list */
+export function setTitle(title) {
+    return modifyPublicTags(title === null ? removeSingletonTag("title") : setSingletonTag(["title", title], true));
+}
+/** Sets or removes the "image" tag on a NIP-51 list */
+export function setImage(image) {
+    return modifyPublicTags(image === null ? removeSingletonTag("image") : setSingletonTag(["image", image], true));
+}
+/** Sets or removes the "description" tag on a NIP-51 list */
+export function setDescription(description) {
+    return modifyPublicTags(description === null ? removeSingletonTag("description") : setSingletonTag(["description", description], true));
+}

package/dist/operations/live-stream.d.ts

@@ -0,0 +1,4 @@
+import { EventOperation } from "applesauce-core/event-factory";
+import { NostrEvent } from "applesauce-core/helpers/event";
+/** Includes the "a" tag for live streams */
+export declare function includeLiveStreamTag(stream: NostrEvent): EventOperation;

package/dist/operations/live-stream.js

@@ -0,0 +1,11 @@
+import { ensureMarkedAddressPointerTag } from "applesauce-core/helpers/factory";
+import { getAddressPointerForEvent } from "applesauce-core/helpers/pointers";
+/** Includes the "a" tag for live streams */
+export function includeLiveStreamTag(stream) {
+    return async (draft, ctx) => {
+        let tags = Array.from(draft.tags);
+        const hint = await ctx.getEventRelayHint?.(stream.id);
+        tags = ensureMarkedAddressPointerTag(tags, getAddressPointerForEvent(stream, hint ? [hint] : undefined), "root");
+        return { ...draft, tags };
+    };
+}

package/dist/operations/media-attachment.d.ts

@@ -0,0 +1,4 @@
+import { EventOperation } from "applesauce-core/event-factory";
+import { FileMetadata } from "../helpers/file-metadata.js";
+/** Adds "imeta" tags on to any event */
+export declare function addMediaAttachments(attachments: FileMetadata[]): EventOperation;

package/dist/operations/media-attachment.js

@@ -0,0 +1,12 @@
+import { createImetaTagForAttachment } from "../helpers/file-metadata.js";
+/** Adds "imeta" tags on to any event */
+export function addMediaAttachments(attachments) {
+    return (draft) => {
+        const tags = Array.from(draft.tags);
+        for (const attachment of attachments) {
+            // TODO: look for duplicates and merge them
+            tags.push(createImetaTagForAttachment(attachment));
+        }
+        return { ...draft, tags };
+    };
+}

package/dist/operations/note.d.ts

@@ -0,0 +1,9 @@
+import { EventOperation } from "applesauce-core/event-factory";
+import { NostrEvent } from "applesauce-core/helpers/event";
+/**
+ * Includes NIP-10 reply tags
+ * @throws {Error} if the parent is not a short text note
+ */
+export declare function setThreadParent(parent: NostrEvent): EventOperation;
+/** Copies "p" tags from parent event and adds new pubkeys */
+export declare function includePubkeyNotificationTags(parent: NostrEvent): EventOperation;

package/dist/operations/note.js

@@ -0,0 +1,42 @@
+import { kinds } from "applesauce-core/helpers/event";
+import { ensureMarkedEventPointerTag, ensureProfilePointerTag } from "applesauce-core/helpers/factory";
+import { isPTag } from "applesauce-core/helpers/tags";
+import { getNip10References } from "../helpers/threading.js";
+/**
+ * Includes NIP-10 reply tags
+ * @throws {Error} if the parent is not a short text note
+ */
+export function setThreadParent(parent) {
+    if (parent.kind !== kinds.ShortTextNote)
+        throw new Error("Parent must be a short text note");
+    return async (draft, ctx) => {
+        let tags = Array.from(draft.tags);
+        const pointer = { id: parent.id, author: parent.pubkey, kind: parent.kind };
+        if (ctx.getEventRelayHint) {
+            const hint = await ctx.getEventRelayHint(parent.id);
+            if (hint)
+                pointer.relays = [hint];
+        }
+        const refs = getNip10References(parent);
+        const root = refs.root?.e ?? pointer;
+        const reply = pointer;
+        tags = ensureMarkedEventPointerTag(tags, root, "root");
+        tags = ensureMarkedEventPointerTag(tags, reply, "reply");
+        return { ...draft, tags };
+    };
+}
+/** Copies "p" tags from parent event and adds new pubkeys */
+export function includePubkeyNotificationTags(parent) {
+    return async (draft, ctx) => {
+        let tags = Array.from(draft.tags);
+        // copy "p" tags from parent event that are not mentions
+        for (const tag of parent.tags) {
+            if (isPTag(tag) && tag[3] !== "mention")
+                tags.push(tag);
+        }
+        // add new "p" tag
+        const hint = await ctx.getPubkeyRelayHint?.(parent.pubkey);
+        tags = ensureProfilePointerTag(tags, { pubkey: parent.pubkey, relays: hint ? [hint] : undefined });
+        return { ...draft, tags };
+    };
+}

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

@@ -0,0 +1,4 @@
+import { EventOperation } from "applesauce-core/event-factory";
+import { MediaAttachment } from "../helpers/file-metadata.js";
+/** Includes the "x" and "m" tags for kind 20 picture posts */
+export declare function setImageMetadata(pictures: MediaAttachment[]): EventOperation;

package/dist/operations/picture-post.js

@@ -0,0 +1,14 @@
+import { ensureNamedValueTag } from "applesauce-core/helpers/tags";
+/** Includes the "x" and "m" tags for kind 20 picture posts */
+export function setImageMetadata(pictures) {
+    return (draft) => {
+        let tags = Array.from(draft.tags);
+        for (const image of pictures) {
+            if (image.sha256)
+                tags = ensureNamedValueTag(tags, ["x", image.sha256]);
+            if (image.type)
+                tags = ensureNamedValueTag(tags, ["m", image.type]);
+        }
+        return { ...draft, tags };
+    };
+}

package/dist/operations/poll-response.d.ts

@@ -0,0 +1,9 @@
+import { EventOperation } from "applesauce-core/event-factory";
+import { NostrEvent } from "applesauce-core/helpers/event";
+import { EventPointer } from "applesauce-core/helpers/pointers";
+/** Sets the poll event that this response is for using an 'e' tag */
+export declare function setPollEvent(poll: NostrEvent | EventPointer | string): EventOperation;
+/** Sets multiple response options at once, replacing any existing response tags */
+export declare function setChoices(optionIds: string[]): EventOperation;
+/** Sets a single response option, replacing any existing response tags (for single choice polls) */
+export declare function setChoice(optionId: string): EventOperation;

package/dist/operations/poll-response.js

@@ -0,0 +1,20 @@
+import { addEventPointerTag } from "applesauce-core/operations/tag/common";
+import { modifyPublicTags } from "applesauce-core/operations/tags";
+/** Sets the poll event that this response is for using an 'e' tag */
+export function setPollEvent(poll) {
+    return modifyPublicTags(addEventPointerTag(poll, true));
+}
+/** Sets multiple response options at once, replacing any existing response tags */
+export function setChoices(optionIds) {
+    return modifyPublicTags((tags) => {
+        // Remove existing response tags
+        const filteredTags = tags.filter((tag) => tag[0] !== "response");
+        // Add new response tags
+        const responseTags = optionIds.map((id) => ["response", id]);
+        return [...filteredTags, ...responseTags];
+    });
+}
+/** Sets a single response option, replacing any existing response tags (for single choice polls) */
+export function setChoice(optionId) {
+    return setChoices([optionId]);
+}

package/dist/operations/poll.d.ts

@@ -0,0 +1,19 @@
+import { EventOperation } from "applesauce-core/event-factory";
+import { PollType } from "../helpers/poll.js";
+/** Sets the content (poll question/label) for a poll event */
+export declare function setQuestion(question: string): EventOperation;
+/** Adds an option to a poll with an option ID and label */
+export declare function addOption(optionId: string, label: string): EventOperation;
+/** Sets multiple poll options at once, replacing any existing option tags */
+export declare function setOptions(options: Array<{
+    id: string;
+    label: string;
+}>): EventOperation;
+/** Sets the poll type (singlechoice or multiplechoice) */
+export declare function setType(pollType: PollType): EventOperation;
+/** Sets the poll expiration timestamp */
+export declare function setEndsAt(timestamp: number): EventOperation;
+/** Adds a relay URL where poll responses should be published */
+export declare function addRelay(relayUrl: string): EventOperation;
+/** Sets multiple relay URLs at once, replacing any existing relay tags */
+export declare function setRelays(relayUrls: string[]): EventOperation;

package/dist/operations/poll.js

@@ -0,0 +1,42 @@
+import { modifyPublicTags } from "applesauce-core/operations";
+import { includeSingletonTag } from "applesauce-core/operations/tags";
+/** Sets the content (poll question/label) for a poll event */
+export function setQuestion(question) {
+    return (draft) => ({ ...draft, content: question });
+}
+/** Adds an option to a poll with an option ID and label */
+export function addOption(optionId, label) {
+    return modifyPublicTags((tags) => [...tags, ["option", optionId, label]]);
+}
+/** Sets multiple poll options at once, replacing any existing option tags */
+export function setOptions(options) {
+    return modifyPublicTags((tags) => {
+        // Remove existing option tags
+        const filteredTags = tags.filter((tag) => tag[0] !== "option");
+        // Add new option tags
+        const optionTags = options.map((option) => ["option", option.id, option.label]);
+        return [...filteredTags, ...optionTags];
+    });
+}
+/** Sets the poll type (singlechoice or multiplechoice) */
+export function setType(pollType) {
+    return includeSingletonTag(["polltype", pollType]);
+}
+/** Sets the poll expiration timestamp */
+export function setEndsAt(timestamp) {
+    return includeSingletonTag(["endsAt", timestamp.toString()]);
+}
+/** Adds a relay URL where poll responses should be published */
+export function addRelay(relayUrl) {
+    return modifyPublicTags((tags) => [...tags, ["relay", relayUrl]]);
+}
+/** Sets multiple relay URLs at once, replacing any existing relay tags */
+export function setRelays(relayUrls) {
+    return modifyPublicTags((tags) => {
+        // Remove existing relay tags
+        const filteredTags = tags.filter((tag) => tag[0] !== "relay");
+        // Add new relay tags
+        const relayTags = relayUrls.map((url) => ["relay", url]);
+        return [...filteredTags, ...relayTags];
+    });
+}

package/dist/operations/reaction.d.ts

@@ -0,0 +1,7 @@
+import { EventOperation } from "applesauce-core/event-factory";
+import { NostrEvent } from "applesauce-core/helpers/event";
+import { Emoji } from "../helpers/emoji.js";
+/** Sets the content for a reaction event */
+export declare function setReaction(emoji?: string | Emoji): EventOperation;
+/** Includes NIP-25 "e", "p", "k", and "a" tags for a reaction event to point to a parent event */
+export declare function setReactionParent(event: NostrEvent): EventOperation;

package/dist/operations/reaction.js

@@ -0,0 +1,39 @@
+import { getTagValue, isAddressableKind } from "applesauce-core/helpers/event";
+import { ensureAddressPointerTag, ensureEventPointerTag, ensureKTag, ensureProfilePointerTag, } from "applesauce-core/helpers/factory";
+// TODO: some of these operations should be refactored to use "modifyPublicTags"
+/** Sets the content for a reaction event */
+export function setReaction(emoji = "+") {
+    return (draft) => ({ ...draft, content: typeof emoji === "string" ? emoji : `:${emoji.shortcode}:` });
+}
+/** Includes NIP-25 "e", "p", "k", and "a" tags for a reaction event to point to a parent event */
+export function setReactionParent(event) {
+    return async (draft, ctx) => {
+        let tags = Array.from(draft.tags);
+        const eventHint = await ctx?.getEventRelayHint?.(event.id);
+        const pubkeyHint = await ctx?.getPubkeyRelayHint?.(event.pubkey);
+        // include "e" tag
+        tags = ensureEventPointerTag(tags, {
+            id: event.id,
+            relays: eventHint ? [eventHint] : undefined,
+        });
+        // include "p" tag
+        tags = ensureProfilePointerTag(tags, {
+            pubkey: event.pubkey,
+            relays: pubkeyHint ? [pubkeyHint] : undefined,
+        });
+        if (isAddressableKind(event.kind)) {
+            // include "a" tag
+            const identifier = getTagValue(event, "d");
+            if (identifier)
+                tags = ensureAddressPointerTag(tags, {
+                    kind: event.kind,
+                    pubkey: event.pubkey,
+                    identifier,
+                    relays: eventHint ? [eventHint] : undefined,
+                });
+        }
+        // include "k" tag
+        tags = ensureKTag(tags, event.kind);
+        return { ...draft, tags };
+    };
+}

package/dist/operations/share.d.ts

@@ -0,0 +1,8 @@
+import { EventOperation } from "applesauce-core/event-factory";
+import { NostrEvent } from "applesauce-core/helpers/event";
+/** Includes NIP-18 repost tags */
+export declare function setShareTags(event: NostrEvent): EventOperation;
+/** Sets the NIP-18 repost kind based on the kind of event being shared */
+export declare function setShareKind(event: NostrEvent): EventOperation;
+/** Sets the content of the event to a JSON string of the shared event */
+export declare function embedSharedEvent(event: NostrEvent): EventOperation;

package/dist/operations/share.js

@@ -0,0 +1,34 @@
+import { isAddressableKind, kinds } from "applesauce-core/helpers/event";
+import { ensureAddressPointerTag, ensureEventPointerTag, ensureKTag, ensureProfilePointerTag, } from "applesauce-core/helpers/factory";
+import { getAddressPointerForEvent, getEventPointerForEvent } from "applesauce-core/helpers/pointers";
+import { setContent } from "applesauce-core/operations/content";
+// TODO: some of these operations should be refactored to use "modifyPublicTags"
+/** Includes NIP-18 repost tags */
+export function setShareTags(event) {
+    return async (draft, ctx) => {
+        let tags = Array.from(draft.tags);
+        const hint = await ctx.getEventRelayHint?.(event.id);
+        // add "e" tag
+        tags = ensureEventPointerTag(tags, getEventPointerForEvent(event, hint ? [hint] : undefined));
+        // add "a" tag
+        if (isAddressableKind(event.kind)) {
+            tags = ensureAddressPointerTag(tags, getAddressPointerForEvent(event, hint ? [hint] : undefined));
+        }
+        // add "p" tag for notify
+        const pubkeyHint = await ctx.getPubkeyRelayHint?.(event.pubkey);
+        tags = ensureProfilePointerTag(tags, { pubkey: event.pubkey, relays: pubkeyHint ? [pubkeyHint] : undefined });
+        // add "k" tag
+        tags = ensureKTag(tags, event.kind);
+        return { ...draft, tags };
+    };
+}
+/** Sets the NIP-18 repost kind based on the kind of event being shared */
+export function setShareKind(event) {
+    return (draft) => {
+        return { ...draft, kind: event.kind === kinds.ShortTextNote ? kinds.Repost : kinds.GenericRepost };
+    };
+}
+/** Sets the content of the event to a JSON string of the shared event */
+export function embedSharedEvent(event) {
+    return setContent(JSON.stringify(event));
+}

package/dist/operations/stream-chat.d.ts

@@ -0,0 +1,7 @@
+import { NostrEvent } from "applesauce-core/helpers/event";
+import { AddressPointer } from "applesauce-core/helpers/pointers";
+import { TextContentOptions } from "applesauce-core/operations/content";
+/** Sets the message content for a stream chat event */
+export declare function setMessage(content: string, options?: TextContentOptions): import("applesauce-core").EventOperation;
+/** Sets the stream for a stream chat event */
+export declare function setStream(stream: AddressPointer | NostrEvent): import("applesauce-core").EventOperation<import("nostr-tools").Event | import("nostr-tools/core").UnsignedEvent | import("nostr-tools/core").EventTemplate, import("nostr-tools").Event | import("nostr-tools/core").UnsignedEvent | import("nostr-tools/core").EventTemplate>;

package/dist/operations/stream-chat.js

@@ -0,0 +1,27 @@
+import { ensureAddressPointerTag } from "applesauce-core/helpers/factory";
+import { eventPipe, skip } from "applesauce-core/helpers/pipeline";
+import { getAddressPointerForEvent, isAddressPointer } from "applesauce-core/helpers/pointers";
+import { includeEmojis, includeQuoteTags, repairNostrLinks, setContent, setContentWarning, tagPubkeyMentions, } from "applesauce-core/operations/content";
+import { modifyPublicTags } from "applesauce-core/operations/tags";
+/** Sets the message content for a stream chat event */
+export function setMessage(content, options) {
+    return eventPipe(
+    // set text content
+    setContent(content), 
+    // fix @ mentions
+    repairNostrLinks(), 
+    // include "p" tags for pubkeys mentioned
+    tagPubkeyMentions(), 
+    // include event "q" tags
+    includeQuoteTags(), 
+    // include "emoji" tags
+    options?.emojis ? includeEmojis(options.emojis) : skip(), 
+    // set "content-warning" tag
+    options?.contentWarning !== undefined ? setContentWarning(options.contentWarning) : skip());
+}
+/** Sets the stream for a stream chat event */
+export function setStream(stream) {
+    if (!isAddressPointer(stream))
+        stream = getAddressPointerForEvent(stream);
+    return modifyPublicTags((tags) => ensureAddressPointerTag(tags, stream));
+}

package/dist/operations/stream.d.ts

@@ -0,0 +1,41 @@
+import { EventOperation } from "applesauce-core/event-factory";
+import { ProfilePointer } from "applesauce-core/helpers/pointers";
+import { StreamRole } from "../helpers/stream.js";
+/** Sets the title of a live event */
+export declare function setTitle(title: string): EventOperation;
+/** Sets the summary/description of a live event */
+export declare function setSummary(summary: string): EventOperation;
+/** Sets the preview image for a live event */
+export declare function setImage(image: string): EventOperation;
+/** Sets the streaming URL for a live event */
+export declare function setStreamingUrl(url: string | URL): EventOperation;
+/** Sets the recording URL for a live event (typically after the event ends) */
+export declare function setRecordingUrl(url: string | URL): EventOperation;
+/** Sets the start timestamp for a live event */
+export declare function setStartTime(start: number | Date): EventOperation;
+/** Sets the end timestamp for a live event */
+export declare function setEndTime(end: number | Date): EventOperation;
+/** Sets the status of a live event */
+export declare function setStatus(status: "planned" | "live" | "ended"): EventOperation;
+/** Sets the current number of participants */
+export declare function setCurrentViewers(count: number): EventOperation;
+/** Sets the total number of participants */
+export declare function setMaxViewers(count: number): EventOperation;
+/** Sets the host of the stream */
+export declare function setHost(user: ProfilePointer): EventOperation;
+/** Adds a participant to a live event with role and optional relay */
+export declare function addParticipant(user: ProfilePointer, role: StreamRole): EventOperation;
+/** Removes a participant from a live event */
+export declare function removeParticipant(pubkey: string): EventOperation;
+/** Adds a relay to the live event's relay list */
+export declare function addRelay(relay: string | URL): EventOperation;
+/** Removes a relay from the live event's relay list */
+export declare function removeRelay(relay: string | URL): EventOperation;
+/** Sets a pinned live chat message */
+export declare function setPinnedMessage(eventId: string): EventOperation;
+/** Removes the pinned live chat message */
+export declare function removePinnedMessage(): EventOperation;
+/** Adds a hashtag to the live event */
+export declare function addHashtag(hashtag: string): EventOperation;
+/** Removes a hashtag from the live event */
+export declare function removeHashtag(hashtag: string): EventOperation;

package/dist/operations/stream.js

@@ -0,0 +1,83 @@
+import { ensureMarkedProfilePointerTag } from "applesauce-core/helpers/factory";
+import { addNameValueTag, removeNameValueTag } from "applesauce-core/operations/tag/common";
+import { includeSingletonTag, modifyPublicTags } from "applesauce-core/operations/tags";
+import * as Hashtags from "./hashtags.js";
+// Live Event (kind:30311) Operations
+/** Sets the title of a live event */
+export function setTitle(title) {
+    return includeSingletonTag(["title", title], true);
+}
+/** Sets the summary/description of a live event */
+export function setSummary(summary) {
+    return includeSingletonTag(["summary", summary], true);
+}
+/** Sets the preview image for a live event */
+export function setImage(image) {
+    return includeSingletonTag(["image", image], true);
+}
+/** Sets the streaming URL for a live event */
+export function setStreamingUrl(url) {
+    return includeSingletonTag(["streaming", new URL(url).toString()], true);
+}
+/** Sets the recording URL for a live event (typically after the event ends) */
+export function setRecordingUrl(url) {
+    return includeSingletonTag(["recording", new URL(url).toString()], true);
+}
+/** Sets the start timestamp for a live event */
+export function setStartTime(start) {
+    const timestamp = typeof start === "number" ? start : Math.round(new Date(start).valueOf() / 1000);
+    return includeSingletonTag(["starts", String(timestamp)], true);
+}
+/** Sets the end timestamp for a live event */
+export function setEndTime(end) {
+    const timestamp = typeof end === "number" ? end : Math.round(new Date(end).valueOf() / 1000);
+    return includeSingletonTag(["ends", String(timestamp)], true);
+}
+/** Sets the status of a live event */
+export function setStatus(status) {
+    return includeSingletonTag(["status", status], true);
+}
+/** Sets the current number of participants */
+export function setCurrentViewers(count) {
+    return includeSingletonTag(["current_participants", String(count)], true);
+}
+/** Sets the total number of participants */
+export function setMaxViewers(count) {
+    return includeSingletonTag(["total_participants", String(count)], true);
+}
+/** Sets the host of the stream */
+export function setHost(user) {
+    return modifyPublicTags((tags) => ensureMarkedProfilePointerTag(tags, user, "host"));
+}
+/** Adds a participant to a live event with role and optional relay */
+export function addParticipant(user, role) {
+    return modifyPublicTags((tags) => ensureMarkedProfilePointerTag(tags, user, role));
+}
+/** Removes a participant from a live event */
+export function removeParticipant(pubkey) {
+    return modifyPublicTags(removeNameValueTag(["p", pubkey]));
+}
+/** Adds a relay to the live event's relay list */
+export function addRelay(relay) {
+    return modifyPublicTags(addNameValueTag(["relays", new URL(relay).toString()], true));
+}
+/** Removes a relay from the live event's relay list */
+export function removeRelay(relay) {
+    return modifyPublicTags(removeNameValueTag(["relays", new URL(relay).toString()]));
+}
+/** Sets a pinned live chat message */
+export function setPinnedMessage(eventId) {
+    return includeSingletonTag(["pinned", eventId], true);
+}
+/** Removes the pinned live chat message */
+export function removePinnedMessage() {
+    return modifyPublicTags((tags) => tags.filter((tag) => tag[0] !== "pinned"));
+}
+/** Adds a hashtag to the live event */
+export function addHashtag(hashtag) {
+    return Hashtags.addHashtag(hashtag);
+}
+/** Removes a hashtag from the live event */
+export function removeHashtag(hashtag) {
+    return Hashtags.removeHashtag(hashtag);
+}

package/dist/operations/tag/bookmarks.d.ts

@@ -0,0 +1,6 @@
+import { TagOperation } from "applesauce-core/event-factory";
+import { NostrEvent } from "applesauce-core/helpers/event";
+/** Adds an "e" or "a" tag to a bookmark list or set */
+export declare function addEventBookmarkTag(event: NostrEvent): TagOperation;
+/** Removes an "e" or "a" tag from a bookmark list or set */
+export declare function removeEventBookmarkTag(event: NostrEvent): TagOperation;

package/dist/operations/tag/bookmarks.js

@@ -0,0 +1,20 @@
+import { isReplaceable } from "applesauce-core/helpers";
+import { kinds } from "applesauce-core/helpers/event";
+import { getAddressPointerForEvent } from "applesauce-core/helpers/pointers";
+import { addAddressPointerTag, addEventPointerTag, removeAddressPointerTag, removeEventPointerTag, } from "applesauce-core/operations/tag/common";
+/** Adds an "e" or "a" tag to a bookmark list or set */
+export function addEventBookmarkTag(event) {
+    if (event.kind !== kinds.ShortTextNote && event.kind !== kinds.LongFormArticle)
+        throw new Error(`Event kind (${event.kind}) cant not be added to bookmarks`);
+    return isReplaceable(event.kind)
+        ? addAddressPointerTag(getAddressPointerForEvent(event))
+        : addEventPointerTag(event.id);
+}
+/** Removes an "e" or "a" tag from a bookmark list or set */
+export function removeEventBookmarkTag(event) {
+    if (event.kind !== kinds.ShortTextNote && event.kind !== kinds.LongFormArticle)
+        throw new Error(`Event kind (${event.kind}) cant not be added to bookmarks`);
+    return isReplaceable(event.kind)
+        ? removeAddressPointerTag(getAddressPointerForEvent(event))
+        : removeEventPointerTag(event.id);
+}

package/dist/operations/tag/index.d.ts

@@ -0,0 +1 @@
+export * from "./bookmarks.js";

package/dist/operations/tag/index.js

@@ -0,0 +1 @@
+export * from "./bookmarks.js";