@welshman/app 0.8.16 → 0.9.0-pre2

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

@@ -0,0 +1,47 @@
+import { Pool, Tracker, Repository, WrapManager } from "@welshman/net";
+import type { NetContext, AdapterFactory } from "@welshman/net";
+import type { User } from "./user.js";
+import type { AppPolicy } from "./policy.js";
+export type AppConfig = {
+    dufflepudUrl?: string;
+    getDefaultRelays?: () => string[];
+    getIndexerRelays?: () => string[];
+    getSearchRelays?: () => string[];
+};
+export type AppOptions = {
+    user?: User;
+    config?: AppConfig;
+    getAdapter?: AdapterFactory;
+    policies?: AppPolicy[];
+};
+export interface IApp {
+    user?: User;
+    config: AppConfig;
+    use: <T>(Ctor: new (app: IApp) => T) => T;
+    netContext: NetContext;
+    pool: Pool;
+    tracker: Tracker;
+    repository: Repository;
+    wrapManager: WrapManager;
+}
+/**
+ * The core of an application instance. Owns the primitives a single identity
+ * needs (so data never bleeds across sessions) — a private repository, a socket
+ * pool, a tracker, a wrap manager — and a `use` registry that resolves data
+ * modules (including net/store helpers) on demand.
+ */
+export declare class App implements IApp {
+    user?: User;
+    config: AppConfig;
+    netContext: NetContext;
+    pool: Pool;
+    tracker: Tracker;
+    repository: Repository;
+    wrapManager: WrapManager;
+    private singletons;
+    private unsubscribers;
+    constructor(options?: AppOptions);
+    use: <T>(Ctor: new (app: IApp) => T) => T;
+    cleanup(): void;
+}
+//# sourceMappingURL=app.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../../src/app.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAC,MAAM,eAAe,CAAA;AACpE,OAAO,KAAK,EAAC,UAAU,EAAE,cAAc,EAAC,MAAM,eAAe,CAAA;AAC7D,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,WAAW,CAAA;AACnC,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,aAAa,CAAA;AAE1C,MAAM,MAAM,SAAS,GAAG;IACtB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,gBAAgB,CAAC,EAAE,MAAM,MAAM,EAAE,CAAA;IACjC,gBAAgB,CAAC,EAAE,MAAM,MAAM,EAAE,CAAA;IACjC,eAAe,CAAC,EAAE,MAAM,MAAM,EAAE,CAAA;CACjC,CAAA;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,CAAC,EAAE,IAAI,CAAA;IACX,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB,UAAU,CAAC,EAAE,cAAc,CAAA;IAC3B,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAA;CACvB,CAAA;AAED,MAAM,WAAW,IAAI;IACnB,IAAI,CAAC,EAAE,IAAI,CAAA;IACX,MAAM,EAAE,SAAS,CAAA;IACjB,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,GAAG,EAAE,IAAI,KAAK,CAAC,KAAK,CAAC,CAAA;IACzC,UAAU,EAAE,UAAU,CAAA;IACtB,IAAI,EAAE,IAAI,CAAA;IACV,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,UAAU,CAAA;IACtB,WAAW,EAAE,WAAW,CAAA;CACzB;AAED;;;;;GAKG;AACH,qBAAa,GAAI,YAAW,IAAI;IAC9B,IAAI,CAAC,EAAE,IAAI,CAAA;IACX,MAAM,EAAE,SAAS,CAAA;IACjB,UAAU,EAAE,UAAU,CAAA;IACtB,IAAI,EAAE,IAAI,CAAA;IACV,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,UAAU,CAAA;IACtB,WAAW,EAAE,WAAW,CAAA;IAExB,OAAO,CAAC,UAAU,CAAiD;IACnE,OAAO,CAAC,aAAa,CAAqB;gBAE9B,OAAO,GAAE,UAAe;IAwBpC,GAAG,GAAI,CAAC,EAAE,MAAM,KAAK,GAAG,EAAE,IAAI,KAAK,CAAC,KAAG,CAAC,CAQvC;IAED,OAAO;CAOR"}

package/dist/app/src/app.js

