@welshman/app 0.8.15 → 0.9.0-pre1

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/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,36 @@
-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 "./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/stores.js";
+export * from "./plugins/router.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/follows.js";
+export * from "./plugins/mutes.js";
+export * from "./plugins/pins.js";
+export * from "./plugins/blossom.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/tags.js";
+export * from "./plugins/wot.js";
+export * from "./plugins/feeds.js";
+export * from "./plugins/search.js";
+export * from "./plugins/sync.js";
+export * from "./plugins/wraps.js";
+export * from "./plugins/rooms.js";
+export * from "./plugins/slashCommands.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,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,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,sBAAsB,CAAA;AACpC,cAAc,kCAAkC,CAAA;AAChD,cAAc,+BAA+B,CAAA;AAC7C,cAAc,sBAAsB,CAAA;AACpC,cAAc,sBAAsB,CAAA;AACpC,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA;AAChC,cAAc,oBAAoB,CAAA;AAClC,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,oBAAoB,CAAA"}

package/dist/app/src/index.js

@@ -1,94 +1,36 @@
-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 "./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/stores.js";
+export * from "./plugins/router.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/follows.js";
+export * from "./plugins/mutes.js";
+export * from "./plugins/pins.js";
+export * from "./plugins/blossom.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/tags.js";
+export * from "./plugins/wot.js";
+export * from "./plugins/feeds.js";
+export * from "./plugins/search.js";
+export * from "./plugins/sync.js";
+export * from "./plugins/wraps.js";
+export * from "./plugins/rooms.js";
+export * from "./plugins/slashCommands.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,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,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,sBAAsB,CAAA;AACpC,cAAc,kCAAkC,CAAA;AAChD,cAAc,+BAA+B,CAAA;AAC7C,cAAc,sBAAsB,CAAA;AACpC,cAAc,sBAAsB,CAAA;AACpC,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA;AAChC,cAAc,oBAAoB,CAAA;AAClC,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,oBAAoB,CAAA"}

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

@@ -0,0 +1,86 @@
+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 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>;
+}
+//# 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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"}

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

