applesauce-actions 0.11.0 → 1.0.0

package/dist/actions/blossom.js

@@ -0,0 +1,52 @@
+import { BLOSSOM_SERVER_LIST_KIND } from "applesauce-core/helpers/blossom";
+import { modifyPublicTags } from "applesauce-factory/operations/event";
+import { addBlossomServerTag, removeBlossomServerTag } from "applesauce-factory/operations/tag/blossom";
+function getBlossomServersEvent(events, self) {
+    const event = events.getReplaceable(BLOSSOM_SERVER_LIST_KIND, self);
+    if (!event)
+        throw new Error("Can't find Blossom servers event");
+    return event;
+}
+/** An action that adds a server to the Blossom servers event */
+export function AddBlossomServer(server) {
+    return async function* ({ events, factory, self }) {
+        const servers = getBlossomServersEvent(events, self);
+        const operation = Array.isArray(server) ? server.map((s) => addBlossomServerTag(s)) : addBlossomServerTag(server);
+        const draft = await factory.modifyTags(servers, operation);
+        yield await factory.sign(draft);
+    };
+}
+/** An action that removes a server from the Blossom servers event */
+export function RemoveBlossomServer(server) {
+    return async function* ({ events, factory, self }) {
+        const servers = getBlossomServersEvent(events, self);
+        const operation = Array.isArray(server)
+            ? server.map((s) => removeBlossomServerTag(s))
+            : removeBlossomServerTag(server);
+        const draft = await factory.modifyTags(servers, operation);
+        yield await factory.sign(draft);
+    };
+}
+/** Makes a specific Blossom server the default server (move it to the top of the list) */
+export function SetDefaultBlossomServer(server) {
+    return async function* ({ events, factory, self }) {
+        const servers = getBlossomServersEvent(events, self);
+        const prependTag = (tag) => (tags) => [tag, ...tags];
+        const draft = await factory.modifyTags(servers, [
+            removeBlossomServerTag(server),
+            prependTag(["server", String(server)]),
+        ]);
+        yield await factory.sign(draft);
+    };
+}
+/** Creates a new Blossom servers event */
+export function NewBlossomServers(servers) {
+    return async function* ({ events, factory, self }) {
+        const existing = events.getReplaceable(BLOSSOM_SERVER_LIST_KIND, self);
+        if (existing)
+            throw new Error("Blossom servers event already exists");
+        const operations = servers ? servers.map((s) => addBlossomServerTag(s)) : [];
+        const draft = await factory.build({ kind: BLOSSOM_SERVER_LIST_KIND }, modifyPublicTags(...operations));
+        yield await factory.sign(draft);
+    };
+}

package/dist/actions/bookmarks.d.ts

@@ -0,0 +1,24 @@
+import { NostrEvent } from "nostr-tools";
+import { Action } from "../action-hub.js";
+/**
+ * An action that adds a note or article to the bookmark list or a bookmark set
+ * @param event the event to bookmark
+ * @param identifier the "d" tag of the bookmark set
+ * @param hidden set to true to add to hidden bookmarks
+ */
+export declare function BookmarkEvent(event: NostrEvent, identifier?: string, hidden?: boolean): Action;
+/**
+ * An action that removes a note or article from the bookmark list or bookmark set
+ * @param event the event to remove from bookmarks
+ * @param identifier the "d" tag of the bookmark set
+ * @param hidden set to true to remove from hidden bookmarks
+ */
+export declare function UnbookmarkEvent(event: NostrEvent, identifier: string, hidden?: boolean): Action;
+/** An action that creates a new bookmark list for a user */
+export declare function CreateBookmarkList(bookmarks?: NostrEvent[]): Action;
+/** An action that creates a new bookmark set for a user */
+export declare function CreateBookmarkSet(title: string, description: string, additional: {
+    image?: string;
+    hidden?: NostrEvent[];
+    public?: NostrEvent[];
+}): Action;

package/dist/actions/bookmarks.js

