@arkiv-network/sdk 0.1.0 → 0.1.2-dev.0

package/dist/queryBuilder-BueP5de6.js

@@ -0,0 +1,341 @@
+import { bytesToString, toBytes } from "viem";
+
+//#region src/query/errors.ts
+var NoMoreResultsError = class extends Error {
+	constructor() {
+		super("No more results");
+	}
+};
+var NoCursorOrLimitError = class extends Error {
+	constructor() {
+		super("Cursor and limit must be defined to fetch next");
+	}
+};
+var OffsetCannotBeLessThanZeroError = class extends Error {
+	constructor() {
+		super("Offset cannot be less than 0");
+	}
+};
+var NoEntityFoundError = class extends Error {
+	constructor() {
+		super("No entity found");
+	}
+};
+
+//#endregion
+//#region src/types/entity.ts
+var Entity = class {
+	key;
+	owner;
+	expiresAtBlock;
+	payload;
+	attributes;
+	contentType;
+	constructor(key, contentType, owner, expiresAtBlock, payload, attributes) {
+		this.key = key;
+		this.owner = owner;
+		this.expiresAtBlock = expiresAtBlock;
+		this.payload = payload;
+		this.attributes = attributes;
+		this.contentType = contentType;
+	}
+	toText() {
+		return bytesToString(this.payload);
+	}
+	toJson() {
+		return JSON.parse(bytesToString(this.payload));
+	}
+};
+
+//#endregion
+//#region src/utils/entities.ts
+async function entityFromRpcResult(rpcEntity) {
+	return new Entity(rpcEntity.key, rpcEntity.contentType, rpcEntity.owner, rpcEntity.expiresAt, toBytes(rpcEntity.value), [...(rpcEntity.stringAttributes ?? []).map(({ key, value }) => ({
+		key,
+		value
+	})), ...(rpcEntity.numericAttributes ?? []).map(({ key, value }) => ({
+		key,
+		value: Number(value)
+	}))]);
+}
+
+//#endregion
+//#region src/query/engine.ts
+function processPredicates(predicates) {
+	const processValue = (value) => {
+		if (typeof value === "string") return `"${value}"`;
+		return value;
+	};
+	return predicates.map((predicate) => {
+		switch (predicate.type) {
+			case "eq": return `${predicate.key} = ${processValue(predicate.value)}`;
+			case "neq": return `${predicate.key} != ${processValue(predicate.value)}`;
+			case "gt": return `${predicate.key} > ${processValue(predicate.value)}`;
+			case "gte": return `${predicate.key} >= ${processValue(predicate.value)}`;
+			case "lt": return `${predicate.key} < ${processValue(predicate.value)}`;
+			case "lte": return `${predicate.key} <= ${processValue(predicate.value)}`;
+			case "not": return `!${predicate.key}`;
+			case "or": return `(${predicate.predicates.map((predicate$1) => processPredicates([predicate$1])).join(" || ")})`;
+			case "and": return `(${predicate.predicates.map((predicate$1) => processPredicates([predicate$1])).join(" && ")})`;
+			default: return "";
+		}
+	}).join(" && ");
+}
+async function processQuery(client, queryParams) {
+	const { predicates, limit, cursor, ownedBy, validAtBlock, withAttributes, withMetadata, withPayload } = queryParams;
+	console.debug(`Processing query with params: predicates: ${predicates}, cursor: ${cursor}, limit: ${limit}, ownedBy: ${ownedBy}, validAtBlock: ${validAtBlock}, withAttributes: ${withAttributes}, withMetadata: ${withMetadata}, withPayload: ${withPayload}`);
+	let query = processPredicates(predicates);
+	if (ownedBy) query += ` && $owner=${ownedBy}`;
+	query = query.trim();
+	if (query.startsWith("&& ")) query = query.slice(3);
+	const queryOptions = { includeData: {
+		key: true,
+		attributes: withAttributes ?? false,
+		payload: withPayload ?? false,
+		contentType: withMetadata ?? false,
+		expiration: withMetadata ?? false,
+		owner: withMetadata ?? false
+	} };
+	if (validAtBlock !== void 0) queryOptions.atBlock = Number(validAtBlock);
+	if (limit !== void 0) queryOptions.resultsPerPage = limit;
+	if (cursor !== void 0) queryOptions.cursor = cursor;
+	console.debug(`Built query to send: ${query}, queryOptions: ${JSON.stringify({
+		includeData: queryOptions.includeData,
+		atBlock: queryOptions.atBlock?.toString(),
+		resultsPerPage: queryOptions.resultsPerPage,
+		cursor: queryOptions.cursor
+	})}`);
+	const result = await client.request({
+		method: "arkiv_query",
+		params: [query, queryOptions]
+	});
+	console.debug("Raw result from query: ", result);
+	return result;
+}
+
+//#endregion
+//#region src/query/queryResult.ts
+var QueryResult = class {
+	entities;
+	_endOfIteration;
+	_cursor;
+	_limit;
+	_validAtBlock;
+	_queryBuilder;
+	get queryBuilder() {
+		return this._queryBuilder;
+	}
+	get cursor() {
+		return this._cursor;
+	}
+	constructor(entities, queryBuilder, cursor, limit, validAtBlock) {
+		this.entities = entities;
+		this._queryBuilder = queryBuilder;
+		this._endOfIteration = !limit || entities.length < limit;
+		this._cursor = cursor;
+		this._limit = limit;
+		this._validAtBlock = validAtBlock;
+	}
+	async next() {
+		if (this._cursor === void 0 || this._limit === void 0) throw new NoCursorOrLimitError();
+		if (this._endOfIteration) throw new NoMoreResultsError();
+		this._queryBuilder.cursor(this._cursor);
+		const result = await this._queryBuilder.fetch();
+		this.entities = result.entities;
+		this._queryBuilder = result.queryBuilder;
+		this._endOfIteration = !result.cursor || result.entities.length < this._limit;
+		this._cursor = result.cursor;
+		console.debug("Current block height for next page: ", this._validAtBlock);
+	}
+	hasNextPage() {
+		return !this._endOfIteration;
+	}
+};
+
+//#endregion
+//#region src/query/queryBuilder.ts
+/**
+* QueryBuilder is a helper class to build queries to the Arkiv DBChains.
+* It can be used to fetch entities from the Arkiv DBChains. It follows the Builder pattern allowing chaining of methods.
+* @param client - The Arkiv client
+* @returns The QueryBuilder instance {@link QueryBuilder}
+*/
+var QueryBuilder = class {
+	_client;
+	_ownedBy;
+	_validAtBlock;
+	_withAttributes;
+	_withMetadata;
+	_withPayload;
+	_limit;
+	_cursor;
+	_predicates;
+	constructor(client) {
+		this._client = client;
+		this._predicates = [];
+	}
+	/**
+	* Sets the ownedBy filter
+	* @param ownedBy - The address of the owner
+	* @returns The QueryBuilder instance
+	*
+	* @example
+	* const builder = new QueryBuilder(client)
+	* builder.ownedBy("0x1234567890123456789012345678901234567890")
+	*/
+	ownedBy(ownedBy) {
+		this._ownedBy = ownedBy;
+		return this;
+	}
+	/**
+	* Sets the withAttributes flag which will return the attributes for the entities if true
+	* @param withAttributes - The boolean value to set
+	* @returns The QueryBuilder instance
+	*
+	* @example
+	* const builder = new QueryBuilder(client)
+	* builder.withAttributes(true)
+	*/
+	withAttributes(withAttributes = true) {
+		this._withAttributes = withAttributes;
+		return this;
+	}
+	/**
+	* Sets the withMetadata flag which will return the metadata (like owner, expiredAt, etc.) for the entities if true
+	* @param withMetadata - The boolean value to set
+	* @returns The QueryBuilder instance
+	*
+	* @example
+	* const builder = new QueryBuilder(client)
+	* builder.withMetadata(true)
+	*/
+	withMetadata(withMetadata = true) {
+		this._withMetadata = withMetadata;
+		return this;
+	}
+	/**
+	* Sets the withPayload flag which will return the payload for the entities if true
+	* @param withPayload - The boolean value to set
+	* @returns The QueryBuilder instance
+	*
+	* @example
+	* const builder = new QueryBuilder(client)
+	* builder.withPayload(true)
+	*/
+	withPayload(withPayload = true) {
+		this._withPayload = withPayload;
+		return this;
+	}
+	/**
+	* Sets the limit for the query
+	* @param limit - The number of entities to return
+	* @returns The QueryBuilder instance
+	*
+	* @example
+	* const builder = new QueryBuilder(client)
+	* builder.limit(10)
+	*/
+	limit(limit) {
+		this._limit = limit;
+		return this;
+	}
+	/**
+	* Sets the cursor for the query - it is advances setting which rather shouldn't be used manually but it is provided from query result if limit is used (pagination).
+	* @param cursor - The cursor to set which tells to RPC Query server where to start or continue the query.
+	* @returns The QueryBuilder instance
+	*
+	* @example
+	* const builder = new QueryBuilder(client)
+	* builder.offset(10)
+	*/
+	cursor(cursor) {
+		this._cursor = cursor;
+		return this;
+	}
+	/**
+	* Sets the validAtBlock for the query which tells at which block height the state we are intested.
+	* If not set, the latest block is  used.
+	* @param validAtBlock - The block number to set
+	* @returns The QueryBuilder instance
+	*
+	* @example
+	* const builder = new QueryBuilder(client)
+	* builder.validAtBlock(10000)
+	*/
+	validAtBlock(validAtBlock) {
+		this._validAtBlock = validAtBlock;
+		return this;
+	}
+	/**
+	* Sets the predicates for the query limiting the results. It can be a single predicate or an array of predicates combined with 'and'.
+	* Predicates can be nested using 'or' and 'and' predicates.
+	* @param predicates - The predicates to set
+	* @returns The QueryBuilder instance
+	*
+	* @example
+	* const builder = new QueryBuilder(client)
+	* builder.where(eq("name", "John"))
+	* builder.where([eq("name", "John"), eq("age", 30)])
+	* builder.where([eq("name", "John"), or([eq("age", 30), eq("age", 31)])])
+	* builder.where([eq("name", "John"), and([eq("age", 30), eq("age", 31)])])
+	* builder.where([eq("name", "John"), or([eq("age", 30), and([eq("age", 31), eq("age", 32)])])])
+	* builder.where([eq("name", "John"), and([eq("age", 30), or([eq("age", 31), eq("age", 32)])])])
+	* builder.where([eq("name", "John"), and([eq("age", 30), or([eq("age", 31), and([eq("age", 32), eq("age", 33)])])])])
+	*/
+	where(predicates) {
+		if (Array.isArray(predicates)) this._predicates.push(...predicates);
+		else this._predicates.push(predicates);
+		return this;
+	}
+	/**
+	* Fetches the entities from the query. Re
+	* It will return a QueryResult instance which can be used to fetch the next and previous pages.
+	* @returns The QueryResult instance {@link QueryResult}
+	*
+	* @example
+	* const builder = new QueryBuilder(client)
+	* const result = await builder.where(eq("name", "John")).fetch()
+	* // result = { entities: [Entity, Entity, Entity], next: async () => QueryResult, previous: async () => QueryResult }
+	*/
+	async fetch() {
+		const queryResult = await processQuery(this._client, {
+			predicates: this._predicates,
+			limit: this._limit,
+			cursor: this._cursor,
+			ownedBy: this._ownedBy,
+			validAtBlock: this._validAtBlock,
+			withAttributes: this._withAttributes,
+			withMetadata: this._withMetadata,
+			withPayload: this._withPayload
+		});
+		const entities = await Promise.all(queryResult.data.map((entity) => entityFromRpcResult(entity)));
+		this.cursor(queryResult.cursor);
+		this.validAtBlock(queryResult.blockNumber);
+		return new QueryResult(entities, this, this._cursor, this._limit, this._validAtBlock);
+	}
+	/**
+	* Counts the entities from the query.
+	* @returns The number of entities
+	*
+	* @example
+	* const builder = new QueryBuilder(client)
+	* const result = await builder.where(eq("name", "John")).count()
+	* // result = 10
+	*/
+	async count() {
+		return (await processQuery(this._client, {
+			predicates: this._predicates,
+			limit: this._limit,
+			cursor: this._cursor,
+			ownedBy: this._ownedBy,
+			validAtBlock: this._validAtBlock,
+			withAttributes: false,
+			withMetadata: false,
+			withPayload: false
+		})).data.length ?? 0;
+	}
+};
+
+//#endregion
+export { NoEntityFoundError as a, NoCursorOrLimitError as i, QueryResult as n, NoMoreResultsError as o, entityFromRpcResult as r, OffsetCannotBeLessThanZeroError as s, QueryBuilder as t };
+//# sourceMappingURL=queryBuilder-BueP5de6.js.map

