@trufnetwork/sdk-js 0.3.8 → 0.4.2

package/dist/esm/contracts-api/cache.integration.test.mjs

@@ -0,0 +1,263 @@
+// src/contracts-api/cache.integration.test.ts
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { Action } from "./action.mjs";
+import { EthereumAddress } from "../util/EthereumAddress.mjs";
+import { StreamId } from "../util/StreamId.mjs";
+var mockKwilClient = {
+  call: vi.fn(),
+  execute: vi.fn()
+};
+var mockKwilSigner = {};
+describe("Cache Integration Tests", () => {
+  let action;
+  let streamLocator;
+  beforeEach(() => {
+    action = new Action(mockKwilClient, mockKwilSigner);
+    streamLocator = {
+      streamId: StreamId.fromString("test-stream").unwrap(),
+      dataProvider: new EthereumAddress("0x1234567890123456789012345678901234567890")
+    };
+    vi.clearAllMocks();
+  });
+  describe("getRecord cache functionality", () => {
+    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
+      });
+      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
+      );
+      expect(result).toEqual({
+        data: [
+          { eventTime: 1609459200, value: "100" },
+          { eventTime: 1609459260, value: "101" }
+        ],
+        cache: void 0,
+        logs: ["cache_hit: true", "other log", "cache_miss: false"]
+      });
+    });
+    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
+      });
+      expect(result).toHaveProperty("data");
+      expect(result).toHaveProperty("cache");
+      expect(result).toHaveProperty("logs");
+      expect(result.data).toEqual([
+        { eventTime: 1609459200, value: "100" }
+      ]);
+      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
+      });
+      expect(result.logs).toMatchObject(['{"cache_hit":true,"cache_disabled":false,"cache_height":148670}']);
+    });
+    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
+      });
+      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
+      );
+    });
+    it("should handle error responses", async () => {
+      mockKwilClient.call.mockResolvedValue({
+        status: 500,
+        data: null
+      });
+      await expect(action.getRecord(streamLocator, { useCache: true })).rejects.toThrow("Failed to get record: 500");
+    });
+  });
+  describe("getIndex cache functionality", () => {
+    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
+      });
+      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
+      );
+      expect(result.data).toEqual([
+        { eventTime: 1609459200, value: "100" }
+      ]);
+    });
+  });
+  describe("getFirstRecord cache functionality", () => {
+    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
+      });
+      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
+      );
+      expect(result.data).toEqual({
+        eventTime: 1609459200,
+        value: "100"
+      });
+    });
+    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
+      });
+      expect(result.data).toBeNull();
+    });
+  });
+  describe("getIndexChange cache functionality", () => {
+    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
+      });
+      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
+      );
+      expect(result.data).toEqual([
+        { eventTime: 1609459200, value: "5.2" }
+      ]);
+    });
+    it("should require options parameter for getIndexChange", async () => {
+      await expect(action.getIndexChange(streamLocator)).rejects.toThrow("Options parameter is required for cache-aware getIndexChange");
+    });
+  });
+  describe("parameter validation", () => {
+    it("should validate cache parameters", async () => {
+      await expect(action.getRecord(streamLocator, { useCache: "true" })).rejects.toThrow("Invalid useCache parameter: must be a boolean");
+      await expect(action.getRecord(streamLocator, { from: -1 })).rejects.toThrow("Invalid from parameter: must be a non-negative number");
+      await 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.mjs.map

package/dist/esm/contracts-api/cache.integration.test.mjs.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/esm/contracts-api/composedAction.mjs

@@ -93,6 +93,92 @@ var ComposedAction = class _ComposedAction extends Action {
     });
     return txHash;
   }
+  /**
+   * Lists taxonomies by block height range for incremental synchronization.
+   * Enables efficient detection of taxonomy changes since a specific block height.
+   * 
+   * @param params Height range and pagination parameters
+   * @returns Promise resolving to taxonomy query results
+   * 
+   * @example
+   * ```typescript
+   * const taxonomies = await composedAction.listTaxonomiesByHeight({
+   *   fromHeight: 1000,
+   *   toHeight: 2000,
+   *   limit: 100,
+   *   latestOnly: true
+   * });
+   * ```
+   */
+  async listTaxonomiesByHeight(params = {}) {
+    const result = await this.call(
+      "list_taxonomies_by_height",
+      {
+        $from_height: params.fromHeight ?? null,
+        $to_height: params.toHeight ?? null,
+        $limit: params.limit ?? null,
+        $offset: params.offset ?? null,
+        $latest_only: params.latestOnly ?? null
+      }
+    );
+    return result.mapRight(
+      (records) => records.map((record) => ({
+        dataProvider: EthereumAddress.fromString(record.data_provider).throw(),
+        streamId: StreamId.fromString(record.stream_id).throw(),
+        childDataProvider: EthereumAddress.fromString(record.child_data_provider).throw(),
+        childStreamId: StreamId.fromString(record.child_stream_id).throw(),
+        weight: record.weight,
+        createdAt: record.created_at,
+        groupSequence: record.group_sequence,
+        startTime: record.start_time
+      }))
+    ).throw();
+  }
+  /**
+   * Gets taxonomies for specific streams in batch.
+   * Useful for validating taxonomy data for known streams.
+   * 
+   * @param params Stream locators and filtering options
+   * @returns Promise resolving to taxonomy query results
+   * 
+   * @example
+   * ```typescript
+   * const taxonomies = await composedAction.getTaxonomiesForStreams({
+   *   streams: [
+   *     { dataProvider: provider1, streamId: streamId1 },
+   *     { dataProvider: provider2, streamId: streamId2 }
+   *   ],
+   *   latestOnly: true
+   * });
+   * ```
+   */
+  async getTaxonomiesForStreams(params) {
+    if (!params.streams || params.streams.length === 0) {
+      return [];
+    }
+    const dataProviders = params.streams.map((s) => s.dataProvider.getAddress());
+    const streamIds = params.streams.map((s) => s.streamId.getId());
+    const result = await this.call(
+      "get_taxonomies_for_streams",
+      {
+        $data_providers: dataProviders,
+        $stream_ids: streamIds,
+        $latest_only: params.latestOnly ?? null
+      }
+    );
+    return result.mapRight(
+      (records) => records.map((record) => ({
+        dataProvider: EthereumAddress.fromString(record.data_provider).throw(),
+        streamId: StreamId.fromString(record.stream_id).throw(),
+        childDataProvider: EthereumAddress.fromString(record.child_data_provider).throw(),
+        childStreamId: StreamId.fromString(record.child_stream_id).throw(),
+        weight: record.weight,
+        createdAt: record.created_at,
+        groupSequence: record.group_sequence,
+        startTime: record.start_time
+      }))
+    ).throw();
+  }
   /**
    * Creates a ComposedStream from a base Stream
    * @param stream The base stream to convert

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/contracts-api/composedAction.ts"],
-  "sourcesContent": ["import {KwilSigner, NodeKwil, Utils, WebKwil} from \"@trufnetwork/kwil-js\";\nimport { GenericResponse } from \"@trufnetwork/kwil-js/dist/core/resreq\";\nimport { TxReceipt } from \"@trufnetwork/kwil-js/dist/core/tx\";\nimport { DateString } from \"../types/other\";\nimport { StreamLocator } from \"../types/stream\";\nimport { EthereumAddress } from \"../util/EthereumAddress\";\nimport { StreamId } from \"../util/StreamId\";\nimport { Action } from \"./action\";\nimport DataType = Utils.DataType;\n\nexport const ErrorStreamNotComposed = \"stream is not a composed stream\";\n\nexport interface TaxonomySet {\n  stream: StreamLocator;\n  taxonomyItems: TaxonomyItem[];\n  startDate: number;\n}\n\nexport interface TaxonomyItem {\n  childStream: StreamLocator;\n  weight: string;\n}\n\nexport interface DescribeTaxonomiesParams {\n  stream: StreamLocator;\n  /**\n   * if true, will return the latest version of the taxonomy only\n   */\n  latestGroupSequence: boolean;\n}\n\nexport class ComposedAction extends Action {\n  constructor(\n    kwilClient: WebKwil | NodeKwil,\n    kwilSigner: KwilSigner,\n  ) {\n    super(kwilClient, kwilSigner);\n  }\n\n  /**\n   * Returns the taxonomy of the stream\n   * @param params Parameters for describing taxonomies\n   * @returns A promise that resolves to the taxonomy\n   */\n  public async describeTaxonomies(\n    params: DescribeTaxonomiesParams,\n  ): Promise<TaxonomySet[]> {\n    type TaxonomyResult = {\n      data_provider: string;\n      stream_id: string;\n      child_data_provider: string;\n      child_stream_id: string;\n      weight: string;\n      created_at: number;\n      group_sequence: number;\n      start_date: number;\n    }[];\n\n    const result = await this.call<TaxonomyResult>(\n        \"describe_taxonomies\",\n        {\n            $data_provider: params.stream.dataProvider.getAddress(),\n            $stream_id: params.stream.streamId.getId(),\n            $latest_group_sequence: params.latestGroupSequence,\n        },\n    );\n\n\n\n    return result\n      .mapRight((records) => {\n        const taxonomyItems: Map<DateString, TaxonomyItem[]> = records.reduce(\n          (acc, record) => {\n            const currentArray = acc.get(record.start_date.toString()) || [];\n            currentArray.push({\n              childStream: {\n                streamId: StreamId.fromString(record.child_stream_id).throw(),\n                dataProvider: EthereumAddress.fromString(\n                  record.child_data_provider,\n                ).throw(),\n              },\n              weight: record.weight,\n            });\n            acc.set(record.start_date.toString(), currentArray);\n            return acc;\n          },\n          new Map<DateString, TaxonomyItem[]>(),\n        );\n\n        return Array.from(taxonomyItems.entries()).map(\n          ([startDate, taxonomyItems]) => ({\n            stream: {\n              streamId: StreamId.fromString(records[0].stream_id).throw(),\n              dataProvider: EthereumAddress.fromString(\n                records[0].data_provider,\n              ).throw(),\n            },\n            taxonomyItems,\n            startDate: Number(startDate)\n          }),\n        );\n      })\n      .throw();\n  }\n\n  /**\n   * Sets the taxonomy of the stream\n   * @param taxonomy The taxonomy to set\n   * @returns A promise that resolves to the transaction receipt\n   */\n  public async setTaxonomy(\n    taxonomy: TaxonomySet,\n  ): Promise<GenericResponse<TxReceipt>> {\n    const childDataProviders: string[] = [];\n    const childStreamIds: string[] = [];\n    const weights: string[] = [];\n\n    for (const item of taxonomy.taxonomyItems) {\n      childDataProviders.push(item.childStream.dataProvider\n          .getAddress());\n      childStreamIds.push(item.childStream.streamId.getId());\n      weights.push(item.weight.toString());\n    }\n\n    const txHash = await this.executeWithActionBody({\n        namespace: \"main\",\n        name: \"insert_taxonomy\",\n        inputs: [\n          {\n            $data_provider: taxonomy.stream.dataProvider.getAddress(),\n            $stream_id: taxonomy.stream.streamId.getId(),\n            $child_data_providers: childDataProviders,\n            $child_stream_ids: childStreamIds,\n            $weights: weights,\n            $start_date: taxonomy.startDate\n          },\n        ],\n        types: {\n          $data_provider: DataType.Text,\n          $stream_id: DataType.Text,\n          $child_data_providers: DataType.TextArray,\n          $child_stream_ids: DataType.TextArray,\n          $weights: DataType.NumericArray(36,18),\n          $start_date: DataType.Int\n        }});\n\n    return txHash;\n  }\n\n  /**\n   * Creates a ComposedStream from a base Stream\n   * @param stream The base stream to convert\n   * @returns A ComposedStream instance\n   */\n  public static fromStream(stream: Action): ComposedAction {\n    return new ComposedAction(\n      stream[\"kwilClient\"],\n      stream[\"kwilSigner\"],\n    );\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import {KwilSigner, NodeKwil, Utils, WebKwil} from \"@trufnetwork/kwil-js\";\nimport { GenericResponse } from \"@trufnetwork/kwil-js/dist/core/resreq\";\nimport { TxReceipt } from \"@trufnetwork/kwil-js/dist/core/tx\";\nimport { DateString } from \"../types/other\";\nimport { StreamLocator } from \"../types/stream\";\nimport { EthereumAddress } from \"../util/EthereumAddress\";\nimport { StreamId } from \"../util/StreamId\";\nimport { Action } from \"./action\";\nimport DataType = Utils.DataType;\n\nexport const ErrorStreamNotComposed = \"stream is not a composed stream\";\n\nexport interface TaxonomySet {\n  stream: StreamLocator;\n  taxonomyItems: TaxonomyItem[];\n  startDate: number;\n}\n\nexport interface TaxonomyItem {\n  childStream: StreamLocator;\n  weight: string;\n}\n\nexport interface DescribeTaxonomiesParams {\n  stream: StreamLocator;\n  /**\n   * if true, will return the latest version of the taxonomy only\n   */\n  latestGroupSequence: boolean;\n}\n\nexport interface ListTaxonomiesByHeightParams {\n  /** Start height (inclusive). If null, uses earliest available. */\n  fromHeight?: number;\n  /** End height (inclusive). If null, uses current height. */\n  toHeight?: number;\n  /** Maximum number of results to return. Default: 1000 */\n  limit?: number;\n  /** Number of results to skip for pagination. Default: 0 */\n  offset?: number;\n  /** If true, returns only latest group_sequence per stream. Default: false */\n  latestOnly?: boolean;\n}\n\nexport interface GetTaxonomiesForStreamsParams {\n  /** Array of stream locators to query */\n  streams: StreamLocator[];\n  /** If true, returns only latest group_sequence per stream. Default: false */\n  latestOnly?: boolean;\n}\n\nexport interface TaxonomyQueryResult {\n  /** Parent stream data provider */\n  dataProvider: EthereumAddress;\n  /** Parent stream ID */\n  streamId: StreamId;\n  /** Child stream data provider */\n  childDataProvider: EthereumAddress;\n  /** Child stream ID */\n  childStreamId: StreamId;\n  /** Weight of the child stream in the taxonomy */\n  weight: string;\n  /** Block height when taxonomy was created */\n  createdAt: number;\n  /** Group sequence number for this taxonomy set */\n  groupSequence: number;\n  /** Start time timestamp for this taxonomy */\n  startTime: number;\n}\n\nexport class ComposedAction extends Action {\n  constructor(\n    kwilClient: WebKwil | NodeKwil,\n    kwilSigner: KwilSigner,\n  ) {\n    super(kwilClient, kwilSigner);\n  }\n\n  /**\n   * Returns the taxonomy of the stream\n   * @param params Parameters for describing taxonomies\n   * @returns A promise that resolves to the taxonomy\n   */\n  public async describeTaxonomies(\n    params: DescribeTaxonomiesParams,\n  ): Promise<TaxonomySet[]> {\n    type TaxonomyResult = {\n      data_provider: string;\n      stream_id: string;\n      child_data_provider: string;\n      child_stream_id: string;\n      weight: string;\n      created_at: number;\n      group_sequence: number;\n      start_date: number;\n    }[];\n\n    const result = await this.call<TaxonomyResult>(\n        \"describe_taxonomies\",\n        {\n            $data_provider: params.stream.dataProvider.getAddress(),\n            $stream_id: params.stream.streamId.getId(),\n            $latest_group_sequence: params.latestGroupSequence,\n        },\n    );\n\n\n\n    return result\n      .mapRight((records) => {\n        const taxonomyItems: Map<DateString, TaxonomyItem[]> = records.reduce(\n          (acc, record) => {\n            const currentArray = acc.get(record.start_date.toString()) || [];\n            currentArray.push({\n              childStream: {\n                streamId: StreamId.fromString(record.child_stream_id).throw(),\n                dataProvider: EthereumAddress.fromString(\n                  record.child_data_provider,\n                ).throw(),\n              },\n              weight: record.weight,\n            });\n            acc.set(record.start_date.toString(), currentArray);\n            return acc;\n          },\n          new Map<DateString, TaxonomyItem[]>(),\n        );\n\n        return Array.from(taxonomyItems.entries()).map(\n          ([startDate, taxonomyItems]) => ({\n            stream: {\n              streamId: StreamId.fromString(records[0].stream_id).throw(),\n              dataProvider: EthereumAddress.fromString(\n                records[0].data_provider,\n              ).throw(),\n            },\n            taxonomyItems,\n            startDate: Number(startDate)\n          }),\n        );\n      })\n      .throw();\n  }\n\n  /**\n   * Sets the taxonomy of the stream\n   * @param taxonomy The taxonomy to set\n   * @returns A promise that resolves to the transaction receipt\n   */\n  public async setTaxonomy(\n    taxonomy: TaxonomySet,\n  ): Promise<GenericResponse<TxReceipt>> {\n    const childDataProviders: string[] = [];\n    const childStreamIds: string[] = [];\n    const weights: string[] = [];\n\n    for (const item of taxonomy.taxonomyItems) {\n      childDataProviders.push(item.childStream.dataProvider\n          .getAddress());\n      childStreamIds.push(item.childStream.streamId.getId());\n      weights.push(item.weight.toString());\n    }\n\n    const txHash = await this.executeWithActionBody({\n        namespace: \"main\",\n        name: \"insert_taxonomy\",\n        inputs: [\n          {\n            $data_provider: taxonomy.stream.dataProvider.getAddress(),\n            $stream_id: taxonomy.stream.streamId.getId(),\n            $child_data_providers: childDataProviders,\n            $child_stream_ids: childStreamIds,\n            $weights: weights,\n            $start_date: taxonomy.startDate\n          },\n        ],\n        types: {\n          $data_provider: DataType.Text,\n          $stream_id: DataType.Text,\n          $child_data_providers: DataType.TextArray,\n          $child_stream_ids: DataType.TextArray,\n          $weights: DataType.NumericArray(36,18),\n          $start_date: DataType.Int\n        }});\n\n    return txHash;\n  }\n\n  /**\n   * Lists taxonomies by block height range for incremental synchronization.\n   * Enables efficient detection of taxonomy changes since a specific block height.\n   * \n   * @param params Height range and pagination parameters\n   * @returns Promise resolving to taxonomy query results\n   * \n   * @example\n   * ```typescript\n   * const taxonomies = await composedAction.listTaxonomiesByHeight({\n   *   fromHeight: 1000,\n   *   toHeight: 2000,\n   *   limit: 100,\n   *   latestOnly: true\n   * });\n   * ```\n   */\n  public async listTaxonomiesByHeight(\n    params: ListTaxonomiesByHeightParams = {},\n  ): Promise<TaxonomyQueryResult[]> {\n    type TaxonomyRawResult = {\n      data_provider: string;\n      stream_id: string;\n      child_data_provider: string;\n      child_stream_id: string;\n      weight: string;\n      created_at: number;\n      group_sequence: number;\n      start_time: number;\n    }[];\n\n    const result = await this.call<TaxonomyRawResult>(\n      \"list_taxonomies_by_height\",\n      {\n        $from_height: params.fromHeight ?? null,\n        $to_height: params.toHeight ?? null,\n        $limit: params.limit ?? null,\n        $offset: params.offset ?? null,\n        $latest_only: params.latestOnly ?? null,\n      },\n    );\n\n    return result\n      .mapRight((records) => \n        records.map(record => ({\n          dataProvider: EthereumAddress.fromString(record.data_provider).throw(),\n          streamId: StreamId.fromString(record.stream_id).throw(),\n          childDataProvider: EthereumAddress.fromString(record.child_data_provider).throw(),\n          childStreamId: StreamId.fromString(record.child_stream_id).throw(),\n          weight: record.weight,\n          createdAt: record.created_at,\n          groupSequence: record.group_sequence,\n          startTime: record.start_time,\n        }))\n      )\n      .throw();\n  }\n\n  /**\n   * Gets taxonomies for specific streams in batch.\n   * Useful for validating taxonomy data for known streams.\n   * \n   * @param params Stream locators and filtering options\n   * @returns Promise resolving to taxonomy query results\n   * \n   * @example\n   * ```typescript\n   * const taxonomies = await composedAction.getTaxonomiesForStreams({\n   *   streams: [\n   *     { dataProvider: provider1, streamId: streamId1 },\n   *     { dataProvider: provider2, streamId: streamId2 }\n   *   ],\n   *   latestOnly: true\n   * });\n   * ```\n   */\n  public async getTaxonomiesForStreams(\n    params: GetTaxonomiesForStreamsParams,\n  ): Promise<TaxonomyQueryResult[]> {\n    // Validate input\n    if (!params.streams || params.streams.length === 0) {\n      return [];\n    }\n\n    const dataProviders = params.streams.map(s => s.dataProvider.getAddress());\n    const streamIds = params.streams.map(s => s.streamId.getId());\n\n    type TaxonomyRawResult = {\n      data_provider: string;\n      stream_id: string;\n      child_data_provider: string;\n      child_stream_id: string;\n      weight: string;\n      created_at: number;\n      group_sequence: number;\n      start_time: number;\n    }[];\n\n    const result = await this.call<TaxonomyRawResult>(\n      \"get_taxonomies_for_streams\",\n      {\n        $data_providers: dataProviders,\n        $stream_ids: streamIds,\n        $latest_only: params.latestOnly ?? null,\n      },\n    );\n\n    return result\n      .mapRight((records) => \n        records.map(record => ({\n          dataProvider: EthereumAddress.fromString(record.data_provider).throw(),\n          streamId: StreamId.fromString(record.stream_id).throw(),\n          childDataProvider: EthereumAddress.fromString(record.child_data_provider).throw(),\n          childStreamId: StreamId.fromString(record.child_stream_id).throw(),\n          weight: record.weight,\n          createdAt: record.created_at,\n          groupSequence: record.group_sequence,\n          startTime: record.start_time,\n        }))\n      )\n      .throw();\n  }\n\n  /**\n   * Creates a ComposedStream from a base Stream\n   * @param stream The base stream to convert\n   * @returns A ComposedStream instance\n   */\n  public static fromStream(stream: Action): ComposedAction {\n    return new ComposedAction(\n      stream[\"kwilClient\"],\n      stream[\"kwilSigner\"],\n    );\n  }\n}\n"],
+  "mappings": "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",
   "names": ["taxonomyItems"]
 }