@trufnetwork/sdk-js 0.4.1 → 0.4.2

package/dist/types/contracts-api/composedAction.d.ts

@@ -2,6 +2,8 @@ import { KwilSigner, NodeKwil, WebKwil } from "@trufnetwork/kwil-js";
 import { GenericResponse } from "@trufnetwork/kwil-js/dist/core/resreq";
 import { TxReceipt } from "@trufnetwork/kwil-js/dist/core/tx";
 import { StreamLocator } from "../types/stream";
+import { EthereumAddress } from "../util/EthereumAddress";
+import { StreamId } from "../util/StreamId";
 import { Action } from "./action";
 export declare const ErrorStreamNotComposed = "stream is not a composed stream";
 export interface TaxonomySet {
@@ -20,6 +22,42 @@ export interface DescribeTaxonomiesParams {
      */
     latestGroupSequence: boolean;
 }
+export interface ListTaxonomiesByHeightParams {
+    /** Start height (inclusive). If null, uses earliest available. */
+    fromHeight?: number;
+    /** End height (inclusive). If null, uses current height. */
+    toHeight?: number;
+    /** Maximum number of results to return. Default: 1000 */
+    limit?: number;
+    /** Number of results to skip for pagination. Default: 0 */
+    offset?: number;
+    /** If true, returns only latest group_sequence per stream. Default: false */
+    latestOnly?: boolean;
+}
+export interface GetTaxonomiesForStreamsParams {
+    /** Array of stream locators to query */
+    streams: StreamLocator[];
+    /** If true, returns only latest group_sequence per stream. Default: false */
+    latestOnly?: boolean;
+}
+export interface TaxonomyQueryResult {
+    /** Parent stream data provider */
+    dataProvider: EthereumAddress;
+    /** Parent stream ID */
+    streamId: StreamId;
+    /** Child stream data provider */
+    childDataProvider: EthereumAddress;
+    /** Child stream ID */
+    childStreamId: StreamId;
+    /** Weight of the child stream in the taxonomy */
+    weight: string;
+    /** Block height when taxonomy was created */
+    createdAt: number;
+    /** Group sequence number for this taxonomy set */
+    groupSequence: number;
+    /** Start time timestamp for this taxonomy */
+    startTime: number;
+}
 export declare class ComposedAction extends Action {
     constructor(kwilClient: WebKwil | NodeKwil, kwilSigner: KwilSigner);
     /**
@@ -34,6 +72,43 @@ export declare class ComposedAction extends Action {
      * @returns A promise that resolves to the transaction receipt
      */
     setTaxonomy(taxonomy: TaxonomySet): Promise<GenericResponse<TxReceipt>>;
+    /**
+     * 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
+     * });
+     * ```
+     */
+    listTaxonomiesByHeight(params?: ListTaxonomiesByHeightParams): Promise<TaxonomyQueryResult[]>;
+    /**
+     * 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
+     * });
+     * ```
+     */
+    getTaxonomiesForStreams(params: GetTaxonomiesForStreamsParams): Promise<TaxonomyQueryResult[]>;
     /**
      * Creates a ComposedStream from a base Stream
      * @param stream The base stream to convert

package/dist/types/contracts-api/composedAction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"composedAction.d.ts","sourceRoot":"","sources":["../../../src/contracts-api/composedAction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAE,QAAQ,EAAS,OAAO,EAAC,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAE9D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGlC,eAAO,MAAM,sBAAsB,oCAAoC,CAAC;AAExE,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,aAAa,CAAC;IACtB,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,aAAa,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,aAAa,CAAC;IACtB;;OAEG;IACH,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED,qBAAa,cAAe,SAAQ,MAAM;gBAEtC,UAAU,EAAE,OAAO,GAAG,QAAQ,EAC9B,UAAU,EAAE,UAAU;IAKxB;;;;OAIG;IACU,kBAAkB,CAC7B,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC,WAAW,EAAE,CAAC;IA2DzB;;;;OAIG;IACU,WAAW,CACtB,QAAQ,EAAE,WAAW,GACpB,OAAO,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;IAqCtC;;;;OAIG;WACW,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc;CAMzD"}
+{"version":3,"file":"composedAction.d.ts","sourceRoot":"","sources":["../../../src/contracts-api/composedAction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAE,QAAQ,EAAS,OAAO,EAAC,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAE9D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGlC,eAAO,MAAM,sBAAsB,oCAAoC,CAAC;AAExE,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,aAAa,CAAC;IACtB,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,aAAa,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,aAAa,CAAC;IACtB;;OAEG;IACH,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,4BAA4B;IAC3C,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,6BAA6B;IAC5C,wCAAwC;IACxC,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,kCAAkC;IAClC,YAAY,EAAE,eAAe,CAAC;IAC9B,uBAAuB;IACvB,QAAQ,EAAE,QAAQ,CAAC;IACnB,iCAAiC;IACjC,iBAAiB,EAAE,eAAe,CAAC;IACnC,sBAAsB;IACtB,aAAa,EAAE,QAAQ,CAAC;IACxB,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,aAAa,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,cAAe,SAAQ,MAAM;gBAEtC,UAAU,EAAE,OAAO,GAAG,QAAQ,EAC9B,UAAU,EAAE,UAAU;IAKxB;;;;OAIG;IACU,kBAAkB,CAC7B,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC,WAAW,EAAE,CAAC;IA2DzB;;;;OAIG;IACU,WAAW,CACtB,QAAQ,EAAE,WAAW,GACpB,OAAO,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;IAqCtC;;;;;;;;;;;;;;;;OAgBG;IACU,sBAAsB,CACjC,MAAM,GAAE,4BAAiC,GACxC,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAuCjC;;;;;;;;;;;;;;;;;OAiBG;IACU,uBAAuB,CAClC,MAAM,EAAE,6BAA6B,GACpC,OAAO,CAAC,mBAAmB,EAAE,CAAC;IA6CjC;;;;OAIG;WACW,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc;CAMzD"}

package/dist/types/contracts-api/composedAction.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=composedAction.test.d.ts.map

package/dist/types/contracts-api/composedAction.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composedAction.test.d.ts","sourceRoot":"","sources":["../../../src/contracts-api/composedAction.test.ts"],"names":[],"mappings":""}

package/dist/types/index.common.d.ts

@@ -4,7 +4,7 @@ export type { StreamLocator } from "./types/stream";
 export type { StreamRecord } from "./contracts-api/action";
 export type { GetRecordInput, GetFirstRecordInput } from "./contracts-api/action";
 export type { InsertRecordInput } from "./contracts-api/primitiveAction";
-export type { TaxonomySet, TaxonomyItem } from "./contracts-api/composedAction";
+export type { TaxonomySet, TaxonomyItem, ListTaxonomiesByHeightParams, GetTaxonomiesForStreamsParams, TaxonomyQueryResult } from "./contracts-api/composedAction";
 export { StreamId } from "./util/StreamId";
 export { EthereumAddress } from "./util/EthereumAddress";
 export { visibility } from "./util/visibility";

package/dist/types/index.common.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.common.d.ts","sourceRoot":"","sources":["../../src/index.common.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,YAAY,EAAE,UAAU,IAAI,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGjE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClF,YAAY,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACzE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAGhF,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAG5D,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAGhE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.common.d.ts","sourceRoot":"","sources":["../../src/index.common.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,YAAY,EAAE,UAAU,IAAI,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGjE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClF,YAAY,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACzE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,4BAA4B,EAAE,6BAA6B,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAGlK,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAG5D,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAGhE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trufnetwork/sdk-js",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "TRUF.NETWORK SDK for JavaScript/TypeScript",
   "type": "module",
   "keywords": [