@welshman/domain 0.9.9 → 0.10.0

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

@@ -0,0 +1,19 @@
+import type { TrustedEvent } from "@welshman/util";
+/**
+ * The NIP-89 client an event was published with, parsed from a
+ * `["client", <name>, <address>, <relay hint>]` tag. `address` is an optional
+ * `31990:pubkey:d-tag` pointer to the client's handler information event, and
+ * `relay` an optional hint for where to find it.
+ */
+export type Client = {
+    name: string;
+    address?: string;
+    relay?: string;
+};
+/**
+ * Parse an event's NIP-89 `client` tag, or undefined if it has none. An address
+ * or relay hint that doesn't parse is dropped. A plain function so it can read
+ * the client off any event, regardless of kind, without a kind-specific reader.
+ */
+export declare const getClient: (event: TrustedEvent) => Client | undefined;
+//# sourceMappingURL=Client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Client.d.ts","sourceRoot":"","sources":["../../../../src/behaviors/Client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAA;AAEhD;;;;;GAKG;AACH,MAAM,MAAM,MAAM,GAAG;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,YAAY,KAAG,MAAM,GAAG,SAYxD,CAAA"}

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

@@ -0,0 +1,18 @@
+import { Address, isRelayUrl, matchTag, normalizeRelayUrl, tagSpec } from "@welshman/util";
+/**
+ * Parse an event's NIP-89 `client` tag, or undefined if it has none. An address
+ * or relay hint that doesn't parse is dropped. A plain function so it can read
+ * the client off any event, regardless of kind, without a kind-specific reader.
+ */
+export const getClient = (event) => {
+    const tag = matchTag(tagSpec("client"), event.tags);
+    if (!tag?.[1])
+        return undefined;
+    const [, name, address, relay] = tag;
+    return {
+        name,
+        address: address && Address.isAddress(address) ? address : undefined,
+        relay: relay && isRelayUrl(relay) ? normalizeRelayUrl(relay) : undefined,
+    };
+};
+//# sourceMappingURL=Client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Client.js","sourceRoot":"","sources":["../../../../src/behaviors/Client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,iBAAiB,EAAE,OAAO,EAAC,MAAM,gBAAgB,CAAA;AAexF;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAmB,EAAsB,EAAE;IACnE,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;IAEnD,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAAE,OAAO,SAAS,CAAA;IAE/B,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,GAAG,GAAG,CAAA;IAEpC,OAAO;QACL,IAAI;QACJ,OAAO,EAAE,OAAO,IAAI,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;QACpE,KAAK,EAAE,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;KACzE,CAAA;AACH,CAAC,CAAA"}

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

@@ -0,0 +1,15 @@
+import type { TrustedEvent } from "@welshman/util";
+/**
+ * A NIP-36 content warning, parsed from a `["content-warning", <reason>]` tag.
+ * The reason is optional: a bare tag flags the content without saying why.
+ */
+export type ContentWarning = {
+    reason?: string;
+};
+/**
+ * Parse an event's NIP-36 `content-warning` tag, or undefined if it has none.
+ * A plain function so it can read the warning off any event, regardless of
+ * kind, without a kind-specific reader.
+ */
+export declare const getContentWarning: (event: TrustedEvent) => ContentWarning | undefined;
+//# sourceMappingURL=ContentWarning.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ContentWarning.d.ts","sourceRoot":"","sources":["../../../../src/behaviors/ContentWarning.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAA;AAEhD;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAI,OAAO,YAAY,KAAG,cAAc,GAAG,SAIxE,CAAA"}

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

@@ -0,0 +1,13 @@
+import { spec } from "@welshman/lib";
+import { tagSpec, tagValue } from "@welshman/util";
+/**
+ * Parse an event's NIP-36 `content-warning` tag, or undefined if it has none.
+ * A plain function so it can read the warning off any event, regardless of
+ * kind, without a kind-specific reader.
+ */
+export const getContentWarning = (event) => {
+    if (!event.tags.some(spec(["content-warning"])))
+        return undefined;
+    return { reason: tagValue(tagSpec("content-warning"), event.tags) };
+};
+//# sourceMappingURL=ContentWarning.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ContentWarning.js","sourceRoot":"","sources":["../../../../src/behaviors/ContentWarning.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,eAAe,CAAA;AAClC,OAAO,EAAC,OAAO,EAAE,QAAQ,EAAC,MAAM,gBAAgB,CAAA;AAWhD;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAmB,EAA8B,EAAE;IACnF,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC;QAAE,OAAO,SAAS,CAAA;IAEjE,OAAO,EAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,EAAC,CAAA;AACnE,CAAC,CAAA"}

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

