@welshman/app 0.8.16 → 0.9.0-pre2

package/dist/app/src/plugins/relayStats.js

@@ -0,0 +1,173 @@
+import { groupBy, batch, now, uniq, ago, DAY, HOUR, MINUTE } from "@welshman/lib";
+import { isOnionUrl, isLocalUrl, isIPAddress, isRelayUrl } from "@welshman/util";
+import { SocketStatus, SocketEvent } from "@welshman/net";
+import { MapPlugin } from "./base.js";
+import { BlockedRelayLists } from "./blockedRelayLists.js";
+export const makeRelayStatsItem = (url) => ({
+    url,
+    first_seen: now(),
+    recent_errors: [],
+    open_count: 0,
+    close_count: 0,
+    publish_count: 0,
+    request_count: 0,
+    event_count: 0,
+    last_open: 0,
+    last_close: 0,
+    last_error: 0,
+    last_publish: 0,
+    last_request: 0,
+    last_event: 0,
+    last_auth: 0,
+    publish_success_count: 0,
+    publish_failure_count: 0,
+    eose_count: 0,
+    notice_count: 0,
+});
+/**
+ * Per-relay connection statistics, keyed by url, plus the `getQuality` heuristic
+ * the router uses to rank relays. A pure store — the socket wiring that fills it
+ * lives in `appPolicyRelayStats`.
+ */
+export class RelayStats extends MapPlugin {
+    getQuality = (url) => {
+        // Skip non-relays entirely
+        if (!isRelayUrl(url))
+            return 0;
+        // Skip relays the user has blocked
+        const pubkey = this.app.user?.pubkey;
+        if (pubkey && this.app.use(BlockedRelayLists).urls(pubkey).get().includes(url)) {
+            return 0;
+        }
+        const stats = this.get(url);
+        // If we have recent errors, skip it
+        if (stats) {
+            if (stats.recent_errors.filter(n => n > ago(MINUTE)).length > 0)
+                return 0;
+            if (stats.recent_errors.filter(n => n > ago(HOUR)).length > 3)
+                return 0;
+            if (stats.recent_errors.filter(n => n > ago(DAY)).length > 10)
+                return 0;
+        }
+        // Prefer stuff we're connected to
+        if (this.app.pool.has(url))
+            return 1;
+        // Prefer stuff we've connected to in the past
+        if (stats)
+            return 0.9;
+        // If it's not a weird url give it an ok score
+        if (!isIPAddress(url) && !isLocalUrl(url) && !isOnionUrl(url) && !url.startsWith("ws://")) {
+            return 0.8;
+        }
+        // Default to a "meh" score
+        return 0.7;
+    };
+    update = batch(150, (batched) => {
+        for (const [url, updates] of groupBy(([url]) => url, batched)) {
+            if (!url || !isRelayUrl(url)) {
+                console.warn(`Attempted to update stats for an invalid relay url: ${url}`);
+                continue;
+            }
+            const prev = this.get(url);
+            const next = prev ? { ...prev } : makeRelayStatsItem(url);
+            for (const [, update] of updates) {
+                update(next);
+            }
+            this.set(url, next);
+        }
+    });
+    onSocketSend = ([verb], url) => {
+        if (verb === "REQ") {
+            this.update([
+                url,
+                stats => {
+                    stats.request_count++;
+                    stats.last_request = now();
+                },
+            ]);
+        }
+        else if (verb === "EVENT") {
+            this.update([
+                url,
+                stats => {
+                    stats.publish_count++;
+                    stats.last_publish = now();
+                },
+            ]);
+        }
+    };
+    onSocketReceive = ([verb, ...extra], url) => {
+        if (verb === "OK") {
+            const [, ok] = extra;
+            this.update([
+                url,
+                stats => {
+                    if (ok) {
+                        stats.publish_success_count++;
+                    }
+                    else {
+                        stats.publish_failure_count++;
+                    }
+                },
+            ]);
+        }
+        else if (verb === "AUTH") {
+            this.update([url, stats => (stats.last_auth = now())]);
+        }
+        else if (verb === "EVENT") {
+            this.update([
+                url,
+                stats => {
+                    stats.event_count++;
+                    stats.last_event = now();
+                },
+            ]);
+        }
+        else if (verb === "EOSE") {
+            this.update([url, stats => stats.eose_count++]);
+        }
+        else if (verb === "NOTICE") {
+            this.update([url, stats => stats.notice_count++]);
+        }
+    };
+    onSocketStatus = (status, url) => {
+        if (status === SocketStatus.Open) {
+            this.update([
+                url,
+                stats => {
+                    stats.last_open = now();
+                    stats.open_count++;
+                },
+            ]);
+        }
+        if (status === SocketStatus.Closed) {
+            this.update([
+                url,
+                stats => {
+                    stats.last_close = now();
+                    stats.close_count++;
+                },
+            ]);
+        }
+        if (status === SocketStatus.Error) {
+            this.update([
+                url,
+                stats => {
+                    stats.last_error = now();
+                    stats.recent_errors = uniq(stats.recent_errors.concat(now())).slice(-10);
+                },
+            ]);
+        }
+    };
+    monitorSocket = (socket) => {
+        socket.on(SocketEvent.Send, this.onSocketSend);
+        socket.on(SocketEvent.Receive, this.onSocketReceive);
+        socket.on(SocketEvent.Status, this.onSocketStatus);
+        return () => {
+            socket.off(SocketEvent.Send, this.onSocketSend);
+            socket.off(SocketEvent.Receive, this.onSocketReceive);
+            socket.off(SocketEvent.Status, this.onSocketStatus);
+        };
+    };
+}
+//# sourceMappingURL=relayStats.js.map

