@trufnetwork/sdk-js 0.3.8 → 0.4.2

package/dist/cjs/contracts-api/action.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/contracts-api/action.ts"],
-  "sourcesContent": ["import {KwilSigner, NodeKwil, WebKwil} from \"@trufnetwork/kwil-js\";\nimport { ActionBody } from '@trufnetwork/kwil-js/dist/core/action';\nimport {NamedParams} from \"@trufnetwork/kwil-js/dist/core/action\";\nimport { GenericResponse } from \"@trufnetwork/kwil-js/dist/core/resreq\";\nimport { TxReceipt } from \"@trufnetwork/kwil-js/dist/core/tx\";\nimport { Either } from \"monads-io\";\nimport { DateString } from \"../types/other\";\nimport { StreamLocator } from \"../types/stream\";\nimport { EthereumAddress } from \"../util/EthereumAddress\";\nimport { head } from \"../util/head\";\nimport { StreamId } from \"../util/StreamId\";\nimport { toVisibilityEnum, VisibilityEnum } from \"../util/visibility\";\nimport {\n  MetadataKey,\n  MetadataKeyValueMap,\n  MetadataTableKey,\n  MetadataValueTypeForKey,\n  StreamType,\n} from \"./contractValues\";\nimport {ValueType} from \"@trufnetwork/kwil-js/dist/utils/types\";\n\nexport interface GetRecordInput {\n  stream: StreamLocator;\n  from?: number;\n  to?: number;\n  frozenAt?: number;\n  baseTime?: DateString | number;\n  prefix?: string;\n}\n\nexport interface GetFirstRecordInput {\n  stream: StreamLocator;\n  after?: number;\n  frozenAt?: number;\n}\n\nexport interface StreamRecord {\n  eventTime: number;\n  value: string;\n}\n\nexport interface GetIndexChangeInput extends GetRecordInput {\n  timeInterval: number;\n}\n\nexport class Action {\n  protected kwilClient: WebKwil | NodeKwil;\n  protected kwilSigner: KwilSigner;\n  constructor(\n    kwilClient: WebKwil | NodeKwil,\n    kwilSigner: KwilSigner,\n  ) {\n    this.kwilClient = kwilClient;\n    this.kwilSigner = kwilSigner;\n  }\n\n  /**\n   * Executes a method on the stream\n   */\n  protected async executeWithNamedParams(\n    method: string,\n    inputs: NamedParams[],\n  ): Promise<GenericResponse<TxReceipt>> {\n    return this.kwilClient.execute({\n          namespace: \"main\",\n          name: method,\n          inputs,\n          description: `TN SDK - Executing method on stream: ${method}`,\n        },\n        this.kwilSigner,\n        );\n  }\n\n    /**\n     * Executes a method on the stream\n     */\n    protected async executeWithActionBody(\n        inputs: ActionBody,\n        synchronous: boolean = false,\n    ): Promise<GenericResponse<TxReceipt>> {\n        return this.kwilClient.execute(inputs, this.kwilSigner, synchronous);\n    }\n\n  /**\n   * Calls a method on the stream\n   */\n  protected async call<T>(\n    method: string,\n    inputs: NamedParams,\n  ): Promise<Either<number, T>> {\n    const result = await this.kwilClient.call(\n      {\n        namespace: \"main\",\n        name: method,\n        inputs: inputs,\n      },\n      this.kwilSigner,\n    );\n\n    if (result.status !== 200) {\n      return Either.left(result.status);\n    }\n\n    return Either.right(result.data?.result as T);\n  }\n\n  /**\n   * Returns the records of the stream within the given date range\n   */\n  public async getRecord(input: GetRecordInput): Promise<StreamRecord[]> {\n    const prefix = input.prefix ? input.prefix : \"\"\n    const result = await this.call<{ event_time: number; value: string }[]>(\n        prefix + \"get_record\",\n        {\n          $data_provider: input.stream.dataProvider.getAddress(),\n          $stream_id: input.stream.streamId.getId(),\n          $from: input.from,\n          $to: input.to,\n          $frozen_at: input.frozenAt,\n        }\n    );\n    return result\n      .mapRight((result) =>\n        result.map((row) => ({\n          eventTime: row.event_time,\n          value: row.value,\n        })),\n      )\n      .throw();\n  }\n\n  /**\n   * Returns the index of the stream within the given date range\n   */\n  public async getIndex(input: GetRecordInput): Promise<StreamRecord[]> {\n    const prefix = input.prefix ? input.prefix : \"\"\n    const result = await this.call<{ event_time: number; value: string }[]>(\n      prefix + \"get_index\",\n        {\n          $data_provider: input.stream.dataProvider.getAddress(),\n          $stream_id: input.stream.streamId.getId(),\n          $from: input.from,\n          $to: input.to,\n          $frozen_at: input.frozenAt,\n          $base_time: input.baseTime,\n        }\n    );\n    return result\n      .mapRight((result) =>\n        result.map((row) => ({\n          eventTime: row.event_time,\n          value: row.value,\n        })),\n      )\n      .throw();\n  }\n\n  /**\n   * Returns the type of the stream\n   */\n  public async getType(\n      stream: StreamLocator,\n  ): Promise<StreamType> {\n    const result = await this.getMetadata(\n        stream,\n        MetadataKey.TypeKey);\n\n    if (!result) {\n      throw new Error(\"Failed to get stream type\");\n    }\n\n    const type = head(result).unwrapOrElse(() => {\n      throw new Error(\n        \"Failed to get stream type. Check if the stream is initialized.\",\n      );\n    });\n\n    const validTypes = [StreamType.Primitive, StreamType.Composed];\n\n    if (!validTypes.includes(type.value as StreamType)) {\n      throw new Error(`Invalid stream type: ${type.value}`);\n    }\n\n    return type.value as StreamType;\n  }\n\n  /**\n   * Returns the first record of the stream\n   */\n  public async getFirstRecord(\n    input: GetFirstRecordInput,\n  ): Promise<StreamRecord | null> {\n    const result = await this.call<{ event_time: number; value: string }[]>(\n      \"get_first_record\",\n        {\n            $data_provider: input.stream.dataProvider.getAddress(),\n            $stream_id: input.stream.streamId.getId(),\n            $after: input.after,\n            $frozen_at: input.frozenAt,\n        }\n    );\n\n    return result\n      .mapRight(head)\n      .mapRight((result) =>\n        result\n          .map((result) => ({\n            eventTime: result.event_time,\n            value: result.value,\n          }))\n          .unwrapOr(null),\n      )\n      .throw();\n  }\n\n  protected async setMetadata<K extends MetadataKey>(\n    stream: StreamLocator,\n    key: K,\n    value: MetadataValueTypeForKey<K>,\n  ): Promise<GenericResponse<TxReceipt>> {\n    return await this.executeWithNamedParams(\"insert_metadata\", [{\n        $data_provider: stream.dataProvider.getAddress(),\n        $stream_id: stream.streamId.getId(),\n        $key: key,\n        $value: value,\n        $val_type: MetadataKeyValueMap[key],\n        },\n    ]);\n  }\n\n  protected async getMetadata<K extends MetadataKey>(\n    stream: StreamLocator,\n    key: K,\n    // onlyLatest: boolean = true,\n    filteredRef?: string,\n    limit?: number,\n    offset?: number,\n    orderBy?: string,\n  ): Promise<\n    { rowId: string; value: MetadataValueTypeForKey<K>; createdAt: number }[]\n  > {\n    const result = await this.call<\n      {\n        row_id: string;\n        value_i: number;\n        value_f: string;\n        value_b: boolean;\n        value_s: string;\n        value_ref: string;\n        created_at: number;\n      }[]\n    >(\"get_metadata\", {\n        $data_provider: stream.dataProvider.getAddress(),\n        $stream_id: stream.streamId.getId(),\n        $key: key,\n        $ref: filteredRef,\n        $limit: limit,\n        $offset: offset,\n        $order_by: orderBy,\n        },\n    );\n    return result\n      .mapRight((result) =>\n        result.map((row) => ({\n          rowId: row.row_id,\n          value: row[\n            MetadataTableKey[MetadataKeyValueMap[key as MetadataKey]]\n          ] as MetadataValueTypeForKey<K>,\n          createdAt: row.created_at,\n        })),\n      )\n      .throw();\n  }\n\n  /**\n   * Sets the read visibility of the stream\n   */\n  public async setReadVisibility(\n    stream: StreamLocator,\n    visibility: VisibilityEnum,\n  ): Promise<GenericResponse<TxReceipt>> {\n    return await this.setMetadata(\n        stream,\n      MetadataKey.ReadVisibilityKey,\n      visibility.toString(),\n    );\n  }\n\n  /**\n   * Returns the read visibility of the stream\n   */\n  public async getReadVisibility(\n      stream: StreamLocator,\n  ): Promise<VisibilityEnum | null> {\n    const result = await this.getMetadata(\n        stream,\n        MetadataKey.ReadVisibilityKey);\n\n    return head(result)\n      .map((row) => toVisibilityEnum(row.value))\n      .unwrapOr(null);\n  }\n\n  /**\n   * Sets the compose visibility of the stream\n   */\n  public async setComposeVisibility(\n    stream: StreamLocator,\n    visibility: VisibilityEnum,\n  ): Promise<GenericResponse<TxReceipt>> {\n    return await this.setMetadata(\n      stream,\n      MetadataKey.ComposeVisibilityKey,\n      visibility.toString(),\n    );\n  }\n\n  /**\n   * Returns the compose visibility of the stream\n   */\n  public async getComposeVisibility(\n      stream: StreamLocator,\n  ): Promise<VisibilityEnum | null> {\n    const result = await this.getMetadata(\n      stream,\n      MetadataKey.ComposeVisibilityKey);\n\n    return head(result)\n      .map((row) => toVisibilityEnum(row.value))\n      .unwrapOr(null);\n  }\n\n  /**\n   * Allows a wallet to read the stream\n   */\n  public async allowReadWallet(\n    stream: StreamLocator,\n    wallet: EthereumAddress,\n  ): Promise<GenericResponse<TxReceipt>> {\n    return await this.setMetadata(\n      stream,\n      MetadataKey.AllowReadWalletKey,\n      wallet.getAddress(),\n    );\n  }\n\n  /**\n   * Disables a wallet from reading the stream\n   */\n  public async disableReadWallet(\n    stream: StreamLocator,\n    wallet: EthereumAddress,\n  ): Promise<GenericResponse<TxReceipt>> {\n    const result = await this.getMetadata(\n      stream,\n      MetadataKey.AllowReadWalletKey,\n      wallet.getAddress(),\n    );\n\n    const row_id = head(result)\n      .map((row) => row.rowId)\n      .unwrapOr(null);\n\n    if (!row_id) {\n      throw new Error(\"Wallet not found in allowed list\");\n    }\n\n    return await this.disableMetadata(stream, row_id);\n  }\n\n  /**\n   * Allows a stream to use this stream as child\n   */\n  public async allowComposeStream(\n    stream: StreamLocator,\n    wallet: StreamLocator,\n  ): Promise<GenericResponse<TxReceipt>> {\n    return await this.setMetadata(\n      stream,\n      MetadataKey.AllowComposeStreamKey,\n      wallet.streamId.getId(),\n    );\n  }\n\n  /**\n   * Disables a stream from using this stream as child\n   */\n  public async disableComposeStream(\n    stream: StreamLocator,\n    wallet: StreamLocator,\n  ): Promise<GenericResponse<TxReceipt>> {\n    const result = await this.getMetadata(\n      stream,\n      MetadataKey.AllowComposeStreamKey,\n      wallet.toString(),\n    );\n\n    const row_id = head(result)\n      .map((row) => row.rowId)\n      .unwrapOr(null);\n\n    if (!row_id) {\n      throw new Error(\"Stream not found in allowed list\");\n    }\n\n    return await this.disableMetadata(stream, row_id);\n  }\n\n  protected async disableMetadata(\n    stream: StreamLocator,\n    rowId: string,\n  ): Promise<GenericResponse<TxReceipt>> {\n    return await this.executeWithNamedParams(\"disable_metadata\", [{\n            $data_provider: stream.dataProvider.getAddress(),\n            $stream_id: stream.streamId.getId(),\n            $row_id: rowId,\n    }]);\n  }\n\n  /**\n   * Returns the wallets allowed to read the stream\n   */\n  public async getAllowedReadWallets(\n    stream: StreamLocator,\n  ): Promise<EthereumAddress[]> {\n    const result = await this.getMetadata(\n        stream,\n        MetadataKey.AllowReadWalletKey);\n\n    return result\n      .filter((row) => row.value)\n      .map((row) => new EthereumAddress(row.value));\n  }\n\n  /**\n   * Returns the streams allowed to compose the stream\n   */\n  public async getAllowedComposeStreams(\n    stream: StreamLocator,\n  ): Promise<StreamLocator[]> {\n    const result = await this.getMetadata(\n        stream,\n        MetadataKey.AllowComposeStreamKey);\n\n    return result\n      .filter((row) => row.value)\n      .map((row) => {\n        const [streamId, dataProvider] = row.value.split(\":\");\n        return {\n          streamId: StreamId.fromString(streamId).throw(),\n          dataProvider: new EthereumAddress(dataProvider),\n        };\n      });\n  }\n\n  /**\n   * Returns the index change of the stream within the given date range\n   */\n  public async getIndexChange(\n    input: GetIndexChangeInput,\n  ): Promise<StreamRecord[]> {\n    const result = await this.call<{ event_time: number; value: string }[]>(\n      \"get_index_change\", \n        {\n          $data_provider: input.stream.dataProvider.getAddress(),\n          $stream_id: input.stream.streamId.getId(),\n          $from: input.from,\n          $to: input.to,\n          $frozen_at: input.frozenAt,\n          $base_time: input.baseTime,\n          $time_interval: input.timeInterval,\n        }\n    );\n\n    return result\n      .mapRight((result) =>\n        result.map((row) => ({\n          eventTime: row.event_time,\n          value: row.value,\n        })),\n      )\n      .throw();\n  }\n\n  /**\n   * A custom method that accepts the procedure name and the input of GetRecordInput\n   * Returns the result of the procedure in the same format as StreamRecord\n   * I.e. a custom procedure named \"get_price\" that returns a list of date_value and value\n   * can be called with customGetProcedure(\"get_price\", { dateFrom: \"2021-01-01\", dateTo: \"2021-01-31\" })\n   */\n  public async customGetProcedure(\n    procedure: string,\n    input: GetRecordInput,\n  ): Promise<StreamRecord[]> {\n    const result = await this.call<{ event_time: number; value: string }[]>(\n      procedure,\n        {\n          $data_provider: input.stream.dataProvider.getAddress(),\n          $stream_id: input.stream.streamId.getId(),\n          $from: input.from,\n          $to: input.to,\n          $frozen_at: input.frozenAt\n        }\n    );\n    return result\n      .mapRight((result) =>\n        result.map((row) => ({\n          eventTime: row.event_time,\n          value: row.value,\n        })),\n      )\n      .throw();\n  }\n\n\n  /**\n   * A custom method that accepts the procedure name and custom input of type Record<string, any>\n   * Returns the result of the procedure in the same format as StreamRecord\n   * I.e. a custom procedure named \"get_custom_index\" that returns a list of date_value and value\n   * can be called with customProcedureWithArgs(\"get_custom_index\", { $customArg1: \"value1\", $customArg2: \"value2\" })\n   * where $customArg1 and $customArg2 are the arguments of the procedure\n   * @param procedure\n   * @param args\n   */\n  public async customProcedureWithArgs(\n    procedure: string,\n    args: Record<string, ValueType | ValueType[]>,\n  ){\n      const result = await this.call<{ event_time: number; value: string }[]>(\n          procedure,\n          args\n    );\n    return result\n      .mapRight((result) =>\n        result.map((row) => ({\n          eventTime: row.event_time,\n          value: row.value,\n        })),\n      )\n      .throw();\n  }\n\n  /**\n   * Returns the size of database\n   */\n  public async getDatabaseSize(): Promise<BigInt> {\n    const result = await this.call<{ database_size: BigInt }[]>(\"get_database_size\", {})\n    return result\n      .map((rows) => {\n        const raw = rows[0].database_size;\n        const asBigInt = BigInt(raw.toString());\n        return asBigInt;\n      }).throw();\n  }\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAKA,uBAAuB;AAGvB,6BAAgC;AAChC,kBAAqB;AACrB,sBAAyB;AACzB,wBAAiD;AACjD,4BAMO;AA2BA,IAAM,SAAN,MAAa;AAAA,EACR;AAAA,EACA;AAAA,EACV,YACE,YACA,YACA;AACA,SAAK,aAAa;AAClB,SAAK,aAAa;AAAA,EACpB;AAAA;AAAA;AAAA;AAAA,EAKA,MAAgB,uBACd,QACA,QACqC;AACrC,WAAO,KAAK,WAAW;AAAA,MAAQ;AAAA,QACzB,WAAW;AAAA,QACX,MAAM;AAAA,QACN;AAAA,QACA,aAAa,wCAAwC,MAAM;AAAA,MAC7D;AAAA,MACA,KAAK;AAAA,IACL;AAAA,EACN;AAAA;AAAA;AAAA;AAAA,EAKE,MAAgB,sBACZ,QACA,cAAuB,OACY;AACnC,WAAO,KAAK,WAAW,QAAQ,QAAQ,KAAK,YAAY,WAAW;AAAA,EACvE;AAAA;AAAA;AAAA;AAAA,EAKF,MAAgB,KACd,QACA,QAC4B;AAC5B,UAAM,SAAS,MAAM,KAAK,WAAW;AAAA,MACnC;AAAA,QACE,WAAW;AAAA,QACX,MAAM;AAAA,QACN;AAAA,MACF;AAAA,MACA,KAAK;AAAA,IACP;AAEA,QAAI,OAAO,WAAW,KAAK;AACzB,aAAO,wBAAO,KAAK,OAAO,MAAM;AAAA,IAClC;AAEA,WAAO,wBAAO,MAAM,OAAO,MAAM,MAAW;AAAA,EAC9C;AAAA;AAAA;AAAA;AAAA,EAKA,MAAa,UAAU,OAAgD;AACrE,UAAM,SAAS,MAAM,SAAS,MAAM,SAAS;AAC7C,UAAM,SAAS,MAAM,KAAK;AAAA,MACtB,SAAS;AAAA,MACT;AAAA,QACE,gBAAgB,MAAM,OAAO,aAAa,WAAW;AAAA,QACrD,YAAY,MAAM,OAAO,SAAS,MAAM;AAAA,QACxC,OAAO,MAAM;AAAA,QACb,KAAK,MAAM;AAAA,QACX,YAAY,MAAM;AAAA,MACpB;AAAA,IACJ;AACA,WAAO,OACJ;AAAA,MAAS,CAACA,YACTA,QAAO,IAAI,CAAC,SAAS;AAAA,QACnB,WAAW,IAAI;AAAA,QACf,OAAO,IAAI;AAAA,MACb,EAAE;AAAA,IACJ,EACC,MAAM;AAAA,EACX;AAAA;AAAA;AAAA;AAAA,EAKA,MAAa,SAAS,OAAgD;AACpE,UAAM,SAAS,MAAM,SAAS,MAAM,SAAS;AAC7C,UAAM,SAAS,MAAM,KAAK;AAAA,MACxB,SAAS;AAAA,MACP;AAAA,QACE,gBAAgB,MAAM,OAAO,aAAa,WAAW;AAAA,QACrD,YAAY,MAAM,OAAO,SAAS,MAAM;AAAA,QACxC,OAAO,MAAM;AAAA,QACb,KAAK,MAAM;AAAA,QACX,YAAY,MAAM;AAAA,QAClB,YAAY,MAAM;AAAA,MACpB;AAAA,IACJ;AACA,WAAO,OACJ;AAAA,MAAS,CAACA,YACTA,QAAO,IAAI,CAAC,SAAS;AAAA,QACnB,WAAW,IAAI;AAAA,QACf,OAAO,IAAI;AAAA,MACb,EAAE;AAAA,IACJ,EACC,MAAM;AAAA,EACX;AAAA;AAAA;AAAA;AAAA,EAKA,MAAa,QACT,QACmB;AACrB,UAAM,SAAS,MAAM,KAAK;AAAA,MACtB;AAAA,MACA,kCAAY;AAAA,IAAO;AAEvB,QAAI,CAAC,QAAQ;AACX,YAAM,IAAI,MAAM,2BAA2B;AAAA,IAC7C;AAEA,UAAM,WAAO,kBAAK,MAAM,EAAE,aAAa,MAAM;AAC3C,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF,CAAC;AAED,UAAM,aAAa,CAAC,iCAAW,WAAW,iCAAW,QAAQ;AAE7D,QAAI,CAAC,WAAW,SAAS,KAAK,KAAmB,GAAG;AAClD,YAAM,IAAI,MAAM,wBAAwB,KAAK,KAAK,EAAE;AAAA,IACtD;AAEA,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,MAAa,eACX,OAC8B;AAC9B,UAAM,SAAS,MAAM,KAAK;AAAA,MACxB;AAAA,MACE;AAAA,QACI,gBAAgB,MAAM,OAAO,aAAa,WAAW;AAAA,QACrD,YAAY,MAAM,OAAO,SAAS,MAAM;AAAA,QACxC,QAAQ,MAAM;AAAA,QACd,YAAY,MAAM;AAAA,MACtB;AAAA,IACJ;AAEA,WAAO,OACJ,SAAS,gBAAI,EACb;AAAA,MAAS,CAACA,YACTA,QACG,IAAI,CAACA,aAAY;AAAA,QAChB,WAAWA,QAAO;AAAA,QAClB,OAAOA,QAAO;AAAA,MAChB,EAAE,EACD,SAAS,IAAI;AAAA,IAClB,EACC,MAAM;AAAA,EACX;AAAA,EAEA,MAAgB,YACd,QACA,KACA,OACqC;AACrC,WAAO,MAAM,KAAK,uBAAuB,mBAAmB;AAAA,MAAC;AAAA,QACzD,gBAAgB,OAAO,aAAa,WAAW;AAAA,QAC/C,YAAY,OAAO,SAAS,MAAM;AAAA,QAClC,MAAM;AAAA,QACN,QAAQ;AAAA,QACR,WAAW,0CAAoB,GAAG;AAAA,MAClC;AAAA,IACJ,CAAC;AAAA,EACH;AAAA,EAEA,MAAgB,YACd,QACA,KAEA,aACA,OACA,QACA,SAGA;AACA,UAAM,SAAS,MAAM,KAAK;AAAA,MAUxB;AAAA,MAAgB;AAAA,QACd,gBAAgB,OAAO,aAAa,WAAW;AAAA,QAC/C,YAAY,OAAO,SAAS,MAAM;AAAA,QAClC,MAAM;AAAA,QACN,MAAM;AAAA,QACN,QAAQ;AAAA,QACR,SAAS;AAAA,QACT,WAAW;AAAA,MACX;AAAA,IACJ;AACA,WAAO,OACJ;AAAA,MAAS,CAACA,YACTA,QAAO,IAAI,CAAC,SAAS;AAAA,QACnB,OAAO,IAAI;AAAA,QACX,OAAO,IACL,uCAAiB,0CAAoB,GAAkB,CAAC,CAC1D;AAAA,QACA,WAAW,IAAI;AAAA,MACjB,EAAE;AAAA,IACJ,EACC,MAAM;AAAA,EACX;AAAA;AAAA;AAAA;AAAA,EAKA,MAAa,kBACX,QACA,YACqC;AACrC,WAAO,MAAM,KAAK;AAAA,MACd;AAAA,MACF,kCAAY;AAAA,MACZ,WAAW,SAAS;AAAA,IACtB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAa,kBACT,QAC8B;AAChC,UAAM,SAAS,MAAM,KAAK;AAAA,MACtB;AAAA,MACA,kCAAY;AAAA,IAAiB;AAEjC,eAAO,kBAAK,MAAM,EACf,IAAI,CAAC,YAAQ,oCAAiB,IAAI,KAAK,CAAC,EACxC,SAAS,IAAI;AAAA,EAClB;AAAA;AAAA;AAAA;AAAA,EAKA,MAAa,qBACX,QACA,YACqC;AACrC,WAAO,MAAM,KAAK;AAAA,MAChB;AAAA,MACA,kCAAY;AAAA,MACZ,WAAW,SAAS;AAAA,IACtB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAa,qBACT,QAC8B;AAChC,UAAM,SAAS,MAAM,KAAK;AAAA,MACxB;AAAA,MACA,kCAAY;AAAA,IAAoB;AAElC,eAAO,kBAAK,MAAM,EACf,IAAI,CAAC,YAAQ,oCAAiB,IAAI,KAAK,CAAC,EACxC,SAAS,IAAI;AAAA,EAClB;AAAA;AAAA;AAAA;AAAA,EAKA,MAAa,gBACX,QACA,QACqC;AACrC,WAAO,MAAM,KAAK;AAAA,MAChB;AAAA,MACA,kCAAY;AAAA,MACZ,OAAO,WAAW;AAAA,IACpB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAa,kBACX,QACA,QACqC;AACrC,UAAM,SAAS,MAAM,KAAK;AAAA,MACxB;AAAA,MACA,kCAAY;AAAA,MACZ,OAAO,WAAW;AAAA,IACpB;AAEA,UAAM,aAAS,kBAAK,MAAM,EACvB,IAAI,CAAC,QAAQ,IAAI,KAAK,EACtB,SAAS,IAAI;AAEhB,QAAI,CAAC,QAAQ;AACX,YAAM,IAAI,MAAM,kCAAkC;AAAA,IACpD;AAEA,WAAO,MAAM,KAAK,gBAAgB,QAAQ,MAAM;AAAA,EAClD;AAAA;AAAA;AAAA;AAAA,EAKA,MAAa,mBACX,QACA,QACqC;AACrC,WAAO,MAAM,KAAK;AAAA,MAChB;AAAA,MACA,kCAAY;AAAA,MACZ,OAAO,SAAS,MAAM;AAAA,IACxB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAa,qBACX,QACA,QACqC;AACrC,UAAM,SAAS,MAAM,KAAK;AAAA,MACxB;AAAA,MACA,kCAAY;AAAA,MACZ,OAAO,SAAS;AAAA,IAClB;AAEA,UAAM,aAAS,kBAAK,MAAM,EACvB,IAAI,CAAC,QAAQ,IAAI,KAAK,EACtB,SAAS,IAAI;AAEhB,QAAI,CAAC,QAAQ;AACX,YAAM,IAAI,MAAM,kCAAkC;AAAA,IACpD;AAEA,WAAO,MAAM,KAAK,gBAAgB,QAAQ,MAAM;AAAA,EAClD;AAAA,EAEA,MAAgB,gBACd,QACA,OACqC;AACrC,WAAO,MAAM,KAAK,uBAAuB,oBAAoB,CAAC;AAAA,MACtD,gBAAgB,OAAO,aAAa,WAAW;AAAA,MAC/C,YAAY,OAAO,SAAS,MAAM;AAAA,MAClC,SAAS;AAAA,IACjB,CAAC,CAAC;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA,EAKA,MAAa,sBACX,QAC4B;AAC5B,UAAM,SAAS,MAAM,KAAK;AAAA,MACtB;AAAA,MACA,kCAAY;AAAA,IAAkB;AAElC,WAAO,OACJ,OAAO,CAAC,QAAQ,IAAI,KAAK,EACzB,IAAI,CAAC,QAAQ,IAAI,uCAAgB,IAAI,KAAK,CAAC;AAAA,EAChD;AAAA;AAAA;AAAA;AAAA,EAKA,MAAa,yBACX,QAC0B;AAC1B,UAAM,SAAS,MAAM,KAAK;AAAA,MACtB;AAAA,MACA,kCAAY;AAAA,IAAqB;AAErC,WAAO,OACJ,OAAO,CAAC,QAAQ,IAAI,KAAK,EACzB,IAAI,CAAC,QAAQ;AACZ,YAAM,CAAC,UAAU,YAAY,IAAI,IAAI,MAAM,MAAM,GAAG;AACpD,aAAO;AAAA,QACL,UAAU,yBAAS,WAAW,QAAQ,EAAE,MAAM;AAAA,QAC9C,cAAc,IAAI,uCAAgB,YAAY;AAAA,MAChD;AAAA,IACF,CAAC;AAAA,EACL;AAAA;AAAA;AAAA;AAAA,EAKA,MAAa,eACX,OACyB;AACzB,UAAM,SAAS,MAAM,KAAK;AAAA,MACxB;AAAA,MACE;AAAA,QACE,gBAAgB,MAAM,OAAO,aAAa,WAAW;AAAA,QACrD,YAAY,MAAM,OAAO,SAAS,MAAM;AAAA,QACxC,OAAO,MAAM;AAAA,QACb,KAAK,MAAM;AAAA,QACX,YAAY,MAAM;AAAA,QAClB,YAAY,MAAM;AAAA,QAClB,gBAAgB,MAAM;AAAA,MACxB;AAAA,IACJ;AAEA,WAAO,OACJ;AAAA,MAAS,CAACA,YACTA,QAAO,IAAI,CAAC,SAAS;AAAA,QACnB,WAAW,IAAI;AAAA,QACf,OAAO,IAAI;AAAA,MACb,EAAE;AAAA,IACJ,EACC,MAAM;AAAA,EACX;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAa,mBACX,WACA,OACyB;AACzB,UAAM,SAAS,MAAM,KAAK;AAAA,MACxB;AAAA,MACE;AAAA,QACE,gBAAgB,MAAM,OAAO,aAAa,WAAW;AAAA,QACrD,YAAY,MAAM,OAAO,SAAS,MAAM;AAAA,QACxC,OAAO,MAAM;AAAA,QACb,KAAK,MAAM;AAAA,QACX,YAAY,MAAM;AAAA,MACpB;AAAA,IACJ;AACA,WAAO,OACJ;AAAA,MAAS,CAACA,YACTA,QAAO,IAAI,CAAC,SAAS;AAAA,QACnB,WAAW,IAAI;AAAA,QACf,OAAO,IAAI;AAAA,MACb,EAAE;AAAA,IACJ,EACC,MAAM;AAAA,EACX;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,MAAa,wBACX,WACA,MACD;AACG,UAAM,SAAS,MAAM,KAAK;AAAA,MACtB;AAAA,MACA;AAAA,IACN;AACA,WAAO,OACJ;AAAA,MAAS,CAACA,YACTA,QAAO,IAAI,CAAC,SAAS;AAAA,QACnB,WAAW,IAAI;AAAA,QACf,OAAO,IAAI;AAAA,MACb,EAAE;AAAA,IACJ,EACC,MAAM;AAAA,EACX;AAAA;AAAA;AAAA;AAAA,EAKA,MAAa,kBAAmC;AAC9C,UAAM,SAAS,MAAM,KAAK,KAAkC,qBAAqB,CAAC,CAAC;AACnF,WAAO,OACJ,IAAI,CAAC,SAAS;AACb,YAAM,MAAM,KAAK,CAAC,EAAE;AACpB,YAAM,WAAW,OAAO,IAAI,SAAS,CAAC;AACtC,aAAO;AAAA,IACT,CAAC,EAAE,MAAM;AAAA,EACb;AACF;",
-  "names": ["result"]
+  "sourcesContent": ["import {KwilSigner, NodeKwil, WebKwil} from \"@trufnetwork/kwil-js\";\nimport { ActionBody } from '@trufnetwork/kwil-js/dist/core/action';\nimport {NamedParams} from \"@trufnetwork/kwil-js/dist/core/action\";\nimport { GenericResponse } from \"@trufnetwork/kwil-js/dist/core/resreq\";\nimport { TxReceipt } from \"@trufnetwork/kwil-js/dist/core/tx\";\nimport { Either } from \"monads-io\";\nimport { DateString } from \"../types/other\";\nimport { StreamLocator } from \"../types/stream\";\nimport { CacheAwareResponse, GetRecordOptions, GetIndexOptions, GetIndexChangeOptions, GetFirstRecordOptions } from \"../types/cache\";\nimport { EthereumAddress } from \"../util/EthereumAddress\";\nimport { head } from \"../util/head\";\nimport { StreamId } from \"../util/StreamId\";\nimport { toVisibilityEnum, VisibilityEnum } from \"../util/visibility\";\nimport { CacheMetadataParser } from \"../util/cacheMetadataParser\";\nimport { CacheValidation } from \"../util/cacheValidation\";\nimport {\n  MetadataKey,\n  MetadataKeyValueMap,\n  MetadataTableKey,\n  MetadataValueTypeForKey,\n  StreamType,\n} from \"./contractValues\";\nimport {ValueType} from \"@trufnetwork/kwil-js/dist/utils/types\";\n\nexport interface GetRecordInput {\n  stream: StreamLocator;\n  from?: number;\n  to?: number;\n  frozenAt?: number;\n  baseTime?: DateString | number;\n  prefix?: string;\n}\n\nexport interface GetFirstRecordInput {\n  stream: StreamLocator;\n  after?: number;\n  frozenAt?: number;\n}\n\nexport interface StreamRecord {\n  eventTime: number;\n  value: string;\n}\n\nexport interface GetIndexChangeInput extends GetRecordInput {\n  timeInterval: number;\n}\n\nexport class Action {\n  protected kwilClient: WebKwil | NodeKwil;\n  protected kwilSigner: KwilSigner;\n  /** Track if deprecation warnings were already emitted */\n  private static _legacyWarnEmitted: Record<string, boolean> = {\n    getRecord: false,\n    getIndex: false,\n    getFirstRecord: false,\n    getIndexChange: false,\n  };\n  constructor(\n    kwilClient: WebKwil | NodeKwil,\n    kwilSigner: KwilSigner,\n  ) {\n    this.kwilClient = kwilClient;\n    this.kwilSigner = kwilSigner;\n  }\n\n  /**\n   * Executes a method on the stream\n   */\n  protected async executeWithNamedParams(\n    method: string,\n    inputs: NamedParams[],\n  ): Promise<GenericResponse<TxReceipt>> {\n    return this.kwilClient.execute({\n          namespace: \"main\",\n          name: method,\n          inputs,\n          description: `TN SDK - Executing method on stream: ${method}`,\n        },\n        this.kwilSigner,\n        );\n  }\n\n    /**\n     * Executes a method on the stream\n     */\n    protected async executeWithActionBody(\n        inputs: ActionBody,\n        synchronous: boolean = false,\n    ): Promise<GenericResponse<TxReceipt>> {\n        return this.kwilClient.execute(inputs, this.kwilSigner, synchronous);\n    }\n\n  /**\n   * Calls a method on the stream\n   */\n  protected async call<T>(\n    method: string,\n    inputs: NamedParams,\n  ): Promise<Either<number, T>> {\n    const result = await this.kwilClient.call(\n      {\n        namespace: \"main\",\n        name: method,\n        inputs: inputs,\n      },\n      this.kwilSigner,\n    );\n\n    if (result.status !== 200) {\n      return Either.left(result.status);\n    }\n\n    return Either.right(result.data?.result as T);\n  }\n\n  /**\n   * @deprecated Use getRecord(stream, options?) to leverage cache support and future-proof parameter handling.\n   */\n  public async getRecord(input: GetRecordInput): Promise<StreamRecord[]>;\n  public async getRecord(stream: StreamLocator, options?: GetRecordOptions): Promise<CacheAwareResponse<StreamRecord[]>>;\n  public async getRecord(\n    inputOrStream: GetRecordInput | StreamLocator,\n    options?: GetRecordOptions\n  ): Promise<StreamRecord[] | CacheAwareResponse<StreamRecord[]>> {\n    // Handle backward compatibility\n    if ('stream' in inputOrStream) {\n      // Legacy call format\n      const input = inputOrStream as GetRecordInput;\n      // emit deprecation warning once\n      if (!Action._legacyWarnEmitted.getRecord) {\n        Action._legacyWarnEmitted.getRecord = true;\n        if (typeof console !== 'undefined' && console.warn) {\n          console.warn('[TN SDK] Deprecated signature: getRecord(input). Use getRecord(stream, options?) instead.');\n        }\n      }\n      const prefix = input.prefix ? input.prefix : \"\"\n      const result = await this.call<{ event_time: number; value: string }[]>(\n          prefix + \"get_record\",\n          {\n            $data_provider: input.stream.dataProvider.getAddress(),\n            $stream_id: input.stream.streamId.getId(),\n            $from: input.from,\n            $to: input.to,\n            $frozen_at: input.frozenAt,\n          }\n      );\n      return result\n        .mapRight((result) =>\n          result.map((row) => ({\n            eventTime: row.event_time,\n            value: row.value,\n          })),\n        )\n        .throw();\n    }\n    \n    // New cache-aware call format\n    const stream = inputOrStream as StreamLocator;\n    \n    // Validate options if provided\n    if (options) {\n      CacheValidation.validateGetRecordOptions(options);\n      CacheValidation.validateTimeRange(options.from, options.to);\n    }\n    \n    const prefix = options?.prefix ? options.prefix : \"\"\n    const params: any = {\n      $data_provider: stream.dataProvider.getAddress(),\n      $stream_id: stream.streamId.getId(),\n      $from: options?.from,\n      $to: options?.to,\n      $frozen_at: options?.frozenAt,\n    };\n    \n    if (options?.useCache !== undefined) {\n      params.$use_cache = options.useCache;\n    }\n    \n    const result = await this.kwilClient.call(\n      {\n        namespace: \"main\",\n        name: prefix + \"get_record\",\n        inputs: params,\n      },\n      this.kwilSigner,\n    );\n    \n    if (result.status !== 200) {\n      throw new Error(`Failed to get record: ${result.status}`);\n    }\n    \n    const data = (result.data?.result as { event_time: number; value: string }[]).map((row) => ({\n      eventTime: row.event_time,\n      value: row.value,\n    }));\n    \n    let cache = CacheMetadataParser.extractFromResponse(result);\n    \n    // Enhance cache metadata with SDK-provided context\n    if (cache) {\n      cache = {\n        ...cache,\n        streamId: stream.streamId.getId(),\n        dataProvider: stream.dataProvider.getAddress(),\n        from: options?.from,\n        to: options?.to,\n        frozenAt: options?.frozenAt,\n        rowsServed: data.length\n      };\n    }\n    \n    return {\n      data,\n      cache: cache || undefined,\n      logs: result.data?.logs ? CacheMetadataParser.parseLogsForMetadata(result.data.logs) : undefined,\n    };\n  }\n\n  /**\n   * Returns the index of the stream within the given date range\n   * @deprecated Use getIndex(stream, options?) to leverage cache support and future-proof parameter handling.\n   */\n  public async getIndex(input: GetRecordInput): Promise<StreamRecord[]>;\n  public async getIndex(stream: StreamLocator, options?: GetIndexOptions): Promise<CacheAwareResponse<StreamRecord[]>>;\n  public async getIndex(\n    inputOrStream: GetRecordInput | StreamLocator,\n    options?: GetIndexOptions\n  ): Promise<StreamRecord[] | CacheAwareResponse<StreamRecord[]>> {\n    // Handle backward compatibility\n    if ('stream' in inputOrStream) {\n      // Legacy call format\n      const input = inputOrStream as GetRecordInput;\n      if (!Action._legacyWarnEmitted.getIndex) {\n        Action._legacyWarnEmitted.getIndex = true;\n        if (typeof console !== 'undefined' && console.warn) {\n          console.warn('[TN SDK] Deprecated signature: getIndex(input). Use getIndex(stream, options?) instead.');\n        }\n      }\n      const prefix = input.prefix ? input.prefix : \"\"\n      const result = await this.call<{ event_time: number; value: string }[]>(\n        prefix + \"get_index\",\n          {\n            $data_provider: input.stream.dataProvider.getAddress(),\n            $stream_id: input.stream.streamId.getId(),\n            $from: input.from,\n            $to: input.to,\n            $frozen_at: input.frozenAt,\n            $base_time: input.baseTime,\n          }\n      );\n      return result\n        .mapRight((result) =>\n          result.map((row) => ({\n            eventTime: row.event_time,\n            value: row.value,\n          })),\n        )\n        .throw();\n    }\n    \n    // New cache-aware call format\n    const stream = inputOrStream as StreamLocator;\n    \n    // Validate options if provided\n    if (options) {\n      CacheValidation.validateGetIndexOptions(options);\n      CacheValidation.validateTimeRange(options.from, options.to);\n    }\n    \n    const prefix = options?.prefix ? options.prefix : \"\"\n    const params: any = {\n      $data_provider: stream.dataProvider.getAddress(),\n      $stream_id: stream.streamId.getId(),\n      $from: options?.from,\n      $to: options?.to,\n      $frozen_at: options?.frozenAt,\n      $base_time: options?.baseTime,\n    };\n    \n    if (options?.useCache !== undefined) {\n      params.$use_cache = options.useCache;\n    }\n    \n    const result = await this.kwilClient.call(\n      {\n        namespace: \"main\",\n        name: prefix + \"get_index\",\n        inputs: params,\n      },\n      this.kwilSigner,\n    );\n    \n    if (result.status !== 200) {\n      throw new Error(`Failed to get index: ${result.status}`);\n    }\n    \n    const data = (result.data?.result as { event_time: number; value: string }[]).map((row) => ({\n      eventTime: row.event_time,\n      value: row.value,\n    }));\n    \n    let cache = CacheMetadataParser.extractFromResponse(result);\n    \n    // Enhance cache metadata with SDK-provided context\n    if (cache) {\n      cache = {\n        ...cache,\n        streamId: stream.streamId.getId(),\n        dataProvider: stream.dataProvider.getAddress(),\n        from: options?.from,\n        to: options?.to,\n        frozenAt: options?.frozenAt,\n        rowsServed: data.length\n      };\n    }\n    \n    return {\n      data,\n      cache: cache || undefined,\n      logs: result.data?.logs ? CacheMetadataParser.parseLogsForMetadata(result.data.logs) : undefined\n    };\n  }\n\n  /**\n   * Returns the type of the stream\n   */\n  public async getType(\n      stream: StreamLocator,\n  ): Promise<StreamType> {\n    const result = await this.getMetadata(\n        stream,\n        MetadataKey.TypeKey);\n\n    if (!result) {\n      throw new Error(\"Failed to get stream type\");\n    }\n\n    const type = head(result).unwrapOrElse(() => {\n      throw new Error(\n        \"Failed to get stream type. Check if the stream is initialized.\",\n      );\n    });\n\n    const validTypes = [StreamType.Primitive, StreamType.Composed];\n\n    if (!validTypes.includes(type.value as StreamType)) {\n      throw new Error(`Invalid stream type: ${type.value}`);\n    }\n\n    return type.value as StreamType;\n  }\n\n  /**\n   * Returns the first record of the stream\n   * @deprecated Use getFirstRecord(stream, options?) to leverage cache support and future-proof parameter handling.\n   */\n  public async getFirstRecord(\n    input: GetFirstRecordInput,\n  ): Promise<StreamRecord | null>;\n  public async getFirstRecord(\n    stream: StreamLocator,\n    options?: GetFirstRecordOptions\n  ): Promise<CacheAwareResponse<StreamRecord | null>>;\n  public async getFirstRecord(\n    inputOrStream: GetFirstRecordInput | StreamLocator,\n    options?: GetFirstRecordOptions\n  ): Promise<StreamRecord | null | CacheAwareResponse<StreamRecord | null>> {\n    // Handle backward compatibility\n    if ('stream' in inputOrStream) {\n      // Legacy call format\n      const input = inputOrStream as GetFirstRecordInput;\n      if (!Action._legacyWarnEmitted.getFirstRecord) {\n        Action._legacyWarnEmitted.getFirstRecord = true;\n        if (typeof console !== 'undefined' && console.warn) {\n          console.warn('[TN SDK] Deprecated signature: getFirstRecord(input). Use getFirstRecord(stream, options?) instead.');\n        }\n      }\n      const result = await this.call<{ event_time: number; value: string }[]>(\n        \"get_first_record\",\n          {\n              $data_provider: input.stream.dataProvider.getAddress(),\n              $stream_id: input.stream.streamId.getId(),\n              $after: input.after,\n              $frozen_at: input.frozenAt,\n          }\n      );\n\n      return result\n        .mapRight(head)\n        .mapRight((result) =>\n          result\n            .map((result) => ({\n              eventTime: result.event_time,\n              value: result.value,\n            }))\n            .unwrapOr(null),\n        )\n        .throw();\n    }\n    \n    // New cache-aware call format\n    const stream = inputOrStream as StreamLocator;\n    \n    // Validate options if provided\n    if (options) {\n      CacheValidation.validateGetFirstRecordOptions(options);\n    }\n    \n    const params: any = {\n      $data_provider: stream.dataProvider.getAddress(),\n      $stream_id: stream.streamId.getId(),\n      $after: options?.after,\n      $frozen_at: options?.frozenAt,\n    };\n    \n    if (options?.useCache !== undefined) {\n      params.$use_cache = options.useCache;\n    }\n    \n    const result = await this.kwilClient.call(\n      {\n        namespace: \"main\",\n        name: \"get_first_record\",\n        inputs: params,\n      },\n      this.kwilSigner,\n    );\n    \n    if (result.status !== 200) {\n      throw new Error(`Failed to get first record: ${result.status}`);\n    }\n    \n    const rawData = result.data?.result as { event_time: number; value: string }[];\n    const data = rawData && rawData.length > 0 ? {\n      eventTime: rawData[0].event_time,\n      value: rawData[0].value,\n    } : null;\n    \n    let cache = CacheMetadataParser.extractFromResponse(result);\n    \n    // Enhance cache metadata with SDK-provided context\n    if (cache) {\n      cache = {\n        ...cache,\n        streamId: stream.streamId.getId(),\n        dataProvider: stream.dataProvider.getAddress(),\n        frozenAt: options?.frozenAt,\n        rowsServed: data ? 1 : 0\n      };\n    }\n    \n    return {\n      data,\n      cache: cache || undefined,\n      logs: result.data?.logs ? CacheMetadataParser.parseLogsForMetadata(result.data.logs) : undefined\n    };\n  }\n\n  protected async setMetadata<K extends MetadataKey>(\n    stream: StreamLocator,\n    key: K,\n    value: MetadataValueTypeForKey<K>,\n  ): Promise<GenericResponse<TxReceipt>> {\n    return await this.executeWithNamedParams(\"insert_metadata\", [{\n        $data_provider: stream.dataProvider.getAddress(),\n        $stream_id: stream.streamId.getId(),\n        $key: key,\n        $value: value,\n        $val_type: MetadataKeyValueMap[key],\n        },\n    ]);\n  }\n\n  protected async getMetadata<K extends MetadataKey>(\n    stream: StreamLocator,\n    key: K,\n    // onlyLatest: boolean = true,\n    filteredRef?: string,\n    limit?: number,\n    offset?: number,\n    orderBy?: string,\n  ): Promise<\n    { rowId: string; value: MetadataValueTypeForKey<K>; createdAt: number }[]\n  > {\n    const result = await this.call<\n      {\n        row_id: string;\n        value_i: number;\n        value_f: string;\n        value_b: boolean;\n        value_s: string;\n        value_ref: string;\n        created_at: number;\n      }[]\n    >(\"get_metadata\", {\n        $data_provider: stream.dataProvider.getAddress(),\n        $stream_id: stream.streamId.getId(),\n        $key: key,\n        $ref: filteredRef,\n        $limit: limit,\n        $offset: offset,\n        $order_by: orderBy,\n        },\n    );\n    return result\n      .mapRight((result) =>\n        result.map((row) => ({\n          rowId: row.row_id,\n          value: row[\n            MetadataTableKey[MetadataKeyValueMap[key as MetadataKey]]\n          ] as MetadataValueTypeForKey<K>,\n          createdAt: row.created_at,\n        })),\n      )\n      .throw();\n  }\n\n  /**\n   * Sets the read visibility of the stream\n   */\n  public async setReadVisibility(\n    stream: StreamLocator,\n    visibility: VisibilityEnum,\n  ): Promise<GenericResponse<TxReceipt>> {\n    return await this.setMetadata(\n        stream,\n      MetadataKey.ReadVisibilityKey,\n      visibility.toString(),\n    );\n  }\n\n  /**\n   * Returns the read visibility of the stream\n   */\n  public async getReadVisibility(\n      stream: StreamLocator,\n  ): Promise<VisibilityEnum | null> {\n    const result = await this.getMetadata(\n        stream,\n        MetadataKey.ReadVisibilityKey);\n\n    return head(result)\n      .map((row) => toVisibilityEnum(row.value))\n      .unwrapOr(null);\n  }\n\n  /**\n   * Sets the compose visibility of the stream\n   */\n  public async setComposeVisibility(\n    stream: StreamLocator,\n    visibility: VisibilityEnum,\n  ): Promise<GenericResponse<TxReceipt>> {\n    return await this.setMetadata(\n      stream,\n      MetadataKey.ComposeVisibilityKey,\n      visibility.toString(),\n    );\n  }\n\n  /**\n   * Returns the compose visibility of the stream\n   */\n  public async getComposeVisibility(\n      stream: StreamLocator,\n  ): Promise<VisibilityEnum | null> {\n    const result = await this.getMetadata(\n      stream,\n      MetadataKey.ComposeVisibilityKey);\n\n    return head(result)\n      .map((row) => toVisibilityEnum(row.value))\n      .unwrapOr(null);\n  }\n\n  /**\n   * Allows a wallet to read the stream\n   */\n  public async allowReadWallet(\n    stream: StreamLocator,\n    wallet: EthereumAddress,\n  ): Promise<GenericResponse<TxReceipt>> {\n    return await this.setMetadata(\n      stream,\n      MetadataKey.AllowReadWalletKey,\n      wallet.getAddress(),\n    );\n  }\n\n  /**\n   * Disables a wallet from reading the stream\n   */\n  public async disableReadWallet(\n    stream: StreamLocator,\n    wallet: EthereumAddress,\n  ): Promise<GenericResponse<TxReceipt>> {\n    const result = await this.getMetadata(\n      stream,\n      MetadataKey.AllowReadWalletKey,\n      wallet.getAddress(),\n    );\n\n    const row_id = head(result)\n      .map((row) => row.rowId)\n      .unwrapOr(null);\n\n    if (!row_id) {\n      throw new Error(\"Wallet not found in allowed list\");\n    }\n\n    return await this.disableMetadata(stream, row_id);\n  }\n\n  /**\n   * Allows a stream to use this stream as child\n   */\n  public async allowComposeStream(\n    stream: StreamLocator,\n    wallet: StreamLocator,\n  ): Promise<GenericResponse<TxReceipt>> {\n    return await this.setMetadata(\n      stream,\n      MetadataKey.AllowComposeStreamKey,\n      wallet.streamId.getId(),\n    );\n  }\n\n  /**\n   * Disables a stream from using this stream as child\n   */\n  public async disableComposeStream(\n    stream: StreamLocator,\n    wallet: StreamLocator,\n  ): Promise<GenericResponse<TxReceipt>> {\n    const result = await this.getMetadata(\n      stream,\n      MetadataKey.AllowComposeStreamKey,\n      wallet.toString(),\n    );\n\n    const row_id = head(result)\n      .map((row) => row.rowId)\n      .unwrapOr(null);\n\n    if (!row_id) {\n      throw new Error(\"Stream not found in allowed list\");\n    }\n\n    return await this.disableMetadata(stream, row_id);\n  }\n\n  protected async disableMetadata(\n    stream: StreamLocator,\n    rowId: string,\n  ): Promise<GenericResponse<TxReceipt>> {\n    return await this.executeWithNamedParams(\"disable_metadata\", [{\n            $data_provider: stream.dataProvider.getAddress(),\n            $stream_id: stream.streamId.getId(),\n            $row_id: rowId,\n    }]);\n  }\n\n  /**\n   * Returns the wallets allowed to read the stream\n   */\n  public async getAllowedReadWallets(\n    stream: StreamLocator,\n  ): Promise<EthereumAddress[]> {\n    const result = await this.getMetadata(\n        stream,\n        MetadataKey.AllowReadWalletKey);\n\n    return result\n      .filter((row) => row.value)\n      .map((row) => new EthereumAddress(row.value));\n  }\n\n  /**\n   * Returns the streams allowed to compose the stream\n   */\n  public async getAllowedComposeStreams(\n    stream: StreamLocator,\n  ): Promise<StreamLocator[]> {\n    const result = await this.getMetadata(\n        stream,\n        MetadataKey.AllowComposeStreamKey);\n\n    return result\n      .filter((row) => row.value)\n      .map((row) => {\n        const [streamId, dataProvider] = row.value.split(\":\");\n        return {\n          streamId: StreamId.fromString(streamId).throw(),\n          dataProvider: new EthereumAddress(dataProvider),\n        };\n      });\n  }\n\n  /**\n   * Returns the index change of the stream within the given date range\n   * @deprecated Use getIndexChange(stream, options) to leverage cache support and future-proof parameter handling.\n   */\n  public async getIndexChange(\n    input: GetIndexChangeInput,\n  ): Promise<StreamRecord[]>;\n  public async getIndexChange(\n    stream: StreamLocator,\n    options: GetIndexChangeOptions\n  ): Promise<CacheAwareResponse<StreamRecord[]>>;\n  public async getIndexChange(\n    inputOrStream: GetIndexChangeInput | StreamLocator,\n    options?: GetIndexChangeOptions\n  ): Promise<StreamRecord[] | CacheAwareResponse<StreamRecord[]>> {\n    // Handle backward compatibility\n    if ('stream' in inputOrStream) {\n      // Legacy call format\n      const input = inputOrStream as GetIndexChangeInput;\n      if (!Action._legacyWarnEmitted.getIndexChange) {\n        Action._legacyWarnEmitted.getIndexChange = true;\n        if (typeof console !== 'undefined' && console.warn) {\n          console.warn('[TN SDK] Deprecated signature: getIndexChange(input). Use getIndexChange(stream, options?) instead.');\n        }\n      }\n      const result = await this.call<{ event_time: number; value: string }[]>(\n        \"get_index_change\", \n          {\n            $data_provider: input.stream.dataProvider.getAddress(),\n            $stream_id: input.stream.streamId.getId(),\n            $from: input.from,\n            $to: input.to,\n            $frozen_at: input.frozenAt,\n            $base_time: input.baseTime,\n            $time_interval: input.timeInterval,\n          }\n      );\n\n      return result\n        .mapRight((result) =>\n          result.map((row) => ({\n            eventTime: row.event_time,\n            value: row.value,\n          })),\n        )\n        .throw();\n    }\n    \n    // New cache-aware call format\n    const stream = inputOrStream as StreamLocator;\n    if (!options) {\n      throw new Error('Options parameter is required for cache-aware getIndexChange');\n    }\n    \n    // Validate options\n    CacheValidation.validateGetIndexChangeOptions(options);\n    CacheValidation.validateTimeRange(options.from, options.to);\n    \n    const params: any = {\n      $data_provider: stream.dataProvider.getAddress(),\n      $stream_id: stream.streamId.getId(),\n      $from: options.from,\n      $to: options.to,\n      $frozen_at: options.frozenAt,\n      $base_time: options.baseTime,\n      $time_interval: options.timeInterval,\n    };\n    \n    if (options.useCache !== undefined) {\n      params.$use_cache = options.useCache;\n    }\n    \n    const result = await this.kwilClient.call(\n      {\n        namespace: \"main\",\n        name: \"get_index_change\",\n        inputs: params,\n      },\n      this.kwilSigner,\n    );\n    \n    if (result.status !== 200) {\n      throw new Error(`Failed to get index change: ${result.status}`);\n    }\n    \n    const data = (result.data?.result as { event_time: number; value: string }[]).map((row) => ({\n      eventTime: row.event_time,\n      value: row.value,\n    }));\n    \n    let cache = CacheMetadataParser.extractFromResponse(result);\n    \n    // Enhance cache metadata with SDK-provided context\n    if (cache) {\n      cache = {\n        ...cache,\n        streamId: stream.streamId.getId(),\n        dataProvider: stream.dataProvider.getAddress(),\n        from: options.from,\n        to: options.to,\n        frozenAt: options.frozenAt,\n        rowsServed: data.length\n      };\n    }\n    \n    return {\n      data,\n      cache: cache || undefined,\n      logs: result.data?.logs ? CacheMetadataParser.parseLogsForMetadata(result.data.logs) : undefined\n    };\n  }\n\n  /**\n   * A custom method that accepts the procedure name and the input of GetRecordInput\n   * Returns the result of the procedure in the same format as StreamRecord\n   * I.e. a custom procedure named \"get_price\" that returns a list of date_value and value\n   * can be called with customGetProcedure(\"get_price\", { dateFrom: \"2021-01-01\", dateTo: \"2021-01-31\" })\n   */\n  public async customGetProcedure(\n    procedure: string,\n    input: GetRecordInput,\n  ): Promise<StreamRecord[]> {\n    const result = await this.call<{ event_time: number; value: string }[]>(\n      procedure,\n        {\n          $data_provider: input.stream.dataProvider.getAddress(),\n          $stream_id: input.stream.streamId.getId(),\n          $from: input.from,\n          $to: input.to,\n          $frozen_at: input.frozenAt\n        }\n    );\n    return result\n      .mapRight((result) =>\n        result.map((row) => ({\n          eventTime: row.event_time,\n          value: row.value,\n        })),\n      )\n      .throw();\n  }\n\n\n  /**\n   * A custom method that accepts the procedure name and custom input of type Record<string, any>\n   * Returns the result of the procedure in the same format as StreamRecord\n   * I.e. a custom procedure named \"get_custom_index\" that returns a list of date_value and value\n   * can be called with customProcedureWithArgs(\"get_custom_index\", { $customArg1: \"value1\", $customArg2: \"value2\" })\n   * where $customArg1 and $customArg2 are the arguments of the procedure\n   * @param procedure\n   * @param args\n   */\n  public async customProcedureWithArgs(\n    procedure: string,\n    args: Record<string, ValueType | ValueType[]>,\n  ){\n      const result = await this.call<{ event_time: number; value: string }[]>(\n          procedure,\n          args\n    );\n    return result\n      .mapRight((result) =>\n        result.map((row) => ({\n          eventTime: row.event_time,\n          value: row.value,\n        })),\n      )\n      .throw();\n  }\n\n  /**\n   * Returns the size of database\n   */\n  public async getDatabaseSize(): Promise<BigInt> {\n    const result = await this.call<{ database_size: BigInt }[]>(\"get_database_size\", {})\n    return result\n      .map((rows) => {\n        const raw = rows[0].database_size;\n        const asBigInt = BigInt(raw.toString());\n        return asBigInt;\n      }).throw();\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["prefix", "result"]
 }

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/contracts-api/composedAction.cjs

@@ -118,6 +118,92 @@ var ComposedAction = class _ComposedAction extends import_action.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: import_EthereumAddress.EthereumAddress.fromString(record.data_provider).throw(),
+        streamId: import_StreamId.StreamId.fromString(record.stream_id).throw(),
+        childDataProvider: import_EthereumAddress.EthereumAddress.fromString(record.child_data_provider).throw(),
+        childStreamId: import_StreamId.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: import_EthereumAddress.EthereumAddress.fromString(record.data_provider).throw(),
+        streamId: import_StreamId.StreamId.fromString(record.stream_id).throw(),
+        childDataProvider: import_EthereumAddress.EthereumAddress.fromString(record.child_data_provider).throw(),
+        childStreamId: import_StreamId.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/cjs/contracts-api/composedAction.cjs.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": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAAmD;AAKnD,6BAAgC;AAChC,sBAAyB;AACzB,oBAAuB;AACvB,IAAO,WAAW,qBAAM;AAEjB,IAAM,yBAAyB;AA4D/B,IAAM,iBAAN,MAAM,wBAAuB,qBAAO;AAAA,EACzC,YACE,YACA,YACA;AACA,UAAM,YAAY,UAAU;AAAA,EAC9B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAa,mBACX,QACwB;AAYxB,UAAM,SAAS,MAAM,KAAK;AAAA,MACtB;AAAA,MACA;AAAA,QACI,gBAAgB,OAAO,OAAO,aAAa,WAAW;AAAA,QACtD,YAAY,OAAO,OAAO,SAAS,MAAM;AAAA,QACzC,wBAAwB,OAAO;AAAA,MACnC;AAAA,IACJ;AAIA,WAAO,OACJ,SAAS,CAAC,YAAY;AACrB,YAAM,gBAAiD,QAAQ;AAAA,QAC7D,CAAC,KAAK,WAAW;AACf,gBAAM,eAAe,IAAI,IAAI,OAAO,WAAW,SAAS,CAAC,KAAK,CAAC;AAC/D,uBAAa,KAAK;AAAA,YAChB,aAAa;AAAA,cACX,UAAU,yBAAS,WAAW,OAAO,eAAe,EAAE,MAAM;AAAA,cAC5D,cAAc,uCAAgB;AAAA,gBAC5B,OAAO;AAAA,cACT,EAAE,MAAM;AAAA,YACV;AAAA,YACA,QAAQ,OAAO;AAAA,UACjB,CAAC;AACD,cAAI,IAAI,OAAO,WAAW,SAAS,GAAG,YAAY;AAClD,iBAAO;AAAA,QACT;AAAA,QACA,oBAAI,IAAgC;AAAA,MACtC;AAEA,aAAO,MAAM,KAAK,cAAc,QAAQ,CAAC,EAAE;AAAA,QACzC,CAAC,CAAC,WAAWA,cAAa,OAAO;AAAA,UAC/B,QAAQ;AAAA,YACN,UAAU,yBAAS,WAAW,QAAQ,CAAC,EAAE,SAAS,EAAE,MAAM;AAAA,YAC1D,cAAc,uCAAgB;AAAA,cAC5B,QAAQ,CAAC,EAAE;AAAA,YACb,EAAE,MAAM;AAAA,UACV;AAAA,UACA,eAAAA;AAAA,UACA,WAAW,OAAO,SAAS;AAAA,QAC7B;AAAA,MACF;AAAA,IACF,CAAC,EACA,MAAM;AAAA,EACX;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAa,YACX,UACqC;AACrC,UAAM,qBAA+B,CAAC;AACtC,UAAM,iBAA2B,CAAC;AAClC,UAAM,UAAoB,CAAC;AAE3B,eAAW,QAAQ,SAAS,eAAe;AACzC,yBAAmB,KAAK,KAAK,YAAY,aACpC,WAAW,CAAC;AACjB,qBAAe,KAAK,KAAK,YAAY,SAAS,MAAM,CAAC;AACrD,cAAQ,KAAK,KAAK,OAAO,SAAS,CAAC;AAAA,IACrC;AAEA,UAAM,SAAS,MAAM,KAAK,sBAAsB;AAAA,MAC5C,WAAW;AAAA,MACX,MAAM;AAAA,MACN,QAAQ;AAAA,QACN;AAAA,UACE,gBAAgB,SAAS,OAAO,aAAa,WAAW;AAAA,UACxD,YAAY,SAAS,OAAO,SAAS,MAAM;AAAA,UAC3C,uBAAuB;AAAA,UACvB,mBAAmB;AAAA,UACnB,UAAU;AAAA,UACV,aAAa,SAAS;AAAA,QACxB;AAAA,MACF;AAAA,MACA,OAAO;AAAA,QACL,gBAAgB,SAAS;AAAA,QACzB,YAAY,SAAS;AAAA,QACrB,uBAAuB,SAAS;AAAA,QAChC,mBAAmB,SAAS;AAAA,QAC5B,UAAU,SAAS,aAAa,IAAG,EAAE;AAAA,QACrC,aAAa,SAAS;AAAA,MACxB;AAAA,IAAC,CAAC;AAEN,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmBA,MAAa,uBACX,SAAuC,CAAC,GACR;AAYhC,UAAM,SAAS,MAAM,KAAK;AAAA,MACxB;AAAA,MACA;AAAA,QACE,cAAc,OAAO,cAAc;AAAA,QACnC,YAAY,OAAO,YAAY;AAAA,QAC/B,QAAQ,OAAO,SAAS;AAAA,QACxB,SAAS,OAAO,UAAU;AAAA,QAC1B,cAAc,OAAO,cAAc;AAAA,MACrC;AAAA,IACF;AAEA,WAAO,OACJ;AAAA,MAAS,CAAC,YACT,QAAQ,IAAI,aAAW;AAAA,QACrB,cAAc,uCAAgB,WAAW,OAAO,aAAa,EAAE,MAAM;AAAA,QACrE,UAAU,yBAAS,WAAW,OAAO,SAAS,EAAE,MAAM;AAAA,QACtD,mBAAmB,uCAAgB,WAAW,OAAO,mBAAmB,EAAE,MAAM;AAAA,QAChF,eAAe,yBAAS,WAAW,OAAO,eAAe,EAAE,MAAM;AAAA,QACjE,QAAQ,OAAO;AAAA,QACf,WAAW,OAAO;AAAA,QAClB,eAAe,OAAO;AAAA,QACtB,WAAW,OAAO;AAAA,MACpB,EAAE;AAAA,IACJ,EACC,MAAM;AAAA,EACX;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoBA,MAAa,wBACX,QACgC;AAEhC,QAAI,CAAC,OAAO,WAAW,OAAO,QAAQ,WAAW,GAAG;AAClD,aAAO,CAAC;AAAA,IACV;AAEA,UAAM,gBAAgB,OAAO,QAAQ,IAAI,OAAK,EAAE,aAAa,WAAW,CAAC;AACzE,UAAM,YAAY,OAAO,QAAQ,IAAI,OAAK,EAAE,SAAS,MAAM,CAAC;AAa5D,UAAM,SAAS,MAAM,KAAK;AAAA,MACxB;AAAA,MACA;AAAA,QACE,iBAAiB;AAAA,QACjB,aAAa;AAAA,QACb,cAAc,OAAO,cAAc;AAAA,MACrC;AAAA,IACF;AAEA,WAAO,OACJ;AAAA,MAAS,CAAC,YACT,QAAQ,IAAI,aAAW;AAAA,QACrB,cAAc,uCAAgB,WAAW,OAAO,aAAa,EAAE,MAAM;AAAA,QACrE,UAAU,yBAAS,WAAW,OAAO,SAAS,EAAE,MAAM;AAAA,QACtD,mBAAmB,uCAAgB,WAAW,OAAO,mBAAmB,EAAE,MAAM;AAAA,QAChF,eAAe,yBAAS,WAAW,OAAO,eAAe,EAAE,MAAM;AAAA,QACjE,QAAQ,OAAO;AAAA,QACf,WAAW,OAAO;AAAA,QAClB,eAAe,OAAO;AAAA,QACtB,WAAW,OAAO;AAAA,MACpB,EAAE;AAAA,IACJ,EACC,MAAM;AAAA,EACX;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,OAAc,WAAW,QAAgC;AACvD,WAAO,IAAI;AAAA,MACT,OAAO,YAAY;AAAA,MACnB,OAAO,YAAY;AAAA,IACrB;AAAA,EACF;AACF;",
   "names": ["taxonomyItems"]
 }