applesauce-actions 0.0.0-next-20251220152312 → 0.0.0-next-20251231055351

package/README.md

@@ -18,12 +18,12 @@ Actions are common pre-built async operations that apps can perform. They use:
 - `EventFactory` to build and sign new nostr events
 - A `publish` method to publish or save the resulting events
 
-The package provides an `ActionHub` class that combines these components into a single manager for easier action execution.
+The package provides an `ActionRunner` class that combines these components into a single manager for easier action execution.
 
 ## Basic Usage
 
 ```typescript
-import { ActionHub } from "applesauce-actions";
+import { ActionRunner } from "applesauce-actions";
 import { FollowUser } from "applesauce-actions/actions";
 
 async function publishEvent(event: NostrEvent) {
@@ -31,7 +31,7 @@ async function publishEvent(event: NostrEvent) {
 }
 
 // Create an action hub with your event store, factory and publish method
-const hub = new ActionHub(eventStore, eventFactory, publishEvent);
+const hub = new ActionRunner(eventStore, eventFactory, publishEvent);
 
 // Example: Follow a user
 await hub

package/dist/{action-hub.d.ts → action-runner.d.ts}

@@ -32,7 +32,7 @@ export type Action = (context: ActionContext) => Promise<void>;
 /** A function that takes arguments and returns an action */
 export type ActionBuilder<Args extends Array<any>> = (...args: Args) => Action;
 /** The main class that runs actions */
-export declare class ActionHub {
+export declare class ActionRunner {
     events: IEventStoreRead & IEventStoreStreams & IEventSubscriptions & IEventStoreActions & EventModels;
     factory: EventFactory;
     private publishMethod?;
@@ -48,4 +48,6 @@ export declare class ActionHub {
     /** Run an action without publishing the events */
     exec<Args extends Array<any>>(builder: ActionBuilder<Args>, ...args: Args): Observable<NostrEvent>;
 }
+/** @deprecated Use ActionRunner instead */
+export declare const ActionHub: typeof ActionRunner;
 export {};

package/dist/{action-hub.js → action-runner.js}

@@ -1,7 +1,7 @@
 import { castUser } from "applesauce-common/casts/user";
 import { from, identity, isObservable, lastValueFrom, Observable, switchMap, tap } from "rxjs";
 /** The main class that runs actions */
-export class ActionHub {
+export class ActionRunner {
     events;
     factory;
     publishMethod;
@@ -37,7 +37,7 @@ export class ActionHub {
     /** Internal method for publishing events to relays */
     async publish(event, relays) {
         if (!this.publishMethod)
-            throw new Error("Missing publish method, use ActionHub.exec");
+            throw new Error("Missing publish method, use ActionRunner.exec");
         // Unwrap array of events to publish
         if (Array.isArray(event)) {
             await Promise.all(event.map((e) => this.publish(e, relays)));
@@ -87,3 +87,5 @@ export class ActionHub {
         this.saveToStore ? tap((event) => this.events.add(event)) : identity);
     }
 }
+/** @deprecated Use ActionRunner instead */
+export const ActionHub = ActionRunner;

package/dist/actions/app-data.d.ts

@@ -1,2 +1,2 @@
-import { Action } from "../action-hub.js";
+import { Action } from "../action-runner.js";
 export declare function UpdateAppData<T>(identifier: string, data: T): Action;

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

@@ -1,4 +1,4 @@
-import { Action } from "../action-hub.js";
+import { Action } from "../action-runner.js";
 /** An action that adds a relay to the 10006 blocked relays event */
 export declare function AddBlockedRelay(relay: string | string[], hidden?: boolean): Action;
 /** An action that removes a relay from the 10006 blocked relays event */

package/dist/actions/blocked-relays.js

@@ -7,7 +7,9 @@ import { of, timeout } from "rxjs";
 function ModifyBlockedRelaysEvent(operations) {
     return async ({ events, factory, user, publish, sign }) => {
         const [event, outboxes] = await Promise.all([
-            firstValueFrom(events.replaceable(kinds.BlockedRelaysList, user.pubkey).pipe(timeout({ first: 1000, with: () => of(undefined) }))),
+            firstValueFrom(events
+                .replaceable(kinds.BlockedRelaysList, user.pubkey)
+                .pipe(timeout({ first: 1000, with: () => of(undefined) }))),
             user.outboxes$.$first(1000, undefined),
         ]);
         // Modify or build new event

package/dist/actions/blossom.d.ts

@@ -1,4 +1,4 @@
-import { Action } from "../action-hub.js";
+import { Action } from "../action-runner.js";
 /** An action that adds a server to the Blossom servers event */
 export declare function AddBlossomServer(server: string | URL | (string | URL)[]): Action;
 /** An action that removes a server from the Blossom servers event */

package/dist/actions/bookmarks.d.ts

@@ -1,6 +1,6 @@
 import { AddressPointer, EventPointer } from "applesauce-core/helpers";
 import { NostrEvent } from "applesauce-core/helpers/event";
-import { Action } from "../action-hub.js";
+import { Action } from "../action-runner.js";
 /**
  * An action that adds a note or article to the bookmark list or a bookmark set
  * @param event the event to bookmark

package/dist/actions/calendar.d.ts

@@ -1,6 +1,6 @@
 import { AddressPointer } from "applesauce-core/helpers";
 import { NostrEvent } from "applesauce-core/helpers/event";
-import { Action } from "../action-hub.js";
+import { Action } from "../action-runner.js";
 /** Adds a calendar event to a calendar */
 export declare function AddEventToCalendar(calendar: NostrEvent | AddressPointer, event: NostrEvent | AddressPointer): Action;
 /** Removes a calendar event from a calendar */

package/dist/actions/comment.d.ts

@@ -0,0 +1,10 @@
+import { CommentBlueprintOptions } from "applesauce-common/blueprints";
+import { CommentPointer } from "applesauce-common/helpers/comment";
+import { NostrEvent } from "applesauce-core/helpers/event";
+import { Action } from "../action-runner.js";
+/**
+ * Creates a comment on an event or CommentPointer and publishes it to:
+ * - The parent event's author's inboxes (if the author exists and pubkey is available)
+ * - The current user's outboxes
+ */
+export declare function CreateComment(parent: NostrEvent | CommentPointer, content: string, options?: CommentBlueprintOptions): Action;

package/dist/actions/comment.js

@@ -0,0 +1,43 @@
+import { CommentBlueprint } from "applesauce-common/blueprints";
+import { castUser } from "applesauce-common/casts";
+import { isCommentAddressPointer, isCommentEventPointer } from "applesauce-common/helpers/comment";
+import { relaySet } from "applesauce-core/helpers";
+import { isEvent } from "applesauce-core/helpers/event";
+/**
+ * Extracts the pubkey from a parent event or CommentPointer.
+ * Returns undefined if the pubkey is not available.
+ */
+function getParentPubkey(parent) {
+    if (isEvent(parent))
+        return parent.pubkey;
+    if (isCommentEventPointer(parent))
+        return parent.pubkey;
+    if (isCommentAddressPointer(parent))
+        return parent.pubkey;
+    // CommentExternalPointer doesn't have a pubkey
+    return undefined;
+}
+/**
+ * Creates a comment on an event or CommentPointer and publishes it to:
+ * - The parent event's author's inboxes (if the author exists and pubkey is available)
+ * - The current user's outboxes
+ */
+export function CreateComment(parent, content, options) {
+    return async ({ factory, user, publish, events, sign }) => {
+        // Get the parent author's pubkey from the pointer/event (without loading the full event)
+        const parentAuthorPubkey = getParentPubkey(parent);
+        // Get the parent author's inboxes in parallel with resolving the event
+        const [parentAuthorInboxes, userOutboxes] = await Promise.all([
+            // Get inboxes if we have a pubkey and it's different from current user
+            parentAuthorPubkey ? castUser(parentAuthorPubkey, events).inboxes$.$first(1_000, undefined) : undefined,
+            // Get the current user's outboxes
+            user.outboxes$.$first(1_000, undefined),
+        ]);
+        // Create and sign the comment
+        const comment = await factory.create(CommentBlueprint, parent, content, options).then(sign);
+        // Combine all relay lists (remove duplicates)
+        const relays = relaySet(parentAuthorInboxes, userOutboxes);
+        // Publish to all relays (inboxes and outboxes)
+        await publish(comment, relays.length > 0 ? relays : undefined);
+    };
+}

package/dist/actions/contacts.d.ts

@@ -1,5 +1,5 @@
 import { ProfilePointer } from "applesauce-core/helpers/pointers";
-import { Action } from "../action-hub.js";
+import { Action } from "../action-runner.js";
 /** An action that adds a pubkey to a users contacts event */
 export declare function FollowUser(user: string | ProfilePointer): Action;
 /** An action that removes a pubkey from a users contacts event */

package/dist/actions/direct-message-relays.d.ts

@@ -1,4 +1,4 @@
-import { Action } from "../action-hub.js";
+import { Action } from "../action-runner.js";
 /** An action that adds a relay to the 10050 DM relays event */
 export declare function AddDirectMessageRelay(relay: string | string[]): Action;
 /** An action that removes a relay from the 10050 DM relays event */

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

@@ -1,5 +1,5 @@
 import { AddressPointer } from "applesauce-core/helpers/pointers";
-import { Action } from "../action-hub.js";
+import { Action } from "../action-runner.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 */

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

@@ -1,6 +1,6 @@
 import { NostrEvent } from "applesauce-core/helpers/event";
 import { ProfilePointer } from "applesauce-core/helpers/pointers";
-import { Action } from "../action-hub.js";
+import { Action } from "../action-runner.js";
 /**
  * An action that creates a new follow set
  * @throws if a follow set already exists

package/dist/actions/index.d.ts

@@ -3,6 +3,7 @@ export * from "./blocked-relays.js";
 export * from "./blossom.js";
 export * from "./bookmarks.js";
 export * from "./calendar.js";
+export * from "./comment.js";
 export * from "./contacts.js";
 export * from "./direct-message-relays.js";
 export * from "./favorite-relays.js";

package/dist/actions/index.js

@@ -3,6 +3,7 @@ export * from "./blocked-relays.js";
 export * from "./blossom.js";
 export * from "./bookmarks.js";
 export * from "./calendar.js";
+export * from "./comment.js";
 export * from "./contacts.js";
 export * from "./direct-message-relays.js";
 export * from "./favorite-relays.js";

package/dist/actions/legacy-messages.d.ts

@@ -1,6 +1,6 @@
 import { LegacyMessageBlueprintOptions } from "applesauce-common/blueprints";
 import { NostrEvent } from "applesauce-core/helpers/event";
-import { Action } from "../action-hub.js";
+import { Action } from "../action-runner.js";
 /** Sends a legacy NIP-04 message to a recipient */
 export declare function SendLegacyMessage(recipient: string, message: string, opts?: LegacyMessageBlueprintOptions): Action;
 /** Send a reply to a legacy message */

package/dist/actions/legacy-messages.js

@@ -18,7 +18,7 @@ export function SendLegacyMessage(recipient, message, opts) {
 }
 /** Send a reply to a legacy message */
 export function ReplyToLegacyMessage(parent, message, opts) {
-    return async ({ factory, sign, publish, events, }) => {
+    return async ({ factory, sign, publish, events }) => {
         if (parent.kind !== kinds.EncryptedDirectMessage)
             throw new Error("Legacy messages can only reply to other legacy messages");
         const signed = await factory.create(LegacyMessageReplyBlueprint, parent, message, opts).then(sign);

package/dist/actions/lists.d.ts

@@ -1,6 +1,6 @@
 import { NostrEvent } from "applesauce-core/helpers/event";
 import { AddressPointer } from "applesauce-core/helpers/pointers";
-import { Action } from "../action-hub.js";
+import { Action } from "../action-runner.js";
 /** An action that sets or removes a NIP-15 list information */
 export declare function SetListMetadata(list: NostrEvent | AddressPointer, info: {
     title?: string;

package/dist/actions/mailboxes.d.ts

@@ -1,4 +1,4 @@
-import { Action } from "../action-hub.js";
+import { Action } from "../action-runner.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 */

package/dist/actions/mute.d.ts

@@ -1,6 +1,6 @@
 import { NostrEvent } from "applesauce-core/helpers/event";
 import { EventPointer } from "applesauce-core/helpers/pointers";
-import { Action } from "../action-hub.js";
+import { Action } from "../action-runner.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 */

package/dist/actions/pins.d.ts

@@ -1,5 +1,5 @@
 import { NostrEvent } from "applesauce-core/helpers/event";
-import { Action } from "../action-hub.js";
+import { Action } from "../action-runner.js";
 export declare const ALLOWED_PIN_KINDS: number[];
 /** An action that pins a note to the users pin list */
 export declare function PinNote(note: NostrEvent): Action;

package/dist/actions/profile.d.ts

@@ -1,5 +1,5 @@
 import { ProfileContent } from "applesauce-core/helpers/profile";
-import { Action } from "../action-hub.js";
+import { Action } from "../action-runner.js";
 /** An action that creates a new kind 0 profile event for a user */
 export declare function CreateProfile(content: ProfileContent): Action;
 /** An action that updates a kind 0 profile evnet for a user */

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

@@ -1,5 +1,5 @@
 import { NostrEvent } from "applesauce-core/helpers/event";
-import { Action } from "../action-hub.js";
+import { Action } from "../action-runner.js";
 /** An action that adds a relay to a relay set*/
 export declare function AddRelayToRelaySet(relay: string | string[], identifier: NostrEvent | string, hidden?: boolean): Action;
 /** An action that removes a relay from a relay set */

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

@@ -1,4 +1,4 @@
-import { Action } from "../action-hub.js";
+import { Action } from "../action-runner.js";
 /** An action that adds a relay to the 10007 search relays event */
 export declare function AddSearchRelay(relay: string | string[], hidden?: boolean): Action;
 /** An action that removes a relay from the 10007 search relays event */

package/dist/actions/wrapped-messages.d.ts

@@ -1,7 +1,7 @@
 import { WrappedMessageBlueprintOptions } from "applesauce-common/blueprints";
 import { Rumor } from "applesauce-common/helpers/gift-wrap";
 import { GiftWrapOptions } from "applesauce-common/operations/gift-wrap";
-import { Action } from "../action-hub.js";
+import { Action } from "../action-runner.js";
 /** Gift wraps a message to a list of participants and publishes it to their inbox relays */
 export declare function GiftWrapMessageToParticipants(message: Rumor, opts?: GiftWrapOptions): Action;
 /**

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export * from "./action-hub.js";
+export * from "./action-runner.js";
 export * as Actions from "./actions/index.js";

package/dist/index.js

@@ -1,2 +1,2 @@
-export * from "./action-hub.js";
+export * from "./action-runner.js";
 export * as Actions from "./actions/index.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "applesauce-actions",
-  "version": "0.0.0-next-20251220152312",
+  "version": "0.0.0-next-20251231055351",
   "description": "A package for performing common nostr actions",
   "type": "module",
   "main": "dist/index.js",
@@ -32,14 +32,14 @@
     }
   },
   "dependencies": {
-    "applesauce-common": "0.0.0-next-20251220152312",
-    "applesauce-core": "0.0.0-next-20251220152312",
+    "applesauce-common": "0.0.0-next-20251231055351",
+    "applesauce-core": "0.0.0-next-20251231055351",
     "rxjs": "^7.8.1"
   },
   "devDependencies": {
     "@hirez_io/observer-spy": "^2.2.0",
     "@types/debug": "^4.1.12",
-    "applesauce-signers": "0.0.0-next-20251220152312",
+    "applesauce-signers": "0.0.0-next-20251231055351",
     "nanoid": "^5.1.5",
     "rimraf": "^6.0.1",
     "typescript": "^5.8.3",