Add DittoEvent and DittoFilter dedicated interface modules

src/interfaces/DittoEvent.ts

@@ -0,0 +1,24 @@
+import { type NostrEvent } from '@/deps.ts';
+
+/** Ditto internal stats for the event's author. */
+export interface AuthorStats {
+  followers_count: number;
+  following_count: number;
+  notes_count: number;
+}
+
+/** Ditto internal stats for the event. */
+export interface EventStats {
+  replies_count: number;
+  reposts_count: number;
+  reactions_count: number;
+}
+
+/** Internal Event representation used by Ditto, including extra keys. */
+export interface DittoEvent extends NostrEvent {
+  author?: DittoEvent;
+  author_stats?: AuthorStats;
+  event_stats?: EventStats;
+  d_author?: DittoEvent;
+  user?: DittoEvent;
+}

src/interfaces/DittoFilter.ts

@@ -0,0 +1,14 @@
+import { type NostrEvent, type NostrFilter } from '@/deps.ts';
+
+import { type DittoEvent } from './DittoEvent.ts';
+
+/** Additional properties that may be added by Ditto to events. */
+export type DittoRelation = Exclude<keyof DittoEvent, keyof NostrEvent>;
+
+/** Custom filter interface that extends Nostr filters with extra options for Ditto. */
+export interface DittoFilter extends NostrFilter {
+  /** Whether the event was authored by a local user. */
+  local?: boolean;
+  /** Additional fields to add to the returned event. */
+  relations?: DittoRelation[];
+}