@@ -0,0 +1,58 @@
+import { kinds } from "nostr-tools";
+import { addEventBookmarkTag, removeEventBookmarkTag } from "applesauce-factory/operations/tag";
+import { modifyHiddenTags, modifyPublicTags, setListDescription, setListImage, setListTitle, } from "applesauce-factory/operations/event";
+function getBookmarkEvent(events, self, identifier) {
+    return events.getReplaceable(identifier ? kinds.Bookmarksets : kinds.BookmarkList, self, identifier);
+}
+/**
+ * An action that adds a note or article to the bookmark list or a bookmark set
+ * @param event the event to bookmark
+ * @param identifier the "d" tag of the bookmark set
+ * @param hidden set to true to add to hidden bookmarks
+ */
+export function BookmarkEvent(event, identifier, hidden = false) {
+    return async function* ({ events, factory, self }) {
+        const bookmarks = getBookmarkEvent(events, self, identifier);
+        if (!bookmarks)
+            throw new Error("Cant find bookmarks");
+        const operation = addEventBookmarkTag(event);
+        const draft = await factory.modifyTags(bookmarks, hidden ? { hidden: operation } : operation);
+        yield await factory.sign(draft);
+    };
+}
+/**
+ * An action that removes a note or article from the bookmark list or bookmark set
+ * @param event the event to remove from bookmarks
+ * @param identifier the "d" tag of the bookmark set
+ * @param hidden set to true to remove from hidden bookmarks
+ */
+export function UnbookmarkEvent(event, identifier, hidden = false) {
+    return async function* ({ events, factory, self }) {
+        const bookmarks = getBookmarkEvent(events, self, identifier);
+        if (!bookmarks)
+            throw new Error("Cant find bookmarks");
+        const operation = removeEventBookmarkTag(event);
+        const draft = await factory.modifyTags(bookmarks, hidden ? { hidden: operation } : operation);
+        yield await factory.sign(draft);
+    };
+}
+/** An action that creates a new bookmark list for a user */
+export function CreateBookmarkList(bookmarks) {
+    return async function* ({ events, factory, self }) {
+        const existing = getBookmarkEvent(events, self);
+        if (existing)
+            throw new Error("Bookmark list already exists");
+        const draft = await factory.build({ kind: kinds.BookmarkList }, bookmarks ? modifyPublicTags(...bookmarks.map(addEventBookmarkTag)) : undefined);
+        yield await factory.sign(draft);
+    };
+}
+/** An action that creates a new bookmark set for a user */
+export function CreateBookmarkSet(title, description, additional) {
+    return async function* ({ events, factory, self }) {
+        const existing = getBookmarkEvent(events, self);
+        if (existing)
+            throw new Error("Bookmark list already exists");
+        const draft = await factory.process({ kind: kinds.BookmarkList }, setListTitle(title), setListDescription(description), additional.image ? setListImage(additional.image) : undefined, additional.public ? modifyPublicTags(...additional.public.map(addEventBookmarkTag)) : undefined, additional.hidden ? modifyHiddenTags(...additional.hidden.map(addEventBookmarkTag)) : undefined);
+        yield await factory.sign(draft);
+    };
+}

package/dist/actions/contacts.d.ts

@@ -0,0 +1,7 @@
+import { Action } from "../action-hub.js";
+/** An action that adds a pubkey to a users contacts event */
+export declare function FollowUser(pubkey: string, relay?: string, hidden?: boolean): Action;
+/** An action that removes a pubkey from a users contacts event */
+export declare function UnfollowUser(pubkey: string, hidden?: boolean): Action;
+/** An action that creates a new kind 3 contacts lists, throws if a contact list already exists */
+export declare function NewContacts(pubkeys?: string[]): Action;

package/dist/actions/contacts.js

