@arkiv-network/sdk 0.7.0-dev.1 → 0.8.0-dev.1

package/dist/queryBuilder-J37buGCi.cjs

@@ -1,865 +0,0 @@
-const require_consts = require('./consts-CxT1-RXU.cjs');
-const require_entity = require('./entity-BhSXaB23.cjs');
-let viem = require("viem");
-
-//#region src/utils/logger.ts
-const ROOT_NAMESPACE = "arkiv";
-function getDebugEnv() {
-	if (typeof process !== "undefined") {
-		const debugEnv = process?.env?.DEBUG;
-		if (debugEnv) return debugEnv;
-	}
-	if (typeof globalThis !== "undefined" && "localStorage" in globalThis) try {
-		return globalThis.localStorage?.getItem("DEBUG") || "";
-	} catch {}
-	return "";
-}
-function matchesPattern(namespace, pattern) {
-	if (pattern === namespace) return true;
-	if (pattern.endsWith("*")) {
-		const prefix = pattern.slice(0, -1);
-		return namespace.startsWith(prefix);
-	}
-	if (pattern.startsWith("-")) return !matchesPattern(namespace, pattern.slice(1));
-	return false;
-}
-function isEnabled(namespace) {
-	const debugEnv = getDebugEnv();
-	if (!debugEnv) return false;
-	const patterns = debugEnv.split(/[\s,]+/).filter((p) => p.length > 0);
-	if (patterns.length === 0) return false;
-	let enabled = false;
-	for (const pattern of patterns) if (pattern.startsWith("-")) {
-		if (matchesPattern(namespace, pattern)) return false;
-	} else if (matchesPattern(namespace, pattern)) enabled = true;
-	return enabled;
-}
-const enabledNamespaces = /* @__PURE__ */ new Set();
-const disabledNamespaces = /* @__PURE__ */ new Set();
-const COLOR_PALETTE = [
-	"#0000FF",
-	"#008000",
-	"#FF0000",
-	"#FF00FF",
-	"#FFA500",
-	"#800080",
-	"#00CED1",
-	"#FF1493",
-	"#32CD32",
-	"#1E90FF",
-	"#FF4500",
-	"#9370DB",
-	"#00FA9A",
-	"#FFD700",
-	"#DC143C",
-	"#00BFFF",
-	"#FF69B4",
-	"#20B2AA",
-	"#DA70D6",
-	"#4682B4"
-];
-const isNode = typeof process !== "undefined" && process.versions?.node != null;
-const ANSI_COLORS = [
-	"\x1B[94m",
-	"\x1B[92m",
-	"\x1B[91m",
-	"\x1B[95m",
-	"\x1B[93m",
-	"\x1B[96m",
-	"\x1B[35m",
-	"\x1B[36m",
-	"\x1B[32m",
-	"\x1B[34m",
-	"\x1B[33m",
-	"\x1B[31m",
-	"\x1B[90m",
-	"\x1B[37m",
-	"\x1B[1m"
-];
-const ANSI_RESET = "\x1B[0m";
-const ANSI_BOLD = "\x1B[1m";
-const namespaceColors = /* @__PURE__ */ new Map();
-function getColorForNamespace(namespace) {
-	const cachedColor = namespaceColors.get(namespace);
-	if (cachedColor) return cachedColor;
-	let hash = 0;
-	for (let i = 0; i < namespace.length; i++) {
-		const char = namespace.charCodeAt(i);
-		hash = (hash << 5) - hash + char;
-		hash = hash & hash;
-	}
-	const colorIndex = Math.abs(hash) % COLOR_PALETTE.length;
-	const color = {
-		css: COLOR_PALETTE[colorIndex],
-		ansi: ANSI_COLORS[colorIndex % ANSI_COLORS.length]
-	};
-	namespaceColors.set(namespace, color);
-	return color;
-}
-function createDebugLogger(namespace) {
-	const colors = getColorForNamespace(namespace);
-	return (...args) => {
-		const envEnabled = isEnabled(namespace);
-		const progEnabled = enabledNamespaces.has(namespace) && !disabledNamespaces.has(namespace);
-		if (envEnabled || progEnabled) if (isNode) {
-			const coloredNamespace = `${ANSI_BOLD}${colors.ansi}${namespace}${ANSI_RESET}`;
-			console.log(coloredNamespace, ...args);
-		} else {
-			const style1 = `color: ${colors.css}; font-weight: bold`;
-			console.log(`%c${namespace}%c`, style1, "color: inherit; font-weight: normal", ...args);
-		}
-	};
-}
-const getLogger = (scope) => {
-	return createDebugLogger(`${ROOT_NAMESPACE}:${scope}`);
-};
-
-//#endregion
-//#region src/errors.ts
-var EntityMutationError = class extends Error {
-	constructor(message) {
-		super(message);
-		this.name = "EntityMutationError";
-	}
-};
-var InvalidExpirationError = class extends Error {
-	constructor(expiresIn) {
-		super(`Invalid expiresIn: ${String(expiresIn)}. expiresIn must be a positive integer and a multiple of the Arkiv block time (${require_consts.BLOCK_TIME} seconds), because expiration is measured in whole blocks (1 block = ${require_consts.BLOCK_TIME} seconds).`);
-		this.name = "InvalidExpirationError";
-	}
-};
-var InvalidAttributeError = class extends Error {
-	constructor(key, value) {
-		const remedy = Number.isInteger(value) ? `Offset it into the non-negative range (e.g. store ${String(value)} + OFFSET, subtracting OFFSET on read) to keep numeric ordering/range queries; otherwise store it as a string (e.g. "${String(value)}")` : `To keep numeric ordering/range queries, scale it to an integer (e.g. Math.round(${String(value)} * 1000), dividing by 1000 on read); otherwise store it as a string (e.g. "${String(value)}")`;
-		super(`Invalid numeric value for attribute "${key}": ${String(value)}. Numeric attribute values must be non-negative integers (stored on-chain as unsigned 256-bit). ${remedy}.`);
-		this.name = "InvalidAttributeError";
-	}
-};
-var InvalidAttributeKeyError = class extends Error {
-	constructor(key, reason) {
-		super(`Invalid attribute key "${key}": ${reason}. Keys must be 1-32 bytes, start with a lowercase letter (a-z), and contain only a-z, 0-9, ".", "-" or "_".`);
-		this.name = "InvalidAttributeKeyError";
-	}
-};
-var DuplicateAttributeError = class extends Error {
-	constructor(key) {
-		super(`Duplicate attribute key "${key}". Attribute keys must be unique per entity.`);
-		this.name = "DuplicateAttributeError";
-	}
-};
-var NoMoreResultsError = class extends Error {
-	constructor() {
-		super("No more results");
-		this.name = "NoMoreResultsError";
-	}
-};
-var NoCursorOrLimitError = class extends Error {
-	constructor() {
-		super("Cursor and limit must be defined to fetch next");
-		this.name = "NoCursorOrLimitError";
-	}
-};
-var NoEntityFoundError = class extends Error {
-	constructor() {
-		super("No entity found");
-		this.name = "NoEntityFoundError";
-	}
-};
-var InvalidContentTypeError = class extends Error {
-	constructor(contentType) {
-		super(`Invalid content type "${contentType}". Must follow RFC 2045 MIME grammar and be lowercase only (e.g. "text/plain").`);
-		this.name = "InvalidContentTypeError";
-	}
-};
-
-//#endregion
-//#region src/types/rpcSchema.ts
-let RpcAttributeValueType = /* @__PURE__ */ function(RpcAttributeValueType$1) {
-	RpcAttributeValueType$1[RpcAttributeValueType$1["Uint"] = 1] = "Uint";
-	RpcAttributeValueType$1[RpcAttributeValueType$1["String"] = 2] = "String";
-	RpcAttributeValueType$1[RpcAttributeValueType$1["EntityKey"] = 3] = "EntityKey";
-	return RpcAttributeValueType$1;
-}({});
-
-//#endregion
-//#region src/utils/entities.ts
-function decodeAttributeValue(value, valueType) {
-	switch (valueType) {
-		case RpcAttributeValueType.Uint: return Number(BigInt(value));
-		case RpcAttributeValueType.EntityKey: return value;
-		case RpcAttributeValueType.String:
-		default: return value;
-	}
-}
-const logger$2 = getLogger("utils:entities");
-async function entityFromRpcResult(rpcEntity) {
-	logger$2("entityFromRpcResult %o", rpcEntity);
-	return new require_entity.Entity(rpcEntity.key, rpcEntity.contentType, rpcEntity.owner, rpcEntity.creator, rpcEntity.expiresAt !== void 0 ? BigInt(rpcEntity.expiresAt) : void 0, rpcEntity.createdAtBlock !== void 0 ? BigInt(rpcEntity.createdAtBlock) : void 0, rpcEntity.lastModifiedAtBlock !== void 0 ? BigInt(rpcEntity.lastModifiedAtBlock) : void 0, rpcEntity.transactionIndexInBlock !== void 0 ? BigInt(rpcEntity.transactionIndexInBlock) : void 0, rpcEntity.operationIndexInTransaction !== void 0 ? BigInt(rpcEntity.operationIndexInTransaction) : void 0, rpcEntity.value !== void 0 ? (0, viem.toBytes)(rpcEntity.value) : void 0, [...(rpcEntity.attributes ?? []).map(({ key, value, valueType }) => ({
-		key,
-		value: decodeAttributeValue(value, valueType)
-	}))]);
-}
-
-//#endregion
-//#region src/utils/validation.ts
-/**
-* True only for hex strings that are exactly 32 bytes (an entity key). This is
-* the single rule deciding whether an attribute string value is stored as the
-* on-chain `EntityKey` type or as a plain string — the query engine applies
-* the same rule, so equality comparisons agree with storage on both paths.
-* Hex-looking strings of any other length are treated as ordinary strings.
-*/
-function isEntityKey(value) {
-	return (0, viem.isHex)(value) && value.length === 66;
-}
-/**
-* Expiration on Arkiv is measured in blocks (1 block =
-* 2 seconds), so the value must be a positive integer that is
-* a multiple of the block time.
-*
-* @param expiresIn - The expiration in seconds.
-* @throws {InvalidExpirationError} If the value is not a positive integer that
-* is a multiple of the block time.
-*/
-function validateExpiresIn(expiresIn) {
-	if (!Number.isInteger(expiresIn) || expiresIn <= 0 || expiresIn % require_consts.BLOCK_TIME !== 0) throw new InvalidExpirationError(expiresIn);
-}
-/**
-* Validates an attribute key against the on-chain `Ident32` rules (mirrors
-* `Ident32.sol` / `validate_ident32_bytes` in the node): non-empty, at most
-* 32 bytes, leading character `a-z`, remaining characters `a-z 0-9 . - _`.
-*
-* @param key - The attribute key to validate.
-* @throws {InvalidAttributeKeyError} If the key violates the `Ident32` rules.
-*/
-function validateAttributeKey(key) {
-	if (key.length === 0) throw new InvalidAttributeKeyError(key, "key is empty");
-	if (!/^[a-z]/.test(key)) throw new InvalidAttributeKeyError(key, `key starts with "${key[0]}"`);
-	const invalid = key.match(/[^a-z0-9._-]/);
-	if (invalid) throw new InvalidAttributeKeyError(key, `key contains "${invalid[0]}" at position ${invalid.index}`);
-	if (key.length > 32) throw new InvalidAttributeKeyError(key, `key is ${key.length} bytes long`);
-}
-/**
-* Validates a single attribute. Keys must follow the on-chain `Ident32` rules
-* (see {@link validateAttributeKey}). Arkiv supports string and number
-* attribute values, but numeric values must be non-negative integers — they
-* are stored on-chain as unsigned 256-bit values.
-*
-* @param attribute - The attribute to validate.
-* @throws {InvalidAttributeKeyError} If the key violates the `Ident32` rules.
-* @throws {InvalidAttributeError} If the attribute has a non-integer or
-* negative numeric value.
-*/
-function validateAttribute(attribute) {
-	validateAttributeKey(attribute.key);
-	if (typeof attribute.value === "number" && (!Number.isInteger(attribute.value) || attribute.value < 0)) throw new InvalidAttributeError(attribute.key, attribute.value);
-}
-
-//#endregion
-//#region src/query/engine.ts
-const logger$1 = getLogger("query:engine");
-function processPredicates(predicates) {
-	const processValue = (value) => {
-		if (typeof value === "string") return isEntityKey(value) ? value : `"${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, createdBy, orderBy, validAtBlock, withAttributes, withMetadata, withPayload, includeData } = queryParams;
-	logger$1("Processing query with params %o", {
-		predicates,
-		cursor,
-		limit,
-		ownedBy,
-		createdBy,
-		orderBy,
-		validAtBlock,
-		withAttributes,
-		withMetadata,
-		withPayload,
-		includeData
-	});
-	let query = processPredicates(predicates);
-	if (ownedBy) query += ` && $owner=${ownedBy}`;
-	if (createdBy) query += ` && $creator=${createdBy}`;
-	query = query.trim();
-	if (query.startsWith("&& ")) query = query.slice(3);
-	const queryOptions = { includeData: includeData ?? {
-		key: true,
-		attributes: withAttributes ?? false,
-		payload: withPayload ?? false,
-		contentType: withMetadata ?? false,
-		expiration: withMetadata ?? false,
-		owner: withMetadata ?? false,
-		creator: withMetadata ?? false,
-		createdAtBlock: withMetadata ?? false,
-		lastModifiedAtBlock: withMetadata ?? false,
-		transactionIndexInBlock: withMetadata ?? false,
-		operationIndexInTransaction: withMetadata ?? false
-	} };
-	if (validAtBlock !== void 0) queryOptions.atBlock = (0, viem.numberToHex)(validAtBlock);
-	if (limit !== void 0) queryOptions.resultsPerPage = (0, viem.numberToHex)(limit);
-	if (cursor !== void 0) queryOptions.cursor = cursor;
-	if (orderBy !== void 0) queryOptions.orderBy = orderBy;
-	logger$1("Built query to send %s %o", query, {
-		includeData: queryOptions.includeData,
-		atBlock: queryOptions.atBlock ? (0, viem.hexToNumber)(queryOptions.atBlock) : void 0,
-		orderBy: queryOptions.orderBy,
-		resultsPerPage: queryOptions.resultsPerPage,
-		cursor: queryOptions.cursor
-	});
-	const result = await client.request({
-		method: "arkiv_query",
-		params: [query, queryOptions]
-	});
-	logger$1("Raw result from query %o", result);
-	return result;
-}
-
-//#endregion
-//#region src/query/queryResult.ts
-const logger = getLogger("query:result");
-/**
-* The result of a query. Holds the fetched entities and supports cursor-based pagination.
-*
-* @typeParam TEntity - The shape of each entity, inferred from the query builder
-*   (a full {@link Entity}, or a projected object inferred from a `select()` selection).
-*/
-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;
-		logger("Current block height for next page %s", this._validAtBlock?.toString() ?? "unknown");
-	}
-	hasNextPage() {
-		return !this._endOfIteration;
-	}
-};
-
-//#endregion
-//#region src/query/selection.ts
-/**
-* Converts a {@link SelectArg} into the {@link RpcIncludeData} understood by the query engine.
-* Every field is opt-in — anything not explicitly selected defaults to `false`, including the key.
-* `undefined` or `"*"` selects everything.
-*
-* @param selection - The selection to convert
-* @returns The fully-resolved include-data object for the RPC query
-* @throws If an empty selection object is provided
-*
-* @example
-* selectionToIncludeData() // everything
-* selectionToIncludeData("*") // everything
-* selectionToIncludeData({ key: true }) // only the key
-* selectionToIncludeData({ owner: true }) // only the owner
-*/
-function selectionToIncludeData(selection) {
-	if (selection === void 0 || selection === "*") return {
-		key: true,
-		attributes: true,
-		payload: true,
-		contentType: true,
-		expiration: true,
-		owner: true,
-		creator: true,
-		createdAtBlock: true,
-		lastModifiedAtBlock: true,
-		transactionIndexInBlock: true,
-		operationIndexInTransaction: true
-	};
-	if (!Object.values(selection).some((selected) => selected === true)) throw new Error("select() requires at least one field to be selected. Pass select() or select(\"*\") to select everything.");
-	return {
-		key: selection.key ?? false,
-		attributes: selection.attributes ?? false,
-		payload: selection.payload ?? false,
-		contentType: selection.contentType ?? false,
-		expiration: selection.expiresAtBlock ?? false,
-		owner: selection.owner ?? false,
-		creator: selection.creator ?? false,
-		createdAtBlock: selection.createdAtBlock ?? false,
-		lastModifiedAtBlock: selection.lastModifiedAtBlock ?? false,
-		transactionIndexInBlock: selection.transactionIndexInBlock ?? false,
-		operationIndexInTransaction: selection.operationIndexInTransaction ?? false
-	};
-}
-
-//#endregion
-//#region src/query/queryBuilder.ts
-/**
-* Helper function to create an ascending order by attribute
-* @param attributeName - The name of the attribute to order by
-* @param attributeType - The type of the attribute to order by (string or number)
-* @returns Input for orderBy method
-*
-* @deprecated Server-side ordering is not supported by the network, so `orderBy` (and this
-* helper) have no effect on the returned order. Sort the fetched entities in JavaScript
-* instead (e.g. `entities.sort(...)`). This function will be removed in a future release.
-*
-* @example
-* const ascAttribute = asc("name", "string")
-*/
-function asc(attributeName, attributeType) {
-	return {
-		name: attributeName,
-		type: attributeType,
-		order: "asc"
-	};
-}
-/**
-* Helper function to create a descending order by attribute
-* @param attributeName - The name of the attribute to order by
-* @param attributeType - The type of the attribute to order by (string or number)
-* @returns Input for orderBy method
-*
-* @deprecated Server-side ordering is not supported by the network, so `orderBy` (and this
-* helper) have no effect on the returned order. Sort the fetched entities in JavaScript
-* instead (e.g. `entities.sort(...)`). This function will be removed in a future release.
-*
-* @example
-* const descAttribute = desc("name", "string")
-*/
-function desc(attributeName, attributeType) {
-	return {
-		name: attributeName,
-		type: attributeType,
-		order: "desc"
-	};
-}
-/**
-* BaseQueryBuilder holds the query-building logic shared by every query builder
-* (filtering, ordering, pagination, execution). It follows the Builder pattern,
-* allowing methods to be chained. Subclasses decide how data selection is expressed
-* by implementing the protected `selectionParams` method.
-*
-* Use {@link SelectQueryBuilder} via `client.select()` to build and execute queries.
-*
-* @typeParam TEntity - The shape of each entity produced by {@link BaseQueryBuilder.fetch}.
-*/
-var BaseQueryBuilder = class {
-	_client;
-	_ownedBy;
-	_createdBy;
-	_orderBy;
-	_validAtBlock;
-	_limit;
-	_cursor;
-	_predicates;
-	constructor(client) {
-		this._client = client;
-		this._predicates = [];
-	}
-	/**
-	* Sets the ownedBy filter
-	* @param ownedBy - The address of the owner
-	* @returns The query builder instance
-	*
-	* @example
-	* const builder = client.select()
-	* builder.ownedBy("0x1234567890123456789012345678901234567890")
-	*/
-	ownedBy(ownedBy) {
-		this._ownedBy = ownedBy;
-		return this;
-	}
-	/**
-	* Sets the createdBy filter
-	* @param createdBy - The address of the creator
-	* @returns The query builder instance
-	*
-	* @example
-	* const builder = client.select()
-	* builder.createdBy("0x1234567890123456789012345678901234567890")
-	*/
-	createdBy(createdBy) {
-		this._createdBy = createdBy;
-		return this;
-	}
-	orderBy(attributeNameOrOrderByAttribute, attributeType, order = "asc") {
-		if (!this._orderBy) this._orderBy = [];
-		const pushOrderByAttribute = ({ name, type, order: order$1 }) => {
-			this._orderBy?.push({
-				name,
-				type: type === "number" ? "numeric" : type,
-				desc: order$1 === "desc"
-			});
-		};
-		if (typeof attributeNameOrOrderByAttribute === "string") {
-			if (!attributeType) throw new Error("attributeType is required when using positional orderBy arguments");
-			pushOrderByAttribute({
-				name: attributeNameOrOrderByAttribute,
-				type: attributeType,
-				order
-			});
-		} else pushOrderByAttribute(attributeNameOrOrderByAttribute);
-		return this;
-	}
-	/**
-	* Sets the limit for the query
-	* @param limit - The number of entities to return
-	* @returns The query builder instance
-	*
-	* @example
-	* const builder = client.select()
-	* 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 query builder instance
-	*
-	* @example
-	* const builder = client.select()
-	* builder.cursor("0xABC123")
-	*/
-	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 query builder instance
-	*
-	* @example
-	* const builder = client.select()
-	* builder.validAtBlock(10000)
-	*/
-	validAtBlock(validAtBlock) {
-		this._validAtBlock = validAtBlock;
-		return this;
-	}
-	where(...predicates) {
-		this._predicates.push(...predicates.flat());
-		return this;
-	}
-	/**
-	* Fetches the entities from the query.
-	* 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 = client.select()
-	* 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,
-			createdBy: this._createdBy,
-			orderBy: this._orderBy,
-			validAtBlock: this._validAtBlock,
-			...this.selectionParams()
-		});
-		const entities = await Promise.all(queryResult.data.map((entity) => this.projectEntity(entity)));
-		this.cursor(queryResult.cursor);
-		this.validAtBlock(BigInt(queryResult.blockNumber ?? 0));
-		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 = client.select()
-	* 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,
-			createdBy: this._createdBy,
-			orderBy: void 0,
-			validAtBlock: this._validAtBlock,
-			withAttributes: false,
-			withMetadata: false,
-			withPayload: false
-		})).data.length ?? 0;
-	}
-};
-/**
-* 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.
-*
-* By default the result includes only the entity `key`. Additional data is opt-in through
-* `withAttributes()`, `withMetadata()` and `withPayload()`.
-*
-* @deprecated Use {@link SelectQueryBuilder} via `client.select()` instead. Declaring the
-* selection up front avoids the common mistake of forgetting to opt in to data and getting back
-* entities with only their `key` populated. This class remains for backwards compatibility and
-* will be removed in a future release.
-*
-* @param client - The Arkiv client
-* @returns The QueryBuilder instance {@link QueryBuilder}
-*/
-var QueryBuilder = class extends BaseQueryBuilder {
-	_withAttributes;
-	_withMetadata;
-	_withPayload;
-	/**
-	* 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 = client.buildQuery()
-	* 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 = client.buildQuery()
-	* 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 = client.buildQuery()
-	* builder.withPayload(true)
-	*/
-	withPayload(withPayload = true) {
-		this._withPayload = withPayload;
-		return this;
-	}
-	selectionParams() {
-		return {
-			withAttributes: this._withAttributes,
-			withMetadata: this._withMetadata,
-			withPayload: this._withPayload
-		};
-	}
-	projectEntity(rpcEntity) {
-		return entityFromRpcResult(rpcEntity);
-	}
-};
-/**
-* SelectQueryBuilder is the recommended query builder. It requires the selection to be declared
-* up front, so results always contain exactly the data you asked for — and the type of each
-* returned entity is narrowed to exactly the selected fields.
-*
-* The selection is fixed at construction time and is flat — each field maps to an entity field.
-* Create one via `client.select(...)` rather than constructing it directly, so the result type is
-* inferred from the selection.
-*
-* @typeParam TEntity - The projected entity shape, inferred from the selection by `client.select()`.
-*
-* @example
-* // everything
-* await client.select().where(eq("name", "John")).fetch()
-* await client.select("*").where(eq("name", "John")).fetch()
-* // specific fields
-* await client.select({ owner: true, attributes: true }).fetch()
-* // a single field — result is typed (flat) { owner: Hex }
-* await client.select({ owner: true }).fetch()
-*/
-var SelectQueryBuilder = class extends BaseQueryBuilder {
-	_includeData;
-	constructor(client, selection) {
-		super(client);
-		this._includeData = selectionToIncludeData(selection);
-	}
-	selectionParams() {
-		return { includeData: this._includeData };
-	}
-	async projectEntity(rpcEntity) {
-		return await entityFromRpcResult(rpcEntity);
-	}
-};
-
-//#endregion
-Object.defineProperty(exports, 'BaseQueryBuilder', {
-  enumerable: true,
-  get: function () {
-    return BaseQueryBuilder;
-  }
-});
-Object.defineProperty(exports, 'DuplicateAttributeError', {
-  enumerable: true,
-  get: function () {
-    return DuplicateAttributeError;
-  }
-});
-Object.defineProperty(exports, 'EntityMutationError', {
-  enumerable: true,
-  get: function () {
-    return EntityMutationError;
-  }
-});
-Object.defineProperty(exports, 'InvalidAttributeError', {
-  enumerable: true,
-  get: function () {
-    return InvalidAttributeError;
-  }
-});
-Object.defineProperty(exports, 'InvalidAttributeKeyError', {
-  enumerable: true,
-  get: function () {
-    return InvalidAttributeKeyError;
-  }
-});
-Object.defineProperty(exports, 'InvalidContentTypeError', {
-  enumerable: true,
-  get: function () {
-    return InvalidContentTypeError;
-  }
-});
-Object.defineProperty(exports, 'InvalidExpirationError', {
-  enumerable: true,
-  get: function () {
-    return InvalidExpirationError;
-  }
-});
-Object.defineProperty(exports, 'NoCursorOrLimitError', {
-  enumerable: true,
-  get: function () {
-    return NoCursorOrLimitError;
-  }
-});
-Object.defineProperty(exports, 'NoEntityFoundError', {
-  enumerable: true,
-  get: function () {
-    return NoEntityFoundError;
-  }
-});
-Object.defineProperty(exports, 'NoMoreResultsError', {
-  enumerable: true,
-  get: function () {
-    return NoMoreResultsError;
-  }
-});
-Object.defineProperty(exports, 'QueryBuilder', {
-  enumerable: true,
-  get: function () {
-    return QueryBuilder;
-  }
-});
-Object.defineProperty(exports, 'QueryResult', {
-  enumerable: true,
-  get: function () {
-    return QueryResult;
-  }
-});
-Object.defineProperty(exports, 'RpcAttributeValueType', {
-  enumerable: true,
-  get: function () {
-    return RpcAttributeValueType;
-  }
-});
-Object.defineProperty(exports, 'SelectQueryBuilder', {
-  enumerable: true,
-  get: function () {
-    return SelectQueryBuilder;
-  }
-});
-Object.defineProperty(exports, 'asc', {
-  enumerable: true,
-  get: function () {
-    return asc;
-  }
-});
-Object.defineProperty(exports, 'desc', {
-  enumerable: true,
-  get: function () {
-    return desc;
-  }
-});
-Object.defineProperty(exports, 'entityFromRpcResult', {
-  enumerable: true,
-  get: function () {
-    return entityFromRpcResult;
-  }
-});
-Object.defineProperty(exports, 'getLogger', {
-  enumerable: true,
-  get: function () {
-    return getLogger;
-  }
-});
-Object.defineProperty(exports, 'isEntityKey', {
-  enumerable: true,
-  get: function () {
-    return isEntityKey;
-  }
-});
-Object.defineProperty(exports, 'selectionToIncludeData', {
-  enumerable: true,
-  get: function () {
-    return selectionToIncludeData;
-  }
-});
-Object.defineProperty(exports, 'validateAttribute', {
-  enumerable: true,
-  get: function () {
-    return validateAttribute;
-  }
-});
-Object.defineProperty(exports, 'validateExpiresIn', {
-  enumerable: true,
-  get: function () {
-    return validateExpiresIn;
-  }
-});