fix: drop venue-typed source enums; align examples with market_reporting (#4175)

CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.2] - 2026-07-10
+
+### Changed
+
+- Loosen `source` typing and align examples with the API's masked source labels: the response `source` now returns `market_reporting` for non-government series (government labels like `EIA`/`opec.org` are unchanged). The `FuturesPrice.source` field remains a free `string` (no venue enum); doc-comment and test fixture examples no longer use venue names such as `ICE`. See oilpriceapi-api#4175.
+
 ## [1.0.1] - 2026-07-03
 
 ### Changed

package.json

@@ -1,6 +1,6 @@
 {
   "name": "oilpriceapi",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Official Node.js SDK for Oil Price API - Real-time and historical oil & commodity prices",
   "type": "module",
   "main": "./dist/cjs/index.js",

src/resources/futures.ts

@@ -49,7 +49,7 @@ export interface FuturesContractMonth {
 export interface FuturesPrice {
   /** Commodity identifier (e.g. "BRENT_FUTURES"). */
   commodity?: string;
-  /** Data source (e.g. "ICE"). */
+  /** Data source label (e.g. "market_reporting", or a government label like "EIA"). */
   source?: string;
   /** ISO timestamp the data was last updated. */
   updated_at?: string;

src/version.ts

@@ -7,7 +7,7 @@
  * - X-Client-Version header
  * - Package.json (should match)
  */
-export const SDK_VERSION = "1.0.1";
+export const SDK_VERSION = "1.0.2";
 
 /**
  * SDK identifier used in User-Agent and X-Api-Client headers

tests/resources/futures.test.ts

@@ -25,7 +25,7 @@ describe("FuturesResource", () => {
       // structure in contracts[].
       const mockPrice: FuturesPrice = {
         commodity: "WTI_FUTURES",
-        source: "ICE",
+        source: "market_reporting",
         updated_at: "2024-01-15T10:00:00Z",
         settlement_date: "2024-01-15",
         front_month: {