@solid-nestjs/common 0.2.6 → 0.2.9

package/dist/types/dto-generation.types.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Type utilities for DTO generation with better TypeScript inference
+ */
+/**
+ * Primitive types that are safe to include in DTOs
+ */
+export type PrimitiveTypes = string | number | boolean | Date;
+/**
+ * Check if a type is primitive (flat type safe for DTOs)
+ */
+export type IsPrimitive<T> = T extends PrimitiveTypes ? true : false;
+/**
+ * Extract only primitive properties from an entity type
+ */
+export type PrimitivePropertiesOf<T> = {
+    [K in keyof T]: IsPrimitive<T[K]> extends true ? T[K] : never;
+};
+/**
+ * Get only the keys of primitive properties
+ */
+export type PrimitiveKeysOf<T> = {
+    [K in keyof T]: IsPrimitive<T[K]> extends true ? K : never;
+}[keyof T];
+/**
+ * Pick only primitive properties from an entity
+ */
+export type PickPrimitive<T> = Pick<T, PrimitiveKeysOf<T>>;
+/**
+ * For array format: Pick only the specified keys that are also primitive
+ */
+export type PickSelectedKeys<T, K extends keyof T> = Pick<T, K & PrimitiveKeysOf<T>>;
+/**
+ * For object format: Pick keys based on boolean configuration, but only primitive ones
+ */
+export type PickByConfig<T, Config extends Partial<Record<keyof T, boolean>>> = Pick<T, {
+    [K in keyof Config]: Config[K] extends true ? K extends PrimitiveKeysOf<T> ? K : never : never;
+}[keyof Config]>;
+/**
+ * Property inclusion configuration type
+ */
+export type PropertyInclusionConfig<TEntity> = Partial<Record<keyof TEntity, boolean>>;
+/**
+ * Infer the correct return type based on the properties/config parameter
+ */
+export type InferDtoType<TEntity, TPropertiesOrConfig extends (keyof TEntity)[] | PropertyInclusionConfig<TEntity> | undefined> = TPropertiesOrConfig extends (keyof TEntity)[] ? PickSelectedKeys<TEntity, TPropertiesOrConfig[number]> : TPropertiesOrConfig extends PropertyInclusionConfig<TEntity> ? PickByConfig<TEntity, TPropertiesOrConfig> : PickPrimitive<TEntity>;
+//# sourceMappingURL=dto-generation.types.d.ts.map

package/dist/types/dto-generation.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dto-generation.types.d.ts","sourceRoot":"","sources":["../../src/types/dto-generation.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,cAAc,GAAG,IAAI,GAAG,KAAK,CAAC;AAErE;;GAEG;AACH,MAAM,MAAM,qBAAqB,CAAC,CAAC,IAAI;KACpC,CAAC,IAAI,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK;CAC9D,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI;KAC9B,CAAC,IAAI,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,GAAG,CAAC,GAAG,KAAK;CAC3D,CAAC,MAAM,CAAC,CAAC,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;AAErF;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,EAAE,MAAM,SAAS,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,IAAI,CAClF,CAAC,EACD;KACG,CAAC,IAAI,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,SAAS,IAAI,GACvC,CAAC,SAAS,eAAe,CAAC,CAAC,CAAC,GAC1B,CAAC,GACD,KAAK,GACP,KAAK;CACV,CAAC,MAAM,MAAM,CAAC,CAChB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,uBAAuB,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AAEvF;;GAEG;AACH,MAAM,MAAM,YAAY,CACtB,OAAO,EACP,mBAAmB,SAAS,CAAC,MAAM,OAAO,CAAC,EAAE,GAAG,uBAAuB,CAAC,OAAO,CAAC,GAAG,SAAS,IAC1F,mBAAmB,SAAS,CAAC,MAAM,OAAO,CAAC,EAAE,GAC7C,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,CAAC,MAAM,CAAC,CAAC,GACtD,mBAAmB,SAAS,uBAAuB,CAAC,OAAO,CAAC,GAC5D,YAAY,CAAC,OAAO,EAAE,mBAAmB,CAAC,GAC1C,aAAa,CAAC,OAAO,CAAC,CAAC"}

