@welshman/domain 0.9.0-pre1 → 0.9.0-pre2

package/dist/domain/src/behaviors/Emoji.d.ts

@@ -0,0 +1,18 @@
+import type { TrustedEvent } from "@welshman/util";
+/**
+ * A NIP-30 custom emoji, parsed from an `["emoji", <shortcode>, <url>, <address>]`
+ * tag. `address` is an optional `kind:pubkey:d-tag` pointer to the kind-30030
+ * emoji set (NIP-51) the emoji belongs to.
+ */
+export type Emoji = {
+    shortcode: string;
+    url: string;
+    address?: string;
+};
+/**
+ * Parse an event's NIP-30 `emoji` tags. Tags missing a shortcode or url are
+ * skipped. A plain function so it can read emojis off any event, regardless of
+ * kind, without a kind-specific reader.
+ */
+export declare const getEmojis: (event: TrustedEvent) => Emoji[];
+//# sourceMappingURL=Emoji.d.ts.map

package/dist/domain/src/behaviors/Emoji.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Emoji.d.ts","sourceRoot":"","sources":["../../../../src/behaviors/Emoji.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAA;AAEhD;;;;GAIG;AACH,MAAM,MAAM,KAAK,GAAG;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,YAAY,KAAG,KAAK,EAGiB,CAAA"}

package/dist/domain/src/behaviors/Emoji.js

@@ -0,0 +1,9 @@
+/**
+ * Parse an event's NIP-30 `emoji` tags. Tags missing a shortcode or url are
+ * skipped. A plain function so it can read emojis off any event, regardless of
+ * kind, without a kind-specific reader.
+ */
+export const getEmojis = (event) => event.tags
+    .filter(tag => tag[0] === "emoji" && tag[1] && tag[2])
+    .map(([, shortcode, url, address]) => ({ shortcode, url, address }));
+//# sourceMappingURL=Emoji.js.map

package/dist/domain/src/behaviors/Emoji.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Emoji.js","sourceRoot":"","sources":["../../../../src/behaviors/Emoji.ts"],"names":[],"mappings":"AAaA;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAmB,EAAW,EAAE,CACxD,KAAK,CAAC,IAAI;KACP,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,OAAO,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;KACrD,GAAG,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,EAAC,SAAS,EAAE,GAAG,EAAE,OAAO,EAAC,CAAC,CAAC,CAAA"}

package/dist/domain/src/behaviors/ZapSplits.d.ts

@@ -0,0 +1,36 @@
+import type { TrustedEvent } from "@welshman/util";
+/**
+ * A single recipient of an event's zaps, parsed from a NIP-57 Appendix G `zap`
+ * tag of the form `["zap", <pubkey>, <relay hint>, <weight>]`.
+ */
+export type ZapSplit = {
+    pubkey: string;
+    relay?: string;
+    weight: number;
+};
+export type ZapSplitAmount = ZapSplit & {
+    amount: number;
+};
+/**
+ * Resolve an event's zap-split recipients per NIP-57 Appendix G:
+ *
+ * - With no `zap` tags the whole zap goes to the event's author.
+ * - If no recipient carries a weight, the zap is split equally (weight 1 each).
+ * - If weights are only partially present, unweighted recipients drop to weight
+ *   0 (i.e. they should not be zapped).
+ *
+ * Weight-0 recipients are still returned so callers have the full recipient set;
+ * they simply receive 0 from `splitZapAmount`.
+ *
+ * A plain function so it can read splits off any event, regardless of kind,
+ * without a kind-specific reader.
+ */
+export declare const getZapSplits: (event: TrustedEvent) => ZapSplit[];
+/**
+ * Divide `total` (in any integer unit, e.g. millisats) across an event's
+ * zap-split recipients proportionally to their weights. Any rounding remainder
+ * is handed to the highest-weighted recipient so the parts sum back to exactly
+ * `total`. If every weight is 0, nobody is zapped.
+ */
+export declare const splitZapAmount: (event: TrustedEvent, total: number) => ZapSplitAmount[];
+//# sourceMappingURL=ZapSplits.d.ts.map

