applesauce-core 0.0.0-next-20250703183032 → 0.0.0-next-20250723224513

package/dist/event-store/interface.d.ts

@@ -5,6 +5,7 @@ import { LRU } from "../helpers/lru.js";
 import { Mutes } from "../helpers/mutes.js";
 import { ProfileContent } from "../helpers/profile.js";
 import { Thread } from "../models/thread.js";
+import { AddressPointerWithoutD } from "../helpers/pointers.js";
 /** The read interface for an event store */
 export interface IEventStoreRead {
     /** Check if the event store has an event with id */
@@ -51,6 +52,17 @@ export interface IEventClaims {
     /** Removes all claims on an event */
     clearClaim(event: NostrEvent): void;
 }
+/** An event store that can be subscribed to */
+export interface IEventStoreSubscriptions {
+    /** Susbscribe to an event by id */
+    event(id: string | EventPointer): Observable<NostrEvent | undefined>;
+    /** Subscribe to a replaceable event by pointer */
+    replaceable(pointer: AddressPointerWithoutD): Observable<NostrEvent | undefined>;
+    /** Subscribe to an addressable event by pointer */
+    addressable(pointer: AddressPointer): Observable<NostrEvent | undefined>;
+    /** Subscribe to a batch of events that match the filters */
+    filter(filters: Filter | Filter[]): Observable<NostrEvent[]>;
+}
 /** Methods for creating common models */
 export interface IEventStoreModels {
     event(id: string): Observable<NostrEvent | undefined>;

package/dist/helpers/calendar-event.d.ts

@@ -0,0 +1,36 @@
+import { NostrEvent } from "nostr-tools";
+import { ProfilePointer } from "nostr-tools/nip19";
+export declare const DATE_BASED_CALENDAR_EVENT_KIND = 31922;
+export declare const TIME_BASED_CALENDAR_EVENT_KIND = 31923;
+export type CalendarEventParticipant = ProfilePointer & {
+    role?: string;
+};
+export declare const CalendarEventLocationsSymbol: unique symbol;
+export declare const CalendarEventParticipantsSymbol: unique symbol;
+export declare const CalendarEventHashtagsSymbol: unique symbol;
+export declare const CalendarEventReferencesSymbol: unique symbol;
+export declare const CalendarEventGeohashSymbol: unique symbol;
+/** Gets the title of a calendar event or calendar */
+export declare function getCalendarEventTitle(event: NostrEvent): string | undefined;
+/** Gets the summary of a calendar event */
+export declare function getCalendarEventSummary(event: NostrEvent): string | undefined;
+/** Gets the image URL of a calendar event */
+export declare function getCalendarEventImage(event: NostrEvent): string | undefined;
+/** Gets the start Unix timestamp of a calendar event */
+export declare function getCalendarEventStart(event: NostrEvent): number | undefined;
+/** Gets the timezone of the start timestamp of a calendar event */
+export declare function getCalendarEventStartTimezone(event: NostrEvent): string | undefined;
+/** Gets the timezone of the end timestamp of a calendar event */
+export declare function getCalendarEventEndTimezone(event: NostrEvent): string | undefined;
+/** Gets the end Unix timestamp of a calendar event */
+export declare function getCalendarEventEnd(event: NostrEvent): number | undefined;
+/** Gets all locations from a calendar event */
+export declare function getCalendarEventLocations(event: NostrEvent): string[];
+/** Gets the geohash of a calendar event */
+export declare function getCalendarEventGeohash(event: NostrEvent): string | undefined;
+/** Gets all participants from a calendar event */
+export declare function getCalendarEventParticipants(event: NostrEvent): CalendarEventParticipant[];
+/** Gets all hashtags from a calendar event */
+export declare function getCalendarEventHashtags(event: NostrEvent): string[];
+/** Gets all references from a calendar event */
+export declare function getCalendarEventReferences(event: NostrEvent): string[];

package/dist/helpers/calendar-event.js

@@ -0,0 +1,110 @@
+import { getOrComputeCachedValue } from "./cache.js";
+import { getTagValue } from "./event-tags.js";
+import { getProfilePointerFromPTag } from "./pointers.js";
+import { isPTag, isRTag, isTTag } from "./tags.js";
+// NIP-52 Calendar Event Kinds
+export const DATE_BASED_CALENDAR_EVENT_KIND = 31922;
+export const TIME_BASED_CALENDAR_EVENT_KIND = 31923;
+// Cache symbols for complex operations only
+export const CalendarEventLocationsSymbol = Symbol.for("calendar-event-locations");
+export const CalendarEventParticipantsSymbol = Symbol.for("calendar-event-participants");
+export const CalendarEventHashtagsSymbol = Symbol.for("calendar-event-hashtags");
+export const CalendarEventReferencesSymbol = Symbol.for("calendar-event-references");
+export const CalendarEventGeohashSymbol = Symbol.for("calendar-event-geohash");
+/** Gets the title of a calendar event or calendar */
+export function getCalendarEventTitle(event) {
+    return getTagValue(event, "title") || getTagValue(event, "name"); // fallback to deprecated "name" tag
+}
+/** Gets the summary of a calendar event */
+export function getCalendarEventSummary(event) {
+    return getTagValue(event, "summary");
+}
+/** Gets the image URL of a calendar event */
+export function getCalendarEventImage(event) {
+    return getTagValue(event, "image");
+}
+/** Gets the start Unix timestamp of a calendar event */
+export function getCalendarEventStart(event) {
+    const value = getTagValue(event, "start");
+    if (!value)
+        return undefined;
+    if (event.kind === DATE_BASED_CALENDAR_EVENT_KIND)
+        return new Date(value).valueOf() / 1000;
+    else if (event.kind === TIME_BASED_CALENDAR_EVENT_KIND)
+        return parseInt(value);
+    else
+        return undefined;
+}
+/** Gets the timezone of the start timestamp of a calendar event */
+export function getCalendarEventStartTimezone(event) {
+    if (event.kind === DATE_BASED_CALENDAR_EVENT_KIND)
+        return undefined;
+    return getTagValue(event, "start_tzid");
+}
+/** Gets the timezone of the end timestamp of a calendar event */
+export function getCalendarEventEndTimezone(event) {
+    if (event.kind === DATE_BASED_CALENDAR_EVENT_KIND)
+        return undefined;
+    return getTagValue(event, "end_tzid");
+}
+/** Gets the end Unix timestamp of a calendar event */
+export function getCalendarEventEnd(event) {
+    const value = getTagValue(event, "end");
+    if (!value)
+        return undefined;
+    if (event.kind === DATE_BASED_CALENDAR_EVENT_KIND)
+        return new Date(value).valueOf() / 1000;
+    else if (event.kind === TIME_BASED_CALENDAR_EVENT_KIND)
+        return parseInt(value);
+    else
+        return undefined;
+}
+/** Gets all locations from a calendar event */
+export function getCalendarEventLocations(event) {
+    if (event.kind !== DATE_BASED_CALENDAR_EVENT_KIND && event.kind !== TIME_BASED_CALENDAR_EVENT_KIND)
+        throw new Error("Event is not a date-based or time-based calendar event");
+    return getOrComputeCachedValue(event, CalendarEventLocationsSymbol, () => {
+        return event.tags.filter((t) => t[0] === "location" && t[1]).map((t) => t[1]);
+    });
+}
+/** Gets the geohash of a calendar event */
+export function getCalendarEventGeohash(event) {
+    if (event.kind !== DATE_BASED_CALENDAR_EVENT_KIND && event.kind !== TIME_BASED_CALENDAR_EVENT_KIND)
+        throw new Error("Event is not a date-based or time-based calendar event");
+    return getOrComputeCachedValue(event, CalendarEventGeohashSymbol, () => {
+        let hash = undefined;
+        for (const tag of event.tags) {
+            if (tag[0] === "g" && tag[1] && (!hash || tag[1].length > hash.length))
+                hash = tag[1];
+        }
+        return hash;
+    });
+}
+/** Gets all participants from a calendar event */
+export function getCalendarEventParticipants(event) {
+    if (event.kind !== DATE_BASED_CALENDAR_EVENT_KIND && event.kind !== TIME_BASED_CALENDAR_EVENT_KIND)
+        throw new Error("Event is not a date-based or time-based calendar event");
+    return getOrComputeCachedValue(event, CalendarEventParticipantsSymbol, () => {
+        return event.tags.filter(isPTag).map((tag) => ({
+            ...getProfilePointerFromPTag(tag),
+            // Third index of tag is optional "role"
+            role: tag[3] || undefined,
+        }));
+    });
+}
+/** Gets all hashtags from a calendar event */
+export function getCalendarEventHashtags(event) {
+    if (event.kind !== DATE_BASED_CALENDAR_EVENT_KIND && event.kind !== TIME_BASED_CALENDAR_EVENT_KIND)
+        throw new Error("Event is not a date-based or time-based calendar event");
+    return getOrComputeCachedValue(event, CalendarEventHashtagsSymbol, () => {
+        return event.tags.filter(isTTag).map((t) => t[1]);
+    });
+}
+/** Gets all references from a calendar event */
+export function getCalendarEventReferences(event) {
+    if (event.kind !== DATE_BASED_CALENDAR_EVENT_KIND && event.kind !== TIME_BASED_CALENDAR_EVENT_KIND)
+        throw new Error("Event is not a date-based or time-based calendar event");
+    return getOrComputeCachedValue(event, CalendarEventReferencesSymbol, () => {
+        return event.tags.filter(isRTag).map((t) => t[1]);
+    });
+}

package/dist/helpers/calendar-rsvp.d.ts

@@ -0,0 +1,15 @@
+import { NostrEvent } from "nostr-tools";
+import { AddressPointer, EventPointer, ProfilePointer } from "nostr-tools/nip19";
+export declare const CALENDAR_EVENT_RSVP_KIND = 31925;
+export type RSVPStatus = "accepted" | "declined" | "tentative";
+export type RSVPFreeBusy = "free" | "busy";
+/** Gets the RSVP status from a calendar event RSVP */
+export declare function getRSVPStatus(event: NostrEvent): RSVPStatus | undefined;
+/** Gets the free/busy status from a calendar event RSVP (will be undefined if the RSVP is declined) */
+export declare function getRSVPFreeBusy(event: NostrEvent): RSVPFreeBusy | undefined;
+/** Gets the referenced calendar event coordinate that the RSVP is responding to */
+export declare function getRSVPAddressPointer(event: NostrEvent): AddressPointer | undefined;
+/** Gets the referenced calendar event pointer that the RSVP is responding to */
+export declare function getRSVPEventPointer(event: NostrEvent): EventPointer | undefined;
+/** Gets the profile pointer that the RSVP is responding to */
+export declare function getRSVPProfilePointer(event: NostrEvent): ProfilePointer | undefined;

package/dist/helpers/calendar-rsvp.js

@@ -0,0 +1,38 @@
+import { getTagValue } from "./event-tags.js";
+import { getAddressPointerFromATag, getEventPointerFromETag, getProfilePointerFromPTag } from "./pointers.js";
+import { isATag, isETag, isPTag } from "./tags.js";
+export const CALENDAR_EVENT_RSVP_KIND = 31925;
+/** Gets the RSVP status from a calendar event RSVP */
+export function getRSVPStatus(event) {
+    const status = getTagValue(event, "status");
+    return status && ["accepted", "declined", "tentative"].includes(status) ? status : undefined;
+}
+/** Gets the free/busy status from a calendar event RSVP (will be undefined if the RSVP is declined) */
+export function getRSVPFreeBusy(event) {
+    const status = getRSVPStatus(event);
+    if (status === "declined")
+        return undefined;
+    const fb = getTagValue(event, "fb");
+    return fb && ["free", "busy"].includes(fb) ? fb : undefined;
+}
+/** Gets the referenced calendar event coordinate that the RSVP is responding to */
+export function getRSVPAddressPointer(event) {
+    const tag = event.tags.find(isATag);
+    if (!tag)
+        return undefined;
+    return getAddressPointerFromATag(tag);
+}
+/** Gets the referenced calendar event pointer that the RSVP is responding to */
+export function getRSVPEventPointer(event) {
+    const tag = event.tags.find(isETag);
+    if (!tag)
+        return undefined;
+    return getEventPointerFromETag(tag);
+}
+/** Gets the profile pointer that the RSVP is responding to */
+export function getRSVPProfilePointer(event) {
+    const tag = event.tags.find(isPTag);
+    if (!tag)
+        return undefined;
+    return getProfilePointerFromPTag(tag);
+}

package/dist/helpers/calendar.d.ts

@@ -0,0 +1,6 @@
+import { NostrEvent } from "nostr-tools";
+import { AddressPointer } from "nostr-tools/nip19";
+/** Gets the title of a calendar */
+export declare function getCalendarTitle(event: NostrEvent): string | undefined;
+/** Gets the address pointers to all the events on the calendar */
+export declare function getCalendarAddressPointers(event: NostrEvent): AddressPointer[];

package/dist/helpers/calendar.js

@@ -0,0 +1,11 @@
+import { getTagValue } from "./event-tags.js";
+import { getAddressPointerFromATag } from "./pointers.js";
+import { isATag } from "./tags.js";
+/** Gets the title of a calendar */
+export function getCalendarTitle(event) {
+    return getTagValue(event, "title");
+}
+/** Gets the address pointers to all the events on the calendar */
+export function getCalendarAddressPointers(event) {
+    return event.tags.filter(isATag).map(getAddressPointerFromATag);
+}

package/dist/helpers/index.d.ts

@@ -4,6 +4,9 @@ export * from "./blossom.js";
 export * from "./bolt11.js";
 export * from "./bookmarks.js";
 export * from "./cache.js";
+export * from "./calendar-event.js";
+export * from "./calendar-rsvp.js";
+export * from "./calendar.js";
 export * from "./channels.js";
 export * from "./comment.js";
 export * from "./contacts.js";

package/dist/helpers/index.js

@@ -4,6 +4,9 @@ export * from "./blossom.js";
 export * from "./bolt11.js";
 export * from "./bookmarks.js";
 export * from "./cache.js";
+export * from "./calendar-event.js";
+export * from "./calendar-rsvp.js";
+export * from "./calendar.js";
 export * from "./channels.js";
 export * from "./comment.js";
 export * from "./contacts.js";

package/dist/helpers/pointers.js

@@ -187,7 +187,7 @@ export function addRelayHintsToPointer(pointer, relays) {
 /** Gets the hex pubkey from any nip-19 encoded string */
 export function normalizeToPubkey(str) {
     if (isHexKey(str))
-        return str;
+        return str.toLowerCase();
     else {
         const decode = nip19.decode(str);
         const pubkey = getPubkeyFromDecodeResult(decode);

package/dist/models/calendar.d.ts

@@ -0,0 +1,6 @@
+import { NostrEvent } from "nostr-tools";
+import { Model } from "../event-store/interface.js";
+/** A model that gets all the events for a calendar */
+export declare function CalendarEventsModel(calendar: NostrEvent): Model<NostrEvent[]>;
+/** A model that gets all the RSVPs for a calendar event */
+export declare function CalendarEventRSVPsModel(event: NostrEvent): Model<NostrEvent[]>;

package/dist/models/calendar.js

@@ -0,0 +1,15 @@
+import { combineLatest } from "rxjs";
+import { CALENDAR_EVENT_RSVP_KIND } from "../helpers/calendar-rsvp.js";
+import { getCalendarAddressPointers } from "../helpers/calendar.js";
+import { getReplaceableAddress } from "../helpers/index.js";
+import { defined } from "../observable/defined.js";
+/** A model that gets all the events for a calendar */
+export function CalendarEventsModel(calendar) {
+    return (events) => combineLatest(getCalendarAddressPointers(calendar).map((p) => events.replaceable(p.kind, p.pubkey, p.identifier).pipe(defined())));
+}
+/** A model that gets all the RSVPs for a calendar event */
+export function CalendarEventRSVPsModel(event) {
+    return (events) => {
+        return events.timeline({ kinds: [CALENDAR_EVENT_RSVP_KIND], "#a": [getReplaceableAddress(event)] });
+    };
+}

package/dist/models/index.d.ts

@@ -1,5 +1,6 @@
 export * from "./blossom.js";
 export * from "./bookmarks.js";
+export * from "./calendar.js";
 export * from "./channels.js";
 export * from "./comments.js";
 export * from "./common.js";

package/dist/models/index.js

@@ -1,5 +1,6 @@
 export * from "./blossom.js";
 export * from "./bookmarks.js";
+export * from "./calendar.js";
 export * from "./channels.js";
 export * from "./comments.js";
 export * from "./common.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "applesauce-core",
-  "version": "0.0.0-next-20250703183032",
+  "version": "0.0.0-next-20250723224513",
   "description": "",
   "type": "module",
   "main": "dist/index.js",

package/dist/__tests__/fixtures.d.ts

@@ -1,17 +0,0 @@
-import type { NostrEvent } from "nostr-tools";
-import { EncryptedContentSigner } from "../helpers/encrypted-content.js";
-export declare class FakeUser implements EncryptedContentSigner {
-    key: Uint8Array<ArrayBufferLike>;
-    pubkey: string;
-    nip04: {
-        encrypt: (pubkey: string, plaintext: string) => string;
-        decrypt: (pubkey: string, ciphertext: string) => string;
-    };
-    nip44: {
-        encrypt: (pubkey: string, plaintext: string) => string;
-        decrypt: (pubkey: string, ciphertext: string) => string;
-    };
-    event(data?: Partial<NostrEvent>): NostrEvent;
-    note(content?: string, extra?: Partial<NostrEvent>): import("nostr-tools").Event;
-    profile(profile: any, extra?: Partial<NostrEvent>): import("nostr-tools").Event;
-}

package/dist/__tests__/fixtures.js

@@ -1,28 +0,0 @@
-import { finalizeEvent, generateSecretKey, getPublicKey, kinds, nip04, nip44 } from "nostr-tools";
-import { unixNow } from "../helpers/time.js";
-export class FakeUser {
-    key = generateSecretKey();
-    pubkey = getPublicKey(this.key);
-    nip04 = {
-        encrypt: (pubkey, plaintext) => nip04.encrypt(this.key, pubkey, plaintext),
-        decrypt: (pubkey, ciphertext) => nip04.decrypt(this.key, pubkey, ciphertext),
-    };
-    nip44 = {
-        encrypt: (pubkey, plaintext) => nip44.encrypt(plaintext, nip44.getConversationKey(this.key, pubkey)),
-        decrypt: (pubkey, ciphertext) => nip44.decrypt(ciphertext, nip44.getConversationKey(this.key, pubkey)),
-    };
-    event(data) {
-        return finalizeEvent({
-            kind: data?.kind ?? kinds.ShortTextNote,
-            content: data?.content || "",
-            created_at: data?.created_at ?? unixNow(),
-            tags: data?.tags || [],
-        }, this.key);
-    }
-    note(content = "Hello World", extra) {
-        return this.event({ kind: kinds.ShortTextNote, content, ...extra });
-    }
-    profile(profile, extra) {
-        return this.event({ kind: kinds.Metadata, content: JSON.stringify({ ...profile }), ...extra });
-    }
-}