package/dist/app/src/plugins/relayStats.js.map

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

package/dist/app/src/plugins/relays.d.ts

@@ -0,0 +1,34 @@
+import type { Readable } from "svelte/store";
+import type { Maybe } from "@welshman/lib";
+import { Relay } from "@welshman/domain";
+import { LoadableMapPlugin, RelayScopedDerivedPlugin } from "./base.js";
+import type { Projection, Search, RelayScopedDerivedPluginOptions } from "./base.js";
+import type { IApp } from "../app.js";
+/**
+ * NIP-11 relay profiles, keyed by url. A "local" loadable collection: items
+ * aren't nostr events, they're fetched over HTTP from each relay.
+ */
+export declare class Relays extends LoadableMapPlugin<Relay> {
+    relaySearch: Readable<Search<string, Relay>>;
+    fetch: (url: string) => Promise<Maybe<Relay>>;
+    display: (url: string) => Projection<string>;
+    hasNegentropy: (url: string) => Promise<boolean>;
+    hasNip: (url: string, nip: number | string) => Promise<boolean>;
+}
+export type RelaySignedItem = {
+    author(): string;
+};
+/**
+ * A `RelayScopedDerivedPlugin` that additionally validates provenance: an item
+ * is only keyed on a relay when the relay ITSELF signed it — i.e. the event's
+ * author matches the relay's NIP-11 `self` pubkey. This is the trust model for
+ * relay-hosted, relay-signed content (NIP-29 group state, relay membership and
+ * roles), and rejects events of these kinds forged by other pubkeys.
+ *
+ * Relay self pubkeys load from NIP-11 and can arrive after the events, so the
+ * collection re-evaluates whenever the relay-profile collection changes.
+ */
+export declare abstract class RelaySignedDerivedPlugin<T extends RelaySignedItem> extends RelayScopedDerivedPlugin<T> {
+    constructor(app: IApp, options: RelayScopedDerivedPluginOptions<T>);
+}
+//# sourceMappingURL=relays.d.ts.map

