applesauce-core 0.11.0 → 0.12.1

package/dist/helpers/gift-wraps.js

@@ -0,0 +1,49 @@
+import { verifyEvent } from "nostr-tools";
+import { getHiddenContent, isHiddenContentLocked, unlockHiddenContent } from "./hidden-content.js";
+import { getOrComputeCachedValue } from "./cache.js";
+export const GiftWrapSealSymbol = Symbol.for("gift-wrap-seal");
+export const GiftWrapEventSymbol = Symbol.for("gift-wrap-event");
+/** Returns the unsigned seal event in a gift-wrap event */
+export function getGiftWrapSeal(gift) {
+    if (isHiddenContentLocked(gift))
+        return undefined;
+    return getOrComputeCachedValue(gift, GiftWrapSealSymbol, () => {
+        const plaintext = getHiddenContent(gift);
+        if (!plaintext)
+            throw new Error("Gift-wrap is locked");
+        const seal = JSON.parse(plaintext);
+        // verify the seal is valid
+        verifyEvent(seal);
+        return seal;
+    });
+}
+/** Returns the unsigned event in the gift-wrap seal */
+export function getGiftWrapEvent(gift) {
+    if (isHiddenContentLocked(gift))
+        return undefined;
+    return getOrComputeCachedValue(gift, GiftWrapEventSymbol, () => {
+        const seal = getGiftWrapSeal(gift);
+        if (!seal)
+            throw new Error("Gift is locked");
+        const plaintext = getHiddenContent(seal);
+        if (!plaintext)
+            throw new Error("Gift-wrap seal is locked");
+        const event = JSON.parse(plaintext);
+        if (event.pubkey !== seal.pubkey)
+            throw new Error("Seal author does not match content");
+        return event;
+    });
+}
+/** Returns if a gift-wrap event or gift-wrap seal is locked */
+export function isGiftWrapLocked(gift) {
+    return isHiddenContentLocked(gift) || isHiddenContentLocked(getGiftWrapSeal(gift));
+}
+/** Unlocks and returns the unsigned seal event in a gift-wrap */
+export async function unlockGiftWrap(gift, signer) {
+    if (isHiddenContentLocked(gift))
+        await unlockHiddenContent(gift, signer);
+    const seal = getGiftWrapSeal(gift);
+    if (isHiddenContentLocked(seal))
+        await unlockHiddenContent(seal, signer);
+    return getGiftWrapEvent(gift);
+}

package/dist/helpers/hidden-content.d.ts

@@ -0,0 +1,48 @@
+export declare const HiddenContentSymbol: unique symbol;
+export type HiddenContentSigner = {
+    nip04?: {
+        encrypt: (pubkey: string, plaintext: string) => Promise<string> | string;
+        decrypt: (pubkey: string, ciphertext: string) => Promise<string> | string;
+    };
+    nip44?: {
+        encrypt: (pubkey: string, plaintext: string) => Promise<string> | string;
+        decrypt: (pubkey: string, ciphertext: string) => Promise<string> | string;
+    };
+};
+/** Various event kinds that can have encrypted tags in their content and which encryption method they use */
+export declare const EventContentEncryptionMethod: Record<number, "nip04" | "nip44">;
+/** Sets the encryption method that is used for the contents of a specific event kind */
+export declare function setEventContentEncryptionMethod(kind: number, method: "nip04" | "nip44"): void;
+/** Checks if an event can have hidden content */
+export declare function canHaveHiddenContent(kind: number): boolean;
+/** Checks if an event has hidden content */
+export declare function hasHiddenContent<T extends {
+    kind: number;
+    content: string;
+}>(event: T): boolean;
+/** Returns the hidden tags for an event if they are unlocked */
+export declare function getHiddenContent<T extends object>(event: T): string | undefined;
+/** Checks if the hidden tags are locked */
+export declare function isHiddenContentLocked<T extends object>(event: T): boolean;
+/** Returns either nip04 or nip44 encryption methods depending on event kind */
+export declare function getHiddenContentEncryptionMethods(kind: number, signer: HiddenContentSigner): {
+    encrypt: (pubkey: string, plaintext: string) => Promise<string> | string;
+    decrypt: (pubkey: string, ciphertext: string) => Promise<string> | string;
+} | {
+    encrypt: (pubkey: string, plaintext: string) => Promise<string> | string;
+    decrypt: (pubkey: string, ciphertext: string) => Promise<string> | string;
+};
+export type HiddenContentEvent = {
+    kind: number;
+    pubkey: string;
+    content: string;
+};
+/**
+ * Unlocks the encrypted content in an event
+ * @param event The event with content to decrypt
+ * @param signer A signer to use to decrypt the tags
+ * @throws
+ */
+export declare function unlockHiddenContent<T extends HiddenContentEvent>(event: T, signer: HiddenContentSigner): Promise<string>;
+/** Removes the unencrypted hidden content on an event */
+export declare function lockHiddenContent<T extends object>(event: T): void;

