@trufnetwork/sdk-js 0.3.8 → 0.4.2

package/dist/esm/contracts-api/composedAction.test.mjs

@@ -0,0 +1,299 @@
+// src/contracts-api/composedAction.test.ts
+import { describe, test, expect, vi } from "vitest";
+import { ComposedAction } from "./composedAction.mjs";
+import { EthereumAddress } from "../util/EthereumAddress.mjs";
+import { StreamId } from "../util/StreamId.mjs";
+describe("ComposedAction Taxonomy Query Methods", () => {
+  const createMockClient = (mockResponse) => ({
+    call: vi.fn().mockResolvedValue({
+      status: 200,
+      data: {
+        result: mockResponse
+      }
+    })
+  });
+  const mockSigner = {};
+  test("listTaxonomiesByHeight calls correct action with parameters", async () => {
+    const mockResponse = [
+      {
+        data_provider: "0x1234567890abcdef1234567890abcdef12345678",
+        stream_id: "test-stream",
+        child_data_provider: "0xabcdef1234567890abcdef1234567890abcdef12",
+        child_stream_id: "child-stream",
+        weight: "100.5",
+        created_at: 1e3,
+        group_sequence: 1,
+        start_time: 1625097600
+      }
+    ];
+    const mockClient = createMockClient(mockResponse);
+    const composedAction = new ComposedAction(mockClient, mockSigner);
+    const result = await composedAction.listTaxonomiesByHeight({
+      fromHeight: 1e3,
+      toHeight: 2e3,
+      limit: 100,
+      offset: 10,
+      latestOnly: true
+    });
+    expect(mockClient.call).toHaveBeenCalledWith(
+      {
+        namespace: "main",
+        name: "list_taxonomies_by_height",
+        inputs: {
+          $from_height: 1e3,
+          $to_height: 2e3,
+          $limit: 100,
+          $offset: 10,
+          $latest_only: true
+        }
+      },
+      {}
+    );
+    expect(result).toHaveLength(1);
+    expect(result[0].dataProvider.getAddress()).toBe("0x1234567890abcdef1234567890abcdef12345678");
+    expect(result[0].streamId.getId()).toBe("test-stream");
+    expect(result[0].childDataProvider.getAddress()).toBe("0xabcdef1234567890abcdef1234567890abcdef12");
+    expect(result[0].childStreamId.getId()).toBe("child-stream");
+    expect(result[0].weight).toBe("100.5");
+    expect(result[0].createdAt).toBe(1e3);
+    expect(result[0].groupSequence).toBe(1);
+    expect(result[0].startTime).toBe(1625097600);
+  });
+  test("listTaxonomiesByHeight handles default parameters", async () => {
+    const mockClient = createMockClient([]);
+    const composedAction = new ComposedAction(mockClient, mockSigner);
+    await composedAction.listTaxonomiesByHeight({});
+    expect(mockClient.call).toHaveBeenCalledWith(
+      {
+        namespace: "main",
+        name: "list_taxonomies_by_height",
+        inputs: {
+          $from_height: null,
+          $to_height: null,
+          $limit: null,
+          $offset: null,
+          $latest_only: null
+        }
+      },
+      {}
+    );
+  });
+  test("listTaxonomiesByHeight handles empty parameters", async () => {
+    const mockClient = createMockClient([]);
+    const composedAction = new ComposedAction(mockClient, mockSigner);
+    await composedAction.listTaxonomiesByHeight();
+    expect(mockClient.call).toHaveBeenCalledWith(
+      {
+        namespace: "main",
+        name: "list_taxonomies_by_height",
+        inputs: {
+          $from_height: null,
+          $to_height: null,
+          $limit: null,
+          $offset: null,
+          $latest_only: null
+        }
+      },
+      {}
+    );
+  });
+  test("getTaxonomiesForStreams calls correct action with stream arrays", async () => {
+    const mockResponse = [
+      {
+        data_provider: "0x1111111111111111111111111111111111111111",
+        stream_id: "stream-1",
+        child_data_provider: "0x2222222222222222222222222222222222222222",
+        child_stream_id: "child-1",
+        weight: "50.0",
+        created_at: 2e3,
+        group_sequence: 2,
+        start_time: 1625097700
+      }
+    ];
+    const mockClient = createMockClient(mockResponse);
+    const composedAction = new ComposedAction(mockClient, mockSigner);
+    const testStreams = [
+      {
+        dataProvider: EthereumAddress.fromString("0x1111111111111111111111111111111111111111").throw(),
+        streamId: StreamId.fromString("stream-1").throw()
+      },
+      {
+        dataProvider: EthereumAddress.fromString("0x3333333333333333333333333333333333333333").throw(),
+        streamId: StreamId.fromString("stream-2").throw()
+      }
+    ];
+    const result = await composedAction.getTaxonomiesForStreams({
+      streams: testStreams,
+      latestOnly: false
+    });
+    expect(mockClient.call).toHaveBeenCalledWith(
+      {
+        namespace: "main",
+        name: "get_taxonomies_for_streams",
+        inputs: {
+          $data_providers: [
+            "0x1111111111111111111111111111111111111111",
+            "0x3333333333333333333333333333333333333333"
+          ],
+          $stream_ids: ["stream-1", "stream-2"],
+          $latest_only: false
+        }
+      },
+      {}
+    );
+    expect(result).toHaveLength(1);
+    expect(result[0].dataProvider.getAddress()).toBe("0x1111111111111111111111111111111111111111");
+    expect(result[0].streamId.getId()).toBe("stream-1");
+    expect(result[0].weight).toBe("50.0");
+  });
+  test("getTaxonomiesForStreams handles empty stream array", async () => {
+    const mockClient = createMockClient([]);
+    const composedAction = new ComposedAction(mockClient, mockSigner);
+    const result = await composedAction.getTaxonomiesForStreams({
+      streams: [],
+      latestOnly: true
+    });
+    expect(mockClient.call).not.toHaveBeenCalled();
+    expect(result).toEqual([]);
+  });
+  test("getTaxonomiesForStreams handles latestOnly parameter", async () => {
+    const mockClient = createMockClient([]);
+    const composedAction = new ComposedAction(mockClient, mockSigner);
+    const testStreams = [
+      {
+        dataProvider: EthereumAddress.fromString("0x1111111111111111111111111111111111111111").throw(),
+        streamId: StreamId.fromString("stream-1").throw()
+      }
+    ];
+    await composedAction.getTaxonomiesForStreams({
+      streams: testStreams,
+      latestOnly: true
+    });
+    expect(mockClient.call).toHaveBeenCalledWith(
+      {
+        namespace: "main",
+        name: "get_taxonomies_for_streams",
+        inputs: expect.objectContaining({
+          $latest_only: true
+        })
+      },
+      {}
+    );
+  });
+  test("getTaxonomiesForStreams handles default latestOnly parameter", async () => {
+    const mockClient = createMockClient([]);
+    const composedAction = new ComposedAction(mockClient, mockSigner);
+    const testStreams = [
+      {
+        dataProvider: EthereumAddress.fromString("0x1111111111111111111111111111111111111111").throw(),
+        streamId: StreamId.fromString("stream-1").throw()
+      }
+    ];
+    await composedAction.getTaxonomiesForStreams({
+      streams: testStreams
+    });
+    expect(mockClient.call).toHaveBeenCalledWith(
+      {
+        namespace: "main",
+        name: "get_taxonomies_for_streams",
+        inputs: expect.objectContaining({
+          $latest_only: null
+        })
+      },
+      {}
+    );
+  });
+  test("listTaxonomiesByHeight handles network error", async () => {
+    const mockClient = {
+      call: vi.fn().mockResolvedValue({
+        status: 500,
+        data: null
+      })
+    };
+    const composedAction = new ComposedAction(mockClient, mockSigner);
+    await expect(
+      composedAction.listTaxonomiesByHeight({
+        fromHeight: 1e3,
+        toHeight: 2e3
+      })
+    ).rejects.toThrow();
+  });
+  test("getTaxonomiesForStreams handles network error", async () => {
+    const mockClient = {
+      call: vi.fn().mockResolvedValue({
+        status: 404,
+        data: null
+      })
+    };
+    const composedAction = new ComposedAction(mockClient, mockSigner);
+    const testStreams = [
+      {
+        dataProvider: EthereumAddress.fromString("0x1111111111111111111111111111111111111111").throw(),
+        streamId: StreamId.fromString("stream-1").throw()
+      }
+    ];
+    await expect(
+      composedAction.getTaxonomiesForStreams({
+        streams: testStreams
+      })
+    ).rejects.toThrow();
+  });
+  test("methods handle multiple results correctly", async () => {
+    const mockResponse = [
+      {
+        data_provider: "0x1111111111111111111111111111111111111111",
+        stream_id: "stream-1",
+        child_data_provider: "0x2222222222222222222222222222222222222222",
+        child_stream_id: "child-1",
+        weight: "50.0",
+        created_at: 2e3,
+        group_sequence: 1,
+        start_time: 1625097600
+      },
+      {
+        data_provider: "0x1111111111111111111111111111111111111111",
+        stream_id: "stream-1",
+        child_data_provider: "0x3333333333333333333333333333333333333333",
+        child_stream_id: "child-2",
+        weight: "25.5",
+        created_at: 2e3,
+        group_sequence: 1,
+        start_time: 1625097600
+      }
+    ];
+    const mockClient = createMockClient(mockResponse);
+    const composedAction = new ComposedAction(mockClient, mockSigner);
+    const result = await composedAction.listTaxonomiesByHeight({ limit: 10 });
+    expect(result).toHaveLength(2);
+    expect(result[0].childStreamId.getId()).toBe("child-1");
+    expect(result[1].childStreamId.getId()).toBe("child-2");
+    expect(result[0].weight).toBe("50.0");
+    expect(result[1].weight).toBe("25.5");
+  });
+  test("methods handle address parsing correctly", async () => {
+    const mockResponse = [
+      {
+        data_provider: "0x1234567890abcdef1234567890abcdef12345678",
+        stream_id: "test-stream",
+        child_data_provider: "0xabcdef1234567890abcdef1234567890abcdef12",
+        child_stream_id: "child-stream",
+        weight: "100.0",
+        created_at: 1e3,
+        group_sequence: 1,
+        start_time: 1625097600
+      }
+    ];
+    const mockClient = createMockClient(mockResponse);
+    const composedAction = new ComposedAction(mockClient, mockSigner);
+    const result = await composedAction.listTaxonomiesByHeight();
+    expect(result[0].dataProvider).toBeInstanceOf(EthereumAddress);
+    expect(result[0].streamId).toBeInstanceOf(StreamId);
+    expect(result[0].childDataProvider).toBeInstanceOf(EthereumAddress);
+    expect(result[0].childStreamId).toBeInstanceOf(StreamId);
+    expect(result[0].dataProvider.getAddress()).toBe("0x1234567890abcdef1234567890abcdef12345678");
+    expect(result[0].streamId.getId()).toBe("test-stream");
+    expect(result[0].childDataProvider.getAddress()).toBe("0xabcdef1234567890abcdef1234567890abcdef12");
+    expect(result[0].childStreamId.getId()).toBe("child-stream");
+  });
+});
+//# sourceMappingURL=composedAction.test.mjs.map

