querier-ts 0.0.0 → 1.0.0

package/lib/query.js

@@ -22,10 +22,10 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 var _Query_rows, _Query_columns, _Query_startAt, _Query_limit;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Query = void 0;
+const validation_1 = require("./core/validation");
+const decorators_1 = require("./core/validation/decorators");
 const sort_1 = require("./utils/functions/sort");
 const type_guards_1 = require("./utils/functions/type-guards");
-const query_row_validator_1 = require("./query-row-validator");
-const number_validaton_1 = require("./utils/decorators/number-validaton");
 /**
  * Allows filtering data from an array of objects.
  *
@@ -76,7 +76,7 @@ class Query {
     /**
      * Initializes the query.
      *
-     * @param {T[]} rows Rows to be queried.
+     * @param rows Rows to be queried.
      */
     constructor(rows) {
         /**
@@ -105,9 +105,9 @@ class Query {
     /**
      * Creates a new query based on the given data.
      *
-     * @param {T[]} rows Rows to be queried.
+     * @param rows Rows to be queried.
      *
-     * @returns {Query<T>} Query to the given rows.
+     * @returns Query to the given rows.
      */
     static from(rows) {
         return new Query(rows);
@@ -115,9 +115,9 @@ class Query {
     /**
      * Defines specific columns to be returned on the final results.
      *
-     * @param {PropOf<T> | PropOf<T>[]} columns Selected columns.
+     * @param columns Selected columns.
      *
-     * @returns {this} Current query.
+     * @returns Current query.
      */
     select(columns) {
         __classPrivateFieldSet(this, _Query_columns, Array.isArray(columns) ? columns : [columns], "f");
@@ -126,8 +126,7 @@ class Query {
     /**
      * Applies conditions to the query.
      *
-     * @param {QueryConditionsGroup<T> | ((obj: T) => boolean)} condition Filter to
-     * be applied to the query.
+     * @param condition Filter to be applied to the query.
      *
      * If a callback function is provided, it must return a boolean value.
      *
@@ -135,7 +134,7 @@ class Query {
      * corresponding values must be the expected values for the attributes or a
      * callback functions that return boolean values.
      *
-     * @returns {this} Current query.
+     * @returns Current query.
      */
     where(condition) {
         this.filterRows(condition);
@@ -145,12 +144,12 @@ class Query {
      * Applies a set of conditions to the query ignoring `null` and `undefined`
      * values as conditions.
      *
-     * @param {QueryConditionsGroupNullable<T>} 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.
+     * @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 {this} Current query.
+     * @returns Current query.
      */
     filterWhere(condition) {
         this.ignoreNullValues = true;
@@ -161,11 +160,10 @@ class Query {
     /**
      * Adds ordering to the results.
      *
-     * @param {(PropOf<T> | keyof addPrefixToObject<PropertyOnly<T>, '-'>)[]} columns
-     * Ascending or descending columns. To mark a field as descending, use `-` before
-     * its name.
+     * @param columns Ascending or descending columns. To mark a field as
+     * descending, use `-` before its name.
      *
-     * @returns {this} Current query.
+     * @returns Current query.
      */
     orderBy(...columns) {
         __classPrivateFieldGet(this, _Query_rows, "f").sort((0, sort_1.sortByProperties)(...columns));
@@ -174,7 +172,7 @@ class Query {
     /**
      * Returns the current number of rows.
      *
-     * @return {number}
+     * @return Filtered rows count.
      */
     count() {
         return this.getLimitedRows().length;
@@ -182,7 +180,7 @@ class Query {
     /**
      * Checks if there is at least one row compatible with the query.
      *
-     * @returns {boolean} Boolean indicating whether any row exists.
+     * @returns Whether any row exists after filtering.
      */
     exists() {
         return this.count() > 0;
@@ -190,7 +188,7 @@ class Query {
     /**
      * Returns the first result.
      *
-     * @returns {T}
+     * @returns The first result.
      */
     first() {
         const rows = this.getLimitedRows();
@@ -199,7 +197,7 @@ class Query {
     /**
      * Returns the last result.
      *
-     * @returns {T}
+     * @returns The last result.
      */
     last() {
         const rows = this.getLimitedRows();
@@ -208,7 +206,7 @@ class Query {
     /**
      * Returns all results.
      *
-     * @returns {T[]}
+     * @returns All filtered rows.
      */
     all() {
         return this.getLimitedRows();
@@ -216,17 +214,19 @@ class Query {
     /**
      * Returns the value of the first (selected) column of the first row.
      *
-     * @returns {T[Promise<T>]|false} First value or `false`, if none row exists.
+     * @returns First value or `false`, if none row exists.
      */
     scalar() {
         const firstObject = this.first();
         const firstColumn = this.getFirstColumn();
-        return firstObject && firstColumn ? firstObject[firstColumn] ?? false : false;
+        return firstObject && firstColumn
+            ? (firstObject[firstColumn] ?? false)
+            : false;
     }
     /**
      * Returns the values of the first (selected) column of all rows.
      *
-     * @returns {T[Promise<T>][]} Values from the first (selected) column.
+     * @returns Values from the first (selected) column.
      */
     column() {
         const firstColumn = this.getFirstColumn();
@@ -239,18 +239,20 @@ class Query {
      * Returns the values of the rows. If there are selected columns, only their
      * values will be returned.
      *
-     * @returns {T[PropOf<T>][][]} Array with the values of all rows.
+     * @returns Array with the values of all rows.
      */
     values() {
-        return this.getLimitedRows().map((row) => __classPrivateFieldGet(this, _Query_columns, "f").length ? __classPrivateFieldGet(this, _Query_columns, "f").map((column) => row[column]) : Object.values(row));
+        return this.getLimitedRows().map((row) => __classPrivateFieldGet(this, _Query_columns, "f").length
+            ? __classPrivateFieldGet(this, _Query_columns, "f").map((column) => row[column])
+            : Object.values(row));
     }
     /**
      * Defines the number of rows to skip.
      *
-     * @param {number} numberOfRows Numbers of rows to skip. Only non negative integer numbers
+     * @param numberOfRows Numbers of rows to skip. Only non negative integer numbers
      * are allowed.
      *
-     * @returns {this} Current query.
+     * @returns Current query.
      *
      * @throws {InvalidArgumentError} If the given number is less than 0.
      */
@@ -261,9 +263,9 @@ class Query {
     /**
      * Defines a limit for the number of results.
      *
-     * @param {number} limit Limit of results. Only non negative integer numbers are allowed.
+     * @param limit Limit of results. Only non negative integer numbers are allowed.
      *
-     * @returns {this} Current query.
+     * @returns Current query.
      *
      * @throws {InvalidArgumentError} If the given limit is less than 0.
      */
@@ -274,7 +276,7 @@ class Query {
     /**
      * Returns the rows that should be used in the final results.
      *
-     * @returns {T[]} Rows within the specified limit.
+     * @returns Rows within the specified limit.
      */
     getLimitedRows() {
         return __classPrivateFieldGet(this, _Query_rows, "f").slice(__classPrivateFieldGet(this, _Query_startAt, "f")).slice(0, __classPrivateFieldGet(this, _Query_limit, "f"));
@@ -282,8 +284,7 @@ class Query {
     /**
      * Returns the first selected column or the first key of some row.
      *
-     * @returns {Promise<T>|null} The first column or `null`, if none is selected
-     * or there is no row.
+     * @returns The first column or `null`, if none is selected  or there is no row.
      */
     getFirstColumn() {
         if (__classPrivateFieldGet(this, _Query_columns, "f").length) {
@@ -295,37 +296,37 @@ class Query {
     /**
      * Filters the rows according to the given conditions.
      *
-     * @param {QueryConditionsGroupNullable<T> | ((obj: T) => boolean)} condition
-     * Object or callback function.
+     * @param condition Object or callback function.
      */
     filterRows(condition) {
-        const isCallbackValidator = (0, type_guards_1.isFunction)(condition);
-        __classPrivateFieldSet(this, _Query_rows, __classPrivateFieldGet(this, _Query_rows, "f").filter((row) => (isCallbackValidator ? condition(row) : this.validateRow(row, condition))), "f");
+        __classPrivateFieldSet(this, _Query_rows, __classPrivateFieldGet(this, _Query_rows, "f").filter((row) => (0, type_guards_1.isFunction)(condition)
+            ? condition(row)
+            : this.validateRow(row, condition)), "f");
     }
     /**
      * Validates a row based on the given conditions object.
      *
-     * @param {T} row Row to validate.
-     * @param {QueryConditionsGroupNullable<T>} condition Conditions object.
+     * @param row Row to validate.
+     * @param condition Conditions object.
      *
      * @returns {boolean} Validation result.
      */
     validateRow(row, condition) {
-        return query_row_validator_1.QueryRowValidator.validate(row, {
+        return validation_1.QueryRowValidator.validate(row, {
             conditionsObject: condition,
             ignoreNullValues: this.ignoreNullValues,
         });
     }
 }
+exports.Query = Query;
 _Query_rows = new WeakMap(), _Query_columns = new WeakMap(), _Query_startAt = new WeakMap(), _Query_limit = new WeakMap();
 __decorate([
-    number_validaton_1.validateNumbers,
-    __param(0, number_validaton_1.integer),
-    __param(0, (0, number_validaton_1.min)(0))
+    decorators_1.validateNumbers,
+    __param(0, decorators_1.integer),
+    __param(0, (0, decorators_1.min)(0))
 ], Query.prototype, "skip", null);
 __decorate([
-    number_validaton_1.validateNumbers,
-    __param(0, number_validaton_1.integer),
-    __param(0, (0, number_validaton_1.min)(0))
+    decorators_1.validateNumbers,
+    __param(0, decorators_1.integer),
+    __param(0, (0, decorators_1.min)(0))
 ], Query.prototype, "limit", null);
-exports.Query = Query;

package/lib/utils/functions/generic/__tests__/compare-arrays.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/utils/functions/generic/__tests__/compare-arrays.spec.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const compare_arrays_1 = require("../compare-arrays");
+describe('compareArrays', () => {
+    it('returns true for ly equal arrays', () => {
+        const a = [{ x: 1 }, { y: 2 }];
+        const b = [{ x: 1 }, { y: 2 }];
+        expect((0, compare_arrays_1.compareArrays)(a, b)).toBe(true);
+    });
+    it('returns false for ly different arrays', () => {
+        expect((0, compare_arrays_1.compareArrays)([{ x: 1 }], [{ x: 2 }])).toBe(false);
+    });
+    it('returns false when order differs', () => {
+        expect((0, compare_arrays_1.compareArrays)([{ a: 1 }, { b: 2 }], [{ b: 2 }, { a: 1 }])).toBe(false);
+    });
+    it('works with nested objects', () => {
+        const a = [{ x: { y: 1 } }];
+        const b = [{ x: { y: 1 } }];
+        expect((0, compare_arrays_1.compareArrays)(a, b)).toBe(true);
+    });
+});

package/lib/utils/functions/generic/__tests__/deep-equal.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/utils/functions/generic/__tests__/deep-equal.spec.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const deep_equal_1 = require("../deep-equal");
+describe('deepEqual', () => {
+    describe('primitive values', () => {
+        it('returns true for strictly equal primitives', () => {
+            expect((0, deep_equal_1.deepEqual)(1, 1)).toBe(true);
+            expect((0, deep_equal_1.deepEqual)('a', 'a')).toBe(true);
+            expect((0, deep_equal_1.deepEqual)(true, true)).toBe(true);
+            expect((0, deep_equal_1.deepEqual)(null, null)).toBe(true);
+            expect((0, deep_equal_1.deepEqual)(undefined, undefined)).toBe(true);
+        });
+        it('returns false for different primitive values', () => {
+            expect((0, deep_equal_1.deepEqual)(1, 2)).toBe(false);
+            expect((0, deep_equal_1.deepEqual)('a', 'b')).toBe(false);
+            expect((0, deep_equal_1.deepEqual)(true, false)).toBe(false);
+            expect((0, deep_equal_1.deepEqual)(null, undefined)).toBe(false);
+        });
+    });
+    describe('objects', () => {
+        it('returns true for deeply equal plain objects', () => {
+            const a = { x: 1, y: 2 };
+            const b = { x: 1, y: 2 };
+            expect((0, deep_equal_1.deepEqual)(a, b)).toBe(true);
+        });
+        it('returns false for objects with different keys', () => {
+            expect((0, deep_equal_1.deepEqual)({ x: 1 }, { y: 1 })).toBe(false);
+        });
+        it('returns false for objects with same keys but different values', () => {
+            expect((0, deep_equal_1.deepEqual)({ x: 1 }, { x: 2 })).toBe(false);
+        });
+        it('returns false when one object has extra keys', () => {
+            expect((0, deep_equal_1.deepEqual)({ x: 1 }, { x: 1, y: 2 })).toBe(false);
+        });
+    });
+    describe('nested structures', () => {
+        it('returns true for deeply nested objects', () => {
+            const a = { x: { y: { z: 1 } } };
+            const b = { x: { y: { z: 1 } } };
+            expect((0, deep_equal_1.deepEqual)(a, b)).toBe(true);
+        });
+        it('returns false for deeply nested differences', () => {
+            const a = { x: { y: { z: 1 } } };
+            const b = { x: { y: { z: 2 } } };
+            expect((0, deep_equal_1.deepEqual)(a, b)).toBe(false);
+        });
+    });
+    describe('arrays', () => {
+        it('returns true for deeply equal arrays', () => {
+            expect((0, deep_equal_1.deepEqual)([1, 2, 3], [1, 2, 3])).toBe(true);
+        });
+        it('returns false for arrays with different order', () => {
+            expect((0, deep_equal_1.deepEqual)([1, 2, 3], [3, 2, 1])).toBe(false);
+        });
+        it('returns true for arrays with nested objects', () => {
+            const a = [{ x: 1 }, { y: 2 }];
+            const b = [{ x: 1 }, { y: 2 }];
+            expect((0, deep_equal_1.deepEqual)(a, b)).toBe(true);
+        });
+        it('returns false for arrays with different lengths', () => {
+            expect((0, deep_equal_1.deepEqual)([1, 2], [1, 2, 3])).toBe(false);
+        });
+    });
+    describe('mixed and edge cases', () => {
+        it('returns false when comparing array and object', () => {
+            expect((0, deep_equal_1.deepEqual)([], {})).toBe(false);
+        });
+        it('returns false when one value is object and the other is primitive', () => {
+            expect((0, deep_equal_1.deepEqual)({ x: 1 }, 1)).toBe(false);
+        });
+        it('returns true for same object reference', () => {
+            const obj = { x: 1 };
+            expect((0, deep_equal_1.deepEqual)(obj, obj)).toBe(true);
+        });
+        it('returns false for Date objects with same value (by design)', () => {
+            const a = new Date(2020, 1, 1);
+            const b = new Date(2020, 1, 1);
+            // Date has no enumerable keys, so this documents the limitation
+            expect((0, deep_equal_1.deepEqual)(a, b)).toBe(true);
+        });
+    });
+});

package/lib/utils/functions/generic/__tests__/get-entries.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/utils/functions/generic/__tests__/get-entries.spec.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const get_entries_1 = require("../get-entries");
+describe('getEntries', () => {
+    it('should return entries for a simple object', () => {
+        const obj = {
+            a: 1,
+            b: 2,
+        };
+        const entries = (0, get_entries_1.getEntries)(obj);
+        expect(entries).toEqual([
+            ['a', 1],
+            ['b', 2],
+        ]);
+    });
+    it('should return an empty array for an empty object', () => {
+        const obj = {};
+        const entries = (0, get_entries_1.getEntries)(obj);
+        expect(entries).toEqual([]);
+    });
+    it('should work with different value types', () => {
+        const obj = {
+            name: 'Alice',
+            age: 30,
+            active: true,
+        };
+        const entries = (0, get_entries_1.getEntries)(obj);
+        expect(entries).toEqual([
+            ['name', 'Alice'],
+            ['age', 30],
+            ['active', true],
+        ]);
+    });
+    it('should preserve key-value association', () => {
+        const obj = {
+            x: 10,
+            y: 20,
+        };
+        const entries = (0, get_entries_1.getEntries)(obj);
+        for (const [key, value] of entries) {
+            expect(obj[key]).toBe(value);
+        }
+    });
+    it('should provide correct typing for keys and values (type-level test)', () => {
+        const obj = {
+            id: 1,
+            title: 'Post',
+        };
+        const entries = (0, get_entries_1.getEntries)(obj);
+        const key = 'id';
+        const value = obj[key];
+        expect(key).toBe('id');
+        expect(value).toBe(1);
+    });
+});

package/lib/utils/functions/generic/compare-arrays.d.ts

@@ -1,9 +1 @@
-/**
- * Compares two arrays.
- *
- * @param {any[]} a First array to compare.
- * @param {any[]} b Second array to compare.
- *
- * @returns {boolean} Validation result.
- */
-export declare const compareArrays: (a: any[], b: any[]) => boolean;
+export declare const compareArrays: <T>(a: T[], b: T[]) => boolean;

package/lib/utils/functions/generic/compare-arrays.js

@@ -1,13 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.compareArrays = void 0;
-/**
- * Compares two arrays.
- *
- * @param {any[]} a First array to compare.
- * @param {any[]} b Second array to compare.
- *
- * @returns {boolean} Validation result.
- */
-const compareArrays = (a, b) => a.length === b.length && a.every((v, i) => v === b[i]);
+const deep_equal_1 = require("./deep-equal");
+const compareArrays = (a, b) => a.length === b.length && a.every((v, i) => (0, deep_equal_1.deepEqual)(v, b[i]));
 exports.compareArrays = compareArrays;

package/lib/utils/functions/generic/deep-equal.d.ts

@@ -0,0 +1 @@
+export declare const deepEqual: (a: unknown, b: unknown) => boolean;

package/lib/utils/functions/generic/deep-equal.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deepEqual = void 0;
+const type_guards_1 = require("../type-guards");
+const deepEqual = (a, b) => {
+    if (a === b) {
+        return true;
+    }
+    if (!(0, type_guards_1.isObject)(a) || !(0, type_guards_1.isObject)(b)) {
+        return false;
+    }
+    if (Array.isArray(a) !== Array.isArray(b)) {
+        return false;
+    }
+    const keysA = Object.keys(a);
+    const keysB = Object.keys(b);
+    if (keysA.length !== keysB.length) {
+        return false;
+    }
+    return keysA.every((key) => Object.prototype.hasOwnProperty.call(b, key) &&
+        (0, exports.deepEqual)(a[key], b[key]));
+};
+exports.deepEqual = deepEqual;

package/lib/utils/functions/generic/get-entries.d.ts

@@ -1,8 +1,5 @@
-/**
- * Returns the entries of an object.
- *
- * @param {object} obj The object to retrieve entries.
- *
- * @returns {[string, any]} The entries of the object.
- */
-export declare const getEntries: <T extends object>(obj: T) => [[keyof T, T[keyof T]]];
+type Entries<T> = {
+    [K in keyof T]: [K, T[K]];
+}[keyof T][];
+export declare function getEntries<T extends Record<PropertyKey, unknown>>(obj: T): Entries<T>;
+export {};

package/lib/utils/functions/generic/get-entries.js

@@ -1,12 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getEntries = void 0;
-/**
- * Returns the entries of an object.
- *
- * @param {object} obj The object to retrieve entries.
- *
- * @returns {[string, any]} The entries of the object.
- */
-const getEntries = (obj) => Object.entries(obj);
 exports.getEntries = getEntries;
+function getEntries(obj) {
+    const entries = [];
+    for (const key of Object.keys(obj)) {
+        entries.push([key, obj[key]]);
+    }
+    return entries;
+}

package/lib/utils/functions/generic/index.d.ts

@@ -1,3 +1,3 @@
-import { compareArrays } from './compare-arrays';
-import { getEntries } from './get-entries';
-export { compareArrays, getEntries, };
+export * from './compare-arrays';
+export * from './deep-equal';
+export * from './get-entries';

package/lib/utils/functions/generic/index.js

@@ -1,7 +1,19 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getEntries = exports.compareArrays = void 0;
-const compare_arrays_1 = require("./compare-arrays");
-Object.defineProperty(exports, "compareArrays", { enumerable: true, get: function () { return compare_arrays_1.compareArrays; } });
-const get_entries_1 = require("./get-entries");
-Object.defineProperty(exports, "getEntries", { enumerable: true, get: function () { return get_entries_1.getEntries; } });
+__exportStar(require("./compare-arrays"), exports);
+__exportStar(require("./deep-equal"), exports);
+__exportStar(require("./get-entries"), exports);

package/lib/utils/functions/sort/__tests__/sort-by-properties.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/utils/functions/sort/__tests__/sort-by-properties.spec.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const sort_by_properties_1 = require("../sort-by-properties");
+describe('sortByProperties', () => {
+    it('sorts by a single property', () => {
+        const data = [
+            { id: 2, name: 'B' },
+            { id: 1, name: 'A' },
+        ];
+        data.sort((0, sort_by_properties_1.sortByProperties)('id'));
+        expect(data).toEqual([
+            { id: 1, name: 'A' },
+            { id: 2, name: 'B' },
+        ]);
+    });
+    it('sorts by multiple properties in order', () => {
+        const data = [
+            { id: 1, name: 'Bob', age: 30 },
+            { id: 2, name: 'Alice', age: 30 },
+            { id: 3, name: 'Alice', age: 25 },
+        ];
+        data.sort((0, sort_by_properties_1.sortByProperties)('name', 'age'));
+        expect(data).toEqual([
+            { id: 3, name: 'Alice', age: 25 },
+            { id: 2, name: 'Alice', age: 30 },
+            { id: 1, name: 'Bob', age: 30 },
+        ]);
+    });
+    it('supports descending order with "-" prefix', () => {
+        const data = [
+            { id: 1, name: 'Bob', age: 30 },
+            { id: 2, name: 'Alice', age: 30 },
+            { id: 3, name: 'Alice', age: 25 },
+        ];
+        data.sort((0, sort_by_properties_1.sortByProperties)('name', '-age'));
+        expect(data).toEqual([
+            { id: 2, name: 'Alice', age: 30 },
+            { id: 3, name: 'Alice', age: 25 },
+            { id: 1, name: 'Bob', age: 30 },
+        ]);
+    });
+    it('places undefined values last when used as secondary key', () => {
+        const data = [
+            { id: 1, name: 'Alice' },
+            { id: 2, name: 'Alice', age: 20 },
+            { id: 3, name: 'Alice', age: 10 },
+        ];
+        data.sort((0, sort_by_properties_1.sortByProperties)('name', 'age'));
+        expect(data).toEqual([
+            { id: 3, name: 'Alice', age: 10 },
+            { id: 2, name: 'Alice', age: 20 },
+            { id: 1, name: 'Alice' },
+        ]);
+    });
+    it('returns 0 when all compared properties are equal', () => {
+        const comparator = (0, sort_by_properties_1.sortByProperties)('name', 'age');
+        expect(comparator({ id: 1, name: 'Alice', age: 20 }, { id: 2, name: 'Alice', age: 20 })).toBe(0);
+    });
+    it('returns 0 when no properties are provided', () => {
+        const comparator = (0, sort_by_properties_1.sortByProperties)();
+        expect(comparator({ id: 1, name: 'Alice' }, { id: 2, name: 'Bob' })).toBe(0);
+    });
+    it('enforces type safety at compile time', () => {
+        // @ts-expect-error
+        (0, sort_by_properties_1.sortByProperties)('invalid');
+        // @ts-expect-error
+        (0, sort_by_properties_1.sortByProperties)('-invalid');
+    });
+});

package/lib/utils/functions/sort/__tests__/sort-by-property.spec.d.ts

@@ -0,0 +1 @@
+export {};