@trufnetwork/sdk-js 0.3.8 → 0.4.1

package/dist/cjs/contracts-api/cache.integration.test.cjs

@@ -0,0 +1,265 @@
+"use strict";
+
+// src/contracts-api/cache.integration.test.ts
+var import_vitest = require("vitest");
+var import_action = require("./action.cjs");
+var import_EthereumAddress = require("../util/EthereumAddress.cjs");
+var import_StreamId = require("../util/StreamId.cjs");
+var mockKwilClient = {
+  call: import_vitest.vi.fn(),
+  execute: import_vitest.vi.fn()
+};
+var mockKwilSigner = {};
+(0, import_vitest.describe)("Cache Integration Tests", () => {
+  let action;
+  let streamLocator;
+  (0, import_vitest.beforeEach)(() => {
+    action = new import_action.Action(mockKwilClient, mockKwilSigner);
+    streamLocator = {
+      streamId: import_StreamId.StreamId.fromString("test-stream").unwrap(),
+      dataProvider: new import_EthereumAddress.EthereumAddress("0x1234567890123456789012345678901234567890")
+    };
+    import_vitest.vi.clearAllMocks();
+  });
+  (0, import_vitest.describe)("getRecord cache functionality", () => {
+    (0, import_vitest.it)("should handle cache-aware getRecord call", async () => {
+      const mockResponse = {
+        status: 200,
+        data: {
+          result: [
+            { event_time: 1609459200, value: "100" },
+            { event_time: 1609459260, value: "101" }
+          ],
+          logs: "1. cache_hit: true\n2. other log\n111. cache_miss: false"
+        }
+      };
+      mockKwilClient.call.mockResolvedValue(mockResponse);
+      const result = await action.getRecord(streamLocator, {
+        from: 1609459200,
+        to: 1609459300,
+        useCache: true
+      });
+      (0, import_vitest.expect)(mockKwilClient.call).toHaveBeenCalledWith(
+        {
+          namespace: "main",
+          name: "get_record",
+          inputs: {
+            $data_provider: "0x1234567890123456789012345678901234567890",
+            $stream_id: "test-stream",
+            $from: 1609459200,
+            $to: 1609459300,
+            $frozen_at: void 0,
+            $use_cache: true
+          }
+        },
+        mockKwilSigner
+      );
+      (0, import_vitest.expect)(result).toEqual({
+        data: [
+          { eventTime: 1609459200, value: "100" },
+          { eventTime: 1609459260, value: "101" }
+        ],
+        cache: void 0,
+        logs: ["cache_hit: true", "other log", "cache_miss: false"]
+      });
+    });
+    (0, import_vitest.it)("should handle cache-aware getRecord call with cache metadata", async () => {
+      const mockResponse = {
+        status: 200,
+        data: {
+          result: [
+            { event_time: 1609459200, value: "100" }
+          ],
+          logs: '1. {"cache_hit":true,"cache_disabled":false,"cache_height":148670}'
+        }
+      };
+      mockKwilClient.call.mockResolvedValue(mockResponse);
+      const result = await action.getRecord(streamLocator, {
+        useCache: true
+      });
+      (0, import_vitest.expect)(result).toHaveProperty("data");
+      (0, import_vitest.expect)(result).toHaveProperty("cache");
+      (0, import_vitest.expect)(result).toHaveProperty("logs");
+      (0, import_vitest.expect)(result.data).toEqual([
+        { eventTime: 1609459200, value: "100" }
+      ]);
+      (0, import_vitest.expect)(result.cache).toMatchObject({
+        hit: true,
+        cacheDisabled: false,
+        height: 148670,
+        dataProvider: "0x1234567890123456789012345678901234567890",
+        from: void 0,
+        frozenAt: void 0,
+        rowsServed: 1,
+        streamId: "test-stream",
+        to: void 0
+      });
+      (0, import_vitest.expect)(result.logs).toMatchObject(['{"cache_hit":true,"cache_disabled":false,"cache_height":148670}']);
+    });
+    (0, import_vitest.it)("should omit useCache parameter when not provided", async () => {
+      const mockResponse = {
+        status: 200,
+        data: { result: [] }
+      };
+      mockKwilClient.call.mockResolvedValue(mockResponse);
+      await action.getRecord(streamLocator, {
+        from: 1609459200
+      });
+      (0, import_vitest.expect)(mockKwilClient.call).toHaveBeenCalledWith(
+        {
+          namespace: "main",
+          name: "get_record",
+          inputs: {
+            $data_provider: "0x1234567890123456789012345678901234567890",
+            $stream_id: "test-stream",
+            $from: 1609459200,
+            $to: void 0,
+            $frozen_at: void 0
+          }
+        },
+        mockKwilSigner
+      );
+    });
+    (0, import_vitest.it)("should handle error responses", async () => {
+      mockKwilClient.call.mockResolvedValue({
+        status: 500,
+        data: null
+      });
+      await (0, import_vitest.expect)(action.getRecord(streamLocator, { useCache: true })).rejects.toThrow("Failed to get record: 500");
+    });
+  });
+  (0, import_vitest.describe)("getIndex cache functionality", () => {
+    (0, import_vitest.it)("should handle cache-aware getIndex call", async () => {
+      const mockResponse = {
+        status: 200,
+        data: {
+          result: [
+            { event_time: 1609459200, value: "100" }
+          ]
+        }
+      };
+      mockKwilClient.call.mockResolvedValue(mockResponse);
+      const result = await action.getIndex(streamLocator, {
+        from: 1609459200,
+        to: 1609459300,
+        baseTime: 1609459180,
+        useCache: true
+      });
+      (0, import_vitest.expect)(mockKwilClient.call).toHaveBeenCalledWith(
+        {
+          namespace: "main",
+          name: "get_index",
+          inputs: {
+            $data_provider: "0x1234567890123456789012345678901234567890",
+            $stream_id: "test-stream",
+            $from: 1609459200,
+            $to: 1609459300,
+            $frozen_at: void 0,
+            $base_time: 1609459180,
+            $use_cache: true
+          }
+        },
+        mockKwilSigner
+      );
+      (0, import_vitest.expect)(result.data).toEqual([
+        { eventTime: 1609459200, value: "100" }
+      ]);
+    });
+  });
+  (0, import_vitest.describe)("getFirstRecord cache functionality", () => {
+    (0, import_vitest.it)("should handle cache-aware getFirstRecord call", async () => {
+      const mockResponse = {
+        status: 200,
+        data: {
+          result: [
+            { event_time: 1609459200, value: "100" }
+          ]
+        }
+      };
+      mockKwilClient.call.mockResolvedValue(mockResponse);
+      const result = await action.getFirstRecord(streamLocator, {
+        after: 1609459180,
+        useCache: true
+      });
+      (0, import_vitest.expect)(mockKwilClient.call).toHaveBeenCalledWith(
+        {
+          namespace: "main",
+          name: "get_first_record",
+          inputs: {
+            $data_provider: "0x1234567890123456789012345678901234567890",
+            $stream_id: "test-stream",
+            $after: 1609459180,
+            $frozen_at: void 0,
+            $use_cache: true
+          }
+        },
+        mockKwilSigner
+      );
+      (0, import_vitest.expect)(result.data).toEqual({
+        eventTime: 1609459200,
+        value: "100"
+      });
+    });
+    (0, import_vitest.it)("should handle empty result for getFirstRecord", async () => {
+      const mockResponse = {
+        status: 200,
+        data: { result: [] }
+      };
+      mockKwilClient.call.mockResolvedValue(mockResponse);
+      const result = await action.getFirstRecord(streamLocator, {
+        useCache: true
+      });
+      (0, import_vitest.expect)(result.data).toBeNull();
+    });
+  });
+  (0, import_vitest.describe)("getIndexChange cache functionality", () => {
+    (0, import_vitest.it)("should handle cache-aware getIndexChange call", async () => {
+      const mockResponse = {
+        status: 200,
+        data: {
+          result: [
+            { event_time: 1609459200, value: "5.2" }
+          ]
+        }
+      };
+      mockKwilClient.call.mockResolvedValue(mockResponse);
+      const result = await action.getIndexChange(streamLocator, {
+        from: 1609459200,
+        to: 1609459300,
+        timeInterval: 60,
+        useCache: true
+      });
+      (0, import_vitest.expect)(mockKwilClient.call).toHaveBeenCalledWith(
+        {
+          namespace: "main",
+          name: "get_index_change",
+          inputs: {
+            $data_provider: "0x1234567890123456789012345678901234567890",
+            $stream_id: "test-stream",
+            $from: 1609459200,
+            $to: 1609459300,
+            $frozen_at: void 0,
+            $base_time: void 0,
+            $time_interval: 60,
+            $use_cache: true
+          }
+        },
+        mockKwilSigner
+      );
+      (0, import_vitest.expect)(result.data).toEqual([
+        { eventTime: 1609459200, value: "5.2" }
+      ]);
+    });
+    (0, import_vitest.it)("should require options parameter for getIndexChange", async () => {
+      await (0, import_vitest.expect)(action.getIndexChange(streamLocator)).rejects.toThrow("Options parameter is required for cache-aware getIndexChange");
+    });
+  });
+  (0, import_vitest.describe)("parameter validation", () => {
+    (0, import_vitest.it)("should validate cache parameters", async () => {
+      await (0, import_vitest.expect)(action.getRecord(streamLocator, { useCache: "true" })).rejects.toThrow("Invalid useCache parameter: must be a boolean");
+      await (0, import_vitest.expect)(action.getRecord(streamLocator, { from: -1 })).rejects.toThrow("Invalid from parameter: must be a non-negative number");
+      await (0, import_vitest.expect)(action.getRecord(streamLocator, { from: 100, to: 50 })).rejects.toThrow("Invalid time range: from time cannot be greater than to time");
+    });
+  });
+});
+//# sourceMappingURL=cache.integration.test.cjs.map