package/dist/app/src/plugins/relays.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relays.d.ts","sourceRoot":"","sources":["../../../../src/plugins/relays.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,cAAc,CAAA;AAC1C,OAAO,KAAK,EAAC,KAAK,EAAC,MAAM,eAAe,CAAA;AAExC,OAAO,EAAC,KAAK,EAAC,MAAM,kBAAkB,CAAA;AACtC,OAAO,EAAC,iBAAiB,EAAE,wBAAwB,EAAe,MAAM,WAAW,CAAA;AACnF,OAAO,KAAK,EAAC,UAAU,EAAE,MAAM,EAAE,+BAA+B,EAAC,MAAM,WAAW,CAAA;AAClF,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,WAAW,CAAA;AAEnC;;;GAGG;AACH,qBAAa,MAAO,SAAQ,iBAAiB,CAAC,KAAK,CAAC;IAClD,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAO3C;IAED,KAAK,GAAU,KAAK,MAAM,KAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAqCjD;IAED,OAAO,GAAI,KAAK,MAAM,KAAG,UAAU,CAAC,MAAM,CAAC,CAC6B;IAExE,aAAa,GAAU,KAAK,MAAM,sBAAqD;IAEvF,MAAM,GAAU,KAAK,MAAM,EAAE,KAAK,MAAM,GAAG,MAAM,sBAAiD;CACnG;AAID,MAAM,MAAM,eAAe,GAAG;IAAC,MAAM,IAAI,MAAM,CAAA;CAAC,CAAA;AAEhD;;;;;;;;;GASG;AACH,8BAAsB,wBAAwB,CAC5C,CAAC,SAAS,eAAe,CACzB,SAAQ,wBAAwB,CAAC,CAAC,CAAC;gBACvB,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,+BAA+B,CAAC,CAAC,CAAC;CAQnE"}

package/dist/app/src/plugins/relays.js

@@ -0,0 +1,68 @@
+import { derived } from "svelte/store";
+import { displayRelayUrl } from "@welshman/util";
+import { Relay } from "@welshman/domain";
+import { LoadableMapPlugin, RelayScopedDerivedPlugin, createSearch } from "./base.js";
+/**
+ * NIP-11 relay profiles, keyed by url. A "local" loadable collection: items
+ * aren't nostr events, they're fetched over HTTP from each relay.
+ */
+export class Relays extends LoadableMapPlugin {
+    relaySearch = derived(this.all.$, $relays => createSearch($relays, {
+        getValue: (relay) => relay.url,
+        fuseOptions: {
+            keys: ["url", "name", { name: "description", weight: 0.3 }],
+        },
+    }));
+    fetch = async (url) => {
+        const httpUrl = url.replace(/^ws/, "http");
+        try {
+            // Don't auto-follow redirects, so a relay whose metadata document has moved
+            // (301/302) is recorded via `redirect_to` rather than silently resolved.
+            const res = await globalThis.fetch(httpUrl, {
+                headers: { Accept: "application/nostr+json" },
+                redirect: "manual",
+            });
+            if (res.status === 301 || res.status === 302) {
+                const location = res.headers.get("location");
+                if (location) {
+                    const relay = new Relay(url, { redirect_to: new URL(location, httpUrl).href });
+                    this.set(url, relay);
+                    return relay;
+                }
+                return;
+            }
+            const json = await res.json();
+            if (json) {
+                const relay = new Relay(url, json);
+                this.set(url, relay);
+                return relay;
+            }
+        }
+        catch (e) {
+            // pass
+        }
+    };
+    display = (url) => this.project(url, $relay => $relay?.display() ?? displayRelayUrl(url));
+    hasNegentropy = async (url) => (await this.load(url))?.hasNegentropy() ?? false;
+    hasNip = async (url, nip) => (await this.load(url))?.hasNip(nip) ?? false;
+}
+/**
+ * A `RelayScopedDerivedPlugin` that additionally validates provenance: an item
+ * is only keyed on a relay when the relay ITSELF signed it — i.e. the event's
+ * author matches the relay's NIP-11 `self` pubkey. This is the trust model for
+ * relay-hosted, relay-signed content (NIP-29 group state, relay membership and
+ * roles), and rejects events of these kinds forged by other pubkeys.
+ *
+ * Relay self pubkeys load from NIP-11 and can arrive after the events, so the
+ * collection re-evaluates whenever the relay-profile collection changes.
+ */
+export class RelaySignedDerivedPlugin extends RelayScopedDerivedPlugin {
+    constructor(app, options) {
+        super(app, {
+            ...options,
+            getKey: (item, url) => item.author() === app.use(Relays).get(url)?.self ? options.getKey(item, url) : undefined,
+            revalidateOn: app.use(Relays).index.$,
+        });
+    }
+}
+//# sourceMappingURL=relays.js.map

package/dist/app/src/plugins/relays.js.map

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

package/dist/app/src/plugins/roomLists.d.ts

