querier-ts 2.4.1 → 2.5.1

package/CHANGELOG.md

@@ -1,5 +1,44 @@
 # Changelog
 
+## v2.5.1
+
+### Summary
+
+- [ ] Bug fixes
+- [ ] Code refactoring
+- [ ] New features
+- [x] Build and packaging updates
+- [ ] Breaking changes
+
+### Build and packaging updates
+
+- Updated target from `es2020` to `es2022`, improving performance and reducing bundle size.
+- Added `pnpm-workspace.yaml` file with `allowBuilds` configuration.
+- Updated development dependencies.
+
+## v2.5.0
+
+### Summary
+
+- [ ] Bug fixes
+- [x] Code refactoring
+- [x] New features
+- [x] Build and packaging updates
+- [ ] Breaking changes
+
+### New features
+
+- Added `distinct()` method to `Query`.
+
+### Code refactoring
+
+- Improve conditions order in `column()` method.
+- Added a new unit test for the `column()` method, covering no rows case.
+
+### Build and packaging updates
+
+- Updated development dependencies.
+
 ## v2.4.1
 
 ### Summary
@@ -7,7 +46,7 @@
 - [ ] Bug fixes
 - [x] Code refactoring
 - [ ] New features
-- [x] Compatibility fixes
+- [x] Compatibility improvements
 - [ ] Breaking changes
 
 ### Code refactoring
@@ -15,10 +54,10 @@
 - Removed redundant conditions and unecessary code.
 - Optimized array iteration performance:
   - Pre-allocate arrays to avoid dynamic resizing.
-  - Replace Array.map() and `for...of` with indexed `for` loops.
+  - Replace `Array.map()` and `for...of` with indexed `for` loops.
 - Updated JSDoc for `Query`.
 
-### Compatibility fixes
+### Compatibility improvements
 
 - Updated development dependencies.
 

package/README.md

@@ -10,7 +10,7 @@ A lightweight, type-safe in-memory query engine for JavaScript and TypeScript.
 
 ## `Query`
 