package/dist/helpers/hidden-content.js

@@ -0,0 +1,88 @@
+import * as kinds from "nostr-tools/kinds";
+import { GROUPS_LIST_KIND } from "./groups.js";
+import { getParentEventStore, isEvent } from "./event.js";
+export const HiddenContentSymbol = Symbol.for("hidden-content");
+/** Various event kinds that can have encrypted tags in their content and which encryption method they use */
+export const EventContentEncryptionMethod = {
+    // NIP-60 wallet
+    17375: "nip44",
+    375: "nip44",
+    7375: "nip44",
+    7376: "nip44",
+    // DMs
+    [kinds.EncryptedDirectMessage]: "nip04",
+    // Gift wraps
+    [kinds.GiftWrap]: "nip44",
+    // NIP-51 lists
+    [kinds.BookmarkList]: "nip04",
+    [kinds.InterestsList]: "nip04",
+    [kinds.Mutelist]: "nip04",
+    [kinds.CommunitiesList]: "nip04",
+    [kinds.PublicChatsList]: "nip04",
+    [kinds.SearchRelaysList]: "nip04",
+    [GROUPS_LIST_KIND]: "nip04",
+    // NIP-51 sets
+    [kinds.Bookmarksets]: "nip04",
+    [kinds.Relaysets]: "nip04",
+    [kinds.Followsets]: "nip04",
+    [kinds.Curationsets]: "nip04",
+    [kinds.Interestsets]: "nip04",
+};
+/** Sets the encryption method that is used for the contents of a specific event kind */
+export function setEventContentEncryptionMethod(kind, method) {
+    EventContentEncryptionMethod[kind] = method;
+}
+/** Checks if an event can have hidden content */
+export function canHaveHiddenContent(kind) {
+    return EventContentEncryptionMethod[kind] !== undefined;
+}
+/** Checks if an event has hidden content */
+export function hasHiddenContent(event) {
+    return canHaveHiddenContent(event.kind) && event.content.length > 0;
+}
+/** Returns the hidden tags for an event if they are unlocked */
+export function getHiddenContent(event) {
+    return Reflect.get(event, HiddenContentSymbol);
+}
+/** Checks if the hidden tags are locked */
+export function isHiddenContentLocked(event) {
+    return Reflect.has(event, HiddenContentSymbol) === false;
+}
+/** Returns either nip04 or nip44 encryption methods depending on event kind */
+export function getHiddenContentEncryptionMethods(kind, signer) {
+    const method = EventContentEncryptionMethod[kind];
+    const encryption = signer[method];
+    if (!encryption)
+        throw new Error(`Signer does not support ${method} encryption`);
+    return encryption;
+}
+/**
+ * Unlocks the encrypted content in an event
+ * @param event The event with content to decrypt
+ * @param signer A signer to use to decrypt the tags
+ * @throws
+ */
+export async function unlockHiddenContent(event, signer) {
+    if (!canHaveHiddenContent(event.kind))
+        throw new Error("Event kind does not support hidden content");
+    const encryption = getHiddenContentEncryptionMethods(event.kind, signer);
+    const plaintext = await encryption.decrypt(event.pubkey, event.content);
+    Reflect.set(event, HiddenContentSymbol, plaintext);
+    // if the event has been added to an event store, notify it
+    if (isEvent(event)) {
+        const eventStore = getParentEventStore(event);
+        if (eventStore)
+            eventStore.update(event);
+    }
+    return plaintext;
+}
+/** Removes the unencrypted hidden content on an event */
+export function lockHiddenContent(event) {
+    Reflect.deleteProperty(event, HiddenContentSymbol);
+    // if the event has been added to an event store, notify it
+    if (isEvent(event)) {
+        const eventStore = getParentEventStore(event);
+        if (eventStore)
+            eventStore.update(event);
+    }
+}