@@ -0,0 +1,22 @@
+import { RoomListReader, RoomListWriter } from "@welshman/domain";
+import { DerivedPlugin } from "./base.js";
+import type { Projection } from "./base.js";
+import type { IApp } from "../app.js";
+/**
+ * NIP-51 kind-10009 room lists (relays the user belongs to, and groups on
+ * them), keyed by pubkey. Loaded via the outbox model (the author's write
+ * relays), so it depends on the relay-list collection.
+ */
+export declare class RoomLists extends DerivedPlugin<RoomListReader> {
+    constructor(app: IApp);
+    fetch(pubkey: string, relayHints?: string[]): Promise<import("@welshman/util").TrustedEvent | undefined>;
+    urls: (pubkey: string) => Projection<string[]>;
+    groupsForUrl: (pubkey: string, url: string) => Projection<string[]>;
+    pubkeysForUrl: (url: string) => Projection<string[]>;
+    update: (fn: (writer: RoomListWriter) => void) => Promise<import("../command.js").Command>;
+    addGroup: (groupId: string, url: string) => Promise<import("../command.js").Command>;
+    removeGroup: (groupId: string, url?: string) => Promise<import("../command.js").Command>;
+    addRelay: (url: string) => Promise<import("../command.js").Command>;
+    removeRelay: (url: string) => Promise<import("../command.js").Command>;
+}
+//# sourceMappingURL=roomLists.d.ts.map

package/dist/app/src/plugins/roomLists.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roomLists.d.ts","sourceRoot":"","sources":["../../../../src/plugins/roomLists.ts"],"names":[],"mappings":"AACA,OAAO,EAAW,cAAc,EAAE,cAAc,EAAC,MAAM,kBAAkB,CAAA;AACzE,OAAO,EAAC,aAAa,EAAc,MAAM,WAAW,CAAA;AACpD,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,WAAW,CAAA;AAIzC,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,WAAW,CAAA;AAEnC;;;;GAIG;AACH,qBAAa,SAAU,SAAQ,aAAa,CAAC,cAAc,CAAC;gBAC9C,GAAG,EAAE,IAAI;IAQrB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,GAAE,MAAM,EAAO;IAI/C,IAAI,GAAI,QAAQ,MAAM,KAAG,UAAU,CAAC,MAAM,EAAE,CAAC,CAAoD;IAEjG,YAAY,GAAI,QAAQ,MAAM,EAAE,KAAK,MAAM,KAAG,UAAU,CAAC,MAAM,EAAE,CAAC,CACL;IAE7D,aAAa,GAAI,KAAK,MAAM,KAAG,UAAU,CAAC,MAAM,EAAE,CAAC,CAGhD;IAEH,MAAM,GAAU,IAAI,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,8CAOnD;IAED,QAAQ,GAAI,SAAS,MAAM,EAAE,KAAK,MAAM,8CAAyD;IAEjG,WAAW,GAAI,SAAS,MAAM,EAAE,MAAM,MAAM,8CACa;IAEzD,QAAQ,GAAI,KAAK,MAAM,8CAAgD;IAEvE,WAAW,GAAI,KAAK,MAAM,8CAAmD;CAC9E"}

package/dist/app/src/plugins/roomLists.js

@@ -0,0 +1,37 @@
+import { ROOMS, normalizeRelayUrl } from "@welshman/util";
+import { RoomList } from "@welshman/domain";
+import { DerivedPlugin, projectFrom } from "./base.js";
+import { Network } from "./network.js";
+import { Domain } from "./domain.js";
+import { User } from "../user.js";
+/**
+ * NIP-51 kind-10009 room lists (relays the user belongs to, and groups on
+ * them), keyed by pubkey. Loaded via the outbox model (the author's write
+ * relays), so it depends on the relay-list collection.
+ */
+export class RoomLists extends DerivedPlugin {
+    constructor(app) {
+        super(app, {
+            filters: [{ kinds: [ROOMS] }],
+            eventToItem: app.use(Domain).reader(RoomList),
+            getKey: list => list.author(),
+        });
+    }
+    fetch(pubkey, relayHints = []) {
+        return this.app.use(Network).loadUsingOutbox(pubkey, { kinds: [ROOMS] }, relayHints);
+    }
+    urls = (pubkey) => this.project(pubkey, list => list?.urls() ?? []);
+    groupsForUrl = (pubkey, url) => this.project(pubkey, list => list?.groupsForUrl(url) ?? []);
+    pubkeysForUrl = (url) => projectFrom(this.all, lists => lists.filter(list => list.urls().includes(normalizeRelayUrl(url))).map(list => list.author()));
+    update = async (fn) => {
+        const user = User.require(this.app);
+        const writer = this.app.use(Domain).writer(RoomList, await this.forceLoad(user.pubkey));
+        fn(writer);
+        return this.app.use(Domain).command(writer);
+    };
+    addGroup = (groupId, url) => this.update(writer => writer.addGroup(groupId, url));
+    removeGroup = (groupId, url) => this.update(writer => writer.removeGroup(groupId, url));
+    addRelay = (url) => this.update(writer => writer.addRelay(url));
+    removeRelay = (url) => this.update(writer => writer.removeRelay(url));
+}
+//# sourceMappingURL=roomLists.js.map

