import { db, type DittoDB } from '@/db.ts'; import { Debug, type Event, type SelectQueryBuilder } from '@/deps.ts'; import { isParameterizedReplaceableKind } from '@/kinds.ts'; import { jsonMetaContentSchema } from '@/schemas/nostr.ts'; import { EventData } from '@/types.ts'; import { isNostrId, isURL } from '@/utils.ts'; import type { DittoFilter, GetFiltersOpts } from '@/filter.ts'; const debug = Debug('ditto:db:events'); /** Function to decide whether or not to index a tag. */ type TagCondition = ({ event, count, value }: { event: Event; data: EventData; count: number; value: string; }) => boolean; /** Conditions for when to index certain tags. */ const tagConditions: Record = { 'd': ({ event, count }) => count === 0 && isParameterizedReplaceableKind(event.kind), 'e': ({ count, value }) => count < 15 && isNostrId(value), 'media': ({ count, value, data }) => (data.user || count < 4) && isURL(value), 'p': ({ event, count, value }) => (count < 15 || event.kind === 3) && isNostrId(value), 'proxy': ({ count, value }) => count === 0 && isURL(value), 'q': ({ event, count, value }) => count === 0 && event.kind === 1 && isNostrId(value), 't': ({ count, value }) => count < 5 && value.length < 50, }; /** Insert an event (and its tags) into the database. */ function insertEvent(event: Event, data: EventData): Promise { debug('insertEvent', JSON.stringify(event)); return db.transaction().execute(async (trx) => { /** Insert the event into the database. */ async function addEvent() { await trx.insertInto('events') .values({ ...event, tags: JSON.stringify(event.tags) }) .execute(); } /** Add search data to the FTS table. */ async function indexSearch() { const searchContent = buildSearchContent(event); if (!searchContent) return; await trx.insertInto('events_fts') .values({ id: event.id, content: searchContent.substring(0, 1000) }) .execute(); } /** Index event tags depending on the conditions defined above. */ async function indexTags() { const tags = filterIndexableTags(event, data); const rows = tags.map(([tag, value]) => ({ event_id: event.id, tag, value })); if (!tags.length) return; await trx.insertInto('tags') .values(rows) .execute(); } // Run the queries. await Promise.all([ addEvent(), indexTags(), indexSearch(), ]); }).catch((error) => { // Don't throw for duplicate events. if (error.message.includes('UNIQUE constraint failed')) { return; } else { throw error; } }); } type EventQuery = SelectQueryBuilder; /** Build the query for a filter. */ function getFilterQuery(filter: DittoFilter): EventQuery { let query = db .selectFrom('events') .select([ 'events.id', 'events.kind', 'events.pubkey', 'events.content', 'events.tags', 'events.created_at', 'events.sig', ]) .orderBy('events.created_at', 'desc'); for (const [key, value] of Object.entries(filter)) { if (value === undefined) continue; switch (key as keyof DittoFilter) { case 'ids': query = query.where('events.id', 'in', filter.ids!); break; case 'kinds': query = query.where('events.kind', 'in', filter.kinds!); break; case 'authors': query = query.where('events.pubkey', 'in', filter.authors!); break; case 'since': query = query.where('events.created_at', '>=', filter.since!); break; case 'until': query = query.where('events.created_at', '<=', filter.until!); break; case 'limit': query = query.limit(filter.limit!); break; } if (key.startsWith('#')) { const tag = key.replace(/^#/, ''); const value = filter[key as `#${string}`] as string[]; query = query .leftJoin('tags', 'tags.event_id', 'events.id') .where('tags.tag', '=', tag) .where('tags.value', 'in', value); } } if (typeof filter.local === 'boolean') { query = filter.local ? query.innerJoin('users', 'users.pubkey', 'events.pubkey') as typeof query : query.leftJoin('users', 'users.pubkey', 'events.pubkey').where('users.pubkey', 'is', null) as typeof query; } if (filter.relations?.includes('author')) { query = query .leftJoin( (eb) => eb .selectFrom('events') .selectAll() .where('kind', '=', 0) .groupBy('pubkey') .as('authors'), (join) => join.onRef('authors.pubkey', '=', 'events.pubkey'), ) .select([ 'authors.id as author_id', 'authors.kind as author_kind', 'authors.pubkey as author_pubkey', 'authors.content as author_content', 'authors.tags as author_tags', 'authors.created_at as author_created_at', 'authors.sig as author_sig', ]); } if (filter.relations?.includes('author_stats')) { query = query .leftJoin('author_stats', 'author_stats.pubkey', 'events.pubkey') .select((eb) => [ eb.fn.coalesce('author_stats.followers_count', eb.val(0)).as('author_stats_followers_count'), eb.fn.coalesce('author_stats.following_count', eb.val(0)).as('author_stats_following_count'), eb.fn.coalesce('author_stats.notes_count', eb.val(0)).as('author_stats_notes_count'), ]); } if (filter.relations?.includes('event_stats')) { query = query .leftJoin('event_stats', 'event_stats.event_id', 'events.id') .select((eb) => [ eb.fn.coalesce('event_stats.replies_count', eb.val(0)).as('stats_replies_count'), eb.fn.coalesce('event_stats.reposts_count', eb.val(0)).as('stats_reposts_count'), eb.fn.coalesce('event_stats.reactions_count', eb.val(0)).as('stats_reactions_count'), ]); } if (filter.search) { query = query .innerJoin('events_fts', 'events_fts.id', 'events.id') .where('events_fts.content', 'match', JSON.stringify(filter.search)); } return query; } /** Combine filter queries into a single union query. */ function getFiltersQuery(filters: DittoFilter[]) { return filters .map((filter) => db.selectFrom(() => getFilterQuery(filter).as('events')).selectAll()) .reduce((result, query) => result.unionAll(query)); } type AuthorStats = Omit; type EventStats = Omit; interface DittoEvent extends Event { author?: DittoEvent<0>; author_stats?: AuthorStats; event_stats?: EventStats; } /** Get events for filters from the database. */ async function getFilters( filters: DittoFilter[], opts: GetFiltersOpts = {}, ): Promise[]> { if (!filters.length) return Promise.resolve([]); debug('REQ', JSON.stringify(filters)); let query = getFiltersQuery(filters); if (typeof opts.limit === 'number') { query = query.limit(opts.limit); } return (await query.execute()).map((row) => { const event: DittoEvent = { id: row.id, kind: row.kind as K, pubkey: row.pubkey, content: row.content, created_at: row.created_at, tags: JSON.parse(row.tags), sig: row.sig, }; if (row.author_id) { event.author = { id: row.author_id, kind: row.author_kind! as 0, pubkey: row.author_pubkey!, content: row.author_content!, created_at: row.author_created_at!, tags: JSON.parse(row.author_tags!), sig: row.author_sig!, }; } if (typeof row.author_stats_followers_count === 'number') { event.author_stats = { followers_count: row.author_stats_followers_count, following_count: row.author_stats_following_count!, notes_count: row.author_stats_notes_count!, }; } if (typeof row.stats_replies_count === 'number') { event.event_stats = { replies_count: row.stats_replies_count, reposts_count: row.stats_reposts_count!, reactions_count: row.stats_reactions_count!, }; } return event; }); } /** Delete events based on filters from the database. */ function deleteFilters(filters: DittoFilter[]) { if (!filters.length) return Promise.resolve([]); debug('deleteFilters', JSON.stringify(filters)); return db.transaction().execute(async (trx) => { const query = getFiltersQuery(filters).clearSelect().select('id'); await trx.deleteFrom('events_fts') .where('id', 'in', () => query) .execute(); return trx.deleteFrom('events') .where('id', 'in', () => query) .execute(); }); } /** Get number of events that would be returned by filters. */ async function countFilters(filters: DittoFilter[]): Promise { if (!filters.length) return Promise.resolve(0); debug('countFilters', JSON.stringify(filters)); const query = getFiltersQuery(filters); const [{ count }] = await query .clearSelect() .select((eb) => eb.fn.count('id').as('count')) .execute(); return Number(count); } /** Return only the tags that should be indexed. */ function filterIndexableTags(event: Event, data: EventData): string[][] { const tagCounts: Record = {}; function getCount(name: string) { return tagCounts[name] || 0; } function incrementCount(name: string) { tagCounts[name] = getCount(name) + 1; } function checkCondition(name: string, value: string, condition: TagCondition) { return condition({ event, data, count: getCount(name), value, }); } return event.tags.reduce((results, tag) => { const [name, value] = tag; const condition = tagConditions[name] as TagCondition | undefined; if (value && condition && value.length < 200 && checkCondition(name, value, condition)) { results.push(tag); } incrementCount(name); return results; }, []); } /** Build a search index from the event. */ function buildSearchContent(event: Event): string { switch (event.kind) { case 0: return buildUserSearchContent(event as Event<0>); case 1: return event.content; default: return ''; } } /** Build search content for a user. */ function buildUserSearchContent(event: Event<0>): string { const { name, nip05, about } = jsonMetaContentSchema.parse(event.content); return [name, nip05, about].filter(Boolean).join('\n'); } export { countFilters, deleteFilters, type DittoEvent, getFilters, insertEvent };