@solid-nestjs/common 0.2.6 → 0.2.8

package/dist/enums/aggregate-function.enum.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Enumeration of supported aggregate functions for database queries.
+ *
+ * @enum {string}
+ * @readonly
+ *
+ * @example
+ * ```typescript
+ * // Using aggregate functions in groupBy operations
+ * const aggregates = [
+ *   { field: 'price', function: AggregateFunctionTypes.AVG },
+ *   { field: 'id', function: AggregateFunctionTypes.COUNT }
+ * ];
+ * ```
+ */
+export declare enum AggregateFunctionTypes {
+    /**
+     * Count of non-null values
+     */
+    COUNT = "COUNT",
+    /**
+     * Sum of numeric values
+     */
+    SUM = "SUM",
+    /**
+     * Average of numeric values
+     */
+    AVG = "AVG",
+    /**
+     * Minimum value
+     */
+    MIN = "MIN",
+    /**
+     * Maximum value
+     */
+    MAX = "MAX",
+    /**
+     * Count of distinct values
+     */
+    COUNT_DISTINCT = "COUNT_DISTINCT"
+}
+//# sourceMappingURL=aggregate-function.enum.d.ts.map

package/dist/enums/aggregate-function.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate-function.enum.d.ts","sourceRoot":"","sources":["../../src/enums/aggregate-function.enum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,oBAAY,sBAAsB;IAChC;;OAEG;IACH,KAAK,UAAU;IAEf;;OAEG;IACH,GAAG,QAAQ;IAEX;;OAEG;IACH,GAAG,QAAQ;IAEX;;OAEG;IACH,GAAG,QAAQ;IAEX;;OAEG;IACH,GAAG,QAAQ;IAEX;;OAEG;IACH,cAAc,mBAAmB;CAClC"}

package/dist/enums/aggregate-function.enum.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AggregateFunctionTypes = void 0;
+/**
+ * Enumeration of supported aggregate functions for database queries.
+ *
+ * @enum {string}
+ * @readonly
+ *
+ * @example
+ * ```typescript
+ * // Using aggregate functions in groupBy operations
+ * const aggregates = [
+ *   { field: 'price', function: AggregateFunctionTypes.AVG },
+ *   { field: 'id', function: AggregateFunctionTypes.COUNT }
+ * ];
+ * ```
+ */
+var AggregateFunctionTypes;
+(function (AggregateFunctionTypes) {
+    /**
+     * Count of non-null values
+     */
+    AggregateFunctionTypes["COUNT"] = "COUNT";
+    /**
+     * Sum of numeric values
+     */
+    AggregateFunctionTypes["SUM"] = "SUM";
+    /**
+     * Average of numeric values
+     */
+    AggregateFunctionTypes["AVG"] = "AVG";
+    /**
+     * Minimum value
+     */
+    AggregateFunctionTypes["MIN"] = "MIN";
+    /**
+     * Maximum value
+     */
+    AggregateFunctionTypes["MAX"] = "MAX";
+    /**
+     * Count of distinct values
+     */
+    AggregateFunctionTypes["COUNT_DISTINCT"] = "COUNT_DISTINCT";
+})(AggregateFunctionTypes || (exports.AggregateFunctionTypes = AggregateFunctionTypes = {}));
+//# sourceMappingURL=aggregate-function.enum.js.map

package/dist/enums/aggregate-function.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate-function.enum.js","sourceRoot":"","sources":["../../src/enums/aggregate-function.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;GAcG;AACH,IAAY,sBA8BX;AA9BD,WAAY,sBAAsB;IAChC;;OAEG;IACH,yCAAe,CAAA;IAEf;;OAEG;IACH,qCAAW,CAAA;IAEX;;OAEG;IACH,qCAAW,CAAA;IAEX;;OAEG;IACH,qCAAW,CAAA;IAEX;;OAEG;IACH,qCAAW,CAAA;IAEX;;OAEG;IACH,2DAAiC,CAAA;AACnC,CAAC,EA9BW,sBAAsB,sCAAtB,sBAAsB,QA8BjC"}

package/dist/enums/index.d.ts

