querier-ts 2.3.0 → 2.4.0

package/CHANGELOG.md

@@ -0,0 +1,159 @@
+# Changelog
+
+## 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
+
+- Optimized build process with [tsup](https://tsup.egoist.dev/), tree-shaking and minification.
+- Removed `utility-types` from dependencies list.
+
+## v2.3.0
+
+### Features
+
+- Added optional `mapFn` to `groupBy()` method to transform grouped values.
+
+## v2.2.0
+
+### Features
+
+- Added an overload to `groupBy()` supporting both property keys and custom grouping functions.
+
+### Improvements
+
+- Internal code refactoring with no functional changes.
+- Updated the build process to ignore test files.
+- Updated `.npmignore` file contents.
+
+## v2.1.1
+
+- Rebuild v2.1.0, for `lib` was outdated.
+
+## v2.1.0
+
+- Added method `map()` to `Query`, intended for data projection, but more flexible and better suited for complex transformations.
+
+## v2.0.2
+
+This release includes minor internal refactoring. There are no new features or breaking changes.
+
+## Improvementskv
+
+- Performed micro-optimizations on array operations.
+
+## v2.0.1
+
+This release includes minor internal refactoring. There are no new features or breaking changes.
+
+## Improvements
+
+- Avoid repeated instantiation of `QueryRowValidator` during row validation by leveraging static members.
+- Replace `Array.prototype.every()` with a `for...of` loop for improved performance.
+
+## v2.0.0
+
+### Changes
+
+* Updated the `select()` method to return a new `Query` instance containing only the selected columns.
+* Added a new `groupBy()` method, which returns a `Map` with results grouped by the specified column.
+* Added an optional `column` parameter to the `column()` method, allowing you to specify which column's values should be returned.
+* Updated the `orderBy()` method to sort query results immediately, restoring the behavior from previous versions.
+
+### Other Improvements
+
+* Replaced Jest with Vitest, improving test performance.
+* Added test coverage reporting.
+* Expanded the test suite to cover more execution paths.
+
+## v1.0.2
+
+Impacts:
+
+### Production
+
+- Code refactory: replaced legacy code with modern alternatives without modifying behavior.
+- Removed `reflect-metadata` from dependencies list.
+
+### Development
+
+- Replaced `tslint` by `eslint`.
+- Updated `tsconfig.json` with stricter options.
+
+## v1.0.1
+
+### Ensure rows immutability in `orderBy()`
+
+`orderBy()` behavior was updated to register the ordering option and apply it only to the results instead of sorting the actual rows immediately.
+
+Before:
+
+```ts
+const results = Query.from(users)
+  .orderBy('-name') // rows would be sorted immediately
+  // ...
+```
+
+One problem with the former approach is that it was not possible to override the sorting by calling `orderBy` a second time; instead, the rows would only be sorted again.
+
+Now:
+
+```ts
+const results = Query.from(users)
+  .orderBy('-name')
+  .orderBy('name') // the overriden orderBy option is the only one applied,
+                   // affecting only the final results
+  // ...
+```
+
+The new approach ensures that the inner rows always remain the same, maintaining their original order.
+
+It is also possible to clear the ordering now:
+
+```ts
+const results = Query.from(users)
+  .orderBy('name')
+  .orderBy() // no sorting logic will be applied to the rows
+```
+
+### Fix Jest configuration
+
+Update match to include `__tests__/*.spec.ts` files only. The previous configuration enabled testing JS and TS type files too, causing errors.
+
+### Other improvements
+
+- Create a `.prettierignore` file.
+- Update `.npmignore` file contents.
+
+## v1.0.0
+
+Updates:
+
+- Dependencies updated.
+- Code refactored keeping previous behavior.
+- Unit tests created or reviewed to cover the whole codebase.
+- Migrated from npm to pnpm.
+- Prettier configuration updated and integrated with Visual Studio Code.
+
+## v0.0.0
+
+Create initial project.

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 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;

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

@@ -1,6 +1,38 @@
-import type { QueryConditionsGroup, QueryConditionsGroupNullable } from './core/types';
-import type { OrderingColumn } from './core/types/ordering-column';
-import type { PropOf } from './utils/types';
+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]: IsFunction<T[K]> extends true ? 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]>;
+};
+
+type KeysOfType<T, TValue> = {
+    [K in keyof T]: T[K] extends TValue ? K : never;
+}[keyof T];
+
 /**
  * Allows filtering data from an array of objects.
  *
@@ -47,7 +79,7 @@ import type { PropOf } from './utils/types';
  * const numberOfUsers = Query.from(users).count();
  * ```
  */
