applesauce-common 0.0.0-next-20251203172109

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 hzrd149
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,59 @@
+# applesauce-common
+
+AppleSauce is a collection of utilities for building reactive nostr applications. The common package provides NIP-specific helpers and models for working with various Nostr Improvement Proposals (NIPs).
+
+## Key Components
+
+- **Helpers**: NIP-specific utility methods for parsing and extracting data from nostr events
+- **Models**: Complex subscriptions for NIP-specific nostr data patterns
+
+## Documentation
+
+For detailed documentation and guides, visit:
+
+- [Getting Started](https://hzrd149.github.io/applesauce/introduction/getting-started)
+- [API Reference](https://hzrd149.github.io/applesauce/typedoc/)
+
+## Example
+
+```js
+import { EventStore } from "applesauce-core";
+import { ThreadModel } from "applesauce-common/models";
+import { getNip10References } from "applesauce-common/helpers/threading";
+import { Relay } from "nostr-tools/relay";
+
+// Create a single EventStore instance for your app
+const eventStore = new EventStore();
+
+// Use any nostr library for relay connections (nostr-tools, ndk, nostrify, etc...)
+const relay = await Relay.connect("wss://relay.example.com");
+
+// Subscribe to events and add them to the store
+const sub = relay.subscribe([{ ids: ["event-id"] }], {
+  onevent(event) {
+    eventStore.add(event);
+  },
+});
+
+// Get NIP-10 thread references
+const refs = getNip10References(event);
+
+// Subscribe to a thread using ThreadModel
+const thread = eventStore.model(ThreadModel, "event-id");
+
+thread.subscribe((thread) => {
+  console.log(thread);
+});
+```
+
+## Supported NIPs
+
+This package includes helpers and models for various NIPs including:
+
+- NIP-10 (Threading)
+- NIP-22 (Comments)
+- NIP-53 (Streams)
+- NIP-23 (Articles)
+- NIP-52 (Calendar Events)
+- NIP-88 (Polls)
+- And many more...

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

@@ -0,0 +1,5 @@
+import { EventBlueprint } from "applesauce-core/event-factory";
+import { EncryptionMethod } from "applesauce-core/helpers/encrypted-content";
+import { MetaTagOptions } from "applesauce-core/operations/event";
+/** A blueprint for creating kind 30078 application data events */
+export declare function AppDataBlueprint<T>(identifier: string, data: T, encryption?: boolean | EncryptionMethod, options?: MetaTagOptions): EventBlueprint;

package/dist/blueprints/app-data.js

@@ -0,0 +1,10 @@
+import { blueprint } from "applesauce-core/event-factory";
+import { setMetaTags } from "applesauce-core/operations/event";
+import { APP_DATA_KIND } from "../helpers/app-data.js";
+import * as AppData from "../operations/app-data.js";
+/** A blueprint for creating kind 30078 application data events */
+export function AppDataBlueprint(identifier, data, encryption, options) {
+    return blueprint(APP_DATA_KIND, AppData.setIdentifier(identifier), 
+    // Set the content as either encrypted or plaintext
+    AppData.setContent(data, encryption), setMetaTags(options));
+}

package/dist/blueprints/calendar.d.ts

@@ -0,0 +1,5 @@
+import { EventBlueprint } from "applesauce-core/event-factory";
+import { NostrEvent } from "applesauce-core/helpers/event";
+import { AddressPointer } from "applesauce-core/helpers/pointers";
+/** Creates a calendar event with a title and optional events */
+export declare function CalendarBlueprint(title: string, events?: (NostrEvent | AddressPointer)[]): EventBlueprint;

package/dist/blueprints/calendar.js

@@ -0,0 +1,7 @@
+import { blueprint } from "applesauce-core/event-factory";
+import { kinds } from "applesauce-core/helpers/event";
+import { addEvent, setTitle } from "../operations/calendar.js";
+/** Creates a calendar event with a title and optional events */
+export function CalendarBlueprint(title, events) {
+    return blueprint(kinds.Calendar, setTitle(title), ...(events?.map((event) => addEvent(event)) ?? []));
+}

package/dist/blueprints/channels.d.ts

@@ -0,0 +1,6 @@
+import { NostrEvent } from "applesauce-core/helpers/event";
+import { TextContentOptions } from "applesauce-core/operations";
+/** Creates a NIP-28 channel message */
+export declare function ChannelMessageBlueprint(channel: NostrEvent, message: string, options?: TextContentOptions): import("applesauce-core/event-factory").EventBlueprint;
+/** Creates a NIP-28 channel message reply */
+export declare function ChannelMessageReplyBlueprint(parent: NostrEvent, message: string, options?: TextContentOptions): import("applesauce-core/event-factory").EventBlueprint;

package/dist/blueprints/channels.js

@@ -0,0 +1,13 @@
+import { blueprint } from "applesauce-core/event-factory";
+import { kinds } from "applesauce-core/helpers/event";
+import { setShortTextContent } from "applesauce-core/operations";
+import { includeChannelPointerTag } from "../operations/channel.js";
+import { includePubkeyNotificationTags, setThreadParent } from "../operations/note.js";
+/** Creates a NIP-28 channel message */
+export function ChannelMessageBlueprint(channel, message, options) {
+    return blueprint(kinds.ChannelMessage, includeChannelPointerTag(channel), setShortTextContent(message, options));
+}
+/** Creates a NIP-28 channel message reply */
+export function ChannelMessageReplyBlueprint(parent, message, options) {
+    return blueprint(kinds.ChannelMessage, setThreadParent(parent), includePubkeyNotificationTags(parent), setShortTextContent(message, options));
+}

package/dist/blueprints/comment.d.ts

@@ -0,0 +1,12 @@
+import { NostrEvent, EventTemplate } from "applesauce-core/helpers/event";
+import { TextContentOptions } from "applesauce-core/operations/content";
+import { MetaTagOptions } from "applesauce-core/operations/event";
+export type CommentBlueprintOptions = TextContentOptions & MetaTagOptions;
+/** A blueprint to create a NIP-22 comment event */
+export declare function CommentBlueprint(parent: NostrEvent, content: string, options?: CommentBlueprintOptions): import("applesauce-core/event-factory").EventBlueprint;
+declare module "applesauce-core/event-factory" {
+    interface EventFactory {
+        /** Create a NIP-22 comment event */
+        comment(parent: NostrEvent, content: string, options?: CommentBlueprintOptions): Promise<EventTemplate>;
+    }
+}

package/dist/blueprints/comment.js

@@ -0,0 +1,15 @@
+import { blueprint } from "applesauce-core/event-factory";
+import { setShortTextContent } from "applesauce-core/operations/content";
+import { setMetaTags } from "applesauce-core/operations/event";
+import { COMMENT_KIND } from "../helpers/comment.js";
+import { setParent } from "../operations/comment.js";
+// Import EventFactory as a value (class) to modify its prototype
+import { EventFactory } from "applesauce-core/event-factory";
+/** A blueprint to create a NIP-22 comment event */
+export function CommentBlueprint(parent, content, options) {
+    return blueprint(COMMENT_KIND, setParent(parent), setShortTextContent(content, options), setMetaTags(options));
+}
+// Register this blueprint with EventFactory
+EventFactory.prototype.comment = function (parent, content, options) {
+    return this.create(CommentBlueprint, parent, content, options);
+};

package/dist/blueprints/delete.d.ts

@@ -0,0 +1,9 @@
+import { EventTemplate, NostrEvent } from "applesauce-core/helpers/event";
+/** A blueprint for a NIP-09 delete event */
+export declare function DeleteBlueprint(events: NostrEvent[], reason?: string): import("applesauce-core/event-factory").EventBlueprint;
+declare module "applesauce-core/event-factory" {
+    interface EventFactory {
+        /** Create a NIP-09 delete event */
+        delete(events: NostrEvent[], reason?: string): Promise<EventTemplate>;
+    }
+}

package/dist/blueprints/delete.js

@@ -0,0 +1,14 @@
+import { blueprint } from "applesauce-core/event-factory";
+import { kinds } from "applesauce-core/helpers/event";
+import { setContent } from "applesauce-core/operations";
+import { setDeleteEvents } from "applesauce-core/operations/delete";
+// Import EventFactory as a value (class) to modify its prototype
+import { EventFactory } from "applesauce-core/event-factory";
+/** A blueprint for a NIP-09 delete event */
+export function DeleteBlueprint(events, reason) {
+    return blueprint(kinds.EventDeletion, reason ? setContent(reason) : undefined, setDeleteEvents(events));
+}
+// Register this blueprint with EventFactory
+EventFactory.prototype.delete = function (events, reason) {
+    return this.create(DeleteBlueprint, events, reason);
+};

package/dist/blueprints/file-metadata.d.ts

@@ -0,0 +1,8 @@
+import { TextContentOptions } from "applesauce-core/operations/content";
+import { MetaTagOptions } from "applesauce-core/operations/event";
+import { FileMetadata } from "../helpers/file-metadata.js";
+export type FileMetadataBlueprintOptions = TextContentOptions & MetaTagOptions & {
+    hashtags?: string[];
+};
+/** Blueprint to create a NIP-94 file metadata event */
+export declare function FileMetadataBlueprint(metadata: FileMetadata, description?: string, options?: FileMetadataBlueprintOptions): import("applesauce-core/event-factory").EventBlueprint;

package/dist/blueprints/file-metadata.js

@@ -0,0 +1,11 @@
+import { blueprint } from "applesauce-core/event-factory";
+import { kinds } from "applesauce-core/helpers/event";
+import { skip } from "applesauce-core/helpers/pipeline";
+import { setShortTextContent } from "applesauce-core/operations/content";
+import { setMetaTags } from "applesauce-core/operations/event";
+import { setFileMetadata } from "../operations/file-metadata.js";
+import { includeHashtags } from "../operations/hashtags.js";
+/** Blueprint to create a NIP-94 file metadata event */
+export function FileMetadataBlueprint(metadata, description, options) {
+    return blueprint(kinds.FileMetadata, setFileMetadata(metadata), description ? setShortTextContent(description, options) : skip(), options?.hashtags ? includeHashtags(options.hashtags) : skip(), setMetaTags(options));
+}

package/dist/blueprints/follow-set.d.ts

@@ -0,0 +1,11 @@
+import { EventBlueprint } from "applesauce-core/event-factory";
+import { ProfilePointer } from "applesauce-core/helpers/pointers";
+/** Creates a new kind 30000 follow set */
+export declare function FollowSetBlueprint(list?: {
+    title?: string;
+    description?: string;
+    image?: string;
+}, users?: {
+    public?: ProfilePointer[];
+    hidden?: ProfilePointer[];
+} | ProfilePointer[]): EventBlueprint;

package/dist/blueprints/follow-set.js

@@ -0,0 +1,21 @@
+import { blueprint } from "applesauce-core/event-factory";
+import { kinds } from "applesauce-core/helpers/event";
+import { addProfilePointerTag } from "applesauce-core/operations/tag/common";
+import { modifyHiddenTags, modifyPublicTags } from "applesauce-core/operations/tags";
+import { setDescription, setImage, setTitle } from "../operations/list.js";
+/** Creates a new kind 30000 follow set */
+export function FollowSetBlueprint(list, users) {
+    const userOperations = users
+        ? Array.isArray(users)
+            ? [modifyPublicTags(...users.map((p) => addProfilePointerTag(p)))]
+            : [
+                users?.public ? modifyPublicTags(...users.public.map((p) => addProfilePointerTag(p))) : undefined,
+                users?.hidden ? modifyHiddenTags(...users.hidden.map((p) => addProfilePointerTag(p))) : undefined,
+            ]
+        : [];
+    return blueprint(kinds.Followsets, 
+    // set list info tags
+    list?.title ? setTitle(list.title) : undefined, list?.description ? setDescription(list.description) : undefined, list?.image ? setImage(list.image) : undefined, 
+    // add users to the list
+    ...userOperations);
+}

package/dist/blueprints/gift-wrap.d.ts

@@ -0,0 +1,5 @@
+import { EventBlueprint } from "applesauce-core/event-factory";
+import { EventTemplate, NostrEvent, UnsignedEvent } from "applesauce-core/helpers/event";
+import { MetaTagOptions } from "applesauce-core/operations/event";
+/** Creates a gift wrapped event based on a blueprint */
+export declare function GiftWrapBlueprint(pubkey: string, blueprint: EventBlueprint | EventTemplate | UnsignedEvent | NostrEvent, opts?: MetaTagOptions): EventBlueprint<NostrEvent>;

package/dist/blueprints/gift-wrap.js

@@ -0,0 +1,6 @@
+import { buildEvent } from "applesauce-core/event-factory";
+import { giftWrap } from "../operations/gift-wrap.js";
+/** Creates a gift wrapped event based on a blueprint */
+export function GiftWrapBlueprint(pubkey, blueprint, opts) {
+    return async (ctx) => (await buildEvent(typeof blueprint === "function" ? await blueprint(ctx) : blueprint, ctx, giftWrap(pubkey, opts)));
+}

package/dist/blueprints/group.d.ts

@@ -0,0 +1,9 @@
+import { NostrEvent } from "applesauce-core/helpers/event";
+import { TextContentOptions } from "applesauce-core/operations/content";
+import { MetaTagOptions } from "applesauce-core/operations/event";
+import { GroupPointer } from "../helpers/groups.js";
+export type GroupMessageBlueprintOptions = {
+    previous: NostrEvent[];
+} & TextContentOptions & MetaTagOptions;
+/** A blueprint for a NIP-29 group message */
+export declare function GroupMessageBlueprint(group: GroupPointer, content: string, options?: GroupMessageBlueprintOptions): import("applesauce-core/event-factory").EventBlueprint;

package/dist/blueprints/group.js

@@ -0,0 +1,17 @@
+import { blueprint } from "applesauce-core/event-factory";
+import { setShortTextContent } from "applesauce-core/operations/content";
+import { setMetaTags } from "applesauce-core/operations/event";
+import { GROUP_MESSAGE_KIND } from "../helpers/groups.js";
+import { addPreviousRefs, setGroupPointer } from "../operations/group.js";
+/** A blueprint for a NIP-29 group message */
+export function GroupMessageBlueprint(group, content, options) {
+    return blueprint(GROUP_MESSAGE_KIND, 
+    // include group id "h" tag
+    setGroupPointer(group), 
+    // include "previous" events tags
+    options?.previous && addPreviousRefs(options.previous), 
+    // Set text content
+    setShortTextContent(content, options), 
+    // Add common meta tags
+    setMetaTags(options));
+}

package/dist/blueprints/highlight.d.ts

@@ -0,0 +1,20 @@
+import { NostrEvent } from "applesauce-core/helpers/event";
+import { AddressPointer } from "applesauce-core/helpers/pointers";
+import { MetaTagOptions } from "applesauce-core/operations/event";
+import { HighlightAttribution } from "../helpers/index.js";
+import { ZapOptions } from "../operations/zap-split.js";
+export type HighlightBlueprintOptions = MetaTagOptions & ZapOptions & {
+    /** Additional context surrounding the highlight */
+    context?: string;
+    /** Comment to create a quote highlight */
+    comment?: string;
+    /** Attribution information for the original content */
+    attributions?: HighlightAttribution[];
+    /** Alt description for clients that can't render the event */
+    alt?: string;
+};
+/**
+ * NIP-84 Highlight event (kind 9802) blueprint
+ * Creates a highlight event that references content from nostr events or external URLs
+ */
+export declare function HighlightBlueprint(content: string, source: NostrEvent | AddressPointer | string, options?: HighlightBlueprintOptions): import("applesauce-core/event-factory").EventBlueprint;

package/dist/blueprints/highlight.js

@@ -0,0 +1,12 @@
+import { blueprint } from "applesauce-core/event-factory";
+import { kinds } from "applesauce-core/helpers/event";
+import { includeAltTag, setMetaTags } from "applesauce-core/operations/event";
+import { setAttributions, setComment, setContext, setHighlightContent, setSource } from "../operations/highlight.js";
+import { setZapSplit } from "../operations/zap-split.js";
+/**
+ * NIP-84 Highlight event (kind 9802) blueprint
+ * Creates a highlight event that references content from nostr events or external URLs
+ */
+export function HighlightBlueprint(content, source, options) {
+    return blueprint(kinds.Highlights, setHighlightContent(content), setSource(source), options?.attributions ? setAttributions(options.attributions) : undefined, options?.context ? setContext(options.context) : undefined, options?.comment ? setComment(options.comment) : undefined, setZapSplit(options), setMetaTags(options), includeAltTag(options?.alt ?? "A text highlight"));
+}

package/dist/blueprints/index.d.ts

@@ -0,0 +1,23 @@
+export * from "./app-data.js";
+export * from "./calendar.js";
+export * from "./channels.js";
+export * from "./comment.js";
+export * from "./delete.js";
+export * from "./file-metadata.js";
+export * from "./follow-set.js";
+export * from "./gift-wrap.js";
+export * from "./group.js";
+export * from "./delete.js";
+export * from "./highlight.js";
+export * from "./legacy-message.js";
+export * from "./live-stream.js";
+export * from "./note.js";
+export * from "./picture-post.js";
+export * from "./poll.js";
+export * from "./profile.js";
+export * from "./reaction.js";
+export * from "./share.js";
+export * from "./stream.js";
+export * from "./torrent.js";
+export * from "./wrapped-message.js";
+import "../register.js";

package/dist/blueprints/index.js

@@ -0,0 +1,24 @@
+export * from "./app-data.js";
+export * from "./calendar.js";
+export * from "./channels.js";
+export * from "./comment.js";
+export * from "./delete.js";
+export * from "./file-metadata.js";
+export * from "./follow-set.js";
+export * from "./gift-wrap.js";
+export * from "./group.js";
+export * from "./delete.js";
+export * from "./highlight.js";
+export * from "./legacy-message.js";
+export * from "./live-stream.js";
+export * from "./note.js";
+export * from "./picture-post.js";
+export * from "./poll.js";
+export * from "./profile.js";
+export * from "./reaction.js";
+export * from "./share.js";
+export * from "./stream.js";
+export * from "./torrent.js";
+export * from "./wrapped-message.js";
+// Register the common blueprints with the event factory
+import "../register.js";

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

@@ -0,0 +1,7 @@
+import { NostrEvent } from "applesauce-core/helpers/event";
+import { MetaTagOptions } from "applesauce-core/operations/event";
+export type LegacyMessageBlueprintOptions = MetaTagOptions;
+/** A blueprint to create a nip-04 encrypted direct message */
+export declare function LegacyMessageBlueprint(recipient: string, message: string, opts?: LegacyMessageBlueprintOptions): import("applesauce-core/event-factory").EventBlueprint;
+/** Creates a reply to a legacy message */
+export declare function LegacyMessageReplyBlueprint(parent: NostrEvent, message: string, opts?: LegacyMessageBlueprintOptions): import("applesauce-core/event-factory").EventBlueprint;

package/dist/blueprints/legacy-message.js

@@ -0,0 +1,29 @@
+import { blueprint } from "applesauce-core/event-factory";
+import { kinds } from "applesauce-core/helpers/event";
+import { setEncryptedContent } from "applesauce-core/operations/encrypted-content";
+import { setMetaTags } from "applesauce-core/operations/event";
+import { setMessageAddress, setMessageParent } from "../operations/legacy-message.js";
+/** A blueprint to create a nip-04 encrypted direct message */
+export function LegacyMessageBlueprint(recipient, message, opts) {
+    return blueprint(kinds.EncryptedDirectMessage, 
+    // Encrypt the contents of the message to the recipient
+    setEncryptedContent(recipient, message), 
+    // Include the necessary "p" tag of the recipient
+    setMessageAddress(recipient), 
+    // Include the meta tags
+    setMetaTags(opts));
+}
+/** Creates a reply to a legacy message */
+export function LegacyMessageReplyBlueprint(parent, message, opts) {
+    if (parent.kind !== kinds.EncryptedDirectMessage)
+        throw new Error("Parent message must be a legacy message (kind 4)");
+    return blueprint(kinds.EncryptedDirectMessage, 
+    // Encrypt the contents of the message to the recipient
+    setEncryptedContent(parent.pubkey, message), 
+    // Include the necessary "p" tag of the recipient
+    setMessageAddress(parent.pubkey), 
+    // Include the parent message id
+    setMessageParent(parent), 
+    // Include the meta tags
+    setMetaTags(opts));
+}

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

@@ -0,0 +1,6 @@
+import { NostrEvent } from "applesauce-core/helpers/event";
+import { TextContentOptions } from "applesauce-core/operations/content";
+import { MetaTagOptions } from "applesauce-core/operations/event";
+export type LiveChatMessageBlueprintOptions = TextContentOptions & MetaTagOptions;
+/** A blueprint for creating a live stream message */
+export declare function LiveChatMessageBlueprint(stream: NostrEvent, message: string, options?: LiveChatMessageBlueprintOptions): import("applesauce-core/event-factory").EventBlueprint;

package/dist/blueprints/live-stream.js

@@ -0,0 +1,9 @@
+import { blueprint } from "applesauce-core/event-factory";
+import { kinds } from "applesauce-core/helpers/event";
+import { setShortTextContent } from "applesauce-core/operations/content";
+import { setMetaTags } from "applesauce-core/operations/event";
+import { includeLiveStreamTag } from "../operations/live-stream.js";
+/** A blueprint for creating a live stream message */
+export function LiveChatMessageBlueprint(stream, message, options) {
+    return blueprint(kinds.LiveChatMessage, includeLiveStreamTag(stream), setShortTextContent(message, options), setMetaTags(options));
+}

package/dist/blueprints/note.d.ts

@@ -0,0 +1,16 @@
+import { EventTemplate, NostrEvent } from "applesauce-core/helpers/event";
+import { MetaTagOptions, TextContentOptions } from "applesauce-core/operations";
+import { ZapOptions } from "../operations/zap-split.js";
+export type NoteBlueprintOptions = TextContentOptions & MetaTagOptions & ZapOptions;
+/** Short text note (kind 1) blueprint */
+export declare function NoteBlueprint(content: string, options?: NoteBlueprintOptions): import("applesauce-core/event-factory").EventBlueprint;
+/** Short text note reply (kind 1) blueprint */
+export declare function NoteReplyBlueprint(parent: NostrEvent, content: string, options?: TextContentOptions): import("applesauce-core/event-factory").EventBlueprint;
+declare module "applesauce-core/event-factory" {
+    interface EventFactory {
+        /** Create a short text note (kind 1) */
+        note(content: string, options?: NoteBlueprintOptions): Promise<EventTemplate>;
+        /** Create a short text note reply (kind 1) */
+        noteReply(parent: NostrEvent, content: string, options?: TextContentOptions): Promise<EventTemplate>;
+    }
+}

package/dist/blueprints/note.js

@@ -0,0 +1,30 @@
+import { blueprint } from "applesauce-core/event-factory";
+import { kinds } from "applesauce-core/helpers/event";
+import { setMetaTags, setShortTextContent } from "applesauce-core/operations";
+import { setZapSplit } from "../operations/zap-split.js";
+import { includePubkeyNotificationTags, setThreadParent } from "../operations/note.js";
+// Import EventFactory as a value (class) to modify its prototype
+import { EventFactory } from "applesauce-core/event-factory";
+/** Short text note (kind 1) blueprint */
+export function NoteBlueprint(content, options) {
+    return blueprint(kinds.ShortTextNote, setShortTextContent(content, options), setZapSplit(options), setMetaTags(options));
+}
+/** Short text note reply (kind 1) blueprint */
+export function NoteReplyBlueprint(parent, content, options) {
+    if (parent.kind !== kinds.ShortTextNote)
+        throw new Error("Kind 1 replies should only be used to reply to kind 1 notes");
+    return blueprint(kinds.ShortTextNote, 
+    // add NIP-10 tags
+    setThreadParent(parent), 
+    // copy "p" tags from parent
+    includePubkeyNotificationTags(parent), 
+    // set default text content
+    setShortTextContent(content, options));
+}
+// Register these blueprints with EventFactory
+EventFactory.prototype.note = function (content, options) {
+    return this.create(NoteBlueprint, content, options);
+};
+EventFactory.prototype.noteReply = function (parent, content, options) {
+    return this.create(NoteReplyBlueprint, parent, content, options);
+};

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

@@ -0,0 +1,12 @@
+import { TextContentOptions } from "applesauce-core/operations/content";
+import { MetaTagOptions } from "applesauce-core/operations/event";
+import { MediaAttachment } from "../helpers/index.js";
+export type PicturePostBlueprintOptions = TextContentOptions & MetaTagOptions & {
+    hashtags?: string[];
+};
+/**
+ * A blueprint to create a kind 20 picture post
+ * @see https://github.com/nostr-protocol/nips/blob/master/68.md
+ * @throws {Error} if the pictures are not image/* types
+ */
+export declare function PicturePostBlueprint(pictures: MediaAttachment[], content: string, options?: PicturePostBlueprintOptions): import("applesauce-core/event-factory").EventBlueprint;

package/dist/blueprints/picture-post.js

@@ -0,0 +1,17 @@
+import { blueprint } from "applesauce-core/event-factory";
+import { setShortTextContent } from "applesauce-core/operations/content";
+import { setMetaTags } from "applesauce-core/operations/event";
+import { PICTURE_POST_KIND } from "../helpers/index.js";
+import { includeHashtags } from "../operations/hashtags.js";
+import { addMediaAttachments } from "../operations/media-attachment.js";
+import { setImageMetadata } from "../operations/picture-post.js";
+/**
+ * A blueprint to create a kind 20 picture post
+ * @see https://github.com/nostr-protocol/nips/blob/master/68.md
+ * @throws {Error} if the pictures are not image/* types
+ */
+export function PicturePostBlueprint(pictures, content, options) {
+    if (pictures.some((m) => !m.type?.includes("image/")))
+        throw new Error("Only image/* types can be added to a picture post");
+    return blueprint(PICTURE_POST_KIND, addMediaAttachments(pictures), setImageMetadata(pictures), setShortTextContent(content, options), setMetaTags(options), options?.hashtags ? includeHashtags(options.hashtags) : undefined);
+}

package/dist/blueprints/poll.d.ts

@@ -0,0 +1,41 @@
+import { EventTemplate, NostrEvent } from "applesauce-core/helpers/event";
+import { EventPointer } from "applesauce-core/helpers/pointers";
+import { MetaTagOptions } from "applesauce-core/operations";
+import { PollType } from "../helpers/poll.js";
+import { ZapOptions } from "../operations/zap-split.js";
+export interface PollOption {
+    id: string;
+    label: string;
+}
+export type PollBlueprintOptions = MetaTagOptions & ZapOptions & {
+    /** Poll type - singlechoice or multiplechoice. Defaults to singlechoice */
+    pollType?: PollType;
+    /** Unix timestamp when the poll ends */
+    endsAt?: number;
+    /** Relay URLs where responses should be published */
+    relays?: string[];
+};
+/**
+ * NIP-88 Poll event (kind 1068) blueprint
+ * Creates a poll event with question and options
+ */
+export declare function PollBlueprint(question: string, options: PollOption[], opts?: PollBlueprintOptions): import("applesauce-core").EventBlueprint;
+export type PollResponseBlueprintOptions = MetaTagOptions & {
+    comment?: string;
+};
+/**
+ * NIP-88 Poll Response event (kind 1018) blueprint
+ * Creates a response to a poll event
+ */
+export declare function PollResponseBlueprint(poll: NostrEvent | EventPointer | string, optionIds: string[], opts?: PollResponseBlueprintOptions): import("applesauce-core").EventBlueprint;
+/**
+ * Convenience blueprint for single-choice poll responses
+ * Creates a response to a poll event with a single option
+ */
+export declare function SingleChoicePollResponseBlueprint(poll: NostrEvent | EventPointer | string, optionId: string, opts?: PollResponseBlueprintOptions): import("applesauce-core").EventBlueprint;
+declare module "applesauce-core/event-factory" {
+    interface EventFactory {
+        /** Create a NIP-88 poll event */
+        poll(question: string, options: PollOption[], opts?: PollBlueprintOptions): Promise<EventTemplate>;
+    }
+}

package/dist/blueprints/poll.js

@@ -0,0 +1,33 @@
+import { blueprint } from "applesauce-core";
+import { setContent, setMetaTags } from "applesauce-core/operations";
+import { POLL_KIND, POLL_RESPONSE_KIND } from "../helpers/poll.js";
+import * as PollResponse from "../operations/poll-response.js";
+import * as Poll from "../operations/poll.js";
+import { setZapSplit } from "../operations/zap-split.js";
+// Import EventFactory as a value (class) to modify its prototype
+import { EventFactory } from "applesauce-core/event-factory";
+/**
+ * NIP-88 Poll event (kind 1068) blueprint
+ * Creates a poll event with question and options
+ */
+export function PollBlueprint(question, options, opts) {
+    return blueprint(POLL_KIND, Poll.setQuestion(question), Poll.setOptions(options), opts?.pollType ? Poll.setType(opts.pollType) : undefined, opts?.endsAt ? Poll.setEndsAt(opts.endsAt) : undefined, opts?.relays ? Poll.setRelays(opts.relays) : undefined, setZapSplit(opts), setMetaTags({ ...opts, alt: opts?.alt ?? `Poll: ${question}` }));
+}
+/**
+ * NIP-88 Poll Response event (kind 1018) blueprint
+ * Creates a response to a poll event
+ */
+export function PollResponseBlueprint(poll, optionIds, opts) {
+    return blueprint(POLL_RESPONSE_KIND, PollResponse.setPollEvent(poll), PollResponse.setChoices(optionIds), opts?.comment ? setContent(opts.comment) : undefined, setMetaTags({ ...opts, alt: opts?.alt ?? "Poll response" }));
+}
+/**
+ * Convenience blueprint for single-choice poll responses
+ * Creates a response to a poll event with a single option
+ */
+export function SingleChoicePollResponseBlueprint(poll, optionId, opts) {
+    return blueprint(POLL_RESPONSE_KIND, PollResponse.setPollEvent(poll), PollResponse.setChoice(optionId), opts?.comment ? setContent(opts.comment) : undefined, setMetaTags({ ...opts, alt: opts?.alt ?? "Poll response" }));
+}
+// Register this blueprint with EventFactory
+EventFactory.prototype.poll = function (question, options, opts) {
+    return this.create(PollBlueprint, question, options, opts);
+};

package/dist/blueprints/profile.d.ts

@@ -0,0 +1,3 @@
+import { ProfileContent } from "applesauce-core/helpers/profile";
+/** User Profile (kind 0) blueprint */
+export declare function ProfileBlueprint(content: ProfileContent): import("applesauce-core/event-factory").EventBlueprint;

package/dist/blueprints/profile.js

@@ -0,0 +1,7 @@
+import { blueprint } from "applesauce-core/event-factory";
+import { kinds } from "applesauce-core/helpers/event";
+import { setProfile } from "applesauce-core/operations/profile";
+/** User Profile (kind 0) blueprint */
+export function ProfileBlueprint(content) {
+    return blueprint(kinds.Metadata, setProfile(content));
+}

package/dist/blueprints/reaction.d.ts

@@ -0,0 +1,10 @@
+import { Emoji } from "applesauce-core/event-factory";
+import { EventTemplate, NostrEvent } from "applesauce-core/helpers/event";
+/** blueprint for kind 7 reaction event */
+export declare function ReactionBlueprint(event: NostrEvent, emoji?: string | Emoji): import("applesauce-core/event-factory").EventBlueprint;
+declare module "applesauce-core/event-factory" {
+    interface EventFactory {
+        /** Create a kind 7 reaction event */
+        reaction(event: NostrEvent, emoji?: string | Emoji): Promise<EventTemplate>;
+    }
+}