package/dist/cjs/contracts-api/cache.integration.test.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/contracts-api/cache.integration.test.ts"],
+  "sourcesContent": ["import { describe, it, expect, vi, beforeEach } from 'vitest';\nimport { Action } from './action';\nimport { EthereumAddress } from '../util/EthereumAddress';\nimport { StreamId } from '../util/StreamId';\nimport type { StreamLocator } from '../types/stream';\nimport { CacheMetadata } from '../types/cache';\n\n// Mock Kwil client\nconst mockKwilClient = {\n  call: vi.fn(),\n  execute: vi.fn()\n};\n\nconst mockKwilSigner = {};\n\ndescribe('Cache Integration Tests', () => {\n  let action: Action;\n  let streamLocator: StreamLocator;\n\n  beforeEach(() => {\n    action = new Action(mockKwilClient as any, mockKwilSigner as any);\n    streamLocator = {\n      streamId: StreamId.fromString('test-stream').unwrap(),\n      dataProvider: new EthereumAddress('0x1234567890123456789012345678901234567890')\n    };\n    \n    // Reset mocks\n    vi.clearAllMocks();\n  });\n\n  describe('getRecord cache functionality', () => {\n    it('should handle cache-aware getRecord call', async () => {\n      const mockResponse = {\n        status: 200,\n        data: {\n          result: [\n            { event_time: 1609459200, value: '100' },\n            { event_time: 1609459260, value: '101' }\n          ],\n          logs: '1. cache_hit: true\\n2. other log\\n111. cache_miss: false'\n        }\n      };\n\n      mockKwilClient.call.mockResolvedValue(mockResponse);\n\n      const result = await action.getRecord(streamLocator, {\n        from: 1609459200,\n        to: 1609459300,\n        useCache: true\n      });\n\n      expect(mockKwilClient.call).toHaveBeenCalledWith(\n        {\n          namespace: 'main',\n          name: 'get_record',\n          inputs: {\n            $data_provider: '0x1234567890123456789012345678901234567890',\n            $stream_id: 'test-stream',\n            $from: 1609459200,\n            $to: 1609459300,\n            $frozen_at: undefined,\n            $use_cache: true\n          }\n        },\n        mockKwilSigner\n      );\n\n      expect(result).toEqual({\n        data: [\n          { eventTime: 1609459200, value: '100' },\n          { eventTime: 1609459260, value: '101' }\n        ],\n        cache: undefined,\n        logs: ['cache_hit: true', 'other log', 'cache_miss: false']\n      });\n    });\n\n    it('should handle cache-aware getRecord call with cache metadata', async () => {\n      const mockResponse = {\n        status: 200,\n        data: {\n          result: [\n            { event_time: 1609459200, value: '100' }\n          ],\n          logs: '1. {\"cache_hit\":true,\"cache_disabled\":false,\"cache_height\":148670}'\n        }\n      };\n\n      mockKwilClient.call.mockResolvedValue(mockResponse);\n\n      const result = await action.getRecord(streamLocator, {\n        useCache: true\n      });\n\n      // Cache metadata extraction happens in the parser\n      // We'll just verify the structure is correct\n      expect(result).toHaveProperty('data');\n      expect(result).toHaveProperty('cache');\n      expect(result).toHaveProperty('logs');\n      expect(result.data).toEqual([\n        { eventTime: 1609459200, value: '100' }\n      ]);\n\n      expect(result.cache).toMatchObject({\n        hit: true,\n        cacheDisabled: false,\n        height: 148670,\n        dataProvider: '0x1234567890123456789012345678901234567890',\n        from: undefined,\n        frozenAt: undefined,\n        rowsServed: 1,\n        streamId: 'test-stream',\n        to: undefined\n      } as CacheMetadata);\n\n      expect(result.logs).toMatchObject(['{\"cache_hit\":true,\"cache_disabled\":false,\"cache_height\":148670}']);\n    });\n\n    it('should omit useCache parameter when not provided', async () => {\n      const mockResponse = {\n        status: 200,\n        data: { result: [] }\n      };\n\n      mockKwilClient.call.mockResolvedValue(mockResponse);\n\n      await action.getRecord(streamLocator, {\n        from: 1609459200\n      });\n\n      expect(mockKwilClient.call).toHaveBeenCalledWith(\n        {\n          namespace: 'main',\n          name: 'get_record',\n          inputs: {\n            $data_provider: '0x1234567890123456789012345678901234567890',\n            $stream_id: 'test-stream',\n            $from: 1609459200,\n            $to: undefined,\n            $frozen_at: undefined\n          }\n        },\n        mockKwilSigner\n      );\n    });\n\n    it('should handle error responses', async () => {\n      mockKwilClient.call.mockResolvedValue({\n        status: 500,\n        data: null\n      });\n\n      await expect(action.getRecord(streamLocator, { useCache: true }))\n        .rejects.toThrow('Failed to get record: 500');\n    });\n  });\n\n  describe('getIndex cache functionality', () => {\n    it('should handle cache-aware getIndex call', async () => {\n      const mockResponse = {\n        status: 200,\n        data: {\n          result: [\n            { event_time: 1609459200, value: '100' }\n          ]\n        }\n      };\n\n      mockKwilClient.call.mockResolvedValue(mockResponse);\n\n      const result = await action.getIndex(streamLocator, {\n        from: 1609459200,\n        to: 1609459300,\n        baseTime: 1609459180,\n        useCache: true\n      });\n\n      expect(mockKwilClient.call).toHaveBeenCalledWith(\n        {\n          namespace: 'main',\n          name: 'get_index',\n          inputs: {\n            $data_provider: '0x1234567890123456789012345678901234567890',\n            $stream_id: 'test-stream',\n            $from: 1609459200,\n            $to: 1609459300,\n            $frozen_at: undefined,\n            $base_time: 1609459180,\n            $use_cache: true\n          }\n        },\n        mockKwilSigner\n      );\n\n      expect(result.data).toEqual([\n        { eventTime: 1609459200, value: '100' }\n      ]);\n    });\n  });\n\n  describe('getFirstRecord cache functionality', () => {\n    it('should handle cache-aware getFirstRecord call', async () => {\n      const mockResponse = {\n        status: 200,\n        data: {\n          result: [\n            { event_time: 1609459200, value: '100' }\n          ]\n        }\n      };\n\n      mockKwilClient.call.mockResolvedValue(mockResponse);\n\n      const result = await action.getFirstRecord(streamLocator, {\n        after: 1609459180,\n        useCache: true\n      });\n\n      expect(mockKwilClient.call).toHaveBeenCalledWith(\n        {\n          namespace: 'main',\n          name: 'get_first_record',\n          inputs: {\n            $data_provider: '0x1234567890123456789012345678901234567890',\n            $stream_id: 'test-stream',\n            $after: 1609459180,\n            $frozen_at: undefined,\n            $use_cache: true\n          }\n        },\n        mockKwilSigner\n      );\n\n      expect(result.data).toEqual({\n        eventTime: 1609459200,\n        value: '100'\n      });\n    });\n\n    it('should handle empty result for getFirstRecord', async () => {\n      const mockResponse = {\n        status: 200,\n        data: { result: [] }\n      };\n\n      mockKwilClient.call.mockResolvedValue(mockResponse);\n\n      const result = await action.getFirstRecord(streamLocator, {\n        useCache: true\n      });\n\n      expect(result.data).toBeNull();\n    });\n  });\n\n  describe('getIndexChange cache functionality', () => {\n    it('should handle cache-aware getIndexChange call', async () => {\n      const mockResponse = {\n        status: 200,\n        data: {\n          result: [\n            { event_time: 1609459200, value: '5.2' }\n          ]\n        }\n      };\n\n      mockKwilClient.call.mockResolvedValue(mockResponse);\n\n      const result = await action.getIndexChange(streamLocator, {\n        from: 1609459200,\n        to: 1609459300,\n        timeInterval: 60,\n        useCache: true\n      });\n\n      expect(mockKwilClient.call).toHaveBeenCalledWith(\n        {\n          namespace: 'main',\n          name: 'get_index_change',\n          inputs: {\n            $data_provider: '0x1234567890123456789012345678901234567890',\n            $stream_id: 'test-stream',\n            $from: 1609459200,\n            $to: 1609459300,\n            $frozen_at: undefined,\n            $base_time: undefined,\n            $time_interval: 60,\n            $use_cache: true\n          }\n        },\n        mockKwilSigner\n      );\n\n      expect(result.data).toEqual([\n        { eventTime: 1609459200, value: '5.2' }\n      ]);\n    });\n\n    it('should require options parameter for getIndexChange', async () => {\n      await expect((action.getIndexChange as any)(streamLocator))\n        .rejects.toThrow('Options parameter is required for cache-aware getIndexChange');\n    });\n  });\n\n  describe('parameter validation', () => {\n    it('should validate cache parameters', async () => {\n      await expect(action.getRecord(streamLocator, { useCache: 'true' as any }))\n        .rejects.toThrow('Invalid useCache parameter: must be a boolean');\n\n      await expect(action.getRecord(streamLocator, { from: -1 }))\n        .rejects.toThrow('Invalid from parameter: must be a non-negative number');\n\n      await expect(action.getRecord(streamLocator, { from: 100, to: 50 }))\n        .rejects.toThrow('Invalid time range: from time cannot be greater than to time');\n    });\n  });\n});"],
+  "mappings": "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",
+  "names": []
+}

package/dist/cjs/types/cache.cjs

@@ -0,0 +1,34 @@
+"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/types/cache.ts
+var cache_exports = {};
+__export(cache_exports, {
+  CacheError: () => CacheError
+});
+module.exports = __toCommonJS(cache_exports);
+var CacheError = class _CacheError extends Error {
+  constructor(message, cause) {
+    super(message);
+    this.cause = cause;
+    this.name = "CacheError";
+    Object.setPrototypeOf(this, _CacheError.prototype);
+  }
+};
+//# sourceMappingURL=cache.cjs.map

package/dist/cjs/types/cache.cjs.map

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

package/dist/cjs/types/cache.test.cjs

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

package/dist/cjs/types/cache.test.cjs.map

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