@@ -0,0 +1,56 @@
+import { call } from "@welshman/lib";
+import { Pool, Tracker, Repository, WrapManager } from "@welshman/net";
+/**
+ * The core of an application instance. Owns the primitives a single identity
+ * needs (so data never bleeds across sessions) — a private repository, a socket
+ * pool, a tracker, a wrap manager — and a `use` registry that resolves data
+ * modules (including net/store helpers) on demand.
+ */
+export class App {
+    user;
+    config;
+    netContext;
+    pool;
+    tracker;
+    repository;
+    wrapManager;
+    singletons = new Map();
+    unsubscribers = [];
+    constructor(options = {}) {
+        this.user = options.user;
+        this.config = options.config ?? {};
+        this.pool = new Pool();
+        this.tracker = new Tracker();
+        this.repository = new Repository();
+        this.wrapManager = new WrapManager({
+            tracker: this.tracker,
+            repository: this.repository,
+        });
+        this.netContext = {
+            pool: this.pool,
+            repository: this.repository,
+            getAdapter: options.getAdapter,
+        };
+        for (const policy of options.policies ?? []) {
+            this.unsubscribers.push(policy(this));
+        }
+    }
+    // Resolve the per-app singleton of a data module, constructing it on first
+    // use. This is how modules reach their dependencies (e.g. app.use(RelayLists)),
+    // replacing constructor injection and letting cycles resolve lazily.
+    use = (Ctor) => {
+        let instance = this.singletons.get(Ctor);
+        if (!instance) {
+            this.singletons.set(Ctor, (instance = new Ctor(this)));
+        }
+        return instance;
+    };
+    cleanup() {
+        this.unsubscribers.forEach(call);
+        this.pool.clear();
+        this.tracker.clear();
+        this.repository.clear();
+        this.wrapManager.clear();
+    }
+}
+//# sourceMappingURL=app.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../../../src/app.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,IAAI,EAAC,MAAM,eAAe,CAAA;AAClC,OAAO,EAAC,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAC,MAAM,eAAe,CAAA;AA8BpE;;;;;GAKG;AACH,MAAM,OAAO,GAAG;IACd,IAAI,CAAO;IACX,MAAM,CAAW;IACjB,UAAU,CAAY;IACtB,IAAI,CAAM;IACV,OAAO,CAAS;IAChB,UAAU,CAAY;IACtB,WAAW,CAAa;IAEhB,UAAU,GAAG,IAAI,GAAG,EAAuC,CAAA;IAC3D,aAAa,GAAmB,EAAE,CAAA;IAE1C,YAAY,UAAsB,EAAE;QAClC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAA;QACxB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,CAAA;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,EAAE,CAAA;QACtB,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,EAAE,CAAA;QAC5B,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,EAAE,CAAA;QAClC,IAAI,CAAC,WAAW,GAAG,IAAI,WAAW,CAAC;YACjC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC,CAAA;QACF,IAAI,CAAC,UAAU,GAAG;YAChB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,UAAU,EAAE,OAAO,CAAC,UAAU;SAC/B,CAAA;QAED,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;YAC5C,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;QACvC,CAAC;IACH,CAAC;IAED,2EAA2E;IAC3E,gFAAgF;IAChF,qEAAqE;IACrE,GAAG,GAAG,CAAI,IAA0B,EAAK,EAAE;QACzC,IAAI,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAkB,CAAA;QAEzD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,QAAQ,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACxD,CAAC;QAED,OAAO,QAAQ,CAAA;IACjB,CAAC,CAAA;IAED,OAAO;QACL,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QAChC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAA;QACjB,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAA;QACpB,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAA;QACvB,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAA;IAC1B,CAAC;CACF"}

package/dist/app/src/command.d.ts

@@ -0,0 +1,26 @@
+import type { EventTemplate } from "@welshman/util";
+import type { IApp } from "./app.js";
+/**
+ * An event paired with the relays it's meant for, without committing to how
+ * it gets published. Plugin mutation methods (`create`/`update`/etc.) build
+ * the event and return a `Command` instead of publishing it directly, so the
+ * caller decides: `publish()` sends it through the normal `Thunks` pipeline,
+ * `publishToRelays(urls)` targets a specific set of relays, and
+ * `publishAsRelay(url)` has the relay sign the event with its own key (NIP-86
+ * `signevent`) before publishing it back to that relay.
+ */
+export declare class Command {
+    readonly app: IApp;
+    readonly event: EventTemplate;
+    readonly relays: string[];
+    constructor(app: IApp, event: EventTemplate, relays: string[]);
+    publish: () => import("./index.js").Thunk;
+    publishToRelays: (urls: string[]) => import("./index.js").Thunk;
+    publishAsRelay: (url: string) => Promise<import("./index.js").Thunk>;
+    signAsRelay: (url: string) => Promise<import("@welshman/util").ManagementResponse>;
+}
+export declare const publish: (command: Command) => import("./index.js").Thunk;
+export declare const publishToRelays: (urls: string[]) => (command: Command) => import("./index.js").Thunk;
+export declare const publishAsRelay: (url: string) => (command: Command) => Promise<import("./index.js").Thunk>;
+export declare const signAsRelay: (url: string) => (command: Command) => Promise<import("@welshman/util").ManagementResponse>;
+//# sourceMappingURL=command.d.ts.map

