querier-ts 2.2.0 → 2.3.1

package/CHANGELOG.md

@@ -0,0 +1,136 @@
+# Changelog
+
+## v2.3.1
+
+- Optimize build process with [tsup](https://tsup.egoist.dev/), tree-shaking and minification.
+
+## 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

@@ -280,15 +280,38 @@ Example output:
 
 ---
 
-#### `groupBy(key)`
+#### `groupBy(key | callback, mapFn?)`
 
-Groups the items by the specified property and returns the result as a `Map`.
+Groups the items by a specified property or a custom callback and returns the result as a `Map`.
 
 - `key`: The property name to group by.
+- `callback`: A function that returns the value to group each item by.
+- `mapFn` *(optional)*: A function to transform each item before adding it to the grouped result.
 
-The returned `Map` uses the property values as keys and arrays of matching items as values.
+The returned `Map` uses the resolved grouping values as keys and arrays of matching (or mapped) items as values.
 
 ```ts
-const usersByActiveStatus = Query.from(users).groupBy('active');
+// Grouping by property
+const usersByActiveStatus = Query.from(users).groupBy('isActive');
 // Map<boolean, User[]>
+
+// Grouping by property with mapping
+const idsByActiveStatus = Query.from(users).groupBy(
+  'isActive',
+  (user) => user.id
+);
+// Map<boolean, number[]>
+
+// Grouping by callback
+const usersByActiveStatus = Query.from(users).groupBy(
+  (user) => user.isActive
+);
+// Map<boolean, User[]>
+
+// Grouping by callback with mapping
+const idsByNotificationPreference = Query.from(users).groupBy(
+  (user) => user.permissions.sendNotifications,
+  (user) => user.id
+);
+// Map<boolean, number[]>
 ```

package/dist/index.cjs

@@ -0,0 +1 @@
+'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/{lib/query.d.ts → dist/index.d.cts}

@@ -1,6 +1,32 @@
-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 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.
  *
@@ -47,7 +73,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.
@@ -132,7 +158,28 @@ export declare class Query<T extends object> {
      */
     orderBy(...columns: OrderingColumn<T>[]): this;
     /**
-     * Groups the results by a specific key or callback.
+     * 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.
      *
@@ -140,25 +187,36 @@ export declare class Query<T extends object> {
      */
     groupBy<K extends keyof T>(key: K): Map<T[K], T[]>;
     /**
-     * Groups the results by a specific key or callback.
+     * Groups the results by a specific key.
      *
-     * @param callback Callback to group by.
+     * @param key Key to group by.
+     * @param mapFn Callback to map each row to a new value.
      *
      * @returns Grouped results.
      */
-    groupBy<TGrouper>(callback: (row: T) => TGrouper): Map<TGrouper, T[]>;
+    groupBy<K extends keyof T, TReturn>(key: K, mapFn: (row: T) => TReturn): Map<T[K], TReturn[]>;
     /**
-     * Returns the current number of rows.
+     * Groups the results by a callback.
      *
-     * @return Filtered rows count.
+     * @param groupFn Callback to group by.
+     *
+     * @returns Grouped results.
      */
-    count(): number;
+    groupBy<TGrouper>(groupFn: (row: T) => TGrouper): Map<TGrouper, T[]>;
     /**
-     * Checks if there is at least one row compatible with the query.
+     * Groups the results by a callback.
      *
-     * @returns Whether any row exists after filtering.
+     * @param groupFn Callback to group by.
+     *
+     * @returns Grouped results.
      */
-    exists(): boolean;
+    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.
      *
@@ -171,12 +229,6 @@ export declare class Query<T extends object> {
      * @returns The last result.
      */
     last(): T | null;
-    /**
-     * Returns all results.
-     *
-     * @returns All filtered rows.
-     */
-    all(): T[];
     /**
      * Returns the value of the first (selected) column of the first row.
      *
@@ -200,26 +252,17 @@ export declare class Query<T extends object> {
      */
     values(): T[PropOf<T>][][];
     /**
-     * Defines the number of rows to skip.
-     *
-     * @param numberOfRows Numbers of rows to skip. Only non negative integer numbers
-     * are allowed.
-     *
-     * @returns Current query.
+     * Returns the current number of rows.
      *
-     * @throws {InvalidArgumentError} If the given number is less than 0.
+     * @return Filtered rows count.
      */
-    skip(numberOfRows: number): this;
+    count(): number;
     /**
-     * Defines a limit for the number of results.
-     *
-     * @param limit Limit of results. Only non negative integer numbers are allowed.
-     *
-     * @returns Current query.
+     * Checks if there is at least one row compatible with the query.
      *
-     * @throws {InvalidArgumentError} If the given limit is less than 0.
+     * @returns Whether any row exists after filtering.
      */
-    limit(limit: number): this;
+    exists(): boolean;
     /**
      * Filters the rows according to the given conditions.
      *
@@ -245,4 +288,5 @@ export declare class Query<T extends object> {
      */
     private cloneStateInto;
 }
-//# sourceMappingURL=query.d.ts.map
+
+export { Query };

package/dist/index.d.ts

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

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