@trufnetwork/sdk-js 0.0.0-dev-20241126103246

package/dist/esm/contracts-api/stream.mjs

@@ -0,0 +1,367 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/contracts-api/stream.ts
+import { ActionInput } from "@kwilteam/kwil-js/dist/core/action.js";
+import { generateDBID } from "@kwilteam/kwil-js/dist/utils/dbid.js";
+import { Either } from "monads-io";
+import { EthereumAddress } from "../util/EthereumAddress.mjs";
+import { head } from "../util/head.mjs";
+import { StreamId } from "../util/StreamId.mjs";
+import { toVisibilityEnum } from "../util/visibility.mjs";
+import {
+  MetadataKey,
+  MetadataKeyValueMap,
+  MetadataTableKey,
+  StreamType
+} from "./contractValues.mjs";
+var Stream = class {
+  constructor(kwilClient, kwilSigner, locator) {
+    __publicField(this, "kwilClient");
+    __publicField(this, "kwilSigner");
+    __publicField(this, "locator");
+    __publicField(this, "dbid");
+    __publicField(this, "schema");
+    __publicField(this, "deployed", false);
+    __publicField(this, "initialized", false);
+    this.kwilClient = kwilClient;
+    this.kwilSigner = kwilSigner;
+    this.locator = locator;
+    this.dbid = generateDBID(
+      locator.dataProvider.getAddress(),
+      locator.streamId.getId()
+    );
+  }
+  /**
+   * Loads the schema for this stream from the network.
+   * Throws if the stream is not deployed.
+   */
+  async loadSchema() {
+    const response = await this.kwilClient.getSchema(this.dbid);
+    if (response.status !== 200 || !response.data) {
+      throw new Error(
+        `Failed to load schema for stream ${this.locator.streamId.getId()}`
+      );
+    }
+    this.schema = response.data;
+  }
+  /**
+   * Executes a method on the stream
+   */
+  async execute(method, inputs) {
+    return this.kwilClient.execute(
+      {
+        dbid: this.dbid,
+        name: method,
+        inputs,
+        description: `TN SDK - Executing method on stream: ${method}`
+      },
+      this.kwilSigner
+    );
+  }
+  /**
+   * Executes a method on the stream after checking if it's initialized
+   */
+  async checkedExecute(method, inputs) {
+    await this.checkInitialized();
+    return this.execute(method, inputs);
+  }
+  /**
+   * Calls a method on the stream
+   */
+  async call(method, inputs) {
+    const result = await this.kwilClient.call(
+      {
+        dbid: this.dbid,
+        name: method,
+        inputs
+      },
+      this.kwilSigner
+    );
+    if (result.status !== 200) {
+      return Either.left(result.status);
+    }
+    return Either.right(result.data?.result);
+  }
+  /**
+   * Checks if the stream is initialized
+   */
+  async checkInitialized(expectedType) {
+    if (this.initialized) {
+      return;
+    }
+    this.checkDeployed();
+    const type = await this.getType();
+    const expectedTypes = expectedType ? [expectedType] : [StreamType.Primitive, StreamType.Composed];
+    if (!expectedTypes.includes(type)) {
+      throw new Error(`Invalid stream type: ${type}`);
+    }
+    this.initialized = true;
+  }
+  /**
+   * Checks if the stream is deployed
+   */
+  async checkDeployed() {
+    if (this.deployed) {
+      return;
+    }
+    await this.loadSchema();
+    this.deployed = true;
+  }
+  /**
+   * Initializes the stream
+   */
+  async initializeStream() {
+    return this.execute("init", []);
+  }
+  /**
+   * Returns the records of the stream within the given date range
+   */
+  async getRecord(input) {
+    const result = await this.call(
+      "get_record",
+      [
+        ActionInput.fromObject({
+          $date_from: input.dateFrom,
+          $date_to: input.dateTo,
+          $frozen_at: input.frozenAt,
+          $base_date: input.baseDate
+        })
+      ]
+    );
+    return result.mapRight(
+      (result2) => result2.map((row) => ({
+        dateValue: row.date_value,
+        value: row.value
+      }))
+    ).throw();
+  }
+  /**
+   * Returns the index of the stream within the given date range
+   */
+  async getIndex(input) {
+    const result = await this.call(
+      "get_index",
+      [
+        ActionInput.fromObject({
+          $date_from: input.dateFrom,
+          $date_to: input.dateTo,
+          $frozen_at: input.frozenAt,
+          $base_date: input.baseDate
+        })
+      ]
+    );
+    return result.mapRight(
+      (result2) => result2.map((row) => ({
+        dateValue: row.date_value,
+        value: row.value
+      }))
+    ).throw();
+  }
+  /**
+   * Returns the type of the stream
+   */
+  async getType() {
+    const result = await this.getMetadata(MetadataKey.TypeKey, true);
+    if (!result) {
+      throw new Error("Failed to get stream type");
+    }
+    const type = head(result).unwrapOrElse(() => {
+      throw new Error(
+        "Failed to get stream type. Check if the stream is initialized."
+      );
+    });
+    const validTypes = [StreamType.Primitive, StreamType.Composed];
+    if (!validTypes.includes(type.value)) {
+      throw new Error(`Invalid stream type: ${type.value}`);
+    }
+    return type.value;
+  }
+  /**
+   * Returns the first record of the stream
+   */
+  async getFirstRecord(input) {
+    const result = await this.call(
+      "get_first_record",
+      [
+        ActionInput.fromObject({
+          $after_date: input.afterDate,
+          $frozen_at: input.frozenAt
+        })
+      ]
+    );
+    return result.mapRight(head).mapRight(
+      (result2) => result2.map((result3) => ({
+        dateValue: result3.date_value,
+        value: result3.value
+      })).unwrapOr(null)
+    ).throw();
+  }
+  async setMetadata(key, value) {
+    return await this.execute("insert_metadata", [
+      ActionInput.fromObject({
+        $key: key,
+        $value: value,
+        $val_type: MetadataKeyValueMap[key]
+      })
+    ]);
+  }
+  async getMetadata(key, onlyLatest = true, filteredRef) {
+    const result = await this.call("get_metadata", [
+      ActionInput.fromObject({
+        $key: key,
+        $only_latest: onlyLatest,
+        $ref: filteredRef
+      })
+    ]);
+    return result.mapRight(
+      (result2) => result2.map((row) => ({
+        rowId: row.row_id,
+        value: row[MetadataTableKey[MetadataKeyValueMap[key]]],
+        createdAt: row.created_at
+      }))
+    ).throw();
+  }
+  /**
+   * Sets the read visibility of the stream
+   */
+  async setReadVisibility(visibility) {
+    return await this.setMetadata(
+      MetadataKey.ReadVisibilityKey,
+      visibility.toString()
+    );
+  }
+  /**
+   * Returns the read visibility of the stream
+   */
+  async getReadVisibility() {
+    const result = await this.getMetadata(MetadataKey.ReadVisibilityKey, true);
+    return head(result).map((row) => toVisibilityEnum(row.value)).unwrapOr(null);
+  }
+  /**
+   * Sets the compose visibility of the stream
+   */
+  async setComposeVisibility(visibility) {
+    return await this.setMetadata(
+      MetadataKey.ComposeVisibilityKey,
+      visibility.toString()
+    );
+  }
+  /**
+   * Returns the compose visibility of the stream
+   */
+  async getComposeVisibility() {
+    const result = await this.getMetadata(
+      MetadataKey.ComposeVisibilityKey,
+      true
+    );
+    return head(result).map((row) => toVisibilityEnum(row.value)).unwrapOr(null);
+  }
+  /**
+   * Allows a wallet to read the stream
+   */
+  async allowReadWallet(wallet) {
+    return await this.setMetadata(
+      MetadataKey.AllowReadWalletKey,
+      wallet.getAddress()
+    );
+  }
+  /**
+   * Disables a wallet from reading the stream
+   */
+  async disableReadWallet(wallet) {
+    const result = await this.getMetadata(
+      MetadataKey.AllowReadWalletKey,
+      true,
+      wallet.getAddress()
+    );
+    const row_id = head(result).map((row) => row.rowId).unwrapOr(null);
+    if (!row_id) {
+      throw new Error("Wallet not found in allowed list");
+    }
+    return await this.disableMetadata(row_id);
+  }
+  /**
+   * Allows a stream to use this stream as child
+   */
+  async allowComposeStream(locator) {
+    const streamDbId = generateDBID(
+      locator.dataProvider.getAddress(),
+      locator.streamId.getId()
+    );
+    return await this.setMetadata(
+      MetadataKey.AllowComposeStreamKey,
+      streamDbId
+    );
+  }
+  /**
+   * Disables a stream from using this stream as child
+   */
+  async disableComposeStream(locator) {
+    const result = await this.getMetadata(
+      MetadataKey.AllowComposeStreamKey,
+      true,
+      locator.toString()
+    );
+    const row_id = head(result).map((row) => row.rowId).unwrapOr(null);
+    if (!row_id) {
+      throw new Error("Stream not found in allowed list");
+    }
+    return await this.disableMetadata(row_id);
+  }
+  async disableMetadata(rowId) {
+    return await this.execute("disable_metadata", [
+      ActionInput.fromObject({
+        $row_id: rowId
+      })
+    ]);
+  }
+  /**
+   * Returns the wallets allowed to read the stream
+   */
+  async getAllowedReadWallets() {
+    const result = await this.getMetadata(MetadataKey.AllowReadWalletKey);
+    return result.filter((row) => row.value).map((row) => new EthereumAddress(row.value));
+  }
+  /**
+   * Returns the streams allowed to compose the stream
+   */
+  async getAllowedComposeStreams() {
+    const result = await this.getMetadata(MetadataKey.AllowComposeStreamKey);
+    return result.filter((row) => row.value).map((row) => {
+      const [streamId, dataProvider] = row.value.split(":");
+      return {
+        streamId: StreamId.fromString(streamId).throw(),
+        dataProvider: new EthereumAddress(dataProvider)
+      };
+    });
+  }
+  /**
+   * Returns the index change of the stream within the given date range
+   */
+  async getIndexChange(input) {
+    const result = await this.call(
+      "get_index_change",
+      [
+        ActionInput.fromObject({
+          $date_from: input.dateFrom,
+          $date_to: input.dateTo,
+          $frozen_at: input.frozenAt,
+          $base_date: input.baseDate,
+          $days_interval: input.daysInterval
+        })
+      ]
+    );
+    return result.mapRight(
+      (result2) => result2.map((row) => ({
+        dateValue: row.date_value,
+        value: row.value
+      }))
+    ).throw();
+  }
+};
+export {
+  Stream
+};
+//# sourceMappingURL=stream.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/contracts-api/stream.ts"],
+  "sourcesContent": ["import { KwilSigner, NodeKwil, WebKwil } from \"@kwilteam/kwil-js\";\nimport { ActionInput } from \"@kwilteam/kwil-js/dist/core/action\";\nimport { Database } from \"@kwilteam/kwil-js/dist/core/database\";\nimport { GenericResponse } from \"@kwilteam/kwil-js/dist/core/resreq\";\nimport { TxReceipt } from \"@kwilteam/kwil-js/dist/core/tx\";\nimport { generateDBID } from \"@kwilteam/kwil-js/dist/utils/dbid\";\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\";\n\nexport interface GetRecordInput {\n  dateFrom?: DateString;\n  dateTo?: DateString;\n  frozenAt?: number;\n  baseDate?: DateString;\n}\n\nexport interface GetFirstRecordInput {\n  afterDate?: DateString;\n  frozenAt?: DateString;\n}\n\nexport interface StreamRecord {\n  dateValue: DateString;\n  value: string;\n}\n\nexport interface GetIndexChangeInput extends GetRecordInput {\n  daysInterval: number;\n}\n\nexport class Stream {\n  protected kwilClient: WebKwil | NodeKwil;\n  protected kwilSigner: KwilSigner;\n  protected locator: StreamLocator;\n  protected dbid: string;\n  protected schema?: Database;\n  protected deployed: boolean = false;\n  protected initialized: boolean = false;\n  constructor(\n    kwilClient: WebKwil | NodeKwil,\n    kwilSigner: KwilSigner,\n    locator: StreamLocator,\n  ) {\n    this.kwilClient = kwilClient;\n    this.kwilSigner = kwilSigner;\n    this.locator = locator;\n    this.dbid = generateDBID(\n      locator.dataProvider.getAddress(),\n      locator.streamId.getId(),\n    );\n  }\n\n  /**\n   * Loads the schema for this stream from the network.\n   * Throws if the stream is not deployed.\n   */\n  public async loadSchema(): Promise<void> {\n    const response = await this.kwilClient.getSchema(this.dbid);\n    if (response.status !== 200 || !response.data) {\n      throw new Error(\n        `Failed to load schema for stream ${this.locator.streamId.getId()}`,\n      );\n    }\n    this.schema = response.data;\n  }\n\n  /**\n   * Executes a method on the stream\n   */\n  protected async execute(\n    method: string,\n    inputs: ActionInput[],\n  ): Promise<GenericResponse<TxReceipt>> {\n    return this.kwilClient.execute(\n      {\n        dbid: this.dbid,\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 after checking if it's initialized\n   */\n  protected async checkedExecute(\n    method: string,\n    inputs: ActionInput[],\n  ): Promise<GenericResponse<TxReceipt>> {\n    await this.checkInitialized();\n    return this.execute(method, inputs);\n  }\n\n  /**\n   * Calls a method on the stream\n   */\n  protected async call<T>(\n    method: string,\n    inputs: ActionInput[],\n  ): Promise<Either<number, T>> {\n    const result = await this.kwilClient.call(\n      {\n        dbid: this.dbid,\n        name: method,\n        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   * Checks if the stream is initialized\n   */\n  protected async checkInitialized(expectedType?: StreamType): Promise<void> {\n    if (this.initialized) {\n      return;\n    }\n\n    this.checkDeployed();\n\n    // check if is initialized by trying to get its type\n    const type = await this.getType();\n\n    // check if type is valid\n    const expectedTypes = expectedType\n      ? [expectedType]\n      : [StreamType.Primitive, StreamType.Composed];\n    if (!expectedTypes.includes(type)) {\n      throw new Error(`Invalid stream type: ${type}`);\n    }\n\n    this.initialized = true;\n  }\n\n  /**\n   * Checks if the stream is deployed\n   */\n  protected async checkDeployed(): Promise<void> {\n    if (this.deployed) {\n      return;\n    }\n    await this.loadSchema();\n    this.deployed = true;\n  }\n\n  /**\n   * Initializes the stream\n   */\n  public async initializeStream(): Promise<GenericResponse<TxReceipt>> {\n    // shouldn't use checkedExecute, because it's not initialized yet\n    return this.execute(\"init\", []);\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    // TODO: change value to string when kwil-js is updated\n    const result = await this.call<{ date_value: string; value: string }[]>(\n      \"get_record\",\n      [\n        ActionInput.fromObject({\n          $date_from: input.dateFrom,\n          $date_to: input.dateTo,\n          $frozen_at: input.frozenAt,\n          $base_date: input.baseDate,\n        }),\n      ],\n    );\n    return result\n      .mapRight((result) =>\n        result.map((row) => ({\n          dateValue: row.date_value,\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 result = await this.call<{ date_value: string; value: string }[]>(\n      \"get_index\",\n      [\n        ActionInput.fromObject({\n          $date_from: input.dateFrom,\n          $date_to: input.dateTo,\n          $frozen_at: input.frozenAt,\n          $base_date: input.baseDate,\n        }),\n      ],\n    );\n    return result\n      .mapRight((result) =>\n        result.map((row) => ({\n          dateValue: row.date_value,\n          value: row.value,\n        })),\n      )\n      .throw();\n  }\n\n  /**\n   * Returns the type of the stream\n   */\n  public async getType(): Promise<StreamType> {\n    const result = await this.getMetadata(MetadataKey.TypeKey, true);\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<{ date_value: string; value: string }[]>(\n      \"get_first_record\",\n      [\n        ActionInput.fromObject({\n          $after_date: input.afterDate,\n          $frozen_at: input.frozenAt,\n        }),\n      ],\n    );\n\n    return result\n      .mapRight(head)\n      .mapRight((result) =>\n        result\n          .map((result) => ({\n            dateValue: result.date_value,\n            value: result.value,\n          }))\n          .unwrapOr(null),\n      )\n      .throw();\n  }\n\n  protected async setMetadata<K extends MetadataKey>(\n    key: K,\n    value: MetadataValueTypeForKey<K>,\n  ): Promise<GenericResponse<TxReceipt>> {\n    return await this.execute(\"insert_metadata\", [\n      ActionInput.fromObject({\n        $key: key,\n        $value: value,\n        $val_type: MetadataKeyValueMap[key],\n      }),\n    ]);\n  }\n\n  protected async getMetadata<K extends MetadataKey>(\n    key: K,\n    onlyLatest: boolean = true,\n    filteredRef?: 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      ActionInput.fromObject({\n        $key: key,\n        $only_latest: onlyLatest,\n        $ref: filteredRef,\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    visibility: VisibilityEnum,\n  ): Promise<GenericResponse<TxReceipt>> {\n    return await this.setMetadata(\n      MetadataKey.ReadVisibilityKey,\n      visibility.toString(),\n    );\n  }\n\n  /**\n   * Returns the read visibility of the stream\n   */\n  public async getReadVisibility(): Promise<VisibilityEnum | null> {\n    const result = await this.getMetadata(MetadataKey.ReadVisibilityKey, true);\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    visibility: VisibilityEnum,\n  ): Promise<GenericResponse<TxReceipt>> {\n    return await this.setMetadata(\n      MetadataKey.ComposeVisibilityKey,\n      visibility.toString(),\n    );\n  }\n\n  /**\n   * Returns the compose visibility of the stream\n   */\n  public async getComposeVisibility(): Promise<VisibilityEnum | null> {\n    const result = await this.getMetadata(\n      MetadataKey.ComposeVisibilityKey,\n      true,\n    );\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    wallet: EthereumAddress,\n  ): Promise<GenericResponse<TxReceipt>> {\n    return await this.setMetadata(\n      MetadataKey.AllowReadWalletKey,\n      wallet.getAddress(),\n    );\n  }\n\n  /**\n   * Disables a wallet from reading the stream\n   */\n  public async disableReadWallet(\n    wallet: EthereumAddress,\n  ): Promise<GenericResponse<TxReceipt>> {\n    const result = await this.getMetadata(\n      MetadataKey.AllowReadWalletKey,\n      true,\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(row_id);\n  }\n\n  /**\n   * Allows a stream to use this stream as child\n   */\n  public async allowComposeStream(\n    locator: StreamLocator,\n  ): Promise<GenericResponse<TxReceipt>> {\n    const streamDbId = generateDBID(\n      locator.dataProvider.getAddress(),\n      locator.streamId.getId(),\n    );\n    return await this.setMetadata(\n      MetadataKey.AllowComposeStreamKey,\n      streamDbId,\n    );\n  }\n\n  /**\n   * Disables a stream from using this stream as child\n   */\n  public async disableComposeStream(\n    locator: StreamLocator,\n  ): Promise<GenericResponse<TxReceipt>> {\n    const result = await this.getMetadata(\n      MetadataKey.AllowComposeStreamKey,\n      true,\n      locator.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(row_id);\n  }\n\n  protected async disableMetadata(\n    rowId: string,\n  ): Promise<GenericResponse<TxReceipt>> {\n    return await this.execute(\"disable_metadata\", [\n      ActionInput.fromObject({\n        $row_id: rowId,\n      }),\n    ]);\n  }\n\n  /**\n   * Returns the wallets allowed to read the stream\n   */\n  public async getAllowedReadWallets(): Promise<EthereumAddress[]> {\n    const result = await this.getMetadata(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(): Promise<StreamLocator[]> {\n    const result = await this.getMetadata(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<{ date_value: string; value: string }[]>(\n      \"get_index_change\",\n      [\n        ActionInput.fromObject({\n          $date_from: input.dateFrom,\n          $date_to: input.dateTo,\n          $frozen_at: input.frozenAt,\n          $base_date: input.baseDate,\n          $days_interval: input.daysInterval,\n        }),\n      ],\n    );\n\n    return result\n      .mapRight((result) =>\n        result.map((row) => ({\n          dateValue: row.date_value,\n          value: row.value,\n        })),\n      )\n      .throw();\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["result"]
+}