package/dist/helpers/hidden-tags.d.ts

@@ -1,28 +1,18 @@
-import { EventTemplate, NostrEvent } from "nostr-tools";
-import { EventStore } from "../event-store/event-store.js";
-export type HiddenTagsSigner = {
-    nip04?: {
-        encrypt: (pubkey: string, plaintext: string) => Promise<string> | string;
-        decrypt: (pubkey: string, ciphertext: string) => Promise<string> | string;
-    };
-    nip44?: {
-        encrypt: (pubkey: string, plaintext: string) => Promise<string> | string;
-        decrypt: (pubkey: string, ciphertext: string) => Promise<string> | string;
-    };
-};
+import { HiddenContentEvent, HiddenContentSigner } from "./hidden-content.js";
 export declare const HiddenTagsSymbol: unique symbol;
-/** Various event kinds that can have encrypted tags in their content and which encryption method they use */
-export declare const EventEncryptionMethod: Record<number, "nip04" | "nip44">;
 /** Checks if an event can have hidden tags */
 export declare function canHaveHiddenTags(kind: number): boolean;
 /** Checks if an event has hidden tags */
-export declare function hasHiddenTags(event: NostrEvent | EventTemplate): boolean;
+export declare function hasHiddenTags<T extends {
+    content: string;
+    kind: number;
+}>(event: T): boolean;
 /** Returns the hidden tags for an event if they are unlocked */
-export declare function getHiddenTags(event: NostrEvent | EventTemplate): string[][] | undefined;
+export declare function getHiddenTags<T extends object>(event: T): string[][] | undefined;
 /** Checks if the hidden tags are locked */
-export declare function isHiddenTagsLocked(event: NostrEvent): boolean;
+export declare function isHiddenTagsLocked<T extends object>(event: T): boolean;
 /** Returns either nip04 or nip44 encryption method depending on list kind */
