Factory

Applesauce has a two-layer factory system.

• applesauce-core provides the low-level EventFactory class and the shared operations used to build drafts, modify tags, stamp events, and sign them.
• applesauce-common provides typed factory classes for common Nostr event types like notes, comments, profiles, lists, gift wraps, and direct messages.

What It Is

Use the core layer when you need a generic builder:

import { EventFactory } from "applesauce-core";

const event = await EventFactory.fromKind(1).content("Hello").sign(signer);

Use the common layer when you want an event-specific API:

import { NoteFactory } from "applesauce-common/factories";

const note = await NoteFactory.create("Hello #world").sign(signer);

How To Use It

Pick the layer that matches your job:

• Event Factory covers the low-level builder in applesauce-core
• Common Factories covers typed factories in applesauce-common/factories
• Extending Factories shows how to build your own subclasses
• Event Operations covers reusable event transforms
• Tag Operations covers public and hidden tag transforms

Integration

Factories fit into the rest of Applesauce in a few predictable places:

• Actions create and sign events with typed factories, then publish them
• Account managers supply the signer used by .sign() or .as(signer)
• Event operations and tag operations stay reusable across both core and common factories

import { CommentFactory } from "applesauce-common/factories";

const comment = await CommentFactory.create(parent, "Nice post").sign(signer);

Best Practices

• Reach for applesauce-common/factories first when a typed factory already exists
• Use EventFactory directly for custom kinds or shared low-level flows
• Keep reusable logic in operations, not inline event mutation
• Use .stamp() when you need an unsigned event with a pubkey

Installation

Install applesauce-core for the base builder:

npm

npm install applesauce-core

yarn

yarn add applesauce-core

pnpm

pnpm add applesauce-core

Install applesauce-common when you want the typed factory layer:

npm

npm install applesauce-common

yarn

yarn add applesauce-common

pnpm

pnpm add applesauce-common