package/dist/app/src/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../src/command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,gBAAgB,CAAA;AACjD,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,UAAU,CAAA;AAIlC;;;;;;;;GAQG;AACH,qBAAa,OAAO;IAEhB,QAAQ,CAAC,GAAG,EAAE,IAAI;IAClB,QAAQ,CAAC,KAAK,EAAE,aAAa;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE;gBAFhB,GAAG,EAAE,IAAI,EACT,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,MAAM,EAAE;IAG3B,OAAO,mCAA0C;IAEjD,eAAe,GAAI,MAAM,MAAM,EAAE,gCACgC;IAIjE,cAAc,GAAU,KAAK,MAAM,yCAQlC;IAED,WAAW,GAAI,KAAK,MAAM,0DAAoE;CAC/F;AAED,eAAO,MAAM,OAAO,GAAI,SAAS,OAAO,+BAAsB,CAAA;AAE9D,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,EAAE,MAAM,SAAS,OAAO,+BACrC,CAAA;AAE/B,eAAO,MAAM,cAAc,GAAI,KAAK,MAAM,MAAM,SAAS,OAAO,wCAAgC,CAAA;AAEhG,eAAO,MAAM,WAAW,GAAI,KAAK,MAAM,MAAM,SAAS,OAAO,yDAA6B,CAAA"}

package/dist/app/src/command.js

@@ -0,0 +1,38 @@
+import { Thunks } from "./plugins/thunk.js";
+import { RelayManagement } from "./plugins/relayManagement.js";
+/**
+ * An event paired with the relays it's meant for, without committing to how
+ * it gets published. Plugin mutation methods (`create`/`update`/etc.) build
+ * the event and return a `Command` instead of publishing it directly, so the
+ * caller decides: `publish()` sends it through the normal `Thunks` pipeline,
+ * `publishToRelays(urls)` targets a specific set of relays, and
+ * `publishAsRelay(url)` has the relay sign the event with its own key (NIP-86
+ * `signevent`) before publishing it back to that relay.
+ */
+export class Command {
+    app;
+    event;
+    relays;
+    constructor(app, event, relays) {
+        this.app = app;
+        this.event = event;
+        this.relays = relays;
+    }
+    publish = () => this.publishToRelays(this.relays);
+    publishToRelays = (urls) => this.app.use(Thunks).publish({ event: this.event, relays: urls });
+    // Ask the relay to sign the event with its own key via NIP-86 `signevent`,
+    // then publish the relay-signed event back to that relay.
+    publishAsRelay = async (url) => {
+        const { result, error } = await this.signAsRelay(url);
+        if (!result) {
+            throw new Error(error || "Relay did not return a signed event");
+        }
+        return this.app.use(Thunks).publish({ event: result, relays: [url] });
+    };
+    signAsRelay = (url) => this.app.use(RelayManagement).forUrl(url).signEvent(this.event);
+}
+export const publish = (command) => command.publish();
+export const publishToRelays = (urls) => (command) => command.publishToRelays(urls);
+export const publishAsRelay = (url) => (command) => command.publishAsRelay(url);
+export const signAsRelay = (url) => (command) => command.signAsRelay(url);
+//# sourceMappingURL=command.js.map