package/dist/app/src/plugins/roomLists.js.map

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

package/dist/app/src/plugins/rooms.d.ts

@@ -0,0 +1,45 @@
+import { RoomMetaReader, RoomMembersReader, RoomAdminsReader } from "@welshman/domain";
+import { LoadableMapPlugin } from "./base.js";
+import type { Projection } from "./base.js";
+export declare const makeGroupKey: (url: string, group: string) => string;
+export declare const splitGroupKey: (key: string) => [string, string];
+export type Room = {
+    h: string;
+    id: string;
+    url: string;
+    meta?: RoomMetaReader;
+    members?: RoomMembersReader;
+    admins?: RoomAdminsReader;
+};
+export type RoomMeta = {
+    h: string;
+    name?: string;
+    about?: string;
+    picture?: string;
+    pictureMeta?: string[];
+    isClosed?: boolean;
+    isHidden?: boolean;
+    isPrivate?: boolean;
+    isRestricted?: boolean;
+    livekit?: boolean;
+};
+/**
+ * NIP-29 relay-based groups (rooms). A `${url}'${h}`-keyed collection whose
+ * values bundle a room's metadata, members, and admins. Also owns room management.
+ *
+ * The three group-state kinds are authored by the relay itself, so an event is
+ * only merged when its author matches the relay's NIP-11 `self` pubkey.
+ */
+export declare class Rooms extends LoadableMapPlugin<Room> {
+    fetch: (id: string) => Promise<Room>;
+    forGroup: (url: string, h: string) => import("svelte/store").Readable<import("@welshman/lib").Maybe<Room>>;
+    forUrl: (url: string) => Projection<Room[]>;
+    createRoom: (url: string, room: RoomMeta) => Promise<import("../command.js").Command>;
+    deleteRoom: (url: string, room: RoomMeta) => Promise<import("../command.js").Command>;
+    editRoom: (url: string, room: RoomMeta) => Promise<import("../command.js").Command>;
+    joinRoom: (url: string, room: RoomMeta) => Promise<import("../command.js").Command>;
+    leaveRoom: (url: string, room: RoomMeta) => Promise<import("../command.js").Command>;
+    addMember: (url: string, room: RoomMeta, pubkey: string) => Promise<import("../command.js").Command>;
+    removeMember: (url: string, room: RoomMeta, pubkey: string) => Promise<import("../command.js").Command>;
+}
+//# sourceMappingURL=rooms.d.ts.map

