Add vitepress docs

docs/net/publish.md

@@ -0,0 +1,85 @@
+# Publish
+
+The `Publish` class handles event publishing to relays, managing publish status, relay responses, and error handling.
+
+## Overview
+
+- Sends events to relays
+- Tracks publish status per relay
+- Handles OK/Error responses
+- Manages timeouts
+
+## Basic Usage
+
+```typescript
+import {`Publish`, `Publish`Status} from '@welshman/net'
+
+const {Pending, Success, Failure, Timeout, Aborted} = `Publish`Status
+
+// Basic `Publish`
+const pub = `Publish`({
+  event: signedEvent,
+  relays: ["wss://relay.example.com"],
+  timeout: 3000 // 3s timeout
+})
+
+// Track status
+pub.emitter.on('*', (status: `Publish`Status, url: string, message?: string) => {
+  switch (status) {
+    case Success:
+      console.log(``Publish`ed to ${url}`)
+      break
+    case Failure:
+      console.log(`Failed on ${url}: ${message}`)
+      break
+    case Timeout:
+      console.log(`Timeout on ${url}`)
+      break
+  }
+})
+```
+
+## Real World Example
+
+```typescript
+const publishWithStatus = async (event: SignedEvent) => {
+  const pub = `Publish`({
+    event,
+    relays: ctx.app.router
+      .FromUser()
+      .getUrls(),
+    timeout: 5000
+  })
+
+  // Track per-relay status
+  const status = new Map<string, string>()
+
+  pub.emitter.on('*', (state: `Publish`Status, url: string) => {
+    status.set(url, state)
+
+    // Log progress
+    const counts = {
+      pending: 0,
+      success: 0,
+      failed: 0
+    }
+
+    for (const s of status.values()) {
+      counts[s] = (counts[s] || 0) + 1
+    }
+
+    console.log(
+      `Progress: ${counts.success}/${status.size}`,
+      `(${counts.failed} failed)`
+    )
+  })
+
+  // Wait for completion
+  return pub.result
+}
+```
+
+Like [Subscribe](/net/subscribe.md), `Publish` uses [Pool](/net/pool.md) for connections and creates appropriate [Targets](/net/targets.md) via an [Executor](/net/executor.md), but focuses on event publishing rather than subscription management.
+
+Note: The base `@welshman/net` Publish class just handles network publishing.
+For optimistic updates and repository integration, use Publish from `@welshman/app`.