@@ -1,3 +1,4 @@
 export * from './standard-actions.enum';
 export * from './order-by-type.enum';
+export * from './aggregate-function.enum';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/enums/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/enums/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC"}

package/dist/enums/index.js

@@ -16,4 +16,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./standard-actions.enum"), exports);
 __exportStar(require("./order-by-type.enum"), exports);
+__exportStar(require("./aggregate-function.enum"), exports);
 //# sourceMappingURL=index.js.map

package/dist/enums/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/enums/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0DAAwC;AACxC,uDAAqC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/enums/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0DAAwC;AACxC,uDAAqC;AACrC,4DAA0C"}

package/dist/interfaces/index.d.ts

@@ -1,4 +1,6 @@
 export * from './services';
 export * from './structures';
 export * from './misc';
+export * from './inputs';
+export * from './outputs';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC"}

package/dist/interfaces/index.js

@@ -17,4 +17,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./services"), exports);
 __exportStar(require("./structures"), exports);
 __exportStar(require("./misc"), exports);
+__exportStar(require("./inputs"), exports);
+__exportStar(require("./outputs"), exports);
 //# sourceMappingURL=index.js.map

package/dist/interfaces/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,+CAA6B;AAC7B,yCAAuB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,+CAA6B;AAC7B,yCAAuB;AACvB,2CAAyB;AACzB,4CAA0B"}

package/dist/interfaces/inputs/filters.interfaces.d.ts

@@ -0,0 +1,36 @@
+export interface StringFilter {
+    _eq?: string;
+    _neq?: string;
+    _in?: string[];
+    _startswith?: string;
+    _notstartswith?: string;
+    _endswith?: string;
+    _notendswith?: string;
+    _contains?: string;
+    _notcontains?: string;
+    _like?: string;
+    _notlike?: string;
+}
+export interface NumberFilter {
+    _eq?: number;
+    _neq?: number;
+    _gt?: number;
+    _gte?: number;
+    _lt?: number;
+    _lte?: number;
+    _in?: number[];
+    _between?: number[];
+    _notbetween?: number[];
+}
+export interface DateFilter {
+    _eq?: Date;
+    _neq?: Date;
+    _gt?: Date;
+    _gte?: Date;
+    _lt?: Date;
+    _lte?: Date;
+    _in?: Date[];
+    _between?: Date[];
+    _notbetween?: Date[];
+}
+//# sourceMappingURL=filters.interfaces.d.ts.map

package/dist/interfaces/inputs/filters.interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filters.interfaces.d.ts","sourceRoot":"","sources":["../../../src/interfaces/inputs/filters.interfaces.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC;IACb,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,IAAI,EAAE,CAAC;CACtB"}

package/dist/interfaces/inputs/filters.interfaces.js

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

package/dist/interfaces/inputs/filters.interfaces.js.map

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

package/dist/interfaces/inputs/find-args.interface.d.ts

@@ -0,0 +1,8 @@
+import { Where, OrderBy } from '../../types/find-args.type';
+import { PaginationRequest } from './pagination-request.interface';
+export interface FindArgs<T> {
+    pagination?: PaginationRequest;
+    where?: Where<T>;
+    orderBy?: OrderBy<T> | OrderBy<T>[];
+}
+//# sourceMappingURL=find-args.interface.d.ts.map

package/dist/interfaces/inputs/find-args.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-args.interface.d.ts","sourceRoot":"","sources":["../../../src/interfaces/inputs/find-args.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAEnE,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAE/B,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAEjB,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;CACrC"}

package/dist/interfaces/inputs/find-args.interface.js

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

package/dist/interfaces/inputs/find-args.interface.js.map

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

package/dist/interfaces/inputs/group-by-args.interface.d.ts