package/dist/esm/contracts-api/composedAction.test.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/contracts-api/composedAction.test.ts"],
+  "sourcesContent": ["import { describe, test, expect, vi } from 'vitest'\r\nimport { ComposedAction } from './composedAction'\r\nimport { EthereumAddress } from '../util/EthereumAddress'\r\nimport { StreamId } from '../util/StreamId'\r\n\r\ndescribe('ComposedAction Taxonomy Query Methods', () => {\r\n  const createMockClient = (mockResponse: any) => ({\r\n    call: vi.fn().mockResolvedValue({\r\n      status: 200,\r\n      data: {\r\n        result: mockResponse\r\n      }\r\n    })\r\n  });\r\n\r\n  const mockSigner = {};\r\n\r\n  test('listTaxonomiesByHeight calls correct action with parameters', async () => {\r\n    const mockResponse = [\r\n      {\r\n        data_provider: '0x1234567890abcdef1234567890abcdef12345678',\r\n        stream_id: 'test-stream',\r\n        child_data_provider: '0xabcdef1234567890abcdef1234567890abcdef12',\r\n        child_stream_id: 'child-stream',\r\n        weight: '100.5',\r\n        created_at: 1000,\r\n        group_sequence: 1,\r\n        start_time: 1625097600\r\n      }\r\n    ];\r\n\r\n    const mockClient = createMockClient(mockResponse);\r\n    const composedAction = new ComposedAction(mockClient as any, mockSigner as any);\r\n\r\n    const result = await composedAction.listTaxonomiesByHeight({\r\n      fromHeight: 1000,\r\n      toHeight: 2000,\r\n      limit: 100,\r\n      offset: 10,\r\n      latestOnly: true\r\n    });\r\n\r\n    // Verify the call was made correctly\r\n    expect(mockClient.call).toHaveBeenCalledWith(\r\n      {\r\n        namespace: \"main\",\r\n        name: 'list_taxonomies_by_height',\r\n        inputs: {\r\n          $from_height: 1000,\r\n          $to_height: 2000,\r\n          $limit: 100,\r\n          $offset: 10,\r\n          $latest_only: true,\r\n        }\r\n      },\r\n      {}\r\n    );\r\n\r\n    // Verify response mapping\r\n    expect(result).toHaveLength(1);\r\n    expect(result[0].dataProvider.getAddress()).toBe('0x1234567890abcdef1234567890abcdef12345678');\r\n    expect(result[0].streamId.getId()).toBe('test-stream');\r\n    expect(result[0].childDataProvider.getAddress()).toBe('0xabcdef1234567890abcdef1234567890abcdef12');\r\n    expect(result[0].childStreamId.getId()).toBe('child-stream');\r\n    expect(result[0].weight).toBe('100.5');\r\n    expect(result[0].createdAt).toBe(1000);\r\n    expect(result[0].groupSequence).toBe(1);\r\n    expect(result[0].startTime).toBe(1625097600);\r\n  });\r\n\r\n  test('listTaxonomiesByHeight handles default parameters', async () => {\r\n    const mockClient = createMockClient([]);\r\n    const composedAction = new ComposedAction(mockClient as any, mockSigner as any);\r\n\r\n    await composedAction.listTaxonomiesByHeight({});\r\n\r\n    expect(mockClient.call).toHaveBeenCalledWith(\r\n      {\r\n        namespace: \"main\",\r\n        name: 'list_taxonomies_by_height',\r\n        inputs: {\r\n          $from_height: null,\r\n          $to_height: null,\r\n          $limit: null,\r\n          $offset: null,\r\n          $latest_only: null,\r\n        }\r\n      },\r\n      {}\r\n    );\r\n  });\r\n\r\n  test('listTaxonomiesByHeight handles empty parameters', async () => {\r\n    const mockClient = createMockClient([]);\r\n    const composedAction = new ComposedAction(mockClient as any, mockSigner as any);\r\n\r\n    await composedAction.listTaxonomiesByHeight();\r\n\r\n    expect(mockClient.call).toHaveBeenCalledWith(\r\n      {\r\n        namespace: \"main\",\r\n        name: 'list_taxonomies_by_height',\r\n        inputs: {\r\n          $from_height: null,\r\n          $to_height: null,\r\n          $limit: null,\r\n          $offset: null,\r\n          $latest_only: null,\r\n        }\r\n      },\r\n      {}\r\n    );\r\n  });\r\n\r\n  test('getTaxonomiesForStreams calls correct action with stream arrays', async () => {\r\n    const mockResponse = [\r\n      {\r\n        data_provider: '0x1111111111111111111111111111111111111111',\r\n        stream_id: 'stream-1',\r\n        child_data_provider: '0x2222222222222222222222222222222222222222',\r\n        child_stream_id: 'child-1',\r\n        weight: '50.0',\r\n        created_at: 2000,\r\n        group_sequence: 2,\r\n        start_time: 1625097700\r\n      }\r\n    ];\r\n\r\n    const mockClient = createMockClient(mockResponse);\r\n    const composedAction = new ComposedAction(mockClient as any, mockSigner as any);\r\n\r\n    const testStreams = [\r\n      {\r\n        dataProvider: EthereumAddress.fromString('0x1111111111111111111111111111111111111111').throw(),\r\n        streamId: StreamId.fromString('stream-1').throw()\r\n      },\r\n      {\r\n        dataProvider: EthereumAddress.fromString('0x3333333333333333333333333333333333333333').throw(),\r\n        streamId: StreamId.fromString('stream-2').throw()\r\n      }\r\n    ];\r\n\r\n    const result = await composedAction.getTaxonomiesForStreams({\r\n      streams: testStreams,\r\n      latestOnly: false\r\n    });\r\n\r\n    // Verify the call was made correctly\r\n    expect(mockClient.call).toHaveBeenCalledWith(\r\n      {\r\n        namespace: \"main\",\r\n        name: 'get_taxonomies_for_streams',\r\n        inputs: {\r\n          $data_providers: [\r\n            '0x1111111111111111111111111111111111111111',\r\n            '0x3333333333333333333333333333333333333333'\r\n          ],\r\n          $stream_ids: ['stream-1', 'stream-2'],\r\n          $latest_only: false,\r\n        }\r\n      },\r\n      {}\r\n    );\r\n\r\n    // Verify response mapping\r\n    expect(result).toHaveLength(1);\r\n    expect(result[0].dataProvider.getAddress()).toBe('0x1111111111111111111111111111111111111111');\r\n    expect(result[0].streamId.getId()).toBe('stream-1');\r\n    expect(result[0].weight).toBe('50.0');\r\n  });\r\n\r\n  test('getTaxonomiesForStreams handles empty stream array', async () => {\r\n    const mockClient = createMockClient([]);\r\n    const composedAction = new ComposedAction(mockClient as any, mockSigner as any);\r\n\r\n    const result = await composedAction.getTaxonomiesForStreams({\r\n      streams: [],\r\n      latestOnly: true\r\n    });\r\n\r\n    // Should return empty array without making network call\r\n    expect(mockClient.call).not.toHaveBeenCalled();\r\n    expect(result).toEqual([]);\r\n  });\r\n\r\n  test('getTaxonomiesForStreams handles latestOnly parameter', async () => {\r\n    const mockClient = createMockClient([]);\r\n    const composedAction = new ComposedAction(mockClient as any, mockSigner as any);\r\n\r\n    const testStreams = [\r\n      {\r\n        dataProvider: EthereumAddress.fromString('0x1111111111111111111111111111111111111111').throw(),\r\n        streamId: StreamId.fromString('stream-1').throw()\r\n      }\r\n    ];\r\n\r\n    await composedAction.getTaxonomiesForStreams({\r\n      streams: testStreams,\r\n      latestOnly: true\r\n    });\r\n\r\n    expect(mockClient.call).toHaveBeenCalledWith(\r\n      {\r\n        namespace: \"main\",\r\n        name: 'get_taxonomies_for_streams',\r\n        inputs: expect.objectContaining({\r\n          $latest_only: true,\r\n        })\r\n      },\r\n      {}\r\n    );\r\n  });\r\n\r\n  test('getTaxonomiesForStreams handles default latestOnly parameter', async () => {\r\n    const mockClient = createMockClient([]);\r\n    const composedAction = new ComposedAction(mockClient as any, mockSigner as any);\r\n\r\n    const testStreams = [\r\n      {\r\n        dataProvider: EthereumAddress.fromString('0x1111111111111111111111111111111111111111').throw(),\r\n        streamId: StreamId.fromString('stream-1').throw()\r\n      }\r\n    ];\r\n\r\n    await composedAction.getTaxonomiesForStreams({\r\n      streams: testStreams\r\n    });\r\n\r\n    expect(mockClient.call).toHaveBeenCalledWith(\r\n      {\r\n        namespace: \"main\",\r\n        name: 'get_taxonomies_for_streams',\r\n        inputs: expect.objectContaining({\r\n          $latest_only: null,\r\n        })\r\n      },\r\n      {}\r\n    );\r\n  });\r\n\r\n  test('listTaxonomiesByHeight handles network error', async () => {\r\n    const mockClient = {\r\n      call: vi.fn().mockResolvedValue({\r\n        status: 500,\r\n        data: null\r\n      })\r\n    };\r\n\r\n    const composedAction = new ComposedAction(mockClient as any, mockSigner as any);\r\n\r\n    await expect(\r\n      composedAction.listTaxonomiesByHeight({\r\n        fromHeight: 1000,\r\n        toHeight: 2000\r\n      })\r\n    ).rejects.toThrow();\r\n  });\r\n\r\n  test('getTaxonomiesForStreams handles network error', async () => {\r\n    const mockClient = {\r\n      call: vi.fn().mockResolvedValue({\r\n        status: 404,\r\n        data: null\r\n      })\r\n    };\r\n\r\n    const composedAction = new ComposedAction(mockClient as any, mockSigner as any);\r\n\r\n    const testStreams = [\r\n      {\r\n        dataProvider: EthereumAddress.fromString('0x1111111111111111111111111111111111111111').throw(),\r\n        streamId: StreamId.fromString('stream-1').throw()\r\n      }\r\n    ];\r\n\r\n    await expect(\r\n      composedAction.getTaxonomiesForStreams({\r\n        streams: testStreams\r\n      })\r\n    ).rejects.toThrow();\r\n  });\r\n\r\n  test('methods handle multiple results correctly', async () => {\r\n    const mockResponse = [\r\n      {\r\n        data_provider: '0x1111111111111111111111111111111111111111',\r\n        stream_id: 'stream-1',\r\n        child_data_provider: '0x2222222222222222222222222222222222222222',\r\n        child_stream_id: 'child-1',\r\n        weight: '50.0',\r\n        created_at: 2000,\r\n        group_sequence: 1,\r\n        start_time: 1625097600\r\n      },\r\n      {\r\n        data_provider: '0x1111111111111111111111111111111111111111',\r\n        stream_id: 'stream-1',\r\n        child_data_provider: '0x3333333333333333333333333333333333333333',\r\n        child_stream_id: 'child-2',\r\n        weight: '25.5',\r\n        created_at: 2000,\r\n        group_sequence: 1,\r\n        start_time: 1625097600\r\n      }\r\n    ];\r\n\r\n    const mockClient = createMockClient(mockResponse);\r\n    const composedAction = new ComposedAction(mockClient as any, mockSigner as any);\r\n\r\n    const result = await composedAction.listTaxonomiesByHeight({ limit: 10 });\r\n\r\n    expect(result).toHaveLength(2);\r\n    expect(result[0].childStreamId.getId()).toBe('child-1');\r\n    expect(result[1].childStreamId.getId()).toBe('child-2');\r\n    expect(result[0].weight).toBe('50.0');\r\n    expect(result[1].weight).toBe('25.5');\r\n  });\r\n\r\n  test('methods handle address parsing correctly', async () => {\r\n    const mockResponse = [\r\n      {\r\n        data_provider: '0x1234567890abcdef1234567890abcdef12345678',\r\n        stream_id: 'test-stream',\r\n        child_data_provider: '0xabcdef1234567890abcdef1234567890abcdef12',\r\n        child_stream_id: 'child-stream',\r\n        weight: '100.0',\r\n        created_at: 1000,\r\n        group_sequence: 1,\r\n        start_time: 1625097600\r\n      }\r\n    ];\r\n\r\n    const mockClient = createMockClient(mockResponse);\r\n    const composedAction = new ComposedAction(mockClient as any, mockSigner as any);\r\n\r\n    const result = await composedAction.listTaxonomiesByHeight();\r\n\r\n    expect(result[0].dataProvider).toBeInstanceOf(EthereumAddress);\r\n    expect(result[0].streamId).toBeInstanceOf(StreamId);\r\n    expect(result[0].childDataProvider).toBeInstanceOf(EthereumAddress);\r\n    expect(result[0].childStreamId).toBeInstanceOf(StreamId);\r\n    \r\n    expect(result[0].dataProvider.getAddress()).toBe('0x1234567890abcdef1234567890abcdef12345678');\r\n    expect(result[0].streamId.getId()).toBe('test-stream');\r\n    expect(result[0].childDataProvider.getAddress()).toBe('0xabcdef1234567890abcdef1234567890abcdef12');\r\n    expect(result[0].childStreamId.getId()).toBe('child-stream');\r\n  });\r\n});"],
+  "mappings": ";AAAA,SAAS,UAAU,MAAM,QAAQ,UAAU;AAC3C,SAAS,sBAAsB;AAC/B,SAAS,uBAAuB;AAChC,SAAS,gBAAgB;AAEzB,SAAS,yCAAyC,MAAM;AACtD,QAAM,mBAAmB,CAAC,kBAAuB;AAAA,IAC/C,MAAM,GAAG,GAAG,EAAE,kBAAkB;AAAA,MAC9B,QAAQ;AAAA,MACR,MAAM;AAAA,QACJ,QAAQ;AAAA,MACV;AAAA,IACF,CAAC;AAAA,EACH;AAEA,QAAM,aAAa,CAAC;AAEpB,OAAK,+DAA+D,YAAY;AAC9E,UAAM,eAAe;AAAA,MACnB;AAAA,QACE,eAAe;AAAA,QACf,WAAW;AAAA,QACX,qBAAqB;AAAA,QACrB,iBAAiB;AAAA,QACjB,QAAQ;AAAA,QACR,YAAY;AAAA,QACZ,gBAAgB;AAAA,QAChB,YAAY;AAAA,MACd;AAAA,IACF;AAEA,UAAM,aAAa,iBAAiB,YAAY;AAChD,UAAM,iBAAiB,IAAI,eAAe,YAAmB,UAAiB;AAE9E,UAAM,SAAS,MAAM,eAAe,uBAAuB;AAAA,MACzD,YAAY;AAAA,MACZ,UAAU;AAAA,MACV,OAAO;AAAA,MACP,QAAQ;AAAA,MACR,YAAY;AAAA,IACd,CAAC;AAGD,WAAO,WAAW,IAAI,EAAE;AAAA,MACtB;AAAA,QACE,WAAW;AAAA,QACX,MAAM;AAAA,QACN,QAAQ;AAAA,UACN,cAAc;AAAA,UACd,YAAY;AAAA,UACZ,QAAQ;AAAA,UACR,SAAS;AAAA,UACT,cAAc;AAAA,QAChB;AAAA,MACF;AAAA,MACA,CAAC;AAAA,IACH;AAGA,WAAO,MAAM,EAAE,aAAa,CAAC;AAC7B,WAAO,OAAO,CAAC,EAAE,aAAa,WAAW,CAAC,EAAE,KAAK,4CAA4C;AAC7F,WAAO,OAAO,CAAC,EAAE,SAAS,MAAM,CAAC,EAAE,KAAK,aAAa;AACrD,WAAO,OAAO,CAAC,EAAE,kBAAkB,WAAW,CAAC,EAAE,KAAK,4CAA4C;AAClG,WAAO,OAAO,CAAC,EAAE,cAAc,MAAM,CAAC,EAAE,KAAK,cAAc;AAC3D,WAAO,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,OAAO;AACrC,WAAO,OAAO,CAAC,EAAE,SAAS,EAAE,KAAK,GAAI;AACrC,WAAO,OAAO,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC;AACtC,WAAO,OAAO,CAAC,EAAE,SAAS,EAAE,KAAK,UAAU;AAAA,EAC7C,CAAC;AAED,OAAK,qDAAqD,YAAY;AACpE,UAAM,aAAa,iBAAiB,CAAC,CAAC;AACtC,UAAM,iBAAiB,IAAI,eAAe,YAAmB,UAAiB;AAE9E,UAAM,eAAe,uBAAuB,CAAC,CAAC;AAE9C,WAAO,WAAW,IAAI,EAAE;AAAA,MACtB;AAAA,QACE,WAAW;AAAA,QACX,MAAM;AAAA,QACN,QAAQ;AAAA,UACN,cAAc;AAAA,UACd,YAAY;AAAA,UACZ,QAAQ;AAAA,UACR,SAAS;AAAA,UACT,cAAc;AAAA,QAChB;AAAA,MACF;AAAA,MACA,CAAC;AAAA,IACH;AAAA,EACF,CAAC;AAED,OAAK,mDAAmD,YAAY;AAClE,UAAM,aAAa,iBAAiB,CAAC,CAAC;AACtC,UAAM,iBAAiB,IAAI,eAAe,YAAmB,UAAiB;AAE9E,UAAM,eAAe,uBAAuB;AAE5C,WAAO,WAAW,IAAI,EAAE;AAAA,MACtB;AAAA,QACE,WAAW;AAAA,QACX,MAAM;AAAA,QACN,QAAQ;AAAA,UACN,cAAc;AAAA,UACd,YAAY;AAAA,UACZ,QAAQ;AAAA,UACR,SAAS;AAAA,UACT,cAAc;AAAA,QAChB;AAAA,MACF;AAAA,MACA,CAAC;AAAA,IACH;AAAA,EACF,CAAC;AAED,OAAK,mEAAmE,YAAY;AAClF,UAAM,eAAe;AAAA,MACnB;AAAA,QACE,eAAe;AAAA,QACf,WAAW;AAAA,QACX,qBAAqB;AAAA,QACrB,iBAAiB;AAAA,QACjB,QAAQ;AAAA,QACR,YAAY;AAAA,QACZ,gBAAgB;AAAA,QAChB,YAAY;AAAA,MACd;AAAA,IACF;AAEA,UAAM,aAAa,iBAAiB,YAAY;AAChD,UAAM,iBAAiB,IAAI,eAAe,YAAmB,UAAiB;AAE9E,UAAM,cAAc;AAAA,MAClB;AAAA,QACE,cAAc,gBAAgB,WAAW,4CAA4C,EAAE,MAAM;AAAA,QAC7F,UAAU,SAAS,WAAW,UAAU,EAAE,MAAM;AAAA,MAClD;AAAA,MACA;AAAA,QACE,cAAc,gBAAgB,WAAW,4CAA4C,EAAE,MAAM;AAAA,QAC7F,UAAU,SAAS,WAAW,UAAU,EAAE,MAAM;AAAA,MAClD;AAAA,IACF;AAEA,UAAM,SAAS,MAAM,eAAe,wBAAwB;AAAA,MAC1D,SAAS;AAAA,MACT,YAAY;AAAA,IACd,CAAC;AAGD,WAAO,WAAW,IAAI,EAAE;AAAA,MACtB;AAAA,QACE,WAAW;AAAA,QACX,MAAM;AAAA,QACN,QAAQ;AAAA,UACN,iBAAiB;AAAA,YACf;AAAA,YACA;AAAA,UACF;AAAA,UACA,aAAa,CAAC,YAAY,UAAU;AAAA,UACpC,cAAc;AAAA,QAChB;AAAA,MACF;AAAA,MACA,CAAC;AAAA,IACH;AAGA,WAAO,MAAM,EAAE,aAAa,CAAC;AAC7B,WAAO,OAAO,CAAC,EAAE,aAAa,WAAW,CAAC,EAAE,KAAK,4CAA4C;AAC7F,WAAO,OAAO,CAAC,EAAE,SAAS,MAAM,CAAC,EAAE,KAAK,UAAU;AAClD,WAAO,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,MAAM;AAAA,EACtC,CAAC;AAED,OAAK,sDAAsD,YAAY;AACrE,UAAM,aAAa,iBAAiB,CAAC,CAAC;AACtC,UAAM,iBAAiB,IAAI,eAAe,YAAmB,UAAiB;AAE9E,UAAM,SAAS,MAAM,eAAe,wBAAwB;AAAA,MAC1D,SAAS,CAAC;AAAA,MACV,YAAY;AAAA,IACd,CAAC;AAGD,WAAO,WAAW,IAAI,EAAE,IAAI,iBAAiB;AAC7C,WAAO,MAAM,EAAE,QAAQ,CAAC,CAAC;AAAA,EAC3B,CAAC;AAED,OAAK,wDAAwD,YAAY;AACvE,UAAM,aAAa,iBAAiB,CAAC,CAAC;AACtC,UAAM,iBAAiB,IAAI,eAAe,YAAmB,UAAiB;AAE9E,UAAM,cAAc;AAAA,MAClB;AAAA,QACE,cAAc,gBAAgB,WAAW,4CAA4C,EAAE,MAAM;AAAA,QAC7F,UAAU,SAAS,WAAW,UAAU,EAAE,MAAM;AAAA,MAClD;AAAA,IACF;AAEA,UAAM,eAAe,wBAAwB;AAAA,MAC3C,SAAS;AAAA,MACT,YAAY;AAAA,IACd,CAAC;AAED,WAAO,WAAW,IAAI,EAAE;AAAA,MACtB;AAAA,QACE,WAAW;AAAA,QACX,MAAM;AAAA,QACN,QAAQ,OAAO,iBAAiB;AAAA,UAC9B,cAAc;AAAA,QAChB,CAAC;AAAA,MACH;AAAA,MACA,CAAC;AAAA,IACH;AAAA,EACF,CAAC;AAED,OAAK,gEAAgE,YAAY;AAC/E,UAAM,aAAa,iBAAiB,CAAC,CAAC;AACtC,UAAM,iBAAiB,IAAI,eAAe,YAAmB,UAAiB;AAE9E,UAAM,cAAc;AAAA,MAClB;AAAA,QACE,cAAc,gBAAgB,WAAW,4CAA4C,EAAE,MAAM;AAAA,QAC7F,UAAU,SAAS,WAAW,UAAU,EAAE,MAAM;AAAA,MAClD;AAAA,IACF;AAEA,UAAM,eAAe,wBAAwB;AAAA,MAC3C,SAAS;AAAA,IACX,CAAC;AAED,WAAO,WAAW,IAAI,EAAE;AAAA,MACtB;AAAA,QACE,WAAW;AAAA,QACX,MAAM;AAAA,QACN,QAAQ,OAAO,iBAAiB;AAAA,UAC9B,cAAc;AAAA,QAChB,CAAC;AAAA,MACH;AAAA,MACA,CAAC;AAAA,IACH;AAAA,EACF,CAAC;AAED,OAAK,gDAAgD,YAAY;AAC/D,UAAM,aAAa;AAAA,MACjB,MAAM,GAAG,GAAG,EAAE,kBAAkB;AAAA,QAC9B,QAAQ;AAAA,QACR,MAAM;AAAA,MACR,CAAC;AAAA,IACH;AAEA,UAAM,iBAAiB,IAAI,eAAe,YAAmB,UAAiB;AAE9E,UAAM;AAAA,MACJ,eAAe,uBAAuB;AAAA,QACpC,YAAY;AAAA,QACZ,UAAU;AAAA,MACZ,CAAC;AAAA,IACH,EAAE,QAAQ,QAAQ;AAAA,EACpB,CAAC;AAED,OAAK,iDAAiD,YAAY;AAChE,UAAM,aAAa;AAAA,MACjB,MAAM,GAAG,GAAG,EAAE,kBAAkB;AAAA,QAC9B,QAAQ;AAAA,QACR,MAAM;AAAA,MACR,CAAC;AAAA,IACH;AAEA,UAAM,iBAAiB,IAAI,eAAe,YAAmB,UAAiB;AAE9E,UAAM,cAAc;AAAA,MAClB;AAAA,QACE,cAAc,gBAAgB,WAAW,4CAA4C,EAAE,MAAM;AAAA,QAC7F,UAAU,SAAS,WAAW,UAAU,EAAE,MAAM;AAAA,MAClD;AAAA,IACF;AAEA,UAAM;AAAA,MACJ,eAAe,wBAAwB;AAAA,QACrC,SAAS;AAAA,MACX,CAAC;AAAA,IACH,EAAE,QAAQ,QAAQ;AAAA,EACpB,CAAC;AAED,OAAK,6CAA6C,YAAY;AAC5D,UAAM,eAAe;AAAA,MACnB;AAAA,QACE,eAAe;AAAA,QACf,WAAW;AAAA,QACX,qBAAqB;AAAA,QACrB,iBAAiB;AAAA,QACjB,QAAQ;AAAA,QACR,YAAY;AAAA,QACZ,gBAAgB;AAAA,QAChB,YAAY;AAAA,MACd;AAAA,MACA;AAAA,QACE,eAAe;AAAA,QACf,WAAW;AAAA,QACX,qBAAqB;AAAA,QACrB,iBAAiB;AAAA,QACjB,QAAQ;AAAA,QACR,YAAY;AAAA,QACZ,gBAAgB;AAAA,QAChB,YAAY;AAAA,MACd;AAAA,IACF;AAEA,UAAM,aAAa,iBAAiB,YAAY;AAChD,UAAM,iBAAiB,IAAI,eAAe,YAAmB,UAAiB;AAE9E,UAAM,SAAS,MAAM,eAAe,uBAAuB,EAAE,OAAO,GAAG,CAAC;AAExE,WAAO,MAAM,EAAE,aAAa,CAAC;AAC7B,WAAO,OAAO,CAAC,EAAE,cAAc,MAAM,CAAC,EAAE,KAAK,SAAS;AACtD,WAAO,OAAO,CAAC,EAAE,cAAc,MAAM,CAAC,EAAE,KAAK,SAAS;AACtD,WAAO,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,MAAM;AACpC,WAAO,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,MAAM;AAAA,EACtC,CAAC;AAED,OAAK,4CAA4C,YAAY;AAC3D,UAAM,eAAe;AAAA,MACnB;AAAA,QACE,eAAe;AAAA,QACf,WAAW;AAAA,QACX,qBAAqB;AAAA,QACrB,iBAAiB;AAAA,QACjB,QAAQ;AAAA,QACR,YAAY;AAAA,QACZ,gBAAgB;AAAA,QAChB,YAAY;AAAA,MACd;AAAA,IACF;AAEA,UAAM,aAAa,iBAAiB,YAAY;AAChD,UAAM,iBAAiB,IAAI,eAAe,YAAmB,UAAiB;AAE9E,UAAM,SAAS,MAAM,eAAe,uBAAuB;AAE3D,WAAO,OAAO,CAAC,EAAE,YAAY,EAAE,eAAe,eAAe;AAC7D,WAAO,OAAO,CAAC,EAAE,QAAQ,EAAE,eAAe,QAAQ;AAClD,WAAO,OAAO,CAAC,EAAE,iBAAiB,EAAE,eAAe,eAAe;AAClE,WAAO,OAAO,CAAC,EAAE,aAAa,EAAE,eAAe,QAAQ;AAEvD,WAAO,OAAO,CAAC,EAAE,aAAa,WAAW,CAAC,EAAE,KAAK,4CAA4C;AAC7F,WAAO,OAAO,CAAC,EAAE,SAAS,MAAM,CAAC,EAAE,KAAK,aAAa;AACrD,WAAO,OAAO,CAAC,EAAE,kBAAkB,WAAW,CAAC,EAAE,KAAK,4CAA4C;AAClG,WAAO,OAAO,CAAC,EAAE,cAAc,MAAM,CAAC,EAAE,KAAK,cAAc;AAAA,EAC7D,CAAC;AACH,CAAC;",
+  "names": []
+}

