laplace-api 4.7.0 → 5.1.0

package/src/test/collections.test.ts

@@ -1,142 +1,197 @@
 import { Logger } from "winston";
 import { LaplaceConfiguration } from "../utilities/configuration";
-import { CollectionClient, Locale, Region, Collection, CollectionDetail, CollectionType, CollectionPriceGraph } from "../client/collections";
+import {
+  CollectionClient,
+  Locale,
+  Region
+} from "../client/collections";
 import "./client_test_suite";
 import { validateCollection, validateCollectionDetail } from "./helpers";
-import { Stock, AssetType, PriceDataPoint, HistoricalPricePeriod } from "../client/stocks";
+import {
+  AggregateGraphPeriod,
+  SortBy,
+} from "../client/collections";
 
-const mockStocks: Stock[] = [
+const mockCollectionList = [
   {
-    id: "stock1",
-    name: "Tüpraş",
-    symbol: "TUPRS",
-    assetType: AssetType.Stock,
-    sectorId: "sector1",
-    industryId: "industry1",
-    updatedDate: "2024-03-14T10:00:00Z",
-    active: true
+    id: "620f455a0187ade00bb0d55f",
+    title: "En Büyükler",
+    region: ["tr"],
+    imageUrl:
+      "https://finfree-storage.s3.eu-central-1.amazonaws.com/collection-images/en-buyukler_original.webp",
+    avatarUrl:
+      "https://finfree-storage.s3.eu-central-1.amazonaws.com/collection-images/en-buyukler_avatar.webp",
+    numStocks: 10,
+    assetClass: "equity",
+    order: 0,
   },
-  {
-    id: "stock2",
-    name: "Garanti Bankası",
-    symbol: "GARAN",
-    assetType: AssetType.Stock,
-    sectorId: "sector2",
-    industryId: "industry2",
-    updatedDate: "2024-03-14T10:00:00Z",
-    active: true
-  }
 ];
 
-const mockIndustries: Collection[] = [
+const mockCollectionDetail = {
+  id: "620f455a0187ade00bb0d55f",
+  title: "En Büyükler",
+  region: ["tr"],
+  imageUrl:
+    "https://finfree-storage.s3.eu-central-1.amazonaws.com/collection-images/en-buyukler_original.webp",
+  avatarUrl:
+    "https://finfree-storage.s3.eu-central-1.amazonaws.com/collection-images/en-buyukler_avatar.webp",
+  numStocks: 10,
+  assetClass: "equity",
+  order: 0,
+  stocks: [
+    {
+      id: "61dd0d670ec2114146342fa5",
+      assetType: "stock",
+      name: "SASA Polyester",
+      symbol: "SASA",
+      sectorId: "65533e047844ee7afe9941c0",
+      industryId: "65533e441fa5c7b58afa097a",
+      updatedDate: "2025-08-05T14:53:59.57Z",
+      active: true,
+    },
+  ],
+};
+
+const mockThemesList = [
   {
-    id: "industry1",
-    title: "Bankacılık",
-    description: "Türkiye'nin önde gelen bankaları",
-    region: [Region.Tr],
+    id: "6256b0647d0bb100123effa7",
+    title: "İhracat Şampiyonları",
+    region: ["tr"],
+    imageUrl:
+      "https://finfree-storage.s3.eu-central-1.amazonaws.com/collection-images/ihracat-sampiyonlari_original.webp",
+    avatarUrl:
+      "https://finfree-storage.s3.eu-central-1.amazonaws.com/collection-images/ihracat-sampiyonlari_avatar.webp",
+    numStocks: 15,
     assetClass: "equity",
-    imageUrl: "https://example.com/banking.jpg",
-    avatarUrl: "https://example.com/banking-avatar.jpg",
-    numStocks: 10
   },
-  {
-    id: "industry2",
-    title: "Enerji",
-    description: "Enerji sektörü şirketleri",
-    region: [Region.Tr],
-    assetClass: "equity",
-    imageUrl: "https://example.com/energy.jpg",
-    avatarUrl: "https://example.com/energy-avatar.jpg",
-    numStocks: 8
-  }
 ];
 
-const mockSectors: Collection[] = [
-  {
-    id: "sector1",
-    title: "Finans",
-    description: "Finans sektörü şirketleri",
-    region: [Region.Tr],
-    assetClass: "equity",
-    imageUrl: "https://example.com/finance.jpg",
-    avatarUrl: "https://example.com/finance-avatar.jpg",
-    numStocks: 25
-  }
-];
+const mockThemeDetail = {
+  id: "6256b0647d0bb100123effa7",
+  title: "İhracat Şampiyonları",
+  region: ["tr"],
+  imageUrl:
+    "https://finfree-storage.s3.eu-central-1.amazonaws.com/collection-images/ihracat-sampiyonlari_original.webp",
+  avatarUrl:
+    "https://finfree-storage.s3.eu-central-1.amazonaws.com/collection-images/ihracat-sampiyonlari_avatar.webp",
+  numStocks: 15,
+  assetClass: "equity",
+  image:
+    "https://finfree-storage.s3.eu-central-1.amazonaws.com/themes/tr/ihracat_sampiyonlari.png",
+  order: 0,
+  stocks: [
+    {
+      id: "61dd0d4b0ec2114146342f69",
+      assetType: "stock",
+      name: "Şişe ve Cam Fabrikaları",
+      symbol: "SISE",
+      sectorId: "65533e047844ee7afe9941be",
+      industryId: "65533e441fa5c7b58afa0956",
+      updatedDate: "2025-04-01T00:00:00.533Z",
+      active: true,
+    },
+  ],
+};
 
-const mockThemes: Collection[] = [
+const mockIndustryList = [
   {
-    id: "theme1",
-    title: "Sürdürülebilir Enerji",
-    description: "Yenilenebilir enerji şirketleri",
-    region: [Region.Tr],
-    assetClass: "equity",
-    imageUrl: "https://example.com/sustainable.jpg",
-    avatarUrl: "https://example.com/sustainable-avatar.jpg",
-    numStocks: 15
-  }
+    id: "65533e441fa5c7b58afa097b",
+    title: "Kimyasal (Çeşitlendirilmiş)",
+    imageUrl:
+      "https://finfree-storage.s3.amazonaws.com/collection-images/chemical-diversified.webp",
+    avatarUrl:
+      "https://finfree-storage.s3.amazonaws.com/collection-images/chemical-diversified_avatar.webp",
+    numStocks: 1,
+  },
 ];
 
-const mockCollections: Collection[] = [
+const mockIndustryDetail = {
+  id: "65533e441fa5c7b58afa0944",
+  title: "Perakende (Özel Hatlar)",
+  region: ["us", "tr"],
+  imageUrl:
+    "https://finfree-storage.s3.amazonaws.com/collection-images/retail-special-lines.webp",
+  avatarUrl:
+    "https://finfree-storage.s3.amazonaws.com/collection-images/retail-special-lines_avatar.webp",
+  numStocks: 59,
+  order: 0,
+  stocks: [
+    {
+      id: "61dd0d850ec2114146343053",
+      assetType: "stock",
+      name: "Teknosa",
+      symbol: "TKNSA",
+      sectorId: "65533e047844ee7afe9941b9",
+      industryId: "65533e441fa5c7b58afa0944",
+      updatedDate: "2025-07-02T00:00:00.426Z",
+      active: true,
+    },
+  ],
+};
+
+const mockSectorsList = [
   {
-    id: "collection1",
-    title: "Borsa İstanbul 30",
-    description: "BIST-30 endeksindeki şirketler",
-    region: [Region.Tr],
-    assetClass: "equity",
-    imageUrl: "https://example.com/bist30.jpg",
-    avatarUrl: "https://example.com/bist30-avatar.jpg",
-    numStocks: 30
-  }
+    id: "65533e047844ee7afe9941bf",
+    title: "Teknoloji",
+    imageUrl:
+      "https://finfree-storage.s3.eu-central-1.amazonaws.com/collection-images/informationtechnology-stocks_original.webp",
+    avatarUrl:
+      "https://finfree-storage.s3.eu-central-1.amazonaws.com/collection-images/informationtechnology-stocks_avatar.webp",
+    numStocks: 47,
+  },
 ];
 
-const mockPriceDataPoints: PriceDataPoint[] = [
+const mockSectorDetail = {
+  id: "65533e047844ee7afe9941b9",
+  title: "Tüketici Döngüsel",
+  region: ["us", "tr"],
+  imageUrl:
+    "https://finfree-storage.s3.amazonaws.com/collection-images/consumer-cyclical.webp",
+  avatarUrl:
+    "https://finfree-storage.s3.amazonaws.com/collection-images/consumer-cyclical_avatar.webp",
+  numStocks: 798,
+  order: 0,
+  stocks: [
+    {
+      id: "61dd0d420ec2114146342f2d",
+      assetType: "stock",
+      name: "Tek-Art İnşaat",
+      symbol: "TEKTU",
+      sectorId: "65533e047844ee7afe9941b9",
+      industryId: "65533e441fa5c7b58afa093b",
+      updatedDate: "2022-01-11T04:53:22.944Z",
+      active: true,
+    },
+  ],
+};
+
+const mockPriceDataPoints = [
   {
     d: 1710403200000,
     o: 100.5,
     h: 105.2,
     l: 99.8,
-    c: 103.7
+    c: 103.7,
   },
   {
     d: 1710489600000,
     o: 103.7,
     h: 107.1,
     l: 102.3,
-    c: 106.4
+    c: 106.4,
   },
   {
     d: 1710576000000,
     o: 106.4,
     h: 108.9,
     l: 105.1,
-    c: 107.8
-  }
+    c: 107.8,
+  },
 ];
 
-const mockCollectionPriceGraph: CollectionPriceGraph = {
+const mockCollectionPriceGraph = {
   previous_close: 98.5,
-  graph: mockPriceDataPoints
-};
-
-const mockIndustryDetail: CollectionDetail = {
-  ...mockIndustries[0],
-  stocks: mockStocks
-};
-
-const mockSectorDetail: CollectionDetail = {
-  ...mockSectors[0],
-  stocks: mockStocks
-};
-
-const mockThemeDetail: CollectionDetail = {
-  ...mockThemes[0],
-  stocks: mockStocks
-};
-
-const mockCollectionDetail: CollectionDetail = {
-  ...mockCollections[0],
-  stocks: mockStocks
+  graph: mockPriceDataPoints,
 };
 
 describe("Collections", () => {
@@ -218,7 +273,7 @@ describe("Collections", () => {
     });
 
     test("GetCollectionDetails", async () => {
-      const resp = await client.getThemeDetail(
+      const resp = await client.getCollectionDetail(
         "620f455a0187ade00bb0d55f",
         Region.Tr,
         Locale.Tr
@@ -229,18 +284,18 @@ describe("Collections", () => {
 
     test("GetAggregateGraph", async () => {
       const resp = await client.getAggregateGraph(
-        HistoricalPricePeriod.OneYear,
+        AggregateGraphPeriod.OneYear,
         "65533e047844ee7afe9941b9",
         "65533e441fa5c7b58afa0944",
         "",
         Region.Tr
       );
-      
+
       expect(resp).not.toBeNull();
       expect(resp.previous_close).toBeDefined();
       expect(resp.graph).toBeDefined();
       expect(resp.graph).toBeInstanceOf(Array);
-      
+
       if (resp.graph.length > 0) {
         const firstDataPoint = resp.graph[0];
         expect(firstDataPoint.d).toBeDefined();
@@ -248,231 +303,397 @@ describe("Collections", () => {
         expect(firstDataPoint.h).toBeDefined();
         expect(firstDataPoint.l).toBeDefined();
         expect(firstDataPoint.c).toBeDefined();
-        expect(typeof firstDataPoint.d).toBe('number');
-        expect(typeof firstDataPoint.o).toBe('number');
-        expect(typeof firstDataPoint.h).toBe('number');
-        expect(typeof firstDataPoint.l).toBe('number');
-        expect(typeof firstDataPoint.c).toBe('number');
+        expect(typeof firstDataPoint.d).toBe("number");
+        expect(typeof firstDataPoint.o).toBe("number");
+        expect(typeof firstDataPoint.h).toBe("number");
+        expect(typeof firstDataPoint.l).toBe("number");
+        expect(typeof firstDataPoint.c).toBe("number");
       }
     });
   });
 
   describe("Mock Tests", () => {
-    beforeEach(() => {
-      jest.clearAllMocks();
-    });
+    let client: CollectionClient;
+    let cli: { request: jest.Mock };
 
-    describe("Industries", () => {
-      test("should get all industries", async () => {
-        jest.spyOn(client, 'getAllIndustries').mockResolvedValue(mockIndustries);
+    const region = Region.Tr;
+    const locale = Locale.Tr;
 
-        const resp = await client.getAllIndustries(Region.Tr, Locale.Tr);
+    beforeEach(() => {
+      cli = { request: jest.fn() };
 
-        expect(resp).toHaveLength(2);
-        expect(resp[0].title).toBe("Bankacılık");
-        expect(resp[1].title).toBe("Enerji");
-        expect(resp[0].numStocks).toBe(10);
-        expect(resp[1].numStocks).toBe(8);
+      const config = (global as any).testSuite.config as LaplaceConfiguration;
+      const logger: Logger = {
+        info: jest.fn(),
+        error: jest.fn(),
+        warn: jest.fn(),
+        debug: jest.fn(),
+      } as unknown as Logger;
 
-        expect(client.getAllIndustries).toHaveBeenCalledWith(Region.Tr, Locale.Tr);
-      });
+      client = new CollectionClient(config, logger, cli as any);
+    });
 
-      test("should get industry details", async () => {
-        jest.spyOn(client, 'getIndustryDetail').mockResolvedValue(mockIndustryDetail);
+    describe("getAllIndustries", () => {
+      test("calls correct endpoint/params and matches raw list", async () => {
+        cli.request.mockResolvedValueOnce({ data: mockIndustryList });
 
-        const resp = await client.getIndustryDetail("industry1", Region.Tr, Locale.Tr);
+        const resp = await client.getAllIndustries(region, locale);
 
-        expect(resp.id).toBe("industry1");
-        expect(resp.title).toBe("Bankacılık");
-        expect(resp.stocks).toHaveLength(2);
-        expect(resp.stocks[0].symbol).toBe("TUPRS");
-        expect(resp.stocks[1].symbol).toBe("GARAN");
+        expect(cli.request).toHaveBeenCalledTimes(1);
+        const call = cli.request.mock.calls[0][0];
+        expect(call.method).toBe("GET");
+        expect(call.url).toBe("/api/v1/industry");
+        expect(call.params).toEqual({ region, locale });
 
-        expect(client.getIndustryDetail).toHaveBeenCalledWith("industry1", Region.Tr, Locale.Tr);
+        expect(resp).toHaveLength(1);
+        const item = resp[0];
+        expect(item.id).toBe("65533e441fa5c7b58afa097b");
+        expect(item.title).toBe("Kimyasal (Çeşitlendirilmiş)");
+        expect(item.imageUrl).toBe(
+          "https://finfree-storage.s3.amazonaws.com/collection-images/chemical-diversified.webp"
+        );
+        expect(item.avatarUrl).toBe(
+          "https://finfree-storage.s3.amazonaws.com/collection-images/chemical-diversified_avatar.webp"
+        );
+        expect(item.numStocks).toBe(1);
+
+        expect((item as any).region).toBeUndefined();
+        expect((item as any).assetClass).toBeUndefined();
+        expect((item as any).order).toBeUndefined();
       });
     });
 
-    describe("Sectors", () => {
-      test("should get all sectors", async () => {
-        jest.spyOn(client, 'getAllSectors').mockResolvedValue(mockSectors);
-
-        const resp = await client.getAllSectors(Region.Tr, Locale.Tr);
-
-        expect(resp).toHaveLength(1);
-        expect(resp[0].title).toBe("Finans");
-        expect(resp[0].numStocks).toBe(25);
-
-        expect(client.getAllSectors).toHaveBeenCalledWith(Region.Tr, Locale.Tr);
+    describe("getIndustryDetail", () => {
+      test("calls correct endpoint/params and matches raw detail", async () => {
+        cli.request.mockResolvedValueOnce({ data: mockIndustryDetail });
+
+        const resp = await client.getIndustryDetail(
+          "65533e441fa5c7b58afa0944",
+          region,
+          locale
+        );
+
+        expect(cli.request).toHaveBeenCalledTimes(1);
+        const call = cli.request.mock.calls[0][0];
+        expect(call.method).toBe("GET");
+        expect(call.url).toBe("/api/v1/industry/65533e441fa5c7b58afa0944");
+        expect(call.params).toEqual({ region, locale });
+
+        expect(resp.id).toBe("65533e441fa5c7b58afa0944");
+        expect(resp.title).toBe("Perakende (Özel Hatlar)");
+        expect(resp.region).toEqual(["us", "tr"]);
+        expect(resp.imageUrl).toBe(
+          "https://finfree-storage.s3.amazonaws.com/collection-images/retail-special-lines.webp"
+        );
+        expect(resp.avatarUrl).toBe(
+          "https://finfree-storage.s3.amazonaws.com/collection-images/retail-special-lines_avatar.webp"
+        );
+        expect(resp.numStocks).toBe(59);
+        expect(resp.order).toBe(0);
+
+        // stocks
+        expect(resp.stocks).toHaveLength(1);
+        const s = resp.stocks[0];
+        expect(s.id).toBe("61dd0d850ec2114146343053");
+        expect((s as any).assetType).toBe("stock");
+        expect(s.name).toBe("Teknosa");
+        expect(s.symbol).toBe("TKNSA");
+        expect(s.sectorId).toBe("65533e047844ee7afe9941b9");
+        expect(s.industryId).toBe("65533e441fa5c7b58afa0944");
+        expect(s.updatedDate).toBe("2025-07-02T00:00:00.426Z");
+        expect(s.active).toBe(true);
       });
+    });
 
-      test("should get sector details", async () => {
-        jest.spyOn(client, 'getSectorDetail').mockResolvedValue(mockSectorDetail);
-
-        const resp = await client.getSectorDetail("sector1", Region.Tr, Locale.Tr);
+    describe("detail methods with sortBy", () => {
+      test("includes sortBy param when provided", async () => {
+        cli.request.mockResolvedValueOnce({ data: mockIndustryDetail });
 
-        expect(resp.id).toBe("sector1");
-        expect(resp.title).toBe("Finans");
-        expect(resp.stocks).toHaveLength(2);
-        expect(resp.stocks[0].symbol).toBe("TUPRS");
-        expect(resp.stocks[1].symbol).toBe("GARAN");
+        await client.getIndustryDetail(
+          "65533e441fa5c7b58afa0944",
+          region,
+          locale,
+          SortBy.PriceChange
+        );
 
-        expect(client.getSectorDetail).toHaveBeenCalledWith("sector1", Region.Tr, Locale.Tr);
+        const call = cli.request.mock.calls[0][0];
+        expect(call.params).toEqual({ region, locale, sortBy: SortBy.PriceChange });
       });
     });
 
-    describe("Themes", () => {
-      test("should get all themes", async () => {
-        jest.spyOn(client, 'getAllThemes').mockResolvedValue(mockThemes);
+    describe("getAllSectors", () => {
+      test("calls correct endpoint/params and matches raw list", async () => {
+        cli.request.mockResolvedValueOnce({ data: mockSectorsList });
 
-        const resp = await client.getAllThemes(Region.Tr, Locale.Tr);
+        const resp = await client.getAllSectors(region, locale);
 
-        expect(resp).toHaveLength(1);
-        expect(resp[0].title).toBe("Sürdürülebilir Enerji");
-        expect(resp[0].numStocks).toBe(15);
+        expect(cli.request).toHaveBeenCalledTimes(1);
+        const call = cli.request.mock.calls[0][0];
+        expect(call.method).toBe("GET");
+        expect(call.url).toBe("/api/v1/sector");
+        expect(call.params).toEqual({ region, locale });
 
-        expect(client.getAllThemes).toHaveBeenCalledWith(Region.Tr, Locale.Tr);
+        expect(resp).toHaveLength(1);
+        const item = resp[0];
+        expect(item.id).toBe("65533e047844ee7afe9941bf");
+        expect(item.title).toBe("Teknoloji");
+        expect(item.imageUrl).toBe(
+          "https://finfree-storage.s3.eu-central-1.amazonaws.com/collection-images/informationtechnology-stocks_original.webp"
+        );
+        expect(item.avatarUrl).toBe(
+          "https://finfree-storage.s3.eu-central-1.amazonaws.com/collection-images/informationtechnology-stocks_avatar.webp"
+        );
+        expect(item.numStocks).toBe(47);
+
+        expect((item as any).region).toBeUndefined();
+        expect((item as any).assetClass).toBeUndefined();
+        expect((item as any).order).toBeUndefined();
       });
+    });
 
-      test("should get theme details", async () => {
-        jest.spyOn(client, 'getThemeDetail').mockResolvedValue(mockThemeDetail);
-
-        const resp = await client.getThemeDetail("theme1", Region.Tr, Locale.Tr);
-
-        expect(resp.id).toBe("theme1");
-        expect(resp.title).toBe("Sürdürülebilir Enerji");
-        expect(resp.stocks).toHaveLength(2);
-        expect(resp.stocks[0].symbol).toBe("TUPRS");
-        expect(resp.stocks[1].symbol).toBe("GARAN");
-
-        expect(client.getThemeDetail).toHaveBeenCalledWith("theme1", Region.Tr, Locale.Tr);
+    describe("getSectorDetail", () => {
+      test("calls correct endpoint/params and matches raw detail", async () => {
+        cli.request.mockResolvedValueOnce({ data: mockSectorDetail });
+
+        const resp = await client.getSectorDetail(
+          "65533e047844ee7afe9941b9",
+          region,
+          locale
+        );
+
+        expect(cli.request).toHaveBeenCalledTimes(1);
+        const call = cli.request.mock.calls[0][0];
+        expect(call.method).toBe("GET");
+        expect(call.url).toBe("/api/v1/sector/65533e047844ee7afe9941b9");
+        expect(call.params).toEqual({ region, locale });
+
+        expect(resp.id).toBe("65533e047844ee7afe9941b9");
+        expect(resp.title).toBe("Tüketici Döngüsel");
+        expect(resp.region).toEqual(["us", "tr"]);
+        expect(resp.imageUrl).toBe(
+          "https://finfree-storage.s3.amazonaws.com/collection-images/consumer-cyclical.webp"
+        );
+        expect(resp.avatarUrl).toBe(
+          "https://finfree-storage.s3.amazonaws.com/collection-images/consumer-cyclical_avatar.webp"
+        );
+        expect(resp.numStocks).toBe(798);
+        expect(resp.order).toBe(0);
+
+        expect(resp.stocks).toHaveLength(1);
+        const s = resp.stocks[0];
+        expect(s.id).toBe("61dd0d420ec2114146342f2d");
+        expect((s as any).assetType).toBe("stock");
+        expect(s.name).toBe("Tek-Art İnşaat");
+        expect(s.symbol).toBe("TEKTU");
+        expect(s.sectorId).toBe("65533e047844ee7afe9941b9");
+        expect(s.industryId).toBe("65533e441fa5c7b58afa093b");
+        expect(s.updatedDate).toBe("2022-01-11T04:53:22.944Z");
+        expect(s.active).toBe(true);
       });
     });
 
-    describe("Collections", () => {
-      test("should get all collections", async () => {
-        jest.spyOn(client, 'getAllCollections').mockResolvedValue(mockCollections);
+    describe("getAllThemes", () => {
+      test("calls correct endpoint/params and matches raw list", async () => {
+        cli.request.mockResolvedValueOnce({ data: mockThemesList });
 
-        const resp = await client.getAllCollections(Region.Tr, Locale.Tr);
+        const resp = await client.getAllThemes(region, locale);
+
+        expect(cli.request).toHaveBeenCalledTimes(1);
+        const call = cli.request.mock.calls[0][0];
+        expect(call.method).toBe("GET");
+        expect(call.url).toBe("/api/v1/theme");
+        expect(call.params).toEqual({ region, locale });
 
         expect(resp).toHaveLength(1);
-        expect(resp[0].title).toBe("Borsa İstanbul 30");
-        expect(resp[0].numStocks).toBe(30);
+        const item = resp[0];
+        expect(item.id).toBe("6256b0647d0bb100123effa7");
+        expect(item.title).toBe("İhracat Şampiyonları");
+        expect(item.region).toEqual(["tr"]);
+        expect(item.imageUrl).toBe(
+          "https://finfree-storage.s3.eu-central-1.amazonaws.com/collection-images/ihracat-sampiyonlari_original.webp"
+        );
+        expect(item.avatarUrl).toBe(
+          "https://finfree-storage.s3.eu-central-1.amazonaws.com/collection-images/ihracat-sampiyonlari_avatar.webp"
+        );
+        expect(item.numStocks).toBe(15);
+        expect(item.assetClass).toBe("equity");
+      });
+    });
 
-        expect(client.getAllCollections).toHaveBeenCalledWith(Region.Tr, Locale.Tr);
+    describe("getThemeDetail", () => {
+      test("calls correct endpoint/params and matches raw detail", async () => {
+        cli.request.mockResolvedValueOnce({ data: mockThemeDetail });
+
+        const resp = await client.getThemeDetail(
+          "6256b0647d0bb100123effa7",
+          region,
+          locale
+        );
+
+        expect(cli.request).toHaveBeenCalledTimes(1);
+        const call = cli.request.mock.calls[0][0];
+        expect(call.method).toBe("GET");
+        expect(call.url).toBe("/api/v1/theme/6256b0647d0bb100123effa7");
+        expect(call.params).toEqual({ region, locale });
+
+        expect(resp.id).toBe("6256b0647d0bb100123effa7");
+        expect(resp.title).toBe("İhracat Şampiyonları");
+        expect(resp.region).toEqual(["tr"]);
+        expect(resp.imageUrl).toBe(
+          "https://finfree-storage.s3.eu-central-1.amazonaws.com/collection-images/ihracat-sampiyonlari_original.webp"
+        );
+        expect(resp.avatarUrl).toBe(
+          "https://finfree-storage.s3.eu-central-1.amazonaws.com/collection-images/ihracat-sampiyonlari_avatar.webp"
+        );
+        expect(resp.numStocks).toBe(15);
+        expect(resp.assetClass).toBe("equity");
+        expect(resp.image).toBe(
+          "https://finfree-storage.s3.eu-central-1.amazonaws.com/themes/tr/ihracat_sampiyonlari.png"
+        );
+        expect(resp.order).toBe(0);
+
+        expect(resp.stocks).toHaveLength(1);
+        const s = resp.stocks[0];
+        expect(s.id).toBe("61dd0d4b0ec2114146342f69");
+        expect((s as any).assetType).toBe("stock");
+        expect(s.name).toBe("Şişe ve Cam Fabrikaları");
+        expect(s.symbol).toBe("SISE");
+        expect(s.sectorId).toBe("65533e047844ee7afe9941be");
+        expect(s.industryId).toBe("65533e441fa5c7b58afa0956");
+        expect(s.updatedDate).toBe("2025-04-01T00:00:00.533Z");
+        expect(s.active).toBe(true);
       });
+    });
 
-      test("should get collection details", async () => {
-        jest.spyOn(client, 'getCollectionDetail').mockResolvedValue(mockCollectionDetail);
+    describe("getAllCollections", () => {
+      test("calls correct endpoint/params and matches raw list", async () => {
+        cli.request.mockResolvedValueOnce({ data: mockCollectionList });
 
-        const resp = await client.getCollectionDetail("collection1", Region.Tr, Locale.Tr);
+        const resp = await client.getAllCollections(region, locale);
 
-        expect(resp.id).toBe("collection1");
-        expect(resp.title).toBe("Borsa İstanbul 30");
-        expect(resp.stocks).toHaveLength(2);
-        expect(resp.stocks[0].symbol).toBe("TUPRS");
-        expect(resp.stocks[1].symbol).toBe("GARAN");
+        expect(cli.request).toHaveBeenCalledTimes(1);
+        const call = cli.request.mock.calls[0][0];
+        expect(call.method).toBe("GET");
+        expect(call.url).toBe("/api/v1/collection");
+        expect(call.params).toEqual({ region, locale });
 
-        expect(client.getCollectionDetail).toHaveBeenCalledWith("collection1", Region.Tr, Locale.Tr);
+        expect(resp).toHaveLength(1);
+        const item = resp[0];
+        expect(item.id).toBe("620f455a0187ade00bb0d55f");
+        expect(item.title).toBe("En Büyükler");
+        expect(item.region).toEqual(["tr"]);
+        expect(item.imageUrl).toBe(
+          "https://finfree-storage.s3.eu-central-1.amazonaws.com/collection-images/en-buyukler_original.webp"
+        );
+        expect(item.avatarUrl).toBe(
+          "https://finfree-storage.s3.eu-central-1.amazonaws.com/collection-images/en-buyukler_avatar.webp"
+        );
+        expect(item.numStocks).toBe(10);
+        expect(item.assetClass).toBe("equity");
+        expect(item.order).toBe(0);
       });
     });
 
-    describe("Aggregate Graph", () => {
-      test("should get aggregate graph for sector", async () => {
-        jest.spyOn(client, 'getAggregateGraph').mockResolvedValue(mockCollectionPriceGraph);
-
-        const resp = await client.getAggregateGraph(HistoricalPricePeriod.OneMonth, "sector1", "", "", Region.Tr);
+    describe("getCollectionDetail", () => {
+      test("calls correct endpoint/params and matches raw detail", async () => {
+        cli.request.mockResolvedValueOnce({ data: mockCollectionDetail });
+
+        const resp = await client.getCollectionDetail(
+          "620f455a0187ade00bb0d55f",
+          region,
+          locale
+        );
+
+        expect(cli.request).toHaveBeenCalledTimes(1);
+        const call = cli.request.mock.calls[0][0];
+        expect(call.method).toBe("GET");
+        expect(call.url).toBe("/api/v1/collection/620f455a0187ade00bb0d55f");
+        expect(call.params).toEqual({ region, locale });
+
+        expect(resp.id).toBe("620f455a0187ade00bb0d55f");
+        expect(resp.title).toBe("En Büyükler");
+        expect(resp.region).toEqual(["tr"]);
+        expect(resp.imageUrl).toBe(
+          "https://finfree-storage.s3.eu-central-1.amazonaws.com/collection-images/en-buyukler_original.webp"
+        );
+        expect(resp.avatarUrl).toBe(
+          "https://finfree-storage.s3.eu-central-1.amazonaws.com/collection-images/en-buyukler_avatar.webp"
+        );
+        expect(resp.numStocks).toBe(10);
+        expect(resp.assetClass).toBe("equity");
+        expect(resp.order).toBe(0);
+
+        expect(resp.stocks).toHaveLength(1);
+        const s = resp.stocks[0];
+        expect(s.id).toBe("61dd0d670ec2114146342fa5");
+        expect((s as any).assetType).toBe("stock");
+        expect(s.name).toBe("SASA Polyester");
+        expect(s.symbol).toBe("SASA");
+        expect(s.sectorId).toBe("65533e047844ee7afe9941c0");
+        expect(s.industryId).toBe("65533e441fa5c7b58afa097a");
+        expect(s.updatedDate).toBe("2025-08-05T14:53:59.57Z");
+        expect(s.active).toBe(true);
+      });
+    });
+    describe("getAggregateGraph", () => {
+      test("calls correct endpoint/params and matches raw graph response", async () => {
+        cli.request.mockResolvedValueOnce({ data: mockCollectionPriceGraph });
+
+        const resp = await client.getAggregateGraph(
+          AggregateGraphPeriod.OneYear,
+          "65533e047844ee7afe9941b9", // sectorId
+          "65533e441fa5c7b58afa0944", // industryId
+          "", // collectionId
+          Region.Tr
+        );
+
+        expect(cli.request).toHaveBeenCalledTimes(1);
+        const call = cli.request.mock.calls[0][0];
+
+        expect(call.method).toBe("GET");
+        expect(call.url).toBe("/api/v1/aggregate/graph");
+        expect(call.params).toEqual({
+          period: AggregateGraphPeriod.OneYear,
+          sectorId: "65533e047844ee7afe9941b9",
+          industryId: "65533e441fa5c7b58afa0944",
+          collectionId: "",
+          region: Region.Tr,
+        });
 
         expect(resp.previous_close).toBe(98.5);
         expect(resp.graph).toHaveLength(3);
+
+        expect(resp.graph[0].d).toBe(1710403200000);
         expect(resp.graph[0].o).toBe(100.5);
         expect(resp.graph[0].h).toBe(105.2);
         expect(resp.graph[0].l).toBe(99.8);
         expect(resp.graph[0].c).toBe(103.7);
-        expect(resp.graph[2].c).toBe(107.8);
-
-        expect(client.getAggregateGraph).toHaveBeenCalledWith(HistoricalPricePeriod.OneMonth, "sector1", "", "", Region.Tr);
-      });
-
-      test("should get aggregate graph for industry", async () => {
-        jest.spyOn(client, 'getAggregateGraph').mockResolvedValue(mockCollectionPriceGraph);
-
-        const resp = await client.getAggregateGraph(HistoricalPricePeriod.ThreeMonth, "", "industry1", "", Region.Tr);
 
-        expect(resp.previous_close).toBe(98.5);
-        expect(resp.graph).toHaveLength(3);
+        expect(resp.graph[1].d).toBe(1710489600000);
         expect(resp.graph[1].o).toBe(103.7);
         expect(resp.graph[1].h).toBe(107.1);
         expect(resp.graph[1].l).toBe(102.3);
         expect(resp.graph[1].c).toBe(106.4);
 
-        expect(client.getAggregateGraph).toHaveBeenCalledWith(HistoricalPricePeriod.ThreeMonth, "", "industry1", "", Region.Tr);
-      });
-
-      test("should get aggregate graph for collection", async () => {
-        jest.spyOn(client, 'getAggregateGraph').mockResolvedValue(mockCollectionPriceGraph);
-
-        const resp = await client.getAggregateGraph(HistoricalPricePeriod.OneWeek, "", "", "collection1", Region.Tr);
-
-        expect(resp.previous_close).toBe(98.5);
-        expect(resp.graph).toHaveLength(3);
-        expect(resp.graph[0].d).toBe(1710403200000);
-        expect(resp.graph[1].d).toBe(1710489600000);
         expect(resp.graph[2].d).toBe(1710576000000);
-
-        expect(client.getAggregateGraph).toHaveBeenCalledWith(HistoricalPricePeriod.OneWeek, "", "", "collection1", Region.Tr);
-      });
-
-      test("should get aggregate graph for different periods", async () => {
-        jest.spyOn(client, 'getAggregateGraph').mockResolvedValue(mockCollectionPriceGraph);
-
-        const resp1D = await client.getAggregateGraph(HistoricalPricePeriod.OneDay, "sector1", "", "", Region.Tr);
-        expect(resp1D.previous_close).toBe(98.5);
-        expect(client.getAggregateGraph).toHaveBeenCalledWith(HistoricalPricePeriod.OneDay, "sector1", "", "", Region.Tr);
-
-        const resp1Y = await client.getAggregateGraph(HistoricalPricePeriod.OneYear, "", "industry1", "", Region.Tr);
-        expect(resp1Y.previous_close).toBe(98.5);
-        expect(client.getAggregateGraph).toHaveBeenCalledWith(HistoricalPricePeriod.OneYear, "", "industry1", "", Region.Tr);
-
-        const resp5Y = await client.getAggregateGraph(HistoricalPricePeriod.FiveYear, "", "", "collection1", Region.Tr);
-        expect(resp5Y.previous_close).toBe(98.5);
-        expect(client.getAggregateGraph).toHaveBeenCalledWith(HistoricalPricePeriod.FiveYear, "", "", "collection1", Region.Tr);
-      });
-    });
-
-    describe("Error Handling", () => {
-      test("should handle invalid industry ID", async () => {
-        jest.spyOn(client, 'getIndustryDetail').mockRejectedValue(new Error("Industry not found"));
-
-        await expect(client.getIndustryDetail("invalid-id", Region.Tr, Locale.Tr))
-          .rejects.toThrow("Industry not found");
-      });
-
-      test("should handle invalid sector ID", async () => {
-        jest.spyOn(client, 'getSectorDetail').mockRejectedValue(new Error("Sector not found"));
-
-        await expect(client.getSectorDetail("invalid-id", Region.Tr, Locale.Tr))
-          .rejects.toThrow("Sector not found");
-      });
-
-      test("should handle invalid theme ID", async () => {
-        jest.spyOn(client, 'getThemeDetail').mockRejectedValue(new Error("Theme not found"));
-
-        await expect(client.getThemeDetail("invalid-id", Region.Tr, Locale.Tr))
-          .rejects.toThrow("Theme not found");
-      });
-
-      test("should handle invalid collection ID", async () => {
-        jest.spyOn(client, 'getCollectionDetail').mockRejectedValue(new Error("Collection not found"));
-
-        await expect(client.getCollectionDetail("invalid-id", Region.Tr, Locale.Tr))
-          .rejects.toThrow("Collection not found");
+        expect(resp.graph[2].o).toBe(106.4);
+        expect(resp.graph[2].h).toBe(108.9);
+        expect(resp.graph[2].l).toBe(105.1);
+        expect(resp.graph[2].c).toBe(107.8);
       });
 
-      test("should handle invalid aggregate graph request", async () => {
-        jest.spyOn(client, 'getAggregateGraph').mockRejectedValue(new Error("Invalid parameters"));
-
-        await expect(client.getAggregateGraph("invalid-period" as HistoricalPricePeriod, "invalid-sector", "", "", Region.Tr))
-          .rejects.toThrow("Invalid parameters");
+      test("bubbles up request error", async () => {
+        cli.request.mockRejectedValueOnce(new Error("Invalid parameters"));
+
+        await expect(
+          client.getAggregateGraph(
+            AggregateGraphPeriod.OneMonth,
+            "",
+            "",
+            "collection1",
+            Region.Tr
+          )
+        ).rejects.toThrow("Invalid parameters");
       });
     });
   });