package/dist/app/src/plugins/rooms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rooms.d.ts","sourceRoot":"","sources":["../../../../src/plugins/rooms.ts"],"names":[],"mappings":"AAEA,OAAO,EAWL,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAC,iBAAiB,EAAc,MAAM,WAAW,CAAA;AACxD,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,WAAW,CAAA;AASzC,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,EAAE,OAAO,MAAM,WAAsB,CAAA;AAE7E,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM,KAAG,CAAC,MAAM,EAAE,MAAM,CAI1D,CAAA;AAKD,MAAM,MAAM,IAAI,GAAG;IACjB,CAAC,EAAE,MAAM,CAAA;IACT,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,cAAc,CAAA;IACrB,OAAO,CAAC,EAAE,iBAAiB,CAAA;IAC3B,MAAM,CAAC,EAAE,gBAAgB,CAAA;CAC1B,CAAA;AAGD,MAAM,MAAM,QAAQ,GAAG;IACrB,CAAC,EAAE,MAAM,CAAA;IACT,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAED;;;;;;GAMG;AACH,qBAAa,KAAM,SAAQ,iBAAiB,CAAC,IAAI,CAAC;IAChD,KAAK,GAAU,IAAI,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC,CA2BxC;IAED,QAAQ,GAAI,KAAK,MAAM,EAAE,GAAG,MAAM,0EAAmC;IAErE,MAAM,GAAI,KAAK,MAAM,KAAG,UAAU,CAAC,IAAI,EAAE,CAAC,CAKvC;IAEH,UAAU,GAAI,KAAK,MAAM,EAAE,MAAM,QAAQ,8CACoD;IAE7F,UAAU,GAAI,KAAK,MAAM,EAAE,MAAM,QAAQ,8CACoD;IAE7F,QAAQ,GAAI,KAAK,MAAM,EAAE,MAAM,QAAQ,8CAetC;IAED,QAAQ,GAAI,KAAK,MAAM,EAAE,MAAM,QAAQ,8CACoD;IAE3F,SAAS,GAAI,KAAK,MAAM,EAAE,MAAM,QAAQ,8CACoD;IAE5F,SAAS,GAAI,KAAK,MAAM,EAAE,MAAM,QAAQ,EAAE,QAAQ,MAAM,8CAGwC;IAEhG,YAAY,GAAI,KAAK,MAAM,EAAE,MAAM,QAAQ,EAAE,QAAQ,MAAM,8CAKtD;CACN"}

package/dist/app/src/plugins/rooms.js

@@ -0,0 +1,82 @@
+import { gt } from "@welshman/lib";
+import { ROOM_META, ROOM_MEMBERS, ROOM_ADMINS } from "@welshman/util";
+import { RoomCreate, RoomDelete, RoomEdit, RoomJoin, RoomLeave, RoomAddMember, RoomRemoveMember, RoomMeta as RoomMetaKind, RoomMembers, RoomAdmins, } from "@welshman/domain";
+import { LoadableMapPlugin, projectFrom } from "./base.js";
+import { Domain } from "./domain.js";
+import { Network } from "./network.js";
+import { Relays } from "./relays.js";
+// NIP-29 group metadata (kinds 39000–39002) is addressable per group but hosted
+// on a specific relay, so the same group id can exist independently on many
+// relays. Key it by `${url}'${group}` (the `'` separator matches flotilla's
+// room-id convention; relay urls never contain it).
+export const makeGroupKey = (url, group) => `${url}'${group}`;
+export const splitGroupKey = (key) => {
+    const i = key.indexOf("'");
+    return [key.slice(0, i), key.slice(i + 1)];
+};
+/**
+ * NIP-29 relay-based groups (rooms). A `${url}'${h}`-keyed collection whose
+ * values bundle a room's metadata, members, and admins. Also owns room management.
+ *
+ * The three group-state kinds are authored by the relay itself, so an event is
+ * only merged when its author matches the relay's NIP-11 `self` pubkey.
+ */
+export class Rooms extends LoadableMapPlugin {
+    fetch = async (id) => {
+        const [url, h] = splitGroupKey(id);
+        const relay = await this.app.use(Relays).load(url);
+        const room = this.get(id) ?? { id, url, h };
+        await this.app.use(Network).load({
+            relays: [url],
+            filters: [{ kinds: [ROOM_META, ROOM_MEMBERS, ROOM_ADMINS], "#d": [h] }],
+            onEvent: async (event) => {
+                if (event.pubkey !== relay?.self)
+                    return;
+                if (event.kind === ROOM_META && gt(event.created_at, room.meta?.createdAt())) {
+                    room.meta = await this.app.use(Domain).reader(RoomMetaKind)(event);
+                    this.set(id, room);
+                }
+                else if (event.kind === ROOM_MEMBERS && gt(event.created_at, room.members?.createdAt())) {
+                    room.members = await this.app.use(Domain).reader(RoomMembers)(event);
+                    this.set(id, room);
+                }
+                else if (event.kind === ROOM_ADMINS && gt(event.created_at, room.admins?.createdAt())) {
+                    room.admins = await this.app.use(Domain).reader(RoomAdmins)(event);
+                    this.set(id, room);
+                }
+            },
+        });
+        return room;
+    };
+    forGroup = (url, h) => this.one(makeGroupKey(url, h));
+    forUrl = (url) => projectFrom(this.index, byKey => Array.from(byKey.entries())
+        .filter(([key]) => key.startsWith(`${url}'`))
+        .map(([, room]) => room));
+    createRoom = (url, room) => this.app.use(Domain).command(this.app.use(Domain).writer(RoomCreate).setGroup(url, room.h));
+    deleteRoom = (url, room) => this.app.use(Domain).command(this.app.use(Domain).writer(RoomDelete).setGroup(url, room.h));
+    editRoom = (url, room) => {
+        const writer = this.app.use(Domain).writer(RoomEdit).setGroup(url, room.h);
+        if (room.name)
+            writer.setName(room.name);
+        if (room.about)
+            writer.setAbout(room.about);
+        if (room.picture)
+            writer.setPicture(room.picture, room.pictureMeta);
+        writer
+            .setClosed(Boolean(room.isClosed))
+            .setHidden(Boolean(room.isHidden))
+            .setPrivate(Boolean(room.isPrivate))
+            .setRestricted(Boolean(room.isRestricted))
+            .setLivekit(Boolean(room.livekit));
+        return this.app.use(Domain).command(writer);
+    };
+    joinRoom = (url, room) => this.app.use(Domain).command(this.app.use(Domain).writer(RoomJoin).setGroup(url, room.h));
+    leaveRoom = (url, room) => this.app.use(Domain).command(this.app.use(Domain).writer(RoomLeave).setGroup(url, room.h));
+    addMember = (url, room, pubkey) => this.app
+        .use(Domain)
+        .command(this.app.use(Domain).writer(RoomAddMember).setGroup(url, room.h).addPubkey(pubkey));
+    removeMember = (url, room, pubkey) => this.app
+        .use(Domain)
+        .command(this.app.use(Domain).writer(RoomRemoveMember).setGroup(url, room.h).addPubkey(pubkey));
+}
+//# sourceMappingURL=rooms.js.map

