docs(timestamp): document timestamp as delivery/feed-freshness (OpticOdds-parity) + bump 0.5.0

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. The SDK already modeled `timestamp` (was always
null); this clarifies its semantics on NormalizedOdds. No type change.

Refs SHA-1048
Type: docs
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: paperclip-resolver[bot]

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
   /**