@trufnetwork/sdk-js 0.3.8 → 0.4.2

package/dist/esm/util/cacheMetadataParser.mjs

@@ -0,0 +1,153 @@
+// src/util/cacheMetadataParser.ts
+var CacheMetadataParser = class {
+  /**
+   * Parses logs and removes prepended numeric prefixes (e.g., "1. ", "2. ")
+   * @param logsInput - The logs string or array to parse
+   * @returns Array of clean log lines
+   */
+  static parseLogsForMetadata(logsInput) {
+    const logs = [];
+    const logArray = Array.isArray(logsInput) ? logsInput : [logsInput];
+    for (const log of logArray) {
+      if (!log || typeof log !== "string") {
+        continue;
+      }
+      const lines = log.split("\n");
+      for (const line of lines) {
+        const trimmedLine = line.trim();
+        if (!trimmedLine) {
+          continue;
+        }
+        const dotSpaceIndex = trimmedLine.indexOf(". ");
+        if (dotSpaceIndex > 0) {
+          const prefix = trimmedLine.substring(0, dotSpaceIndex);
+          if (/^\d+$/.test(prefix)) {
+            const cleanLine = trimmedLine.substring(dotSpaceIndex + 2).trim();
+            if (cleanLine) {
+              logs.push(cleanLine);
+            }
+            continue;
+          }
+        }
+        logs.push(trimmedLine);
+      }
+    }
+    return logs;
+  }
+  /**
+   * Extracts cache metadata from action logs
+   * @param logs - The action logs returned from the backend (may be a single string or array)
+   * @returns Cache metadata if found, null otherwise
+   */
+  static extractFromLogs(logs) {
+    const logLines = this.parseLogsForMetadata(logs);
+    for (const line of logLines) {
+      if (line.includes("cache_hit")) {
+        try {
+          const logData = JSON.parse(line);
+          if (logData.cache_hit === true) {
+            return {
+              hit: true,
+              cacheDisabled: logData.cache_disabled,
+              height: logData.cache_height ? Number(logData.cache_height) : void 0
+            };
+          }
+          if (logData.cache_hit === false) {
+            return {
+              hit: false,
+              cacheDisabled: logData.cache_disabled,
+              height: void 0
+            };
+          }
+        } catch (error) {
+          continue;
+        }
+      }
+    }
+    return null;
+  }
+  /**
+   * Validates cache metadata structure
+   * @param metadata - The cache metadata to validate
+   * @returns True if metadata is valid, false otherwise
+   */
+  static isValidCacheMetadata(metadata) {
+    if (!metadata || typeof metadata !== "object") {
+      return false;
+    }
+    if (typeof metadata.hit !== "boolean") {
+      return false;
+    }
+    if (metadata.cacheDisabled !== void 0 && typeof metadata.cacheDisabled !== "boolean") {
+      return false;
+    }
+    if (metadata.streamId !== void 0 && typeof metadata.streamId !== "string") {
+      return false;
+    }
+    if (metadata.dataProvider !== void 0 && typeof metadata.dataProvider !== "string") {
+      return false;
+    }
+    if (metadata.from !== void 0 && typeof metadata.from !== "number") {
+      return false;
+    }
+    if (metadata.to !== void 0 && typeof metadata.to !== "number") {
+      return false;
+    }
+    if (metadata.frozenAt !== void 0 && typeof metadata.frozenAt !== "number") {
+      return false;
+    }
+    if (metadata.rowsServed !== void 0 && typeof metadata.rowsServed !== "number") {
+      return false;
+    }
+    if (metadata.height !== void 0 && typeof metadata.height !== "number") {
+      return false;
+    }
+    return true;
+  }
+  /**
+   * Extracts cache metadata from Kwil response structure
+   * @param response - The full response from Kwil client
+   * @returns Cache metadata if found, null otherwise
+   */
+  static extractFromResponse(response) {
+    if (response && response.data && response.data.logs) {
+      return this.extractFromLogs(response.data.logs);
+    }
+    if (response && response.logs) {
+      return this.extractFromLogs(response.logs);
+    }
+    return null;
+  }
+  /**
+   * Aggregates multiple cache metadata entries into a collection
+   * @param metadataList - Array of cache metadata entries
+   * @returns Aggregated cache metadata collection
+   */
+  static aggregate(metadataList) {
+    const totalQueries = metadataList.length;
+    let cacheHits = 0;
+    let totalRowsServed = 0;
+    for (const metadata of metadataList) {
+      if (metadata.hit) {
+        cacheHits++;
+      }
+      if (metadata.rowsServed) {
+        totalRowsServed += metadata.rowsServed;
+      }
+    }
+    const cacheMisses = totalQueries - cacheHits;
+    const cacheHitRate = totalQueries > 0 ? cacheHits / totalQueries : 0;
+    return {
+      totalQueries,
+      cacheHits,
+      cacheMisses,
+      cacheHitRate,
+      totalRowsServed,
+      entries: metadataList
+    };
+  }
+};
+export {
+  CacheMetadataParser
+};
+//# sourceMappingURL=cacheMetadataParser.mjs.map

