filter-kit 2.0.0

package/dist/cjs/filters/buildSearch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildSearch.js","sourceRoot":"","sources":["../../../src/filters/buildSearch.ts"],"names":[],"mappings":"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"}

package/dist/cjs/filters/buildSort.d.ts

@@ -0,0 +1,2 @@
+export declare function buildSort(querySort: string | undefined, queryOrder: string | undefined, defaultSort: string, defaultOrder: 'asc' | 'desc'): Record<string, 1 | -1>;
+//# sourceMappingURL=buildSort.d.ts.map

package/dist/cjs/filters/buildSort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildSort.d.ts","sourceRoot":"","sources":["../../../src/filters/buildSort.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CACvB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,KAAK,GAAG,MAAM,GAC3B,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAgBxB"}

package/dist/cjs/filters/buildSort.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSort = buildSort;
+function buildSort(querySort, queryOrder, defaultSort, defaultOrder) {
+    var _a;
+    const sortFields = ((querySort && querySort.trim()) || defaultSort)
+        .split(',')
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0);
+    const orderParts = (queryOrder !== null && queryOrder !== void 0 ? queryOrder : '').split(',').map((o) => o.trim());
+    const result = {};
+    for (let i = 0; i < sortFields.length; i++) {
+        const rawOrder = (_a = orderParts[i]) !== null && _a !== void 0 ? _a : '';
+        const dir = rawOrder === 'asc' || rawOrder === 'desc' ? rawOrder : i === 0 ? defaultOrder : 'asc';
+        result[sortFields[i]] = dir === 'asc' ? 1 : -1;
+    }
+    return result;
+}
+//# sourceMappingURL=buildSort.js.map

package/dist/cjs/filters/buildSort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildSort.js","sourceRoot":"","sources":["../../../src/filters/buildSort.ts"],"names":[],"mappings":";;AAAA,8BAqBC;AArBD,SAAgB,SAAS,CACvB,SAA6B,EAC7B,UAA8B,EAC9B,WAAmB,EACnB,YAA4B;;IAE5B,MAAM,UAAU,GAAG,CAAC,CAAC,SAAS,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC,IAAI,WAAW,CAAC;SAChE,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAE/B,MAAM,UAAU,GAAG,CAAC,UAAU,aAAV,UAAU,cAAV,UAAU,GAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAEtE,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,MAAM,QAAQ,GAAG,MAAA,UAAU,CAAC,CAAC,CAAC,mCAAI,EAAE,CAAC;QACrC,MAAM,GAAG,GACP,QAAQ,KAAK,KAAK,IAAI,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC;QACxF,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/cjs/index.d.ts

