@trufnetwork/sdk-js 0.3.7 → 0.4.1

package/dist/cjs/util/cacheMetadataParser.test.cjs

@@ -0,0 +1,329 @@
+"use strict";
+
+// src/util/cacheMetadataParser.test.ts
+var import_vitest = require("vitest");
+var import_cacheMetadataParser = require("./cacheMetadataParser.cjs");
+(0, import_vitest.describe)("CacheMetadataParser", () => {
+  (0, import_vitest.describe)("extractFromLogs", () => {
+    (0, import_vitest.it)("should extract cache hit metadata from valid log", () => {
+      const logs = ['{"cache_hit": true, "cache_height": 123456}'];
+      const result = import_cacheMetadataParser.CacheMetadataParser.extractFromLogs(logs);
+      (0, import_vitest.expect)(result).toEqual({
+        hit: true,
+        cacheDisabled: void 0,
+        height: 123456
+      });
+    });
+    (0, import_vitest.it)("should extract enhanced cache metadata with cacheDisabled field", () => {
+      const logs = ['{"cache_hit": false, "cache_disabled": true}'];
+      const result = import_cacheMetadataParser.CacheMetadataParser.extractFromLogs(logs);
+      (0, import_vitest.expect)(result).toEqual({
+        hit: false,
+        cacheDisabled: true,
+        height: void 0
+      });
+    });
+    (0, import_vitest.it)("should extract cache miss metadata from valid log", () => {
+      const logs = ['{"cache_hit": false}'];
+      const result = import_cacheMetadataParser.CacheMetadataParser.extractFromLogs(logs);
+      (0, import_vitest.expect)(result).toEqual({
+        hit: false,
+        cacheDisabled: void 0,
+        height: void 0
+      });
+    });
+    (0, import_vitest.it)("should handle cache hit without height field", () => {
+      const logs = ['{"cache_hit": true}'];
+      const result = import_cacheMetadataParser.CacheMetadataParser.extractFromLogs(logs);
+      (0, import_vitest.expect)(result).toEqual({
+        hit: true,
+        cacheDisabled: void 0,
+        height: void 0
+      });
+    });
+    (0, import_vitest.it)("should handle single string log with newlines", () => {
+      const log = 'other log entry\n{"cache_hit": true, "cache_height": 123456}\nmore logs';
+      const result = import_cacheMetadataParser.CacheMetadataParser.extractFromLogs(log);
+      (0, import_vitest.expect)(result).toEqual({
+        hit: true,
+        cacheDisabled: void 0,
+        height: 123456
+      });
+    });
+    (0, import_vitest.it)("should handle array of logs", () => {
+      const logs = [
+        "normal log entry",
+        '{"cache_hit": true, "cache_height": 123456}',
+        "another log"
+      ];
+      const result = import_cacheMetadataParser.CacheMetadataParser.extractFromLogs(logs);
+      (0, import_vitest.expect)(result).toEqual({
+        hit: true,
+        cacheDisabled: void 0,
+        height: 123456
+      });
+    });
+    (0, import_vitest.it)("should return null for logs without cache metadata", () => {
+      const logs = ["normal log entry", "another log"];
+      const result = import_cacheMetadataParser.CacheMetadataParser.extractFromLogs(logs);
+      (0, import_vitest.expect)(result).toBeNull();
+    });
+    (0, import_vitest.it)("should return null for malformed JSON", () => {
+      const logs = ['{"cache_hit": true invalid json}'];
+      const result = import_cacheMetadataParser.CacheMetadataParser.extractFromLogs(logs);
+      (0, import_vitest.expect)(result).toBeNull();
+    });
+    (0, import_vitest.it)("should return null for empty logs", () => {
+      const result = import_cacheMetadataParser.CacheMetadataParser.extractFromLogs([]);
+      (0, import_vitest.expect)(result).toBeNull();
+    });
+    (0, import_vitest.it)("should handle empty string logs", () => {
+      const result = import_cacheMetadataParser.CacheMetadataParser.extractFromLogs(["", "   ", "\n"]);
+      (0, import_vitest.expect)(result).toBeNull();
+    });
+    (0, import_vitest.it)("should extract cache hit metadata with all fields", () => {
+      const logs = ['{"cache_hit": true, "cache_height": 123456}'];
+      const metadata = import_cacheMetadataParser.CacheMetadataParser.extractFromLogs(logs);
+      (0, import_vitest.expect)(metadata).toEqual({
+        hit: true,
+        cacheDisabled: void 0,
+        height: 123456
+      });
+    });
+    (0, import_vitest.it)("should extract cache hit without optional fields", () => {
+      const logs = ['{"cache_hit": true}'];
+      const metadata = import_cacheMetadataParser.CacheMetadataParser.extractFromLogs(logs);
+      (0, import_vitest.expect)(metadata).toEqual({
+        hit: true,
+        cacheDisabled: void 0,
+        height: void 0
+      });
+    });
+    (0, import_vitest.it)("should extract cache miss", () => {
+      const logs = ['{"cache_hit": false}'];
+      const metadata = import_cacheMetadataParser.CacheMetadataParser.extractFromLogs(logs);
+      (0, import_vitest.expect)(metadata).toEqual({
+        hit: false,
+        cacheDisabled: void 0,
+        height: void 0
+      });
+    });
+    (0, import_vitest.it)("should handle logs with prepended numeric prefixes", () => {
+      const logs = ['1. {"cache_hit": true, "cache_height": 123456}\n2. some other log\n3. {"cache_hit": false}'];
+      const metadata = import_cacheMetadataParser.CacheMetadataParser.extractFromLogs(logs);
+      (0, import_vitest.expect)(metadata).toEqual({
+        hit: true,
+        cacheDisabled: void 0,
+        height: 123456
+      });
+    });
+    (0, import_vitest.it)("should handle array of logs with prepended numeric prefixes", () => {
+      const logs = [
+        "1. normal log line",
+        '2. {"cache_hit": false, "cache_disabled": true}',
+        "3. another log line"
+      ];
+      const metadata = import_cacheMetadataParser.CacheMetadataParser.extractFromLogs(logs);
+      (0, import_vitest.expect)(metadata).toEqual({
+        hit: false,
+        cacheDisabled: true,
+        height: void 0
+      });
+    });
+    (0, import_vitest.it)("should handle mixed format logs (some with prefixes, some without)", () => {
+      const logs = [
+        "normal log without prefix",
+        '1. {"cache_hit": true}',
+        "another log without prefix"
+      ];
+      const metadata = import_cacheMetadataParser.CacheMetadataParser.extractFromLogs(logs);
+      (0, import_vitest.expect)(metadata).toEqual({
+        hit: true,
+        cacheDisabled: void 0,
+        height: void 0
+      });
+    });
+  });
+  (0, import_vitest.describe)("isValidCacheMetadata", () => {
+    (0, import_vitest.it)("should validate correct cache metadata", () => {
+      const metadata = { hit: true, height: 123456 };
+      (0, import_vitest.expect)(import_cacheMetadataParser.CacheMetadataParser.isValidCacheMetadata(metadata)).toBe(true);
+    });
+    (0, import_vitest.it)("should validate metadata without height", () => {
+      const metadata = { hit: false };
+      (0, import_vitest.expect)(import_cacheMetadataParser.CacheMetadataParser.isValidCacheMetadata(metadata)).toBe(true);
+    });
+    (0, import_vitest.it)("should validate 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
+      };
+      (0, import_vitest.expect)(import_cacheMetadataParser.CacheMetadataParser.isValidCacheMetadata(metadata)).toBe(true);
+    });
+    (0, import_vitest.it)("should validate metadata with optional fields", () => {
+      const metadata = { hit: true, cacheDisabled: true };
+      (0, import_vitest.expect)(import_cacheMetadataParser.CacheMetadataParser.isValidCacheMetadata(metadata)).toBe(true);
+    });
+    (0, import_vitest.it)("should reject metadata without hit field", () => {
+      const metadata = { height: 123456 };
+      (0, import_vitest.expect)(import_cacheMetadataParser.CacheMetadataParser.isValidCacheMetadata(metadata)).toBe(false);
+    });
+    (0, import_vitest.it)("should reject metadata with invalid hit type", () => {
+      const metadata = { hit: "true", height: 123456 };
+      (0, import_vitest.expect)(import_cacheMetadataParser.CacheMetadataParser.isValidCacheMetadata(metadata)).toBe(false);
+    });
+    (0, import_vitest.it)("should reject metadata with invalid cacheDisabled type", () => {
+      const metadata = { hit: true, cacheDisabled: "false" };
+      (0, import_vitest.expect)(import_cacheMetadataParser.CacheMetadataParser.isValidCacheMetadata(metadata)).toBe(false);
+    });
+    (0, import_vitest.it)("should reject metadata with invalid streamId type", () => {
+      const metadata = { hit: true, streamId: 123 };
+      (0, import_vitest.expect)(import_cacheMetadataParser.CacheMetadataParser.isValidCacheMetadata(metadata)).toBe(false);
+    });
+    (0, import_vitest.it)("should reject metadata with invalid dataProvider type", () => {
+      const metadata = { hit: true, dataProvider: 456 };
+      (0, import_vitest.expect)(import_cacheMetadataParser.CacheMetadataParser.isValidCacheMetadata(metadata)).toBe(false);
+    });
+    (0, import_vitest.it)("should reject metadata with invalid numeric fields", () => {
+      const invalidFromMetadata = { hit: true, from: "123" };
+      const invalidToMetadata = { hit: true, to: "456" };
+      const invalidFrozenAtMetadata = { hit: true, frozenAt: "789" };
+      const invalidRowsServedMetadata = { hit: true, rowsServed: "10" };
+      (0, import_vitest.expect)(import_cacheMetadataParser.CacheMetadataParser.isValidCacheMetadata(invalidFromMetadata)).toBe(false);
+      (0, import_vitest.expect)(import_cacheMetadataParser.CacheMetadataParser.isValidCacheMetadata(invalidToMetadata)).toBe(false);
+      (0, import_vitest.expect)(import_cacheMetadataParser.CacheMetadataParser.isValidCacheMetadata(invalidFrozenAtMetadata)).toBe(false);
+      (0, import_vitest.expect)(import_cacheMetadataParser.CacheMetadataParser.isValidCacheMetadata(invalidRowsServedMetadata)).toBe(false);
+    });
+    (0, import_vitest.it)("should validate complete metadata", () => {
+      const metadata = { hit: true, height: 123456 };
+      (0, import_vitest.expect)(import_cacheMetadataParser.CacheMetadataParser.isValidCacheMetadata(metadata)).toBe(true);
+    });
+    (0, import_vitest.it)("should reject metadata with invalid height type", () => {
+      const metadata = { hit: true, height: "123456" };
+      (0, import_vitest.expect)(import_cacheMetadataParser.CacheMetadataParser.isValidCacheMetadata(metadata)).toBe(false);
+    });
+    (0, import_vitest.it)("should reject null or undefined", () => {
+      (0, import_vitest.expect)(import_cacheMetadataParser.CacheMetadataParser.isValidCacheMetadata(null)).toBe(false);
+      (0, import_vitest.expect)(import_cacheMetadataParser.CacheMetadataParser.isValidCacheMetadata(void 0)).toBe(false);
+    });
+  });
+  (0, import_vitest.describe)("extractFromResponse", () => {
+    (0, import_vitest.it)("should extract from response with logs", () => {
+      const response = {
+        data: { result: [] },
+        logs: ['{"cache_hit": true, "cache_height": 123456}']
+      };
+      const result = import_cacheMetadataParser.CacheMetadataParser.extractFromResponse(response);
+      (0, import_vitest.expect)(result).toEqual({
+        hit: true,
+        cacheDisabled: void 0,
+        height: 123456
+      });
+    });
+    (0, import_vitest.it)("should return null for response without logs", () => {
+      const response = { data: { result: [] } };
+      const result = import_cacheMetadataParser.CacheMetadataParser.extractFromResponse(response);
+      (0, import_vitest.expect)(result).toBeNull();
+    });
+    (0, import_vitest.it)("should return null for null response", () => {
+      const result = import_cacheMetadataParser.CacheMetadataParser.extractFromResponse(null);
+      (0, import_vitest.expect)(result).toBeNull();
+    });
+  });
+  (0, import_vitest.describe)("aggregate", () => {
+    (0, import_vitest.it)("should aggregate empty metadata list", () => {
+      const result = import_cacheMetadataParser.CacheMetadataParser.aggregate([]);
+      (0, import_vitest.expect)(result).toEqual({
+        totalQueries: 0,
+        cacheHits: 0,
+        cacheMisses: 0,
+        cacheHitRate: 0,
+        totalRowsServed: 0,
+        entries: []
+      });
+    });
+    (0, import_vitest.it)("should aggregate single metadata entry", () => {
+      const metadata = {
+        hit: true,
+        height: 123456,
+        streamId: "test-stream",
+        rowsServed: 5
+      };
+      const result = import_cacheMetadataParser.CacheMetadataParser.aggregate([metadata]);
+      (0, import_vitest.expect)(result).toEqual({
+        totalQueries: 1,
+        cacheHits: 1,
+        cacheMisses: 0,
+        cacheHitRate: 1,
+        totalRowsServed: 5,
+        entries: [metadata]
+      });
+    });
+    (0, import_vitest.it)("should aggregate multiple metadata entries", () => {
+      const metadata1 = {
+        hit: true,
+        height: 123456,
+        streamId: "stream-1",
+        rowsServed: 10
+      };
+      const metadata2 = {
+        hit: false,
+        streamId: "stream-2",
+        rowsServed: 5
+      };
+      const metadata3 = {
+        hit: true,
+        height: 123457,
+        streamId: "stream-3",
+        rowsServed: 15
+      };
+      const result = import_cacheMetadataParser.CacheMetadataParser.aggregate([metadata1, metadata2, metadata3]);
+      (0, import_vitest.expect)(result).toEqual({
+        totalQueries: 3,
+        cacheHits: 2,
+        cacheMisses: 1,
+        cacheHitRate: 2 / 3,
+        totalRowsServed: 30,
+        entries: [metadata1, metadata2, metadata3]
+      });
+    });
+    (0, import_vitest.it)("should handle metadata without rowsServed", () => {
+      const metadata1 = { hit: true, height: 123456 };
+      const metadata2 = { hit: false };
+      const metadata3 = { hit: true, rowsServed: 8 };
+      const result = import_cacheMetadataParser.CacheMetadataParser.aggregate([metadata1, metadata2, metadata3]);
+      (0, import_vitest.expect)(result).toEqual({
+        totalQueries: 3,
+        cacheHits: 2,
+        cacheMisses: 1,
+        cacheHitRate: 2 / 3,
+        totalRowsServed: 8,
+        // Only metadata3 has rowsServed
+        entries: [metadata1, metadata2, metadata3]
+      });
+    });
+    (0, import_vitest.it)("should calculate correct cache hit rate for mixed results", () => {
+      const metadataList = [
+        { hit: true, rowsServed: 1 },
+        { hit: false, rowsServed: 2 },
+        { hit: false, rowsServed: 3 },
+        { hit: true, rowsServed: 4 },
+        { hit: true, rowsServed: 5 }
+      ];
+      const result = import_cacheMetadataParser.CacheMetadataParser.aggregate(metadataList);
+      (0, import_vitest.expect)(result.totalQueries).toBe(5);
+      (0, import_vitest.expect)(result.cacheHits).toBe(3);
+      (0, import_vitest.expect)(result.cacheMisses).toBe(2);
+      (0, import_vitest.expect)(result.cacheHitRate).toBe(0.6);
+      (0, import_vitest.expect)(result.totalRowsServed).toBe(15);
+    });
+  });
+});
+//# sourceMappingURL=cacheMetadataParser.test.cjs.map

