laplace-api 5.1.0 → 5.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "laplace-api",
-  "version": "5.1.0",
+  "version": "5.2.1",
   "description": "Client library for Laplace API for the US stock market and BIST (Istanbul stock market) fundamental financial data.",
   "main": "index.js",
   "scripts": {

package/src/client/news.ts

@@ -1,124 +1,170 @@
-import {Client} from "./client";
-import {Locale, Region} from "./collections";
-import {PaginatedResponse} from "./capital_increase";
-import {SortDirection} from "./broker";
+import { Client } from "./client";
+import { Locale, Region } from "./collections";
+import { PaginatedResponse } from "./capital_increase";
+import { SortDirection } from "./broker";
 
 export interface NewsHighlights {
-    consumer: string[];
-    energyAndUtilities: string[];
-    finance: string[];
-    healthcare: string[];
-    industrialsAndMaterials: string[];
-    tech: string[];
-    other: string[];
+  consumer: string[];
+  energyAndUtilities: string[];
+  finance: string[];
+  healthcare: string[];
+  industrialsAndMaterials: string[];
+  tech: string[];
+  other: string[];
 }
 
 export enum NewsType {
-    BRIEFS = "briefs",
-    BLOOMBERG = "bloomberg",
-    FDA = "fda",
-    REUTERS = "reuters",
+  BRIEFS = "briefs",
+  BLOOMBERG = "bloomberg",
+  FDA = "fda",
+  REUTERS = "reuters",
 }
 
 export enum NewsOrderBy {
-    TIMESTAMP = "timestamp",
+  TIMESTAMP = "timestamp",
 }
 
 export interface News {
-    url: string;
-    imageUrl: string;
-    timestamp: string;
-    publisherUrl: string;
-    publisher: NewsPublisher;
-    relatedTickers: NewsTicker[];
-    qualityScore: number;
-    createdAt: string;
-    tickers?: NewsTicker[];
-    categories?: NewsCategories;
-    sectors?: NewsSector;
-    content?: NewsContent;
-    industries?: NewsIndustry;
+  url: string;
+  imageUrl: string;
+  timestamp: string;
+  publisherUrl: string;
+  publisher: NewsPublisher;
+  relatedTickers: NewsTicker[];
+  qualityScore: number;
+  createdAt: string;
+  tickers?: NewsTicker[];
+  categories?: NewsCategories;
+  sectors?: NewsSector;
+  content?: NewsContent;
+  industries?: NewsIndustry;
 }
 
+export type NewsV2 = Omit<News, "relatedTickers">;
+
 export interface NewsPublisher {
-    name: string;
-    logoUrl: string | null;
+  name: string;
+  logoUrl: string | null;
 }
 
 export interface NewsTicker {
-    id: string;
-    name: string;
-    symbol?: string;
+  id: string;
+  name: string;
+  symbol?: string;
 }
 
 export interface NewsCategories {
-    name: string;
-    newsCount: number;
-    categoryType?: string | null;
-    meanType?: number | null;
+  name: string;
+  newsCount: number;
+  categoryType?: string | null;
+  meanType?: number | null;
 }
 
 export interface NewsSector {
-    name: string;
-    newsCount: number;
-    categoryType?: string | null;
-    meanType?: number | null;
+  name: string;
+  newsCount: number;
+  categoryType?: string | null;
+  meanType?: number | null;
 }
 
 export interface NewsContent {
-    title: string;
-    description: string;
-    content: string[];
-    summary: string[];
-    investorInsight: string;
+  title: string;
+  description: string;
+  content: string[];
+  summary: string[];
+  investorInsight: string;
 }
 
 export interface NewsIndustry {
-    name: string;
-    meanType: number;
+  name: string;
+  meanType: number;
 }
 
 export class NewsClient extends Client {
-    async getHighlights(
-        region: Region,
-        locale: Locale
-      ): Promise<NewsHighlights> {
-        return this.sendRequest<NewsHighlights>({
-          method: "GET",
-          url: "/api/v1/news/highlights",
-          params: {
-            region,
-            locale,
-          },
-        });
-      }
-      
-
-    async getNews(
-        region: Region,
-        locale: Locale,
-        newsType?: NewsType,
-        page?: number,
-        size?: number,
-        orderBy?: NewsOrderBy,
-        orderByDirection?: SortDirection,
-        extraFilters?: string
-      ): Promise<PaginatedResponse<News>> {
-        const params = {
-          region,
-          locale,
-          ...(newsType != null && { newsType }),
-          ...(page != null && { page }),
-          ...(size != null && { size }),
-          ...(orderBy != null && { orderBy }),
-          ...(orderByDirection != null && { orderByDirection }),
-          ...(extraFilters != null && { extraFilters }),
-        };
-      
-        return this.sendRequest<PaginatedResponse<News>>({
-          method: "GET",
-          url: "/api/v1/news",
-          params,
-        });
-      }      
+  async getHighlights(
+    region: Region,
+    locale: Locale
+  ): Promise<NewsHighlights> {
+    return this.sendRequest<NewsHighlights>({
+      method: "GET",
+      url: "/api/v1/news/highlights",
+      params: {
+        region,
+        locale,
+      },
+    });
+  }
+
+
+  async getNews(
+    region: Region,
+    locale: Locale,
+    newsType?: NewsType,
+    page?: number,
+    size?: number,
+    orderBy?: NewsOrderBy,
+    orderByDirection?: SortDirection,
+    extraFilters?: string
+  ): Promise<PaginatedResponse<News>> {
+    const params = {
+      region,
+      locale,
+      ...(newsType != null && { newsType }),
+      ...(page != null && { page }),
+      ...(size != null && { size }),
+      ...(orderBy != null && { orderBy }),
+      ...(orderByDirection != null && { orderByDirection }),
+      ...(extraFilters != null && { extraFilters }),
+    };
+
+    return this.sendRequest<PaginatedResponse<News>>({
+      method: "GET",
+      url: "/api/v1/news",
+      params,
+    });
+  }
+
+  async getNewsV2(
+    region: Region,
+    locale: Locale,
+    newsType?: NewsType,
+    page?: number,
+    size?: number,
+    orderBy?: NewsOrderBy,
+    orderByDirection?: SortDirection,
+    extraFilters?: string
+  ): Promise<PaginatedResponse<NewsV2>> {
+    const params = {
+      region,
+      locale,
+      ...(newsType != null && { newsType }),
+      ...(page != null && { page }),
+      ...(size != null && { size }),
+      ...(orderBy != null && { orderBy }),
+      ...(orderByDirection != null && { orderByDirection }),
+      ...(extraFilters != null && { extraFilters }),
+    };
+
+    return this.sendRequest<PaginatedResponse<NewsV2>>({
+      method: "GET",
+      url: "/api/v2/news",
+      params,
+    });
+  }
+
+  streamNews(
+    region: Region,
+    locale: Locale,
+    sectors?: string[],
+    tickers?: string[],
+    categories?: string[],
+    industries?: string[]
+  ): { events: AsyncIterable<NewsV2[]>, cancel: () => void } {
+    let url = `${this["baseUrl"]}/api/v1/news/stream?locale=${locale}&region=${region}`;
+    if (sectors?.length) url += `&sectors=${encodeURIComponent(sectors.join(","))}`;
+    if (tickers?.length) url += `&tickers=${encodeURIComponent(tickers.join(","))}`;
+    if (categories?.length) url += `&categories=${encodeURIComponent(categories.join(","))}`;
+    if (industries?.length) url += `&industries=${encodeURIComponent(industries.join(","))}`;
+    return this.sendSSERequest<NewsV2[]>(url);
+  }
 }

package/src/test/news.test.ts

@@ -1,4 +1,5 @@
 import { Logger } from "winston";
+import axios from "axios";
 import { LaplaceConfiguration } from "../utilities/configuration";
 import {
   NewsClient,
@@ -10,61 +11,66 @@ import { Region, Locale } from "../client/collections";
 import { SortDirection } from "../client/broker";
 
 const mockNewsHighlightsResponse = {
-    tech: [
-      "Alphabet ve Amazon'un desteğiyle Anthropic, 2026 başlarında Hindistan'ın Bengaluru kentinde bir ofis açacak."
-    ],
-    other: [
-      "ABD Yüksek Mahkemesi, Epic Games'in davası kapsamında Google'ın Play uygulamalarındaki değişikliği engellemeyecek."
-    ],
-    finance: [
-      "Fifth Third Bank, Comerica'yı 10,9 milyar dolara satın alacak ve böylece ABD'nin 9. en büyük bankası olacak."
-    ],
-    consumer: [
-      "Tesla, rekabet ortamında pazar payını geri almak için daha ucuz Model Y ve Model 3'ü piyasaya sürdü; duyuru hisseleri etkiledi."
-    ],
-    healthcare: [
-      "İlaç üreticileri, Amgen ve Novo Nordisk'in de dahil olduğu şekilde, Trump'ın ilaç fiyatlarını düşürme planıyla uyumlu olarak tele-sağlık satışlarını artırıyor."
-    ],
-    energyAndUtilities: [
-      "ABD Enerji Bakanlığı, Stellantis ve GM'ye verilen 1,1 milyar dolarlık hibeleri iptal edebilir."
-    ],
-    industrialsAndMaterials: [
-      "Boeing, bir grevi sona erdirmek için IAM Sendikası ile geçici bir anlaşmaya vardı; detaylar açıklanmadı."
-    ]
-  };
-  
-  const mockNewsResponse = {
-    items: [
-      {
-        url: "https://www.reuters.com/business/energy/commonwealth-lng-wants-more-time-build-planned-export-facility-louisiana-2025-10-07/",
-        content: {
-          title: "Commonwealth LNG wants more time to build planned export facility in Louisiana",
-          content: [
-            "Commonwealth LNG has requested a four-year extension from federal regulators to construct & begin exporting liquefied natural gas..."
-          ],
-          summary: [
-            "Commonwealth LNG has requested a four-year extension from federal regulators..."
-          ],
-          description:
-            "Commonwealth LNG has asked federal regulators for a four-year extension...",
-          investorInsight:
-            "What it means for investors: The extension request could postpone..."
-        },
-        sectors: { name: "Energy", meanType: 9, newsCount: 1 },
-        tickers: [{ id: "6203d1ba1e674875275558f7", name: "EQT Corp", symbol: "EQT" }],
-        imageUrl: "",
-        createdAt: "2025-10-07T17:10:01.560644Z",
-        publisher: { name: "Reuters", logoUrl: null },
-        timestamp: "2025-10-07T16:50:16Z",
-        categories: { name: "Sector News", newsCount: 1, categoryType: "StockSpesific" },
-        industries: { name: "Oil/Gas (Production and Exploration)", meanType: 78 },
-        publisherUrl: "Reuters",
-        qualityScore: 0,
-        relatedTickers: [{ id: "6203d1ba1e674875275558f7", name: "EQT Corp", symbol: "EQT" }]
-      }
-    ],
-    recordCount: 352
-  };
+  tech: [
+    "Alphabet ve Amazon'un desteğiyle Anthropic, 2026 başlarında Hindistan'ın Bengaluru kentinde bir ofis açacak."
+  ],
+  other: [
+    "ABD Yüksek Mahkemesi, Epic Games'in davası kapsamında Google'ın Play uygulamalarındaki değişikliği engellemeyecek."
+  ],
+  finance: [
+    "Fifth Third Bank, Comerica'yı 10,9 milyar dolara satın alacak ve böylece ABD'nin 9. en büyük bankası olacak."
+  ],
+  consumer: [
+    "Tesla, rekabet ortamında pazar payını geri almak için daha ucuz Model Y ve Model 3'ü piyasaya sürdü; duyuru hisseleri etkiledi."
+  ],
+  healthcare: [
+    "İlaç üreticileri, Amgen ve Novo Nordisk'in de dahil olduğu şekilde, Trump'ın ilaç fiyatlarını düşürme planıyla uyumlu olarak tele-sağlık satışlarını artırıyor."
+  ],
+  energyAndUtilities: [
+    "ABD Enerji Bakanlığı, Stellantis ve GM'ye verilen 1,1 milyar dolarlık hibeleri iptal edebilir."
+  ],
+  industrialsAndMaterials: [
+    "Boeing, bir grevi sona erdirmek için IAM Sendikası ile geçici bir anlaşmaya vardı; detaylar açıklanmadı."
+  ]
+};
+
+const mockNewsResponse = {
+  items: [
+    {
+      url: "https://www.reuters.com/business/energy/commonwealth-lng-wants-more-time-build-planned-export-facility-louisiana-2025-10-07/",
+      content: {
+        title: "Commonwealth LNG wants more time to build planned export facility in Louisiana",
+        content: [
+          "Commonwealth LNG has requested a four-year extension from federal regulators to construct & begin exporting liquefied natural gas..."
+        ],
+        summary: [
+          "Commonwealth LNG has requested a four-year extension from federal regulators..."
+        ],
+        description:
+          "Commonwealth LNG has asked federal regulators for a four-year extension...",
+        investorInsight:
+          "What it means for investors: The extension request could postpone..."
+      },
+      sectors: { name: "Energy", meanType: 9, newsCount: 1 },
+      tickers: [{ id: "6203d1ba1e674875275558f7", name: "EQT Corp", symbol: "EQT" }],
+      imageUrl: "",
+      createdAt: "2025-10-07T17:10:01.560644Z",
+      publisher: { name: "Reuters", logoUrl: null },
+      timestamp: "2025-10-07T16:50:16Z",
+      categories: { name: "Sector News", newsCount: 1, categoryType: "StockSpesific" },
+      industries: { name: "Oil/Gas (Production and Exploration)", meanType: 78 },
+      publisherUrl: "Reuters",
+      qualityScore: 0,
+      relatedTickers: [{ id: "6203d1ba1e674875275558f7", name: "EQT Corp", symbol: "EQT" }]
+    }
+  ],
+  recordCount: 352
+};
+
+const mockNewsV2Response = {
+  items: mockNewsResponse.items.map(({ relatedTickers, ...rest }) => rest),
+  recordCount: mockNewsResponse.recordCount
+};
 
 describe("NewsClient", () => {
   let client: NewsClient;
@@ -150,13 +156,13 @@ describe("NewsClient", () => {
           expect(typeof n.categories.newsCount).toBe("number");
           expect(
             typeof n.categories.categoryType === "string" ||
-              n.categories.categoryType == null ||
-              n.categories.categoryType === undefined
+            n.categories.categoryType == null ||
+            n.categories.categoryType === undefined
           ).toBe(true);
           expect(
             typeof n.categories.meanType === "number" ||
-              n.categories.meanType == null ||
-              n.categories.meanType === undefined
+            n.categories.meanType == null ||
+            n.categories.meanType === undefined
           ).toBe(true);
         }
 
@@ -165,13 +171,13 @@ describe("NewsClient", () => {
           expect(typeof n.sectors.newsCount).toBe("number");
           expect(
             typeof n.sectors.categoryType === "string" ||
-              n.sectors.categoryType == null ||
-              n.sectors.categoryType === undefined
+            n.sectors.categoryType == null ||
+            n.sectors.categoryType === undefined
           ).toBe(true);
           expect(
             typeof n.sectors.meanType === "number" ||
-              n.sectors.meanType == null ||
-              n.sectors.meanType === undefined
+            n.sectors.meanType == null ||
+            n.sectors.meanType === undefined
           ).toBe(true);
         }
 
@@ -189,6 +195,58 @@ describe("NewsClient", () => {
         }
       }
     });
+
+    test("getNewsV2 returns valid paginated data", async () => {
+      const resp = await client.getNewsV2(
+        Region.Us,
+        Locale.Tr,
+        NewsType.BRIEFS,
+        0,
+        10,
+        NewsOrderBy.TIMESTAMP,
+        SortDirection.Desc
+      );
+
+      expect(resp).toBeDefined();
+      expect(typeof resp.recordCount).toBe("number");
+      expect(resp.recordCount).toBeGreaterThanOrEqual(0);
+      expect(Array.isArray(resp.items)).toBe(true);
+
+      if (resp.items.length > 0) {
+        const n = resp.items[0];
+
+        expect(typeof n.url).toBe("string");
+        expect(typeof n.imageUrl).toBe("string");
+        expect(typeof n.timestamp).toBe("string");
+        expect(typeof n.publisherUrl).toBe("string");
+        expect(typeof n.qualityScore).toBe("number");
+        expect(typeof n.createdAt).toBe("string");
+
+        expect((n as any).relatedTickers).toBeUndefined();
+
+        expect(n.publisher).toBeDefined();
+        expect(typeof n.publisher.name).toBe("string");
+      }
+    });
+
+    test("streamNews yields item before timeout or throws gracefully if none arrive", async () => {
+      let newsItemsReceived = 0;
+      const { events, cancel } = client.streamNews(Region.Us, Locale.Tr);
+
+      const receivePromise = (async () => {
+        for await (const items of events) {
+          if (items && items.length > 0) {
+            newsItemsReceived += items.length;
+            break;
+          }
+        }
+      })();
+
+      const timeoutPromise = new Promise((resolve) => setTimeout(resolve, 8000));
+      await Promise.race([receivePromise, timeoutPromise]);
+      cancel();
+      expect(newsItemsReceived).toBeGreaterThanOrEqual(0);
+    });
   });
 
   describe("Mock Tests", () => {
@@ -343,5 +401,142 @@ describe("NewsClient", () => {
         expect(cli.request).toHaveBeenCalledTimes(1);
       });
     });
+
+    describe("getNewsV2", () => {
+      test("calls correct endpoint/params and matches raw response", async () => {
+        cli.request.mockResolvedValueOnce({ data: mockNewsV2Response });
+
+        const resp = await client.getNewsV2(
+          Region.Tr,
+          Locale.Tr,
+          NewsType.BRIEFS,
+          1,
+          10,
+          NewsOrderBy.TIMESTAMP,
+          SortDirection.Desc,
+          undefined
+        );
+
+        expect(cli.request).toHaveBeenCalledTimes(1);
+        const call = cli.request.mock.calls[0][0];
+
+        expect(call.method).toBe("GET");
+        expect(call.url).toBe("/api/v2/news");
+        expect(call.params).toEqual({
+          region: Region.Tr,
+          locale: Locale.Tr,
+          newsType: NewsType.BRIEFS,
+          page: 1,
+          size: 10,
+          orderBy: NewsOrderBy.TIMESTAMP,
+          orderByDirection: SortDirection.Desc
+        });
+
+        expect(resp.recordCount).toBe(352);
+        expect(resp.items).toHaveLength(1);
+
+        const n = resp.items[0];
+
+        expect((n as any).relatedTickers).toBeUndefined();
+        expect(n.url).toBe(mockNewsV2Response.items[0].url);
+      });
+
+      test("does not send optional params when undefined", async () => {
+        cli.request.mockResolvedValueOnce({ data: mockNewsV2Response });
+
+        await client.getNewsV2(Region.Tr, Locale.Tr);
+
+        const call = cli.request.mock.calls[0][0];
+        expect(call.params).toEqual({
+          region: Region.Tr,
+          locale: Locale.Tr
+        });
+      });
+
+      test("bubbles up request error", async () => {
+        cli.request.mockRejectedValueOnce(new Error("Failed to fetch news v2"));
+
+        await expect(
+          client.getNewsV2(
+            Region.Tr,
+            Locale.Tr,
+            NewsType.REUTERS,
+            0,
+            10,
+            NewsOrderBy.TIMESTAMP,
+            SortDirection.Desc
+          )
+        ).rejects.toThrow("Failed to fetch news v2");
+
+        expect(cli.request).toHaveBeenCalledTimes(1);
+      });
+    });
+
+    describe("streamNews", () => {
+      test("calls correct endpoint/params and correctly yields stream entities", async () => {
+        const eventsList: any[] = [];
+
+        // Mock get response to return a readable stream
+        const mockStreamData = [
+          "data: " + JSON.stringify([{ url: "http://example.com/stream-news-1", publiser: { name: "test-publisher" } }]) + "\n\n",
+          "data: " + JSON.stringify([{ url: "http://example.com/stream-news-2", publiser: { name: "test-publisher-2" } }]) + "\n\n",
+        ];
+
+        const mockAsyncIterator = {
+          async *[Symbol.asyncIterator]() {
+            for (const chunk of mockStreamData) {
+              yield new TextEncoder().encode(chunk);
+            }
+          }
+        };
+
+        const axiosGetSpy = jest.spyOn(axios, 'get').mockResolvedValueOnce({
+          data: mockAsyncIterator
+        });
+
+        const { events, cancel } = client.streamNews(Region.Us, Locale.Tr);
+
+        for await (const newsList of events) {
+          eventsList.push(newsList);
+        }
+
+        expect(axiosGetSpy).toHaveBeenCalledTimes(1);
+        const callArgs = axiosGetSpy.mock.calls[0];
+        expect(callArgs[0]).toBe(`${client["baseUrl"]}/api/v1/news/stream?locale=tr&region=us`);
+        expect(callArgs[1]?.responseType).toBe('stream');
+
+        expect(eventsList).toHaveLength(2);
+        expect(eventsList[0][0].url).toBe("http://example.com/stream-news-1");
+        expect(eventsList[1][0].url).toBe("http://example.com/stream-news-2");
+
+        cancel();
+        axiosGetSpy.mockRestore();
+      });
+
+      test("calls correct endpoint with optional parameters", async () => {
+        const mockAsyncIterator = {
+          async *[Symbol.asyncIterator]() {
+            yield new TextEncoder().encode("data: " + JSON.stringify([]) + "\n\n");
+          }
+        };
+
+        const axiosGetSpy = jest.spyOn(axios, 'get').mockResolvedValueOnce({
+          data: mockAsyncIterator
+        });
+
+        const { events, cancel } = client.streamNews(Region.Us, Locale.En, ["tech"], ["AAPL"], ["category"], ["software"]);
+
+        for await (const _ of events) {
+          break;
+        }
+
+        expect(axiosGetSpy).toHaveBeenCalledTimes(1);
+        const callArgs = axiosGetSpy.mock.calls[0];
+        expect(callArgs[0]).toBe(`${client["baseUrl"]}/api/v1/news/stream?locale=en&region=us&sectors=tech&tickers=AAPL&categories=category&industries=software`);
+
+        cancel();
+        axiosGetSpy.mockRestore();
+      });
+    });
   });
 });