package/dist/domain/src/behaviors/ZapSplits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ZapSplits.d.ts","sourceRoot":"","sources":["../../../../src/behaviors/ZapSplits.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAA;AAEhD;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC,CAAA;AAQxD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,YAAY,KAAG,QAAQ,EAc1D,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,YAAY,EAAE,OAAO,MAAM,KAAG,cAAc,EAoBjF,CAAA"}

package/dist/domain/src/behaviors/ZapSplits.js

@@ -0,0 +1,54 @@
+import { sum, allPass, nthEq, nth } from "@welshman/lib";
+const parseWeight = (weight) => {
+    const n = weight === undefined ? NaN : parseFloat(weight);
+    return Number.isFinite(n) && n > 0 ? n : 0;
+};
+/**
+ * Resolve an event's zap-split recipients per NIP-57 Appendix G:
+ *
+ * - With no `zap` tags the whole zap goes to the event's author.
+ * - If no recipient carries a weight, the zap is split equally (weight 1 each).
+ * - If weights are only partially present, unweighted recipients drop to weight
+ *   0 (i.e. they should not be zapped).
+ *
+ * Weight-0 recipients are still returned so callers have the full recipient set;
+ * they simply receive 0 from `splitZapAmount`.
+ *
+ * A plain function so it can read splits off any event, regardless of kind,
+ * without a kind-specific reader.
+ */
+export const getZapSplits = (event) => {
+    const zapTags = event.tags.filter(allPass(nthEq(0, "zap"), nth(1)));
+    if (zapTags.length === 0) {
+        return [{ pubkey: event.pubkey, weight: 1 }];
+    }
+    const anyWeighted = zapTags.some(nth(3));
+    return zapTags.map(([, pubkey, relay, weight]) => ({
+        pubkey,
+        relay: relay || undefined,
+        weight: anyWeighted ? parseWeight(weight) : 1,
+    }));
+};
+/**
+ * Divide `total` (in any integer unit, e.g. millisats) across an event's
+ * zap-split recipients proportionally to their weights. Any rounding remainder
+ * is handed to the highest-weighted recipient so the parts sum back to exactly
+ * `total`. If every weight is 0, nobody is zapped.
+ */
+export const splitZapAmount = (event, total) => {
+    const splits = getZapSplits(event);
+    const totalWeight = sum(splits.map(split => split.weight));
+    if (totalWeight === 0) {
+        return splits.map(split => ({ ...split, amount: 0 }));
+    }
+    const amounts = splits.map(split => Math.floor((total * split.weight) / totalWeight));
+    let maxIndex = 0;
+    splits.forEach((split, i) => {
+        if (split.weight > splits[maxIndex].weight) {
+            maxIndex = i;
+        }
+    });
+    amounts[maxIndex] += total - sum(amounts);
+    return splits.map((split, i) => ({ ...split, amount: amounts[i] }));
+};
+//# sourceMappingURL=ZapSplits.js.map

package/dist/domain/src/behaviors/ZapSplits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ZapSplits.js","sourceRoot":"","sources":["../../../../src/behaviors/ZapSplits.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAC,MAAM,eAAe,CAAA;AAetD,MAAM,WAAW,GAAG,CAAC,MAA0B,EAAE,EAAE;IACjD,MAAM,CAAC,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAA;IAEzD,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAC5C,CAAC,CAAA;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAmB,EAAc,EAAE;IAC9D,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAEnE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,EAAC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAC,CAAC,CAAA;IAC5C,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IAExC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QACjD,MAAM;QACN,KAAK,EAAE,KAAK,IAAI,SAAS;QACzB,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;KAC9C,CAAC,CAAC,CAAA;AACL,CAAC,CAAA;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAmB,EAAE,KAAa,EAAoB,EAAE;IACrF,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAA;IAClC,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;IAE1D,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAC,GAAG,KAAK,EAAE,MAAM,EAAE,CAAC,EAAC,CAAC,CAAC,CAAA;IACrD,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAA;IAErF,IAAI,QAAQ,GAAG,CAAC,CAAA;IAChB,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QAC1B,IAAI,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC;YAC3C,QAAQ,GAAG,CAAC,CAAA;QACd,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,OAAO,CAAC,QAAQ,CAAC,IAAI,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,CAAA;IAEzC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAC,GAAG,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAAC,CAAC,CAAC,CAAA;AACnE,CAAC,CAAA"}