@@ -0,0 +1,9 @@
+import type { TrustedEvent } from "@welshman/util";
+/**
+ * Parse an event's NIP-40 `expiration` tag — the timestamp after which relays
+ * should stop serving it — or undefined if it has none or the value isn't a
+ * number. A plain function so it can read the expiration off any event,
+ * regardless of kind, without a kind-specific reader.
+ */
+export declare const getExpiration: (event: TrustedEvent) => number | undefined;
+//# sourceMappingURL=Expiration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Expiration.d.ts","sourceRoot":"","sources":["../../../../src/behaviors/Expiration.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAA;AAEhD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,YAAY,KAAG,MAAM,GAAG,SACH,CAAA"}

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

@@ -0,0 +1,10 @@
+import { toInt } from "@welshman/lib";
+import { tagSpec, tagValue } from "@welshman/util";
+/**
+ * Parse an event's NIP-40 `expiration` tag — the timestamp after which relays
+ * should stop serving it — or undefined if it has none or the value isn't a
+ * number. A plain function so it can read the expiration off any event,
+ * regardless of kind, without a kind-specific reader.
+ */
+export const getExpiration = (event) => toInt(tagValue(tagSpec("expiration"), event.tags) ?? "");
+//# sourceMappingURL=Expiration.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Expiration.js","sourceRoot":"","sources":["../../../../src/behaviors/Expiration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAC,MAAM,eAAe,CAAA;AACnC,OAAO,EAAC,OAAO,EAAE,QAAQ,EAAC,MAAM,gBAAgB,CAAA;AAGhD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAmB,EAAsB,EAAE,CACvE,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA"}

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

@@ -0,0 +1,8 @@
+import type { TrustedEvent } from "@welshman/util";
+/**
+ * Whether an event carries the NIP-70 `["-"]` marker, which asks relays to
+ * accept it only from its author. A plain function so it can read the marker
+ * off any event, regardless of kind, without a kind-specific reader.
+ */
+export declare const isProtected: (event: TrustedEvent) => boolean;
+//# sourceMappingURL=Protected.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Protected.d.ts","sourceRoot":"","sources":["../../../../src/behaviors/Protected.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAA;AAEhD;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,YAAY,KAAG,OAAuC,CAAA"}

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

@@ -0,0 +1,8 @@
+import { spec } from "@welshman/lib";
+/**
+ * Whether an event carries the NIP-70 `["-"]` marker, which asks relays to
+ * accept it only from its author. A plain function so it can read the marker
+ * off any event, regardless of kind, without a kind-specific reader.
+ */
+export const isProtected = (event) => event.tags.some(spec(["-"]));
+//# sourceMappingURL=Protected.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Protected.js","sourceRoot":"","sources":["../../../../src/behaviors/Protected.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,eAAe,CAAA;AAGlC;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAmB,EAAW,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA"}

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