@@ -0,0 +1,35 @@
+import { kinds } from "nostr-tools";
+import { addPubkeyTag, removePubkeyTag } from "applesauce-factory/operations/tag";
+/** An action that adds a pubkey to a users contacts event */
+export function FollowUser(pubkey, relay, hidden = false) {
+    return async function* ({ events, factory, self }) {
+        const contacts = events.getReplaceable(kinds.Contacts, self);
+        if (!contacts)
+            throw new Error("Missing contacts event");
+        const pointer = { pubkey, relays: relay ? [relay] : undefined };
+        const operation = addPubkeyTag(pointer);
+        const draft = await factory.modifyTags(contacts, hidden ? { hidden: operation } : operation);
+        yield await factory.sign(draft);
+    };
+}
+/** An action that removes a pubkey from a users contacts event */
+export function UnfollowUser(pubkey, hidden = false) {
+    return async function* ({ events, factory, self }) {
+        const contacts = events.getReplaceable(kinds.Contacts, self);
+        if (!contacts)
+            throw new Error("Missing contacts event");
+        const operation = removePubkeyTag(pubkey);
+        const draft = await factory.modifyTags(contacts, hidden ? { hidden: operation } : operation);
+        yield await factory.sign(draft);
+    };
+}
+/** An action that creates a new kind 3 contacts lists, throws if a contact list already exists */
+export function NewContacts(pubkeys) {
+    return async function* ({ events, factory, self }) {
+        const contacts = events.getReplaceable(kinds.Contacts, self);
+        if (contacts)
+            throw new Error("Contact list already exists");
+        const draft = await factory.process({ kind: kinds.Contacts, tags: pubkeys?.map((p) => ["p", p]) });
+        yield await factory.sign(draft);
+    };
+}

package/dist/actions/dm-relays.d.ts

@@ -0,0 +1,7 @@
+import { Action } from "../action-hub.js";
+/** An action that adds a relay to the 10050 DM relays event */
+export declare function AddDMRelay(relay: string | string[]): Action;
+/** An action that removes a relay from the 10050 DM relays event */
+export declare function RemoveDMRelay(relay: string | string[]): Action;
+/** Creates a new DM relays event */
+export declare function NewDMRelays(relays?: string[]): Action;

package/dist/actions/dm-relays.js

@@ -0,0 +1,38 @@
+import { modifyPublicTags } from "applesauce-factory/operations/event";
+import { addRelayTag, removeRelayTag } from "applesauce-factory/operations/tag/relay";
+import { kinds } from "nostr-tools";
+function getDMRelaysEvent(events, self) {
+    const event = events.getReplaceable(kinds.DirectMessageRelaysList, self);
+    if (!event)
+        throw new Error("Can't find DM relays event");
+    return event;
+}
+/** An action that adds a relay to the 10050 DM relays event */
+export function AddDMRelay(relay) {
+    return async function* ({ events, factory, self }) {
+        const dmRelays = getDMRelaysEvent(events, self);
+        const operation = Array.isArray(relay) ? relay.map((r) => addRelayTag(r)) : addRelayTag(relay);
+        const draft = await factory.modifyTags(dmRelays, operation);
+        yield await factory.sign(draft);
+    };
+}
+/** An action that removes a relay from the 10050 DM relays event */
+export function RemoveDMRelay(relay) {
+    return async function* ({ events, factory, self }) {
+        const dmRelays = getDMRelaysEvent(events, self);
+        const operation = Array.isArray(relay) ? relay.map((r) => removeRelayTag(r)) : removeRelayTag(relay);
+        const draft = await factory.modifyTags(dmRelays, operation);
+        yield await factory.sign(draft);
+    };
+}
+/** Creates a new DM relays event */
+export function NewDMRelays(relays) {
+    return async function* ({ events, factory, self }) {
+        const dmRelays = events.getReplaceable(kinds.DirectMessageRelaysList, self);
+        if (dmRelays)
+            throw new Error("DM relays event already exists");
+        const operations = relays?.map((r) => addRelayTag(r)) ?? [];
+        const draft = await factory.build({ kind: kinds.DirectMessageRelaysList }, modifyPublicTags(...operations));
+        yield await factory.sign(draft);
+    };
+}

package/dist/actions/favorite-relays.d.ts