package/dist/app/src/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../../src/command.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,MAAM,EAAC,MAAM,oBAAoB,CAAA;AACzC,OAAO,EAAC,eAAe,EAAC,MAAM,8BAA8B,CAAA;AAE5D;;;;;;;;GAQG;AACH,MAAM,OAAO,OAAO;IAEP;IACA;IACA;IAHX,YACW,GAAS,EACT,KAAoB,EACpB,MAAgB;QAFhB,QAAG,GAAH,GAAG,CAAM;QACT,UAAK,GAAL,KAAK,CAAe;QACpB,WAAM,GAAN,MAAM,CAAU;IACxB,CAAC;IAEJ,OAAO,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IAEjD,eAAe,GAAG,CAAC,IAAc,EAAE,EAAE,CACnC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAC,CAAC,CAAA;IAEjE,2EAA2E;IAC3E,0DAA0D;IAC1D,cAAc,GAAG,KAAK,EAAE,GAAW,EAAE,EAAE;QACrC,MAAM,EAAC,MAAM,EAAE,KAAK,EAAC,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;QAEnD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,KAAK,IAAI,qCAAqC,CAAC,CAAA;QACjE,CAAC;QAED,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,EAAC,CAAC,CAAA;IACrE,CAAC,CAAA;IAED,WAAW,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;CAC/F;AAED,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,OAAgB,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,CAAA;AAE9D,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAc,EAAE,EAAE,CAAC,CAAC,OAAgB,EAAE,EAAE,CACtE,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;AAE/B,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,CAAC,OAAgB,EAAE,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,CAAA;AAEhG,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,CAAC,OAAgB,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA"}

package/dist/app/src/createApp.d.ts

@@ -0,0 +1,12 @@
+import { App } from "./app.js";
+import type { AppOptions } from "./app.js";
+/**
+ * Creates a batteries-included app: an `App` wired with the default app
+ * policies (event ingestion, relay-stats collection, gift-wrap unwrapping).
+ * Reach data modules via `app.use(Profiles)`, `app.use(FollowLists)`, etc.
+ *
+ * For a bare app (no default side effects) construct `new App(...)`
+ * directly, or pass your own `policies`.
+ */
+export declare const createApp: (options?: AppOptions) => App;
+//# sourceMappingURL=createApp.d.ts.map

package/dist/app/src/createApp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createApp.d.ts","sourceRoot":"","sources":["../../../src/createApp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,GAAG,EAAC,MAAM,UAAU,CAAA;AAC5B,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,UAAU,CAAA;AAGxC;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,GAAI,UAAS,UAAe,QACuB,CAAA"}

package/dist/app/src/createApp.js

@@ -0,0 +1,12 @@
+import { App } from "./app.js";
+import { defaultAppPolicies } from "./policy.js";
+/**
+ * Creates a batteries-included app: an `App` wired with the default app
+ * policies (event ingestion, relay-stats collection, gift-wrap unwrapping).
+ * Reach data modules via `app.use(Profiles)`, `app.use(FollowLists)`, etc.
+ *
+ * For a bare app (no default side effects) construct `new App(...)`
+ * directly, or pass your own `policies`.
+ */
+export const createApp = (options = {}) => new App({ ...options, policies: options.policies ?? defaultAppPolicies });
+//# sourceMappingURL=createApp.js.map

package/dist/app/src/createApp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createApp.js","sourceRoot":"","sources":["../../../src/createApp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,GAAG,EAAC,MAAM,UAAU,CAAA;AAE5B,OAAO,EAAC,kBAAkB,EAAC,MAAM,aAAa,CAAA;AAE9C;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,UAAsB,EAAE,EAAE,EAAE,CACpD,IAAI,GAAG,CAAC,EAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,kBAAkB,EAAC,CAAC,CAAA"}

package/dist/app/src/index.d.ts

@@ -1,29 +1,41 @@
-export * from "./blossom.js";
-export * from "./context.js";
-export * from "./core.js";
-export * from "./commands.js";
-export * from "./feeds.js";
-export * from "./follows.js";
-export * from "./handles.js";
-export * from "./mutes.js";
-export * from "./plaintext.js";
-export * from "./profiles.js";
-export * from "./pins.js";
-export * from "./relays.js";
-export * from "./relayStats.js";
-export * from "./relayLists.js";
-export * from "./blockedRelayLists.js";
-export * from "./messagingRelayLists.js";
-export * from "./search.js";
-export * from "./session.js";
-export * from "./sync.js";
-export * from "./tags.js";
-export * from "./thunk.js";
-export * from "./topics.js";
+export * from "./app.js";
+export * from "./command.js";
+export * from "./policy.js";
 export * from "./user.js";