package/dist/queryBuilder-BueP5de6.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryBuilder-BueP5de6.js","names":["predicate","queryOptions: RpcQueryOptions"],"sources":["../src/query/errors.ts","../src/types/entity.ts","../src/utils/entities.ts","../src/query/engine.ts","../src/query/queryResult.ts","../src/query/queryBuilder.ts"],"sourcesContent":["export class NoMoreResultsError extends Error {\n  constructor() {\n    super(\"No more results\")\n  }\n}\n\nexport class NoCursorOrLimitError extends Error {\n  constructor() {\n    super(\"Cursor and limit must be defined to fetch next\")\n  }\n}\n\nexport class OffsetCannotBeLessThanZeroError extends Error {\n  constructor() {\n    super(\"Offset cannot be less than 0\")\n  }\n}\n\nexport class NoEntityFoundError extends Error {\n  constructor() {\n    super(\"No entity found\")\n  }\n}\n","import { bytesToString, type Hex } from \"viem\"\nimport type { MimeType } from \"../types\"\nimport type { Attribute } from \"./attributes\"\n\nexport class Entity {\n  key: Hex\n  owner: Hex\n  expiresAtBlock: bigint\n  payload: Uint8Array\n  attributes: Attribute[]\n  contentType: MimeType\n\n  constructor(\n    key: Hex,\n    contentType: MimeType,\n    owner: Hex,\n    expiresAtBlock: bigint,\n    payload: Uint8Array,\n    attributes: Attribute[],\n  ) {\n    this.key = key\n    this.owner = owner\n    this.expiresAtBlock = expiresAtBlock\n    this.payload = payload\n    this.attributes = attributes\n    this.contentType = contentType\n  }\n\n  toText(): string {\n    return bytesToString(this.payload)\n  }\n\n  toJson(): any {\n    return JSON.parse(bytesToString(this.payload))\n  }\n}\n","import { toBytes } from \"viem\"\nimport { Entity } from \"../types/entity\"\nimport type { RpcEntity } from \"../types/rpcSchema\"\n\nexport async function entityFromRpcResult(rpcEntity: RpcEntity) {\n  return new Entity(\n    rpcEntity.key,\n    rpcEntity.contentType,\n    rpcEntity.owner,\n    rpcEntity.expiresAt,\n    toBytes(rpcEntity.value),\n    [\n      ...(rpcEntity.stringAttributes ?? []).map(({ key, value }) => ({\n        key,\n        value,\n      })),\n      ...(rpcEntity.numericAttributes ?? []).map(({ key, value }) => ({\n        key,\n        value: Number(value),\n      })),\n    ],\n  )\n}\n","import type { Hex } from \"viem\"\nimport type { ArkivClient } from \"../clients/baseClient\"\nimport type { RpcQueryOptions } from \"../types/rpcSchema\"\nimport type { Predicate } from \"./predicate\"\n\nfunction processPredicates(predicates: Predicate[]): string {\n  const processValue = (value: string | number) => {\n    if (typeof value === \"string\") {\n      return `\"${value}\"`\n    }\n    return value\n  }\n  return predicates\n    .map((predicate) => {\n      switch (predicate.type) {\n        case \"eq\":\n          return `${predicate.key} = ${processValue(predicate.value)}`\n        case \"neq\":\n          return `${predicate.key} != ${processValue(predicate.value)}`\n        case \"gt\":\n          return `${predicate.key} > ${processValue(predicate.value)}`\n        case \"gte\":\n          return `${predicate.key} >= ${processValue(predicate.value)}`\n        case \"lt\":\n          return `${predicate.key} < ${processValue(predicate.value)}`\n        case \"lte\":\n          return `${predicate.key} <= ${processValue(predicate.value)}`\n        case \"not\":\n          return `!${predicate.key}`\n        case \"or\":\n          return `(${predicate.predicates.map((predicate) => processPredicates([predicate])).join(\" || \")})`\n        case \"and\":\n          return `(${predicate.predicates.map((predicate) => processPredicates([predicate])).join(\" && \")})`\n        default:\n          return \"\"\n      }\n    })\n    .join(\" && \")\n}\n\nexport async function processQuery(\n  client: ArkivClient,\n  queryParams: {\n    predicates: Predicate[]\n    limit: number | undefined\n    cursor: string | undefined\n    ownedBy: Hex | undefined\n    validAtBlock?: bigint | undefined\n    withAttributes?: boolean | undefined\n    withMetadata?: boolean | undefined\n    withPayload?: boolean | undefined\n  },\n) {\n  const {\n    predicates,\n    limit,\n    cursor,\n    ownedBy,\n    validAtBlock,\n    withAttributes,\n    withMetadata,\n    withPayload,\n  } = queryParams\n\n  console.debug(\n    `Processing query with params: predicates: ${predicates}, cursor: ${cursor}, limit: ${limit}, ownedBy: ${ownedBy}, validAtBlock: ${validAtBlock}, withAttributes: ${withAttributes}, withMetadata: ${withMetadata}, withPayload: ${withPayload}`,\n  )\n\n  let query = processPredicates(predicates)\n  if (ownedBy) {\n    query += ` && $owner=${ownedBy}`\n  }\n\n  // remove leading and trailing spaces and leading &&\n  query = query.trim()\n  if (query.startsWith(\"&& \")) {\n    query = query.slice(3)\n  }\n\n  const queryOptions: RpcQueryOptions = {\n    includeData: {\n      key: true,\n      attributes: withAttributes ?? false,\n      payload: withPayload ?? false,\n      contentType: withMetadata ?? false,\n      expiration: withMetadata ?? false,\n      owner: withMetadata ?? false,\n    },\n  }\n\n  if (validAtBlock !== undefined) {\n    queryOptions.atBlock = Number(validAtBlock)\n  }\n  if (limit !== undefined) {\n    queryOptions.resultsPerPage = limit\n  }\n  if (cursor !== undefined) {\n    queryOptions.cursor = cursor\n  }\n\n  console.debug(\n    `Built query to send: ${query}, queryOptions: ${JSON.stringify({ includeData: queryOptions.includeData, atBlock: queryOptions.atBlock?.toString(), resultsPerPage: queryOptions.resultsPerPage, cursor: queryOptions.cursor })}`,\n  )\n\n  const result = await client.request({\n    method: \"arkiv_query\",\n    params: [query, queryOptions],\n  })\n  console.debug(\"Raw result from query: \", result)\n\n  return result\n}\n","import type { Entity } from \"../types/entity\"\nimport { NoCursorOrLimitError, NoMoreResultsError } from \"./errors\"\nimport type { QueryBuilder } from \"./queryBuilder\"\n\nexport class QueryResult {\n  entities: Entity[]\n  private _endOfIteration: boolean\n  private _cursor: string | undefined\n  private _limit: number | undefined\n  private _validAtBlock: bigint | undefined\n  private _queryBuilder: QueryBuilder\n\n  // Public getters for internal state\n  get queryBuilder(): QueryBuilder {\n    return this._queryBuilder\n  }\n\n  get cursor(): string | undefined {\n    return this._cursor\n  }\n\n  constructor(\n    entities: Entity[],\n    queryBuilder: QueryBuilder,\n    cursor: string | undefined,\n    limit: number | undefined,\n    validAtBlock: bigint | undefined,\n  ) {\n    this.entities = entities\n    this._queryBuilder = queryBuilder\n    this._endOfIteration = !limit || entities.length < limit\n    this._cursor = cursor\n    this._limit = limit\n    this._validAtBlock = validAtBlock\n  }\n\n  async next() {\n    if (this._cursor === undefined || this._limit === undefined) {\n      throw new NoCursorOrLimitError()\n    }\n    if (this._endOfIteration) {\n      throw new NoMoreResultsError()\n    }\n    this._queryBuilder.cursor(this._cursor)\n    const result = await this._queryBuilder.fetch()\n    this.entities = result.entities\n    // Update the query builder reference\n    this._queryBuilder = result.queryBuilder\n    // Check if we've reached the end (no more cursor or we got fewer entities than limit)\n    this._endOfIteration = !result.cursor || result.entities.length < this._limit\n    // Update the cursor\n    this._cursor = result.cursor\n\n    // TODO check current block height and if it is not too old\n    console.debug(\"Current block height for next page: \", this._validAtBlock)\n  }\n\n  hasNextPage() {\n    return !this._endOfIteration\n  }\n}\n","import type { Hex } from \"viem\"\nimport type { ArkivClient } from \"../clients/baseClient\"\nimport { entityFromRpcResult } from \"../utils/entities\"\nimport { processQuery } from \"./engine\"\nimport type { Predicate } from \"./predicate\"\nimport { QueryResult } from \"./queryResult\"\n\n/**\n * QueryBuilder is a helper class to build queries to the Arkiv DBChains.\n * It can be used to fetch entities from the Arkiv DBChains. It follows the Builder pattern allowing chaining of methods.\n * @param client - The Arkiv client\n * @returns The QueryBuilder instance {@link QueryBuilder}\n */\nexport class QueryBuilder {\n  private _client: ArkivClient\n  private _ownedBy: Hex | undefined\n  private _validAtBlock: bigint | undefined\n  private _withAttributes: boolean | undefined\n  private _withMetadata: boolean | undefined\n  private _withPayload: boolean | undefined\n  private _limit: number | undefined\n  private _cursor: string | undefined\n  private _predicates: Predicate[]\n\n  constructor(client: ArkivClient) {\n    this._client = client\n    this._predicates = []\n  }\n\n  /**\n   * Sets the ownedBy filter\n   * @param ownedBy - The address of the owner\n   * @returns The QueryBuilder instance\n   *\n   * @example\n   * const builder = new QueryBuilder(client)\n   * builder.ownedBy(\"0x1234567890123456789012345678901234567890\")\n   */\n  ownedBy(ownedBy: Hex) {\n    this._ownedBy = ownedBy\n    return this\n  }\n\n  /**\n   * Sets the withAttributes flag which will return the attributes for the entities if true\n   * @param withAttributes - The boolean value to set\n   * @returns The QueryBuilder instance\n   *\n   * @example\n   * const builder = new QueryBuilder(client)\n   * builder.withAttributes(true)\n   */\n  withAttributes(withAttributes: boolean = true) {\n    this._withAttributes = withAttributes\n    return this\n  }\n\n  /**\n   * Sets the withMetadata flag which will return the metadata (like owner, expiredAt, etc.) for the entities if true\n   * @param withMetadata - The boolean value to set\n   * @returns The QueryBuilder instance\n   *\n   * @example\n   * const builder = new QueryBuilder(client)\n   * builder.withMetadata(true)\n   */\n  withMetadata(withMetadata: boolean = true) {\n    this._withMetadata = withMetadata\n    return this\n  }\n\n  /**\n   * Sets the withPayload flag which will return the payload for the entities if true\n   * @param withPayload - The boolean value to set\n   * @returns The QueryBuilder instance\n   *\n   * @example\n   * const builder = new QueryBuilder(client)\n   * builder.withPayload(true)\n   */\n  withPayload(withPayload: boolean = true) {\n    this._withPayload = withPayload\n    return this\n  }\n\n  /**\n   * Sets the limit for the query\n   * @param limit - The number of entities to return\n   * @returns The QueryBuilder instance\n   *\n   * @example\n   * const builder = new QueryBuilder(client)\n   * builder.limit(10)\n   */\n  limit(limit: number) {\n    this._limit = limit\n    return this\n  }\n\n  /**\n   * Sets the cursor for the query - it is advances setting which rather shouldn't be used manually but it is provided from query result if limit is used (pagination).\n   * @param cursor - The cursor to set which tells to RPC Query server where to start or continue the query.\n   * @returns The QueryBuilder instance\n   *\n   * @example\n   * const builder = new QueryBuilder(client)\n   * builder.offset(10)\n   */\n  cursor(cursor: string) {\n    this._cursor = cursor\n    return this\n  }\n\n  /**\n   * Sets the validAtBlock for the query which tells at which block height the state we are intested.\n   * If not set, the latest block is  used.\n   * @param validAtBlock - The block number to set\n   * @returns The QueryBuilder instance\n   *\n   * @example\n   * const builder = new QueryBuilder(client)\n   * builder.validAtBlock(10000)\n   */\n  validAtBlock(validAtBlock: bigint) {\n    this._validAtBlock = validAtBlock\n    return this\n  }\n\n  /**\n   * Sets the predicates for the query limiting the results. It can be a single predicate or an array of predicates combined with 'and'.\n   * Predicates can be nested using 'or' and 'and' predicates.\n   * @param predicates - The predicates to set\n   * @returns The QueryBuilder instance\n   *\n   * @example\n   * const builder = new QueryBuilder(client)\n   * builder.where(eq(\"name\", \"John\"))\n   * builder.where([eq(\"name\", \"John\"), eq(\"age\", 30)])\n   * builder.where([eq(\"name\", \"John\"), or([eq(\"age\", 30), eq(\"age\", 31)])])\n   * builder.where([eq(\"name\", \"John\"), and([eq(\"age\", 30), eq(\"age\", 31)])])\n   * builder.where([eq(\"name\", \"John\"), or([eq(\"age\", 30), and([eq(\"age\", 31), eq(\"age\", 32)])])])\n   * builder.where([eq(\"name\", \"John\"), and([eq(\"age\", 30), or([eq(\"age\", 31), eq(\"age\", 32)])])])\n   * builder.where([eq(\"name\", \"John\"), and([eq(\"age\", 30), or([eq(\"age\", 31), and([eq(\"age\", 32), eq(\"age\", 33)])])])])\n   */\n  where(predicates: Predicate[] | Predicate) {\n    if (Array.isArray(predicates)) {\n      this._predicates.push(...predicates)\n    } else {\n      this._predicates.push(predicates)\n    }\n    return this\n  }\n\n  /**\n   * Fetches the entities from the query. Re\n   * It will return a QueryResult instance which can be used to fetch the next and previous pages.\n   * @returns The QueryResult instance {@link QueryResult}\n   *\n   * @example\n   * const builder = new QueryBuilder(client)\n   * const result = await builder.where(eq(\"name\", \"John\")).fetch()\n   * // result = { entities: [Entity, Entity, Entity], next: async () => QueryResult, previous: async () => QueryResult }\n   */\n  async fetch() {\n    const queryResult = await processQuery(this._client, {\n      predicates: this._predicates,\n      limit: this._limit,\n      cursor: this._cursor,\n      ownedBy: this._ownedBy,\n      validAtBlock: this._validAtBlock,\n      withAttributes: this._withAttributes,\n      withMetadata: this._withMetadata,\n      withPayload: this._withPayload,\n    })\n\n    const entities = await Promise.all(\n      queryResult.data.map((entity) => entityFromRpcResult(entity)),\n    )\n\n    this.cursor(queryResult.cursor)\n    this.validAtBlock(queryResult.blockNumber)\n\n    return new QueryResult(entities, this, this._cursor, this._limit, this._validAtBlock)\n  }\n\n  /**\n   * Counts the entities from the query.\n   * @returns The number of entities\n   *\n   * @example\n   * const builder = new QueryBuilder(client)\n   * const result = await builder.where(eq(\"name\", \"John\")).count()\n   * // result = 10\n   */\n  async count() {\n    const queryResult = await processQuery(this._client, {\n      predicates: this._predicates,\n      limit: this._limit,\n      cursor: this._cursor,\n      ownedBy: this._ownedBy,\n      validAtBlock: this._validAtBlock,\n      withAttributes: false,\n      withMetadata: false,\n      withPayload: false,\n    })\n\n    return queryResult.data.length ?? 0\n  }\n}\n"],"mappings":"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"}