@@ -0,0 +1,18 @@
+import { AddressPointer } from "nostr-tools/nip19";
+import { Action } from "../action-hub.js";
+/** An action that adds a relay to the 10012 favorite relays event */
+export declare function AddFavoriteRelay(relay: string | string[], hidden?: boolean): Action;
+/** An action that removes a relay from the 10012 favorite relays event */
+export declare function RemoveFavoriteRelay(relay: string | string[], hidden?: boolean): Action;
+/** An action that adds a relay set to the 10012 favorite relays event */
+export declare function AddFavoriteRelaySet(addr: AddressPointer[] | AddressPointer, hidden?: boolean): Action;
+/** An action that removes a relay set from the 10012 favorite relays event */
+export declare function RemoveFavoriteRelaySet(addr: AddressPointer[] | AddressPointer, hidden?: boolean): Action;
+/** Creates a new favorite relays event */
+export declare function NewFavoriteRelays(relays?: string[] | {
+    public?: string[];
+    hidden?: string[];
+}, sets?: AddressPointer[] | {
+    public?: AddressPointer[];
+    hidden?: AddressPointer[];
+}): Action;

package/dist/actions/favorite-relays.js

@@ -0,0 +1,75 @@
+import { FAVORITE_RELAYS_KIND } from "applesauce-core/helpers/lists";
+import { modifyHiddenTags, modifyPublicTags } from "applesauce-factory/operations/event";
+import { addCoordinateTag, addRelayTag, removeCoordinateTag, removeRelayTag } from "applesauce-factory/operations/tag";
+function getFavoriteRelaysEvent(events, self) {
+    const event = events.getReplaceable(FAVORITE_RELAYS_KIND, self);
+    if (!event)
+        throw new Error("Can't find favorite relays event");
+    return event;
+}
+/** An action that adds a relay to the 10012 favorite relays event */
+export function AddFavoriteRelay(relay, hidden = false) {
+    return async function* ({ events, factory, self }) {
+        const favorites = getFavoriteRelaysEvent(events, self);
+        const operation = Array.isArray(relay) ? relay.map((r) => addRelayTag(r)) : addRelayTag(relay);
+        const draft = await factory.modifyTags(favorites, hidden ? { hidden: operation } : operation);
+        yield await factory.sign(draft);
+    };
+}
+/** An action that removes a relay from the 10012 favorite relays event */
+export function RemoveFavoriteRelay(relay, hidden = false) {
+    return async function* ({ events, factory, self }) {
+        const favorites = getFavoriteRelaysEvent(events, self);
+        const operation = Array.isArray(relay) ? relay.map((r) => removeRelayTag(r)) : removeRelayTag(relay);
+        const draft = await factory.modifyTags(favorites, hidden ? { hidden: operation } : operation);
+        yield await factory.sign(draft);
+    };
+}
+/** An action that adds a relay set to the 10012 favorite relays event */
+export function AddFavoriteRelaySet(addr, hidden = false) {
+    return async function* ({ events, factory, self }) {
+        const favorites = getFavoriteRelaysEvent(events, self);
+        const operation = Array.isArray(addr) ? addr.map((a) => addCoordinateTag(a)) : addCoordinateTag(addr);
+        const draft = await factory.modifyTags(favorites, hidden ? { hidden: operation } : operation);
+        yield await factory.sign(draft);
+    };
+}
+/** An action that removes a relay set from the 10012 favorite relays event */
+export function RemoveFavoriteRelaySet(addr, hidden = false) {
+    return async function* ({ events, factory, self }) {
+        const favorites = getFavoriteRelaysEvent(events, self);
+        const operation = Array.isArray(addr) ? addr.map((a) => removeCoordinateTag(a)) : removeCoordinateTag(addr);
+        const draft = await factory.modifyTags(favorites, hidden ? { hidden: operation } : operation);
+        yield await factory.sign(draft);
+    };
+}
+/** Creates a new favorite relays event */
+export function NewFavoriteRelays(relays, sets) {
+    return async function* ({ events, factory, self }) {
+        const favorites = events.getReplaceable(FAVORITE_RELAYS_KIND, self);
+        if (favorites)
+            throw new Error("Favorite relays event already exists");
+        let publicOperations = [];
+        let hiddenOperations = [];
+        if (Array.isArray(relays)) {
+            publicOperations.push(...relays.map((r) => addRelayTag(r)));
+        }
+        else {
+            if (relays?.public)
+                publicOperations.push(...(relays?.public ?? []).map((r) => addRelayTag(r)));
+            if (relays?.hidden)
+                hiddenOperations.push(...(relays?.hidden ?? []).map((r) => addRelayTag(r)));
+        }
+        if (Array.isArray(sets)) {
+            publicOperations.push(...sets.map((s) => addCoordinateTag(s)));
+        }
+        else {
+            if (sets?.public)
+                publicOperations.push(...(sets?.public ?? []).map((s) => addCoordinateTag(s)));
+            if (sets?.hidden)
+                hiddenOperations.push(...(sets?.hidden ?? []).map((s) => addCoordinateTag(s)));
+        }
+        const draft = await factory.build({ kind: FAVORITE_RELAYS_KIND }, publicOperations.length ? modifyPublicTags(...publicOperations) : undefined, hiddenOperations.length ? modifyHiddenTags(...hiddenOperations) : undefined);
+        yield await factory.sign(draft);
+    };
+}