-export declare class Query<T extends object> {
+declare class Query<T extends object> {
     #private;
     /**
      * Initializes the query.
@@ -152,6 +184,58 @@ export 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.
      *
@@ -186,57 +270,61 @@ export 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.
      *
@@ -262,4 +350,5 @@ export declare class Query<T extends object> {
      */
     private cloneStateInto;
 }
-//# sourceMappingURL=query.d.ts.map
+
+export { Query };

package/dist/esm/index.js

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

package/package.json

@@ -1,16 +1,48 @@
 {
   "name": "querier-ts",
-  "version": "2.3.0",
-  "description": "Query tool for analysing arrays of objects",
-  "main": "lib/index.js",
-  "types": "lib/index.d.ts",
+  "type": "module",
+  "version": "2.4.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"
+  },
+  "keywords": [
+    "query",
+    "data filtering",
+    "in-memory"
+  ],
+  "author": {
+    "name": "Luiz Filipe da Silva",
+    "email": "luizfilipezs@proton.me",
+    "url": "https://github.com/luizfilipezs"
+  },
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/luizfilipezs/query-ts/issues"
+  },
+  "homepage": "https://github.com/luizfilipezs/query-ts#readme",
   "files": [
-    "lib/**/*"
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
   ],
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/esm/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/esm/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js"
+    }
+  },
+  "sideEffects": false,
   "scripts": {
     "test": "vitest",
     "test:cov": "vitest --coverage",
-    "build": "tsc --project tsconfig.build.json",
+    "build": "tsup",
     "type-check": "tsc --noEmit",
     "format": "prettier --write \"src/**/*.ts\"",
     "lint": "eslint \"src/**/*.ts\" --fix",
@@ -26,27 +58,6 @@
       "eslint --fix"
     ]
   },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/luizfilipezs/query-ts.git"
-  },
-  "keywords": [
-    "query",
-    "data filtering"
-  ],
-  "author": {
-    "name": "Luiz Filipe da Silva",
-    "email": "filipeluiz.bs@gmail.com",
-    "url": "https://blogdolipe.com.br"
-  },
-  "license": "MIT",
-  "bugs": {
-    "url": "https://github.com/luizfilipezs/query-ts/issues"
-  },
-  "homepage": "https://github.com/luizfilipezs/query-ts#readme",
-  "dependencies": {
-    "utility-types": "^3.11.0"
-  },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
     "@vitest/coverage-v8": "^4.1.2",
@@ -59,6 +70,7 @@
     "lint-staged": "^16.4.0",
     "prettier": "^3.8.1",
     "prettier-plugin-organize-imports": "^4.3.0",
+    "tsup": "^8.5.1",
     "typescript": "~5.9.3",
     "typescript-eslint": "^8.57.1",
     "vitest": "^4.1.2"

package/lib/core/errors/index.d.ts

@@ -1,2 +0,0 @@
-export * from './invalid-argument-error';
-//# sourceMappingURL=index.d.ts.map

package/lib/core/errors/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC"}

package/lib/core/errors/index.js

@@ -1,2 +0,0 @@
-export * from './invalid-argument-error';
-//# sourceMappingURL=index.js.map

package/lib/core/errors/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC"}

package/lib/core/errors/invalid-argument-error.d.ts

@@ -1,4 +0,0 @@
-export declare class InvalidArgumentError extends Error {
-    constructor(message: string);
-}
-//# sourceMappingURL=invalid-argument-error.d.ts.map

