Merge remote-tracking branch 'origin/main' into sync/hosted-docs

Author: realfishsam

changelog.md

@@ -2,6 +2,15 @@
 
 All notable changes to this project will be documented in this file.
 
+## [2.48.6] - 2026-06-04
+
+### Fixed
+
+- **Opinion**: `resolutionDate` on Opinion markets no longer collapses to `1970-01-01T00:00:00Z` when the upstream `cutoffAt` is missing or `0`. Root cause: `toMillis(0)` returned `0`, which the normalizer then wrapped in `new Date(0)` and emitted as a valid-looking past date. Categorical child markets (e.g. `2026 FIFA World Cup Winner - Spain`) are the common case — Opinion publishes `cutoffAt` only on the parent, not on each child — so every child silently inherited epoch and was filtered out by any downstream `closes_at > now()` guard. Concretely, hosted-pmxt's `fetchMarketMatches` was dropping all Opinion ↔ Polymarket pairs (407 in the catalog, 13 FIFA-specific) because the Opinion side looked already-closed.
+- **Opinion**: `normalizeChildMarket` now inherits `parent.cutoffAt` via `child.cutoffAt || parent.cutoffAt`, so the fallback introduced in commit `6ac8cd1` actually fires for the `cutoffAt = 0` case (the upstream literal, not a missing field).
+- **Core**: `toMillis(ts)` in `opinion/utils.ts` now returns `null` for falsy input instead of `0`, so callers can distinguish "no timestamp" from "epoch" and stop materializing bogus 1970 dates. Trade/order normalizers preserve old behavior with `?? 0`.
+- **Core**: `UnifiedMarket.resolutionDate` is now `?: Date`. Not every venue publishes a resolution date on every market, and the optional type lets normalizers emit `undefined` instead of fabricating an epoch sentinel. `BaseExchange.filterByCriteria` and the Baozi normalizer handle the optional case (markets without a known resolution date pass an `active`-status filter, fail a `closed`-status filter, and sort last under `sort=newest`).
+
 ## [2.48.5] - 2026-06-02
 
 ### Fixed

core/api-doc-config.generated.json

@@ -1,5 +1,5 @@
 {
-    "_generated": "Auto-generated by extract-jsdoc.js on 2026-06-02T00:34:44.916Z. Do not edit manually.",
+    "_generated": "Auto-generated by extract-jsdoc.js on 2026-06-08T08:31:38.004Z. Do not edit manually.",
     "methods": {
         "has": {
             "summary": "HTTP verb for the endpoint (e.g. GET, POST). */",
@@ -566,7 +566,7 @@
                 "type": "UnifiedEvent[]",
                 "description": "Filtered array of events"
             },
-            "source": "BaseExchange.ts:1317"
+            "source": "BaseExchange.ts:1318"
         },
         "watchOrderBook": {
             "summary": "Watch order book updates in real-time via WebSocket.",
@@ -595,7 +595,7 @@
                 "type": "OrderBook",
                 "description": "Promise that resolves with the current orderbook state"
             },
-            "source": "BaseExchange.ts:1413"
+            "source": "BaseExchange.ts:1414"
         },
         "watchOrderBooks": {
             "summary": "Watch multiple order books simultaneously via WebSocket.",
@@ -624,7 +624,7 @@
                 "type": "Record<string, OrderBook>",
                 "description": "Promise that resolves with order books keyed by ID"
             },
-            "source": "BaseExchange.ts:1426"
+            "source": "BaseExchange.ts:1427"
         },
         "unwatchOrderBook": {
             "summary": "Unsubscribe from a previously watched order book stream.",
@@ -641,7 +641,7 @@
                 "type": "void",
                 "description": "Result"
             },
-            "source": "BaseExchange.ts:1454"
+            "source": "BaseExchange.ts:1455"
         },
         "watchTrades": {
             "summary": "Watch trade executions in real-time via WebSocket.",
@@ -676,7 +676,7 @@
                 "type": "Trade[]",
                 "description": "Promise that resolves with recent trades"
             },
-            "source": "BaseExchange.ts:1467"
+            "source": "BaseExchange.ts:1468"
         },
         "watchAddress": {
             "summary": "Stream activity for a public wallet address",
@@ -699,7 +699,7 @@
                 "type": "SubscribedAddressSnapshot",
                 "description": "Promise that resolves with the latest SubscribedAddressSnapshot snapshot"
             },