-export * from "./wot.js";
-export * from "./zappers.js";
-import { RelayMode } from "@welshman/util";
-export declare const getPubkeyRelays: (pubkey: string, mode?: RelayMode) => string[];
-export declare const derivePubkeyRelays: (pubkey: string, mode?: RelayMode) => import("svelte/store").Readable<string[]>;
+export * from "./session.js";
+export * from "./createApp.js";
+export * from "./plugins/base.js";
+export * from "./plugins/network.js";
+export * from "./plugins/router.js";
+export * from "./plugins/domain.js";
+export * from "./plugins/relays.js";
+export * from "./plugins/relayStats.js";
+export * from "./plugins/relayLists.js";
+export * from "./plugins/blockedRelayLists.js";
+export * from "./plugins/logger.js";
+export * from "./plugins/plaintext.js";
+export * from "./plugins/profiles.js";
+export * from "./plugins/followLists.js";
+export * from "./plugins/muteLists.js";
+export * from "./plugins/pins.js";
+export * from "./plugins/pinboards.js";
+export * from "./plugins/roomLists.js";
+export * from "./plugins/reactions.js";
+export * from "./plugins/deletes.js";
+export * from "./plugins/blossomServerLists.js";
+export * from "./plugins/messagingRelayLists.js";
+export * from "./plugins/searchRelayLists.js";
+export * from "./plugins/handles.js";
+export * from "./plugins/zappers.js";
+export * from "./plugins/topics.js";
+export * from "./plugins/wot.js";
+export * from "./plugins/feeds.js";
+export * from "./plugins/feedLists.js";
+export * from "./plugins/sync.js";
+export * from "./plugins/wraps.js";
+export * from "./plugins/rooms.js";
+export * from "./plugins/relayRoles.js";
+export * from "./plugins/relayMembers.js";
+export * from "./plugins/relayManagement.js";
+export * from "./plugins/thunk.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/app/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,wBAAwB,CAAA;AACtC,cAAc,0BAA0B,CAAA;AACxC,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA;AAI5B,OAAO,EAIL,SAAS,EAGV,MAAM,gBAAgB,CAAA;AAsDvB,eAAO,MAAM,eAAe,GAAI,QAAQ,MAAM,EAAE,OAAO,SAAS,aAK/D,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAI,QAAQ,MAAM,EAAE,OAAO,SAAS,8CAQlE,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA;AACjC,cAAc,sBAAsB,CAAA;AACpC,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,yBAAyB,CAAA;AACvC,cAAc,yBAAyB,CAAA;AACvC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,qBAAqB,CAAA;AACnC,cAAc,wBAAwB,CAAA;AACtC,cAAc,uBAAuB,CAAA;AACrC,cAAc,0BAA0B,CAAA;AACxC,cAAc,wBAAwB,CAAA;AACtC,cAAc,mBAAmB,CAAA;AACjC,cAAc,wBAAwB,CAAA;AACtC,cAAc,wBAAwB,CAAA;AACtC,cAAc,wBAAwB,CAAA;AACtC,cAAc,sBAAsB,CAAA;AACpC,cAAc,iCAAiC,CAAA;AAC/C,cAAc,kCAAkC,CAAA;AAChD,cAAc,+BAA+B,CAAA;AAC7C,cAAc,sBAAsB,CAAA;AACpC,cAAc,sBAAsB,CAAA;AACpC,cAAc,qBAAqB,CAAA;AACnC,cAAc,kBAAkB,CAAA;AAChC,cAAc,oBAAoB,CAAA;AAClC,cAAc,wBAAwB,CAAA;AACtC,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,yBAAyB,CAAA;AACvC,cAAc,2BAA2B,CAAA;AACzC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,oBAAoB,CAAA"}

package/dist/app/src/index.js

@@ -1,94 +1,41 @@
-export * from "./blossom.js";
-export * from "./context.js";
-export * from "./core.js";
-export * from "./commands.js";
-export * from "./feeds.js";
-export * from "./follows.js";
-export * from "./handles.js";
-export * from "./mutes.js";
-export * from "./plaintext.js";
-export * from "./profiles.js";
-export * from "./pins.js";
-export * from "./relays.js";
-export * from "./relayStats.js";
-export * from "./relayLists.js";
-export * from "./blockedRelayLists.js";
-export * from "./messagingRelayLists.js";
-export * from "./search.js";
-export * from "./session.js";
-export * from "./sync.js";
-export * from "./tags.js";
-export * from "./thunk.js";
-export * from "./topics.js";
+export * from "./app.js";
+export * from "./command.js";
+export * from "./policy.js";
 export * from "./user.js";