package/dist/domain/src/core/EventReader.d.ts

@@ -0,0 +1,24 @@
+import type { TrustedEvent } from "@welshman/util";
+import type { KindContext } from "./Kind.js";
+import type { Emoji } from "../behaviors/Emoji.js";
+import type { ZapSplit } from "../behaviors/ZapSplits.js";
+export declare abstract class EventReader {
+    readonly kind: number;
+    readonly context: KindContext;
+    readonly event: TrustedEvent;
+    constructor(kind: number, context: KindContext, event: TrustedEvent);
+    parse(): Promise<void>;
+    id(): string;
+    author(): string;
+    content(): string;
+    tags(): string[][];
+    createdAt(): number;
+    identifier(): string | undefined;
+    address(): string;
+    group(): string | undefined;
+    protect(): boolean;
+    expiration(): number | undefined;
+    emojis(): Emoji[];
+    zapSplits(): ZapSplit[];
+}
+//# sourceMappingURL=EventReader.d.ts.map

package/dist/domain/src/core/EventReader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventReader.d.ts","sourceRoot":"","sources":["../../../../src/core/EventReader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAA;AAChD,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,WAAW,CAAA;AAE1C,OAAO,KAAK,EAAC,KAAK,EAAC,MAAM,uBAAuB,CAAA;AAEhD,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,2BAA2B,CAAA;AAEvD,8BAAsB,WAAW;IAE7B,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,OAAO,EAAE,WAAW;IAC7B,QAAQ,CAAC,KAAK,EAAE,YAAY;gBAFnB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,YAAY;IAOxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAE5B,EAAE;IAIF,MAAM;IAIN,OAAO;IAIP,IAAI;IAIJ,SAAS;IAIT,UAAU;IAIV,OAAO;IAIP,KAAK;IAIL,OAAO;IAIP,UAAU;IAIV,MAAM,IAAI,KAAK,EAAE;IAIjB,SAAS,IAAI,QAAQ,EAAE;CAGxB"}

package/dist/domain/src/core/EventReader.js

@@ -0,0 +1,55 @@
+import { spec, toInt } from "@welshman/lib";
+import { tagSpec, tagValue, getAddress } from "@welshman/util";
+import { getEmojis } from "../behaviors/Emoji.js";
+import { getZapSplits } from "../behaviors/ZapSplits.js";
+export class EventReader {
+    kind;
+    context;
+    event;
+    constructor(kind, context, event) {
+        this.kind = kind;
+        this.context = context;
+        this.event = event;
+        if (event.kind !== kind) {
+            throw new Error(`Expected a kind ${kind} event, got kind ${event.kind}`);
+        }
+    }
+    async parse() { }
+    id() {
+        return this.event.id;
+    }
+    author() {
+        return this.event.pubkey;
+    }
+    content() {
+        return this.event.content;
+    }
+    tags() {
+        return this.event.tags;
+    }
+    createdAt() {
+        return this.event.created_at;
+    }
+    identifier() {
+        return tagValue(tagSpec("d"), this.event.tags);
+    }
+    address() {
+        return getAddress(this.event);
+    }
+    group() {
+        return tagValue(tagSpec("h"), this.event.tags);
+    }
+    protect() {
+        return this.event.tags.some(spec(["-"]));
+    }
+    expiration() {
+        return toInt(tagValue(tagSpec("expiration"), this.event.tags) ?? "");
+    }
+    emojis() {
+        return getEmojis(this.event);
+    }
+    zapSplits() {
+        return getZapSplits(this.event);
+    }
+}
+//# sourceMappingURL=EventReader.js.map