@@ -0,0 +1,33 @@
+import { FindArgs } from './find-args.interface';
+import { GroupByRequest } from './group-by-request.interface';
+/**
+ * Extended find arguments that include groupBy configuration.
+ * This interface extends FindArgs to add GROUP BY functionality
+ * without polluting the base FindArgs interface.
+ *
+ * @interface GroupByArgs
+ * @template T - The entity type being queried
+ * @extends {FindArgs<T>}
+ *
+ * @example
+ * ```typescript
+ * const args: GroupByArgs<Product> = {
+ *   where: { category: 'Electronics' },
+ *   groupBy: {
+ *     fields: { supplier: { name: true } },
+ *     aggregates: [
+ *       { field: 'price', function: AggregateFunctionTypes.AVG }
+ *     ]
+ *   },
+ *   pagination: { page: 1, limit: 10 }
+ * };
+ * ```
+ */
+export interface GroupByArgs<T> extends FindArgs<T> {
+    /**
+     * GroupBy configuration for the query.
+     * This property is required for grouped queries.
+     */
+    groupBy: GroupByRequest<T>;
+}
+//# sourceMappingURL=group-by-args.interface.d.ts.map

package/dist/interfaces/inputs/group-by-args.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-by-args.interface.d.ts","sourceRoot":"","sources":["../../../src/interfaces/inputs/group-by-args.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,CAAE,SAAQ,QAAQ,CAAC,CAAC,CAAC;IACjD;;;OAGG;IACH,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;CAC5B"}

package/dist/interfaces/inputs/group-by-args.interface.js

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

package/dist/interfaces/inputs/group-by-args.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-by-args.interface.js","sourceRoot":"","sources":["../../../src/interfaces/inputs/group-by-args.interface.ts"],"names":[],"mappings":""}

package/dist/interfaces/inputs/group-by-request.interface.d.ts

@@ -0,0 +1,63 @@
+import { AggregateFunctionTypes } from '../../enums';
+import { GroupBy } from '../../types/group-by.type';
+/**
+ * Represents an aggregate field configuration for groupBy operations.
+ *
+ * @interface AggregateField
+ *
+ * @example
+ * ```typescript
+ * const aggregateField: AggregateField = {
+ *   field: 'price',
+ *   function: AggregateFunctionTypes.AVG,
+ *   alias: 'averagePrice'
+ * };
+ * ```
+ */
+export interface AggregateField {
+    /**
+     * The field name to apply the aggregate function to
+     */
+    field: string;
+    /**
+     * The aggregate function to apply
+     */
+    function: AggregateFunctionTypes;
+    /**
+     * Optional alias for the aggregate result
+     * If not provided, defaults to `${function}_${field}`
+     */
+    alias?: string;
+}
+/**
+ * Represents the groupBy configuration for queries.
+ *
+ * @interface GroupByRequest
+ * @template T - The entity type being grouped
+ *
+ * @example
+ * ```typescript
+ * const groupByRequest: GroupByRequest<Product> = {
+ *   fields: {
+ *     category: true,
+ *     supplier: { name: true }
+ *   },
+ *   aggregates: [
+ *     { field: 'price', function: AggregateFunctionTypes.AVG, alias: 'avgPrice' },
+ *     { field: 'type', function: AggregateFunctionTypes.COUNT, alias: 'totalProducts' }
+ *   ],
+ *   includeItems: false
+ * };
+ * ```
+ */
+export interface GroupByRequest<T = any> {
+    /**
+     * Fields to group by (similar to OrderBy structure)
+     */
+    fields?: GroupBy<T>;
+    /**
+     * Aggregate functions to apply
+     */
+    aggregates?: AggregateField[];
+}
+//# sourceMappingURL=group-by-request.interface.d.ts.map

package/dist/interfaces/inputs/group-by-request.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-by-request.interface.d.ts","sourceRoot":"","sources":["../../../src/interfaces/inputs/group-by-request.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAEpD;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,EAAE,sBAAsB,CAAC;IAEjC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,GAAG;IACrC;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAEpB;;OAEG;IACH,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;CAC/B"}

package/dist/interfaces/inputs/group-by-request.interface.js

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

package/dist/interfaces/inputs/group-by-request.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-by-request.interface.js","sourceRoot":"","sources":["../../../src/interfaces/inputs/group-by-request.interface.ts"],"names":[],"mappings":""}

package/dist/interfaces/inputs/index.d.ts

@@ -0,0 +1,6 @@
+export * from './filters.interfaces';
+export * from './find-args.interface';
+export * from './group-by-args.interface';
+export * from './group-by-request.interface';
+export * from './pagination-request.interface';
+//# sourceMappingURL=index.d.ts.map