-export * from "./wot.js";
-export * from "./zappers.js";
-import { derived } from "svelte/store";
-import { sortBy, throttleWithValue } from "@welshman/lib";
-import { isEphemeralKind, isDVMKind, WRAP, RelayMode, getRelaysFromList, } from "@welshman/util";
-import { routerContext } from "@welshman/router";
-import { Pool, SocketEvent, isRelayEvent, netContext } from "@welshman/net";
-import { pubkey, unwrapAndStore } from "./session.js";
-import { repository, tracker } from "./core.js";
-import { getRelays, loadRelay } from "./relays.js";
-import { trackRelayStats, getRelayQuality } from "./relayStats.js";
-import { deriveRelayList, getRelayList } from "./relayLists.js";
-import { deriveSearchRelayList, getSearchRelayList } from "./searchRelayLists.js";
-import { deriveBlockedRelayList, getBlockedRelayList } from "./blockedRelayLists.js";
-import { deriveMessagingRelayList, getMessagingRelayList } from "./messagingRelayLists.js";
-// Sync relays with our database
-Pool.get().subscribe(socket => {
-    loadRelay(socket.url);
-    trackRelayStats(socket);
-    socket.on(SocketEvent.Receive, message => {
-        if (isRelayEvent(message)) {
-            const event = message[2];
-            if (!isDVMKind(event.kind) &&
-                !isEphemeralKind(event.kind) &&
-                netContext.isEventValid(event, socket.url)) {
-                tracker.track(event.id, socket.url);
-                if (event.kind === WRAP) {
-                    unwrapAndStore(event);
-                }
-                else {
-                    repository.publish(event);
-                }
-            }
-        }
-    });
-});
-// Configure the router and add a few other relay utils
-const _relayGetter = (fn) => throttleWithValue(200, () => {
-    let _relays = getRelays();
-    if (fn) {
-        _relays = _relays.filter(fn);
-    }
-    return sortBy(r => -getRelayQuality(r.url), _relays)
-        .slice(0, 5)
-        .map(r => r.url);
-});
-export const getPubkeyRelays = (pubkey, mode) => {
-    if (mode === RelayMode.Search)
-        return getRelaysFromList(getSearchRelayList(pubkey));
-    if (mode === RelayMode.Blocked)
-        return getRelaysFromList(getBlockedRelayList(pubkey));
-    if (mode === RelayMode.Messaging)
-        return getRelaysFromList(getMessagingRelayList(pubkey));
-    return getRelaysFromList(getRelayList(pubkey), mode);
-};
-export const derivePubkeyRelays = (pubkey, mode) => {
-    if (mode === RelayMode.Search)
-        return derived(deriveSearchRelayList(pubkey), list => getRelaysFromList(list));
-    if (mode === RelayMode.Blocked)
-        return derived(deriveBlockedRelayList(pubkey), list => getRelaysFromList(list));
-    if (mode === RelayMode.Messaging)
-        return derived(deriveMessagingRelayList(pubkey), list => getRelaysFromList(list));
-    return derived(deriveRelayList(pubkey), list => getRelaysFromList(list, mode));
-};
-routerContext.getUserPubkey = () => pubkey.get();
-routerContext.getPubkeyRelays = getPubkeyRelays;
-routerContext.getRelayQuality = getRelayQuality;
-routerContext.getDefaultRelays = _relayGetter();
-routerContext.getIndexerRelays = _relayGetter();
-routerContext.getSearchRelays = _relayGetter(r => r?.supported_nips?.includes?.("50"));
+export * from "./session.js";
+export * from "./createApp.js";
+export * from "./plugins/base.js";
+export * from "./plugins/network.js";
+export * from "./plugins/router.js";
+export * from "./plugins/domain.js";
+export * from "./plugins/relays.js";
+export * from "./plugins/relayStats.js";
+export * from "./plugins/relayLists.js";
+export * from "./plugins/blockedRelayLists.js";
+export * from "./plugins/logger.js";
+export * from "./plugins/plaintext.js";
+export * from "./plugins/profiles.js";
+export * from "./plugins/followLists.js";
+export * from "./plugins/muteLists.js";
+export * from "./plugins/pins.js";
+export * from "./plugins/pinboards.js";
+export * from "./plugins/roomLists.js";
+export * from "./plugins/reactions.js";
+export * from "./plugins/deletes.js";
+export * from "./plugins/blossomServerLists.js";
+export * from "./plugins/messagingRelayLists.js";
+export * from "./plugins/searchRelayLists.js";
+export * from "./plugins/handles.js";
+export * from "./plugins/zappers.js";
+export * from "./plugins/topics.js";
+export * from "./plugins/wot.js";
+export * from "./plugins/feeds.js";
+export * from "./plugins/feedLists.js";
+export * from "./plugins/sync.js";
+export * from "./plugins/wraps.js";
+export * from "./plugins/rooms.js";
+export * from "./plugins/relayRoles.js";
+export * from "./plugins/relayMembers.js";
+export * from "./plugins/relayManagement.js";
+export * from "./plugins/thunk.js";
 //# sourceMappingURL=index.js.map