package/dist/types/dto-generation.types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Type utilities for DTO generation with better TypeScript inference
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=dto-generation.types.js.map

package/dist/types/dto-generation.types.js.map

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

package/dist/types/find-args.type.d.ts

@@ -1,5 +1,5 @@
 import { OrderByTypes } from '../enums';
-import { StringFilter, NumberFilter, DateFilter } from './../interfaces/misc/filters.interfaces';
+import { StringFilter, NumberFilter, DateFilter } from './../interfaces/inputs/filters.interfaces';
 /**
  * Represents a flexible filter type for a given field type `T` in query operations.
  *
@@ -7,13 +7,14 @@ import { StringFilter, NumberFilter, DateFilter } from './../interfaces/misc/fil
  * - For `number` fields, allows a number, an array of numbers, or a `NumberFilter` object.
  * - For `Date` fields, allows a `Date`, an array of `Date`s, or a `DateFilter` object.
  * - For `boolean` fields, allows a boolean value.
+ * - For array fields (e.g., `InvoiceDetail[]`), extracts the element type and applies `Where<ElementType>`.
  * - For all other types, recursively applies the `Where<T>` type.
  *
  * This utility type is typically used to define the shape of "where" filter arguments in query builders or ORM-like APIs.
  *
  * @template T - The type of the field to generate a filter for.
  */
-type WhereField<T> = T extends string ? string | string[] | StringFilter : T extends number ? number | number[] | NumberFilter : T extends Date ? Date | Date[] | DateFilter : T extends boolean ? boolean : Where<T>;
+type WhereField<T> = T extends string ? string | string[] | StringFilter : T extends number ? number | number[] | NumberFilter : T extends Date ? Date | Date[] | DateFilter : T extends boolean ? boolean : T extends (infer U)[] ? Where<U> : Where<T>;
 /**
  * Represents a flexible filter type for querying objects of type `T`.
  *
@@ -34,15 +35,16 @@ export type Where<T> = {
 /**
  * Infers the appropriate ordering type for a given field type `T`.
  *
- * - If `T` is a `string`, the type is `string`.
- * - If `T` is a `number`, the type is `number`.
- * - If `T` is a `Date`, the type is `Date`.
- * - If `T` is a `boolean`, the type is `boolean`.
+ * - If `T` is a `string`, the type is `OrderByTypes`.
+ * - If `T` is a `number`, the type is `OrderByTypes`.
+ * - If `T` is a `Date`, the type is `OrderByTypes`.
+ * - If `T` is a `boolean`, the type is `OrderByTypes`.
+ * - For array fields (e.g., `InvoiceDetail[]`), extracts the element type and applies `OrderBy<ElementType>`.
  * - Otherwise, falls back to `OrderBy<T>`, allowing for nested ordering.
  *
  * @template T - The type of the field to determine the order-by type for.
  */