package/dist/esm/index.browser.mjs

@@ -0,0 +1,7 @@
+// src/index.browser.ts
+import { BrowserTNClient } from "./client/browserClient.mjs";
+export * from "./index.common.mjs";
+export {
+  BrowserTNClient
+};
+//# sourceMappingURL=index.browser.mjs.map

package/dist/esm/index.browser.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/index.browser.ts"],
+  "sourcesContent": ["// Browser/Web exports\nexport { BrowserTNClient } from \"./client/browserClient\";\nexport * from \"./index.common\";\n"],
+  "mappings": ";AACA,SAAS,uBAAuB;AAChC,cAAc;",
+  "names": []
+}

package/dist/esm/index.common.mjs

@@ -0,0 +1,18 @@
+// src/index.common.ts
+import { StreamId } from "./util/StreamId.mjs";
+import { EthereumAddress } from "./util/EthereumAddress.mjs";
+import { visibility } from "./util/visibility.mjs";
+import { StreamType } from "./contracts-api/contractValues.mjs";
+import { Stream } from "./contracts-api/stream.mjs";
+import { PrimitiveStream } from "./contracts-api/primitiveStream.mjs";
+import { ComposedStream } from "./contracts-api/composedStream.mjs";
+export {
+  ComposedStream,
+  EthereumAddress,
+  PrimitiveStream,
+  Stream,
+  StreamId,
+  StreamType,
+  visibility
+};
+//# sourceMappingURL=index.common.mjs.map