@@ -0,0 +1,3 @@
+export { queryBuilder } from './queryBuilder';
+export type { QueryBuilderOptions, PaginationMeta, QueryBuilderResult, SearchField, SearchFieldConfig, SearchFieldType, DateFieldConfig, SoftDeleteConfig, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EACV,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,gBAAgB,GACjB,MAAM,SAAS,CAAC"}

package/dist/cjs/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.queryBuilder = void 0;
+var queryBuilder_1 = require("./queryBuilder");
+Object.defineProperty(exports, "queryBuilder", { enumerable: true, get: function () { return queryBuilder_1.queryBuilder; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,+CAA8C;AAArC,4GAAA,YAAY,OAAA"}

package/dist/cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist/cjs/queryBuilder.d.ts

@@ -0,0 +1,3 @@
+import { QueryBuilderOptions, QueryBuilderResult } from './types';
+export declare function queryBuilder<T = any>(options: QueryBuilderOptions<T>): Promise<QueryBuilderResult<T>>;
+//# sourceMappingURL=queryBuilder.d.ts.map

package/dist/cjs/queryBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryBuilder.d.ts","sourceRoot":"","sources":["../../src/queryBuilder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAkB,MAAM,SAAS,CAAC;AAQlF,wBAAsB,YAAY,CAAC,CAAC,GAAG,GAAG,EACxC,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC9B,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAwHhC"}

package/dist/cjs/queryBuilder.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.queryBuilder = queryBuilder;
+const buildSearch_1 = require("./filters/buildSearch");
+const buildPagination_1 = require("./filters/buildPagination");
+const buildSort_1 = require("./filters/buildSort");
+const buildDateFilter_1 = require("./filters/buildDateFilter");
+const buildPopulate_1 = require("./filters/buildPopulate");
+const buildDynamicFilters_1 = require("./filters/buildDynamicFilters");
+async function queryBuilder(options) {
+    var _a, _b;
+    const { model, query, searchFields, searchMode = 'or', allowedFilters, defaultSort = 'createdAt', defaultOrder = 'desc', defaultLimit = 10, maxLimit = 100, populate: optionPopulate, select: optionSelect, dateField, dateFields, lean = false, customFilter, softDelete, withCount = true, } = options;
+    const filterParts = [];
+    const searchFilter = (0, buildSearch_1.buildSearch)(query['search'], searchFields, searchMode);
+    if (Object.keys(searchFilter).length > 0)
+        filterParts.push(searchFilter);
+    // Single dateField (backward compat)
+    if (dateField) {
+        const dateFilter = (0, buildDateFilter_1.buildDateFilter)(query['from'], query['to'], dateField);
+        if (Object.keys(dateFilter).length > 0)
+            filterParts.push(dateFilter);
+    }
+    // Multiple dateFields
+    for (const cfg of dateFields !== null && dateFields !== void 0 ? dateFields : []) {
+        const dateFilter = (0, buildDateFilter_1.buildDateFilter)(query[(_a = cfg.fromParam) !== null && _a !== void 0 ? _a : 'from'], query[(_b = cfg.toParam) !== null && _b !== void 0 ? _b : 'to'], cfg.field);
+        if (Object.keys(dateFilter).length > 0)
+            filterParts.push(dateFilter);
+    }
+    const dynamicFilter = (0, buildDynamicFilters_1.buildDynamicFilters)(query, allowedFilters, model);
+    if (Object.keys(dynamicFilter).length > 0)
+        filterParts.push(dynamicFilter);
+    if (customFilter && Object.keys(customFilter).length > 0) {
+        filterParts.push(customFilter);
+    }
+    if (softDelete) {
+        const excludeVal = softDelete.value !== undefined ? softDelete.value : true;
+        filterParts.push({ [softDelete.field]: { $ne: excludeVal } });
+    }
+    const filter = filterParts.length > 1
+        ? { $and: filterParts }
+        : filterParts.length === 1
+            ? filterParts[0]
+            : {};
+    const { page, limit, skip } = (0, buildPagination_1.buildPagination)(query['page'], query['limit'], defaultLimit, maxLimit);
+    const sort = (0, buildSort_1.buildSort)(query['sort'], query['order'], defaultSort, defaultOrder);
+    const populateFields = (0, buildPopulate_1.buildPopulate)(query['populate'], optionPopulate);
+    const selectParam = query['select'];
+    const selectValue = selectParam && selectParam.trim() !== ''
+        ? selectParam.replace(/,/g, ' ')
+        : optionSelect;
+    let findQuery = model.find(filter).sort(sort).skip(skip).limit(limit);
+    for (const pop of populateFields) {
+        findQuery = findQuery.populate(pop);
+    }
+    if (selectValue !== undefined && selectValue !== null) {
+        findQuery = findQuery.select(selectValue);
+    }
+    if (lean) {
+        findQuery = findQuery.lean();
+    }
+    const [data, total] = withCount
+        ? await Promise.all([findQuery.exec(), model.countDocuments(filter)])
+        : [await findQuery.exec(), 0];
+    const pages = withCount ? Math.ceil(total / limit) : 0;
+    const pagination = {
+        total,
+        page,
+        limit,
+        pages,
+        hasNext: withCount ? page < pages : false,
+        hasPrev: page > 1,
+    };
+    return { data, pagination };
+}
+//# sourceMappingURL=queryBuilder.js.map

package/dist/cjs/queryBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryBuilder.js","sourceRoot":"","sources":["../../src/queryBuilder.ts"],"names":[],"mappings":"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"}

package/dist/cjs/types.d.ts

@@ -0,0 +1,48 @@
+import { Model, PopulateOptions, ProjectionType } from 'mongoose';
+export type SearchFieldType = 'string' | 'number' | 'exact';
+export interface SearchFieldConfig {
+    field: string;
+    type?: SearchFieldType;
+}
+export type SearchField = string | SearchFieldConfig;
+export interface DateFieldConfig {
+    field: string;
+    fromParam?: string;
+    toParam?: string;
+}
+export interface SoftDeleteConfig {
+    field: string;
+    value?: any;
+}
+export interface QueryBuilderOptions<T = any> {
+    model: Model<T>;
+    query: Record<string, any>;
+    searchFields?: SearchField[];
+    searchMode?: 'or' | 'and';
+    allowedFilters?: string[];
+    defaultSort?: string;
+    defaultOrder?: 'asc' | 'desc';
+    defaultLimit?: number;
+    maxLimit?: number;
+    populate?: string | string[] | PopulateOptions | PopulateOptions[];
+    select?: ProjectionType<T> | string;
+    dateField?: string;
+    dateFields?: DateFieldConfig[];
+    lean?: boolean;
+    customFilter?: Record<string, any>;
+    softDelete?: SoftDeleteConfig;
+    withCount?: boolean;
+}
+export interface PaginationMeta {
+    total: number;
+    page: number;
+    limit: number;
+    pages: number;
+    hasNext: boolean;
+    hasPrev: boolean;
+}
+export interface QueryBuilderResult<T = any> {
+    data: T[];
+    pagination: PaginationMeta;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cjs/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAElE,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE5D,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,eAAe,CAAC;CACxB;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,iBAAiB,CAAC;AAErD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,GAAG,CAAC;CACb;AAED,MAAM,WAAW,mBAAmB,CAAC,CAAC,GAAG,GAAG;IAC1C,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;IAC7B,UAAU,CAAC,EAAE,IAAI,GAAG,KAAK,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,eAAe,GAAG,eAAe,EAAE,CAAC;IACnE,MAAM,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;IAC/B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACnC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,GAAG;IACzC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,UAAU,EAAE,cAAc,CAAC;CAC5B"}

package/dist/cjs/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cjs/types.js.map

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

package/dist/esm/filters/buildDateFilter.d.ts

@@ -0,0 +1,11 @@
+import { FilterQuery } from 'mongoose';
+/**
+ * Builds a MongoDB date-range filter for the specified field.
+ *
+ * - `from` maps to `$gte` (start of that day, as-is from the ISO string).
+ * - `to`   maps to `$lte` (end of that day — time set to 23:59:59.999).
+ * - Invalid date strings are silently ignored.
+ * - Returns `{}` when no dateField is provided or both dates are invalid.
+ */
+export declare function buildDateFilter(from: string | undefined, to: string | undefined, dateField: string | undefined): FilterQuery<any>;
+//# sourceMappingURL=buildDateFilter.d.ts.map

package/dist/esm/filters/buildDateFilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildDateFilter.d.ts","sourceRoot":"","sources":["../../../src/filters/buildDateFilter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAWvC;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,WAAW,CAAC,GAAG,CAAC,CAqBlB"}

package/dist/esm/filters/buildDateFilter.js

@@ -0,0 +1,36 @@
+/**
+ * Determines whether a given value produces a valid Date object.
+ */
+function isValidDate(value) {
+    if (!value || value.trim() === '')
+        return false;
+    const d = new Date(value);
+    return !isNaN(d.getTime());
+}
+/**
+ * Builds a MongoDB date-range filter for the specified field.
+ *
+ * - `from` maps to `$gte` (start of that day, as-is from the ISO string).
+ * - `to`   maps to `$lte` (end of that day — time set to 23:59:59.999).
+ * - Invalid date strings are silently ignored.
+ * - Returns `{}` when no dateField is provided or both dates are invalid.
+ */
+export function buildDateFilter(from, to, dateField) {
+    if (!dateField)
+        return {};
+    const conditions = {};
+    if (from && isValidDate(from)) {
+        conditions['$gte'] = new Date(from);
+    }
+    if (to && isValidDate(to)) {
+        const toDate = new Date(to);
+        // Set to end of day so the entire `to` day is included
+        toDate.setHours(23, 59, 59, 999);
+        conditions['$lte'] = toDate;
+    }
+    if (Object.keys(conditions).length === 0) {
+        return {};
+    }
+    return { [dateField]: conditions };
+}
+//# sourceMappingURL=buildDateFilter.js.map

package/dist/esm/filters/buildDateFilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildDateFilter.js","sourceRoot":"","sources":["../../../src/filters/buildDateFilter.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,SAAS,WAAW,CAAC,KAAa;IAChC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IAChD,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAwB,EACxB,EAAsB,EACtB,SAA6B;IAE7B,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,CAAC;IAE1B,MAAM,UAAU,GAAyB,EAAE,CAAC;IAE5C,IAAI,IAAI,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,UAAU,CAAC,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,EAAE,IAAI,WAAW,CAAC,EAAE,CAAC,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5B,uDAAuD;QACvD,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;QACjC,UAAU,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;IAC9B,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,EAAE,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,CAAC;AACrC,CAAC"}

package/dist/esm/filters/buildDynamicFilters.d.ts

@@ -0,0 +1,3 @@
+import { FilterQuery, Model } from 'mongoose';
+export declare function buildDynamicFilters(query: Record<string, any>, allowedFilters: string[] | undefined, model: Model<any>): FilterQuery<any>;
+//# sourceMappingURL=buildDynamicFilters.d.ts.map

package/dist/esm/filters/buildDynamicFilters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildDynamicFilters.d.ts","sourceRoot":"","sources":["../../../src/filters/buildDynamicFilters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAiE9C,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC1B,cAAc,EAAE,MAAM,EAAE,GAAG,SAAS,EACpC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAChB,WAAW,CAAC,GAAG,CAAC,CAyClB"}

package/dist/esm/filters/buildDynamicFilters.js

@@ -0,0 +1,107 @@
+const RESERVED_PARAMS = new Set([
+    'page', 'limit', 'sort', 'order', 'search', 'from', 'to', 'populate', 'select',
+]);
+const OPERATOR_SUFFIXES = [
+    ['_exists', '$exists'],
+    ['_regex', '$regex'],
+    ['_nin', '$nin'],
+    ['_gte', '$gte'],
+    ['_lte', '$lte'],
+    ['_ne', '$ne'],
+    ['_in', '$in'],
+    ['_gt', '$gt'],
+    ['_lt', '$lt'],
+];
+function parseOperatorKey(key) {
+    for (const [suffix, op] of OPERATOR_SUFFIXES) {
+        if (key.endsWith(suffix) && key.length > suffix.length) {
+            return { field: key.slice(0, -suffix.length), op };
+        }
+    }
+    return null;
+}
+function coerceScalar(raw) {
+    const str = String(raw);
+    if (str === 'true')
+        return true;
+    if (str === 'false')
+        return false;
+    const n = Number(str);
+    return isNaN(n) ? str : n;
+}
+function coerceForOperator(raw, op) {
+    const str = String(raw);
+    switch (op) {
+        case '$gte':
+        case '$lte':
+        case '$gt':
+        case '$lt': {
+            const n = Number(str);
+            return isNaN(n) ? str : n;
+        }
+        case '$ne':
+            return coerceScalar(raw);
+        case '$in':
+        case '$nin':
+            return str.split(',').map((v) => coerceScalar(v.trim()));
+        case '$exists':
+            return str !== 'false';
+        case '$regex': {
+            try {
+                return new RegExp(str, 'i');
+            }
+            catch (_a) {
+                return null;
+            }
+        }
+        default:
+            return coerceScalar(raw);
+    }
+}
+export function buildDynamicFilters(query, allowedFilters, model) {
+    const filter = {};
+    const allowed = new Set(allowedFilters !== null && allowedFilters !== void 0 ? allowedFilters : []);
+    const schemaPaths = model.schema.paths;
+    for (const key of Object.keys(query)) {
+        if (RESERVED_PARAMS.has(key))
+            continue;
+        const raw = query[key];
+        if (raw === undefined || raw === null || raw === '')
+            continue;
+        const parsed = parseOperatorKey(key);
+        if (parsed) {
+            const { field, op } = parsed;
+            const fieldAllowed = allowed.has(field) || field in schemaPaths;
+            if (!fieldAllowed)
+                continue;
+            const coerced = coerceForOperator(raw, op);
+            if (coerced === null)
+                continue;
+            if (typeof filter[field] !== 'object' || Array.isArray(filter[field])) {
+                filter[field] = {};
+            }
+            filter[field][op] = coerced;
+        }
+        else {
+            const keyAllowed = allowed.has(key) || key in schemaPaths;
+            if (!keyAllowed)
+                continue;
+            const value = String(raw);
+            if (value === 'true') {
+                filter[key] = true;
+                continue;
+            }
+            if (value === 'false') {
+                filter[key] = false;
+                continue;
+            }
+            if (value.includes(',')) {
+                filter[key] = { $in: value.split(',').map((v) => v.trim()) };
+                continue;
+            }
+            filter[key] = raw;
+        }
+    }
+    return filter;
+}
+//# sourceMappingURL=buildDynamicFilters.js.map

package/dist/esm/filters/buildDynamicFilters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildDynamicFilters.js","sourceRoot":"","sources":["../../../src/filters/buildDynamicFilters.ts"],"names":[],"mappings":"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"}

package/dist/esm/filters/buildPagination.d.ts

@@ -0,0 +1,15 @@
+export interface PaginationParams {
+    page: number;
+    limit: number;
+    skip: number;
+}
+/**
+ * Parses and validates pagination query parameters.
+ *
+ * Rules:
+ * - `page` is clamped to a minimum of 1.
+ * - `limit` is clamped between 1 and `maxLimit` (inclusive).
+ * - Non-numeric or missing values fall back to the provided defaults.
+ */
+export declare function buildPagination(queryPage: string | undefined, queryLimit: string | undefined, defaultLimit: number, maxLimit: number): PaginationParams;
+//# sourceMappingURL=buildPagination.d.ts.map

package/dist/esm/filters/buildPagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildPagination.d.ts","sourceRoot":"","sources":["../../../src/filters/buildPagination.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,gBAAgB,CAgBlB"}

package/dist/esm/filters/buildPagination.js

@@ -0,0 +1,27 @@
+/**
+ * Parses and validates pagination query parameters.
+ *
+ * Rules:
+ * - `page` is clamped to a minimum of 1.
+ * - `limit` is clamped between 1 and `maxLimit` (inclusive).
+ * - Non-numeric or missing values fall back to the provided defaults.
+ */
+export function buildPagination(queryPage, queryLimit, defaultLimit, maxLimit) {
+    let page = parseInt(queryPage, 10);
+    let limit = parseInt(queryLimit, 10);
+    // Fall back to defaults for non-numeric inputs
+    if (isNaN(page))
+        page = 1;
+    if (isNaN(limit))
+        limit = defaultLimit;
+    // Enforce bounds
+    if (page < 1)
+        page = 1;
+    if (limit < 1)
+        limit = 1;
+    if (limit > maxLimit)
+        limit = maxLimit;
+    const skip = (page - 1) * limit;
+    return { page, limit, skip };
+}
+//# sourceMappingURL=buildPagination.js.map

package/dist/esm/filters/buildPagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildPagination.js","sourceRoot":"","sources":["../../../src/filters/buildPagination.ts"],"names":[],"mappings":"AAMA;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAC7B,SAA6B,EAC7B,UAA8B,EAC9B,YAAoB,EACpB,QAAgB;IAEhB,IAAI,IAAI,GAAG,QAAQ,CAAC,SAAmB,EAAE,EAAE,CAAC,CAAC;IAC7C,IAAI,KAAK,GAAG,QAAQ,CAAC,UAAoB,EAAE,EAAE,CAAC,CAAC;IAE/C,+CAA+C;IAC/C,IAAI,KAAK,CAAC,IAAI,CAAC;QAAE,IAAI,GAAG,CAAC,CAAC;IAC1B,IAAI,KAAK,CAAC,KAAK,CAAC;QAAE,KAAK,GAAG,YAAY,CAAC;IAEvC,iBAAiB;IACjB,IAAI,IAAI,GAAG,CAAC;QAAE,IAAI,GAAG,CAAC,CAAC;IACvB,IAAI,KAAK,GAAG,CAAC;QAAE,KAAK,GAAG,CAAC,CAAC;IACzB,IAAI,KAAK,GAAG,QAAQ;QAAE,KAAK,GAAG,QAAQ,CAAC;IAEvC,MAAM,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;IAEhC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC/B,CAAC"}

package/dist/esm/filters/buildPopulate.d.ts

@@ -0,0 +1,3 @@
+import { PopulateOptions } from 'mongoose';
+export declare function buildPopulate(queryPopulate: string | undefined, optionPopulate: string | string[] | PopulateOptions | PopulateOptions[] | undefined): PopulateOptions[];
+//# sourceMappingURL=buildPopulate.d.ts.map

package/dist/esm/filters/buildPopulate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildPopulate.d.ts","sourceRoot":"","sources":["../../../src/filters/buildPopulate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAmB3C,wBAAgB,aAAa,CAC3B,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,cAAc,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,eAAe,GAAG,eAAe,EAAE,GAAG,SAAS,GAClF,eAAe,EAAE,CA2BnB"}

package/dist/esm/filters/buildPopulate.js

@@ -0,0 +1,42 @@
+function dotToPopulate(dotPath) {
+    const parts = dotPath
+        .trim()
+        .split('.')
+        .map((p) => p.trim())
+        .filter((p) => p.length > 0)
+        .slice(0, 4);
+    if (parts.length === 0)
+        throw new Error(`Invalid populate path: "${dotPath}"`);
+    let result = { path: parts[parts.length - 1] };
+    for (let i = parts.length - 2; i >= 0; i--) {
+        result = { path: parts[i], populate: result };
+    }
+    return result;
+}
+export function buildPopulate(queryPopulate, optionPopulate) {
+    if (queryPopulate && queryPopulate.trim() !== '') {
+        return queryPopulate
+            .split(',')
+            .map((p) => p.trim())
+            .filter((p) => p.length > 0)
+            .map(dotToPopulate);
+    }
+    if (optionPopulate === undefined || optionPopulate === null)
+        return [];
+    if (typeof optionPopulate === 'string') {
+        return optionPopulate.trim() === '' ? [] : [dotToPopulate(optionPopulate)];
+    }
+    if (Array.isArray(optionPopulate)) {
+        if (optionPopulate.length === 0)
+            return [];
+        if (typeof optionPopulate[0] === 'string') {
+            return optionPopulate
+                .map((p) => p.trim())
+                .filter((p) => p.length > 0)
+                .map(dotToPopulate);
+        }
+        return optionPopulate;
+    }
+    return [optionPopulate];
+}
+//# sourceMappingURL=buildPopulate.js.map

package/dist/esm/filters/buildPopulate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildPopulate.js","sourceRoot":"","sources":["../../../src/filters/buildPopulate.ts"],"names":[],"mappings":"AAEA,SAAS,aAAa,CAAC,OAAe;IACpC,MAAM,KAAK,GAAG,OAAO;SAClB,IAAI,EAAE;SACN,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;SAC3B,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAEf,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,OAAO,GAAG,CAAC,CAAC;IAE/E,IAAI,MAAM,GAAoB,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;IAChE,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,MAAM,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAChD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,aAAiC,EACjC,cAAmF;IAEnF,IAAI,aAAa,IAAI,aAAa,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACjD,OAAO,aAAa;aACjB,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;aAC3B,GAAG,CAAC,aAAa,CAAC,CAAC;IACxB,CAAC;IAED,IAAI,cAAc,KAAK,SAAS,IAAI,cAAc,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IAEvE,IAAI,OAAO,cAAc,KAAK,QAAQ,EAAE,CAAC;QACvC,OAAO,cAAc,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC,CAAC;IAC7E,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;QAClC,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAC3C,IAAI,OAAO,cAAc,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC1C,OAAQ,cAA2B;iBAChC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;iBACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;iBAC3B,GAAG,CAAC,aAAa,CAAC,CAAC;QACxB,CAAC;QACD,OAAO,cAAmC,CAAC;IAC7C,CAAC;IAED,OAAO,CAAC,cAAiC,CAAC,CAAC;AAC7C,CAAC"}

package/dist/esm/filters/buildSearch.d.ts

@@ -0,0 +1,4 @@
+import { FilterQuery } from 'mongoose';
+import { SearchField } from '../types';
+export declare function buildSearch(search: string | undefined, searchFields: SearchField[] | undefined, searchMode?: 'or' | 'and'): FilterQuery<any>;
+//# sourceMappingURL=buildSearch.d.ts.map

package/dist/esm/filters/buildSearch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildSearch.d.ts","sourceRoot":"","sources":["../../../src/filters/buildSearch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAgCvC,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,YAAY,EAAE,WAAW,EAAE,GAAG,SAAS,EACvC,UAAU,GAAE,IAAI,GAAG,KAAY,GAC9B,WAAW,CAAC,GAAG,CAAC,CA8BlB"}

package/dist/esm/filters/buildSearch.js

@@ -0,0 +1,54 @@
+function escapeRegex(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+function buildFieldCondition(field, type, term) {
+    if (type === 'number') {
+        const num = Number(term);
+        if (isNaN(num))
+            return null;
+        return { [field]: { $eq: num } };
+    }
+    if (type === 'exact') {
+        return { [field]: term };
+    }
+    return { [field]: { $regex: new RegExp(escapeRegex(term), 'i') } };
+}
+function normaliseFields(searchFields) {
+    return searchFields.map((f) => {
+        var _a;
+        return typeof f === 'string'
+            ? { field: f, type: 'string' }
+            : { field: f.field, type: (_a = f.type) !== null && _a !== void 0 ? _a : 'string' };
+    });
+}
+export function buildSearch(search, searchFields, searchMode = 'or') {
+    if (!search || !searchFields || searchFields.length === 0)
+        return {};
+    const trimmed = search.trim();
+    if (trimmed.length === 0)
+        return {};
+    const fields = normaliseFields(searchFields);
+    if (searchMode === 'and') {
+        const terms = trimmed.split(/\s+/).filter((t) => t.length > 0);
+        const andClauses = [];
+        for (const term of terms) {
+            const orConds = fields
+                .map((f) => buildFieldCondition(f.field, f.type, term))
+                .filter((c) => c !== null);
+            if (orConds.length > 0)
+                andClauses.push({ $or: orConds });
+        }
+        if (andClauses.length === 0)
+            return {};
+        if (andClauses.length === 1)
+            return andClauses[0];
+        return { $and: andClauses };
+    }
+    const orConds = fields
+        .map((f) => buildFieldCondition(f.field, f.type, trimmed))
+        .filter((c) => c !== null);
+    if (orConds.length === 0)
+        return {};
+    return { $or: orConds };
+}
+//# sourceMappingURL=buildSearch.js.map

package/dist/esm/filters/buildSearch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildSearch.js","sourceRoot":"","sources":["../../../src/filters/buildSearch.ts"],"names":[],"mappings":"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"}

package/dist/esm/filters/buildSort.d.ts

@@ -0,0 +1,2 @@
+export declare function buildSort(querySort: string | undefined, queryOrder: string | undefined, defaultSort: string, defaultOrder: 'asc' | 'desc'): Record<string, 1 | -1>;
+//# sourceMappingURL=buildSort.d.ts.map

package/dist/esm/filters/buildSort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildSort.d.ts","sourceRoot":"","sources":["../../../src/filters/buildSort.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CACvB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,KAAK,GAAG,MAAM,GAC3B,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAgBxB"}

package/dist/esm/filters/buildSort.js

@@ -0,0 +1,16 @@
+export function buildSort(querySort, queryOrder, defaultSort, defaultOrder) {
+    var _a;
+    const sortFields = ((querySort && querySort.trim()) || defaultSort)
+        .split(',')
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0);
+    const orderParts = (queryOrder !== null && queryOrder !== void 0 ? queryOrder : '').split(',').map((o) => o.trim());
+    const result = {};
+    for (let i = 0; i < sortFields.length; i++) {
+        const rawOrder = (_a = orderParts[i]) !== null && _a !== void 0 ? _a : '';
+        const dir = rawOrder === 'asc' || rawOrder === 'desc' ? rawOrder : i === 0 ? defaultOrder : 'asc';
+        result[sortFields[i]] = dir === 'asc' ? 1 : -1;
+    }
+    return result;
+}
+//# sourceMappingURL=buildSort.js.map

package/dist/esm/filters/buildSort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildSort.js","sourceRoot":"","sources":["../../../src/filters/buildSort.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS,CACvB,SAA6B,EAC7B,UAA8B,EAC9B,WAAmB,EACnB,YAA4B;;IAE5B,MAAM,UAAU,GAAG,CAAC,CAAC,SAAS,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC,IAAI,WAAW,CAAC;SAChE,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAE/B,MAAM,UAAU,GAAG,CAAC,UAAU,aAAV,UAAU,cAAV,UAAU,GAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAEtE,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,MAAM,QAAQ,GAAG,MAAA,UAAU,CAAC,CAAC,CAAC,mCAAI,EAAE,CAAC;QACrC,MAAM,GAAG,GACP,QAAQ,KAAK,KAAK,IAAI,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC;QACxF,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/esm/index.d.ts

@@ -0,0 +1,3 @@
+export { queryBuilder } from './queryBuilder';
+export type { QueryBuilderOptions, PaginationMeta, QueryBuilderResult, SearchField, SearchFieldConfig, SearchFieldType, DateFieldConfig, SoftDeleteConfig, } from './types';
+//# sourceMappingURL=index.d.ts.map