@@ -0,0 +1,124 @@
+import { writable, derived } from "svelte/store";
+import { deriveItems, getter, makeDeriveItem, makeLoadItem, makeForceLoadItem } from "@welshman/store";
+import { Stores } from "./stores.js";
+export const projection = ($, get = getter($)) => ({ $, get });
+/**
+ * Build a `Projection` derived from another `Projection`: re-read `src`
+ * reactively via `.$` or synchronously via `.get()`.
+ */
+export const projectFrom = (src, read) => projection(derived(src.$, read), () => read(src.get()));
+/**
+ * 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 class MapPlugin {
+    app;
+    store = writable(new Map());
+    index;
+    all;
+    one;
+    subs = [];
+    constructor(app) {
+        this.app = app;
+        this.index = projection(this.store);
+        this.all = projection(deriveItems(this.store));
+        this.one = makeDeriveItem(this.store);
+    }
+    get = (key) => this.index.get().get(key);
+    project = (key, read) => projection(derived(this.one(key), read), () => read(this.get(key)));
+    set = (key, value) => {
+        this.store.update($items => {
+            $items.set(key, value);
+            return $items;
+        });
+        this.emitItem(key, value);
+    };
+    delete = (key) => {
+        this.store.update($items => {
+            $items.delete(key);
+            return $items;
+        });
+        this.emitItem(key, undefined);
+    };
+    clear = () => {
+        const keys = Array.from(this.index.get().keys());
+        this.store.set(new Map());
+        for (const key of keys) {
+            this.emitItem(key, undefined);
+        }
+    };
+    onItem = (subscriber) => {
+        this.subs.push(subscriber);
+        return () => {
+            const i = this.subs.indexOf(subscriber);
+            if (i !== -1)
+                this.subs.splice(i, 1);
+        };
+    };
+    emitItem = (key, value) => {
+        for (const subscriber of this.subs) {
+            subscriber(key, value);
+        }
+    };
+}
+/**
+ * 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 class LoadableMapPlugin extends MapPlugin {
+    load;
+    forceLoad;
+    constructor(app, options = {}) {
+        super(app);
+        // Subclasses implement `fetch` as an arrow field, whose initializer runs
+        // *after* super() — so `this.fetch` is undefined here. makeLoadItem captures
+        // its loadItem eagerly, so we defer the lookup to call time via this wrapper.
+        const fetch = (key, ...args) => this.fetch(key, ...args);
+        const read = (key) => this.index.get().get(key);
+        this.load = makeLoadItem(fetch, read, options);
+        this.forceLoad = makeForceLoadItem(fetch, read);
+        this.one = makeDeriveItem(this.store, this.load);
+    }
+}
+/**
+ * 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 class DerivedPlugin {
+    app;
+    index;
+    all;
+    one;
+    load;
+    forceLoad;
+    constructor(app, options) {
+        this.app = app;
+        const index = app.use(Stores).itemsByKey({
+            filters: options.filters,
+            eventToItem: options.eventToItem,
+            getKey: options.getKey,
+        });
+        this.index = projection(index);
+        this.all = projection(deriveItems(index));
+        const fetch = (key, ...args) => this.fetch(key, ...args);
+        const read = (key) => this.index.get().get(key);
+        this.load = makeLoadItem(fetch, read, options.loadOptions);
+        this.forceLoad = makeForceLoadItem(fetch, read);
+        this.one = makeDeriveItem(index, this.load);
+    }
+    get = (key) => this.index.get().get(key);
+    project = (key, read) => projection(derived(this.one(key), read), () => read(this.get(key)));
+}
+//# sourceMappingURL=base.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../src/plugins/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAE,OAAO,EAAC,MAAM,cAAc,CAAA;AAI9C,OAAO,EAAC,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,YAAY,EAAE,iBAAiB,EAAC,MAAM,iBAAiB,CAAA;AAGpG,OAAO,EAAC,MAAM,EAAC,MAAM,aAAa,CAAA;AAUlC,MAAM,CAAC,MAAM,UAAU,GAAG,CAAI,CAAc,EAAE,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAE,GAAG,EAAC,CAAC,CAAA;AAE5E;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAO,GAAkB,EAAE,IAAiB,EAAiB,EAAE,CACxF,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;AAEzD;;;;;;;;GAQG;AACH,MAAM,OAAO,SAAS;IAOW;IANrB,KAAK,GAAG,QAAQ,CAAC,IAAI,GAAG,EAAa,CAAC,CAAA;IAChD,KAAK,CAA2B;IAChC,GAAG,CAAiB;IACpB,GAAG,CAAsD;IACzD,IAAI,GAA+C,EAAE,CAAA;IAErD,YAA+B,GAAS;QAAT,QAAG,GAAH,GAAG,CAAM;QACtC,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACnC,IAAI,CAAC,GAAG,GAAG,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;QAC9C,IAAI,CAAC,GAAG,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACvC,CAAC;IAED,GAAG,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAEhD,OAAO,GAAG,CAAI,GAAW,EAAE,IAA2B,EAAiB,EAAE,CACvE,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IAErE,GAAG,GAAG,CAAC,GAAW,EAAE,KAAQ,EAAE,EAAE;QAC9B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE;YACzB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;YAEtB,OAAO,MAAM,CAAA;QACf,CAAC,CAAC,CAAA;QAEF,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IAC3B,CAAC,CAAA;IAED,MAAM,GAAG,CAAC,GAAW,EAAE,EAAE;QACvB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE;YACzB,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YAElB,OAAO,MAAM,CAAA;QACf,CAAC,CAAC,CAAA;QAEF,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC,CAAA;IAC/B,CAAC,CAAA;IAED,KAAK,GAAG,GAAG,EAAE;QACX,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,CAAA;QAEhD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC,CAAA;QAEzB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC,CAAA;QAC/B,CAAC;IACH,CAAC,CAAA;IAED,MAAM,GAAG,CAAC,UAAkD,EAAgB,EAAE;QAC5E,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QAE1B,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;YAEvC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QACtC,CAAC,CAAA;IACH,CAAC,CAAA;IAES,QAAQ,GAAG,CAAC,GAAW,EAAE,KAAe,EAAE,EAAE;QACpD,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACnC,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QACxB,CAAC;IACH,CAAC,CAAA;CACF;AAED;;;;GAIG;AACH,MAAM,OAAgB,iBAAqB,SAAQ,SAAY;IAC7D,IAAI,CAAoD;IACxD,SAAS,CAAoD;IAI7D,YAAY,GAAS,EAAE,UAA+B,EAAE;QACtD,KAAK,CAAC,GAAG,CAAC,CAAA;QAEV,yEAAyE;QACzE,6EAA6E;QAC7E,8EAA8E;QAC9E,MAAM,KAAK,GAAG,CAAC,GAAW,EAAE,GAAG,IAAW,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAA;QACvE,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAEvD,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;QAC9C,IAAI,CAAC,SAAS,GAAG,iBAAiB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;QAC/C,IAAI,CAAC,GAAG,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;IAClD,CAAC;CACF;AASD;;;;;;;;;GASG;AACH,MAAM,OAAgB,aAAa;IAUZ;IATrB,KAAK,CAA2B;IAChC,GAAG,CAAiB;IACpB,GAAG,CAAsD;IACzD,IAAI,CAAoD;IACxD,SAAS,CAAoD;IAI7D,YACqB,GAAS,EAC5B,OAAgC;QADb,QAAG,GAAH,GAAG,CAAM;QAG5B,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,UAAU,CAAI;YAC1C,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAA;QAEF,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAA;QAC9B,IAAI,CAAC,GAAG,GAAG,UAAU,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAA;QAEzC,MAAM,KAAK,GAAG,CAAC,GAAW,EAAE,GAAG,IAAW,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAA;QACvE,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAEvD,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;QAC1D,IAAI,CAAC,SAAS,GAAG,iBAAiB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;QAC/C,IAAI,CAAC,GAAG,GAAG,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;IAC7C,CAAC;IAED,GAAG,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAEhD,OAAO,GAAG,CAAI,GAAW,EAAE,IAA2B,EAAiB,EAAE,CACvE,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;CACtE"}

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

@@ -0,0 +1,19 @@
+import { BlockedRelayList, BlockedRelayListBuilder } from "@welshman/domain";
+import { DerivedPlugin } from "./base.js";
+import type { Projection } from "./base.js";
+import type { IApp } from "../app.js";
+/**
+ * Kind-10006 blocked-relay lists, keyed by pubkey. Loaded via the outbox model,
+ * so it depends on the relay-list collection. Feeds `RelayStats.getQuality` so
+ * blocked relays are never selected.
+ */
+export declare class BlockedRelayLists extends DerivedPlugin<BlockedRelayList> {
+    constructor(app: IApp);
+    fetch(pubkey: string, relayHints?: string[]): Promise<import("@welshman/util").TrustedEvent | undefined>;
+    urls: (pubkey: string) => Projection<string[]>;
+    update: (fn: (builder: BlockedRelayListBuilder) => void) => Promise<import("./thunk.js").Thunk>;
+    addUrl: (url: string) => Promise<import("./thunk.js").Thunk>;
+    removeUrl: (url: string) => Promise<import("./thunk.js").Thunk>;
+    setUrls: (urls: string[]) => Promise<import("./thunk.js").Thunk>;
+}
+//# sourceMappingURL=blockedRelayLists.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"blockedRelayLists.d.ts","sourceRoot":"","sources":["../../../../src/plugins/blockedRelayLists.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,gBAAgB,EAAE,uBAAuB,EAAC,MAAM,kBAAkB,CAAA;AAC1E,OAAO,EAAC,aAAa,EAAC,MAAM,WAAW,CAAA;AACvC,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,WAAW,CAAA;AAIzC,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,WAAW,CAAA;AAEnC;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,aAAa,CAAC,gBAAgB,CAAC;gBACxD,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,MAAM,GAAU,IAAI,CAAC,OAAO,EAAE,uBAAuB,KAAK,IAAI,yCAS7D;IAED,MAAM,GAAI,KAAK,MAAM,yCAAgD;IAErE,SAAS,GAAI,KAAK,MAAM,yCAAmD;IAE3E,OAAO,GAAI,MAAM,MAAM,EAAE,yCAAkD;CAC5E"}