package/dist/esm/index.common.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/index.common.ts"],
+  "sourcesContent": ["// Core client types\nexport type { TNClientOptions } from \"./client/client\";\nexport type { SignerInfo as EthProvider } from \"./client/client\";\n\n// Stream types and interfaces\nexport type { StreamLocator } from \"./types/stream\";\nexport type { StreamRecord } from \"./contracts-api/stream\";\nexport type { GetRecordInput, GetFirstRecordInput } from \"./contracts-api/stream\";\nexport type { InsertRecordInput } from \"./contracts-api/primitiveStream\";\nexport type { TaxonomySet, TaxonomyItem } from \"./contracts-api/composedStream\";\n\n// Utility types and classes\nexport { StreamId } from \"./util/StreamId\";\nexport { EthereumAddress } from \"./util/EthereumAddress\";\nexport { visibility } from \"./util/visibility\";\nexport type { VisibilityEnum } from \"./util/visibility\";\n\n// Stream type constants\nexport { StreamType } from \"./contracts-api/contractValues\";\n\n// Base classes\nexport { Stream } from \"./contracts-api/stream\";\nexport { PrimitiveStream } from \"./contracts-api/primitiveStream\";\nexport { ComposedStream } from \"./contracts-api/composedStream\";\n\n"],
+  "mappings": ";AAYA,SAAS,gBAAgB;AACzB,SAAS,uBAAuB;AAChC,SAAS,kBAAkB;AAI3B,SAAS,kBAAkB;AAG3B,SAAS,cAAc;AACvB,SAAS,uBAAuB;AAChC,SAAS,sBAAsB;",
+  "names": []
+}