package/dist/esm/index.common.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/index.common.ts"],
-  "sourcesContent": ["// Core client types\nexport type { TNClientOptions } from \"./client/client\";\nexport type { SignerInfo as EthProvider } from \"./client/client\";\n\n// Stream types and interfaces\nexport type { StreamLocator } from \"./types/stream\";\nexport type { StreamRecord } from \"./contracts-api/action\";\nexport type { GetRecordInput, GetFirstRecordInput } from \"./contracts-api/action\";\nexport type { InsertRecordInput } from \"./contracts-api/primitiveAction\";\nexport type { TaxonomySet, TaxonomyItem } from \"./contracts-api/composedAction\";\n\n// Utility types and classes\nexport { StreamId } from \"./util/StreamId\";\nexport { EthereumAddress } from \"./util/EthereumAddress\";\nexport { visibility } from \"./util/visibility\";\nexport type { VisibilityEnum } from \"./util/visibility\";\n\n// Stream type constants\nexport { StreamType } from \"./contracts-api/contractValues\";\n\n// Base classes\nexport { Action } from \"./contracts-api/action\";\nexport { PrimitiveAction } from \"./contracts-api/primitiveAction\";\nexport { ComposedAction } from \"./contracts-api/composedAction\";\n\n// Role management exports\nexport { RoleManagement } from \"./contracts-api/roleManagement\";\nexport type { GrantRoleInput, RevokeRoleInput, AreMembersOfInput, WalletMembership } from \"./types/role\";\n\n"],
+  "sourcesContent": ["// Core client types\nexport type { TNClientOptions } from \"./client/client\";\nexport type { SignerInfo as EthProvider } from \"./client/client\";\n\n// Stream types and interfaces\nexport type { StreamLocator } from \"./types/stream\";\nexport type { StreamRecord } from \"./contracts-api/action\";\nexport type { GetRecordInput, GetFirstRecordInput } from \"./contracts-api/action\";\nexport type { InsertRecordInput } from \"./contracts-api/primitiveAction\";\nexport type { TaxonomySet, TaxonomyItem, ListTaxonomiesByHeightParams, GetTaxonomiesForStreamsParams, TaxonomyQueryResult } from \"./contracts-api/composedAction\";\n\n// Utility types and classes\nexport { StreamId } from \"./util/StreamId\";\nexport { EthereumAddress } from \"./util/EthereumAddress\";\nexport { visibility } from \"./util/visibility\";\nexport type { VisibilityEnum } from \"./util/visibility\";\n\n// Stream type constants\nexport { StreamType } from \"./contracts-api/contractValues\";\n\n// Base classes\nexport { Action } from \"./contracts-api/action\";\nexport { PrimitiveAction } from \"./contracts-api/primitiveAction\";\nexport { ComposedAction } from \"./contracts-api/composedAction\";\n\n// Role management exports\nexport { RoleManagement } from \"./contracts-api/roleManagement\";\nexport type { GrantRoleInput, RevokeRoleInput, AreMembersOfInput, WalletMembership } from \"./types/role\";\n\n"],
   "mappings": ";AAYA,SAAS,gBAAgB;AACzB,SAAS,uBAAuB;AAChC,SAAS,kBAAkB;AAI3B,SAAS,kBAAkB;AAG3B,SAAS,cAAc;AACvB,SAAS,uBAAuB;AAChC,SAAS,sBAAsB;AAG/B,SAAS,sBAAsB;",
   "names": []
 }