-            "source": "BaseExchange.ts:1481"
+            "source": "BaseExchange.ts:1482"
         },
         "unwatchAddress": {
             "summary": "Stop watching a previously registered wallet address and release its resource updates.",
@@ -716,7 +716,7 @@
                 "type": "void",
                 "description": "Result"
             },
-            "source": "BaseExchange.ts:1494"
+            "source": "BaseExchange.ts:1495"
         },
         "close": {
             "summary": "Close all WebSocket connections and clean up resources.",
@@ -726,7 +726,7 @@
                 "type": "void",
                 "description": "Result"
             },
-            "source": "BaseExchange.ts:1503"
+            "source": "BaseExchange.ts:1504"
         },
         "fetchMarketMatches": {
             "summary": "Find the same or related market on other venues. Two modes:",
@@ -743,7 +743,7 @@
                 "type": "MatchResult[]",
                 "description": "Array of matched markets with relation and confidence"
             },
-            "source": "BaseExchange.ts:1517"
+            "source": "BaseExchange.ts:1518"
         },
         "fetchMatches": {
             "summary": "fetchMatches",
@@ -760,7 +760,7 @@
                 "type": "MatchResult[]",
                 "description": "Result"
             },
-            "source": "BaseExchange.ts:1533"
+            "source": "BaseExchange.ts:1534"
         },
         "fetchEventMatches": {
             "summary": "Find the same or related event on other venues. Two modes:",
@@ -777,7 +777,7 @@
                 "type": "EventMatchResult[]",
                 "description": "Array of matched events with market-level match details"
             },
-            "source": "BaseExchange.ts:1541"
+            "source": "BaseExchange.ts:1542"
         },
         "compareMarketPrices": {
             "summary": "Compare live prices for the same market across venues. Finds identity matches and returns side-by-side best bid/ask prices so you can spot price differences at a glance.",
@@ -794,7 +794,7 @@
                 "type": "PriceComparison[]",
                 "description": "Array of price comparisons across venues"
             },
-            "source": "BaseExchange.ts:1557"
+            "source": "BaseExchange.ts:1558"
         },
         "fetchRelatedMarkets": {
             "summary": "Find related markets across venues. Discovers subset/superset market relationships",
@@ -811,7 +811,7 @@
                 "type": "PriceComparison[]",
                 "description": "Array of subset/superset matches with live prices"
             },
-            "source": "BaseExchange.ts:1567"
+            "source": "BaseExchange.ts:1568"
         },
         "fetchMatchedMarkets": {
             "summary": "fetchMatchedMarkets",
@@ -828,7 +828,7 @@
                 "type": "MatchedMarketPair[]",
                 "description": "Result"
             },
-            "source": "BaseExchange.ts:1578"
+            "source": "BaseExchange.ts:1579"
         },
         "fetchMatchedPrices": {
             "summary": "fetchMatchedPrices",
@@ -845,7 +845,7 @@
                 "type": "MatchedPricePair[]",
                 "description": "Array of matched market pairs with prices from each venue"
             },
-            "source": "BaseExchange.ts:1586"
+            "source": "BaseExchange.ts:1587"
         },
         "fetchHedges": {
             "summary": "fetchHedges",
@@ -862,7 +862,7 @@
                 "type": "PriceComparison[]",
                 "description": "Array of subset/superset matches with live prices"
             },
-            "source": "BaseExchange.ts:1597"
+            "source": "BaseExchange.ts:1598"
         },
         "fetchArbitrage": {
             "summary": "fetchArbitrage",
@@ -879,7 +879,7 @@
                 "type": "ArbitrageOpportunity[]",
                 "description": "Array of arbitrage opportunities sorted by spread"
             },
-            "source": "BaseExchange.ts:1607"
+            "source": "BaseExchange.ts:1608"
         },
         "watchPrices": {
             "summary": "Watch AMM price updates for a market address (Limitless only).",
@@ -950,7 +950,7 @@
                 "description": "Result"
             },
             "exchangeOnly": "polymarket",
-            "source": "index.ts:143"
+            "source": "index.ts:144"
         },
         "preWarmMarket": {
             "summary": "Pre-warm the SDK's internal caches for a market outcome.",
@@ -968,7 +968,7 @@
                 "description": "Result"
             },
             "exchangeOnly": "polymarket",
-            "source": "index.ts:209"
+            "source": "index.ts:210"
         },
         "getEventById": {
             "summary": "Fetch a single event by its numeric ID (Probable only).",