package/dist/cjs/util/cacheMetadataParser.test.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/util/cacheMetadataParser.test.ts"],
+  "sourcesContent": ["import { describe, it, expect } from 'vitest';\nimport { CacheMetadataParser } from './cacheMetadataParser';\nimport type { CacheMetadata } from '../types/cache';\n\ndescribe('CacheMetadataParser', () => {\n  describe('extractFromLogs', () => {\n    it('should extract cache hit metadata from valid log', () => {\n      const logs = ['{\"cache_hit\": true, \"cache_height\": 123456}'];\n      const result = CacheMetadataParser.extractFromLogs(logs);\n      \n      expect(result).toEqual({\n        hit: true,\n        cacheDisabled: undefined,\n        height: 123456\n      });\n    });\n\n    it('should extract enhanced cache metadata with cacheDisabled field', () => {\n      const logs = ['{\"cache_hit\": false, \"cache_disabled\": true}'];\n      const result = CacheMetadataParser.extractFromLogs(logs);\n      \n      expect(result).toEqual({\n        hit: false,\n        cacheDisabled: true,\n        height: undefined\n      });\n    });\n\n    it('should extract cache miss metadata from valid log', () => {\n      const logs = ['{\"cache_hit\": false}'];\n      const result = CacheMetadataParser.extractFromLogs(logs);\n      \n      expect(result).toEqual({\n        hit: false,\n        cacheDisabled: undefined,\n        height: undefined\n      });\n    });\n\n    it('should handle cache hit without height field', () => {\n      const logs = ['{\"cache_hit\": true}'];\n      const result = CacheMetadataParser.extractFromLogs(logs);\n      \n      expect(result).toEqual({\n        hit: true,\n        cacheDisabled: undefined,\n        height: undefined\n      });\n    });\n\n    it('should handle single string log with newlines', () => {\n      const log = 'other log entry\\n{\"cache_hit\": true, \"cache_height\": 123456}\\nmore logs';\n      const result = CacheMetadataParser.extractFromLogs(log);\n      \n      expect(result).toEqual({\n        hit: true,\n        cacheDisabled: undefined,\n        height: 123456\n      });\n    });\n\n    it('should handle array of logs', () => {\n      const logs = [\n        'normal log entry',\n        '{\"cache_hit\": true, \"cache_height\": 123456}',\n        'another log'\n      ];\n      const result = CacheMetadataParser.extractFromLogs(logs);\n      \n      expect(result).toEqual({\n        hit: true,\n        cacheDisabled: undefined,\n        height: 123456\n      });\n    });\n\n    it('should return null for logs without cache metadata', () => {\n      const logs = ['normal log entry', 'another log'];\n      const result = CacheMetadataParser.extractFromLogs(logs);\n      \n      expect(result).toBeNull();\n    });\n\n    it('should return null for malformed JSON', () => {\n      const logs = ['{\"cache_hit\": true invalid json}'];\n      const result = CacheMetadataParser.extractFromLogs(logs);\n      \n      expect(result).toBeNull();\n    });\n\n    it('should return null for empty logs', () => {\n      const result = CacheMetadataParser.extractFromLogs([]);\n      expect(result).toBeNull();\n    });\n\n    it('should handle empty string logs', () => {\n      const result = CacheMetadataParser.extractFromLogs(['', '   ', '\\n']);\n      expect(result).toBeNull();\n    });\n\n    it('should extract cache hit metadata with all fields', () => {\n      const logs = ['{\"cache_hit\": true, \"cache_height\": 123456}'];\n      const metadata = CacheMetadataParser.extractFromLogs(logs);\n      expect(metadata).toEqual({\n        hit: true,\n        cacheDisabled: undefined,\n        height: 123456\n      });\n    });\n\n    it('should extract cache hit without optional fields', () => {\n      const logs = ['{\"cache_hit\": true}'];\n      const metadata = CacheMetadataParser.extractFromLogs(logs);\n      expect(metadata).toEqual({\n        hit: true,\n        cacheDisabled: undefined,\n        height: undefined\n      });\n    });\n\n    it('should extract cache miss', () => {\n      const logs = ['{\"cache_hit\": false}'];\n      const metadata = CacheMetadataParser.extractFromLogs(logs);\n      expect(metadata).toEqual({\n        hit: false,\n        cacheDisabled: undefined,\n        height: undefined\n      });\n    });\n\n    it('should handle logs with prepended numeric prefixes', () => {\n      const logs = ['1. {\"cache_hit\": true, \"cache_height\": 123456}\\n2. some other log\\n3. {\"cache_hit\": false}'];\n      const metadata = CacheMetadataParser.extractFromLogs(logs);\n      // Should extract the first cache metadata found (cache hit)\n      expect(metadata).toEqual({\n        hit: true,\n        cacheDisabled: undefined,\n        height: 123456\n      });\n    });\n\n    it('should handle array of logs with prepended numeric prefixes', () => {\n      const logs = [\n        '1. normal log line',\n        '2. {\"cache_hit\": false, \"cache_disabled\": true}',\n        '3. another log line'\n      ];\n      const metadata = CacheMetadataParser.extractFromLogs(logs);\n      expect(metadata).toEqual({\n        hit: false,\n        cacheDisabled: true,\n        height: undefined\n      });\n    });\n\n    it('should handle mixed format logs (some with prefixes, some without)', () => {\n      const logs = [\n        'normal log without prefix',\n        '1. {\"cache_hit\": true}',\n        'another log without prefix'\n      ];\n      const metadata = CacheMetadataParser.extractFromLogs(logs);\n      expect(metadata).toEqual({\n        hit: true,\n        cacheDisabled: undefined,\n        height: undefined\n      });\n    });\n  });\n\n  describe('isValidCacheMetadata', () => {\n    it('should validate correct cache metadata', () => {\n      const metadata = { hit: true, height: 123456 };\n      expect(CacheMetadataParser.isValidCacheMetadata(metadata)).toBe(true);\n    });\n\n    it('should validate metadata without height', () => {\n      const metadata = { hit: false };\n      expect(CacheMetadataParser.isValidCacheMetadata(metadata)).toBe(true);\n    });\n\n    it('should validate 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      expect(CacheMetadataParser.isValidCacheMetadata(metadata)).toBe(true);\n    });\n\n    it('should validate metadata with optional fields', () => {\n      const metadata = { hit: true, cacheDisabled: true };\n      expect(CacheMetadataParser.isValidCacheMetadata(metadata)).toBe(true);\n    });\n\n    it('should reject metadata without hit field', () => {\n      const metadata = { height: 123456 };\n      expect(CacheMetadataParser.isValidCacheMetadata(metadata)).toBe(false);\n    });\n\n    it('should reject metadata with invalid hit type', () => {\n      const metadata = { hit: 'true', height: 123456 };\n      expect(CacheMetadataParser.isValidCacheMetadata(metadata)).toBe(false);\n    });\n\n    it('should reject metadata with invalid cacheDisabled type', () => {\n      const metadata = { hit: true, cacheDisabled: 'false' };\n      expect(CacheMetadataParser.isValidCacheMetadata(metadata)).toBe(false);\n    });\n\n    it('should reject metadata with invalid streamId type', () => {\n      const metadata = { hit: true, streamId: 123 };\n      expect(CacheMetadataParser.isValidCacheMetadata(metadata)).toBe(false);\n    });\n\n    it('should reject metadata with invalid dataProvider type', () => {\n      const metadata = { hit: true, dataProvider: 456 };\n      expect(CacheMetadataParser.isValidCacheMetadata(metadata)).toBe(false);\n    });\n\n    it('should reject metadata with invalid numeric fields', () => {\n      const invalidFromMetadata = { hit: true, from: '123' };\n      const invalidToMetadata = { hit: true, to: '456' };\n      const invalidFrozenAtMetadata = { hit: true, frozenAt: '789' };\n      const invalidRowsServedMetadata = { hit: true, rowsServed: '10' };\n\n      expect(CacheMetadataParser.isValidCacheMetadata(invalidFromMetadata)).toBe(false);\n      expect(CacheMetadataParser.isValidCacheMetadata(invalidToMetadata)).toBe(false);\n      expect(CacheMetadataParser.isValidCacheMetadata(invalidFrozenAtMetadata)).toBe(false);\n      expect(CacheMetadataParser.isValidCacheMetadata(invalidRowsServedMetadata)).toBe(false);\n    });\n\n    it('should validate complete metadata', () => {\n      const metadata = { hit: true, height: 123456 };\n      expect(CacheMetadataParser.isValidCacheMetadata(metadata)).toBe(true);\n    });\n\n    it('should reject metadata with invalid height type', () => {\n      const metadata = { hit: true, height: '123456' };\n      expect(CacheMetadataParser.isValidCacheMetadata(metadata)).toBe(false);\n    });\n\n    it('should reject null or undefined', () => {\n      expect(CacheMetadataParser.isValidCacheMetadata(null)).toBe(false);\n      expect(CacheMetadataParser.isValidCacheMetadata(undefined)).toBe(false);\n    });\n  });\n\n  describe('extractFromResponse', () => {\n    it('should extract from response with logs', () => {\n      const response = {\n        data: { result: [] },\n        logs: ['{\"cache_hit\": true, \"cache_height\": 123456}']\n      };\n      const result = CacheMetadataParser.extractFromResponse(response);\n      \n      expect(result).toEqual({\n        hit: true,\n        cacheDisabled: undefined,\n        height: 123456\n      });\n    });\n\n    it('should return null for response without logs', () => {\n      const response = { data: { result: [] } };\n      const result = CacheMetadataParser.extractFromResponse(response);\n      \n      expect(result).toBeNull();\n    });\n\n    it('should return null for null response', () => {\n      const result = CacheMetadataParser.extractFromResponse(null);\n      expect(result).toBeNull();\n    });\n  });\n\n  describe('aggregate', () => {\n    it('should aggregate empty metadata list', () => {\n      const result = CacheMetadataParser.aggregate([]);\n      \n      expect(result).toEqual({\n        totalQueries: 0,\n        cacheHits: 0,\n        cacheMisses: 0,\n        cacheHitRate: 0,\n        totalRowsServed: 0,\n        entries: []\n      });\n    });\n\n    it('should aggregate single metadata entry', () => {\n      const metadata: CacheMetadata = {\n        hit: true,\n        height: 123456,\n        streamId: 'test-stream',\n        rowsServed: 5\n      };\n      \n      const result = CacheMetadataParser.aggregate([metadata]);\n      \n      expect(result).toEqual({\n        totalQueries: 1,\n        cacheHits: 1,\n        cacheMisses: 0,\n        cacheHitRate: 1.0,\n        totalRowsServed: 5,\n        entries: [metadata]\n      });\n    });\n\n    it('should aggregate multiple metadata entries', () => {\n      const metadata1: CacheMetadata = {\n        hit: true,\n        height: 123456,\n        streamId: 'stream-1',\n        rowsServed: 10\n      };\n      \n      const metadata2: CacheMetadata = {\n        hit: false,\n        streamId: 'stream-2',\n        rowsServed: 5\n      };\n      \n      const metadata3: CacheMetadata = {\n        hit: true,\n        height: 123457,\n        streamId: 'stream-3',\n        rowsServed: 15\n      };\n      \n      const result = CacheMetadataParser.aggregate([metadata1, metadata2, metadata3]);\n      \n      expect(result).toEqual({\n        totalQueries: 3,\n        cacheHits: 2,\n        cacheMisses: 1,\n        cacheHitRate: 2/3,\n        totalRowsServed: 30,\n        entries: [metadata1, metadata2, metadata3]\n      });\n    });\n\n    it('should handle metadata without rowsServed', () => {\n      const metadata1: CacheMetadata = { hit: true, height: 123456 };\n      const metadata2: CacheMetadata = { hit: false };\n      const metadata3: CacheMetadata = { hit: true, rowsServed: 8 };\n      \n      const result = CacheMetadataParser.aggregate([metadata1, metadata2, metadata3]);\n      \n      expect(result).toEqual({\n        totalQueries: 3,\n        cacheHits: 2,\n        cacheMisses: 1,\n        cacheHitRate: 2/3,\n        totalRowsServed: 8, // Only metadata3 has rowsServed\n        entries: [metadata1, metadata2, metadata3]\n      });\n    });\n\n    it('should calculate correct cache hit rate for mixed results', () => {\n      const metadataList: CacheMetadata[] = [\n        { hit: true, rowsServed: 1 },\n        { hit: false, rowsServed: 2 },\n        { hit: false, rowsServed: 3 },\n        { hit: true, rowsServed: 4 },\n        { hit: true, rowsServed: 5 }\n      ];\n      \n      const result = CacheMetadataParser.aggregate(metadataList);\n      \n      expect(result.totalQueries).toBe(5);\n      expect(result.cacheHits).toBe(3);\n      expect(result.cacheMisses).toBe(2);\n      expect(result.cacheHitRate).toBe(0.6); // 3/5 = 0.6\n      expect(result.totalRowsServed).toBe(15); // 1+2+3+4+5 = 15\n    });\n  });\n});"],
+  "mappings": "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",
+  "names": []
+}