package/dist/esm/types/cache.mjs

@@ -0,0 +1,13 @@
+// src/types/cache.ts
+var CacheError = class _CacheError extends Error {
+  constructor(message, cause) {
+    super(message);
+    this.cause = cause;
+    this.name = "CacheError";
+    Object.setPrototypeOf(this, _CacheError.prototype);
+  }
+};
+export {
+  CacheError
+};
+//# sourceMappingURL=cache.mjs.map

package/dist/esm/types/cache.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/types/cache.ts"],
+  "sourcesContent": ["/**\n * Cache-related type definitions for the Truf Network SDK\n * These types enable cache-aware operations with proper TypeScript support\n */\n\n/**\n * Metadata about cache operations\n * Matches the Go SDK implementation structure\n */\nexport interface CacheMetadata {\n  /** Whether the data came from cache */\n  hit: boolean;\n  /** Whether cache was disabled for this query */\n  cacheDisabled?: boolean;\n  /** Block height when data was cached (optional) */\n  height?: number;\n  \n  // SDK-provided context (optional)\n  /** Stream ID used in the query */\n  streamId?: string;\n  /** Data provider address */\n  dataProvider?: string;\n  /** Start time of the query range */\n  from?: number;\n  /** End time of the query range */\n  to?: number;\n  /** Frozen time for historical queries */\n  frozenAt?: number;\n  /** Number of rows returned */\n  rowsServed?: number;\n}\n\n/**\n * Enhanced options for getRecord method with cache support\n */\nexport interface GetRecordOptions {\n  /** Start time for the query range */\n  from?: number;\n  /** End time for the query range */\n  to?: number;\n  /** Frozen time for historical queries */\n  frozenAt?: number;\n  /** Base time for index calculations */\n  baseTime?: string | number;\n  /** Procedure name prefix */\n  prefix?: string;\n  /** Enable cache usage for this query */\n  useCache?: boolean;\n}\n\n/**\n * Enhanced options for getIndex method with cache support\n */\nexport interface GetIndexOptions {\n  /** Start time for the query range */\n  from?: number;\n  /** End time for the query range */\n  to?: number;\n  /** Frozen time for historical queries */\n  frozenAt?: number;\n  /** Base time for index calculations */\n  baseTime?: string | number;\n  /** Procedure name prefix */\n  prefix?: string;\n  /** Enable cache usage for this query */\n  useCache?: boolean;\n}\n\n/**\n * Enhanced options for getIndexChange method with cache support\n */\nexport interface GetIndexChangeOptions {\n  /** Start time for the query range */\n  from?: number;\n  /** End time for the query range */\n  to?: number;\n  /** Frozen time for historical queries */\n  frozenAt?: number;\n  /** Base time for index calculations */\n  baseTime?: string | number;\n  /** Time interval for change calculations */\n  timeInterval: number;\n  /** Procedure name prefix */\n  prefix?: string;\n  /** Enable cache usage for this query */\n  useCache?: boolean;\n}\n\n/**\n * Enhanced options for getFirstRecord method with cache support\n */\nexport interface GetFirstRecordOptions {\n  /** Return records after this time */\n  after?: number;\n  /** Frozen time for historical queries */\n  frozenAt?: number;\n  /** Enable cache usage for this query */\n  useCache?: boolean;\n}\n\n/**\n * Response wrapper that includes cache metadata\n * Provides structured access to both data and cache information\n */\nexport interface CacheAwareResponse<T> {\n  /** The actual response data */\n  data: T;\n  /** Cache metadata (if available) */\n  cache?: CacheMetadata;\n  /** Action logs for debugging (optional) */\n  logs?: string[];\n}\n\n/**\n * Aggregated cache metadata from multiple operations\n */\nexport interface CacheMetadataCollection {\n  /** Total number of queries performed */\n  totalQueries: number;\n  /** Number of cache hits */\n  cacheHits: number;\n  /** Number of cache misses */\n  cacheMisses: number;\n  /** Cache hit rate (0-1) */\n  cacheHitRate: number;\n  /** Total rows served across all queries */\n  totalRowsServed: number;\n  /** Individual metadata entries */\n  entries: CacheMetadata[];\n}\n\n/**\n * Error class for cache-related operations\n */\nexport class CacheError extends Error {\n  constructor(message: string, public cause?: Error) {\n    super(message);\n    this.name = 'CacheError';\n\n    // Fix prototype chain\n    Object.setPrototypeOf(this, CacheError.prototype);\n  }\n}"],
+  "mappings": ";AAsIO,IAAM,aAAN,MAAM,oBAAmB,MAAM;AAAA,EACpC,YAAY,SAAwB,OAAe;AACjD,UAAM,OAAO;AADqB;AAElC,SAAK,OAAO;AAGZ,WAAO,eAAe,MAAM,YAAW,SAAS;AAAA,EAClD;AACF;",
+  "names": []
+}