package/dist/actions/follow-sets.d.ts

@@ -0,0 +1,43 @@
+import { NostrEvent } from "nostr-tools";
+import { Action } from "../action-hub.js";
+import { ProfilePointer } from "nostr-tools/nip19";
+/**
+ * An action that creates a new follow set
+ * @param identifier the "d" tag of the follow set
+ * @param pubkeys the pubkeys to add to the follow set
+ * @param hidden set to true to create a hidden follow set
+ * @throws if a follow set already exists
+ */
+export declare function CreateFollowSet(title: string, options?: {
+    description?: string;
+    image?: string;
+    public?: (string | ProfilePointer)[];
+    hidden?: (string | ProfilePointer)[];
+}): Action;
+/**
+ * An action that adds a pubkey to a follow set
+ * @param pubkey the pubkey to add to the set
+ * @param identifier the "d" tag of the follow set
+ * @param hidden set to true to add to hidden follows
+ * @throws if the follow set does not exist
+ */
+export declare function AddUserToFollowSet(pubkey: (string | ProfilePointer)[] | string | ProfilePointer, identifier: NostrEvent | string, hidden?: boolean): Action;
+/**
+ * An action that removes a pubkey from a follow set
+ * @param pubkey the pubkey to remove from the set
+ * @param identifier the "d" tag of the follow set
+ * @param hidden set to true to remove from hidden follows
+ * @throws if the follow set does not exist
+ */
+export declare function RemoveUserFromFollowSet(pubkey: (string | ProfilePointer)[] | string | ProfilePointer, identifier: NostrEvent | string, hidden?: boolean): Action;
+/**
+ * An action that updates the title, description, or image of a follow set
+ * @param identifier the "d" tag of the follow set
+ * @param info the new information for the follow set
+ * @throws if the follow set does not exist
+ */
+export declare function UpdateFollowSetInformation(identifier: string, info: {
+    title?: string;
+    description?: string;
+    image?: string;
+}): Action;

package/dist/actions/follow-sets.js