package/dist/app/src/plugins/rooms.js.map

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

package/dist/app/src/plugins/router.d.ts

@@ -0,0 +1,25 @@
+import { Resolver } from "@welshman/util";
+import type { RelayRoute, RelaySelection } from "@welshman/util";
+import type { FeedRouter } from "@welshman/feeds";
+import type { IApp } from "../app.js";
+/**
+ * The app's relay router. Reach it via `app.use(Router)`.
+ *
+ * `resolve(selections)` turns the declarative `RelaySelection` DSL (from
+ * `@welshman/util`) into a scored `RelayScenario`. `resolver` turns a single
+ * declarative route into concrete urls (the domain kinds' resolver, injected via
+ * `app.use(Domain)`).
+ */
+export declare class Router implements FeedRouter {
+    readonly app: IApp;
+    resolver: Resolver;
+    constructor(app: IApp);
+    resolve: (selections: RelaySelection[]) => Promise<import("@welshman/util").RelayScenario>;
+    resolveRoute: (route: RelayRoute) => string[] | Promise<string[]>;
+    private inboxRelays;
+    private outboxRelays;
+    private messagingRelays;
+    private resolveEvent;
+    private resolveSeen;
+}
+//# sourceMappingURL=router.d.ts.map

package/dist/app/src/plugins/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../../../src/plugins/router.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,QAAQ,EAA6B,MAAM,gBAAgB,CAAA;AACnE,OAAO,KAAK,EAAC,UAAU,EAAE,cAAc,EAAW,MAAM,gBAAgB,CAAA;AACxE,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,iBAAiB,CAAA;AAK/C,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,WAAW,CAAA;AAEnC;;;;;;;GAOG;AACH,qBAAa,MAAO,YAAW,UAAU;IAG3B,QAAQ,CAAC,GAAG,EAAE,IAAI;IAF9B,QAAQ,EAAE,QAAQ,CAAA;gBAEG,GAAG,EAAE,IAAI;IAQ9B,OAAO,GAAI,YAAY,cAAc,EAAE,qDAAuC;IAG9E,YAAY,GAAI,OAAO,UAAU,kCA2BhC;IAGD,OAAO,CAAC,WAAW,CAC8D;IAGjF,OAAO,CAAC,YAAY,CAC8D;IAGlF,OAAO,CAAC,eAAe,CAC+D;IAKtF,OAAO,CAAC,YAAY,CAmBnB;IAID,OAAO,CAAC,WAAW,CAelB;CACF"}

package/dist/app/src/plugins/router.js