package/dist/esm/types/cache.test.mjs

@@ -0,0 +1,203 @@
+// src/types/cache.test.ts
+import { describe, it, expect } from "vitest";
+import { CacheError } from "./cache.mjs";
+describe("Cache Types", () => {
+  describe("CacheMetadata", () => {
+    it("should allow valid cache metadata", () => {
+      const metadata = { hit: true, height: 123456 };
+      expect(metadata.hit).toBe(true);
+      expect(metadata.height).toBe(123456);
+    });
+    it("should create cache metadata with all fields", () => {
+      const metadata = { hit: true, height: 123456 };
+      expect(metadata.hit).toBe(true);
+      expect(metadata.height).toBe(123456);
+    });
+    it("should allow cache metadata without optional fields", () => {
+      const metadata = { hit: false };
+      expect(metadata.hit).toBe(false);
+      expect(metadata.height).toBeUndefined();
+    });
+    it("should allow enhanced cache metadata with all fields", () => {
+      const metadata = {
+        hit: true,
+        cacheDisabled: false,
+        height: 123456,
+        streamId: "test-stream",
+        dataProvider: "0x123456789abcdef",
+        from: 1609459100,
+        to: 1609459300,
+        frozenAt: 1609459250,
+        rowsServed: 10
+      };
+      expect(metadata.hit).toBe(true);
+      expect(metadata.cacheDisabled).toBe(false);
+      expect(metadata.height).toBe(123456);
+      expect(metadata.streamId).toBe("test-stream");
+      expect(metadata.dataProvider).toBe("0x123456789abcdef");
+      expect(metadata.from).toBe(1609459100);
+      expect(metadata.to).toBe(1609459300);
+      expect(metadata.frozenAt).toBe(1609459250);
+      expect(metadata.rowsServed).toBe(10);
+    });
+    it("should allow partial enhanced metadata", () => {
+      const metadata = {
+        hit: true,
+        cacheDisabled: true,
+        streamId: "partial-stream"
+      };
+      expect(metadata.hit).toBe(true);
+      expect(metadata.cacheDisabled).toBe(true);
+      expect(metadata.streamId).toBe("partial-stream");
+      expect(metadata.height).toBeUndefined();
+    });
+  });
+  describe("CacheMetadataCollection", () => {
+    it("should allow valid cache metadata collection", () => {
+      const collection = {
+        totalQueries: 5,
+        cacheHits: 3,
+        cacheMisses: 2,
+        cacheHitRate: 0.6,
+        totalRowsServed: 100,
+        entries: [
+          { hit: true, rowsServed: 30 },
+          { hit: false, rowsServed: 25 },
+          { hit: true, rowsServed: 45 }
+        ]
+      };
+      expect(collection.totalQueries).toBe(5);
+      expect(collection.cacheHits).toBe(3);
+      expect(collection.cacheMisses).toBe(2);
+      expect(collection.cacheHitRate).toBe(0.6);
+      expect(collection.totalRowsServed).toBe(100);
+      expect(collection.entries).toHaveLength(3);
+    });
+  });
+  describe("CacheAwareResponse", () => {
+    it("should allow response with cache metadata", () => {
+      const response = {
+        data: ["test1", "test2"],
+        cache: { hit: true, height: 123456 },
+        logs: ["log1", "log2"]
+      };
+      expect(response.data).toEqual(["test1", "test2"]);
+      expect(response.cache?.hit).toBe(true);
+      expect(response.logs).toEqual(["log1", "log2"]);
+    });
+    it("should create cache aware response with all fields", () => {
+      const response = {
+        data: "test",
+        cache: { hit: true, height: 123456 },
+        logs: ["log1"]
+      };
+      expect(response.data).toBe("test");
+      expect(response.cache?.hit).toBe(true);
+      expect(response.cache?.height).toBe(123456);
+      expect(response.logs).toEqual(["log1"]);
+    });
+    it("should allow response without cache metadata", () => {
+      const response = {
+        data: ["test1", "test2"]
+      };
+      expect(response.data).toEqual(["test1", "test2"]);
+      expect(response.cache).toBeUndefined();
+      expect(response.logs).toBeUndefined();
+    });
+  });
+  describe("GetRecordOptions", () => {
+    it("should allow all valid options", () => {
+      const options = {
+        from: 1609459200,
+        to: 1609545600,
+        frozenAt: 1609459200,
+        baseTime: 1609459200,
+        prefix: "test_",
+        useCache: true
+      };
+      expect(options.from).toBe(1609459200);
+      expect(options.useCache).toBe(true);
+    });
+    it("should allow string baseTime", () => {
+      const options = {
+        baseTime: "2021-01-01",
+        useCache: false
+      };
+      expect(options.baseTime).toBe("2021-01-01");
+    });
+    it("should allow empty options", () => {
+      const options = {};
+      expect(options.useCache).toBeUndefined();
+    });
+  });
+  describe("GetIndexOptions", () => {
+    it("should allow all valid options", () => {
+      const options = {
+        from: 1609459200,
+        to: 1609545600,
+        frozenAt: 1609459200,
+        baseTime: 1609459200,
+        prefix: "test_",
+        useCache: true
+      };
+      expect(options.useCache).toBe(true);
+    });
+  });
+  describe("GetIndexChangeOptions", () => {
+    it("should allow all valid options including timeInterval", () => {
+      const options = {
+        from: 1609459200,
+        to: 1609545600,
+        frozenAt: 1609459200,
+        baseTime: 1609459200,
+        timeInterval: 3600,
+        prefix: "test_",
+        useCache: true
+      };
+      expect(options.timeInterval).toBe(3600);
+      expect(options.useCache).toBe(true);
+    });
+    it("should require timeInterval", () => {
+      const options = {
+        timeInterval: 3600
+      };
+      expect(options.timeInterval).toBe(3600);
+    });
+  });
+  describe("GetFirstRecordOptions", () => {
+    it("should allow all valid options", () => {
+      const options = {
+        after: 1609459200,
+        frozenAt: 1609459200,
+        useCache: true
+      };
+      expect(options.after).toBe(1609459200);
+      expect(options.useCache).toBe(true);
+    });
+    it("should allow empty options", () => {
+      const options = {};
+      expect(options.useCache).toBeUndefined();
+    });
+  });
+  describe("CacheError", () => {
+    it("should create error with message", () => {
+      const error = new CacheError("Test error");
+      expect(error.message).toBe("Test error");
+      expect(error.name).toBe("CacheError");
+      expect(error.cause).toBeUndefined();
+    });
+    it("should create error with cause", () => {
+      const cause = new Error("Original error");
+      const error = new CacheError("Test error", cause);
+      expect(error.message).toBe("Test error");
+      expect(error.name).toBe("CacheError");
+      expect(error.cause).toBe(cause);
+    });
+    it("should be instanceof Error", () => {
+      const error = new CacheError("Test error");
+      expect(error instanceof Error).toBe(true);
+      expect(error instanceof CacheError).toBe(true);
+    });
+  });
+});
+//# sourceMappingURL=cache.test.mjs.map