package/dist/domain/src/core/EventReader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventReader.js","sourceRoot":"","sources":["../../../../src/core/EventReader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAE,KAAK,EAAC,MAAM,eAAe,CAAA;AACzC,OAAO,EAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAC,MAAM,gBAAgB,CAAA;AAG5D,OAAO,EAAC,SAAS,EAAC,MAAM,uBAAuB,CAAA;AAE/C,OAAO,EAAC,YAAY,EAAC,MAAM,2BAA2B,CAAA;AAGtD,MAAM,OAAgB,WAAW;IAEpB;IACA;IACA;IAHX,YACW,IAAY,EACZ,OAAoB,EACpB,KAAmB;QAFnB,SAAI,GAAJ,IAAI,CAAQ;QACZ,YAAO,GAAP,OAAO,CAAa;QACpB,UAAK,GAAL,KAAK,CAAc;QAE5B,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,oBAAoB,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;QAC1E,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK,KAAmB,CAAC;IAE/B,EAAE;QACA,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAA;IACtB,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAA;IAC1B,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAA;IAC3B,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAA;IACxB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAA;IAC9B,CAAC;IAED,UAAU;QACR,OAAO,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAChD,CAAC;IAED,OAAO;QACL,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC/B,CAAC;IAED,KAAK;QACH,OAAO,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAChD,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IAC1C,CAAC;IAED,UAAU;QACR,OAAO,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;IACtE,CAAC;IAED,MAAM;QACJ,OAAO,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC9B,CAAC;IAED,SAAS;QACP,OAAO,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACjC,CAAC;CACF"}

package/dist/domain/src/core/EventWriter.d.ts

@@ -0,0 +1,99 @@
+import type { MaybeAsync } from "@welshman/lib";
+import type { EventTemplate, TrustedEvent, RelaySelection, RelayScenario } from "@welshman/util";
+import type { EventReader } from "./EventReader.js";
+import type { KindContext } from "./Kind.js";
+export declare class TagParser {
+    tags: string[][];
+    constructor(tags: string[][]);
+    consume(key: string): string[][];
+}
+export declare abstract class EventWriter<Reader extends EventReader> {
+    readonly kind: number;
+    readonly context: KindContext;
+    readonly reader?: Reader | undefined;
+    content: string;
+    groupTag?: string[];
+    protectTag?: string[];
+    expirationTag?: string[];
+    identifierTag?: string[];
+    extraTags: string[][];
+    forcedRelays?: string[];
+    pendingResolves: Promise<unknown>[];
+    readonly requiresRelays: boolean;
+    constructor(kind: number, context: KindContext, reader?: Reader | undefined);
+    setContent(content: string): this;
+    setGroup(url: string, group: string): this;
+    clearGroup(): this;
+    forceRelays(...urls: string[]): this;
+    clearForcedRelays(): this;
+    setProtected(protect: boolean): this;
+    setExpiration(expiration: number): this;
+    clearExpiration(): this;
+    setIdentifier(identifier?: string): this;
+    clearIdentifier(): this;
+    addTags(...tags: string[][]): this;
+    keepTags(pred: (tag: string[]) => boolean): this;
+    dropTags(pred: (tag: string[]) => boolean): this;
+    addMention(pubkey: string): this;
+    addQuote(event: TrustedEvent): this;
+    addZapSplit(pubkey: string, split?: number): this;
+    removeZapSplit(pubkey: string): this;
+    addEmoji(shortcode: string, url: string, address?: string): this;
+    removeEmoji(shortcode: string): this;
+    /**
+     * Validates a domain object, throwing an error if invalid.
+     */
+    validate(): void;
+    /**
+     * Tracks a promise that must resolve before the event is rendered.
+     */
+    private trackPending;
+    /**
+     * Resolves one or more relay selections to a single hint url, tracking the
+     * in-flight promise so `renderTags` can wait for it. Callers backfill the
+     * resolved url into a tag's hint slot.
+     */
+    protected hint(...routes: RelaySelection[]): Promise<string>;
+    /**
+     * Returns a list of tags that may be attached to any kind.
+     */
+    protected renderBehaviorTags(): MaybeAsync<string[][]>;
+    /**
+     * Returns a list of tags related to the kind.
+     */
+    protected renderDomainTags(): MaybeAsync<string[][]>;
+    /**
+     * Returns the complete tag list for publishing.
+     */
+    renderTags(): Promise<string[][]>;
+    /**
+     * Returns the content string as defined by the kind.
+     */
+    renderContent(): MaybeAsync<string>;
+    /**
+     * Validates and renders an event template.
+     */
+    renderTemplate(): Promise<EventTemplate>;
+    /**
+     * Returns the list of routes this event should be published to. Defaults to
+     * the outbox model. Override to implement custom behavior.
+     */
+    protected renderRoutes(): Promise<RelaySelection[]>;
+    /**
+     * Returns a router scenario for this event. Publishes to forced relays (e.g. a
+     * NIP-29 group) when set, otherwise to the rendered routes.
+     */
+    scenario(): Promise<RelayScenario>;
+    /**
+     * Shortcut for getting relays from the router scenario.
+     */
+    relays(): Promise<string[]>;
+    /**
+     * Returns a rendered event template along with its relays.
+     */
+    render(): Promise<{
+        event: EventTemplate;
+        relays: string[];
+    }>;
+}
+//# sourceMappingURL=EventWriter.d.ts.map

