querier-ts 2.3.1 → 2.4.0

package/CHANGELOG.md

@@ -1,8 +1,31 @@
 # 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
 
-- 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 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/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,6 +29,10 @@ 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.
  *
@@ -178,6 +184,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 +270,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 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,7 +1,7 @@
 {
   "name": "querier-ts",
   "type": "module",
-  "version": "2.3.1",
+  "version": "2.4.0",
   "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,

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