package/dist/cjs/util/cacheValidation.cjs

@@ -0,0 +1,88 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/util/cacheValidation.ts
+var cacheValidation_exports = {};
+__export(cacheValidation_exports, {
+  CacheValidation: () => CacheValidation
+});
+module.exports = __toCommonJS(cacheValidation_exports);
+var CacheValidation = class {
+  /**
+   * Validates GetRecordOptions parameters
+   */
+  static validateGetRecordOptions(options) {
+    if (options.from !== void 0 && (typeof options.from !== "number" || options.from < 0)) {
+      throw new Error("Invalid from parameter: must be a non-negative number");
+    }
+    if (options.to !== void 0 && (typeof options.to !== "number" || options.to < 0)) {
+      throw new Error("Invalid to parameter: must be a non-negative number");
+    }
+    if (options.frozenAt !== void 0 && (typeof options.frozenAt !== "number" || options.frozenAt < 0)) {
+      throw new Error("Invalid frozenAt parameter: must be a non-negative number");
+    }
+    if (options.useCache !== void 0 && typeof options.useCache !== "boolean") {
+      throw new Error("Invalid useCache parameter: must be a boolean");
+    }
+    if (options.prefix !== void 0 && typeof options.prefix !== "string") {
+      throw new Error("Invalid prefix parameter: must be a string");
+    }
+    if (options.baseTime !== void 0 && typeof options.baseTime !== "number" && typeof options.baseTime !== "string") {
+      throw new Error("Invalid baseTime parameter: must be a number or string");
+    }
+  }
+  /**
+   * Validates GetIndexOptions parameters
+   */
+  static validateGetIndexOptions(options) {
+    this.validateGetRecordOptions(options);
+  }
+  /**
+   * Validates GetIndexChangeOptions parameters
+   */
+  static validateGetIndexChangeOptions(options) {
+    this.validateGetRecordOptions(options);
+    if (typeof options.timeInterval !== "number" || options.timeInterval <= 0) {
+      throw new Error("Invalid timeInterval parameter: must be a positive number");
+    }
+  }
+  /**
+   * Validates GetFirstRecordOptions parameters
+   */
+  static validateGetFirstRecordOptions(options) {
+    if (options.after !== void 0 && (typeof options.after !== "number" || options.after < 0)) {
+      throw new Error("Invalid after parameter: must be a non-negative number");
+    }
+    if (options.frozenAt !== void 0 && (typeof options.frozenAt !== "number" || options.frozenAt < 0)) {
+      throw new Error("Invalid frozenAt parameter: must be a non-negative number");
+    }
+    if (options.useCache !== void 0 && typeof options.useCache !== "boolean") {
+      throw new Error("Invalid useCache parameter: must be a boolean");
+    }
+  }
+  /**
+   * Validates time range parameters
+   */
+  static validateTimeRange(from, to) {
+    if (from !== void 0 && to !== void 0 && from > to) {
+      throw new Error("Invalid time range: from time cannot be greater than to time");
+    }
+  }
+};
+//# sourceMappingURL=cacheValidation.cjs.map

