querier-ts 2.3.1 → 2.4.1

package/CHANGELOG.md

@@ -1,8 +1,53 @@
 # Changelog
 
+## v2.4.1
+
+### Summary
+
+- [ ] Bug fixes
+- [x] Code refactoring
+- [ ] New features
+- [x] Compatibility fixes
+- [ ] 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 fixes
+
+- Updated development dependencies.
+
+## v2.4.0
+
+### Changes
+
+- [ ] Bug fixes
+- [ ] Code refactoring
+- [x] New features
+- [x] Build improvements
+- [ ] Breaking changes
+
+### New Features
+
+- Added `min()`, `max()`, `sum()`, and `average()` methods to `Query`.
+
+### Build Improvements
+- Improved build output by introducing separate ESM and CJS bundles.
+- ESM files are now emitted to `dist/esm` and CJS files to `dist/cjs`.
+- Updated package exports to provide better compatibility with modern bundlers and Node.js.
+- Reduced bundle size through improved minification and build configuration.
+- Refactored build pipeline using multiple `tsup` configurations.
+- Ensured type declarations are emitted only once to avoid duplication.
+
 ## v2.3.1
 
-- Optimize build process with [tsup](https://tsup.egoist.dev/), tree-shaking and minification.
+- Optimized build process with [tsup](https://tsup.egoist.dev/), tree-shaking and minification.
+- Removed `utility-types` from dependencies list.
 
 ## v2.3.0
 

package/README.md

@@ -315,3 +315,81 @@ const idsByNotificationPreference = Query.from(users).groupBy(
 );
 // Map<boolean, number[]>
 ```
+
+### Aggregating data
+
+#### `min(key | callback)`
+
+Returns the minimum numeric value from the results.
+
+- `key`: The numeric column to evaluate.
+- `callback`: A function that maps each row to a number.
+
+Returns `null` if no rows exist.
+
+```ts
+// Using a column
+const minAge = Query.from(users).min('age');
+
+// Using a callback
+const minNameLength = Query.from(users).min(
+  (user) => user.name.length
+);
+```
+
+#### `max(key | callback)`
+
+Returns the maximum numeric value from the results.
+
+- `key`: The numeric column to evaluate.
+- `callback`: A function that maps each row to a number.
+
+Returns `null` if no rows exist.
+
+```ts
+// Using a column
+const maxAge = Query.from(users).max('age');
+
+// Using a callback
+const maxNameLength = Query.from(users).max(
+  (user) => user.name.length
+);
+```
+
+#### `sum(key | callback)`
+
+Returns the sum of numeric values from the results.
+
+- `key`: The numeric column to evaluate.
+- `callback`: A function that maps each row to a number.
+
+Returns `0` if no rows exist.
+
+```ts
+// Using a column
+const totalAge = Query.from(users).sum('age');
+
+// Using a callback
+const totalNameLength = Query.from(users).sum(
+  (user) => user.name.length
+);
+```
+
+#### `average(key | callback)`
+
+Returns the average of numeric values from the results.
+
+- `key`: The numeric column to evaluate.
+- `callback`: A function that maps each row to a number.
+
+Returns `null` if no rows exist.
+
+```ts
+// Using a column
+const averageAge = Query.from(users).average('age');
+
+// Using a callback
+const averageNameLength = Query.from(users).average(
+  (user) => user.name.length
+);
+```

package/dist/cjs/index.cjs

@@ -0,0 +1 @@
+'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;

package/dist/{index.d.ts → esm/index.d.ts}

@@ -2,8 +2,10 @@ type addPrefixToObject<T, P extends string> = {
     [K in keyof T as K extends string ? `${P}${K}` : never]: T[K];
 };
 
+type IsFunction<T> = T extends (...args: any[]) => any ? true : false;
+
 type NonFunctionKeys<T extends object> = {
-    [K in keyof T]: T[K] extends (...args: any[]) => any ? never : K;
+    [K in keyof T]: IsFunction<T[K]> extends true ? never : K;
 }[keyof T];
 
 type PropertyOnly<T extends object> = {
@@ -27,51 +29,54 @@ type QueryConditionsGroupNullable<T extends object> = {
     [P in keyof PropertyOnly<T>]?: T[P] extends object ? QueryConditionsGroupNullable<T[P]> : NullableCondition<T[P]>;
 };
 
+type KeysOfType<T, TValue> = {
+    [K in keyof T]: T[K] extends TValue ? K : never;
+}[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;
@@ -178,6 +183,58 @@ declare class Query<T extends object> {
      * @throws {InvalidArgumentError} If the given limit is less than 0.
      */
     limit(limit: number): this;
+    /**
+     * Returns all results.
+     *
+     * @returns All filtered rows.
+     */
+    all(): T[];
+    /**
+     * Returns the first result.
+     *
+     * @returns The first result.
+     */
+    first(): T | null;
+    /**
+     * Returns the last result.
+     *
+     * @returns The last result.
+     */
+    last(): T | null;
+    /**
+     * Returns the current number of rows.
+     *
+     * @return Filtered rows count.
+     */
+    count(): number;
+    /**
+     * Checks if there is at least one row compatible with the query.
+     *
+     * @returns Whether any row exists after filtering.
+     */
+    exists(): boolean;
+    /**
+     * Returns the value of the first (selected) column of the first row.
+     *
+     * @returns First value or `false`, if none row exists.
+     */
+    scalar(): T[PropOf<T>] | false;
+    /**
+     * Returns the values of the first (selected) column of all rows.
+     *
+     * @param column (Optional) The column to get the values from.
+     *
+     * @returns Values from the first (selected) column.
+     */
+    column(): T[PropOf<T>][];
+    column<TColumn extends PropOf<T>>(column: TColumn): T[TColumn][];
+    /**
+     * 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(): T[PropOf<T>][][];
     /**
      * Groups the results by a specific key.
      *
@@ -212,57 +269,61 @@ declare class Query<T extends object> {
      */
     groupBy<TGrouper, TReturn>(groupFn: (row: T) => TGrouper, mapFn: (row: T) => TReturn): Map<TGrouper, TReturn[]>;
     /**
-     * Returns all results.
+     * Returns the minimum value of a column.
      *
-     * @returns All filtered rows.
+     * @param key Column to get the minimum value from.
+     * @returns Minimum value or `null`, if no rows exist.
      */
-    all(): T[];
+    min<K extends KeysOfType<T, number>>(key: K): number | null;
     /**
-     * Returns the first result.
+     * Returns the minimum value of the mapped rows by a callback.
      *
-     * @returns The first result.
+     * @param callback Callback to map the rows.
+     * @returns Minimum value or `null`, if no rows exist.
      */
-    first(): T | null;
+    min(callback: (row: T) => number): number | null;
     /**
-     * Returns the last result.
+     * Returns the maximum value of a column.
      *
-     * @returns The last result.
+     * @param key Column to get the maximum value from.
+     * @returns Maximum value or `null`, if no rows exist.
      */
-    last(): T | null;
+    max<K extends KeysOfType<T, number>>(key: K): number | null;
     /**
-     * Returns the value of the first (selected) column of the first row.
+     * Returns the maximum value of the mapped rows by a callback.
      *
-     * @returns First value or `false`, if none row exists.
+     * @param callback Callback to map the rows.
+     * @returns Maximum value or `null`, if no rows exist.
      */
-    scalar(): T[PropOf<T>] | false;
+    max(callback: (row: T) => number): number | null;
     /**
-     * Returns the values of the first (selected) column of all rows.
+     * Returns the sum of the values of a column.
      *
-     * @param column (Optional) The column to get the values from.
-     *
-     * @returns Values from the first (selected) column.
+     * @param key Column to get the sum from.
+     * @returns Sum.
      */
-    column(): T[PropOf<T>][];
-    column<TColumn extends PropOf<T>>(column: TColumn): T[TColumn][];
+    sum<K extends KeysOfType<T, number>>(key: K): number;
     /**
-     * Returns the values of the rows. If there are selected columns, only their
-     * values will be returned.
+     * Returns the sum of the mapped rows by a callback.
      *
-     * @returns Array with the values of all rows.
+     * @param callback Callback to map the rows.
+     * @returns Sum.
      */
-    values(): T[PropOf<T>][][];
+    sum(callback: (row: T) => number): number;
     /**
-     * Returns the current number of rows.
+     * Returns the average of the values of a column.
      *
-     * @return Filtered rows count.
+     * @param key Column to get the average from.
+     * @returns Average or `null`, if no rows exist.
      */
-    count(): number;
+    average<K extends KeysOfType<T, number>>(key: K): number | null;
     /**
-     * Checks if there is at least one row compatible with the query.
+     * Returns the average of the mapped rows by a callback.
      *
-     * @returns Whether any row exists after filtering.
+     * @param callback Callback to map the rows.
+     * @returns Average or `null`, if no rows exist.
      */
-    exists(): boolean;
+    average(callback: (row: T) => number): number | null;
     /**
      * Filters the rows according to the given conditions.
      *

package/dist/esm/index.js

@@ -0,0 +1 @@
+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};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "querier-ts",
   "type": "module",
-  "version": "2.3.1",
+  "version": "2.4.1",
   "description": "A lightweight, type-safe in-memory query engine for JavaScript and TypeScript",
   "repository": {
     "type": "git",
@@ -28,13 +28,14 @@
     "LICENSE",
     "CHANGELOG.md"
   ],
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/esm/index.d.ts",
   "exports": {
     ".": {
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
+      "types": "./dist/esm/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js"
     }
   },
   "sideEffects": false,
@@ -60,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",
@@ -71,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"
 }

package/dist/index.cjs

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

package/dist/index.d.cts

@@ -1,292 +0,0 @@
-type addPrefixToObject<T, P extends string> = {
-    [K in keyof T as K extends string ? `${P}${K}` : never]: T[K];
-};
-
-type NonFunctionKeys<T extends object> = {
-    [K in keyof T]: T[K] extends (...args: any[]) => any ? never : K;
-}[keyof T];
-
-type PropertyOnly<T extends object> = {
-    [P in NonFunctionKeys<T>]: T[P];
-};
-
-/**
- * Represents a property of a class or interface.
- */
-type PropOf<T extends object> = keyof PropertyOnly<T>;
-
-type OrderingColumn<T extends object> = PropOf<T> | keyof addPrefixToObject<PropertyOnly<T>, '-'>;
-
-type QueryConditionsGroup<T extends object> = {
-    [P in keyof PropertyOnly<T>]?: T[P] extends object ? QueryConditionsGroup<T[P]> : T[P] | ((value: T[P]) => boolean);
-};
-
-type NullableCondition<T> = T | ((value: T) => boolean) | null | undefined;
-
-type QueryConditionsGroupNullable<T extends object> = {
-    [P in keyof PropertyOnly<T>]?: T[P] extends object ? QueryConditionsGroupNullable<T[P]> : NullableCondition<T[P]>;
-};
-
-/**
- * Allows filtering data from an array of objects.
- *
- * @example
- * ```ts
- * interface User {
- *   id: string;
- *   email: string;
- *   isActive: boolean;
- *   createdAt: string;
- *   updatedAt: string;
- * }
- *
- * const users: User[] = [];
- *
- * // Filtering objects
- *
- * const activeGmailUsers = 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')
- *   .orderBy('-createdAt')
- *   .scalar();
- *
- * // Checking information
- *
- * const userExists = Query.from(users)
- *   .where({
- *     id: 'some-id',
- *   })
- *   .exists();
- *
- * const numberOfUsers = Query.from(users).count();
- * ```
- */
-declare class Query<T extends object> {
-    #private;
-    /**
-     * Initializes the query.
-     *
-     * @param rows Rows to be queried.
-     */
-    private constructor();
-    /**
-     * Creates a new query based on the given data.
-     *
-     * @param rows Rows to be queried.
-     *
-     * @returns Query to the given rows.
-     */
-    static from<T extends object>(rows: T[]): Query<T>;
-    /**
-     * Defines specific columns to be returned on the final results.
-     *
-     * @param columns Selected columns.
-     *
-     * @returns Current query.
-     */
-    select<TColumns extends PropOf<T>[]>(...columns: TColumns): Query<{
-        [P in TColumns[number]]: T[P];
-    }>;
-    /**
-     * 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<TReturn extends object>(callback: (obj: T) => TReturn): Query<TReturn>;
-    /**
-     * 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: QueryConditionsGroup<T> | ((obj: T) => boolean)): 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: QueryConditionsGroupNullable<T>): 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: OrderingColumn<T>[]): this;
-    /**
-     * Defines the number of rows to skip.
-     *
-     * @param numberOfRows Numbers of rows to skip. Only non negative integer numbers
-     * are allowed.
-     *
-     * @returns Current query.
-     *
-     * @throws {InvalidArgumentError} If the given number is less than 0.
-     */
-    skip(numberOfRows: number): this;
-    /**
-     * Defines a limit for the number of results.
-     *
-     * @param limit Limit of results. Only non negative integer numbers are allowed.
-     *
-     * @returns Current query.
-     *
-     * @throws {InvalidArgumentError} If the given limit is less than 0.
-     */
-    limit(limit: number): this;
-    /**
-     * Groups the results by a specific key.
-     *
-     * @param key Key to group by.
-     *
-     * @returns Grouped results.
-     */
-    groupBy<K extends keyof T>(key: K): Map<T[K], T[]>;
-    /**
-     * Groups the results by a specific key.
-     *
-     * @param key Key to group by.
-     * @param mapFn Callback to map each row to a new value.
-     *
-     * @returns Grouped results.
-     */
-    groupBy<K extends keyof T, TReturn>(key: K, mapFn: (row: T) => TReturn): Map<T[K], TReturn[]>;
-    /**
-     * Groups the results by a callback.
-     *
-     * @param groupFn Callback to group by.
-     *
-     * @returns Grouped results.
-     */
-    groupBy<TGrouper>(groupFn: (row: T) => TGrouper): Map<TGrouper, T[]>;
-    /**
-     * Groups the results by a callback.
-     *
-     * @param groupFn Callback to group by.
-     *
-     * @returns Grouped results.
-     */
-    groupBy<TGrouper, TReturn>(groupFn: (row: T) => TGrouper, mapFn: (row: T) => TReturn): Map<TGrouper, TReturn[]>;
-    /**
-     * Returns all results.
-     *
-     * @returns All filtered rows.
-     */
-    all(): T[];
-    /**
-     * Returns the first result.
-     *
-     * @returns The first result.
-     */
-    first(): T | null;
-    /**
-     * Returns the last result.
-     *
-     * @returns The last result.
-     */
-    last(): T | null;
-    /**
-     * Returns the value of the first (selected) column of the first row.
-     *
-     * @returns First value or `false`, if none row exists.
-     */
-    scalar(): T[PropOf<T>] | false;
-    /**
-     * Returns the values of the first (selected) column of all rows.
-     *
-     * @param column (Optional) The column to get the values from.
-     *
-     * @returns Values from the first (selected) column.
-     */
-    column(): T[PropOf<T>][];
-    column<TColumn extends PropOf<T>>(column: TColumn): T[TColumn][];
-    /**
-     * 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(): T[PropOf<T>][][];
-    /**
-     * Returns the current number of rows.
-     *
-     * @return Filtered rows count.
-     */
-    count(): number;
-    /**
-     * Checks if there is at least one row compatible with the query.
-     *
-     * @returns Whether any row exists after filtering.
-     */
-    exists(): boolean;
-    /**
-     * Filters the rows according to the given conditions.
-     *
-     * @param condition Object or callback function.
-     */
-    private filterRows;
-    /**
-     * 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.
-     */
-    private getFirstColumn;
-    /**
-     * Returns the rows that should be used in the final results.
-     *
-     * @returns Rows within the specified limit.
-     */
-    private getLimitedRows;
-    /**
-     * Copies the state of the current query into the given query.
-     *
-     * @param query Query to copy the state into.
-     */
-    private cloneStateInto;
-}
-
-export { Query };

package/dist/index.js

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