package/dist/interfaces/inputs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/interfaces/inputs/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC"}

package/dist/interfaces/inputs/index.js

@@ -0,0 +1,22 @@
+"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 });
+__exportStar(require("./filters.interfaces"), exports);
+__exportStar(require("./find-args.interface"), exports);
+__exportStar(require("./group-by-args.interface"), exports);
+__exportStar(require("./group-by-request.interface"), exports);
+__exportStar(require("./pagination-request.interface"), exports);
+//# sourceMappingURL=index.js.map

package/dist/interfaces/inputs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/interfaces/inputs/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uDAAqC;AACrC,wDAAsC;AACtC,4DAA0C;AAC1C,+DAA6C;AAC7C,iEAA+C"}

package/dist/interfaces/inputs/pagination-request.interface.d.ts

@@ -0,0 +1,7 @@
+export interface PaginationRequest {
+    skip?: number;
+    take?: number;
+    page?: number;
+    limit?: number;
+}
+//# sourceMappingURL=pagination-request.interface.d.ts.map

package/dist/interfaces/inputs/pagination-request.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination-request.interface.d.ts","sourceRoot":"","sources":["../../../src/interfaces/inputs/pagination-request.interface.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/interfaces/inputs/pagination-request.interface.js

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

package/dist/interfaces/inputs/pagination-request.interface.js.map

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

package/dist/interfaces/misc/group-by-args.interface.d.ts

@@ -0,0 +1,33 @@
+import { FindArgs } from './find-args.interface';
+import { GroupByRequest } from './group-by-request.interface';
+/**
+ * Extended find arguments that include groupBy configuration.
+ * This interface extends FindArgs to add GROUP BY functionality
+ * without polluting the base FindArgs interface.
+ *
+ * @interface GroupByArgs
+ * @template T - The entity type being queried
+ * @extends {FindArgs<T>}
+ *
+ * @example
+ * ```typescript
+ * const args: GroupByArgs<Product> = {
+ *   where: { category: 'Electronics' },
+ *   groupBy: {
+ *     fields: { supplier: { name: true } },
+ *     aggregates: [
+ *       { field: 'price', function: AggregateFunctionTypes.AVG }
+ *     ]
+ *   },
+ *   pagination: { page: 1, limit: 10 }
+ * };
+ * ```
+ */
+export interface GroupByArgs<T> extends FindArgs<T> {
+    /**
+     * GroupBy configuration for the query.
+     * This property is required for grouped queries.
+     */
+    groupBy: GroupByRequest<T>;
+}
+//# sourceMappingURL=group-by-args.interface.d.ts.map

package/dist/interfaces/misc/group-by-args.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-by-args.interface.d.ts","sourceRoot":"","sources":["../../../src/interfaces/misc/group-by-args.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,CAAE,SAAQ,QAAQ,CAAC,CAAC,CAAC;IACjD;;;OAGG;IACH,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;CAC5B"}

package/dist/interfaces/misc/group-by-args.interface.js

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

package/dist/interfaces/misc/group-by-args.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-by-args.interface.js","sourceRoot":"","sources":["../../../src/interfaces/misc/group-by-args.interface.ts"],"names":[],"mappings":""}

package/dist/interfaces/misc/group-by-request.interface.d.ts

