docs(timestamp): clarify timestamp = delivery/feed-freshness (OpticOdds-parity) (#10)

The API now emits a single per-odd `timestamp` (delivery/last-refreshed,
advances every ingest cycle, matching OpticOdds) — replacing
`odds_changed_at`/`last_seen_at`/`wire_received_at` (sharp-api-go #751).
The SDK already modeled `timestamp` (was always null); this documents
its semantics on `NormalizedOdds`. No type change. Bump 0.5.0.

Refs SHA-1048
Type: docs

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: paperclip-resolver[bot] <3736210+paperclip-resolver[bot]@users.noreply.github.com>
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: 3 people

CHANGELOG.md

@@ -2,6 +2,17 @@
 
 All notable changes to `@sharp-api/client` are documented here.
 
+## 0.5.0 — 2026-06-02
+
+### Changed
+
+- `NormalizedOdds.timestamp` documented as the **delivery / last-refreshed**
+  feed-freshness timestamp (advances every ingest cycle), matching OpticOdds'
+  `timestamp` — NOT a price-last-changed time. The API now populates this field
+  (previously always `null`). The removed `odds_changed_at` / `last_seen_at` /
+  `wire_received_at` were never modeled by this SDK, so no type change is
+  needed. (SHA-1048)
+
 ## 0.4.0 — 2026-05-31
 
 ### Added

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sharp-api/client",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Official TypeScript/JavaScript client for the SharpAPI real-time sports betting odds API",
   "type": "module",
   "main": "./dist/index.cjs",

src/index.ts

@@ -304,6 +304,11 @@ export interface NormalizedOdds extends NestedRefs {
   odds: OddsValue
   line?: number
   eventStartTime: string
+  /**
+   * ISO 8601 — when SharpAPI last refreshed this odd through its pipeline
+   * (advances every ingest cycle). A feed-freshness / delivery signal matching
+   * OpticOdds' `timestamp`; NOT a price-last-changed time. (SHA-1048)
+   */
   timestamp: string
   isLive: boolean
   /**