@@ -0,0 +1,71 @@
+import { kinds } from "nostr-tools";
+import { addPubkeyTag, removePubkeyTag } from "applesauce-factory/operations/tag";
+import { modifyHiddenTags, modifyPublicTags, setListDescription, setListImage, setListTitle, } from "applesauce-factory/operations/event";
+function getFollowSetEvent(events, self, identifier) {
+    const set = typeof identifier === "string" ? events.getReplaceable(kinds.Followsets, self, identifier) : identifier;
+    if (!set)
+        throw new Error("Can't find follow set");
+    if (set.kind !== kinds.Followsets)
+        throw new Error("Event is not a follow set");
+    return set;
+}
+/**
+ * An action that creates a new follow set
+ * @param identifier the "d" tag of the follow set
+ * @param pubkeys the pubkeys to add to the follow set
+ * @param hidden set to true to create a hidden follow set
+ * @throws if a follow set already exists
+ */
+export function CreateFollowSet(title, options) {
+    return async function* ({ factory }) {
+        const draft = await factory.build({ kind: kinds.Followsets }, 
+        // set list information
+        setListTitle(title), options?.description ? setListDescription(options.description) : undefined, options?.image ? setListImage(options.image) : undefined, 
+        // add pubkey tags
+        options?.public ? modifyPublicTags(...options.public.map((p) => addPubkeyTag(p))) : undefined, options?.hidden ? modifyHiddenTags(...options.hidden.map((p) => addPubkeyTag(p))) : undefined);
+        yield await factory.sign(draft);
+    };
+}
+/**
+ * An action that adds a pubkey to a follow set
+ * @param pubkey the pubkey to add to the set
+ * @param identifier the "d" tag of the follow set
+ * @param hidden set to true to add to hidden follows
+ * @throws if the follow set does not exist
+ */
+export function AddUserToFollowSet(pubkey, identifier, hidden = false) {
+    return async function* ({ events, factory, self }) {
+        const follows = getFollowSetEvent(events, self, identifier);
+        const operations = Array.isArray(pubkey) ? pubkey.map((p) => addPubkeyTag(p)) : addPubkeyTag(pubkey);
+        const draft = await factory.modifyTags(follows, hidden ? { hidden: operations } : operations);
+        yield await factory.sign(draft);
+    };
+}
+/**
+ * An action that removes a pubkey from a follow set
+ * @param pubkey the pubkey to remove from the set
+ * @param identifier the "d" tag of the follow set
+ * @param hidden set to true to remove from hidden follows
+ * @throws if the follow set does not exist
+ */
+export function RemoveUserFromFollowSet(pubkey, identifier, hidden = false) {
+    return async function* ({ events, factory, self }) {
+        const follows = getFollowSetEvent(events, self, identifier);
+        const operations = Array.isArray(pubkey) ? pubkey.map((p) => removePubkeyTag(p)) : removePubkeyTag(pubkey);
+        const draft = await factory.modifyTags(follows, hidden ? { hidden: operations } : operations);
+        yield await factory.sign(draft);
+    };
+}
+/**
+ * An action that updates the title, description, or image of a follow set
+ * @param identifier the "d" tag of the follow set
+ * @param info the new information for the follow set
+ * @throws if the follow set does not exist
+ */
+export function UpdateFollowSetInformation(identifier, info) {
+    return async function* ({ events, factory, self }) {
+        const follows = getFollowSetEvent(events, self, identifier);
+        const draft = await factory.modify(follows, info?.title ? setListTitle(info.title) : undefined, info?.description ? setListDescription(info.description) : undefined, info?.image ? setListImage(info.image) : undefined);
+        yield await factory.sign(draft);
+    };
+}

package/dist/actions/index.d.ts

@@ -0,0 +1,13 @@
+export * from "./blocked-relays.js";
+export * from "./blossom.js";
+export * from "./bookmarks.js";
+export * from "./contacts.js";
+export * from "./dm-relays.js";
+export * from "./favorite-relays.js";
+export * from "./follow-sets.js";
+export * from "./mailboxes.js";
+export * from "./mute.js";
+export * from "./pins.js";
+export * from "./profile.js";
+export * from "./relay-sets.js";
+export * from "./search-relays.js";

package/dist/actions/index.js

@@ -0,0 +1,13 @@
+export * from "./blocked-relays.js";
+export * from "./blossom.js";
+export * from "./bookmarks.js";
+export * from "./contacts.js";
+export * from "./dm-relays.js";
+export * from "./favorite-relays.js";
+export * from "./follow-sets.js";
+export * from "./mailboxes.js";
+export * from "./mute.js";
+export * from "./pins.js";
+export * from "./profile.js";
+export * from "./relay-sets.js";
+export * from "./search-relays.js";

package/dist/actions/mailboxes.d.ts

@@ -0,0 +1,11 @@
+import { Action } from "../action-hub.js";
+/** An action to create a new kind 10002 relay list event */
+export declare function CreateMailboxes(inboxes: string[], outboxes: string[]): Action;
+/** An action to add an inbox relay to the kind 10002 relay list */
+export declare function AddInboxRelay(relay: string | string[]): Action;
+/** An action to remove an inbox relay from the kind 10002 relay list */
+export declare function RemoveInboxRelay(relay: string | string[]): Action;
+/** An action to add an outbox relay to the kind 10002 relay list */
+export declare function AddOutboxRelay(relay: string | string[]): Action;
+/** An action to remove an outbox relay from the kind 10002 relay list */
+export declare function RemoveOutboxRelay(relay: string | string[]): Action;