@@ -0,0 +1,102 @@
+import type { MaybeAsync } from "@welshman/lib";
+import type { Filter, RelaySelection, RelayScenario } from "@welshman/util";
+import type { KindContext } from "./Kind.js";
+/**
+ * The read-side counterpart to `EventWriter`: a chainable builder for the filters
+ * that fetch a kind's events, plus the relays to request them from. The kind comes
+ * from the factory; each subclass implements `renderRoutes` to say where its
+ * events live, and adds any domain-specific methods (e.g. `CommentQuery.forRoot`).
+ */
+export declare abstract class EventQuery {
+    readonly kind: number;
+    readonly context: KindContext;
+    ids?: string[];
+    authors?: string[];
+    since?: number;
+    until?: number;
+    limit?: number;
+    search?: string;
+    tagValues: Map<string, string[]>;
+    forcedRoutes?: RelaySelection[];
+    extraRoutes: RelaySelection[];
+    constructor(kind: number, context: KindContext);
+    setIds(ids: string[]): this;
+    addIds(ids: string[]): this;
+    removeIds(ids: string[]): this;
+    clearIds(): this;
+    setAuthors(authors: string[]): this;
+    addAuthors(authors: string[]): this;
+    removeAuthors(authors: string[]): this;
+    clearAuthors(): this;
+    setTag(key: string, values: string[]): this;
+    addTag(key: string, values: string[]): this;
+    removeTag(key: string, values: string[]): this;
+    clearTag(key: string): this;
+    clearTags(): this;
+    setSince(since: number): this;
+    clearSince(): this;
+    setUntil(until: number): this;
+    clearUntil(): this;
+    setLimit(limit: number): this;
+    clearLimit(): this;
+    setSearch(search: string): this;
+    clearSearch(): this;
+    setRoom(url: string, room: string): this;
+    clearRoom(): this;
+    /**
+     * Replaces the rendered routes. These are routes rather than urls, so
+     * `setRoutes([userInbox()])` asks the user's read relays without resolving them
+     * first.
+     */
+    setRoutes(routes: RelaySelection[]): this;
+    /**
+     * Adds routes alongside the rendered ones.
+     */
+    addRoutes(routes: RelaySelection[]): this;
+    clearRoutes(): this;
+    /**
+     * Returns the filter fields that may be set on any kind.
+     */
+    protected renderBaseFilter(): MaybeAsync<Filter>;
+    /**
+     * Returns one filter per kind-specific variant. A relay ANDs a filter's fields
+     * together, so alternative references go in separate filters.
+     */
+    protected renderDomainFilters(): MaybeAsync<Filter[]>;
+    /**
+     * Returns the complete filter list for requesting.
+     */
+    renderFilters(): Promise<Filter[]>;
+    /**
+     * Returns the outboxes of the authors being queried.
+     */
+    protected authorRoutes(weight?: number): RelaySelection[];
+    /**
+     * Returns the inboxes of the pubkeys this query filters on by `p` tag — where
+     * events addressed to them are delivered.
+     */
+    protected mentionRoutes(weight?: number): RelaySelection[];
+    /**
+     * Returns the list of routes this query should be sent to. Every kind implements
+     * this itself; there is no default.
+     */
+    protected abstract renderRoutes(): MaybeAsync<RelaySelection[]>;
+    /**
+     * Returns a router scenario for this query. Requests the routes given to
+     * `setRoutes` when set, otherwise the rendered ones; either way `addRoutes`
+     * contributes on top.
+     */
+    scenario(): Promise<RelayScenario>;
+    /**
+     * Shortcut for getting relays from the router scenario.
+     */
+    relays(): Promise<string[]>;
+    /**
+     * Returns rendered filters along with the relays to request them from.
+     */
+    render(): Promise<{
+        filters: Filter[];
+        relays: string[];
+    }>;
+}
+//# sourceMappingURL=EventQuery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EventQuery.d.ts","sourceRoot":"","sources":["../../../../src/core/EventQuery.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,eAAe,CAAA;AAE7C,OAAO,KAAK,EAAC,MAAM,EAAE,cAAc,EAAE,aAAa,EAAC,MAAM,gBAAgB,CAAA;AACzE,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,WAAW,CAAA;AAc1C;;;;;GAKG;AACH,8BAAsB,UAAU;IAY5B,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,OAAO,EAAE,WAAW;IAZ/B,GAAG,CAAC,EAAE,MAAM,EAAE,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,wBAA8B;IACvC,YAAY,CAAC,EAAE,cAAc,EAAE,CAAA;IAC/B,WAAW,EAAE,cAAc,EAAE,CAAK;gBAGvB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,WAAW;IAG/B,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE;IAMpB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE;IAMpB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE;IAMvB,QAAQ;IAMR,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE;IAM5B,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE;IAM5B,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE;IAM/B,YAAY;IAMZ,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE;IAMpC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE;IAWpC,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE;IAWvC,QAAQ,CAAC,GAAG,EAAE,MAAM;IAMpB,SAAS;IAMT,QAAQ,CAAC,KAAK,EAAE,MAAM;IAMtB,UAAU;IAMV,QAAQ,CAAC,KAAK,EAAE,MAAM;IAMtB,UAAU;IAMV,QAAQ,CAAC,KAAK,EAAE,MAAM;IAMtB,UAAU;IAMV,SAAS,CAAC,MAAM,EAAE,MAAM;IAMxB,WAAW;IAOX,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAMjC,SAAS;IAMT;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,cAAc,EAAE;IAMlC;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,cAAc,EAAE;IAMlC,WAAW;IAOX;;OAEG;IACH,SAAS,CAAC,gBAAgB,IAAI,UAAU,CAAC,MAAM,CAAC;IAiBhD;;;OAGG;IACH,SAAS,CAAC,mBAAmB,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;IAIrD;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAOxC;;OAEG;IACH,SAAS,CAAC,YAAY,CAAC,MAAM,SAAI,GAAG,cAAc,EAAE;IAIpD;;;OAGG;IACH,SAAS,CAAC,aAAa,CAAC,MAAM,SAAM,GAAG,cAAc,EAAE;IAIvD;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,YAAY,IAAI,UAAU,CAAC,cAAc,EAAE,CAAC;IAE/D;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,aAAa,CAAC;IAMxC;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAIjC;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAC,CAAC;CAK/D"}

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