@@ -0,0 +1,63 @@
+import { AggregateFunctionTypes } from '../../enums';
+import { GroupBy } from '../../types/group-by.type';
+/**
+ * Represents an aggregate field configuration for groupBy operations.
+ *
+ * @interface AggregateField
+ *
+ * @example
+ * ```typescript
+ * const aggregateField: AggregateField = {
+ *   field: 'price',
+ *   function: AggregateFunctionTypes.AVG,
+ *   alias: 'averagePrice'
+ * };
+ * ```
+ */
+export interface AggregateField {
+    /**
+     * The field name to apply the aggregate function to
+     */
+    field: string;
+    /**
+     * The aggregate function to apply
+     */
+    function: AggregateFunctionTypes;
+    /**
+     * Optional alias for the aggregate result
+     * If not provided, defaults to `${function}_${field}`
+     */
+    alias?: string;
+}
+/**
+ * Represents the groupBy configuration for queries.
+ *
+ * @interface GroupByRequest
+ * @template T - The entity type being grouped
+ *
+ * @example
+ * ```typescript
+ * const groupByRequest: GroupByRequest<Product> = {
+ *   fields: {
+ *     category: true,
+ *     supplier: { name: true }
+ *   },
+ *   aggregates: [
+ *     { field: 'price', function: AggregateFunctionTypes.AVG, alias: 'avgPrice' },
+ *     { field: 'type', function: AggregateFunctionTypes.COUNT, alias: 'totalProducts' }
+ *   ],
+ *   includeItems: false
+ * };
+ * ```
+ */
+export interface GroupByRequest<T = any> {
+    /**
+     * Fields to group by (similar to OrderBy structure)
+     */
+    fields?: GroupBy<T>;
+    /**
+     * Aggregate functions to apply
+     */
+    aggregates?: AggregateField[];
+}
+//# sourceMappingURL=group-by-request.interface.d.ts.map

package/dist/interfaces/misc/group-by-request.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-by-request.interface.d.ts","sourceRoot":"","sources":["../../../src/interfaces/misc/group-by-request.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAEpD;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,EAAE,sBAAsB,CAAC;IAEjC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,GAAG;IACrC;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAEpB;;OAEG;IACH,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;CAC/B"}

package/dist/interfaces/misc/group-by-request.interface.js

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

package/dist/interfaces/misc/group-by-request.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-by-request.interface.js","sourceRoot":"","sources":["../../../src/interfaces/misc/group-by-request.interface.ts"],"names":[],"mappings":""}

package/dist/interfaces/misc/group-by-response.interface.d.ts

@@ -0,0 +1,59 @@
+import { PaginationResult } from './pagination-result.interface';
+/**
+ * Represents a single group result.
+ *
+ * @interface GroupResult
+ * @template T - The entity type being grouped
+ *
+ * @example
+ * ```typescript
+ * const groupResult: GroupResult<Product> = {
+ *   key: { category: 'Electronics', supplierName: 'TechCorp' },
+ *   aggregates: { avgPrice: 1250.50, totalProducts: 15 }
+ * };
+ * ```
+ */
+export interface GroupResult<T = any> {
+    /**
+     * The grouped key values as an object
+     */
+    key: Record<string, any>;
+    /**
+     * The computed aggregate values as an object
+     */
+    aggregates: Record<string, any>;
+}
+/**
+ * Represents the result of a grouped query with pagination.
+ * Extends PaginationResult to reuse existing pagination properties.
+ *
+ * @interface GroupedPaginationResult
+ * @template T - The entity type being grouped
+ *
+ * @example
+ * ```typescript
+ * const result: GroupedPaginationResult<Product> = {
+ *   groups: [groupResult1, groupResult2, ...],
+ *   pagination: {
+ *     total: 25,
+ *     count: 10,
+ *     limit: 10,
+ *     page: 1,
+ *     pageCount: 3,
+ *     hasNextPage: true,
+ *     hasPreviousPage: false
+ *   }
+ * };
+ * ```
+ */
+export interface GroupedPaginationResult<T = any> {
+    /**
+     * Array of group results
+     */
+    groups: GroupResult<T>[];
+    /**
+     * Pagination information for the groups
+     */
+    pagination: PaginationResult;
+}
+//# sourceMappingURL=group-by-response.interface.d.ts.map

package/dist/interfaces/misc/group-by-response.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-by-response.interface.d.ts","sourceRoot":"","sources":["../../../src/interfaces/misc/group-by-response.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEjE;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,GAAG;IAClC;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEzB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,uBAAuB,CAAC,CAAC,GAAG,GAAG;IAC9C;;OAEG;IACH,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IAEzB;;OAEG;IACH,UAAU,EAAE,gBAAgB,CAAC;CAC9B"}

package/dist/interfaces/misc/group-by-response.interface.js

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

package/dist/interfaces/misc/group-by-response.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-by-response.interface.js","sourceRoot":"","sources":["../../../src/interfaces/misc/group-by-response.interface.ts"],"names":[],"mappings":""}