Add vitepress docs

docs/util/repository.md

@@ -0,0 +1,115 @@
+# Repository
+
+The Repository module provides a robust in-memory event storage system with indexing, querying, and event replacement capabilities.
+
+## Core Features
+
+- Event storage and indexing
+- Query support with multiple filters
+- Event replacement and deletion tracking
+- Event update notifications
+- Optimized indexes for common queries
+
+## Class Definition
+
+```typescript
+class Repository<E extends HashedEvent = TrustedEvent> extends Emitter {
+  // Storage indexes
+  eventsById = new Map<string, E>()
+  eventsByWrap = new Map<string, E>()
+  eventsByAddress = new Map<string, E>()
+  eventsByTag = new Map<string, E[]>()
+  eventsByDay = new Map<number, E[]>()
+  eventsByAuthor = new Map<string, E[]>()
+  eventsByKind = new Map<number, E[]>()
+  deletes = new Map<string, number>()
+}
+```
+
+## Core Methods
+
+### Event Management
+```typescript
+// Store or update event
+publish(event: E, opts = { shouldNotify: true }): boolean
+
+// Get event by ID or address
+getEvent(idOrAddress: string): E | undefined
+
+// Check if event exists
+hasEvent(event: E): boolean
+
+// Remove event
+removeEvent(idOrAddress: string): void
+
+// Check deletion status
+isDeleted(event: E): boolean
+isDeletedByAddress(event: E): boolean
+isDeletedById(event: E): boolean
+```
+
+### Querying
+```typescript
+// Query events with filters
+query(
+  filters: Filter[],
+  opts = {
+    includeDeleted: false,
+    shouldSort: true
+  }
+): E[]
+
+// Dump all events
+dump(): E[]
+
+// Load events in bulk
+load(events: E[], chunkSize = 1000): void
+```
+
+## Usage Examples
+
+### Basic Repository Operations
+```typescript
+// Create repository
+const repo = new Repository<TrustedEvent>()
+
+// Add events
+repo.publish(event)
+
+// Query events
+const events = repo.query([
+  { kinds: [1], limit: 100 }
+])
+
+// Check event status
+if (!repo.isDeleted(event)) {
+  processEvent(event)
+}
+```
+
+### Bulk Operations
+```typescript
+// Load multiple events
+repo.load(events, 500) // Process in chunks of 500
+
+// Get all events
+const allEvents = repo.dump()
+```
+
+### Query Examples
+```typescript
+// Query with multiple filters
+const events = repo.query([
+  // Recent events from specific authors
+  {
+    kinds: [1],
+    authors: ['pub1', 'pub2'],
+    since: now() - 24 * 60 * 60
+  },
+  // Events with specific tags
+  {
+    '#t': ['bitcoin', 'nostr'],
+    limit: 50
+  }
+])
+```