-type OrderByField<T> = T extends string ? OrderByTypes : T extends number ? OrderByTypes : T extends Date ? OrderByTypes : T extends boolean ? OrderByTypes : OrderBy<T>;
+type OrderByField<T> = T extends string ? OrderByTypes : T extends number ? OrderByTypes : T extends Date ? OrderByTypes : T extends boolean ? OrderByTypes : T extends (infer U)[] ? OrderBy<U> : OrderBy<T>;
 /**
  * Represents an object for specifying sorting order for each property of type `T`.
  * Each key of `T` can be optionally assigned an `OrderByField` value to indicate the sort direction.

package/dist/types/find-args.type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"find-args.type.d.ts","sourceRoot":"","sources":["../../src/types/find-args.type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,UAAU,EACX,MAAM,yCAAyC,CAAC;AAEjD;;;;;;;;;;;;GAYG;AACH,KAAK,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GACjC,MAAM,GAAG,MAAM,EAAE,GAAG,YAAY,GAChC,CAAC,SAAS,MAAM,GACd,MAAM,GAAG,MAAM,EAAE,GAAG,YAAY,GAChC,CAAC,SAAS,IAAI,GACZ,IAAI,GAAG,IAAI,EAAE,GAAG,UAAU,GAC1B,CAAC,SAAS,OAAO,GACf,OAAO,GACP,KAAK,CAAC,CAAC,CAAC,CAAC;AAEnB;;;;;;;;;;GAUG;AACH,MAAM,MAAM,KAAK,CAAC,CAAC,IAAI;KACpB,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAClC,GAAG;IACF,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7B,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;CAC7B,CAAC;AAEF;;;;;;;;;;GAUG;AACH,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GACnC,YAAY,GACZ,CAAC,SAAS,MAAM,GACd,YAAY,GACZ,CAAC,SAAS,IAAI,GACZ,YAAY,GACZ,CAAC,SAAS,OAAO,GACf,YAAY,GACZ,OAAO,CAAC,CAAC,CAAC,CAAC;AAErB;;;;;GAKG;AACH,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI;KACtB,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACpC,CAAC"}
+{"version":3,"file":"find-args.type.d.ts","sourceRoot":"","sources":["../../src/types/find-args.type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,UAAU,EACX,MAAM,2CAA2C,CAAC;AAEnD;;;;;;;;;;;;;GAaG;AACH,KAAK,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GACjC,MAAM,GAAG,MAAM,EAAE,GAAG,YAAY,GAChC,CAAC,SAAS,MAAM,GACd,MAAM,GAAG,MAAM,EAAE,GAAG,YAAY,GAChC,CAAC,SAAS,IAAI,GACZ,IAAI,GAAG,IAAI,EAAE,GAAG,UAAU,GAC1B,CAAC,SAAS,OAAO,GACf,OAAO,GACP,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GACnB,KAAK,CAAC,CAAC,CAAC,GACR,KAAK,CAAC,CAAC,CAAC,CAAC;AAErB;;;;;;;;;;GAUG;AACH,MAAM,MAAM,KAAK,CAAC,CAAC,IAAI;KACpB,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAClC,GAAG;IACF,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7B,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;CAC7B,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GACnC,YAAY,GACZ,CAAC,SAAS,MAAM,GACd,YAAY,GACZ,CAAC,SAAS,IAAI,GACZ,YAAY,GACZ,CAAC,SAAS,OAAO,GACf,YAAY,GACZ,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GACnB,OAAO,CAAC,CAAC,CAAC,GACV,OAAO,CAAC,CAAC,CAAC,CAAC;AAEvB;;;;;GAKG;AACH,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI;KACtB,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACpC,CAAC"}

package/dist/types/group-by.type.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Infers the appropriate grouping type for a given field type `T`.
+ *
+ * - If `T` is a `string`, the type is `boolean` (can be grouped).
+ * - If `T` is a `number`, the type is `boolean` (can be grouped).
+ * - If `T` is a `Date`, the type is `boolean` (can be grouped).
+ * - If `T` is a `boolean`, the type is `boolean` (can be grouped).
+ * - For array fields (e.g., `InvoiceDetail[]`), extracts the element type and applies `GroupBy<ElementType>`.
+ * - Otherwise, falls back to `GroupBy<T>`, allowing for nested grouping.
+ *
+ * @template T - The type of the field to determine the group-by type for.
+ */
+type GroupByField<T> = T extends string ? boolean : T extends number ? boolean : T extends Date ? boolean : T extends boolean ? boolean : T extends (infer U)[] ? GroupBy<U> : GroupBy<T>;
+/**
+ * Represents an object for specifying grouping fields for each property of type `T`.
+ * Each key of `T` can be optionally assigned a `GroupByField` value to indicate if it should be grouped.
+ *
+ * @template T - The type whose properties can be used for grouping.
+ *
+ * @example
+ * ```typescript
+ * interface Product {
+ *   id: number;
+ *   name: string;
+ *   category: string;
+ *   supplier: Supplier;
+ * }
+ *
+ * const groupBy: GroupBy<Product> = {
+ *   category: true,
+ *   supplier: {
+ *     name: true
+ *   }
+ * };
+ * ```
+ */
+export type GroupBy<T> = {
+    [K in keyof T]?: GroupByField<T[K]>;
+};
+export {};
+//# sourceMappingURL=group-by.type.d.ts.map