@@ -0,0 +1,227 @@
+import { uniq, without } from "@welshman/lib";
+import { normalizeRelayUrl, inboxes, outbox, relay } from "@welshman/util";
+// A filter field is either absent (unconstrained) or an array, an empty array
+// included, which matches nothing. Adding no values leaves the field as it was.
+const addValues = (current, values) => values.length > 0 ? uniq([...(current ?? []), ...values]) : current;
+const removeValues = (current, values) => current && without(values, current);
+// Tag filter keys are stored bare ("e") and rendered prefixed ("#e"), so callers
+// may pass either.
+const tagKey = (key) => (key.startsWith("#") ? key.slice(1) : key);
+/**
+ * The read-side counterpart to `EventWriter`: a chainable builder for the filters
+ * that fetch a kind's events, plus the relays to request them from. The kind comes
+ * from the factory; each subclass implements `renderRoutes` to say where its
+ * events live, and adds any domain-specific methods (e.g. `CommentQuery.forRoot`).
+ */
+export class EventQuery {
+    kind;
+    context;
+    ids;
+    authors;
+    since;
+    until;
+    limit;
+    search;
+    tagValues = new Map();
+    forcedRoutes;
+    extraRoutes = [];
+    constructor(kind, context) {
+        this.kind = kind;
+        this.context = context;
+    }
+    setIds(ids) {
+        this.ids = ids;
+        return this;
+    }
+    addIds(ids) {
+        this.ids = addValues(this.ids, ids);
+        return this;
+    }
+    removeIds(ids) {
+        this.ids = removeValues(this.ids, ids);
+        return this;
+    }
+    clearIds() {
+        this.ids = undefined;
+        return this;
+    }
+    setAuthors(authors) {
+        this.authors = authors;
+        return this;
+    }
+    addAuthors(authors) {
+        this.authors = addValues(this.authors, authors);
+        return this;
+    }
+    removeAuthors(authors) {
+        this.authors = removeValues(this.authors, authors);
+        return this;
+    }
+    clearAuthors() {
+        this.authors = undefined;
+        return this;
+    }
+    setTag(key, values) {
+        this.tagValues.set(tagKey(key), values);
+        return this;
+    }
+    addTag(key, values) {
+        const k = tagKey(key);
+        const next = addValues(this.tagValues.get(k), values);
+        if (next) {
+            this.tagValues.set(k, next);
+        }
+        return this;
+    }
+    removeTag(key, values) {
+        const k = tagKey(key);
+        const next = removeValues(this.tagValues.get(k), values);
+        if (next) {
+            this.tagValues.set(k, next);
+        }
+        return this;
+    }
+    clearTag(key) {
+        this.tagValues.delete(tagKey(key));
+        return this;
+    }
+    clearTags() {
+        this.tagValues.clear();
+        return this;
+    }
+    setSince(since) {
+        this.since = since;
+        return this;
+    }
+    clearSince() {
+        this.since = undefined;
+        return this;
+    }
+    setUntil(until) {
+        this.until = until;
+        return this;
+    }
+    clearUntil() {
+        this.until = undefined;
+        return this;
+    }
+    setLimit(limit) {
+        this.limit = limit;
+        return this;
+    }
+    clearLimit() {
+        this.limit = undefined;
+        return this;
+    }
+    setSearch(search) {
+        this.search = search;
+        return this;
+    }
+    clearSearch() {
+        this.search = undefined;
+        return this;
+    }
+    // NIP-29 room events live on one relay and are scoped by their `h` tag.
+    setRoom(url, room) {
+        this.forcedRoutes = [relay(normalizeRelayUrl(url))];
+        return this.setTag("h", [room]);
+    }
+    clearRoom() {
+        this.forcedRoutes = undefined;
+        return this.clearTag("h");
+    }
+    /**
+     * Replaces the rendered routes. These are routes rather than urls, so
+     * `setRoutes([userInbox()])` asks the user's read relays without resolving them
+     * first.
+     */
+    setRoutes(routes) {
+        this.forcedRoutes = routes;
+        return this;
+    }
+    /**
+     * Adds routes alongside the rendered ones.
+     */
+    addRoutes(routes) {
+        this.extraRoutes = [...this.extraRoutes, ...routes];
+        return this;
+    }
+    clearRoutes() {
+        this.forcedRoutes = undefined;
+        this.extraRoutes = [];
+        return this;
+    }
+    /**
+     * Returns the filter fields that may be set on any kind.
+     */
+    renderBaseFilter() {
+        const filter = { kinds: [this.kind] };
+        if (this.ids)
+            filter.ids = this.ids;
+        if (this.authors)
+            filter.authors = this.authors;
+        if (this.since !== undefined)
+            filter.since = this.since;
+        if (this.until !== undefined)
+            filter.until = this.until;
+        if (this.limit !== undefined)
+            filter.limit = this.limit;
+        if (this.search !== undefined)
+            filter.search = this.search;
+        for (const [key, values] of this.tagValues) {
+            filter[`#${key}`] = values;
+        }
+        return filter;
+    }
+    /**
+     * Returns one filter per kind-specific variant. A relay ANDs a filter's fields
+     * together, so alternative references go in separate filters.
+     */
+    renderDomainFilters() {
+        return [{}];
+    }
+    /**
+     * Returns the complete filter list for requesting.
+     */
+    async renderFilters() {
+        const baseFilter = await this.renderBaseFilter();
+        const domainFilters = await this.renderDomainFilters();
+        return domainFilters.map(filter => ({ ...baseFilter, ...filter }));
+    }
+    /**
+     * Returns the outboxes of the authors being queried.
+     */
+    authorRoutes(weight = 1) {
+        return (this.authors ?? []).map(pubkey => outbox(pubkey, weight));
+    }
+    /**
+     * Returns the inboxes of the pubkeys this query filters on by `p` tag — where
+     * events addressed to them are delivered.
+     */
+    mentionRoutes(weight = 0.5) {
+        return inboxes(this.tagValues.get("p") ?? [], weight);
+    }
+    /**
+     * Returns a router scenario for this query. Requests the routes given to
+     * `setRoutes` when set, otherwise the rendered ones; either way `addRoutes`
+     * contributes on top.
+     */
+    async scenario() {
+        const routes = this.forcedRoutes?.length ? this.forcedRoutes : await this.renderRoutes();
+        return this.context.resolver.scenario([...routes, ...this.extraRoutes]);
+    }
+    /**
+     * Shortcut for getting relays from the router scenario.
+     */
+    async relays() {
+        return (await this.scenario()).getUrls();
+    }
+    /**
+     * Returns rendered filters along with the relays to request them from.
+     */
+    async render() {
+        const [filters, relays] = await Promise.all([this.renderFilters(), this.relays()]);
+        return { filters, relays };
+    }
+}
+//# sourceMappingURL=EventQuery.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EventQuery.js","sourceRoot":"","sources":["../../../../src/core/EventQuery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAE,OAAO,EAAC,MAAM,eAAe,CAAA;AAE3C,OAAO,EAAC,iBAAiB,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAC,MAAM,gBAAgB,CAAA;AAIxE,8EAA8E;AAC9E,gFAAgF;AAChF,MAAM,SAAS,GAAG,CAAC,OAA6B,EAAE,MAAgB,EAAE,EAAE,CACpE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAA;AAErE,MAAM,YAAY,GAAG,CAAC,OAA6B,EAAE,MAAgB,EAAE,EAAE,CACvE,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAErC,iFAAiF;AACjF,mBAAmB;AACnB,MAAM,MAAM,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;AAE1E;;;;;GAKG;AACH,MAAM,OAAgB,UAAU;IAYnB;IACA;IAZX,GAAG,CAAW;IACd,OAAO,CAAW;IAClB,KAAK,CAAS;IACd,KAAK,CAAS;IACd,KAAK,CAAS;IACd,MAAM,CAAS;IACf,SAAS,GAAG,IAAI,GAAG,EAAoB,CAAA;IACvC,YAAY,CAAmB;IAC/B,WAAW,GAAqB,EAAE,CAAA;IAElC,YACW,IAAY,EACZ,OAAoB;QADpB,SAAI,GAAJ,IAAI,CAAQ;QACZ,YAAO,GAAP,OAAO,CAAa;IAC5B,CAAC;IAEJ,MAAM,CAAC,GAAa;QAClB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAA;QAEd,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,CAAC,GAAa;QAClB,IAAI,CAAC,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;QAEnC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,SAAS,CAAC,GAAa;QACrB,IAAI,CAAC,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;QAEtC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,QAAQ;QACN,IAAI,CAAC,GAAG,GAAG,SAAS,CAAA;QAEpB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,UAAU,CAAC,OAAiB;QAC1B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QAEtB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,UAAU,CAAC,OAAiB;QAC1B,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAE/C,OAAO,IAAI,CAAA;IACb,CAAC;IAED,aAAa,CAAC,OAAiB;QAC7B,IAAI,CAAC,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAElD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,YAAY;QACV,IAAI,CAAC,OAAO,GAAG,SAAS,CAAA;QAExB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,CAAC,GAAW,EAAE,MAAgB;QAClC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAA;QAEvC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,CAAC,GAAW,EAAE,MAAgB;QAClC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;QACrB,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAA;QAErD,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;QAC7B,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;IAED,SAAS,CAAC,GAAW,EAAE,MAAgB;QACrC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;QACrB,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAA;QAExD,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;QAC7B,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;IAED,QAAQ,CAAC,GAAW;QAClB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;QAElC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,SAAS;QACP,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAA;QAEtB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,QAAQ,CAAC,KAAa;QACpB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QAElB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,UAAU;QACR,IAAI,CAAC,KAAK,GAAG,SAAS,CAAA;QAEtB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,QAAQ,CAAC,KAAa;QACpB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QAElB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,UAAU;QACR,IAAI,CAAC,KAAK,GAAG,SAAS,CAAA;QAEtB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,QAAQ,CAAC,KAAa;QACpB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QAElB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,UAAU;QACR,IAAI,CAAC,KAAK,GAAG,SAAS,CAAA;QAEtB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,SAAS,CAAC,MAAc;QACtB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QAEpB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,WAAW;QACT,IAAI,CAAC,MAAM,GAAG,SAAS,CAAA;QAEvB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,wEAAwE;IACxE,OAAO,CAAC,GAAW,EAAE,IAAY;QAC/B,IAAI,CAAC,YAAY,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;QAEnD,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAA;IACjC,CAAC;IAED,SAAS;QACP,IAAI,CAAC,YAAY,GAAG,SAAS,CAAA;QAE7B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;IAC3B,CAAC;IAED;;;;OAIG;IACH,SAAS,CAAC,MAAwB;QAChC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAA;QAE1B,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,MAAwB;QAChC,IAAI,CAAC,WAAW,GAAG,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,GAAG,MAAM,CAAC,CAAA;QAEnD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,WAAW;QACT,IAAI,CAAC,YAAY,GAAG,SAAS,CAAA;QAC7B,IAAI,CAAC,WAAW,GAAG,EAAE,CAAA;QAErB,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;OAEG;IACO,gBAAgB;QACxB,MAAM,MAAM,GAAwB,EAAC,KAAK,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAC,CAAA;QAExD,IAAI,IAAI,CAAC,GAAG;YAAE,MAAM,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAA;QACnC,IAAI,IAAI,CAAC,OAAO;YAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAA;QAC/C,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAAE,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;QACvD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAAE,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;QACvD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAAE,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;QACvD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;YAAE,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;QAE1D,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC3C,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC,GAAG,MAAM,CAAA;QAC5B,CAAC;QAED,OAAO,MAAgB,CAAA;IACzB,CAAC;IAED;;;OAGG;IACO,mBAAmB;QAC3B,OAAO,CAAC,EAAE,CAAC,CAAA;IACb,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa;QACjB,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAA;QAChD,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAA;QAEtD,OAAO,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAC,GAAG,UAAU,EAAE,GAAG,MAAM,EAAC,CAAC,CAAC,CAAA;IAClE,CAAC;IAED;;OAEG;IACO,YAAY,CAAC,MAAM,GAAG,CAAC;QAC/B,OAAO,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IACnE,CAAC;IAED;;;OAGG;IACO,aAAa,CAAC,MAAM,GAAG,GAAG;QAClC,OAAO,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,CAAA;IACvD,CAAC;IAQD;;;;OAIG;IACH,KAAK,CAAC,QAAQ;QACZ,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,YAAY,EAAE,CAAA;QAExF,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAA;IACzE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM;QACV,OAAO,CAAC,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAA;IAC1C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM;QACV,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;QAElF,OAAO,EAAC,OAAO,EAAE,MAAM,EAAC,CAAA;IAC1B,CAAC;CACF"}

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