-export declare function getListEncryptionMethods(kind: number, signer: HiddenTagsSigner): {
+export declare function getHiddenTagsEncryptionMethods(kind: number, signer: HiddenContentSigner): {
     encrypt: (pubkey: string, plaintext: string) => Promise<string> | string;
     decrypt: (pubkey: string, ciphertext: string) => Promise<string> | string;
 } | {
@@ -36,13 +26,5 @@ export declare function getListEncryptionMethods(kind: number, signer: HiddenTag
  * @param store An optional EventStore to notify about the update
  * @throws
  */
-export declare function unlockHiddenTags<T extends {
-    kind: number;
-    pubkey: string;
-    content: string;
-}>(event: T, signer: HiddenTagsSigner, store?: EventStore): Promise<T>;
-/**
- * Override the hidden tags in an event
- * @throws
- */
-export declare function overrideHiddenTags(event: NostrEvent, hidden: string[][], signer: HiddenTagsSigner): Promise<EventTemplate>;
+export declare function unlockHiddenTags<T extends HiddenContentEvent>(event: T, signer: HiddenContentSigner): Promise<string[][]>;
+export declare function lockHiddenTags<T extends object>(event: T): void;

package/dist/helpers/hidden-tags.js

@@ -1,30 +1,9 @@
-import { kinds } from "nostr-tools";
-import { GROUPS_LIST_KIND } from "./groups.js";
-import { unixNow } from "./time.js";
-import { isEvent } from "./event.js";
+import { canHaveHiddenContent, getHiddenContent, getHiddenContentEncryptionMethods, isHiddenContentLocked, lockHiddenContent, unlockHiddenContent, } from "./hidden-content.js";
+import { getOrComputeCachedValue } from "./cache.js";
 export const HiddenTagsSymbol = Symbol.for("hidden-tags");
-/** Various event kinds that can have encrypted tags in their content and which encryption method they use */
-export const EventEncryptionMethod = {
-    // NIP-60 wallet
-    37375: "nip44",
-    // NIP-51 lists
-    [kinds.BookmarkList]: "nip04",
-    [kinds.InterestsList]: "nip04",
-    [kinds.Mutelist]: "nip04",
-    [kinds.CommunitiesList]: "nip04",
-    [kinds.PublicChatsList]: "nip04",
-    [kinds.SearchRelaysList]: "nip04",
-    [GROUPS_LIST_KIND]: "nip04",
-    // NIP-51 sets
-    [kinds.Bookmarksets]: "nip04",
-    [kinds.Relaysets]: "nip04",
-    [kinds.Followsets]: "nip04",
-    [kinds.Curationsets]: "nip04",
-    [kinds.Interestsets]: "nip04",
-};
 /** Checks if an event can have hidden tags */
 export function canHaveHiddenTags(kind) {
-    return EventEncryptionMethod[kind] !== undefined;
+    return canHaveHiddenContent(kind);
 }
 /** Checks if an event has hidden tags */
 export function hasHiddenTags(event) {
@@ -32,19 +11,24 @@ export function hasHiddenTags(event) {
 }
 /** Returns the hidden tags for an event if they are unlocked */
 export function getHiddenTags(event) {
-    return Reflect.get(event, HiddenTagsSymbol);
+    if (isHiddenTagsLocked(event))
+        return undefined;
+    return getOrComputeCachedValue(event, HiddenTagsSymbol, () => {
+        const plaintext = getHiddenContent(event);
+        const parsed = JSON.parse(plaintext);
+        if (!Array.isArray(parsed))
+            throw new Error("Content is not an array of tags");
+        // Convert array to tags array string[][]
+        return parsed.filter((t) => Array.isArray(t)).map((t) => t.map((v) => String(v)));
+    });
 }
 /** Checks if the hidden tags are locked */
 export function isHiddenTagsLocked(event) {
-    return hasHiddenTags(event) && getHiddenTags(event) === undefined;
+    return isHiddenContentLocked(event);
 }
 /** Returns either nip04 or nip44 encryption method depending on list kind */
-export function getListEncryptionMethods(kind, signer) {
-    const method = EventEncryptionMethod[kind];
-    const encryption = signer[method];
-    if (!encryption)
-        throw new Error(`Signer does not support ${method} encryption`);
-    return encryption;
+export function getHiddenTagsEncryptionMethods(kind, signer) {
+    return getHiddenContentEncryptionMethods(kind, signer);
 }
 /**
  * Decrypts the private list
@@ -53,34 +37,15 @@ export function getListEncryptionMethods(kind, signer) {
  * @param store An optional EventStore to notify about the update
  * @throws
  */
-export async function unlockHiddenTags(event, signer, store) {
+export async function unlockHiddenTags(event, signer) {
     if (!canHaveHiddenTags(event.kind))
         throw new Error("Event kind does not support hidden tags");
-    const encryption = getListEncryptionMethods(event.kind, signer);
-    const plaintext = await encryption.decrypt(event.pubkey, event.content);
-    const parsed = JSON.parse(plaintext);
-    if (!Array.isArray(parsed))
-        throw new Error("Content is not an array of tags");
-    // Convert array to tags array string[][]
-    const tags = parsed.filter((t) => Array.isArray(t)).map((t) => t.map((v) => String(v)));
-    Reflect.set(event, HiddenTagsSymbol, tags);
-    if (store && isEvent(event))
-        store.update(event);
-    return event;
+    // unlock hidden content is needed
+    if (isHiddenContentLocked(event))
+        await unlockHiddenContent(event, signer);
+    return getHiddenTags(event);
 }
-/**
- * Override the hidden tags in an event
- * @throws
- */
-export async function overrideHiddenTags(event, hidden, signer) {
-    if (!canHaveHiddenTags(event.kind))
-        throw new Error("Event kind does not support hidden tags");
-    const encryption = getListEncryptionMethods(event.kind, signer);
-    const ciphertext = await encryption.encrypt(event.pubkey, JSON.stringify(hidden));
-    return {
-        kind: event.kind,
-        content: ciphertext,
-        created_at: unixNow(),
-        tags: event.tags,
-    };
+export function lockHiddenTags(event) {
+    Reflect.deleteProperty(event, HiddenTagsSymbol);
+    lockHiddenContent(event);
 }

package/dist/helpers/index.d.ts

@@ -7,14 +7,17 @@ export * from "./comment.js";
 export * from "./contacts.js";
 export * from "./content.js";
 export * from "./delete.js";
+export * from "./direct-messages.js";
 export * from "./dns-identity.js";
 export * from "./emoji.js";
 export * from "./event.js";
 export * from "./external-id.js";
 export * from "./file-metadata.js";
 export * from "./filter.js";
+export * from "./gift-wraps.js";
 export * from "./groups.js";
 export * from "./hashtag.js";
+export * from "./hidden-content.js";
 export * from "./hidden-tags.js";
 export * from "./json.js";
 export * from "./lists.js";

package/dist/helpers/index.js

@@ -7,14 +7,17 @@ export * from "./comment.js";
 export * from "./contacts.js";
 export * from "./content.js";
 export * from "./delete.js";
+export * from "./direct-messages.js";
 export * from "./dns-identity.js";
 export * from "./emoji.js";
 export * from "./event.js";
 export * from "./external-id.js";
 export * from "./file-metadata.js";
 export * from "./filter.js";
+export * from "./gift-wraps.js";
 export * from "./groups.js";
 export * from "./hashtag.js";
+export * from "./hidden-content.js";
 export * from "./hidden-tags.js";
 export * from "./json.js";
 export * from "./lists.js";

package/dist/helpers/mutes.d.ts

@@ -7,6 +7,7 @@ export type Mutes = {
     hashtags: Set<string>;
     words: Set<string>;
 };
+/** Parses mute tags */
 export declare function parseMutedTags(tags: string[][]): Mutes;
 /** Returns muted things */
 export declare function getMutedThings(mute: NostrEvent): Mutes;

package/dist/helpers/mutes.js

@@ -3,6 +3,7 @@ import { getOrComputeCachedValue } from "./cache.js";
 import { getHiddenTags } from "./hidden-tags.js";
 export const MutePublicSymbol = Symbol.for("mute-public");
 export const MuteHiddenSymbol = Symbol.for("mute-hidden");
+/** Parses mute tags */
 export function parseMutedTags(tags) {
     const pubkeys = new Set(tags.filter(isPTag).map((t) => t[1]));
     const threads = new Set(tags.filter(isETag).map((t) => t[1]));
@@ -12,7 +13,7 @@ export function parseMutedTags(tags) {
 }
 /** Returns muted things */
 export function getMutedThings(mute) {
-    return getOrComputeCachedValue(mute, MutePublicSymbol, (e) => parseMutedTags(e.tags));
+    return getOrComputeCachedValue(mute, MutePublicSymbol, () => parseMutedTags(mute.tags));
 }
 /** Returns the hidden muted content if the event is unlocked */
 export function getHiddenMutedThings(mute) {

package/dist/helpers/nip-19.d.ts

@@ -0,0 +1,4 @@
+/** Gets the hex pubkey from any nip-19 encoded string */
+export declare function normalizeToPubkey(str: string): string;
+/** Converts hex to nsec strings into Uint8 secret keys */
+export declare function normalizeToSecretKey(str: string): Uint8Array;

package/dist/helpers/nip-19.js

@@ -0,0 +1,27 @@
+import { nip19 } from "nostr-tools";
+import { hexToBytes } from "@noble/hashes/utils";
+import { isHexKey } from "./string.js";
+import { getPubkeyFromDecodeResult } from "./pointers.js";
+/** Gets the hex pubkey from any nip-19 encoded string */
+export function normalizeToPubkey(str) {
+    if (isHexKey(str))
+        return str;
+    else {
+        const decode = nip19.decode(str);
+        const pubkey = getPubkeyFromDecodeResult(decode);
+        if (!pubkey)
+            throw new Error(`Cant find pubkey in ${decode.type}`);
+        return pubkey;
+    }
+}
+/** Converts hex to nsec strings into Uint8 secret keys */
+export function normalizeToSecretKey(str) {
+    if (isHexKey(str))
+        return hexToBytes(str);
+    else {
+        const decode = nip19.decode(str);
+        if (decode.type !== "nsec")
+            throw new Error(`Cant get secret key from ${decode.type}`);
+        return decode.data;
+    }
+}

package/dist/observable/claim-latest.d.ts

@@ -1,4 +1,5 @@
 import { MonoTypeOperatorFunction } from "rxjs";
 import { NostrEvent } from "nostr-tools";
-import { Database } from "../event-store/database.js";
-export declare function claimLatest(database: Database): MonoTypeOperatorFunction<NostrEvent | undefined>;
+import { type Database } from "../event-store/database.js";
+/** An operator that claims the latest event with the database */
+export declare function claimLatest<T extends NostrEvent | undefined>(database: Database): MonoTypeOperatorFunction<T>;

package/dist/observable/claim-latest.js

@@ -1,4 +1,5 @@
 import { finalize, tap } from "rxjs";
+/** An operator that claims the latest event with the database */
 export function claimLatest(database) {
     return (source) => {
         let latest = undefined;
@@ -12,7 +13,7 @@ export function claimLatest(database) {
             // update state
             latest = event;
         }), finalize(() => {
-            // late claim
+            // remove latest claim
             if (latest)
                 database.removeClaim(latest, source);
         }));

package/dist/observable/with-immediate-value.d.ts

@@ -0,0 +1,3 @@
+import { OperatorFunction } from "rxjs";
+/** if a synchronous value is not emitted, default is emitted */
+export declare function withImmediateValueOrDefault<Value, Default extends unknown = unknown>(defaultValue: Default): OperatorFunction<Value, Value | Default>;

package/dist/observable/with-immediate-value.js

@@ -0,0 +1,19 @@
+import { Observable } from "rxjs";
+/** if a synchronous value is not emitted, default is emitted */
+export function withImmediateValueOrDefault(defaultValue) {
+    return (source) => new Observable((observer) => {
+        let seen = false;
+        const sub = source.subscribe({
+            next: (v) => {
+                seen = true;
+                observer.next(v);
+            },
+            error: (err) => observer.error(err),
+            complete: () => observer.complete(),
+        });
+        // if a value is not emitted sync, emit default
+        if (!seen)
+            observer.next(defaultValue);
+        return sub;
+    });
+}

package/dist/queries/mutes.js

@@ -5,7 +5,7 @@ import { isHiddenTagsLocked } from "../helpers/hidden-tags.js";
 export function UserMuteQuery(pubkey) {
     return {
         key: pubkey,
-        run: (store) => store.replaceable(kinds.Mutelist, pubkey).pipe(map((event) => event && getMutedThings(event))),
+        run: (event) => event.replaceable(kinds.Mutelist, pubkey).pipe(map((event) => event && getMutedThings(event))),
     };
 }
 export function UserHiddenMuteQuery(pubkey) {

package/dist/queries/simple.d.ts

@@ -7,7 +7,7 @@ export declare function MultipleEventsQuery(ids: string[]): Query<Record<string,
 /** Creates a Query returning the latest version of a replaceable event */
 export declare function ReplaceableQuery(kind: number, pubkey: string, d?: string): Query<NostrEvent | undefined>;
 /** Creates a Query that returns an array of sorted events matching the filters */
-export declare function TimelineQuery(filters: Filter | Filter[], keepOldVersions?: boolean): Query<NostrEvent[]>;
+export declare function TimelineQuery(filters: Filter | Filter[], includeOldVersion?: boolean): Query<NostrEvent[]>;
 /** Creates a Query that returns a directory of events by their UID */
 export declare function ReplaceableSetQuery(pointers: {
     kind: number;

package/dist/queries/simple.js

@@ -22,11 +22,11 @@ export function ReplaceableQuery(kind, pubkey, d) {
     };
 }
 /** Creates a Query that returns an array of sorted events matching the filters */
-export function TimelineQuery(filters, keepOldVersions) {
+export function TimelineQuery(filters, includeOldVersion) {
     filters = Array.isArray(filters) ? filters : [filters];
     return {
-        key: hash_sum(filters) + (keepOldVersions ? "-history" : ""),
-        run: (events) => events.timeline(filters, keepOldVersions),
+        key: hash_sum(filters) + (includeOldVersion ? "-history" : ""),
+        run: (events) => events.timeline(filters, includeOldVersion),
     };
 }
 /** Creates a Query that returns a directory of events by their UID */

package/dist/query-store/__tests__/query-store.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/query-store/{query-store.test.js → __tests__/query-store.test.js}

@@ -1,7 +1,9 @@
 import { describe, it, expect, beforeEach } from "vitest";
-import { EventStore } from "../event-store/event-store.js";
-import { QueryStore } from "./query-store.js";
-import { ProfileQuery } from "../queries/profile.js";
+import { subscribeSpyTo } from "@hirez_io/observer-spy";
+import { EventStore } from "../../event-store/event-store.js";
+import { QueryStore } from "../query-store.js";
+import { ProfileQuery } from "../../queries/profile.js";
+import { SingleEventQuery } from "../../queries/simple.js";
 let eventStore;
 let queryStore;
 const event = {
@@ -17,6 +19,34 @@ beforeEach(() => {
     eventStore = new EventStore();
     queryStore = new QueryStore(eventStore);
 });
+describe("createQuery", () => {
+    it("should emit synchronous value if it exists", () => {
+        let value = undefined;
+        eventStore.add(event);
+        queryStore.createQuery(ProfileQuery, event.pubkey).subscribe((v) => (value = v));
+        expect(value).not.toBe(undefined);
+    });
+    it("should not emit undefined if value exists", () => {
+        eventStore.add(event);
+        const spy = subscribeSpyTo(queryStore.createQuery(SingleEventQuery, event.id));
+        expect(spy.getValues()).toEqual([event]);
+    });
+    it("should emit synchronous undefined if value does not exists", () => {
+        let value = 0;
+        queryStore.createQuery(ProfileQuery, event.pubkey).subscribe((v) => {
+            value = v;
+        });
+        expect(value).not.toBe(0);
+        expect(value).toBe(undefined);
+    });
+    it("should share latest value", () => {
+        eventStore.add(event);
+        const spy = subscribeSpyTo(queryStore.createQuery(SingleEventQuery, event.id));
+        const spy2 = subscribeSpyTo(queryStore.createQuery(SingleEventQuery, event.id));
+        expect(spy.getValues()).toEqual([event]);
+        expect(spy2.getValues()).toEqual([event]);
+    });
+});
 describe("executeQuery", () => {
     it("should resolve when value is already present", async () => {
         eventStore.add(event);

package/dist/query-store/query-store.d.ts

@@ -1,19 +1,19 @@
 import { Observable } from "rxjs";
 import { Filter, NostrEvent } from "nostr-tools";
 import type { AddressPointer, EventPointer } from "nostr-tools/nip19";
-import { EventStore } from "../event-store/event-store.js";
+import { IEventStore } from "../event-store/interface.js";
 import * as Queries from "../queries/index.js";
 export type Query<T extends unknown> = {
     /** A unique key for this query. this is used to detect duplicate queries */
     key: string;
     /** The meat of the query, this should return an Observables that subscribes to the eventStore in some way */
-    run: (events: EventStore, store: QueryStore) => Observable<T>;
+    run: (events: IEventStore, store: QueryStore) => Observable<T>;
 };
 export type QueryConstructor<T extends unknown, Args extends Array<any>> = (...args: Args) => Query<T>;
 export declare class QueryStore {
     static Queries: typeof Queries;
-    store: EventStore;
-    constructor(store: EventStore);
+    store: IEventStore;
+    constructor(store: IEventStore);
     /** A directory of all active queries */
     queries: Map<QueryConstructor<any, any[]>, Map<string, Observable<any>>>;
     /** How long a query should be kept "warm" while nothing is subscribed to it */
@@ -45,6 +45,8 @@ export declare class QueryStore {
         inboxes: string[];
         outboxes: string[];
     } | undefined>;
+    /** Creates a query for a users blossom servers */
+    blossomServers(pubkey: string): Observable<URL[] | undefined>;
     /** Creates a ThreadQuery */
     thread(root: string | EventPointer | AddressPointer): Observable<Queries.Thread | undefined>;
 }