package/lib/core/errors/invalid-argument-error.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"invalid-argument-error.d.ts","sourceRoot":"","sources":["../../../src/core/errors/invalid-argument-error.ts"],"names":[],"mappings":"AAAA,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,OAAO,EAAE,MAAM;CAI5B"}

package/lib/core/errors/invalid-argument-error.js

@@ -1,7 +0,0 @@
-export class InvalidArgumentError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'InvalidArgumentError';
-    }
-}
-//# sourceMappingURL=invalid-argument-error.js.map

package/lib/core/errors/invalid-argument-error.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"invalid-argument-error.js","sourceRoot":"","sources":["../../../src/core/errors/invalid-argument-error.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF"}

package/lib/core/types/attribute-validation-function.d.ts

@@ -1,2 +0,0 @@
-export type AttributeValidationFunction<T extends object, P extends keyof T = keyof T> = (value: T[P]) => boolean;
-//# sourceMappingURL=attribute-validation-function.d.ts.map

package/lib/core/types/attribute-validation-function.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"attribute-validation-function.d.ts","sourceRoot":"","sources":["../../../src/core/types/attribute-validation-function.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,2BAA2B,CACrC,CAAC,SAAS,MAAM,EAChB,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,CAAC,IACzB,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC"}

package/lib/core/types/attribute-validation-function.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=attribute-validation-function.js.map

package/lib/core/types/attribute-validation-function.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"attribute-validation-function.js","sourceRoot":"","sources":["../../../src/core/types/attribute-validation-function.ts"],"names":[],"mappings":""}

package/lib/core/types/column-condition.d.ts

@@ -1,7 +0,0 @@
-import type { AttributeValidationFunction } from './attribute-validation-function';
-import type { QueryConditionsGroupNullable } from './query-conditions-group-nullable';
-/**
- * Condition to apply to a row column.
- */
-export type ColumnCondition<T extends object, P extends keyof T> = T[P] extends object ? QueryConditionsGroupNullable<T[P]> | undefined : T[P] | AttributeValidationFunction<T, P> | null | undefined;
-//# sourceMappingURL=column-condition.d.ts.map

package/lib/core/types/column-condition.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"column-condition.d.ts","sourceRoot":"","sources":["../../../src/core/types/column-condition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AACnF,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AAEtF;;GAEG;AACH,MAAM,MAAM,eAAe,CACzB,CAAC,SAAS,MAAM,EAChB,CAAC,SAAS,MAAM,CAAC,IACf,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GACnB,4BAA4B,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,GAC9C,CAAC,CAAC,CAAC,CAAC,GAAG,2BAA2B,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC"}

package/lib/core/types/column-condition.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=column-condition.js.map

package/lib/core/types/column-condition.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"column-condition.js","sourceRoot":"","sources":["../../../src/core/types/column-condition.ts"],"names":[],"mappings":""}

package/lib/core/types/index.d.ts

@@ -1,5 +0,0 @@
-export * from './attribute-validation-function';
-export * from './query-conditions-group';
-export * from './query-conditions-group-nullable';
-export * from './query-row-validator-initializer';
-//# sourceMappingURL=index.d.ts.map

package/lib/core/types/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAC;AAChD,cAAc,0BAA0B,CAAC;AACzC,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC"}

package/lib/core/types/index.js

@@ -1,5 +0,0 @@
-export * from './attribute-validation-function';
-export * from './query-conditions-group';
-export * from './query-conditions-group-nullable';
-export * from './query-row-validator-initializer';
-//# sourceMappingURL=index.js.map

package/lib/core/types/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAC;AAChD,cAAc,0BAA0B,CAAC;AACzC,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC"}

package/lib/core/types/nullable-condition.d.ts

@@ -1,2 +0,0 @@
-export type NullableCondition<T> = T | ((value: T) => boolean) | null | undefined;
-//# sourceMappingURL=nullable-condition.d.ts.map