@@ -1,6 +1,7 @@
 import type { MaybeAsync } from "@welshman/lib";
 import type { TrustedEvent } from "@welshman/util";
 import type { KindContext } from "./Kind.js";
+import type { Client } from "../behaviors/Client.js";
 import type { Emoji } from "../behaviors/Emoji.js";
 import type { ZapSplit } from "../behaviors/ZapSplits.js";
 /**
@@ -24,6 +25,9 @@ export declare abstract class BaseEventReader {
     room(): string | undefined;
     protect(): boolean;
     expiration(): number | undefined;
+    contentWarning(): boolean;
+    contentWarningReason(): string | undefined;
+    client(): Client | undefined;
     emojis(): Emoji[];
     zapSplits(): ZapSplit[];
 }

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

@@ -1 +1 @@
-{"version":3,"file":"EventReader.d.ts","sourceRoot":"","sources":["../../../../src/core/EventReader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,eAAe,CAAA;AAE7C,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;;;;GAIG;AACH,8BAAsB,eAAe;IAEjC,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;IAS9B,QAAQ,CAAC,KAAK,IAAI,UAAU,CAAC,IAAI,CAAC;IAElC,EAAE;IAIF,MAAM;IAIN,OAAO;IAIP,IAAI;IAIJ,SAAS;IAIT,UAAU;IAIV,OAAO;IAIP,IAAI;IAIJ,OAAO;IAIP,UAAU;IAIV,MAAM,IAAI,KAAK,EAAE;IAIjB,SAAS,IAAI,QAAQ,EAAE;CAGxB;AAED;;;;GAIG;AACH,8BAAsB,WAAY,SAAQ,eAAe;IACvD,KAAK,IAAI,IAAI;CAGd;AAED;;;;GAIG;AACH,8BAAsB,gBAAiB,SAAQ,eAAe;IAC5D,QAAQ,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,SAAS,eAAe,IAAI,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAA"}
+{"version":3,"file":"EventReader.d.ts","sourceRoot":"","sources":["../../../../src/core/EventReader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,eAAe,CAAA;AAE7C,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAA;AAChD,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,WAAW,CAAA;AAE1C,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,wBAAwB,CAAA;AAGlD,OAAO,KAAK,EAAC,KAAK,EAAC,MAAM,uBAAuB,CAAA;AAIhD,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,2BAA2B,CAAA;AAEvD;;;;GAIG;AACH,8BAAsB,eAAe;IAEjC,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;IAS9B,QAAQ,CAAC,KAAK,IAAI,UAAU,CAAC,IAAI,CAAC;IAElC,EAAE;IAIF,MAAM;IAIN,OAAO;IAIP,IAAI;IAIJ,SAAS;IAIT,UAAU;IAIV,OAAO;IAIP,IAAI;IAIJ,OAAO;IAIP,UAAU;IAIV,cAAc;IAId,oBAAoB;IAIpB,MAAM,IAAI,MAAM,GAAG,SAAS;IAI5B,MAAM,IAAI,KAAK,EAAE;IAIjB,SAAS,IAAI,QAAQ,EAAE;CAGxB;AAED;;;;GAIG;AACH,8BAAsB,WAAY,SAAQ,eAAe;IACvD,KAAK,IAAI,IAAI;CAGd;AAED;;;;GAIG;AACH,8BAAsB,gBAAiB,SAAQ,eAAe;IAC5D,QAAQ,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,SAAS,eAAe,IAAI,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAA"}

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

@@ -1,6 +1,9 @@
-import { spec, toInt } from "@welshman/lib";
 import { tagSpec, tagValue, getAddress } from "@welshman/util";
+import { getClient } from "../behaviors/Client.js";
+import { getContentWarning } from "../behaviors/ContentWarning.js";
 import { getEmojis } from "../behaviors/Emoji.js";
+import { getExpiration } from "../behaviors/Expiration.js";
+import { isProtected } from "../behaviors/Protected.js";
 import { getZapSplits } from "../behaviors/ZapSplits.js";
 /**
  * The accessors every reader shares. Readers don't extend this directly — they
@@ -44,10 +47,19 @@ export class BaseEventReader {
         return tagValue(tagSpec("h"), this.event.tags);
     }
     protect() {
-        return this.event.tags.some(spec(["-"]));
+        return isProtected(this.event);
     }
     expiration() {
-        return toInt(tagValue(tagSpec("expiration"), this.event.tags) ?? "");
+        return getExpiration(this.event);
+    }
+    contentWarning() {
+        return Boolean(getContentWarning(this.event));
+    }
+    contentWarningReason() {
+        return getContentWarning(this.event)?.reason;
+    }
+    client() {
+        return getClient(this.event);
     }
     emojis() {
         return getEmojis(this.event);

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

@@ -1 +1 @@
-{"version":3,"file":"EventReader.js","sourceRoot":"","sources":["../../../../src/core/EventReader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAE,KAAK,EAAC,MAAM,eAAe,CAAA;AAEzC,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;;;;GAIG;AACH,MAAM,OAAgB,eAAe;IAExB;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;IAMD,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,IAAI;QACF,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;AAED;;;;GAIG;AACH,MAAM,OAAgB,WAAY,SAAQ,eAAe;IACvD,KAAK;QACH,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAgB,gBAAiB,SAAQ,eAAe;CAE7D"}
+{"version":3,"file":"EventReader.js","sourceRoot":"","sources":["../../../../src/core/EventReader.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAC,MAAM,gBAAgB,CAAA;AAG5D,OAAO,EAAC,SAAS,EAAC,MAAM,wBAAwB,CAAA;AAEhD,OAAO,EAAC,iBAAiB,EAAC,MAAM,gCAAgC,CAAA;AAChE,OAAO,EAAC,SAAS,EAAC,MAAM,uBAAuB,CAAA;AAE/C,OAAO,EAAC,aAAa,EAAC,MAAM,4BAA4B,CAAA;AACxD,OAAO,EAAC,WAAW,EAAC,MAAM,2BAA2B,CAAA;AACrD,OAAO,EAAC,YAAY,EAAC,MAAM,2BAA2B,CAAA;AAGtD;;;;GAIG;AACH,MAAM,OAAgB,eAAe;IAExB;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;IAMD,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,IAAI;QACF,OAAO,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAChD,CAAC;IAED,OAAO;QACL,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAChC,CAAC;IAED,UAAU;QACR,OAAO,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAClC,CAAC;IAED,cAAc;QACZ,OAAO,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;IAC/C,CAAC;IAED,oBAAoB;QAClB,OAAO,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IAC9C,CAAC;IAED,MAAM;QACJ,OAAO,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC9B,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;AAED;;;;GAIG;AACH,MAAM,OAAgB,WAAY,SAAQ,eAAe;IACvD,KAAK;QACH,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAgB,gBAAiB,SAAQ,eAAe;CAE7D"}

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

@@ -15,20 +15,36 @@ export declare abstract class EventWriter<Reader extends BaseEventReader> {
     roomTag?: string[];
     protectTag?: string[];
     expirationTag?: string[];
+    contentWarningTag?: string[];
+    clientTag?: string[];
     identifierTag?: string[];
     extraTags: string[][];
-    forcedRelays?: string[];
+    forcedRoutes?: RelaySelection[];
     pendingResolves: Promise<unknown>[];
     readonly requiresRelays: boolean;
     constructor(kind: number, context: KindContext, reader?: Reader | undefined);
     setContent(content: string): this;
     setRoom(url: string, room: string): this;
     clearRoom(): this;
-    forceRelays(...urls: string[]): this;
-    clearForcedRelays(): this;
+    /**
+     * Replaces the rendered routes. These are routes rather than urls, so
+     * `forceRoutes(userInbox())` pins an event to the user's read relays without
+     * resolving them first.
+     */
+    forceRoutes(...routes: RelaySelection[]): this;
+    clearForcedRoutes(): this;
     setProtected(protect: boolean): this;
     setExpiration(expiration: number): this;
     clearExpiration(): this;