package/dist/domain/src/core/EventWriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventWriter.d.ts","sourceRoot":"","sources":["../../../../src/core/EventWriter.ts"],"names":[],"mappings":"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"}

package/dist/domain/src/core/EventWriter.js

@@ -0,0 +1,233 @@
+import { remove, complement, first, partition, randomId, removeUndefined, spec } from "@welshman/lib";
+import { isParameterizedReplaceableKind, normalizeRelayUrl, hexTags, tagValues, outbox, userOutbox, inboxes, relays, } from "@welshman/util";
+// A cursor over a tag list that splits out tags by key as they're consumed,
+// leaving the rest in `tags`. Writers use it to peel behavior/kind-specific tags
+// off an event being edited.
+export class TagParser {
+    tags;
+    constructor(tags) {
+        this.tags = tags;
+    }
+    consume(key) {
+        const [consumed, remaining] = partition(spec([key]), this.tags);
+        this.tags = remaining;
+        return consumed;
+    }
+}
+export class EventWriter {
+    kind;
+    context;
+    reader;
+    content = "";
+    groupTag;
+    protectTag;
+    expirationTag;
+    identifierTag;
+    extraTags = [];
+    forcedRelays;
+    pendingResolves = [];
+    // Kinds that must publish to explicit relays (e.g. NIP-29 group events) set this.
+    // Annotated `boolean` (not the inferred literal `false`) so subclasses can override.
+    requiresRelays = false;
+    constructor(kind, context, reader) {
+        this.kind = kind;
+        this.context = context;
+        this.reader = reader;
+        if (reader) {
+            const parser = new TagParser(reader.event.tags);
+            this.content = reader.event.content;
+            this.groupTag = first(parser.consume("h"));
+            this.protectTag = first(parser.consume("-"));
+            this.expirationTag = first(parser.consume("expiration"));
+            this.identifierTag = first(parser.consume("d"));
+            this.extraTags = parser.tags;
+        }
+    }
+    setContent(content) {
+        this.content = content;
+        return this;
+    }
+    setGroup(url, group) {
+        this.forcedRelays = [normalizeRelayUrl(url)];
+        this.groupTag = ["h", group];
+        return this;
+    }
+    clearGroup() {
+        this.forcedRelays = undefined;
+        this.groupTag = undefined;
+        return this;
+    }
+    forceRelays(...urls) {
+        this.forcedRelays = urls.map(normalizeRelayUrl);
+        return this;
+    }
+    clearForcedRelays() {
+        this.forcedRelays = undefined;
+        return this;
+    }
+    setProtected(protect) {
+        this.protectTag = protect ? ["-"] : undefined;
+        return this;
+    }
+    setExpiration(expiration) {
+        this.expirationTag = ["expiration", String(expiration)];
+        return this;
+    }
+    clearExpiration() {
+        this.expirationTag = undefined;
+        return this;
+    }
+    setIdentifier(identifier = randomId()) {
+        this.identifierTag = ["d", identifier];
+        return this;
+    }
+    clearIdentifier() {
+        this.identifierTag = undefined;
+        return this;
+    }
+    addTags(...tags) {
+        this.extraTags.push(...tags);
+        return this;
+    }
+    keepTags(pred) {
+        this.extraTags = this.extraTags.filter(pred);
+        return this;
+    }
+    dropTags(pred) {
+        this.extraTags = this.extraTags.filter(complement(pred));
+        return this;
+    }
+    addMention(pubkey) {
+        const tag = ["p", pubkey, ""];
+        this.addTags(tag);
+        this.hint(outbox(pubkey)).then(url => {
+            tag[2] = url;
+        });
+        return this;
+    }
+    addQuote(event) {
+        const tag = ["q", event.id, "", event.pubkey];
+        this.addTags(tag);
+        this.hint(outbox(event.pubkey)).then(url => {
+            tag[2] = url;
+        });
+        return this;
+    }
+    addZapSplit(pubkey, split = 1) {
+        const tag = ["zap", pubkey, "", String(split)];
+        this.addTags(tag);
+        this.hint(outbox(pubkey)).then(url => {
+            tag[2] = url;
+        });
+        return this;
+    }
+    removeZapSplit(pubkey) {
+        return this.dropTags(spec(["zap", pubkey]));
+    }
+    addEmoji(shortcode, url, address) {
+        return this.dropTags(spec(["emoji", shortcode])).addTags(removeUndefined(["emoji", shortcode, url, address]));
+    }
+    removeEmoji(shortcode) {
+        return this.dropTags(spec(["emoji", shortcode]));
+    }
+    /**
+     * Validates a domain object, throwing an error if invalid.
+     */
+    validate() {
+        if (isParameterizedReplaceableKind(this.kind) && !this.identifierTag) {
+            throw new Error(`A d tag is required for kind ${this.kind}`);
+        }
+        if (this.groupTag && !this.forcedRelays?.length) {
+            throw new Error("A group event requires a relay url (set the group via setGroup)");
+        }
+        if (this.requiresRelays && !this.forcedRelays?.length) {
+            throw new Error(`A kind ${this.kind} event must publish to explicit relays (via setGroup or forceRelays)`);
+        }
+    }
+    /**
+     * Tracks a promise that must resolve before the event is rendered.
+     */
+    trackPending(promise) {
+        this.pendingResolves.push(promise);
+        promise.then(() => {
+            this.pendingResolves = remove(promise, this.pendingResolves);
+        });
+        return promise;
+    }
+    /**
+     * Resolves one or more relay selections to a single hint url, tracking the
+     * in-flight promise so `renderTags` can wait for it. Callers backfill the
+     * resolved url into a tag's hint slot.
+     */
+    hint(...routes) {
+        return this.trackPending(this.context.resolver.relay(routes).then(url => url ?? ""));
+    }
+    /**
+     * Returns a list of tags that may be attached to any kind.
+     */
+    renderBehaviorTags() {
+        return removeUndefined([this.groupTag, this.protectTag, this.expirationTag, this.identifierTag]);
+    }
+    /**
+     * Returns a list of tags related to the kind.
+     */
+    renderDomainTags() {
+        return [];
+    }
+    /**
+     * Returns the complete tag list for publishing.
+     */
+    async renderTags() {
+        const behaviorTags = await this.renderBehaviorTags();
+        const domainTags = await this.renderDomainTags();
+        // Wait for any relay hints to resolve and backfill their tags.
+        await Promise.all(this.pendingResolves);
+        return [...behaviorTags, ...domainTags, ...this.extraTags];
+    }
+    /**
+     * Returns the content string as defined by the kind.
+     */
+    renderContent() {
+        return this.content;
+    }
+    /**
+     * Validates and renders an event template.
+     */
+    async renderTemplate() {
+        this.validate();
+        return {
+            kind: this.kind,
+            tags: await this.renderTags(),
+            content: await this.renderContent(),
+        };
+    }
+    /**
+     * Returns the list of routes this event should be published to. Defaults to
+     * the outbox model. Override to implement custom behavior.
+     */
+    async renderRoutes() {
+        return [userOutbox(), ...inboxes(tagValues(hexTags("p"), await this.renderTags()), 0.5)];
+    }
+    /**
+     * Returns a router scenario for this event. Publishes to forced relays (e.g. a
+     * NIP-29 group) when set, otherwise to the rendered routes.
+     */
+    async scenario() {
+        const routes = this.forcedRelays?.length ? relays(this.forcedRelays) : await this.renderRoutes();
+        return this.context.resolver.scenario(routes);
+    }
+    /**
+     * Shortcut for getting relays from the router scenario.
+     */
+    async relays() {
+        return (await this.scenario()).getUrls();
+    }
+    /**
+     * Returns a rendered event template along with its relays.
+     */
+    async render() {
+        const [event, relays] = await Promise.all([this.renderTemplate(), this.relays()]);
+        return { event, relays };
+    }
+}
+//# sourceMappingURL=EventWriter.js.map