package/dist/cjs/util/cacheValidation.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/util/cacheValidation.ts"],
+  "sourcesContent": ["import { GetRecordOptions, GetIndexOptions, GetIndexChangeOptions, GetFirstRecordOptions } from '../types/cache';\n\n/**\n * Validation utilities for cache-related parameters\n */\nexport class CacheValidation {\n  /**\n   * Validates GetRecordOptions parameters\n   */\n  static validateGetRecordOptions(options: GetRecordOptions): void {\n    if (options.from !== undefined && (typeof options.from !== 'number' || options.from < 0)) {\n      throw new Error('Invalid from parameter: must be a non-negative number');\n    }\n    \n    if (options.to !== undefined && (typeof options.to !== 'number' || options.to < 0)) {\n      throw new Error('Invalid to parameter: must be a non-negative number');\n    }\n    \n    if (options.frozenAt !== undefined && (typeof options.frozenAt !== 'number' || options.frozenAt < 0)) {\n      throw new Error('Invalid frozenAt parameter: must be a non-negative number');\n    }\n    \n    if (options.useCache !== undefined && typeof options.useCache !== 'boolean') {\n      throw new Error('Invalid useCache parameter: must be a boolean');\n    }\n    \n    if (options.prefix !== undefined && typeof options.prefix !== 'string') {\n      throw new Error('Invalid prefix parameter: must be a string');\n    }\n    \n    if (options.baseTime !== undefined && typeof options.baseTime !== 'number' && typeof options.baseTime !== 'string') {\n      throw new Error('Invalid baseTime parameter: must be a number or string');\n    }\n  }\n  \n  /**\n   * Validates GetIndexOptions parameters\n   */\n  static validateGetIndexOptions(options: GetIndexOptions): void {\n    // GetIndexOptions has the same validation as GetRecordOptions\n    this.validateGetRecordOptions(options);\n  }\n  \n  /**\n   * Validates GetIndexChangeOptions parameters\n   */\n  static validateGetIndexChangeOptions(options: GetIndexChangeOptions): void {\n    // Validate base options\n    this.validateGetRecordOptions(options);\n    \n    // Validate timeInterval - required for index change\n    if (typeof options.timeInterval !== 'number' || options.timeInterval <= 0) {\n      throw new Error('Invalid timeInterval parameter: must be a positive number');\n    }\n  }\n  \n  /**\n   * Validates GetFirstRecordOptions parameters\n   */\n  static validateGetFirstRecordOptions(options: GetFirstRecordOptions): void {\n    if (options.after !== undefined && (typeof options.after !== 'number' || options.after < 0)) {\n      throw new Error('Invalid after parameter: must be a non-negative number');\n    }\n    \n    if (options.frozenAt !== undefined && (typeof options.frozenAt !== 'number' || options.frozenAt < 0)) {\n      throw new Error('Invalid frozenAt parameter: must be a non-negative number');\n    }\n    \n    if (options.useCache !== undefined && typeof options.useCache !== 'boolean') {\n      throw new Error('Invalid useCache parameter: must be a boolean');\n    }\n  }\n  \n  /**\n   * Validates time range parameters\n   */\n  static validateTimeRange(from?: number, to?: number): void {\n    if (from !== undefined && to !== undefined && from > to) {\n      throw new Error('Invalid time range: from time cannot be greater than to time');\n    }\n  }\n}"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAKO,IAAM,kBAAN,MAAsB;AAAA;AAAA;AAAA;AAAA,EAI3B,OAAO,yBAAyB,SAAiC;AAC/D,QAAI,QAAQ,SAAS,WAAc,OAAO,QAAQ,SAAS,YAAY,QAAQ,OAAO,IAAI;AACxF,YAAM,IAAI,MAAM,uDAAuD;AAAA,IACzE;AAEA,QAAI,QAAQ,OAAO,WAAc,OAAO,QAAQ,OAAO,YAAY,QAAQ,KAAK,IAAI;AAClF,YAAM,IAAI,MAAM,qDAAqD;AAAA,IACvE;AAEA,QAAI,QAAQ,aAAa,WAAc,OAAO,QAAQ,aAAa,YAAY,QAAQ,WAAW,IAAI;AACpG,YAAM,IAAI,MAAM,2DAA2D;AAAA,IAC7E;AAEA,QAAI,QAAQ,aAAa,UAAa,OAAO,QAAQ,aAAa,WAAW;AAC3E,YAAM,IAAI,MAAM,+CAA+C;AAAA,IACjE;AAEA,QAAI,QAAQ,WAAW,UAAa,OAAO,QAAQ,WAAW,UAAU;AACtE,YAAM,IAAI,MAAM,4CAA4C;AAAA,IAC9D;AAEA,QAAI,QAAQ,aAAa,UAAa,OAAO,QAAQ,aAAa,YAAY,OAAO,QAAQ,aAAa,UAAU;AAClH,YAAM,IAAI,MAAM,wDAAwD;AAAA,IAC1E;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,wBAAwB,SAAgC;AAE7D,SAAK,yBAAyB,OAAO;AAAA,EACvC;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,8BAA8B,SAAsC;AAEzE,SAAK,yBAAyB,OAAO;AAGrC,QAAI,OAAO,QAAQ,iBAAiB,YAAY,QAAQ,gBAAgB,GAAG;AACzE,YAAM,IAAI,MAAM,2DAA2D;AAAA,IAC7E;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,8BAA8B,SAAsC;AACzE,QAAI,QAAQ,UAAU,WAAc,OAAO,QAAQ,UAAU,YAAY,QAAQ,QAAQ,IAAI;AAC3F,YAAM,IAAI,MAAM,wDAAwD;AAAA,IAC1E;AAEA,QAAI,QAAQ,aAAa,WAAc,OAAO,QAAQ,aAAa,YAAY,QAAQ,WAAW,IAAI;AACpG,YAAM,IAAI,MAAM,2DAA2D;AAAA,IAC7E;AAEA,QAAI,QAAQ,aAAa,UAAa,OAAO,QAAQ,aAAa,WAAW;AAC3E,YAAM,IAAI,MAAM,+CAA+C;AAAA,IACjE;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,kBAAkB,MAAe,IAAmB;AACzD,QAAI,SAAS,UAAa,OAAO,UAAa,OAAO,IAAI;AACvD,YAAM,IAAI,MAAM,8DAA8D;AAAA,IAChF;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/cjs/util/cacheValidation.test.cjs

@@ -0,0 +1,108 @@
+"use strict";
+
+// src/util/cacheValidation.test.ts
+var import_vitest = require("vitest");
+var import_cacheValidation = require("./cacheValidation.cjs");
+(0, import_vitest.describe)("CacheValidation", () => {
+  (0, import_vitest.describe)("validateGetRecordOptions", () => {
+    (0, import_vitest.it)("should validate correct options", () => {
+      const options = {
+        from: 1609459200,
+        to: 1609545600,
+        frozenAt: 1609459200,
+        useCache: true,
+        prefix: "test_",
+        baseTime: 1609459200
+      };
+      (0, import_vitest.expect)(() => import_cacheValidation.CacheValidation.validateGetRecordOptions(options)).not.toThrow();
+    });
+    (0, import_vitest.it)("should validate options with string baseTime", () => {
+      const options = {
+        baseTime: "2021-01-01",
+        useCache: true
+      };
+      (0, import_vitest.expect)(() => import_cacheValidation.CacheValidation.validateGetRecordOptions(options)).not.toThrow();
+    });
+    (0, import_vitest.it)("should validate empty options", () => {
+      (0, import_vitest.expect)(() => import_cacheValidation.CacheValidation.validateGetRecordOptions({})).not.toThrow();
+    });
+    (0, import_vitest.it)("should throw for invalid from parameter", () => {
+      (0, import_vitest.expect)(() => import_cacheValidation.CacheValidation.validateGetRecordOptions({ from: -1 })).toThrow("Invalid from parameter: must be a non-negative number");
+      (0, import_vitest.expect)(() => import_cacheValidation.CacheValidation.validateGetRecordOptions({ from: "invalid" })).toThrow("Invalid from parameter: must be a non-negative number");
+    });
+    (0, import_vitest.it)("should throw for invalid to parameter", () => {
+      (0, import_vitest.expect)(() => import_cacheValidation.CacheValidation.validateGetRecordOptions({ to: -1 })).toThrow("Invalid to parameter: must be a non-negative number");
+    });
+    (0, import_vitest.it)("should throw for invalid frozenAt parameter", () => {
+      (0, import_vitest.expect)(() => import_cacheValidation.CacheValidation.validateGetRecordOptions({ frozenAt: -1 })).toThrow("Invalid frozenAt parameter: must be a non-negative number");
+    });
+    (0, import_vitest.it)("should throw for invalid useCache parameter", () => {
+      (0, import_vitest.expect)(() => import_cacheValidation.CacheValidation.validateGetRecordOptions({ useCache: "true" })).toThrow("Invalid useCache parameter: must be a boolean");
+    });
+    (0, import_vitest.it)("should throw for invalid prefix parameter", () => {
+      (0, import_vitest.expect)(() => import_cacheValidation.CacheValidation.validateGetRecordOptions({ prefix: 123 })).toThrow("Invalid prefix parameter: must be a string");
+    });
+    (0, import_vitest.it)("should throw for invalid baseTime parameter", () => {
+      (0, import_vitest.expect)(() => import_cacheValidation.CacheValidation.validateGetRecordOptions({ baseTime: true })).toThrow("Invalid baseTime parameter: must be a number or string");
+    });
+  });
+  (0, import_vitest.describe)("validateGetIndexChangeOptions", () => {
+    (0, import_vitest.it)("should validate correct options", () => {
+      const options = {
+        from: 1609459200,
+        to: 1609545600,
+        timeInterval: 3600,
+        useCache: true
+      };
+      (0, import_vitest.expect)(() => import_cacheValidation.CacheValidation.validateGetIndexChangeOptions(options)).not.toThrow();
+    });
+    (0, import_vitest.it)("should throw for missing timeInterval", () => {
+      const options = {
+        from: 1609459200,
+        to: 1609545600
+      };
+      (0, import_vitest.expect)(() => import_cacheValidation.CacheValidation.validateGetIndexChangeOptions(options)).toThrow("Invalid timeInterval parameter: must be a positive number");
+    });
+    (0, import_vitest.it)("should throw for invalid timeInterval", () => {
+      (0, import_vitest.expect)(() => import_cacheValidation.CacheValidation.validateGetIndexChangeOptions({ timeInterval: -1 })).toThrow("Invalid timeInterval parameter: must be a positive number");
+      (0, import_vitest.expect)(() => import_cacheValidation.CacheValidation.validateGetIndexChangeOptions({ timeInterval: 0 })).toThrow("Invalid timeInterval parameter: must be a positive number");
+      (0, import_vitest.expect)(() => import_cacheValidation.CacheValidation.validateGetIndexChangeOptions({ timeInterval: "invalid" })).toThrow("Invalid timeInterval parameter: must be a positive number");
+    });
+  });
+  (0, import_vitest.describe)("validateGetFirstRecordOptions", () => {
+    (0, import_vitest.it)("should validate correct options", () => {
+      const options = {
+        after: 1609459200,
+        frozenAt: 1609459200,
+        useCache: true
+      };
+      (0, import_vitest.expect)(() => import_cacheValidation.CacheValidation.validateGetFirstRecordOptions(options)).not.toThrow();
+    });
+    (0, import_vitest.it)("should throw for invalid after parameter", () => {
+      (0, import_vitest.expect)(() => import_cacheValidation.CacheValidation.validateGetFirstRecordOptions({ after: -1 })).toThrow("Invalid after parameter: must be a non-negative number");
+    });
+    (0, import_vitest.it)("should throw for invalid frozenAt parameter", () => {
+      (0, import_vitest.expect)(() => import_cacheValidation.CacheValidation.validateGetFirstRecordOptions({ frozenAt: -1 })).toThrow("Invalid frozenAt parameter: must be a non-negative number");
+    });
+    (0, import_vitest.it)("should throw for invalid useCache parameter", () => {
+      (0, import_vitest.expect)(() => import_cacheValidation.CacheValidation.validateGetFirstRecordOptions({ useCache: "true" })).toThrow("Invalid useCache parameter: must be a boolean");
+    });
+  });
+  (0, import_vitest.describe)("validateTimeRange", () => {
+    (0, import_vitest.it)("should validate correct time range", () => {
+      (0, import_vitest.expect)(() => import_cacheValidation.CacheValidation.validateTimeRange(1609459200, 1609545600)).not.toThrow();
+    });
+    (0, import_vitest.it)("should validate undefined parameters", () => {
+      (0, import_vitest.expect)(() => import_cacheValidation.CacheValidation.validateTimeRange(void 0, void 0)).not.toThrow();
+      (0, import_vitest.expect)(() => import_cacheValidation.CacheValidation.validateTimeRange(1609459200, void 0)).not.toThrow();
+      (0, import_vitest.expect)(() => import_cacheValidation.CacheValidation.validateTimeRange(void 0, 1609545600)).not.toThrow();
+    });
+    (0, import_vitest.it)("should validate equal times", () => {
+      (0, import_vitest.expect)(() => import_cacheValidation.CacheValidation.validateTimeRange(1609459200, 1609459200)).not.toThrow();
+    });
+    (0, import_vitest.it)("should throw for invalid time range", () => {
+      (0, import_vitest.expect)(() => import_cacheValidation.CacheValidation.validateTimeRange(1609545600, 1609459200)).toThrow("Invalid time range: from time cannot be greater than to time");
+    });
+  });
+});
+//# sourceMappingURL=cacheValidation.test.cjs.map

package/dist/cjs/util/cacheValidation.test.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/util/cacheValidation.test.ts"],
+  "sourcesContent": ["import { describe, it, expect } from 'vitest';\nimport { CacheValidation } from './cacheValidation';\n\ndescribe('CacheValidation', () => {\n  describe('validateGetRecordOptions', () => {\n    it('should validate correct options', () => {\n      const options = {\n        from: 1609459200,\n        to: 1609545600,\n        frozenAt: 1609459200,\n        useCache: true,\n        prefix: 'test_',\n        baseTime: 1609459200\n      };\n      \n      expect(() => CacheValidation.validateGetRecordOptions(options)).not.toThrow();\n    });\n\n    it('should validate options with string baseTime', () => {\n      const options = {\n        baseTime: '2021-01-01',\n        useCache: true\n      };\n      \n      expect(() => CacheValidation.validateGetRecordOptions(options)).not.toThrow();\n    });\n\n    it('should validate empty options', () => {\n      expect(() => CacheValidation.validateGetRecordOptions({})).not.toThrow();\n    });\n\n    it('should throw for invalid from parameter', () => {\n      expect(() => CacheValidation.validateGetRecordOptions({ from: -1 }))\n        .toThrow('Invalid from parameter: must be a non-negative number');\n      \n      expect(() => CacheValidation.validateGetRecordOptions({ from: 'invalid' as any }))\n        .toThrow('Invalid from parameter: must be a non-negative number');\n    });\n\n    it('should throw for invalid to parameter', () => {\n      expect(() => CacheValidation.validateGetRecordOptions({ to: -1 }))\n        .toThrow('Invalid to parameter: must be a non-negative number');\n    });\n\n    it('should throw for invalid frozenAt parameter', () => {\n      expect(() => CacheValidation.validateGetRecordOptions({ frozenAt: -1 }))\n        .toThrow('Invalid frozenAt parameter: must be a non-negative number');\n    });\n\n    it('should throw for invalid useCache parameter', () => {\n      expect(() => CacheValidation.validateGetRecordOptions({ useCache: 'true' as any }))\n        .toThrow('Invalid useCache parameter: must be a boolean');\n    });\n\n    it('should throw for invalid prefix parameter', () => {\n      expect(() => CacheValidation.validateGetRecordOptions({ prefix: 123 as any }))\n        .toThrow('Invalid prefix parameter: must be a string');\n    });\n\n    it('should throw for invalid baseTime parameter', () => {\n      expect(() => CacheValidation.validateGetRecordOptions({ baseTime: true as any }))\n        .toThrow('Invalid baseTime parameter: must be a number or string');\n    });\n  });\n\n  describe('validateGetIndexChangeOptions', () => {\n    it('should validate correct options', () => {\n      const options = {\n        from: 1609459200,\n        to: 1609545600,\n        timeInterval: 3600,\n        useCache: true\n      };\n      \n      expect(() => CacheValidation.validateGetIndexChangeOptions(options)).not.toThrow();\n    });\n\n    it('should throw for missing timeInterval', () => {\n      const options = {\n        from: 1609459200,\n        to: 1609545600\n      };\n      \n      expect(() => CacheValidation.validateGetIndexChangeOptions(options as any))\n        .toThrow('Invalid timeInterval parameter: must be a positive number');\n    });\n\n    it('should throw for invalid timeInterval', () => {\n      expect(() => CacheValidation.validateGetIndexChangeOptions({ timeInterval: -1 }))\n        .toThrow('Invalid timeInterval parameter: must be a positive number');\n      \n      expect(() => CacheValidation.validateGetIndexChangeOptions({ timeInterval: 0 }))\n        .toThrow('Invalid timeInterval parameter: must be a positive number');\n      \n      expect(() => CacheValidation.validateGetIndexChangeOptions({ timeInterval: 'invalid' as any }))\n        .toThrow('Invalid timeInterval parameter: must be a positive number');\n    });\n  });\n\n  describe('validateGetFirstRecordOptions', () => {\n    it('should validate correct options', () => {\n      const options = {\n        after: 1609459200,\n        frozenAt: 1609459200,\n        useCache: true\n      };\n      \n      expect(() => CacheValidation.validateGetFirstRecordOptions(options)).not.toThrow();\n    });\n\n    it('should throw for invalid after parameter', () => {\n      expect(() => CacheValidation.validateGetFirstRecordOptions({ after: -1 }))\n        .toThrow('Invalid after parameter: must be a non-negative number');\n    });\n\n    it('should throw for invalid frozenAt parameter', () => {\n      expect(() => CacheValidation.validateGetFirstRecordOptions({ frozenAt: -1 }))\n        .toThrow('Invalid frozenAt parameter: must be a non-negative number');\n    });\n\n    it('should throw for invalid useCache parameter', () => {\n      expect(() => CacheValidation.validateGetFirstRecordOptions({ useCache: 'true' as any }))\n        .toThrow('Invalid useCache parameter: must be a boolean');\n    });\n  });\n\n  describe('validateTimeRange', () => {\n    it('should validate correct time range', () => {\n      expect(() => CacheValidation.validateTimeRange(1609459200, 1609545600)).not.toThrow();\n    });\n\n    it('should validate undefined parameters', () => {\n      expect(() => CacheValidation.validateTimeRange(undefined, undefined)).not.toThrow();\n      expect(() => CacheValidation.validateTimeRange(1609459200, undefined)).not.toThrow();\n      expect(() => CacheValidation.validateTimeRange(undefined, 1609545600)).not.toThrow();\n    });\n\n    it('should validate equal times', () => {\n      expect(() => CacheValidation.validateTimeRange(1609459200, 1609459200)).not.toThrow();\n    });\n\n    it('should throw for invalid time range', () => {\n      expect(() => CacheValidation.validateTimeRange(1609545600, 1609459200))\n        .toThrow('Invalid time range: from time cannot be greater than to time');\n    });\n  });\n});"],
+  "mappings": "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",
+  "names": []
+}

