feat: enrich ledger events with logo metadata

src/tbank/brokerage-operations.service.spec.ts

@@ -17,10 +17,12 @@ describe('BrokerageOperationsService', () => {
     getOperationsByCursor: jest.fn(),
   };
   const requestContext = { set: jest.fn() };
+  const metadata = { resolve: jest.fn() };
   const service = new BrokerageOperationsService(
     access as never,
     tbank as never,
     requestContext as never,
+    metadata as never,
   );
   let operationsRequest: unknown;
 
@@ -28,6 +30,7 @@ describe('BrokerageOperationsService', () => {
     jest.clearAllMocks();
     access.withAccount.mockReset();
     tbank.getOperationsByCursor.mockReset();
+    metadata.resolve.mockReset();
     access.withAccount.mockImplementation(
       (
         _userId: string,
@@ -103,6 +106,94 @@ describe('BrokerageOperationsService', () => {
     );
   });
 
+  it('includes resolved instrument logo metadata in a ledger entry', async () => {
+    tbank.getOperationsByCursor.mockResolvedValue({
+      items: [
+        {
+          id: 'coupon',
+          date: { seconds: '1' },
+          type: 'OPERATION_TYPE_COUPON',
+          instrumentUid: 'instrument-uid',
+        },
+      ],
+    });
+    metadata.resolve.mockResolvedValue({
+      brand: { logoName: 'instrument-logo.png' },
+    });
+
+    await expect(service.get('user', 'account', {})).resolves.toMatchObject({
+      items: [{ id: 'coupon', logoName: 'instrument-logo.png' }],
+    });
+  });
+
+  it('resolves repeated instrument metadata only once per ledger page', async () => {
+    tbank.getOperationsByCursor.mockResolvedValue({
+      items: [
+        {
+          id: 'first',
+          date: { seconds: '1' },
+          type: 'OPERATION_TYPE_COUPON',
+          instrumentUid: 'instrument-uid',
+        },
+        {
+          id: 'second',
+          date: { seconds: '2' },
+          type: 'OPERATION_TYPE_COUPON',
+          instrumentUid: 'instrument-uid',
+        },
+      ],
+    });
+    metadata.resolve.mockResolvedValue({
+      brand: { logoName: 'instrument-logo.png' },
+    });
+
+    await service.get('user', 'account', {});
+
+    expect(metadata.resolve).toHaveBeenCalledTimes(1);
+  });
+
+  it('does not let a UID-only lookup suppress a later FIGI fallback on the same page', async () => {
+    tbank.getOperationsByCursor.mockResolvedValue({
+      items: [
+        {
+          id: 'first',
+          date: { seconds: '1' },
+          type: 'OPERATION_TYPE_COUPON',
+          instrumentUid: 'instrument-uid',
+        },
+        {
+          id: 'second',
+          date: { seconds: '2' },
+          type: 'OPERATION_TYPE_COUPON',
+          instrumentUid: 'instrument-uid',
+          figi: 'BBG000000001',
+        },
+      ],
+    });
+    metadata.resolve.mockResolvedValueOnce(null).mockResolvedValueOnce({
+      brand: { logoName: 'fallback-logo.png' },
+    });
+
+    await expect(service.get('user', 'account', {})).resolves.toMatchObject({
+      items: [
+        { id: 'first', logoName: null },
+        { id: 'second', logoName: 'fallback-logo.png' },
+      ],
+    });
+    expect(metadata.resolve).toHaveBeenNthCalledWith(
+      1,
+      'token',
+      'instrument-uid',
+      null,
+    );
+    expect(metadata.resolve).toHaveBeenNthCalledWith(
+      2,
+      'token',
+      'instrument-uid',
+      'BBG000000001',
+    );
+  });
+
   it('returns an empty page without calling T-Bank when the period starts in the future', async () => {
     await expect(
       service.get('user', 'account', { from: '2999-01-01T00:00:00.000Z' }),