package/dist/esm/index.mjs

@@ -0,0 +1,9 @@
+// src/index.ts
+import { BrowserTNClient } from "./client/browserClient.mjs";
+import { NodeTNClient } from "./client/nodeClient.mjs";
+export * from "./index.common.mjs";
+export {
+  BrowserTNClient,
+  NodeTNClient
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/index.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/index.ts"],
+  "sourcesContent": ["// All exports, to provide types for both browser and node\nexport { BrowserTNClient } from \"./client/browserClient\";\nexport { NodeTNClient } from \"./client/nodeClient\";\nexport * from \"./index.common\";\n"],
+  "mappings": ";AACA,SAAS,uBAAuB;AAChC,SAAS,oBAAoB;AAC7B,cAAc;",
+  "names": []
+}

package/dist/esm/index.node.mjs

@@ -0,0 +1,7 @@
+// src/index.node.ts
+import { NodeTNClient } from "./client/nodeClient.mjs";
+export * from "./index.common.mjs";
+export {
+  NodeTNClient
+};
+//# sourceMappingURL=index.node.mjs.map

package/dist/esm/index.node.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/index.node.ts"],
+  "sourcesContent": ["// Node.js exports  \nexport { NodeTNClient } from \"./client/nodeClient\";\nexport * from \"./index.common\";\n"],
+  "mappings": ";AACA,SAAS,oBAAoB;AAC7B,cAAc;",
+  "names": []
+}