package/dist/app/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA;AACjC,cAAc,sBAAsB,CAAA;AACpC,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,yBAAyB,CAAA;AACvC,cAAc,yBAAyB,CAAA;AACvC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,qBAAqB,CAAA;AACnC,cAAc,wBAAwB,CAAA;AACtC,cAAc,uBAAuB,CAAA;AACrC,cAAc,0BAA0B,CAAA;AACxC,cAAc,wBAAwB,CAAA;AACtC,cAAc,mBAAmB,CAAA;AACjC,cAAc,wBAAwB,CAAA;AACtC,cAAc,wBAAwB,CAAA;AACtC,cAAc,wBAAwB,CAAA;AACtC,cAAc,sBAAsB,CAAA;AACpC,cAAc,iCAAiC,CAAA;AAC/C,cAAc,kCAAkC,CAAA;AAChD,cAAc,+BAA+B,CAAA;AAC7C,cAAc,sBAAsB,CAAA;AACpC,cAAc,sBAAsB,CAAA;AACpC,cAAc,qBAAqB,CAAA;AACnC,cAAc,kBAAkB,CAAA;AAChC,cAAc,oBAAoB,CAAA;AAClC,cAAc,wBAAwB,CAAA;AACtC,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,yBAAyB,CAAA;AACvC,cAAc,2BAA2B,CAAA;AACzC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,oBAAoB,CAAA"}

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