package/dist/actions/mailboxes.js

@@ -0,0 +1,66 @@
+import { kinds } from "nostr-tools";
+import { addInboxRelay, addOutboxRelay, removeInboxRelay, removeOutboxRelay } from "applesauce-factory/operations/tag";
+import { modifyPublicTags } from "applesauce-factory/operations/event";
+/** An action to create a new kind 10002 relay list event */
+export function CreateMailboxes(inboxes, outboxes) {
+    return async function* ({ events, factory, self }) {
+        const mailboxes = events.getReplaceable(kinds.RelayList, self);
+        if (mailboxes)
+            throw new Error("Mailbox event already exists");
+        const draft = await factory.build({ kind: kinds.RelayList }, modifyPublicTags(...inboxes.map(addInboxRelay), ...outboxes.map(addOutboxRelay)));
+        const signed = await factory.sign(draft);
+        yield signed;
+    };
+}
+/** An action to add an inbox relay to the kind 10002 relay list */
+export function AddInboxRelay(relay) {
+    return async function* ({ events, factory, self }) {
+        if (typeof relay === "string")
+            relay = [relay];
+        const mailboxes = events.getReplaceable(kinds.RelayList, self);
+        if (!mailboxes)
+            throw new Error("Missing mailboxes event");
+        const draft = await factory.modifyTags(mailboxes, ...relay.map(addInboxRelay));
+        const signed = await factory.sign(draft);
+        yield signed;
+    };
+}
+/** An action to remove an inbox relay from the kind 10002 relay list */
+export function RemoveInboxRelay(relay) {
+    return async function* ({ events, factory, self }) {
+        if (typeof relay === "string")
+            relay = [relay];
+        const mailboxes = events.getReplaceable(kinds.RelayList, self);
+        if (!mailboxes)
+            throw new Error("Missing mailboxes event");
+        const draft = await factory.modifyTags(mailboxes, ...relay.map(removeInboxRelay));
+        const signed = await factory.sign(draft);
+        yield signed;
+    };
+}
+/** An action to add an outbox relay to the kind 10002 relay list */
+export function AddOutboxRelay(relay) {
+    return async function* ({ events, factory, self }) {
+        if (typeof relay === "string")
+            relay = [relay];
+        const mailboxes = events.getReplaceable(kinds.RelayList, self);
+        if (!mailboxes)
+            throw new Error("Missing mailboxes event");
+        const draft = await factory.modifyTags(mailboxes, ...relay.map(addOutboxRelay));
+        const signed = await factory.sign(draft);
+        yield signed;
+    };
+}
+/** An action to remove an outbox relay from the kind 10002 relay list */
+export function RemoveOutboxRelay(relay) {
+    return async function* ({ events, factory, self }) {
+        if (typeof relay === "string")
+            relay = [relay];
+        const mailboxes = events.getReplaceable(kinds.RelayList, self);
+        if (!mailboxes)
+            throw new Error("Missing mailboxes event");
+        const draft = await factory.modifyTags(mailboxes, ...relay.map(removeOutboxRelay));
+        const signed = await factory.sign(draft);
+        yield signed;
+    };
+}

package/dist/actions/mute.d.ts

@@ -0,0 +1,19 @@
+import { NostrEvent } from "nostr-tools";
+import { EventPointer } from "nostr-tools/nip19";
+import { Action } from "../action-hub.js";
+/** An action that adds a pubkey to the mute list */
+export declare function MuteUser(pubkey: string, hidden?: boolean): Action;
+/** Removes a pubkey from the mute list */
+export declare function UnmuteUser(pubkey: string, hidden?: boolean): Action;
+/** Add a thread to the mute list */
+export declare function MuteThread(thread: string | NostrEvent | EventPointer, hidden?: boolean): Action;
+/** Removes a thread from the mute list */
+export declare function UnmuteThread(thread: string | NostrEvent | EventPointer, hidden?: boolean): Action;
+/** Add a word to the mute list */
+export declare function MuteWord(word: string, hidden?: boolean): Action;
+/** Removes a word from the mute list */
+export declare function UnmuteWord(word: string, hidden?: boolean): Action;
+/** Add a hashtag to the mute list */
+export declare function MuteHashtag(hashtag: string, hidden?: boolean): Action;
+/** Removes a hashtag from the mute list */
+export declare function UnmuteHashtag(hashtag: string, hidden?: boolean): Action;