package/dist/esm/types/other.mjs

@@ -0,0 +1 @@
+//# sourceMappingURL=other.mjs.map

package/dist/esm/types/other.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/esm/types/stream.mjs

@@ -0,0 +1 @@
+//# sourceMappingURL=stream.mjs.map

package/dist/esm/types/stream.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/esm/util/EthereumAddress.mjs

@@ -0,0 +1,90 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/util/EthereumAddress.ts
+import { ethers } from "ethers";
+import { left, right } from "monads-io/either";
+var EthereumAddress = class _EthereumAddress {
+  constructor(address) {
+    __publicField(this, "address");
+    __publicField(this, "correctlyCreated", false);
+    address = address.toLowerCase();
+    if (!address.startsWith("0x")) {
+      address = "0x" + address;
+    }
+    if (!this.validateEthereumAddress(address)) {
+      throw new Error("Invalid Ethereum address");
+    }
+    this.address = address;
+    this.correctlyCreated = true;
+  }
+  validateEthereumAddress(address) {
+    return /^(0x)?[0-9a-f]{40}$/i.test(address);
+  }
+  getAddress() {
+    if (!this.correctlyCreated) {
+      throw new Error("EthereumAddress not correctly created");
+    }
+    return this.address;
+  }
+  getBytes() {
+    return new TextEncoder().encode(this.getAddress());
+  }
+  toJSON() {
+    return this.getAddress();
+  }
+  static fromJSON(json) {
+    return new _EthereumAddress(json);
+  }
+  static fromBytes(bytes) {
+    try {
+      return right(new _EthereumAddress(ethers.hexlify(bytes)));
+    } catch (e) {
+      return left(e);
+    }
+  }
+  static fromString(str) {
+    try {
+      return right(new _EthereumAddress(str));
+    } catch (e) {
+      return left(e);
+    }
+  }
+};
+if (import.meta.vitest) {
+  const { describe, it, expect } = import.meta.vitest;
+  describe("EthereumAddress", () => {
+    it("should create a valid EthereumAddress with correct format", () => {
+      const address = new EthereumAddress(
+        "0x1234567890123456789012345678901234567890"
+      );
+      expect(address.getAddress()).toBe(
+        "0x1234567890123456789012345678901234567890"
+      );
+    });
+    it("should throw an error for an invalid Ethereum address", () => {
+      expect(() => new EthereumAddress("invalid_address")).toThrow(
+        "Invalid Ethereum address"
+      );
+    });
+    it("should enforce lowercase addresses", () => {
+      const mixedCaseAddress = "0xaaBbccDdEeff1234567890123456789012345678".toLowerCase();
+      const address = new EthereumAddress(mixedCaseAddress);
+      expect(address.getAddress()).toBe(
+        "0xaabbccddeeff1234567890123456789012345678"
+      );
+    });
+    it("should correctly serialize and deserialize to/from JSON", () => {
+      const originalAddress = "0x1234567890123456789012345678901234567890";
+      const address = new EthereumAddress(originalAddress);
+      const json = address.toJSON();
+      const deserializedAddress = EthereumAddress.fromJSON(json);
+      expect(deserializedAddress.getAddress()).toBe(originalAddress);
+    });
+  });
+}
+export {
+  EthereumAddress
+};
+//# sourceMappingURL=EthereumAddress.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/util/EthereumAddress.ts"],
+  "sourcesContent": ["import { ethers } from \"ethers\";\nimport { Either, left, right } from \"monads-io/either\";\n\nexport class EthereumAddress {\n  private readonly address: string;\n  private readonly correctlyCreated: boolean = false;\n\n  constructor(address: string) {\n    address = address.toLowerCase();\n    if (!address.startsWith(\"0x\")) {\n      address = \"0x\" + address;\n    }\n\n    if (!this.validateEthereumAddress(address)) {\n      throw new Error(\"Invalid Ethereum address\");\n    }\n\n    this.address = address;\n    this.correctlyCreated = true;\n  }\n\n  private validateEthereumAddress(address: string): boolean {\n    return /^(0x)?[0-9a-f]{40}$/i.test(address);\n  }\n\n  public getAddress(): string {\n    if (!this.correctlyCreated) {\n      throw new Error(\"EthereumAddress not correctly created\");\n    }\n\n    return this.address;\n  }\n\n  public getBytes(): Uint8Array {\n    return new TextEncoder().encode(this.getAddress());\n  }\n\n  public toJSON(): string {\n    return this.getAddress();\n  }\n\n  public static fromJSON(json: string): EthereumAddress {\n    return new EthereumAddress(json);\n  }\n\n  public static fromBytes(bytes: Uint8Array): Either<Error, EthereumAddress> {\n    try {\n      return right(new EthereumAddress(ethers.hexlify(bytes)));\n    } catch (e) {\n      return left(e as Error);\n    }\n  }\n\n  public static fromString(str: string): Either<Error, EthereumAddress> {\n    try {\n      return right(new EthereumAddress(str));\n    } catch (e) {\n      return left(e as Error);\n    }\n  }\n}\n\nif (import.meta.vitest) {\n  const { describe, it, expect } = import.meta.vitest;\n  describe(\"EthereumAddress\", () => {\n    it(\"should create a valid EthereumAddress with correct format\", () => {\n      const address = new EthereumAddress(\n        \"0x1234567890123456789012345678901234567890\",\n      );\n      expect(address.getAddress()).toBe(\n        \"0x1234567890123456789012345678901234567890\",\n      );\n    });\n\n    it(\"should throw an error for an invalid Ethereum address\", () => {\n      expect(() => new EthereumAddress(\"invalid_address\")).toThrow(\n        \"Invalid Ethereum address\",\n      );\n    });\n\n    it(\"should enforce lowercase addresses\", () => {\n      const mixedCaseAddress =\n        \"0xaaBbccDdEeff1234567890123456789012345678\".toLowerCase();\n      const address = new EthereumAddress(mixedCaseAddress);\n      expect(address.getAddress()).toBe(\n        \"0xaabbccddeeff1234567890123456789012345678\",\n      );\n    });\n\n    it(\"should correctly serialize and deserialize to/from JSON\", () => {\n      const originalAddress = \"0x1234567890123456789012345678901234567890\";\n      const address = new EthereumAddress(originalAddress);\n      const json = address.toJSON();\n      const deserializedAddress = EthereumAddress.fromJSON(json);\n      expect(deserializedAddress.getAddress()).toBe(originalAddress);\n    });\n  });\n}\n"],
+  "mappings": ";;;;;AAAA,SAAS,cAAc;AACvB,SAAiB,MAAM,aAAa;AAE7B,IAAM,kBAAN,MAAM,iBAAgB;AAAA,EAI3B,YAAY,SAAiB;AAH7B,wBAAiB;AACjB,wBAAiB,oBAA4B;AAG3C,cAAU,QAAQ,YAAY;AAC9B,QAAI,CAAC,QAAQ,WAAW,IAAI,GAAG;AAC7B,gBAAU,OAAO;AAAA,IACnB;AAEA,QAAI,CAAC,KAAK,wBAAwB,OAAO,GAAG;AAC1C,YAAM,IAAI,MAAM,0BAA0B;AAAA,IAC5C;AAEA,SAAK,UAAU;AACf,SAAK,mBAAmB;AAAA,EAC1B;AAAA,EAEQ,wBAAwB,SAA0B;AACxD,WAAO,uBAAuB,KAAK,OAAO;AAAA,EAC5C;AAAA,EAEO,aAAqB;AAC1B,QAAI,CAAC,KAAK,kBAAkB;AAC1B,YAAM,IAAI,MAAM,uCAAuC;AAAA,IACzD;AAEA,WAAO,KAAK;AAAA,EACd;AAAA,EAEO,WAAuB;AAC5B,WAAO,IAAI,YAAY,EAAE,OAAO,KAAK,WAAW,CAAC;AAAA,EACnD;AAAA,EAEO,SAAiB;AACtB,WAAO,KAAK,WAAW;AAAA,EACzB;AAAA,EAEA,OAAc,SAAS,MAA+B;AACpD,WAAO,IAAI,iBAAgB,IAAI;AAAA,EACjC;AAAA,EAEA,OAAc,UAAU,OAAmD;AACzE,QAAI;AACF,aAAO,MAAM,IAAI,iBAAgB,OAAO,QAAQ,KAAK,CAAC,CAAC;AAAA,IACzD,SAAS,GAAG;AACV,aAAO,KAAK,CAAU;AAAA,IACxB;AAAA,EACF;AAAA,EAEA,OAAc,WAAW,KAA6C;AACpE,QAAI;AACF,aAAO,MAAM,IAAI,iBAAgB,GAAG,CAAC;AAAA,IACvC,SAAS,GAAG;AACV,aAAO,KAAK,CAAU;AAAA,IACxB;AAAA,EACF;AACF;AAEA,IAAI,YAAY,QAAQ;AACtB,QAAM,EAAE,UAAU,IAAI,OAAO,IAAI,YAAY;AAC7C,WAAS,mBAAmB,MAAM;AAChC,OAAG,6DAA6D,MAAM;AACpE,YAAM,UAAU,IAAI;AAAA,QAClB;AAAA,MACF;AACA,aAAO,QAAQ,WAAW,CAAC,EAAE;AAAA,QAC3B;AAAA,MACF;AAAA,IACF,CAAC;AAED,OAAG,yDAAyD,MAAM;AAChE,aAAO,MAAM,IAAI,gBAAgB,iBAAiB,CAAC,EAAE;AAAA,QACnD;AAAA,MACF;AAAA,IACF,CAAC;AAED,OAAG,sCAAsC,MAAM;AAC7C,YAAM,mBACJ,6CAA6C,YAAY;AAC3D,YAAM,UAAU,IAAI,gBAAgB,gBAAgB;AACpD,aAAO,QAAQ,WAAW,CAAC,EAAE;AAAA,QAC3B;AAAA,MACF;AAAA,IACF,CAAC;AAED,OAAG,2DAA2D,MAAM;AAClE,YAAM,kBAAkB;AACxB,YAAM,UAAU,IAAI,gBAAgB,eAAe;AACnD,YAAM,OAAO,QAAQ,OAAO;AAC5B,YAAM,sBAAsB,gBAAgB,SAAS,IAAI;AACzD,aAAO,oBAAoB,WAAW,CAAC,EAAE,KAAK,eAAe;AAAA,IAC/D,CAAC;AAAA,EACH,CAAC;AACH;",
+  "names": []
+}