@@ -0,0 +1,133 @@
+import type { IFuseOptions, FuseResult } from "fuse.js";
+import type { Readable, Unsubscriber } from "svelte/store";
+import type { Maybe } from "@welshman/lib";
+import type { Filter } from "@welshman/util";
+import type { EventToItem, ItemsByKey, MakeLoadItemOptions } from "@welshman/store";
+import type { IApp } from "../app.js";
+/**
+ * Utility type which allows for using the same value both for hot gets and derived subscriptions
+ */
+export type Projection<T> = {
+    get: () => T;
+    $: Readable<T>;
+};
+export type SearchOptions<V, T> = {
+    getValue: (item: T) => V;
+    fuseOptions?: IFuseOptions<T>;
+    onSearch?: (term: string) => void;
+    sortFn?: (items: FuseResult<T>) => any;
+};
+export type Search<V, T> = {
+    options: T[];
+    getValue: (item: T) => V;
+    getOption: (value: V) => T | undefined;
+    searchOptions: (term: string) => T[];
+    searchValues: (term: string) => V[];
+};
+/**
+ * A reusable fuzzy-search primitive over a fixed list of `options`. Plugins that
+ * expose a search (profiles, topics, relays) build one of these reactively from
+ * their collection. Blends fuse scoring with an optional `sortFn`.
+ */
+export declare const createSearch: <V, T>(options: T[], opts: SearchOptions<V, T>) => Search<V, T>;
+export declare const projection: <T>($: Readable<T>, get?: () => T) => {
+    $: Readable<T>;
+    get: () => T;
+};
+/**
+ * Build a `Projection` derived from another `Projection`: re-read `src`
+ * reactively via `.$` or synchronously via `.get()`.
+ */
+export declare const projectFrom: <S, U>(src: Projection<S>, read: ($: S) => U) => Projection<U>;
+/**
+ * Base class for a reactive, keyed collection of "local" (non-event) data —
+ * things like relay stats or NIP-11 profiles that aren't backed by the
+ * repository. The collection owns its own map.
+ *
+ * `index` (map) and `all` (values) are `Projection`s — subscribe via `.$`,
+ * snapshot via `.get()`. Per-key access is `one(key)`, a plain on-demand store
+ * (snapshot with svelte's `get(...)`, or read `get(key)` directly).
+ */
+export declare class MapPlugin<T> {
+    protected readonly app: IApp;
+    protected store: import("svelte/store").Writable<Map<string, T>>;
+    index: Projection<ItemsByKey<T>>;
+    all: Projection<T[]>;
+    one: (key?: string, ...args: any[]) => Readable<Maybe<T>>;
+    subs: ((key: string, value: Maybe<T>) => void)[];
+    constructor(app: IApp);
+    get: (key: string) => T | undefined;
+    project: <U>(key: string, read: (item: Maybe<T>) => U) => Projection<U>;
+    set: (key: string, value: T) => void;
+    delete: (key: string) => void;
+    clear: () => void;
+    onItem: (subscriber: (key: string, value: Maybe<T>) => void) => Unsubscriber;
+    protected emitItem: (key: string, value: Maybe<T>) => void;
+}
+/**
+ * A `MapPlugin` collection that knows how to lazily load items by key from the
+ * network. Subclasses implement `fetch`; `load`/`forceLoad`/`one` are derived
+ * from it (with per-key caching and backoff via `makeLoadItem`).
+ */
+export declare abstract class LoadableMapPlugin<T> extends MapPlugin<T> {
+    load: (key: string, ...args: any[]) => Promise<Maybe<T>>;
+    forceLoad: (key: string, ...args: any[]) => Promise<Maybe<T>>;
+    abstract fetch(key: string, ...args: any[]): Promise<unknown>;
+    constructor(app: IApp, options?: MakeLoadItemOptions);
+}
+export type DerivedPluginOptions<T> = {
+    filters: Filter[];
+    eventToItem: EventToItem<T>;
+    getKey: (item: T) => string;
+    loadOptions?: MakeLoadItemOptions;
+};
+/**
+ * Base class for a reactive, keyed collection of data derived from nostr events.
+ * The repository is the single source of truth — the collection is a live view
+ * over `app.itemsByKey`, never a duplicated map. Subclasses implement `fetch`
+ * (how to load an item by key from the network) and pass the filters/decoder via
+ * `super`.
+ *
+ * `index` (map) and `all` (values) are `Projection`s — subscribe via `.$`,
+ * snapshot via `.get()`. Per-key access is `one(key)`, a plain on-demand store.
+ */
+export declare abstract class DerivedPlugin<T> {
+    protected readonly app: IApp;
+    index: Projection<ItemsByKey<T>>;
+    all: Projection<T[]>;
+    one: (key?: string, ...args: any[]) => Readable<Maybe<T>>;
+    load: (key: string, ...args: any[]) => Promise<Maybe<T>>;
+    forceLoad: (key: string, ...args: any[]) => Promise<Maybe<T>>;
+    abstract fetch(key: string, ...args: any[]): Promise<unknown>;
+    constructor(app: IApp, options: DerivedPluginOptions<T>);
+    get: (key: string) => T | undefined;
+    project: <U>(key: string, read: (item: Maybe<T>) => U) => Projection<U>;
+}
+export type RelayScopedDerivedPluginOptions<T> = {
+    filters: Filter[];
+    eventToItem: EventToItem<T>;
+    getKey: (item: T, url: string) => string | undefined;
+    loadOptions?: MakeLoadItemOptions;
+    revalidateOn?: Readable<unknown>;
+};
+/**
+ * A `DerivedPlugin` for relay-dependent data: each item is keyed by
+ * `getKey(item, url)` once per relay it was seen on (via the tracker), so the
+ * same addressable coordinate on two relays stays two distinct entries. Use it
+ * for collections that only make sense relative to a relay — NIP-29 rooms
+ * (`${url}'${group}`), relay roles (`${url}|${d}`), per-relay replaceables
+ * (`${url}`). Subclasses implement `fetch` (loading from the relevant relay).
+ */
+export declare abstract class RelayScopedDerivedPlugin<T> {
+    protected readonly app: IApp;
+    index: Projection<ItemsByKey<T>>;
+    all: Projection<T[]>;
+    one: (key?: string, ...args: any[]) => Readable<Maybe<T>>;
+    load: (key: string, ...args: any[]) => Promise<Maybe<T>>;
+    forceLoad: (key: string, ...args: any[]) => Promise<Maybe<T>>;
+    abstract fetch(key: string, ...args: any[]): Promise<unknown>;
+    constructor(app: IApp, options: RelayScopedDerivedPluginOptions<T>);
+    get: (key: string) => T | undefined;
+    project: <U>(key: string, read: (item: Maybe<T>) => U) => Projection<U>;
+}
+//# sourceMappingURL=base.d.ts.map

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

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