package/dist/actions/mute.js

@@ -0,0 +1,79 @@
+import { addEventTag, addNameValueTag, addPubkeyTag, removeEventTag, removeNameValueTag, removePubkeyTag, } from "applesauce-factory/operations/tag";
+import { kinds } from "nostr-tools";
+function ensureMuteList(events, self) {
+    const mute = events.getReplaceable(kinds.Mutelist, self);
+    if (!mute)
+        throw new Error("No mute list found");
+    return mute;
+}
+/** An action that adds a pubkey to the mute list */
+export function MuteUser(pubkey, hidden = false) {
+    return async function* ({ events, factory, self }) {
+        const mute = ensureMuteList(events, self);
+        const operation = addPubkeyTag(pubkey);
+        const draft = await factory.modifyTags(mute, hidden ? { hidden: operation } : operation);
+        yield await factory.sign(draft);
+    };
+}
+/** Removes a pubkey from the mute list */
+export function UnmuteUser(pubkey, hidden = false) {
+    return async function* ({ events, factory, self }) {
+        const mute = ensureMuteList(events, self);
+        const draft = await factory.modifyTags(mute, hidden ? { hidden: removePubkeyTag(pubkey) } : removePubkeyTag(pubkey));
+        yield await factory.sign(draft);
+    };
+}
+/** Add a thread to the mute list */
+export function MuteThread(thread, hidden = false) {
+    return async function* ({ events, factory, self }) {
+        const mute = ensureMuteList(events, self);
+        const operation = addEventTag(thread);
+        const draft = await factory.modifyTags(mute, hidden ? { hidden: operation } : operation);
+        yield await factory.sign(draft);
+    };
+}
+/** Removes a thread from the mute list */
+export function UnmuteThread(thread, hidden = false) {
+    return async function* ({ events, factory, self }) {
+        const mute = ensureMuteList(events, self);
+        const operation = removeEventTag(thread);
+        const draft = await factory.modifyTags(mute, hidden ? { hidden: operation } : operation);
+        yield await factory.sign(draft);
+    };
+}
+/** Add a word to the mute list */
+export function MuteWord(word, hidden = false) {
+    return async function* ({ events, factory, self }) {
+        const mute = ensureMuteList(events, self);
+        const operation = addNameValueTag(["word", word.toLocaleLowerCase()], true);
+        const draft = await factory.modifyTags(mute, hidden ? { hidden: operation } : operation);
+        yield await factory.sign(draft);
+    };
+}
+/** Removes a word from the mute list */
+export function UnmuteWord(word, hidden = false) {
+    return async function* ({ events, factory, self }) {
+        const mute = ensureMuteList(events, self);
+        const operation = removeNameValueTag(["word", word.toLocaleLowerCase()]);
+        const draft = await factory.modifyTags(mute, hidden ? { hidden: operation } : operation);
+        yield await factory.sign(draft);
+    };
+}
+/** Add a hashtag to the mute list */
+export function MuteHashtag(hashtag, hidden = false) {
+    return async function* ({ events, factory, self }) {
+        const mute = ensureMuteList(events, self);
+        const operation = addNameValueTag(["t", hashtag.toLocaleLowerCase()], true);
+        const draft = await factory.modifyTags(mute, hidden ? { hidden: operation } : operation);
+        yield await factory.sign(draft);
+    };
+}
+/** Removes a hashtag from the mute list */
+export function UnmuteHashtag(hashtag, hidden = false) {
+    return async function* ({ events, factory, self }) {
+        const mute = ensureMuteList(events, self);
+        const operation = removeNameValueTag(["t", hashtag.toLocaleLowerCase()]);
+        const draft = await factory.modifyTags(mute, hidden ? { hidden: operation } : operation);
+        yield await factory.sign(draft);
+    };
+}