@@ -0,0 +1,95 @@
+import { uniq } from "@welshman/lib";
+import { Resolver, Address, isReplaceableKind } from "@welshman/util";
+import { RelayLists } from "./relayLists.js";
+import { MessagingRelayLists } from "./messagingRelayLists.js";
+import { RelayStats } from "./relayStats.js";
+import { User } from "../user.js";
+/**
+ * The app's relay router. Reach it via `app.use(Router)`.
+ *
+ * `resolve(selections)` turns the declarative `RelaySelection` DSL (from
+ * `@welshman/util`) into a scored `RelayScenario`. `resolver` turns a single
+ * declarative route into concrete urls (the domain kinds' resolver, injected via
+ * `app.use(Domain)`).
+ */
+export class Router {
+    app;
+    resolver;
+    constructor(app) {
+        this.app = app;
+        this.resolver = new Resolver(this.resolveRoute, {
+            getRelayQuality: url => this.app.use(RelayStats).getQuality(url),
+            getDefaultRelays: this.app.config.getDefaultRelays,
+        });
+    }
+    // Resolve selections into a scored `RelayScenario`
+    resolve = (selections) => this.resolver.scenario(selections);
+    // Resolve a single route into concrete relay urls.
+    resolveRoute = (route) => {
+        switch (route.type) {
+            case "userInbox":
+                return this.inboxRelays(User.require(this.app).pubkey);
+            case "userOutbox":
+                return this.outboxRelays(User.require(this.app).pubkey);
+            case "userMessaging":
+                return this.messagingRelays(User.require(this.app).pubkey);
+            case "pubkeyInbox":
+                return this.inboxRelays(route.pubkey);
+            case "pubkeyOutbox":
+                return this.outboxRelays(route.pubkey);
+            case "pubkeyMessaging":
+                return this.messagingRelays(route.pubkey);
+            case "eventInbox":
+                return this.resolveEvent(route.ref, this.inboxRelays);
+            case "eventOutbox":
+                return this.resolveEvent(route.ref, this.outboxRelays);
+            case "seen":
+                return this.resolveSeen(route.ref);
+            case "index":
+                return this.app.config.getIndexerRelays?.() ?? [];
+            case "search":
+                return this.app.config.getSearchRelays?.() ?? [];
+            case "relay":
+                return [route.url];
+        }
+    };
+    // A pubkey's read relays (its inbox — where to deliver so it receives events).
+    inboxRelays = async (pubkey) => pubkey ? ((await this.app.use(RelayLists).load(pubkey))?.readUrls() ?? []) : [];
+    // A pubkey's write relays (its outbox — where its events live).
+    outboxRelays = async (pubkey) => pubkey ? ((await this.app.use(RelayLists).load(pubkey))?.writeUrls() ?? []) : [];
+    // A pubkey's NIP-17 messaging relays.
+    messagingRelays = async (pubkey) => pubkey ? ((await this.app.use(MessagingRelayLists).load(pubkey))?.urls() ?? []) : [];
+    // Resolve an event reference to a pubkey's relays: route directly to a known
+    // pubkey, else look the event up in the repository to find its author, else fall
+    // back to any relay hints on the reference.
+    resolveEvent = async (ref, getRelays) => {
+        const relays = ref.relays ? [...ref.relays] : [];
+        if (ref.pubkey) {
+            relays.push(...(await getRelays(ref.pubkey)));
+        }
+        if (ref.id) {
+            const event = this.app.repository.getEvent(ref.id);
+            if (event) {
+                relays.push(...(await getRelays(event.pubkey)));
+            }
+        }
+        return uniq(relays);
+    };
+    // Relays an event was found on: the tracker's record (keyed by event id) plus
+    // any relay hints carried on the reference.
+    resolveSeen = (ref) => {
+        const relays = ref.relays ? [...ref.relays] : [];
+        if (ref.id) {
+            relays.push(...this.app.tracker.getRelays(ref.id));
+        }
+        else if (ref.pubkey && ref.kind !== undefined && isReplaceableKind(ref.kind)) {
+            const address = new Address(ref.kind, ref.pubkey, ref.identifier ?? "").toString();
+            const event = this.app.repository.getEvent(address);
+            if (event) {
+                relays.push(...this.app.tracker.getRelays(event.id));
+            }
+        }
+        return relays;
+    };
+}
+//# sourceMappingURL=router.js.map