laplace-api 4.4.0 → 4.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "laplace-api",
-  "version": "4.4.0",
+  "version": "4.5.0",
   "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/live-price-web-socket.ts

@@ -1,3 +1,5 @@
+import { OrderbookLiveData } from "./live-price";
+
 interface RawBISTStockLiveData {
   _id: number;
   symbol: string;
@@ -33,14 +35,15 @@ export enum LivePriceFeed {
   LiveUs = "live_price_us",
   DelayedBist = "delayed_price_tr",
   DelayedUs = "delayed_price_us",
-  // DepthBist = "depth_tr",
+  DepthBist = "depth_tr",
 }
 
 type StockLiveDataType<T extends LivePriceFeed> = T extends
   | LivePriceFeed.LiveBist
   | LivePriceFeed.DelayedBist
-  ? // | LivePriceFeed.DepthBist
-    BISTStockLiveData
+  ? BISTStockLiveData
+  : T extends LivePriceFeed.DepthBist
+  ? OrderbookLiveData
   : USStockLiveData;
 
 export enum LogLevel {
@@ -94,14 +97,10 @@ export class LivePriceWebSocketClient {
     number,
     {
       symbols: string[];
-      handler: (data: BISTStockLiveData | USStockLiveData) => void;
+      handler: (data: BISTStockLiveData | USStockLiveData | OrderbookLiveData) => void;
       feed: LivePriceFeed;
     }
   >();
-  private symbolLastData = new Map<
-    string,
-    BISTStockLiveData | USStockLiveData
-  >();
   private reconnectAttempts = 0;
   private reconnectTimeout: NodeJS.Timeout | null = null;
   private isClosed: boolean = false;
@@ -276,13 +275,11 @@ export class LivePriceWebSocketClient {
                   WebSocketErrorType.MESSAGE_PARSE_ERROR
                 );
               }
-              let priceData: BISTStockLiveData | USStockLiveData;
+              let priceData: BISTStockLiveData | USStockLiveData | OrderbookLiveData;
 
               if (
                 feed === LivePriceFeed.DelayedBist ||
                 feed === LivePriceFeed.LiveBist
-                //  ||
-                // feed === LivePriceFeed.DepthBist
               ) {
                 const message = messageData as RawBISTStockLiveData;
                 priceData = {
@@ -293,6 +290,13 @@ export class LivePriceWebSocketClient {
                   timestamp: message?.d,
                   percentChange: message?.c,
                 } as BISTStockLiveData;
+              } else if (feed === LivePriceFeed.DepthBist) {
+                const message = messageData as OrderbookLiveData;
+                priceData = {
+                  updated: message.updated,
+                  deleted: message.deleted,
+                  symbol: message?.symbol,
+                } as OrderbookLiveData;
               } else {
                 const message = messageData as RawUSStockLiveData;
                 priceData = {
@@ -302,7 +306,6 @@ export class LivePriceWebSocketClient {
                 } as USStockLiveData;
               }
               if (priceData.symbol) {
-                this.symbolLastData.set(priceData.symbol, priceData);
                 const handlers = this.getHandlersForSymbol(
                   priceData.symbol,
                   feed
@@ -409,7 +412,7 @@ export class LivePriceWebSocketClient {
     const subscriptionId = this.subscriptionCounter++;
     let symbolsToAdd: string[] = [];
 
-    const typedHandler = (data: BISTStockLiveData | USStockLiveData) => {
+    const typedHandler = (data: BISTStockLiveData | USStockLiveData | OrderbookLiveData) => {
       handler(data as StockLiveDataType<F>);
     };
 
@@ -423,12 +426,6 @@ export class LivePriceWebSocketClient {
       const symbolHandlers = this.getHandlersForSymbol(symbol, feed);
       if (symbolHandlers.length === 1) {
         symbolsToAdd.push(symbol);
-      } else if (symbolHandlers.length > 1) {
-        const lastData: BISTStockLiveData | USStockLiveData | undefined =
-          this.symbolLastData.get(symbol);
-        if (lastData) {
-          typedHandler(lastData);
-        }
       }
     }
     this.addSymbols(symbolsToAdd, feed);
@@ -445,7 +442,7 @@ export class LivePriceWebSocketClient {
   private getHandlersForSymbol(
     symbol: string,
     feed: LivePriceFeed
-  ): ((data: BISTStockLiveData | USStockLiveData) => void)[] {
+  ): ((data: BISTStockLiveData | USStockLiveData | OrderbookLiveData) => void)[] {
     return Array.from(this.subscriptions.values())
       .filter((s) => s.symbols.includes(symbol) && s.feed === feed)
       .map((s) => s.handler);

package/src/client/stocks.ts

@@ -298,12 +298,14 @@ export class StockClient extends Client {
     if (request.resolution) params.resolution = request.resolution;
     if (request.indicators) params.indicators = request.indicators;
     if (request.chartType != null) params.chartType = request.chartType;
-  
-    return this.sendRequest<Blob>({
-      method: 'GET',
-      url: '/api/v1/stock/chart',
+
+    const data = await this.sendRequest<ArrayBuffer>({
+      method: "GET",
+      url: "/api/v1/stock/chart",
       params,
-      responseType: 'blob',
+      responseType: "arraybuffer",
     });
+
+    return new Blob([data], { type: "image/png" });
   }
 }

package/src/test/stocks.test.ts

@@ -125,14 +125,14 @@ const mockTickRulesResponse = {
 
 const mockEarningsTranscriptList: EarningsTranscriptListItem[] = [
   {
-    symbol: "TUPRS",
+    symbol: "AAPL",
     year: 2024,
     quarter: 1,
     date: "2024-05-15",
-    fiscal_year: 2024
+    fiscal_year: 2024,
   },
   {
-    symbol: "TUPRS",
+    symbol: "AAPL",
     year: 2023,
     quarter: 4,
     date: "2024-02-20",
@@ -141,7 +141,7 @@ const mockEarningsTranscriptList: EarningsTranscriptListItem[] = [
 ];
 
 const mockEarningsTranscriptDetail: EarningsTranscriptWithSummary = {
-  symbol: "TUPRS",
+  symbol: "AAPL",
   year: 2024,
   quarter: 1,
   date: "2024-05-15",
@@ -153,14 +153,14 @@ const mockEarningsTranscriptDetail: EarningsTranscriptWithSummary = {
 const mockMarketStates: MarketState[] = [
   {
     id: 1,
-    marketSymbol: "XIST",
+    marketSymbol: "BIST",
     state: "OPEN",
     lastTimestamp: "2024-03-14T10:00:00Z",
     stockSymbol: "TUPRS"
   },
   {
     id: 2,
-    marketSymbol: "XIST",
+    marketSymbol: "BIST",
     state: "CLOSED",
     lastTimestamp: "2024-03-14T18:00:00Z",
     stockSymbol: "GARAN"
@@ -174,7 +174,7 @@ const mockPaginatedMarketStates: PaginatedResponse<MarketState> = {
 
 const mockSingleMarketState: MarketState = {
   id: 1,
-  marketSymbol: "XIST",
+  marketSymbol: "BIST",
   state: "OPEN",
   lastTimestamp: "2024-03-14T10:00:00Z",
   stockSymbol: "TUPRS"
@@ -389,7 +389,7 @@ describe("Stocks Client", () => {
 
     describe("getEarningsTranscripts", () => {
       test("should return earnings transcript list", async () => {
-        const resp = await client.getEarningsTranscripts("TUPRS", Region.Tr);
+        const resp = await client.getEarningsTranscripts("AAPL", Region.Us);
 
         expect(Array.isArray(resp)).toBe(true);
 
@@ -406,7 +406,7 @@ describe("Stocks Client", () => {
 
     describe("getEarningsTranscript", () => {
       test("should return earnings transcript detail", async () => {
-        const resp = await client.getEarningsTranscript("TUPRS", 2023, 4);
+        const resp = await client.getEarningsTranscript("AAPL", 2023, 4);
 
         expect(resp).toBeDefined();
         expect(typeof resp.symbol).toBe("string");
@@ -476,7 +476,7 @@ describe("Stocks Client", () => {
 
     describe("getState", () => {
       test("should return single market state", async () => {
-        const resp = await client.getState("XIST");
+        const resp = await client.getState("BIST");
 
         expect(resp).toBeDefined();
         expect(typeof resp.id).toBe("number");
@@ -495,11 +495,10 @@ describe("Stocks Client", () => {
           symbol: "TUPRS",
           region: Region.Tr,
         });
-    
         expect(resp).toBeDefined();
         expect(resp).toBeInstanceOf(Blob);
         expect(resp.size).toBeGreaterThan(0);
-      });
+      }, 10000);
     });
   });
 
@@ -693,12 +692,12 @@ describe("Stocks Client", () => {
       test("should return earnings transcript list with mock data", async () => {
         jest.spyOn(client, 'getEarningsTranscripts').mockResolvedValue(mockEarningsTranscriptList);
 
-        const resp = await client.getEarningsTranscripts("TUPRS", Region.Tr);
+        const resp = await client.getEarningsTranscripts("AAPL", Region.Us);
 
         expect(resp).toHaveLength(2);
         
         const firstTranscript = resp[0];
-        expect(firstTranscript.symbol).toBe("TUPRS");
+        expect(firstTranscript.symbol).toBe("AAPL");
         expect(firstTranscript.year).toBe(2024);
         expect(firstTranscript.quarter).toBe(1);
         expect(firstTranscript.date).toBe("2024-05-15");
@@ -708,14 +707,18 @@ describe("Stocks Client", () => {
         expect(secondTranscript.year).toBe(2023);
         expect(secondTranscript.quarter).toBe(4);
 
-        expect(client.getEarningsTranscripts).toHaveBeenCalledWith("TUPRS", Region.Tr);
+        expect(client.getEarningsTranscripts).toHaveBeenCalledWith(
+          "AAPL",
+          Region.Us
+        );
       });
 
       test("should handle API errors for earnings transcripts", async () => {
         jest.spyOn(client, 'getEarningsTranscripts').mockRejectedValue(new Error("Transcripts not found"));
 
-        await expect(client.getEarningsTranscripts("INVALID", Region.Tr))
-          .rejects.toThrow("Transcripts not found");
+        await expect(
+          client.getEarningsTranscripts("INVALID", Region.Us)
+        ).rejects.toThrow("Transcripts not found");
       });
     });
 
@@ -723,9 +726,9 @@ describe("Stocks Client", () => {
       test("should return earnings transcript detail with mock data", async () => {
         jest.spyOn(client, 'getEarningsTranscript').mockResolvedValue(mockEarningsTranscriptDetail);
 
-        const resp = await client.getEarningsTranscript("TUPRS", 2024, 1);
+        const resp = await client.getEarningsTranscript("AAPL", 2024, 1);
 
-        expect(resp.symbol).toBe("TUPRS");
+        expect(resp.symbol).toBe("AAPL");
         expect(resp.year).toBe(2024);
         expect(resp.quarter).toBe(1);
         expect(resp.date).toBe("2024-05-15");
@@ -733,14 +736,19 @@ describe("Stocks Client", () => {
         expect(resp.summary).toBe("Strong Q1 performance with 15% revenue growth");
         expect(resp.has_summary).toBe(true);
 
-        expect(client.getEarningsTranscript).toHaveBeenCalledWith("TUPRS", 2024, 1);
+        expect(client.getEarningsTranscript).toHaveBeenCalledWith(
+          "AAPL",
+          2024,
+          1
+        );
       });
 
       test("should handle API errors for earnings transcript detail", async () => {
         jest.spyOn(client, 'getEarningsTranscript').mockRejectedValue(new Error("Transcript not found"));
 
-        await expect(client.getEarningsTranscript("TUPRS", 2020, 1))
-          .rejects.toThrow("Transcript not found");
+        await expect(
+          client.getEarningsTranscript("AAPL", 2020, 1)
+        ).rejects.toThrow("Transcript not found");
       });
     });
 
@@ -755,7 +763,7 @@ describe("Stocks Client", () => {
 
         const firstState = resp.items[0];
         expect(firstState.id).toBe(1);
-        expect(firstState.marketSymbol).toBe("XIST");
+        expect(firstState.marketSymbol).toBe("BIST");
         expect(firstState.state).toBe("OPEN");
         expect(firstState.stockSymbol).toBe("TUPRS");
 
@@ -777,7 +785,7 @@ describe("Stocks Client", () => {
         const resp = await client.getStockState("TUPRS");
 
         expect(resp.id).toBe(1);
-        expect(resp.marketSymbol).toBe("XIST");
+        expect(resp.marketSymbol).toBe("BIST");
         expect(resp.state).toBe("OPEN");
         expect(resp.lastTimestamp).toBe("2024-03-14T10:00:00Z");
         expect(resp.stockSymbol).toBe("TUPRS");
@@ -821,14 +829,14 @@ describe("Stocks Client", () => {
       test("should return single market state with mock data", async () => {
         jest.spyOn(client, 'getState').mockResolvedValue(mockSingleMarketState);
 
-        const resp = await client.getState("XIST");
+        const resp = await client.getState("BIST");
 
         expect(resp.id).toBe(1);
-        expect(resp.marketSymbol).toBe("XIST");
+        expect(resp.marketSymbol).toBe("BIST");
         expect(resp.state).toBe("OPEN");
         expect(resp.lastTimestamp).toBe("2024-03-14T10:00:00Z");
 
-        expect(client.getState).toHaveBeenCalledWith("XIST");
+        expect(client.getState).toHaveBeenCalledWith("BIST");
       });
 
       test("should handle API errors for single state", async () => {