querier-ts 2.4.0 → 2.5.0

package/CHANGELOG.md

@@ -1,5 +1,50 @@
 # Changelog
 
+## 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
+
+- [ ] Bug fixes
+- [x] Code refactoring
+- [ ] New features
+- [x] Compatibility improvements
+- [ ] Breaking changes
+
+### Code refactoring
+
+- 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.
+- Updated JSDoc for `Query`.
+
+### Compatibility improvements
+
+- Updated development dependencies.
+
 ## v2.4.0
 
 ### Changes

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 @@
-'use strict';var S=Object.defineProperty;var $=Object.getOwnPropertyDescriptor;var F=n=>{throw TypeError(n)};var x=(n,e,t,r)=>{for(var o=$(e,t),i=n.length-1,s;i>=0;i--)(s=n[i])&&(o=(s(e,t,o))||o);return o&&S(e,t,o),o},h=(n,e)=>(t,r)=>e(t,r,n);var N=(n,e,t)=>e.has(n)||F("Cannot "+t);var l=(n,e,t)=>(N(n,e,"read from private field"),t?t.call(n):e.get(n)),y=(n,e,t)=>e.has(n)?F("Cannot add the same private member more than once"):e instanceof WeakSet?e.add(n):e.set(n,t),p=(n,e,t,r)=>(N(n,e,"write to private field"),e.set(n,t),t);var O=n=>typeof n=="number";var b=class extends Error{constructor(e){super(e),this.name="InvalidArgumentError";}};var v=new WeakMap;function V(n,e){let t=v.get(n);t||(t=new Map,v.set(n,t));let r=t.get(e);return r||(r=[],t.set(e,r)),r}function k(n){return function(e,t,r){let o=V(e,t),i=o.find(s=>s.index===r);i?i.min=n:o.push({index:r,min:n});}}function P(n,e,t){let r=V(n,e),o=r.find(i=>i.index===t);o?o.integer=true:r.push({index:t,integer:true});}function C(n,e,t){let r=t.value;t.value=function(...o){let i=v.get(n)?.get(e)??[];for(let s of i){let u=o[s.index];if(s.min!==void 0&&(!O(u)||u<s.min))throw new b(`${String(u)} is not a valid argument to param ${s.index} on ${e}(). Expected value to be equal or greater than ${s.min}.`);if(s.max!==void 0&&(!O(u)||u>s.max))throw new b(`${String(u)} is not a valid argument to param ${s.index} on ${e}(). Expected value to be equal or less than ${s.max}.`);if(s.integer&&!Number.isSafeInteger(u))throw new b(`${String(u)} is not a valid argument to param ${s.index} on ${e}(). Expected value to be an integer.`)}return r.apply(this,o)};}var d=n=>typeof n=="object"&&n!==null;var j=(n,e)=>{if(n===e)return  true;if(!d(n)||!d(e)||Array.isArray(n)!==Array.isArray(e))return  false;let t=Object.keys(n),r=Object.keys(e);return t.length!==r.length?false:t.every(o=>Object.prototype.hasOwnProperty.call(e,o)&&j(n[o],e[o]))};var A=(n,e)=>n.length===e.length&&n.every((t,r)=>j(t,e[r]));function G(n){return Object.entries(n)}var m=n=>typeof n=="function";var w,g=class{static validate(e,t,r){for(let[o,i]of G(t))if(!this.validateColumnCondition(e,o,i,r??l(this,w)))return  false;return  true}static validateColumnCondition(e,t,r,o){if(o.ignoreNullValues&&r==null)return  true;let i=e[t];return m(r)?r(i):Array.isArray(r)?Array.isArray(i)?A(i,r):false:d(r)?d(i)?this.validate(i,r):false:i===r}};w=new WeakMap,y(g,w,{ignoreNullValues:false});function B(n){return Object.keys(n).filter(e=>typeof n[e]!="function")}function L(n){let e=1,t=n;t.startsWith("-")&&(e=-1,t=t.slice(1));let r=t;return (o,i)=>{let s=o[r],u=i[r];return s==null&&u==null?0:s==null?1*e:u==null||s<u?-1*e:s>u?1*e:0}}function M(...n){return (e,t)=>{if(n.length===0)return 0;for(let r of n){let o=L(r)(e,t);if(o!==0)return o}return 0}}var a,f,T,c=class c{constructor(e){y(this,a,[]);y(this,f,0);y(this,T,null);p(this,a,[...e]);}static from(e){return new c(e)}select(...e){let t=[];for(let o of l(this,a)){let i={};for(let s of e)i[s]=o[s];t.push(i);}let r=new c(t);return this.cloneStateInto(r),r}map(e){let t=[];for(let o of l(this,a))t.push(e(o));let r=new c(t);return this.cloneStateInto(r),r}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(M(...e))),this}skip(e){return p(this,f,e),this}limit(e){return p(this,T,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 t=this.getFirstColumn();if(!t)return [];e=t;}return this.getLimitedRows().map(t=>t[e])}values(){let e=[];for(let t of this.getLimitedRows())e.push(Object.values(t));return e}groupBy(e,t){let r=this.getLimitedRows(),o=new Map,i=m(e);for(let s of r){let u=i?e(s):s[e],K=t?t(s):s;o.has(u)?o.get(u).push(K):o.set(u,[K]);}return o}min(e){let t=this.getLimitedRows();if(t.length===0)return null;let r=m(e)?t.map(o=>e(o)):t.map(o=>o[e]);return r.length===0?null:Math.min(...r)}max(e){let t=this.getLimitedRows();if(t.length===0)return null;let r=m(e)?t.map(o=>e(o)):t.map(o=>o[e]);return r.length===0?null:Math.max(...r)}sum(e){let t=this.getLimitedRows();return t.length===0?0:(m(e)?t.map(o=>e(o)):t.map(o=>o[e])).reduce((o,i)=>o+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 i=0;i<r.length;i++){let s=r[i];e(s)&&o.push(s);}else for(let i=0;i<r.length;i++){let s=r[i];g.validate(s,e,t)&&o.push(s);}p(this,a,o);}getFirstColumn(){let e=this.first();if(!e)return null;let t=B(e);return t.length>0?t[0]:null}getLimitedRows(){let e=[...l(this,a)];return e.slice(l(this,f),l(this,f)+(l(this,T)??e.length))}cloneStateInto(e){p(e,f,l(this,f)),p(e,T,l(this,T));}};a=new WeakMap,f=new WeakMap,T=new WeakMap,x([C,h(0,P),h(0,k(0))],c.prototype,"skip"),x([C,h(0,P),h(0,k(0))],c.prototype,"limit");var R=c;exports.Query=R;
+'use strict';var $=Object.defineProperty;var E=Object.getOwnPropertyDescriptor;var V=s=>{throw TypeError(s)};var O=(s,e,t,n)=>{for(var o=E(e,t),r=s.length-1,i;r>=0;r--)(i=s[r])&&(o=(i(e,t,o))||o);return o&&$(e,t,o),o},g=(s,e)=>(t,n)=>e(t,n,s);var F=(s,e,t)=>e.has(s)||V("Cannot "+t);var l=(s,e,t)=>(F(s,e,"read from private field"),e.get(s)),d=(s,e,t)=>e.has(s)?V("Cannot add the same private member more than once"):e instanceof WeakSet?e.add(s):e.set(s,t),f=(s,e,t,n)=>(F(s,e,"write to private field"),e.set(s,t),t);var v=s=>typeof s=="number";var b=class extends Error{constructor(e){super(e),this.name="InvalidArgumentError";}};var k=new WeakMap;function N(s,e){let t=k.get(s);t||(t=new Map,k.set(s,t));let n=t.get(e);return n||(n=[],t.set(e,n)),n}function P(s){return function(e,t,n){let o=N(e,t),r=o.find(i=>i.index===n);r?r.min=s:o.push({index:n,min:s});}}function C(s,e,t){let n=N(s,e),o=n.find(r=>r.index===t);o?o.integer=true:n.push({index:t,integer:true});}function j(s,e,t){let n=t.value;t.value=function(...o){let r=k.get(s)?.get(e)??[];for(let i of r){let u=o[i.index];if(i.min!==void 0&&(!v(u)||u<i.min))throw new b(`${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 b(`${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 b(`${String(u)} is not a valid argument to param ${i.index} on ${e}(). Expected value to be an integer.`)}return n.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),n=Object.keys(e);return t.length!==n.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,n)=>R(t,e[n]));function B(s){return Object.entries(s)}var m=s=>typeof s=="function";var x,w=class{static validate(e,t,n){for(let[o,r]of B(t))if(!this.validateColumnCondition(e,o,r,n??l(this,x)))return  false;return  true}static validateColumnCondition(e,t,n,o){if(o.ignoreNullValues&&n==null)return  true;let r=e[t];return m(n)?n(r):Array.isArray(n)?Array.isArray(r)?G(r,n):false:h(n)?h(r)?this.validate(r,n):false:r===n}};x=new WeakMap,d(w,x,{ignoreNullValues:false});function S(s){return Object.keys(s).filter(e=>typeof s[e]!="function")}function L(s){let e=1,t=s;t.startsWith("-")&&(e=-1,t=t.slice(1));let n=t;return (o,r)=>{let i=o[n],u=r[n];return i==null&&u==null?0:i==null?1*e:u==null||i<u?-1*e:i>u?1*e:0}}function M(...s){return (e,t)=>{if(s.length===0)return 0;for(let n of s){let o=L(n)(e,t);if(o!==0)return o}return 0}}var a,c,y,T=class T{constructor(e){d(this,a,[]);d(this,c,0);d(this,y,null);f(this,a,[...e]);}static from(e){return new T(e)}select(...e){let t=l(this,a),n=t.length,o=new Array(n);for(let i=0;i<n;i++){let u={};for(let p of e)u[p]=t[i][p];o[i]=u;}let r=new T(o);return this.cloneStateInto(r),r}map(e){let t=l(this,a),n=t.length,o=new Array(n);for(let i=0;i<n;i++)o[i]=e(t[i]);let r=new T(o);return this.cloneStateInto(r),r}distinct(e){let t=new Set,n=[],o=l(this,a),r=m(e);for(let i=0;i<o.length;i++){let u=o[i],p=r?e(u):u[e];t.has(p)||(t.add(p),n.push(u));}return f(this,a,n),this}where(e){return this.filterRows(e),this}filterWhere(e){return this.filterRows(e,{ignoreNullValues:true}),this}orderBy(...e){return f(this,a,l(this,a).sort(M(...e))),this}skip(e){return f(this,c,e),this}limit(e){return f(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){let t=this.getLimitedRows(),n=t.length;if(n===0)return [];if(e===void 0){let r=this.getFirstColumn();if(!r)return [];e=r;}let o=new Array(n);for(let r=0;r<n;r++)o[r]=t[r][e];return o}values(){let e=this.getLimitedRows(),t=e.length,n=new Array(t);for(let o=0;o<t;o++)n[o]=Object.values(e[o]);return n}groupBy(e,t){let n=this.getLimitedRows(),o=new Map,r=m(e);for(let i=0;i<n.length;i++){let u=n[i],p=r?e(u):u[e],A=t?t(u):u;o.has(p)?o.get(p).push(A):o.set(p,[A]);}return o}min(e){let t=this.getLimitedRows(),n=t.length;if(n===0)return null;let o=new Array(n);if(m(e))for(let r=0;r<n;r++)o[r]=e(t[r]);else for(let r=0;r<n;r++)o[r]=t[r][e];return Math.min(...o)}max(e){let t=this.getLimitedRows(),n=t.length;if(n===0)return null;let o=new Array(n);if(m(e))for(let r=0;r<n;r++)o[r]=e(t[r]);else for(let r=0;r<n;r++)o[r]=t[r][e];return Math.max(...o)}sum(e){let t=this.getLimitedRows(),n=t.length;if(n===0)return 0;let o=new Array(n);if(m(e))for(let r=0;r<n;r++)o[r]=e(t[r]);else for(let r=0;r<n;r++)o[r]=t[r][e];return o.reduce((r,i)=>r+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 n=l(this,a),o=[];if(m(e))for(let r=0;r<n.length;r++){let i=n[r];e(i)&&o.push(i);}else for(let r=0;r<n.length;r++){let i=n[r];w.validate(i,e,t)&&o.push(i);}f(this,a,o);}getFirstColumn(){let e=this.first();if(!e)return null;let t=S(e);return t.length>0?t[0]:null}getLimitedRows(){return l(this,a).slice(l(this,c),l(this,c)+(l(this,y)??l(this,a).length))}cloneStateInto(e){f(e,c,l(this,c)),f(e,y,l(this,y));}};a=new WeakMap,c=new WeakMap,y=new WeakMap,O([j,g(0,C),g(0,P(0))],T.prototype,"skip"),O([j,g(0,C),g(0,P(0))],T.prototype,"limit");var K=T;exports.Query=K;

package/dist/esm/index.d.ts

@@ -34,50 +34,49 @@ type KeysOfType<T, TValue> = {
 }[keyof T];
 
 /**
- * Allows filtering data from an array of objects.
+ * A fluent, immutable-like query builder for in-memory collections.
  *
- * @example
- * ```ts
- * interface User {
- *   id: string;
- *   email: string;
- *   isActive: boolean;
- *   createdAt: string;
- *   updatedAt: string;
- * }
+ * Provides a set of methods to filter, transform, group, aggregate and
+ * retrieve data from an array of objects, inspired by database query APIs.
  *
- * const users: User[] = [];
+ * All transformation methods (e.g. `select`, `map`) return a new `Query`
+ * instance, preserving the original query state. Filtering and stateful
+ * operations (e.g. `where`, `orderBy`, `skip`, `limit`) mutate the current instance.
  *
- * // Filtering objects
+ * @typeParam T - The shape of the objects being queried.
  *
- * const activeGmailUsers = Query.from(users)
+ * @example
+ * ```ts
+ * const results = Query.from(users)
  *   .where({
- *     isActive: true,
- *     email: (email) => email.endsWith('@gmail.com'),
- *   })
- *   .all();
- *
- * // Selecting specific data
- *
- * const userEmails = Query.from(users)
- *   .select('email')
- *   .column();
- *
- * const lastUserId = Query.from(users)
- *   .select('id')
+ *      active: true,
+ *      email: (email) => email.endsWith('@example.com'),
+ *    })
  *   .orderBy('-createdAt')
- *   .scalar();
- *
- * // Checking information
+ *   .select('id', 'name')
+ *   .skip(10)
+ *   .limit(5)
+ *   .all();
+ * ```
  *
- * const userExists = Query.from(users)
- *   .where({
- *     id: 'some-id',
- *   })
- *   .exists();
+ * @example
+ * ```ts
+ * const total = Query.from(products)
+ *   .where(p => p.category === 'books')
+ *   .sum('price');
+ * ```
  *
- * const numberOfUsers = Query.from(users).count();
+ * @example
+ * ```ts
+ * const grouped = Query.from(users)
+ *   .groupBy('role');
+ * // Map<Role, User[]>
  * ```
+ *
+ * @remarks
+ * - All operations are performed in memory.
+ * - Ordering is applied to the current dataset at the moment `orderBy` is called.
+ * - `skip` and `limit` are only applied when retrieving results (`all`, `first`, etc.).
  */
 declare class Query<T extends object> {
     #private;
@@ -112,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 @@
-var S=Object.defineProperty;var $=Object.getOwnPropertyDescriptor;var F=n=>{throw TypeError(n)};var x=(n,e,t,r)=>{for(var o=$(e,t),i=n.length-1,s;i>=0;i--)(s=n[i])&&(o=(s(e,t,o))||o);return o&&S(e,t,o),o},h=(n,e)=>(t,r)=>e(t,r,n);var N=(n,e,t)=>e.has(n)||F("Cannot "+t);var l=(n,e,t)=>(N(n,e,"read from private field"),t?t.call(n):e.get(n)),y=(n,e,t)=>e.has(n)?F("Cannot add the same private member more than once"):e instanceof WeakSet?e.add(n):e.set(n,t),p=(n,e,t,r)=>(N(n,e,"write to private field"),e.set(n,t),t);var O=n=>typeof n=="number";var b=class extends Error{constructor(e){super(e),this.name="InvalidArgumentError";}};var v=new WeakMap;function V(n,e){let t=v.get(n);t||(t=new Map,v.set(n,t));let r=t.get(e);return r||(r=[],t.set(e,r)),r}function k(n){return function(e,t,r){let o=V(e,t),i=o.find(s=>s.index===r);i?i.min=n:o.push({index:r,min:n});}}function P(n,e,t){let r=V(n,e),o=r.find(i=>i.index===t);o?o.integer=true:r.push({index:t,integer:true});}function C(n,e,t){let r=t.value;t.value=function(...o){let i=v.get(n)?.get(e)??[];for(let s of i){let u=o[s.index];if(s.min!==void 0&&(!O(u)||u<s.min))throw new b(`${String(u)} is not a valid argument to param ${s.index} on ${e}(). Expected value to be equal or greater than ${s.min}.`);if(s.max!==void 0&&(!O(u)||u>s.max))throw new b(`${String(u)} is not a valid argument to param ${s.index} on ${e}(). Expected value to be equal or less than ${s.max}.`);if(s.integer&&!Number.isSafeInteger(u))throw new b(`${String(u)} is not a valid argument to param ${s.index} on ${e}(). Expected value to be an integer.`)}return r.apply(this,o)};}var d=n=>typeof n=="object"&&n!==null;var j=(n,e)=>{if(n===e)return  true;if(!d(n)||!d(e)||Array.isArray(n)!==Array.isArray(e))return  false;let t=Object.keys(n),r=Object.keys(e);return t.length!==r.length?false:t.every(o=>Object.prototype.hasOwnProperty.call(e,o)&&j(n[o],e[o]))};var A=(n,e)=>n.length===e.length&&n.every((t,r)=>j(t,e[r]));function G(n){return Object.entries(n)}var m=n=>typeof n=="function";var w,g=class{static validate(e,t,r){for(let[o,i]of G(t))if(!this.validateColumnCondition(e,o,i,r??l(this,w)))return  false;return  true}static validateColumnCondition(e,t,r,o){if(o.ignoreNullValues&&r==null)return  true;let i=e[t];return m(r)?r(i):Array.isArray(r)?Array.isArray(i)?A(i,r):false:d(r)?d(i)?this.validate(i,r):false:i===r}};w=new WeakMap,y(g,w,{ignoreNullValues:false});function B(n){return Object.keys(n).filter(e=>typeof n[e]!="function")}function L(n){let e=1,t=n;t.startsWith("-")&&(e=-1,t=t.slice(1));let r=t;return (o,i)=>{let s=o[r],u=i[r];return s==null&&u==null?0:s==null?1*e:u==null||s<u?-1*e:s>u?1*e:0}}function M(...n){return (e,t)=>{if(n.length===0)return 0;for(let r of n){let o=L(r)(e,t);if(o!==0)return o}return 0}}var a,f,T,c=class c{constructor(e){y(this,a,[]);y(this,f,0);y(this,T,null);p(this,a,[...e]);}static from(e){return new c(e)}select(...e){let t=[];for(let o of l(this,a)){let i={};for(let s of e)i[s]=o[s];t.push(i);}let r=new c(t);return this.cloneStateInto(r),r}map(e){let t=[];for(let o of l(this,a))t.push(e(o));let r=new c(t);return this.cloneStateInto(r),r}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(M(...e))),this}skip(e){return p(this,f,e),this}limit(e){return p(this,T,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 t=this.getFirstColumn();if(!t)return [];e=t;}return this.getLimitedRows().map(t=>t[e])}values(){let e=[];for(let t of this.getLimitedRows())e.push(Object.values(t));return e}groupBy(e,t){let r=this.getLimitedRows(),o=new Map,i=m(e);for(let s of r){let u=i?e(s):s[e],K=t?t(s):s;o.has(u)?o.get(u).push(K):o.set(u,[K]);}return o}min(e){let t=this.getLimitedRows();if(t.length===0)return null;let r=m(e)?t.map(o=>e(o)):t.map(o=>o[e]);return r.length===0?null:Math.min(...r)}max(e){let t=this.getLimitedRows();if(t.length===0)return null;let r=m(e)?t.map(o=>e(o)):t.map(o=>o[e]);return r.length===0?null:Math.max(...r)}sum(e){let t=this.getLimitedRows();return t.length===0?0:(m(e)?t.map(o=>e(o)):t.map(o=>o[e])).reduce((o,i)=>o+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 i=0;i<r.length;i++){let s=r[i];e(s)&&o.push(s);}else for(let i=0;i<r.length;i++){let s=r[i];g.validate(s,e,t)&&o.push(s);}p(this,a,o);}getFirstColumn(){let e=this.first();if(!e)return null;let t=B(e);return t.length>0?t[0]:null}getLimitedRows(){let e=[...l(this,a)];return e.slice(l(this,f),l(this,f)+(l(this,T)??e.length))}cloneStateInto(e){p(e,f,l(this,f)),p(e,T,l(this,T));}};a=new WeakMap,f=new WeakMap,T=new WeakMap,x([C,h(0,P),h(0,k(0))],c.prototype,"skip"),x([C,h(0,P),h(0,k(0))],c.prototype,"limit");var R=c;export{R as Query};
+var $=Object.defineProperty;var E=Object.getOwnPropertyDescriptor;var V=s=>{throw TypeError(s)};var O=(s,e,t,n)=>{for(var o=E(e,t),r=s.length-1,i;r>=0;r--)(i=s[r])&&(o=(i(e,t,o))||o);return o&&$(e,t,o),o},g=(s,e)=>(t,n)=>e(t,n,s);var F=(s,e,t)=>e.has(s)||V("Cannot "+t);var l=(s,e,t)=>(F(s,e,"read from private field"),e.get(s)),d=(s,e,t)=>e.has(s)?V("Cannot add the same private member more than once"):e instanceof WeakSet?e.add(s):e.set(s,t),f=(s,e,t,n)=>(F(s,e,"write to private field"),e.set(s,t),t);var v=s=>typeof s=="number";var b=class extends Error{constructor(e){super(e),this.name="InvalidArgumentError";}};var k=new WeakMap;function N(s,e){let t=k.get(s);t||(t=new Map,k.set(s,t));let n=t.get(e);return n||(n=[],t.set(e,n)),n}function P(s){return function(e,t,n){let o=N(e,t),r=o.find(i=>i.index===n);r?r.min=s:o.push({index:n,min:s});}}function C(s,e,t){let n=N(s,e),o=n.find(r=>r.index===t);o?o.integer=true:n.push({index:t,integer:true});}function j(s,e,t){let n=t.value;t.value=function(...o){let r=k.get(s)?.get(e)??[];for(let i of r){let u=o[i.index];if(i.min!==void 0&&(!v(u)||u<i.min))throw new b(`${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 b(`${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 b(`${String(u)} is not a valid argument to param ${i.index} on ${e}(). Expected value to be an integer.`)}return n.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),n=Object.keys(e);return t.length!==n.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,n)=>R(t,e[n]));function B(s){return Object.entries(s)}var m=s=>typeof s=="function";var x,w=class{static validate(e,t,n){for(let[o,r]of B(t))if(!this.validateColumnCondition(e,o,r,n??l(this,x)))return  false;return  true}static validateColumnCondition(e,t,n,o){if(o.ignoreNullValues&&n==null)return  true;let r=e[t];return m(n)?n(r):Array.isArray(n)?Array.isArray(r)?G(r,n):false:h(n)?h(r)?this.validate(r,n):false:r===n}};x=new WeakMap,d(w,x,{ignoreNullValues:false});function S(s){return Object.keys(s).filter(e=>typeof s[e]!="function")}function L(s){let e=1,t=s;t.startsWith("-")&&(e=-1,t=t.slice(1));let n=t;return (o,r)=>{let i=o[n],u=r[n];return i==null&&u==null?0:i==null?1*e:u==null||i<u?-1*e:i>u?1*e:0}}function M(...s){return (e,t)=>{if(s.length===0)return 0;for(let n of s){let o=L(n)(e,t);if(o!==0)return o}return 0}}var a,c,y,T=class T{constructor(e){d(this,a,[]);d(this,c,0);d(this,y,null);f(this,a,[...e]);}static from(e){return new T(e)}select(...e){let t=l(this,a),n=t.length,o=new Array(n);for(let i=0;i<n;i++){let u={};for(let p of e)u[p]=t[i][p];o[i]=u;}let r=new T(o);return this.cloneStateInto(r),r}map(e){let t=l(this,a),n=t.length,o=new Array(n);for(let i=0;i<n;i++)o[i]=e(t[i]);let r=new T(o);return this.cloneStateInto(r),r}distinct(e){let t=new Set,n=[],o=l(this,a),r=m(e);for(let i=0;i<o.length;i++){let u=o[i],p=r?e(u):u[e];t.has(p)||(t.add(p),n.push(u));}return f(this,a,n),this}where(e){return this.filterRows(e),this}filterWhere(e){return this.filterRows(e,{ignoreNullValues:true}),this}orderBy(...e){return f(this,a,l(this,a).sort(M(...e))),this}skip(e){return f(this,c,e),this}limit(e){return f(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){let t=this.getLimitedRows(),n=t.length;if(n===0)return [];if(e===void 0){let r=this.getFirstColumn();if(!r)return [];e=r;}let o=new Array(n);for(let r=0;r<n;r++)o[r]=t[r][e];return o}values(){let e=this.getLimitedRows(),t=e.length,n=new Array(t);for(let o=0;o<t;o++)n[o]=Object.values(e[o]);return n}groupBy(e,t){let n=this.getLimitedRows(),o=new Map,r=m(e);for(let i=0;i<n.length;i++){let u=n[i],p=r?e(u):u[e],A=t?t(u):u;o.has(p)?o.get(p).push(A):o.set(p,[A]);}return o}min(e){let t=this.getLimitedRows(),n=t.length;if(n===0)return null;let o=new Array(n);if(m(e))for(let r=0;r<n;r++)o[r]=e(t[r]);else for(let r=0;r<n;r++)o[r]=t[r][e];return Math.min(...o)}max(e){let t=this.getLimitedRows(),n=t.length;if(n===0)return null;let o=new Array(n);if(m(e))for(let r=0;r<n;r++)o[r]=e(t[r]);else for(let r=0;r<n;r++)o[r]=t[r][e];return Math.max(...o)}sum(e){let t=this.getLimitedRows(),n=t.length;if(n===0)return 0;let o=new Array(n);if(m(e))for(let r=0;r<n;r++)o[r]=e(t[r]);else for(let r=0;r<n;r++)o[r]=t[r][e];return o.reduce((r,i)=>r+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 n=l(this,a),o=[];if(m(e))for(let r=0;r<n.length;r++){let i=n[r];e(i)&&o.push(i);}else for(let r=0;r<n.length;r++){let i=n[r];w.validate(i,e,t)&&o.push(i);}f(this,a,o);}getFirstColumn(){let e=this.first();if(!e)return null;let t=S(e);return t.length>0?t[0]:null}getLimitedRows(){return l(this,a).slice(l(this,c),l(this,c)+(l(this,y)??l(this,a).length))}cloneStateInto(e){f(e,c,l(this,c)),f(e,y,l(this,y));}};a=new WeakMap,c=new WeakMap,y=new WeakMap,O([j,g(0,C),g(0,P(0))],T.prototype,"skip"),O([j,g(0,C),g(0,P(0))],T.prototype,"limit");var K=T;export{K as Query};

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "querier-ts",
   "type": "module",
-  "version": "2.4.0",
+  "version": "2.5.0",
   "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.0.3",
+    "eslint": "^10.1.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.5",
     "globals": "^17.4.0",
@@ -72,7 +72,8 @@
     "prettier-plugin-organize-imports": "^4.3.0",
     "tsup": "^8.5.1",
     "typescript": "~5.9.3",
-    "typescript-eslint": "^8.57.1",
+    "typescript-eslint": "^8.58.0",
     "vitest": "^4.1.2"
-  }
+  },
+  "packageManager": "pnpm@10.33.0"
 }