package/dist/esm/util/cacheMetadataParser.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/util/cacheMetadataParser.ts"],
+  "sourcesContent": ["import { CacheMetadata, CacheMetadataCollection } from '../types/cache';\n\n/**\n * Parser for extracting cache metadata from action logs\n * Handles the parsing of cache-related information from SQL action responses\n */\nexport class CacheMetadataParser {\n  /**\n   * Parses logs and removes prepended numeric prefixes (e.g., \"1. \", \"2. \")\n   * @param logsInput - The logs string or array to parse\n   * @returns Array of clean log lines\n   */\n  static parseLogsForMetadata(logsInput: string | string[]): string[] {\n    const logs: string[] = [];\n    const logArray = Array.isArray(logsInput) ? logsInput : [logsInput];\n    \n    for (const log of logArray) {\n      if (!log || typeof log !== 'string') {\n        continue;\n      }\n      \n      const lines = log.split('\\n');\n      for (const line of lines) {\n        const trimmedLine = line.trim();\n        if (!trimmedLine) {\n          continue;\n        }\n        \n        // Check for prepended numeric format (e.g., \"1. \", \"2. \")\n        const dotSpaceIndex = trimmedLine.indexOf('. ');\n        if (dotSpaceIndex > 0) {\n          const prefix = trimmedLine.substring(0, dotSpaceIndex);\n          // Check if prefix is a number\n          if (/^\\d+$/.test(prefix)) {\n            const cleanLine = trimmedLine.substring(dotSpaceIndex + 2).trim();\n            if (cleanLine) {\n              logs.push(cleanLine);\n            }\n            continue;\n          }\n        }\n        \n        // If no prepended format found, add the line as-is\n        logs.push(trimmedLine);\n      }\n    }\n    \n    return logs;\n  }\n\n  /**\n   * Extracts cache metadata from action logs\n   * @param logs - The action logs returned from the backend (may be a single string or array)\n   * @returns Cache metadata if found, null otherwise\n   */\n  static extractFromLogs(logs: string | string[]): CacheMetadata | null {\n    // Parse logs and remove prepended numeric prefixes\n    const logLines = this.parseLogsForMetadata(logs);\n    \n    for (const line of logLines) {\n      // Look for cache-related log entries\n      if (line.includes('cache_hit')) {\n        try {\n          // Try to parse as JSON\n          const logData = JSON.parse(line);\n          \n          // Check if this is a cache hit entry\n          if (logData.cache_hit === true) {\n            return {\n              hit: true,\n              cacheDisabled: logData.cache_disabled,\n              height: logData.cache_height ? Number(logData.cache_height) : undefined\n            };\n          }\n          \n          // Cache miss case\n          if (logData.cache_hit === false) {\n            return {\n              hit: false,\n              cacheDisabled: logData.cache_disabled,\n              height: undefined\n            };\n          }\n          \n        } catch (error) {\n          // If JSON parsing fails, continue checking other logs\n          // This is expected for non-JSON log entries\n          continue;\n        }\n      }\n    }\n    \n    // No cache metadata found\n    return null;\n  }\n  \n  /**\n   * Validates cache metadata structure\n   * @param metadata - The cache metadata to validate\n   * @returns True if metadata is valid, false otherwise\n   */\n  static isValidCacheMetadata(metadata: any): metadata is CacheMetadata {\n    if (!metadata || typeof metadata !== 'object') {\n      return false;\n    }\n    \n    // Check required fields\n    if (typeof metadata.hit !== 'boolean') {\n      return false;\n    }\n    \n    // Check optional fields\n    if (metadata.cacheDisabled !== undefined && typeof metadata.cacheDisabled !== 'boolean') {\n      return false;\n    }\n    \n    if (metadata.streamId !== undefined && typeof metadata.streamId !== 'string') {\n      return false;\n    }\n    \n    if (metadata.dataProvider !== undefined && typeof metadata.dataProvider !== 'string') {\n      return false;\n    }\n    \n    if (metadata.from !== undefined && typeof metadata.from !== 'number') {\n      return false;\n    }\n    \n    if (metadata.to !== undefined && typeof metadata.to !== 'number') {\n      return false;\n    }\n    \n    if (metadata.frozenAt !== undefined && typeof metadata.frozenAt !== 'number') {\n      return false;\n    }\n    \n    if (metadata.rowsServed !== undefined && typeof metadata.rowsServed !== 'number') {\n      return false;\n    }\n\n    if (metadata.height !== undefined && typeof metadata.height !== 'number') {\n      return false;\n    }\n    \n    return true;\n  }\n  \n  /**\n   * Extracts cache metadata from Kwil response structure\n   * @param response - The full response from Kwil client\n   * @returns Cache metadata if found, null otherwise\n   */\n  static extractFromResponse(response: any): CacheMetadata | null {\n    // Check if response has logs (new structure from kwil-js)\n    if (response && response.data && response.data.logs) {\n      return this.extractFromLogs(response.data.logs);\n    }\n    \n    // Fallback: check if response has logs directly (for backward compatibility)\n    if (response && response.logs) {\n      return this.extractFromLogs(response.logs);\n    }\n    \n    return null;\n  }\n  \n  /**\n   * Aggregates multiple cache metadata entries into a collection\n   * @param metadataList - Array of cache metadata entries\n   * @returns Aggregated cache metadata collection\n   */\n  static aggregate(metadataList: CacheMetadata[]): CacheMetadataCollection {\n    const totalQueries = metadataList.length;\n    let cacheHits = 0;\n    let totalRowsServed = 0;\n    \n    for (const metadata of metadataList) {\n      if (metadata.hit) {\n        cacheHits++;\n      }\n      \n      if (metadata.rowsServed) {\n        totalRowsServed += metadata.rowsServed;\n      }\n    }\n    \n    const cacheMisses = totalQueries - cacheHits;\n    const cacheHitRate = totalQueries > 0 ? cacheHits / totalQueries : 0;\n    \n    return {\n      totalQueries,\n      cacheHits,\n      cacheMisses,\n      cacheHitRate,\n      totalRowsServed,\n      entries: metadataList\n    };\n  }\n}"],
+  "mappings": "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",
+  "names": []
+}

package/dist/esm/util/cacheMetadataParser.test.mjs

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

package/dist/esm/util/cacheMetadataParser.test.mjs.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/esm/util/cacheValidation.mjs

@@ -0,0 +1,67 @@
+// src/util/cacheValidation.ts
+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");
+    }
+  }
+};
+export {
+  CacheValidation
+};
+//# sourceMappingURL=cacheValidation.mjs.map

package/dist/esm/util/cacheValidation.mjs.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": ";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": []
+}