package/dist/domain/src/core/EventWriter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventWriter.js","sourceRoot":"","sources":["../../../../src/core/EventWriter.ts"],"names":[],"mappings":"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"}

package/dist/domain/src/core/Kind.d.ts

@@ -0,0 +1,39 @@
+import type { TrustedEvent, Resolver } from "@welshman/util";
+import type { ISigner } from "@welshman/signer";
+import type { EventReader } from "./EventReader.js";
+import type { EventWriter } from "./EventWriter.js";
+export type KindContext = {
+    resolver: Resolver;
+    signer?: ISigner;
+};
+export type KindConfig<Reader extends EventReader, Writer extends EventWriter<Reader>> = {
+    kind: number;
+    reader: new (kind: number, context: KindContext, event: TrustedEvent) => Reader;
+    writer: new (kind: number, context: KindContext, reader?: Reader) => Writer;
+};
+/**
+ * Bundles a kind's number, reader, and writer classes.
+ *
+ * Usage: `export const Profile = new KindFactory({kind: PROFILE, reader:
+ * ProfileReader, writer: ProfileWriter})`, then `Profile.kind` reads the number and
+ * `Profile.configure(context)` binds the app's dependencies once.
+ */
+export declare class KindFactory<Reader extends EventReader, Writer extends EventWriter<Reader>> {
+    readonly config: KindConfig<Reader, Writer>;
+    constructor(config: KindConfig<Reader, Writer>);
+    get kind(): number;
+    configure(context: KindContext): ConfiguredKind<Reader, Writer>;
+}
+/**
+ * A kind bound to a `KindContext`. Produces readers and writers which share the
+ * configured dependencies.
+ */
+export declare class ConfiguredKind<Reader extends EventReader, Writer extends EventWriter<Reader>> {
+    readonly config: KindConfig<Reader, Writer>;
+    readonly context: KindContext;
+    constructor(config: KindConfig<Reader, Writer>, context: KindContext);
+    get kind(): number;
+    reader: (event: TrustedEvent) => Promise<Reader>;
+    writer: (reader?: Reader) => Writer;
+}
+//# sourceMappingURL=Kind.d.ts.map