package/dist/esm/client/browserClient.mjs

@@ -1,5 +1,5 @@
 // src/client/browserClient.ts
-import { WebKwil } from "@kwilteam/kwil-js";
+import { WebKwil } from "@trufnetwork/kwil-js";
 import { BaseTNClient } from "./client.mjs";
 var BrowserTNClient = class extends BaseTNClient {
   constructor(options) {

package/dist/esm/client/browserClient.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/client/browserClient.ts"],
-  "sourcesContent": ["import { EnvironmentType } from \"@kwilteam/kwil-js/dist/core/enums\";\nimport { WebKwil } from \"@kwilteam/kwil-js\";\nimport { BaseTNClient, TNClientOptions } from \"./client\";\n\nexport class BrowserTNClient extends BaseTNClient<EnvironmentType.BROWSER> {\n  constructor(options: TNClientOptions) {\n    super(options);\n    this.kwilClient = new WebKwil({\n      ...options,\n      timeout: options.timeout ?? 30000,\n      kwilProvider: options.endpoint,\n    });\n  }\n}\n\nexport default BrowserTNClient;\n"],
+  "sourcesContent": ["import { EnvironmentType } from \"@trufnetwork/kwil-js/dist/core/enums\";\nimport { WebKwil } from \"@trufnetwork/kwil-js\";\nimport { BaseTNClient, TNClientOptions } from \"./client\";\n\nexport class BrowserTNClient extends BaseTNClient<EnvironmentType.BROWSER> {\n  constructor(options: TNClientOptions) {\n    super(options);\n    this.kwilClient = new WebKwil({\n      ...options,\n      timeout: options.timeout ?? 30000,\n      kwilProvider: options.endpoint,\n    });\n  }\n}\n\nexport default BrowserTNClient;\n"],
   "mappings": ";AACA,SAAS,eAAe;AACxB,SAAS,oBAAqC;AAEvC,IAAM,kBAAN,cAA8B,aAAsC;AAAA,EACzE,YAAY,SAA0B;AACpC,UAAM,OAAO;AACb,SAAK,aAAa,IAAI,QAAQ;AAAA,MAC5B,GAAG;AAAA,MACH,SAAS,QAAQ,WAAW;AAAA,MAC5B,cAAc,QAAQ;AAAA,IACxB,CAAC;AAAA,EACH;AACF;AAEA,IAAO,wBAAQ;",
   "names": []
 }