-You can create a `Query` instance like this:
+Usage:
 
 ```ts
 const usersQuery = Query.from(users);
@@ -79,6 +79,23 @@ const filteredUsers = Query.from(users)
 
 ---
 
+#### `distinct(key | callback)`
+
+Removes duplicate rows based on a key or a callback function.
+
+- `key`: The key to be used for comparison.
+- `callback`: A function that maps each row to a value.
+
+```ts
+const uniqueCountries = Query.from(addresses)
+  .distinct('country')
+  .column('country');
+
+const uniqueEmailProviders = Query.from(users)
+  .distinct((user) => user.email.split('@')[1])
+  .column('email');
+```
+
 ### Selecting data
 
 #### `select(columns)`

package/dist/cjs/index.cjs

@@ -1 +1,618 @@
-'use strict';var $=Object.defineProperty;var E=Object.getOwnPropertyDescriptor;var F=s=>{throw TypeError(s)};var O=(s,e,t,r)=>{for(var o=E(e,t),n=s.length-1,i;n>=0;n--)(i=s[n])&&(o=(i(e,t,o))||o);return o&&$(e,t,o),o},g=(s,e)=>(t,r)=>e(t,r,s);var N=(s,e,t)=>e.has(s)||F("Cannot "+t);var l=(s,e,t)=>(N(s,e,"read from private field"),e.get(s)),b=(s,e,t)=>e.has(s)?F("Cannot add the same private member more than once"):e instanceof WeakSet?e.add(s):e.set(s,t),p=(s,e,t,r)=>(N(s,e,"write to private field"),e.set(s,t),t);var v=s=>typeof s=="number";var d=class extends Error{constructor(e){super(e),this.name="InvalidArgumentError";}};var k=new WeakMap;function V(s,e){let t=k.get(s);t||(t=new Map,k.set(s,t));let r=t.get(e);return r||(r=[],t.set(e,r)),r}function P(s){return function(e,t,r){let o=V(e,t),n=o.find(i=>i.index===r);n?n.min=s:o.push({index:r,min:s});}}function C(s,e,t){let r=V(s,e),o=r.find(n=>n.index===t);o?o.integer=true:r.push({index:t,integer:true});}function j(s,e,t){let r=t.value;t.value=function(...o){let n=k.get(s)?.get(e)??[];for(let i of n){let u=o[i.index];if(i.min!==void 0&&(!v(u)||u<i.min))throw new d(`${String(u)} is not a valid argument to param ${i.index} on ${e}(). Expected value to be equal or greater than ${i.min}.`);if(i.max!==void 0&&(!v(u)||u>i.max))throw new d(`${String(u)} is not a valid argument to param ${i.index} on ${e}(). Expected value to be equal or less than ${i.max}.`);if(i.integer&&!Number.isSafeInteger(u))throw new d(`${String(u)} is not a valid argument to param ${i.index} on ${e}(). Expected value to be an integer.`)}return r.apply(this,o)};}var h=s=>typeof s=="object"&&s!==null;var R=(s,e)=>{if(s===e)return  true;if(!h(s)||!h(e)||Array.isArray(s)!==Array.isArray(e))return  false;let t=Object.keys(s),r=Object.keys(e);return t.length!==r.length?false:t.every(o=>Object.prototype.hasOwnProperty.call(e,o)&&R(s[o],e[o]))};var G=(s,e)=>s.length===e.length&&s.every((t,r)=>R(t,e[r]));function B(s){return Object.entries(s)}var m=s=>typeof s=="function";var x,w=class{static validate(e,t,r){for(let[o,n]of B(t))if(!this.validateColumnCondition(e,o,n,r??l(this,x)))return  false;return  true}static validateColumnCondition(e,t,r,o){if(o.ignoreNullValues&&r==null)return  true;let n=e[t];return m(r)?r(n):Array.isArray(r)?Array.isArray(n)?G(n,r):false:h(r)?h(n)?this.validate(n,r):false:n===r}};x=new WeakMap,b(w,x,{ignoreNullValues:false});function L(s){return Object.keys(s).filter(e=>typeof s[e]!="function")}function M(s){let e=1,t=s;t.startsWith("-")&&(e=-1,t=t.slice(1));let r=t;return (o,n)=>{let i=o[r],u=n[r];return i==null&&u==null?0:i==null?1*e:u==null||i<u?-1*e:i>u?1*e:0}}function S(...s){return (e,t)=>{if(s.length===0)return 0;for(let r of s){let o=M(r)(e,t);if(o!==0)return o}return 0}}var a,f,y,c=class c{constructor(e){b(this,a,[]);b(this,f,0);b(this,y,null);p(this,a,[...e]);}static from(e){return new c(e)}select(...e){let t=l(this,a),r=t.length,o=new Array(r);for(let i=0;i<r;i++){let u={};for(let T of e)u[T]=t[i][T];o[i]=u;}let n=new c(o);return this.cloneStateInto(n),n}map(e){let t=l(this,a),r=t.length,o=new Array(r);for(let i=0;i<r;i++)o[i]=e(t[i]);let n=new c(o);return this.cloneStateInto(n),n}where(e){return this.filterRows(e),this}filterWhere(e){return this.filterRows(e,{ignoreNullValues:true}),this}orderBy(...e){return p(this,a,l(this,a).sort(S(...e))),this}skip(e){return p(this,f,e),this}limit(e){return p(this,y,e),this}all(){return this.getLimitedRows()}first(){let e=this.getLimitedRows();return e.length>0?e[0]:null}last(){let e=this.getLimitedRows();return e[e.length-1]??null}count(){return this.getLimitedRows().length}exists(){return this.count()>0}scalar(){let e=this.first(),t=this.getFirstColumn();return e&&t?e[t]:false}column(e){if(e===void 0){let n=this.getFirstColumn();if(!n)return [];e=n;}let t=this.getLimitedRows(),r=t.length;if(r===0)return [];let o=new Array(r);for(let n=0;n<r;n++)o[n]=t[n][e];return o}values(){let e=this.getLimitedRows(),t=e.length,r=new Array(t);for(let o=0;o<t;o++)r[o]=Object.values(e[o]);return r}groupBy(e,t){let r=this.getLimitedRows(),o=new Map,n=m(e);for(let i=0;i<r.length;i++){let u=r[i],T=n?e(u):u[e],K=t?t(u):u;o.has(T)?o.get(T).push(K):o.set(T,[K]);}return o}min(e){let t=this.getLimitedRows(),r=t.length;if(r===0)return null;let o=new Array(r);if(m(e))for(let n=0;n<r;n++)o[n]=e(t[n]);else for(let n=0;n<r;n++)o[n]=t[n][e];return Math.min(...o)}max(e){let t=this.getLimitedRows(),r=t.length;if(r===0)return null;let o=new Array(r);if(m(e))for(let n=0;n<r;n++)o[n]=e(t[n]);else for(let n=0;n<r;n++)o[n]=t[n][e];return Math.max(...o)}sum(e){let t=this.getLimitedRows(),r=t.length;if(r===0)return 0;let o=new Array(r);if(m(e))for(let n=0;n<r;n++)o[n]=e(t[n]);else for(let n=0;n<r;n++)o[n]=t[n][e];return o.reduce((n,i)=>n+i,0)}average(e){let t=this.count();return t===0?null:(m(e)?this.sum(e):this.sum(e))/t}filterRows(e,t){let r=l(this,a),o=[];if(m(e))for(let n=0;n<r.length;n++){let i=r[n];e(i)&&o.push(i);}else for(let n=0;n<r.length;n++){let i=r[n];w.validate(i,e,t)&&o.push(i);}p(this,a,o);}getFirstColumn(){let e=this.first();if(!e)return null;let t=L(e);return t.length>0?t[0]:null}getLimitedRows(){return l(this,a).slice(l(this,f),l(this,f)+(l(this,y)??l(this,a).length))}cloneStateInto(e){p(e,f,l(this,f)),p(e,y,l(this,y));}};a=new WeakMap,f=new WeakMap,y=new WeakMap,O([j,g(0,C),g(0,P(0))],c.prototype,"skip"),O([j,g(0,C),g(0,P(0))],c.prototype,"limit");var A=c;exports.Query=A;
+'use strict';
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = __getOwnPropDesc(target, key) ;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (decorator(target, key, result) ) || result;
+  if (result) __defProp(target, key, result);
+  return result;
+};
+var __decorateParam = (index, decorator) => (target, key) => decorator(target, key, index);
+
+// src/utils/functions/type-guards/is-number.ts
+var isNumber = (value) => typeof value === "number";
+
+// src/core/errors/invalid-argument-error.ts
+var InvalidArgumentError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "InvalidArgumentError";
+  }
+};
+
+// src/core/validation/decorators/number-validaton.ts
+var metadata = /* @__PURE__ */ new WeakMap();
+function getParams(target, propertyKey) {
+  let methods = metadata.get(target);
+  if (!methods) {
+    methods = /* @__PURE__ */ new Map();
+    metadata.set(target, methods);
+  }
+  let params = methods.get(propertyKey);
+  if (!params) {
+    params = [];
+    methods.set(propertyKey, params);
+  }
+  return params;
+}
+function min(value) {
+  return function(target, propertyKey, index) {
+    const params = getParams(target, propertyKey);
+    const existing = params.find((p) => p.index === index);
+    if (existing) {
+      existing.min = value;
+    } else {
+      params.push({ index, min: value });
+    }
+  };
+}
+function integer(target, propertyKey, index) {
+  const params = getParams(target, propertyKey);
+  const existing = params.find((p) => p.index === index);
+  if (existing) {
+    existing.integer = true;
+  } else {
+    params.push({ index, integer: true });
+  }
+}
+function validateNumbers(target, propertyKey, descriptor) {
+  const original = descriptor.value;
+  descriptor.value = function(...args) {
+    const params = metadata.get(target)?.get(propertyKey) ?? [];
+    for (const rule of params) {
+      const value = args[rule.index];
+      if (rule.min !== void 0) {
+        if (!isNumber(value) || value < rule.min) {
+          throw new InvalidArgumentError(
+            `${String(value)} is not a valid argument to param ${rule.index} on ${propertyKey}(). Expected value to be equal or greater than ${rule.min}.`
+          );
+        }
+      }
+      if (rule.max !== void 0) {
+        if (!isNumber(value) || value > rule.max) {
+          throw new InvalidArgumentError(
+            `${String(value)} is not a valid argument to param ${rule.index} on ${propertyKey}(). Expected value to be equal or less than ${rule.max}.`
+          );
+        }
+      }
+      if (rule.integer) {
+        if (!Number.isSafeInteger(value)) {
+          throw new InvalidArgumentError(
+            `${String(value)} is not a valid argument to param ${rule.index} on ${propertyKey}(). Expected value to be an integer.`
+          );
+        }
+      }
+    }
+    return original.apply(this, args);
+  };
+}
+
+// src/utils/functions/type-guards/is-object.ts
+var isObject = (value) => typeof value === "object" && value !== null;
+
+// src/utils/functions/generic/deep-equal.ts
+var deepEqual = (a, b) => {
+  if (a === b) {
+    return true;
+  }
+  if (!isObject(a) || !isObject(b)) {
+    return false;
+  }
+  if (Array.isArray(a) !== Array.isArray(b)) {
+    return false;
+  }
+  const keysA = Object.keys(a);
+  const keysB = Object.keys(b);
+  if (keysA.length !== keysB.length) {
+    return false;
+  }
+  return keysA.every(
+    (key) => Object.prototype.hasOwnProperty.call(b, key) && deepEqual(
+      a[key],
+      b[key]
+    )
+  );
+};
+
+// src/utils/functions/generic/compare-arrays.ts
+var compareArrays = (a, b) => a.length === b.length && a.every((v, i) => deepEqual(v, b[i]));
+
+// src/utils/functions/generic/get-entries.ts
+function getEntries(obj) {
+  return Object.entries(obj);
+}
+
+// src/utils/functions/type-guards/is-function.ts
+var isFunction = (value) => typeof value === "function";
+
+// src/core/validation/query-row-validator.ts
+var QueryRowValidator = class {
+  static #defaultOptions = {
+    ignoreNullValues: false
+  };
+  /**
+   * Validates all conditions of the row.
+   *
+   * @returns Validation result.
+   */
+  static validate(row, condition, options) {
+    for (const [column, columnCondition] of getEntries(condition)) {
+      const validated = this.validateColumnCondition(
+        row,
+        column,
+        columnCondition,
+        options ?? this.#defaultOptions
+      );
+      if (!validated) {
+        return false;
+      }
+    }
+    return true;
+  }
+  /**
+   * Validate a condition to a specific column.
+   *
+   * @param columnName Column name.
+   * @param condition Condition to be validated.
+   *
+   * @returns Validation result.
+   */
+  static validateColumnCondition(row, column, condition, options) {
+    if (options.ignoreNullValues && (condition === null || condition === void 0)) {
+      return true;
+    }
+    const cellValue = row[column];
+    if (isFunction(condition)) {
+      return condition(cellValue);
+    }
+    if (Array.isArray(condition)) {
+      return Array.isArray(cellValue) ? compareArrays(cellValue, condition) : false;
+    }
+    if (isObject(condition)) {
+      return isObject(cellValue) ? this.validate(cellValue, condition) : false;
+    }
+    return cellValue === condition;
+  }
+};
+
+// src/utils/functions/generic/get-object-property-names.ts
+function getObjectPropertyNames(obj) {
+  return Object.keys(obj).filter(
+    (key) => typeof obj[key] !== "function"
+  );
+}
+
+// src/utils/functions/sort/sort-by-property.ts
+function sortByProperty(property) {
+  let sortOrder = 1;
+  let prop = property;
+  if (prop.startsWith("-")) {
+    sortOrder = -1;
+    prop = prop.slice(1);
+  }
+  const key = prop;
+  return (a, b) => {
+    const valueA = a[key];
+    const valueB = b[key];
+    if (valueA == null && valueB == null) return 0;
+    if (valueA == null) return 1 * sortOrder;
+    if (valueB == null) return -1 * sortOrder;
+    if (valueA < valueB) return -1 * sortOrder;
+    if (valueA > valueB) return 1 * sortOrder;
+    return 0;
+  };
+}
+
+// src/utils/functions/sort/sort-by-properties.ts
+function sortByProperties(...props) {
+  return (a, b) => {
+    if (props.length === 0) {
+      return 0;
+    }
+    for (const prop of props) {
+      const result = sortByProperty(prop)(a, b);
+      if (result !== 0) {
+        return result;
+      }
+    }
+    return 0;
+  };
+}
+
+// src/query.ts
+var _Query = class _Query {
+  /**
+   * Rows to be queried.
+   */
+  #rows = [];
+  /**
+   * Number of results to skip.
+   */
+  #startAt = 0;
+  /**
+   * Limit of results.
+   */
+  #limit = null;
+  /**
+   * Initializes the query.
+   *
+   * @param rows Rows to be queried.
+   */
+  constructor(rows) {
+    this.#rows = [...rows];
+  }
+  /**
+   * Creates a new query based on the given data.
+   *
+   * @param rows Rows to be queried.
+   *
+   * @returns Query to the given rows.
+   */
+  static from(rows) {
+    return new _Query(rows);
+  }
+  /**
+   * Defines specific columns to be returned on the final results.
+   *
+   * @param columns Selected columns.
+   *
+   * @returns Current query.
+   */
+  select(...columns) {
+    const source = this.#rows;
+    const length = source.length;
+    const rows = new Array(length);
+    for (let i = 0; i < length; i++) {
+      const result = {};
+      for (const column of columns) {
+        result[column] = source[i][column];
+      }
+      rows[i] = result;
+    }
+    const query = new _Query(rows);
+    this.cloneStateInto(query);
+    return query;
+  }
+  /**
+   * Maps each row to a new object and returns a new query.
+   *
+   * @param callback Function to be called for each row.
+   * @returns New query with the mapped rows.
+   */
+  map(callback) {
+    const source = this.#rows;
+    const length = source.length;
+    const rows = new Array(length);
+    for (let i = 0; i < length; i++) {
+      rows[i] = callback(source[i]);
+    }
+    const query = new _Query(rows);
+    this.cloneStateInto(query);
+    return query;
+  }
+  distinct(arg) {
+    const seen = /* @__PURE__ */ new Set();
+    const result = [];
+    const rows = this.#rows;
+    const isFn = isFunction(arg);
+    for (let i = 0; i < rows.length; i++) {
+      const row = rows[i];
+      const value = isFn ? arg(row) : row[arg];
+      if (!seen.has(value)) {
+        seen.add(value);
+        result.push(row);
+      }
+    }
+    this.#rows = result;
+    return this;
+  }
+  /**
+   * Applies conditions to the query.
+   *
+   * @param condition Filter to be applied to the query.
+   *
+   * If a callback function is provided, it must return a boolean value.
+   *
+   * If an object is provided, its properties must be attributes of `T` and their
+   * corresponding values must be the expected values for the attributes or a
+   * callback functions that return boolean values.
+   *
+   * @returns Current query.
+   */
+  where(condition) {
+    this.filterRows(condition);
+    return this;
+  }
+  /**
+   * Applies a set of conditions to the query ignoring `null` and `undefined`
+   * values as conditions.
+   *
+   * @param condition An object where each property represents an attribute
+   * to be validated. The values can be literal or callback functions that
+   * return a boolean. If `null` or `undefined` is passed, that condition
+   * will be skipped.
+   *
+   * @returns Current query.
+   */
+  filterWhere(condition) {
+    this.filterRows(condition, { ignoreNullValues: true });
+    return this;
+  }
+  /**
+   * Adds ordering to the results.
+   *
+   * This method should be called after `select()`; otherwise, the ordering will
+   * be applied only to the selected columns.
+   *
+   * @example
+   * ```ts
+   * // ❌ "age" will not be ordered, because it is not part of the selected columns
+   * const query = Query.from(users)
+   *   .orderBy('-age')
+   *   .select('name');
+   *
+   * // ✅ "age" will be ordered
+   * const query = Query.from(users)
+   *   .select('name', 'age')
+   *   .orderBy('-age');
+   * ```
+   *
+   * @param columns Ascending or descending columns. To mark a field as
+   * descending, prefix it with `-`.
+   *
+   * @returns Current query.
+   */
+  orderBy(...columns) {
+    this.#rows = this.#rows.sort(sortByProperties(...columns));
+    return this;
+  }
+  skip(numberOfRows) {
+    this.#startAt = numberOfRows;
+    return this;
+  }
+  limit(limit) {
+    this.#limit = limit;
+    return this;
+  }
+  /**
+   * Returns all results.
+   *
+   * @returns All filtered rows.
+   */
+  all() {
+    return this.getLimitedRows();
+  }
+  /**
+   * Returns the first result.
+   *
+   * @returns The first result.
+   */
+  first() {
+    const rows = this.getLimitedRows();
+    return rows.length > 0 ? rows[0] : null;
+  }
+  /**
+   * Returns the last result.
+   *
+   * @returns The last result.
+   */
+  last() {
+    const rows = this.getLimitedRows();
+    return rows[rows.length - 1] ?? null;
+  }
+  /**
+   * Returns the current number of rows.
+   *
+   * @return Filtered rows count.
+   */
+  count() {
+    return this.getLimitedRows().length;
+  }
+  /**
+   * Checks if there is at least one row compatible with the query.
+   *
+   * @returns Whether any row exists after filtering.
+   */
+  exists() {
+    return this.count() > 0;
+  }
+  /**
+   * Returns the value of the first (selected) column of the first row.
+   *
+   * @returns First value or `false`, if none row exists.
+   */
+  scalar() {
+    const firstObject = this.first();
+    const firstColumn = this.getFirstColumn();
+    return firstObject && firstColumn ? firstObject[firstColumn] : false;
+  }
+  column(column) {
+    const source = this.getLimitedRows();
+    const length = source.length;
+    if (length === 0) {
+      return [];
+    }
+    if (column === void 0) {
+      const firstColumn = this.getFirstColumn();
+      if (!firstColumn) {
+        return [];
+      }
+      column = firstColumn;
+    }
+    const values = new Array(length);
+    for (let i = 0; i < length; i++) {
+      values[i] = source[i][column];
+    }
+    return values;
+  }
+  /**
+   * Returns the values of the rows. If there are selected columns, only their
+   * values will be returned.
+   *
+   * @returns Array with the values of all rows.
+   */
+  values() {
+    const source = this.getLimitedRows();
+    const length = source.length;
+    const rows = new Array(length);
+    for (let i = 0; i < length; i++) {
+      rows[i] = Object.values(source[i]);
+    }
+    return rows;
+  }
+  groupBy(groupArg, mapArg) {
+    const rows = this.getLimitedRows();
+    const map = /* @__PURE__ */ new Map();
+    const hasCallback = isFunction(groupArg);
+    for (let i = 0; i < rows.length; i++) {
+      const row = rows[i];
+      const key = hasCallback ? groupArg(row) : row[groupArg];
+      const value = mapArg ? mapArg(row) : row;
+      if (map.has(key)) {
+        map.get(key).push(value);
+      } else {
+        map.set(key, [value]);
+      }
+    }
+    return map;
+  }
+  min(arg) {
+    const source = this.getLimitedRows();
+    const length = source.length;
+    if (length === 0) {
+      return null;
+    }
+    const values = new Array(length);
+    if (isFunction(arg)) {
+      for (let i = 0; i < length; i++) {
+        values[i] = arg(source[i]);
+      }
+    } else {
+      for (let i = 0; i < length; i++) {
+        values[i] = source[i][arg];
+      }
+    }
+    return Math.min(...values);
+  }
+  max(arg) {
+    const source = this.getLimitedRows();
+    const length = source.length;
+    if (length === 0) {
+      return null;
+    }
+    const values = new Array(length);
+    if (isFunction(arg)) {
+      for (let i = 0; i < length; i++) {
+        values[i] = arg(source[i]);
+      }
+    } else {
+      for (let i = 0; i < length; i++) {
+        values[i] = source[i][arg];
+      }
+    }
+    return Math.max(...values);
+  }
+  sum(arg) {
+    const source = this.getLimitedRows();
+    const length = source.length;
+    if (length === 0) {
+      return 0;
+    }
+    const values = new Array(length);
+    if (isFunction(arg)) {
+      for (let i = 0; i < length; i++) {
+        values[i] = arg(source[i]);
+      }
+    } else {
+      for (let i = 0; i < length; i++) {
+        values[i] = source[i][arg];
+      }
+    }
+    return values.reduce((total, value) => total + value, 0);
+  }
+  average(arg) {
+    const count = this.count();
+    if (count === 0) {
+      return null;
+    }
+    const sum = isFunction(arg) ? this.sum(arg) : this.sum(arg);
+    return sum / count;
+  }
+  /**
+   * Filters the rows according to the given conditions.
+   *
+   * @param condition Object or callback function.
+   */
+  filterRows(condition, options) {
+    const rows = this.#rows;
+    const result = [];
+    if (isFunction(condition)) {
+      for (let i = 0; i < rows.length; i++) {
+        const row = rows[i];
+        if (condition(row)) {
+          result.push(row);
+        }
+      }
+    } else {
+      for (let i = 0; i < rows.length; i++) {
+        const row = rows[i];
+        if (QueryRowValidator.validate(row, condition, options)) {
+          result.push(row);
+        }
+      }
+    }
+    this.#rows = result;
+  }
+  /**
+   * Returns the first selected column or the first key of some row.
+   *
+   * @returns The first column or `null`, if none is selected  or there is no row.
+   */
+  getFirstColumn() {
+    const firstRow = this.first();
+    if (!firstRow) {
+      return null;
+    }
+    const columns = getObjectPropertyNames(firstRow);
+    if (columns.length > 0) {
+      return columns[0];
+    }
+    return null;
+  }
+  /**
+   * Returns the rows that should be used in the final results.
+   *
+   * @returns Rows within the specified limit.
+   */
+  getLimitedRows() {
+    return this.#rows.slice(
+      this.#startAt,
+      this.#startAt + (this.#limit ?? this.#rows.length)
+    );
+  }
+  /**
+   * Copies the state of the current query into the given query.
+   *
+   * @param query Query to copy the state into.
+   */
+  cloneStateInto(query) {
+    query.#startAt = this.#startAt;
+    query.#limit = this.#limit;
+  }
+};
+__decorateClass([
+  validateNumbers,
+  __decorateParam(0, integer),
+  __decorateParam(0, min(0))
+], _Query.prototype, "skip");
+__decorateClass([
+  validateNumbers,
+  __decorateParam(0, integer),
+  __decorateParam(0, min(0))
+], _Query.prototype, "limit");
+var Query = _Query;
+
+exports.Query = Query;

package/dist/esm/index.d.ts

@@ -111,6 +111,20 @@ declare class Query<T extends object> {
      * @returns New query with the mapped rows.
      */
     map<TReturn extends object>(callback: (obj: T) => TReturn): Query<TReturn>;
+    /**
+     * Removes duplicate rows based on a key.
+     *
+     * @param key Key to be used for comparison.
+     * @returns Current query.
+     */
+    distinct<K extends PropOf<T>>(key: K): this;
+    /**
+     * Removes duplicate rows based on a function.
+     *
+     * @param fn Function to be used for comparison.
+     * @returns Current query.
+     */
+    distinct<TValue>(fn: (row: T) => TValue): this;
     /**
      * Applies conditions to the query.
      *

package/dist/esm/index.js

@@ -1 +1,616 @@
-var $=Object.defineProperty;var E=Object.getOwnPropertyDescriptor;var F=s=>{throw TypeError(s)};var O=(s,e,t,r)=>{for(var o=E(e,t),n=s.length-1,i;n>=0;n--)(i=s[n])&&(o=(i(e,t,o))||o);return o&&$(e,t,o),o},g=(s,e)=>(t,r)=>e(t,r,s);var N=(s,e,t)=>e.has(s)||F("Cannot "+t);var l=(s,e,t)=>(N(s,e,"read from private field"),e.get(s)),b=(s,e,t)=>e.has(s)?F("Cannot add the same private member more than once"):e instanceof WeakSet?e.add(s):e.set(s,t),p=(s,e,t,r)=>(N(s,e,"write to private field"),e.set(s,t),t);var v=s=>typeof s=="number";var d=class extends Error{constructor(e){super(e),this.name="InvalidArgumentError";}};var k=new WeakMap;function V(s,e){let t=k.get(s);t||(t=new Map,k.set(s,t));let r=t.get(e);return r||(r=[],t.set(e,r)),r}function P(s){return function(e,t,r){let o=V(e,t),n=o.find(i=>i.index===r);n?n.min=s:o.push({index:r,min:s});}}function C(s,e,t){let r=V(s,e),o=r.find(n=>n.index===t);o?o.integer=true:r.push({index:t,integer:true});}function j(s,e,t){let r=t.value;t.value=function(...o){let n=k.get(s)?.get(e)??[];for(let i of n){let u=o[i.index];if(i.min!==void 0&&(!v(u)||u<i.min))throw new d(`${String(u)} is not a valid argument to param ${i.index} on ${e}(). Expected value to be equal or greater than ${i.min}.`);if(i.max!==void 0&&(!v(u)||u>i.max))throw new d(`${String(u)} is not a valid argument to param ${i.index} on ${e}(). Expected value to be equal or less than ${i.max}.`);if(i.integer&&!Number.isSafeInteger(u))throw new d(`${String(u)} is not a valid argument to param ${i.index} on ${e}(). Expected value to be an integer.`)}return r.apply(this,o)};}var h=s=>typeof s=="object"&&s!==null;var R=(s,e)=>{if(s===e)return  true;if(!h(s)||!h(e)||Array.isArray(s)!==Array.isArray(e))return  false;let t=Object.keys(s),r=Object.keys(e);return t.length!==r.length?false:t.every(o=>Object.prototype.hasOwnProperty.call(e,o)&&R(s[o],e[o]))};var G=(s,e)=>s.length===e.length&&s.every((t,r)=>R(t,e[r]));function B(s){return Object.entries(s)}var m=s=>typeof s=="function";var x,w=class{static validate(e,t,r){for(let[o,n]of B(t))if(!this.validateColumnCondition(e,o,n,r??l(this,x)))return  false;return  true}static validateColumnCondition(e,t,r,o){if(o.ignoreNullValues&&r==null)return  true;let n=e[t];return m(r)?r(n):Array.isArray(r)?Array.isArray(n)?G(n,r):false:h(r)?h(n)?this.validate(n,r):false:n===r}};x=new WeakMap,b(w,x,{ignoreNullValues:false});function L(s){return Object.keys(s).filter(e=>typeof s[e]!="function")}function M(s){let e=1,t=s;t.startsWith("-")&&(e=-1,t=t.slice(1));let r=t;return (o,n)=>{let i=o[r],u=n[r];return i==null&&u==null?0:i==null?1*e:u==null||i<u?-1*e:i>u?1*e:0}}function S(...s){return (e,t)=>{if(s.length===0)return 0;for(let r of s){let o=M(r)(e,t);if(o!==0)return o}return 0}}var a,f,y,c=class c{constructor(e){b(this,a,[]);b(this,f,0);b(this,y,null);p(this,a,[...e]);}static from(e){return new c(e)}select(...e){let t=l(this,a),r=t.length,o=new Array(r);for(let i=0;i<r;i++){let u={};for(let T of e)u[T]=t[i][T];o[i]=u;}let n=new c(o);return this.cloneStateInto(n),n}map(e){let t=l(this,a),r=t.length,o=new Array(r);for(let i=0;i<r;i++)o[i]=e(t[i]);let n=new c(o);return this.cloneStateInto(n),n}where(e){return this.filterRows(e),this}filterWhere(e){return this.filterRows(e,{ignoreNullValues:true}),this}orderBy(...e){return p(this,a,l(this,a).sort(S(...e))),this}skip(e){return p(this,f,e),this}limit(e){return p(this,y,e),this}all(){return this.getLimitedRows()}first(){let e=this.getLimitedRows();return e.length>0?e[0]:null}last(){let e=this.getLimitedRows();return e[e.length-1]??null}count(){return this.getLimitedRows().length}exists(){return this.count()>0}scalar(){let e=this.first(),t=this.getFirstColumn();return e&&t?e[t]:false}column(e){if(e===void 0){let n=this.getFirstColumn();if(!n)return [];e=n;}let t=this.getLimitedRows(),r=t.length;if(r===0)return [];let o=new Array(r);for(let n=0;n<r;n++)o[n]=t[n][e];return o}values(){let e=this.getLimitedRows(),t=e.length,r=new Array(t);for(let o=0;o<t;o++)r[o]=Object.values(e[o]);return r}groupBy(e,t){let r=this.getLimitedRows(),o=new Map,n=m(e);for(let i=0;i<r.length;i++){let u=r[i],T=n?e(u):u[e],K=t?t(u):u;o.has(T)?o.get(T).push(K):o.set(T,[K]);}return o}min(e){let t=this.getLimitedRows(),r=t.length;if(r===0)return null;let o=new Array(r);if(m(e))for(let n=0;n<r;n++)o[n]=e(t[n]);else for(let n=0;n<r;n++)o[n]=t[n][e];return Math.min(...o)}max(e){let t=this.getLimitedRows(),r=t.length;if(r===0)return null;let o=new Array(r);if(m(e))for(let n=0;n<r;n++)o[n]=e(t[n]);else for(let n=0;n<r;n++)o[n]=t[n][e];return Math.max(...o)}sum(e){let t=this.getLimitedRows(),r=t.length;if(r===0)return 0;let o=new Array(r);if(m(e))for(let n=0;n<r;n++)o[n]=e(t[n]);else for(let n=0;n<r;n++)o[n]=t[n][e];return o.reduce((n,i)=>n+i,0)}average(e){let t=this.count();return t===0?null:(m(e)?this.sum(e):this.sum(e))/t}filterRows(e,t){let r=l(this,a),o=[];if(m(e))for(let n=0;n<r.length;n++){let i=r[n];e(i)&&o.push(i);}else for(let n=0;n<r.length;n++){let i=r[n];w.validate(i,e,t)&&o.push(i);}p(this,a,o);}getFirstColumn(){let e=this.first();if(!e)return null;let t=L(e);return t.length>0?t[0]:null}getLimitedRows(){return l(this,a).slice(l(this,f),l(this,f)+(l(this,y)??l(this,a).length))}cloneStateInto(e){p(e,f,l(this,f)),p(e,y,l(this,y));}};a=new WeakMap,f=new WeakMap,y=new WeakMap,O([j,g(0,C),g(0,P(0))],c.prototype,"skip"),O([j,g(0,C),g(0,P(0))],c.prototype,"limit");var A=c;export{A as Query};
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = __getOwnPropDesc(target, key) ;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (decorator(target, key, result) ) || result;
+  if (result) __defProp(target, key, result);
+  return result;
+};
+var __decorateParam = (index, decorator) => (target, key) => decorator(target, key, index);
+
+// src/utils/functions/type-guards/is-number.ts
+var isNumber = (value) => typeof value === "number";
+
+// src/core/errors/invalid-argument-error.ts
+var InvalidArgumentError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "InvalidArgumentError";
+  }
+};
+
+// src/core/validation/decorators/number-validaton.ts
+var metadata = /* @__PURE__ */ new WeakMap();
+function getParams(target, propertyKey) {
+  let methods = metadata.get(target);
+  if (!methods) {
+    methods = /* @__PURE__ */ new Map();
+    metadata.set(target, methods);
+  }
+  let params = methods.get(propertyKey);
+  if (!params) {
+    params = [];
+    methods.set(propertyKey, params);
+  }
+  return params;
+}
+function min(value) {
+  return function(target, propertyKey, index) {
+    const params = getParams(target, propertyKey);
+    const existing = params.find((p) => p.index === index);
+    if (existing) {
+      existing.min = value;
+    } else {
+      params.push({ index, min: value });
+    }
+  };
+}
+function integer(target, propertyKey, index) {
+  const params = getParams(target, propertyKey);
+  const existing = params.find((p) => p.index === index);
+  if (existing) {
+    existing.integer = true;
+  } else {
+    params.push({ index, integer: true });
+  }
+}
+function validateNumbers(target, propertyKey, descriptor) {
+  const original = descriptor.value;
+  descriptor.value = function(...args) {
+    const params = metadata.get(target)?.get(propertyKey) ?? [];
+    for (const rule of params) {
+      const value = args[rule.index];
+      if (rule.min !== void 0) {
+        if (!isNumber(value) || value < rule.min) {
+          throw new InvalidArgumentError(
+            `${String(value)} is not a valid argument to param ${rule.index} on ${propertyKey}(). Expected value to be equal or greater than ${rule.min}.`
+          );
+        }
+      }
+      if (rule.max !== void 0) {
+        if (!isNumber(value) || value > rule.max) {
+          throw new InvalidArgumentError(
+            `${String(value)} is not a valid argument to param ${rule.index} on ${propertyKey}(). Expected value to be equal or less than ${rule.max}.`
+          );
+        }
+      }
+      if (rule.integer) {
+        if (!Number.isSafeInteger(value)) {
+          throw new InvalidArgumentError(
+            `${String(value)} is not a valid argument to param ${rule.index} on ${propertyKey}(). Expected value to be an integer.`
+          );
+        }
+      }
+    }
+    return original.apply(this, args);
+  };
+}
+
+// src/utils/functions/type-guards/is-object.ts
+var isObject = (value) => typeof value === "object" && value !== null;
+
+// src/utils/functions/generic/deep-equal.ts
+var deepEqual = (a, b) => {
+  if (a === b) {
+    return true;
+  }
+  if (!isObject(a) || !isObject(b)) {
+    return false;
+  }
+  if (Array.isArray(a) !== Array.isArray(b)) {
+    return false;
+  }
+  const keysA = Object.keys(a);
+  const keysB = Object.keys(b);
+  if (keysA.length !== keysB.length) {
+    return false;
+  }
+  return keysA.every(
+    (key) => Object.prototype.hasOwnProperty.call(b, key) && deepEqual(
+      a[key],
+      b[key]
+    )
+  );
+};
+
+// src/utils/functions/generic/compare-arrays.ts
+var compareArrays = (a, b) => a.length === b.length && a.every((v, i) => deepEqual(v, b[i]));
+
+// src/utils/functions/generic/get-entries.ts
+function getEntries(obj) {
+  return Object.entries(obj);
+}
+
+// src/utils/functions/type-guards/is-function.ts
+var isFunction = (value) => typeof value === "function";
+
+// src/core/validation/query-row-validator.ts
+var QueryRowValidator = class {
+  static #defaultOptions = {
+    ignoreNullValues: false
+  };
+  /**
+   * Validates all conditions of the row.
+   *
+   * @returns Validation result.
+   */
+  static validate(row, condition, options) {
+    for (const [column, columnCondition] of getEntries(condition)) {
+      const validated = this.validateColumnCondition(
+        row,
+        column,
+        columnCondition,
+        options ?? this.#defaultOptions
+      );
+      if (!validated) {
+        return false;
+      }
+    }
+    return true;
+  }
+  /**
+   * Validate a condition to a specific column.
+   *
+   * @param columnName Column name.
+   * @param condition Condition to be validated.
+   *
+   * @returns Validation result.
+   */
+  static validateColumnCondition(row, column, condition, options) {
+    if (options.ignoreNullValues && (condition === null || condition === void 0)) {
+      return true;
+    }
+    const cellValue = row[column];
+    if (isFunction(condition)) {
+      return condition(cellValue);
+    }
+    if (Array.isArray(condition)) {
+      return Array.isArray(cellValue) ? compareArrays(cellValue, condition) : false;
+    }
+    if (isObject(condition)) {
+      return isObject(cellValue) ? this.validate(cellValue, condition) : false;
+    }
+    return cellValue === condition;
+  }
+};
+
+// src/utils/functions/generic/get-object-property-names.ts
+function getObjectPropertyNames(obj) {
+  return Object.keys(obj).filter(
+    (key) => typeof obj[key] !== "function"
+  );
+}
+
+// src/utils/functions/sort/sort-by-property.ts
+function sortByProperty(property) {
+  let sortOrder = 1;
+  let prop = property;
+  if (prop.startsWith("-")) {
+    sortOrder = -1;
+    prop = prop.slice(1);
+  }
+  const key = prop;
+  return (a, b) => {
+    const valueA = a[key];
+    const valueB = b[key];
+    if (valueA == null && valueB == null) return 0;
+    if (valueA == null) return 1 * sortOrder;
+    if (valueB == null) return -1 * sortOrder;
+    if (valueA < valueB) return -1 * sortOrder;
+    if (valueA > valueB) return 1 * sortOrder;
+    return 0;
+  };
+}
+
+// src/utils/functions/sort/sort-by-properties.ts
+function sortByProperties(...props) {
+  return (a, b) => {
+    if (props.length === 0) {
+      return 0;
+    }
+    for (const prop of props) {
+      const result = sortByProperty(prop)(a, b);
+      if (result !== 0) {
+        return result;
+      }
+    }
+    return 0;
+  };
+}
+
+// src/query.ts
+var _Query = class _Query {
+  /**
+   * Rows to be queried.
+   */
+  #rows = [];
+  /**
+   * Number of results to skip.
+   */
+  #startAt = 0;
+  /**
+   * Limit of results.
+   */
+  #limit = null;
+  /**
+   * Initializes the query.
+   *
+   * @param rows Rows to be queried.
+   */
+  constructor(rows) {
+    this.#rows = [...rows];
+  }
+  /**
+   * Creates a new query based on the given data.
+   *
+   * @param rows Rows to be queried.
+   *
+   * @returns Query to the given rows.
+   */
+  static from(rows) {
+    return new _Query(rows);
+  }
+  /**
+   * Defines specific columns to be returned on the final results.
+   *
+   * @param columns Selected columns.
+   *
+   * @returns Current query.
+   */
+  select(...columns) {
+    const source = this.#rows;
+    const length = source.length;
+    const rows = new Array(length);
+    for (let i = 0; i < length; i++) {
+      const result = {};
+      for (const column of columns) {
+        result[column] = source[i][column];
+      }
+      rows[i] = result;
+    }
+    const query = new _Query(rows);
+    this.cloneStateInto(query);
+    return query;
+  }
+  /**
+   * Maps each row to a new object and returns a new query.
+   *
+   * @param callback Function to be called for each row.
+   * @returns New query with the mapped rows.
+   */
+  map(callback) {
+    const source = this.#rows;
+    const length = source.length;
+    const rows = new Array(length);
+    for (let i = 0; i < length; i++) {
+      rows[i] = callback(source[i]);
+    }
+    const query = new _Query(rows);
+    this.cloneStateInto(query);
+    return query;
+  }
+  distinct(arg) {
+    const seen = /* @__PURE__ */ new Set();
+    const result = [];
+    const rows = this.#rows;
+    const isFn = isFunction(arg);
+    for (let i = 0; i < rows.length; i++) {
+      const row = rows[i];
+      const value = isFn ? arg(row) : row[arg];
+      if (!seen.has(value)) {
+        seen.add(value);
+        result.push(row);
+      }
+    }
+    this.#rows = result;
+    return this;
+  }
+  /**
+   * Applies conditions to the query.
+   *
+   * @param condition Filter to be applied to the query.
+   *
+   * If a callback function is provided, it must return a boolean value.
+   *
+   * If an object is provided, its properties must be attributes of `T` and their
+   * corresponding values must be the expected values for the attributes or a
+   * callback functions that return boolean values.
+   *
+   * @returns Current query.
+   */
+  where(condition) {
+    this.filterRows(condition);
+    return this;
+  }
+  /**
+   * Applies a set of conditions to the query ignoring `null` and `undefined`
+   * values as conditions.
+   *
+   * @param condition An object where each property represents an attribute
+   * to be validated. The values can be literal or callback functions that
+   * return a boolean. If `null` or `undefined` is passed, that condition
+   * will be skipped.
+   *
+   * @returns Current query.
+   */
+  filterWhere(condition) {
+    this.filterRows(condition, { ignoreNullValues: true });
+    return this;
+  }
+  /**
+   * Adds ordering to the results.
+   *
+   * This method should be called after `select()`; otherwise, the ordering will
+   * be applied only to the selected columns.
+   *
+   * @example
+   * ```ts
+   * // ❌ "age" will not be ordered, because it is not part of the selected columns
+   * const query = Query.from(users)
+   *   .orderBy('-age')
+   *   .select('name');
+   *
+   * // ✅ "age" will be ordered
+   * const query = Query.from(users)
+   *   .select('name', 'age')
+   *   .orderBy('-age');
+   * ```
+   *
+   * @param columns Ascending or descending columns. To mark a field as
+   * descending, prefix it with `-`.
+   *
+   * @returns Current query.
+   */
+  orderBy(...columns) {
+    this.#rows = this.#rows.sort(sortByProperties(...columns));
+    return this;
+  }
+  skip(numberOfRows) {
+    this.#startAt = numberOfRows;
+    return this;
+  }
+  limit(limit) {
+    this.#limit = limit;
+    return this;
+  }
+  /**
+   * Returns all results.
+   *
+   * @returns All filtered rows.
+   */
+  all() {
+    return this.getLimitedRows();
+  }
+  /**
+   * Returns the first result.
+   *
+   * @returns The first result.
+   */
+  first() {
+    const rows = this.getLimitedRows();
+    return rows.length > 0 ? rows[0] : null;
+  }
+  /**
+   * Returns the last result.
+   *
+   * @returns The last result.
+   */
+  last() {
+    const rows = this.getLimitedRows();
+    return rows[rows.length - 1] ?? null;
+  }
+  /**
+   * Returns the current number of rows.
+   *
+   * @return Filtered rows count.
+   */
+  count() {
+    return this.getLimitedRows().length;
+  }
+  /**
+   * Checks if there is at least one row compatible with the query.
+   *
+   * @returns Whether any row exists after filtering.
+   */
+  exists() {
+    return this.count() > 0;
+  }
+  /**
+   * Returns the value of the first (selected) column of the first row.
+   *
+   * @returns First value or `false`, if none row exists.
+   */
+  scalar() {
+    const firstObject = this.first();
+    const firstColumn = this.getFirstColumn();
+    return firstObject && firstColumn ? firstObject[firstColumn] : false;
+  }
+  column(column) {
+    const source = this.getLimitedRows();
+    const length = source.length;
+    if (length === 0) {
+      return [];
+    }
+    if (column === void 0) {
+      const firstColumn = this.getFirstColumn();
+      if (!firstColumn) {
+        return [];
+      }
+      column = firstColumn;
+    }
+    const values = new Array(length);
+    for (let i = 0; i < length; i++) {
+      values[i] = source[i][column];
+    }
+    return values;
+  }
+  /**
+   * Returns the values of the rows. If there are selected columns, only their
+   * values will be returned.
+   *
+   * @returns Array with the values of all rows.
+   */
+  values() {
+    const source = this.getLimitedRows();
+    const length = source.length;
+    const rows = new Array(length);
+    for (let i = 0; i < length; i++) {
+      rows[i] = Object.values(source[i]);
+    }
+    return rows;
+  }
+  groupBy(groupArg, mapArg) {
+    const rows = this.getLimitedRows();
+    const map = /* @__PURE__ */ new Map();
+    const hasCallback = isFunction(groupArg);
+    for (let i = 0; i < rows.length; i++) {
+      const row = rows[i];
+      const key = hasCallback ? groupArg(row) : row[groupArg];
+      const value = mapArg ? mapArg(row) : row;
+      if (map.has(key)) {
+        map.get(key).push(value);
+      } else {
+        map.set(key, [value]);
+      }
+    }
+    return map;
+  }
+  min(arg) {
+    const source = this.getLimitedRows();
+    const length = source.length;
+    if (length === 0) {
+      return null;
+    }
+    const values = new Array(length);
+    if (isFunction(arg)) {
+      for (let i = 0; i < length; i++) {
+        values[i] = arg(source[i]);
+      }
+    } else {
+      for (let i = 0; i < length; i++) {
+        values[i] = source[i][arg];
+      }
+    }
+    return Math.min(...values);
+  }
+  max(arg) {
+    const source = this.getLimitedRows();
+    const length = source.length;
+    if (length === 0) {
+      return null;
+    }
+    const values = new Array(length);
+    if (isFunction(arg)) {
+      for (let i = 0; i < length; i++) {
+        values[i] = arg(source[i]);
+      }
+    } else {
+      for (let i = 0; i < length; i++) {
+        values[i] = source[i][arg];
+      }
+    }
+    return Math.max(...values);
+  }
+  sum(arg) {
+    const source = this.getLimitedRows();
+    const length = source.length;
+    if (length === 0) {
+      return 0;
+    }
+    const values = new Array(length);
+    if (isFunction(arg)) {
+      for (let i = 0; i < length; i++) {
+        values[i] = arg(source[i]);
+      }
+    } else {
+      for (let i = 0; i < length; i++) {
+        values[i] = source[i][arg];
+      }
+    }
+    return values.reduce((total, value) => total + value, 0);
+  }
+  average(arg) {
+    const count = this.count();
+    if (count === 0) {
+      return null;
+    }
+    const sum = isFunction(arg) ? this.sum(arg) : this.sum(arg);
+    return sum / count;
+  }
+  /**
+   * Filters the rows according to the given conditions.
+   *
+   * @param condition Object or callback function.
+   */
+  filterRows(condition, options) {
+    const rows = this.#rows;
+    const result = [];
+    if (isFunction(condition)) {
+      for (let i = 0; i < rows.length; i++) {
+        const row = rows[i];
+        if (condition(row)) {
+          result.push(row);
+        }
+      }
+    } else {
+      for (let i = 0; i < rows.length; i++) {
+        const row = rows[i];
+        if (QueryRowValidator.validate(row, condition, options)) {
+          result.push(row);
+        }
+      }
+    }
+    this.#rows = result;
+  }
+  /**
+   * Returns the first selected column or the first key of some row.
+   *
+   * @returns The first column or `null`, if none is selected  or there is no row.
+   */
+  getFirstColumn() {
+    const firstRow = this.first();
+    if (!firstRow) {
+      return null;
+    }
+    const columns = getObjectPropertyNames(firstRow);
+    if (columns.length > 0) {
+      return columns[0];
+    }
+    return null;
+  }
+  /**
+   * Returns the rows that should be used in the final results.
+   *
+   * @returns Rows within the specified limit.
+   */
+  getLimitedRows() {
+    return this.#rows.slice(
+      this.#startAt,
+      this.#startAt + (this.#limit ?? this.#rows.length)
+    );
+  }
+  /**
+   * Copies the state of the current query into the given query.
+   *
+   * @param query Query to copy the state into.
+   */
+  cloneStateInto(query) {
+    query.#startAt = this.#startAt;
+    query.#limit = this.#limit;
+  }
+};
+__decorateClass([
+  validateNumbers,
+  __decorateParam(0, integer),
+  __decorateParam(0, min(0))
+], _Query.prototype, "skip");
+__decorateClass([
+  validateNumbers,
+  __decorateParam(0, integer),
+  __decorateParam(0, min(0))
+], _Query.prototype, "limit");
+var Query = _Query;
+
+export { Query };

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "querier-ts",
   "type": "module",
-  "version": "2.4.1",
+  "version": "2.5.1",
   "description": "A lightweight, type-safe in-memory query engine for JavaScript and TypeScript",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/luizfilipezs/query-ts.git"
+    "url": "git+https://github.com/luizfilipezs/querier-ts.git"
   },
   "keywords": [
     "query",
@@ -19,9 +19,9 @@
   },
   "license": "MIT",
   "bugs": {
-    "url": "https://github.com/luizfilipezs/query-ts/issues"
+    "url": "https://github.com/luizfilipezs/querier-ts/issues"
   },
-  "homepage": "https://github.com/luizfilipezs/query-ts#readme",
+  "homepage": "https://github.com/luizfilipezs/querier-ts#readme",
   "files": [
     "dist",
     "README.md",
@@ -61,7 +61,7 @@
   "devDependencies": {
     "@eslint/js": "^10.0.1",
     "@vitest/coverage-v8": "^4.1.2",
-    "eslint": "^10.1.0",
+    "eslint": "^10.2.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.5",
     "globals": "^17.4.0",