package/dist/esm/types/cache.test.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/types/cache.test.ts"],
+  "sourcesContent": ["import { describe, it, expect } from 'vitest';\nimport { CacheError } from './cache';\nimport type { \n  CacheMetadata, \n  CacheAwareResponse, \n  CacheMetadataCollection,\n  GetRecordOptions, \n  GetIndexOptions, \n  GetIndexChangeOptions, \n  GetFirstRecordOptions \n} from './cache';\n\ndescribe('Cache Types', () => {\n  describe('CacheMetadata', () => {\n    it('should allow valid cache metadata', () => {\n      const metadata: CacheMetadata = { hit: true, height: 123456 };\n      expect(metadata.hit).toBe(true);\n      expect(metadata.height).toBe(123456);\n    });\n\n    it('should create cache metadata with all fields', () => {\n      const metadata: CacheMetadata = { hit: true, height: 123456 };\n      expect(metadata.hit).toBe(true);\n      expect(metadata.height).toBe(123456);\n    });\n\n    it('should allow cache metadata without optional fields', () => {\n      const metadata: CacheMetadata = { hit: false };\n      expect(metadata.hit).toBe(false);\n      expect(metadata.height).toBeUndefined();\n    });\n\n    it('should allow enhanced cache metadata with all fields', () => {\n      const metadata: CacheMetadata = {\n        hit: true,\n        cacheDisabled: false,\n        height: 123456,\n        streamId: 'test-stream',\n        dataProvider: '0x123456789abcdef',\n        from: 1609459100,\n        to: 1609459300,\n        frozenAt: 1609459250,\n        rowsServed: 10\n      };\n      \n      expect(metadata.hit).toBe(true);\n      expect(metadata.cacheDisabled).toBe(false);\n      expect(metadata.height).toBe(123456);\n      expect(metadata.streamId).toBe('test-stream');\n      expect(metadata.dataProvider).toBe('0x123456789abcdef');\n      expect(metadata.from).toBe(1609459100);\n      expect(metadata.to).toBe(1609459300);\n      expect(metadata.frozenAt).toBe(1609459250);\n      expect(metadata.rowsServed).toBe(10);\n    });\n\n    it('should allow partial enhanced metadata', () => {\n      const metadata: CacheMetadata = {\n        hit: true,\n        cacheDisabled: true,\n        streamId: 'partial-stream'\n      };\n      \n      expect(metadata.hit).toBe(true);\n      expect(metadata.cacheDisabled).toBe(true);\n      expect(metadata.streamId).toBe('partial-stream');\n      expect(metadata.height).toBeUndefined();\n    });\n  });\n\n  describe('CacheMetadataCollection', () => {\n    it('should allow valid cache metadata collection', () => {\n      const collection: CacheMetadataCollection = {\n        totalQueries: 5,\n        cacheHits: 3,\n        cacheMisses: 2,\n        cacheHitRate: 0.6,\n        totalRowsServed: 100,\n        entries: [\n          { hit: true, rowsServed: 30 },\n          { hit: false, rowsServed: 25 },\n          { hit: true, rowsServed: 45 }\n        ]\n      };\n      \n      expect(collection.totalQueries).toBe(5);\n      expect(collection.cacheHits).toBe(3);\n      expect(collection.cacheMisses).toBe(2);\n      expect(collection.cacheHitRate).toBe(0.6);\n      expect(collection.totalRowsServed).toBe(100);\n      expect(collection.entries).toHaveLength(3);\n    });\n  });\n\n  describe('CacheAwareResponse', () => {\n    it('should allow response with cache metadata', () => {\n      const response: CacheAwareResponse<string[]> = {\n        data: ['test1', 'test2'],\n        cache: { hit: true, height: 123456 },\n        logs: ['log1', 'log2']\n      };\n      \n      expect(response.data).toEqual(['test1', 'test2']);\n      expect(response.cache?.hit).toBe(true);\n      expect(response.logs).toEqual(['log1', 'log2']);\n    });\n\n    it('should create cache aware response with all fields', () => {\n      const response: CacheAwareResponse<string> = {\n        data: 'test',\n        cache: { hit: true, height: 123456 },\n        logs: ['log1']\n      };\n      expect(response.data).toBe('test');\n      expect(response.cache?.hit).toBe(true);\n      expect(response.cache?.height).toBe(123456);\n      expect(response.logs).toEqual(['log1']);\n    });\n\n    it('should allow response without cache metadata', () => {\n      const response: CacheAwareResponse<string[]> = {\n        data: ['test1', 'test2']\n      };\n      \n      expect(response.data).toEqual(['test1', 'test2']);\n      expect(response.cache).toBeUndefined();\n      expect(response.logs).toBeUndefined();\n    });\n  });\n\n  describe('GetRecordOptions', () => {\n    it('should allow all valid options', () => {\n      const options: GetRecordOptions = {\n        from: 1609459200,\n        to: 1609545600,\n        frozenAt: 1609459200,\n        baseTime: 1609459200,\n        prefix: 'test_',\n        useCache: true\n      };\n      \n      expect(options.from).toBe(1609459200);\n      expect(options.useCache).toBe(true);\n    });\n\n    it('should allow string baseTime', () => {\n      const options: GetRecordOptions = {\n        baseTime: '2021-01-01',\n        useCache: false\n      };\n      \n      expect(options.baseTime).toBe('2021-01-01');\n    });\n\n    it('should allow empty options', () => {\n      const options: GetRecordOptions = {};\n      expect(options.useCache).toBeUndefined();\n    });\n  });\n\n  describe('GetIndexOptions', () => {\n    it('should allow all valid options', () => {\n      const options: GetIndexOptions = {\n        from: 1609459200,\n        to: 1609545600,\n        frozenAt: 1609459200,\n        baseTime: 1609459200,\n        prefix: 'test_',\n        useCache: true\n      };\n      \n      expect(options.useCache).toBe(true);\n    });\n  });\n\n  describe('GetIndexChangeOptions', () => {\n    it('should allow all valid options including timeInterval', () => {\n      const options: GetIndexChangeOptions = {\n        from: 1609459200,\n        to: 1609545600,\n        frozenAt: 1609459200,\n        baseTime: 1609459200,\n        timeInterval: 3600,\n        prefix: 'test_',\n        useCache: true\n      };\n      \n      expect(options.timeInterval).toBe(3600);\n      expect(options.useCache).toBe(true);\n    });\n\n    it('should require timeInterval', () => {\n      // This should compile - timeInterval is required\n      const options: GetIndexChangeOptions = {\n        timeInterval: 3600\n      };\n      \n      expect(options.timeInterval).toBe(3600);\n    });\n  });\n\n  describe('GetFirstRecordOptions', () => {\n    it('should allow all valid options', () => {\n      const options: GetFirstRecordOptions = {\n        after: 1609459200,\n        frozenAt: 1609459200,\n        useCache: true\n      };\n      \n      expect(options.after).toBe(1609459200);\n      expect(options.useCache).toBe(true);\n    });\n\n    it('should allow empty options', () => {\n      const options: GetFirstRecordOptions = {};\n      expect(options.useCache).toBeUndefined();\n    });\n  });\n\n  describe('CacheError', () => {\n    it('should create error with message', () => {\n      const error = new CacheError('Test error');\n      expect(error.message).toBe('Test error');\n      expect(error.name).toBe('CacheError');\n      expect(error.cause).toBeUndefined();\n    });\n\n    it('should create error with cause', () => {\n      const cause = new Error('Original error');\n      const error = new CacheError('Test error', cause);\n      expect(error.message).toBe('Test error');\n      expect(error.name).toBe('CacheError');\n      expect(error.cause).toBe(cause);\n    });\n\n    it('should be instanceof Error', () => {\n      const error = new CacheError('Test error');\n      expect(error instanceof Error).toBe(true);\n      expect(error instanceof CacheError).toBe(true);\n    });\n  });\n});"],
+  "mappings": "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",
+  "names": []
+}