package/dist/domain/src/core/Kind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Kind.d.ts","sourceRoot":"","sources":["../../../../src/core/Kind.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,YAAY,EAAE,QAAQ,EAAC,MAAM,gBAAgB,CAAA;AAC1D,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,kBAAkB,CAAA;AAC7C,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAA;AACjD,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAA;AAEjD,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,EAAE,QAAQ,CAAA;IAClB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,UAAU,CAAC,MAAM,SAAS,WAAW,EAAE,MAAM,SAAS,WAAW,CAAC,MAAM,CAAC,IAAI;IACvF,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,KAAK,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,KAAK,MAAM,CAAA;IAC/E,MAAM,EAAE,KAAK,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;CAC5E,CAAA;AAED;;;;;;GAMG;AACH,qBAAa,WAAW,CAAC,MAAM,SAAS,WAAW,EAAE,MAAM,SAAS,WAAW,CAAC,MAAM,CAAC;IACzE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC;gBAAlC,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC;IAEvD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC;CAGhE;AAED;;;GAGG;AACH,qBAAa,cAAc,CAAC,MAAM,SAAS,WAAW,EAAE,MAAM,SAAS,WAAW,CAAC,MAAM,CAAC;IAEtF,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,WAAW;gBADpB,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,EAClC,OAAO,EAAE,WAAW;IAG/B,IAAI,IAAI,IAAI,MAAM,CAEjB;IAGD,MAAM,GAAU,OAAO,YAAY,KAAG,OAAO,CAAC,MAAM,CAAC,CAMpD;IAGD,MAAM,GAAI,SAAS,MAAM,KAAG,MAAM,CAC8B;CACjE"}