package/dist/types/group-by.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-by.type.d.ts","sourceRoot":"","sources":["../../src/types/group-by.type.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GACnC,OAAO,GACP,CAAC,SAAS,MAAM,GACd,OAAO,GACP,CAAC,SAAS,IAAI,GACZ,OAAO,GACP,CAAC,SAAS,OAAO,GACf,OAAO,GACP,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GACnB,OAAO,CAAC,CAAC,CAAC,GACV,OAAO,CAAC,CAAC,CAAC,CAAC;AAEvB;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI;KACtB,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACpC,CAAC"}

package/dist/types/group-by.type.js

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

package/dist/types/group-by.type.js.map

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

package/dist/types/index.d.ts

@@ -2,6 +2,8 @@ export * from './constructor.type';
 export * from './boolean.type';
 export * from './deep-partial.type';
 export * from './find-args.type';
+export * from './group-by.type';
 export * from './prettify.type';
 export * from './union-to-intersection.type';
+export * from './dto-generation.types';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC"}

package/dist/types/index.js

@@ -18,6 +18,8 @@ __exportStar(require("./constructor.type"), exports);
 __exportStar(require("./boolean.type"), exports);
 __exportStar(require("./deep-partial.type"), exports);
 __exportStar(require("./find-args.type"), exports);
+__exportStar(require("./group-by.type"), exports);
 __exportStar(require("./prettify.type"), exports);
 __exportStar(require("./union-to-intersection.type"), exports);
+__exportStar(require("./dto-generation.types"), exports);
 //# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,iDAA+B;AAC/B,sDAAoC;AACpC,mDAAiC;AACjC,kDAAgC;AAChC,+DAA6C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,iDAA+B;AAC/B,sDAAoC;AACpC,mDAAiC;AACjC,kDAAgC;AAChC,kDAAgC;AAChC,+DAA6C;AAC7C,yDAAuC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solid-nestjs/common",
-  "version": "0.2.6",
+  "version": "0.2.9",
   "description": "solid-nestjs common utilities",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -42,5 +42,5 @@
     "tsconfig.json": "^1.0.11",
     "typescript": "^5.8.3"
   },
-  "gitHead": "529b07675273503db46ac19a0ffeb32eb6fb2c85"
+  "gitHead": "3ebf7d4bd0a62c0964bbf3f3810c2ee3b2a3051b"
 }

package/dist/utils/object.utils.d.ts

@@ -1,8 +0,0 @@
-/**
- * Removes properties with `null` or `undefined` values from each object in the provided array.
- *
- * @param array - An array of objects to process.
- * @returns A new array of objects with all `null` or `undefined` properties removed.
- */
-declare function removeNullish(array: any): any;
-//# sourceMappingURL=object.utils.d.ts.map

package/dist/utils/object.utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"object.utils.d.ts","sourceRoot":"","sources":["../../src/utils/object.utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,iBAAS,aAAa,CAAC,KAAK,KAAA,OAM3B"}

package/dist/utils/object.utils.js

@@ -1,11 +0,0 @@
-"use strict";
-/**
- * Removes properties with `null` or `undefined` values from each object in the provided array.
- *
- * @param array - An array of objects to process.
- * @returns A new array of objects with all `null` or `undefined` properties removed.
- */
-function removeNullish(array) {
-    return array.map(obj => Object.fromEntries(Object.entries(obj).filter(([key, value]) => value != null)));
-}
-//# sourceMappingURL=object.utils.js.map

package/dist/utils/object.utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"object.utils.js","sourceRoot":"","sources":["../../src/utils/object.utils.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;AACH,SAAS,aAAa,CAAC,KAAK;IAC1B,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CACrB,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,IAAI,IAAI,CAAC,CAC5D,CACF,CAAC;AACJ,CAAC"}