+    setContentWarning(reason?: string): this;
+    clearContentWarning(): this;
+    /**
+     * Attributes the event to the NIP-89 client that produced it. `address` is an
+     * optional `31990:pubkey:d-tag` pointer to the client's handler information
+     * event; when given, its author's outbox fills in the tag's relay hint slot.
+     */
+    setClient(name: string, address?: string): this;
+    clearClient(): this;
     setIdentifier(identifier?: string): this;
     clearIdentifier(): this;
     addTags(...tags: string[][]): this;
@@ -80,8 +96,8 @@ export declare abstract class EventWriter<Reader extends BaseEventReader> {
      */
     protected renderRoutes(): Promise<RelaySelection[]>;
     /**
-     * Returns a router scenario for this event. Publishes to forced relays (e.g. a
-     * NIP-29 room) when set, otherwise to the rendered routes.
+     * Returns a router scenario for this event. Publishes to the forced routes (e.g. a
+     * NIP-29 room's relay) when set, otherwise to the rendered routes.
      */
     scenario(): Promise<RelayScenario>;
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"EventWriter.d.ts","sourceRoot":"","sources":["../../../../src/core/EventWriter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"EventWriter.d.ts","sourceRoot":"","sources":["../../../../src/core/EventWriter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,eAAe,CAAA;AAY7C,OAAO,KAAK,EAAC,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAC,MAAM,gBAAgB,CAAA;AAC9F,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,kBAAkB,CAAA;AACrD,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,WAAW,CAAA;AAK1C,qBAAa,SAAS;IACpB,IAAI,EAAE,MAAM,EAAE,EAAE,CAAA;gBAEJ,IAAI,EAAE,MAAM,EAAE,EAAE;IAI5B,OAAO,CAAC,GAAG,EAAE,MAAM;CAOpB;AAED,8BAAsB,WAAW,CAAC,MAAM,SAAS,eAAe;IAiB5D,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,OAAO,EAAE,WAAW;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM;IAlB1B,OAAO,SAAK;IACZ,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC5B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,SAAS,EAAE,MAAM,EAAE,EAAE,CAAK;IAC1B,YAAY,CAAC,EAAE,cAAc,EAAE,CAAA;IAC/B,eAAe,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,CAAK;IAIxC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAQ;gBAG7B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,WAAW,EACpB,MAAM,CAAC,EAAE,MAAM,YAAA;IAgB1B,UAAU,CAAC,OAAO,EAAE,MAAM;IAM1B,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAOjC,SAAS;IAOT;;;;OAIG;IACH,WAAW,CAAC,GAAG,MAAM,EAAE,cAAc,EAAE;IAMvC,iBAAiB;IAMjB,YAAY,CAAC,OAAO,EAAE,OAAO;IAM7B,aAAa,CAAC,UAAU,EAAE,MAAM;IAMhC,eAAe;IAOf,iBAAiB,CAAC,MAAM,CAAC,EAAE,MAAM;IAMjC,mBAAmB;IAMnB;;;;OAIG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;IAcxC,WAAW;IAMX,aAAa,CAAC,UAAU,SAAa;IAMrC,eAAe;IAMf,OAAO,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,EAAE;IAM3B,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,OAAO;IAMzC,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,OAAO;IAMzC,UAAU,CAAC,MAAM,EAAE,MAAM;IAYzB,QAAQ,CAAC,KAAK,EAAE,YAAY;IAY5B,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,SAAI;IAYrC,cAAc,CAAC,MAAM,EAAE,MAAM;IAI7B,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;IAMzD,WAAW,CAAC,SAAS,EAAE,MAAM;IAI7B;;OAEG;IACH,QAAQ,IAAI,IAAI;IAgBhB;;OAEG;IACH,OAAO,CAAC,YAAY;IAUpB;;;;OAIG;IACH,SAAS,CAAC,IAAI,CAAC,GAAG,MAAM,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAI5D;;OAEG;IACH,SAAS,CAAC,kBAAkB,IAAI,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC;IAWtD;;OAEG;IACH,SAAS,CAAC,gBAAgB,IAAI,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC;IAIpD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAUvC;;OAEG;IACH,aAAa,IAAI,UAAU,CAAC,MAAM,CAAC;IAInC;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,aAAa,CAAC;IAU9C;;;OAGG;cACa,YAAY,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAIzD;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,aAAa,CAAC;IAMxC;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAIjC;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC;QAAC,KAAK,EAAE,aAAa,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAC,CAAC;CAKlE"}