@solid-nestjs/common 0.2.8 → 0.2.9

package/dist/helpers/args-helpers/groupby-args-from.helper.js

@@ -0,0 +1,185 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GroupByArgsFrom = GroupByArgsFrom;
+exports.extractFindArgsMetadata = extractFindArgsMetadata;
+exports.getGroupByArgsMetadata = getGroupByArgsMetadata;
+exports.getGroupByFieldMetadata = getGroupByFieldMetadata;
+exports.isGroupByArgsFromClass = isGroupByArgsFromClass;
+require("reflect-metadata");
+/**
+ * GroupByArgsFrom mixin helper that creates a GroupBy class from a FindArgs constructor.
+ *
+ * This function analyzes the provided FindArgs class and extracts relevant properties
+ * to generate a boolean-based GroupBy class, where each specified field becomes a
+ * boolean property indicating whether to group by that field.
+ *
+ * @template T - The FindArgs type
+ * @param config - Configuration specifying FindArgs type and fields to include
+ * @returns A function that can be used as a mixin base class
+ *
+ * @example
+ * ```typescript
+ * // Define FindArgs class
+ * export class FindProductArgs extends FindArgsFrom({
+ *   whereType: ProductWhere,
+ *   orderByType: ProductOrderBy
+ * }) {}
+ *
+ * // Create GroupBy from FindArgs
+ * const ProductGroupByFromArgs = GroupByArgsFrom({
+ *   findArgsType: FindProductArgs,
+ *   groupByFields: ['category', 'supplier', 'status'],
+ *   className: 'ProductGroupByFromFindArgs'
+ * });
+ *
+ * // Usage in service or resolver
+ * function groupProducts(args: FindProductArgs): ProductGroupByFromArgs {
+ *   return new ProductGroupByFromArgs();
+ * }
+ * ```
+ */
+function GroupByArgsFrom(config) {
+    if (!config.findArgsType) {
+        throw new Error('findArgsType is required in GroupByArgsFromConfig');
+    }
+    if (!config.groupByFields || config.groupByFields.length === 0) {
+        throw new Error('groupByFields array is required and cannot be empty');
+    }
+    // Extract metadata from FindArgs class
+    const findArgsMetadata = extractFindArgsMetadata(config.findArgsType);
+    // Validate that specified fields exist in FindArgs
+    const availableFields = findArgsMetadata.properties.map(p => p.name);
+    const invalidFields = config.groupByFields.filter(field => !availableFields.includes(field));
+    if (invalidFields.length > 0) {
+        throw new Error(`Invalid groupByFields specified: ${invalidFields.join(', ')}. Available fields: ${availableFields.join(', ')}`);
+    }
+    // Generate class name
+    const className = config.className || `${findArgsMetadata.className}GroupBy`;
+    // Create dynamic class
+    const GroupByClass = class {
+        constructor() {
+            // Initialize all group by fields as optional booleans
+            config.groupByFields.forEach(fieldName => {
+                this[fieldName] = undefined;
+            });
+        }
+    };
+    // Set class name for debugging and reflection
+    Object.defineProperty(GroupByClass, 'name', {
+        value: className,
+        configurable: true
+    });
+    // Add metadata for each group by field
+    config.groupByFields.forEach(fieldName => {
+        const originalProperty = findArgsMetadata.properties.find(p => p.name === fieldName);
+        // Set property metadata for TypeScript reflection
+        Reflect.defineMetadata('design:type', Boolean, GroupByClass.prototype, fieldName);
+        // Store custom metadata for the property
+        Reflect.defineMetadata('groupby:field', {
+            originalType: originalProperty?.type,
+            description: originalProperty?.description || `Group by ${fieldName}`,
+            isOptional: true,
+            isGroupBy: true
+        }, GroupByClass.prototype, fieldName);
+    });
+    // Store class-level metadata
+    Reflect.defineMetadata('groupby:config', {
+        sourceClass: config.findArgsType.name,
+        className,
+        description: config.description || `GroupBy fields derived from ${findArgsMetadata.className}`,
+        fields: config.groupByFields,
+        entityType: findArgsMetadata.entityType
+    }, GroupByClass);
+    return GroupByClass;
+}
+/**
+ * Extracts metadata from a FindArgs class for use in GroupBy generation
+ *
+ * @param findArgsType - The FindArgs class to analyze
+ * @returns Extracted metadata including properties and class information
+ */
+function extractFindArgsMetadata(findArgsType) {
+    const className = findArgsType.name;
+    const properties = [];
+    // Get all property names from the class prototype
+    const propertyNames = Object.getOwnPropertyNames(findArgsType.prototype);
+    // Get all metadata keys to find properties with design:type metadata
+    const metadataKeys = Reflect.getMetadataKeys(findArgsType.prototype) || [];
+    const typeMetadataKeys = metadataKeys
+        .filter(key => typeof key === 'string' && key.startsWith('design:type'))
+        .map(key => key);
+    // Find property names from metadata keys
+    const metadataPropertyNames = [];
+    for (const key of typeMetadataKeys) {
+        if (key === 'design:type')
+            continue; // Skip class-level metadata
+        // Get all properties that have design:type metadata
+        const allMetadataKeys = Reflect.getMetadataKeys(findArgsType.prototype);
+        for (const metaKey of allMetadataKeys) {
+            if (typeof metaKey === 'symbol')
+                continue;
+            const parts = metaKey.split(':');
+            if (parts[0] === 'design' && parts[1] === 'type' && parts[2]) {
+                metadataPropertyNames.push(parts[2]);
+            }
+        }
+    }
+    // Get properties that have design:type metadata directly
+    const instance = new findArgsType();
+    const instanceKeys = Object.keys(instance);
+    // Combine all sources of property names
+    const allPropertyNames = Array.from(new Set([
+        ...propertyNames,
+        ...metadataPropertyNames,
+        ...instanceKeys
+    ])).filter(name => name !== 'constructor');
+    // Extract metadata for each property
+    for (const propertyName of allPropertyNames) {
+        const type = Reflect.getMetadata('design:type', findArgsType.prototype, propertyName);
+        if (type || instanceKeys.includes(propertyName)) {
+            properties.push({
+                name: propertyName,
+                type: type || Object, // Default to Object if no type metadata
+                isOptional: true, // Assume optional for GroupBy context
+                description: `Property ${propertyName} from ${className}`
+            });
+        }
+    }
+    // Try to extract entity type if available in class metadata
+    const entityType = Reflect.getMetadata('entity:type', findArgsType) ||
+        Reflect.getMetadata('crud:entity', findArgsType);
+    return {
+        className,
+        properties,
+        entityType
+    };
+}
+/**
+ * Gets the GroupBy configuration metadata from a class created by GroupByArgsFrom
+ *
+ * @param groupByClass - The class created by GroupByArgsFrom
+ * @returns The configuration metadata or undefined if not found
+ */
+function getGroupByArgsMetadata(groupByClass) {
+    return Reflect.getMetadata('groupby:config', groupByClass);
+}
+/**
+ * Gets the field metadata for a specific property in a GroupBy class
+ *
+ * @param groupByClass - The class created by GroupByArgsFrom
+ * @param fieldName - The field name to get metadata for
+ * @returns The field metadata or undefined if not found
+ */
+function getGroupByFieldMetadata(groupByClass, fieldName) {
+    return Reflect.getMetadata('groupby:field', groupByClass.prototype, fieldName);
+}
+/**
+ * Validates that a class was created by GroupByArgsFrom
+ *
+ * @param groupByClass - The class to validate
+ * @returns True if the class was created by GroupByArgsFrom
+ */
+function isGroupByArgsFromClass(groupByClass) {
+    return !!Reflect.getMetadata('groupby:config', groupByClass);
+}
+//# sourceMappingURL=groupby-args-from.helper.js.map

package/dist/helpers/args-helpers/groupby-args-from.helper.js.map

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

package/dist/helpers/args-helpers/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Args Helper Mixins - Core Infrastructure
+ *
+ * This module provides the shared infrastructure for creating helper functions
+ * that reduce boilerplate in DTO creation. These utilities are used by the
+ * package-specific implementations in rest-api, graphql, and rest-graphql packages.
+ */
+export { inferFilterType, inferPlainType, FilterTypeRegistry, setDefaultFilterTypes, // deprecated, use FilterTypeRegistry.register()
+isSupportedPrimitiveType, getReflectedPropertyType, isEnum, getEnumInfo, shouldTreatAsEnum, isRelationType, type FieldConfig, type ParsedFieldConfig } from './type-inference.helper';
+export { parseFieldConfig, parseOrderByConfig, parseGroupByConfig, parseClassOptions, validateFieldConfig, validateClassOptions, type WhereFieldsConfig, type OrderByFieldConfig, type OrderByFieldsConfig, type GroupByFieldConfig, type GroupByFieldsConfig, type ClassOptions, type ParsedClassOptions } from './field-config.helper';
+export { generateBaseClass, addPropertyToClass, getPropertyMetadata, setPropertyMetadata, getDefinedProperties, cloneClass, type ClassGeneratorOptions, type PropertyOptions } from '../class-generation';
+export { applyDecoratorToProperty, applyDecoratorsToProperty, applyDecoratorToClass, applyDecoratorsToClass } from '../decorators';
+export { BaseDecoratorBuilder, DecoratorUtils, DecoratorBuilderRegistry, addLogicalOperators, type DecoratorConfig, type DecoratorBuilder, type DecoratorBuilderFactory } from './decorator-builder.helper';
+export { GroupByArgsFrom, extractFindArgsMetadata, getGroupByArgsMetadata, getGroupByFieldMetadata, isGroupByArgsFromClass, type GroupByArgsFromConfig, type FindArgsMetadata } from './groupby-args-from.helper';
+//# sourceMappingURL=index.d.ts.map

package/dist/helpers/args-helpers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/helpers/args-helpers/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EAAE,gDAAgD;AACvE,wBAAwB,EACxB,wBAAwB,EACxB,MAAM,EACN,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACvB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACxB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,UAAU,EACV,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACrB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,wBAAwB,EACxB,mBAAmB,EACnB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC7B,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACtB,MAAM,4BAA4B,CAAC"}

package/dist/helpers/args-helpers/index.js

@@ -0,0 +1,58 @@
+"use strict";
+/**
+ * Args Helper Mixins - Core Infrastructure
+ *
+ * This module provides the shared infrastructure for creating helper functions
+ * that reduce boilerplate in DTO creation. These utilities are used by the
+ * package-specific implementations in rest-api, graphql, and rest-graphql packages.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isGroupByArgsFromClass = exports.getGroupByFieldMetadata = exports.getGroupByArgsMetadata = exports.extractFindArgsMetadata = exports.GroupByArgsFrom = exports.addLogicalOperators = exports.DecoratorBuilderRegistry = exports.DecoratorUtils = exports.BaseDecoratorBuilder = exports.applyDecoratorsToClass = exports.applyDecoratorToClass = exports.applyDecoratorsToProperty = exports.applyDecoratorToProperty = exports.cloneClass = exports.getDefinedProperties = exports.setPropertyMetadata = exports.getPropertyMetadata = exports.addPropertyToClass = exports.generateBaseClass = exports.validateClassOptions = exports.validateFieldConfig = exports.parseClassOptions = exports.parseGroupByConfig = exports.parseOrderByConfig = exports.parseFieldConfig = exports.isRelationType = exports.shouldTreatAsEnum = exports.getEnumInfo = exports.isEnum = exports.getReflectedPropertyType = exports.isSupportedPrimitiveType = exports.setDefaultFilterTypes = exports.FilterTypeRegistry = exports.inferPlainType = exports.inferFilterType = void 0;
+// Type inference utilities
+var type_inference_helper_1 = require("./type-inference.helper");
+Object.defineProperty(exports, "inferFilterType", { enumerable: true, get: function () { return type_inference_helper_1.inferFilterType; } });
+Object.defineProperty(exports, "inferPlainType", { enumerable: true, get: function () { return type_inference_helper_1.inferPlainType; } });
+Object.defineProperty(exports, "FilterTypeRegistry", { enumerable: true, get: function () { return type_inference_helper_1.FilterTypeRegistry; } });
+Object.defineProperty(exports, "setDefaultFilterTypes", { enumerable: true, get: function () { return type_inference_helper_1.setDefaultFilterTypes; } });
+Object.defineProperty(exports, "isSupportedPrimitiveType", { enumerable: true, get: function () { return type_inference_helper_1.isSupportedPrimitiveType; } });
+Object.defineProperty(exports, "getReflectedPropertyType", { enumerable: true, get: function () { return type_inference_helper_1.getReflectedPropertyType; } });
+Object.defineProperty(exports, "isEnum", { enumerable: true, get: function () { return type_inference_helper_1.isEnum; } });
+Object.defineProperty(exports, "getEnumInfo", { enumerable: true, get: function () { return type_inference_helper_1.getEnumInfo; } });
+Object.defineProperty(exports, "shouldTreatAsEnum", { enumerable: true, get: function () { return type_inference_helper_1.shouldTreatAsEnum; } });
+Object.defineProperty(exports, "isRelationType", { enumerable: true, get: function () { return type_inference_helper_1.isRelationType; } });
+// Field configuration utilities
+var field_config_helper_1 = require("./field-config.helper");
+Object.defineProperty(exports, "parseFieldConfig", { enumerable: true, get: function () { return field_config_helper_1.parseFieldConfig; } });
+Object.defineProperty(exports, "parseOrderByConfig", { enumerable: true, get: function () { return field_config_helper_1.parseOrderByConfig; } });
+Object.defineProperty(exports, "parseGroupByConfig", { enumerable: true, get: function () { return field_config_helper_1.parseGroupByConfig; } });
+Object.defineProperty(exports, "parseClassOptions", { enumerable: true, get: function () { return field_config_helper_1.parseClassOptions; } });
+Object.defineProperty(exports, "validateFieldConfig", { enumerable: true, get: function () { return field_config_helper_1.validateFieldConfig; } });
+Object.defineProperty(exports, "validateClassOptions", { enumerable: true, get: function () { return field_config_helper_1.validateClassOptions; } });
+// Re-export class generation utilities from the common location
+var class_generation_1 = require("../class-generation");
+Object.defineProperty(exports, "generateBaseClass", { enumerable: true, get: function () { return class_generation_1.generateBaseClass; } });
+Object.defineProperty(exports, "addPropertyToClass", { enumerable: true, get: function () { return class_generation_1.addPropertyToClass; } });
+Object.defineProperty(exports, "getPropertyMetadata", { enumerable: true, get: function () { return class_generation_1.getPropertyMetadata; } });
+Object.defineProperty(exports, "setPropertyMetadata", { enumerable: true, get: function () { return class_generation_1.setPropertyMetadata; } });
+Object.defineProperty(exports, "getDefinedProperties", { enumerable: true, get: function () { return class_generation_1.getDefinedProperties; } });
+Object.defineProperty(exports, "cloneClass", { enumerable: true, get: function () { return class_generation_1.cloneClass; } });
+// Re-export decorator utilities from the common location
+var decorators_1 = require("../decorators");
+Object.defineProperty(exports, "applyDecoratorToProperty", { enumerable: true, get: function () { return decorators_1.applyDecoratorToProperty; } });
+Object.defineProperty(exports, "applyDecoratorsToProperty", { enumerable: true, get: function () { return decorators_1.applyDecoratorsToProperty; } });
+Object.defineProperty(exports, "applyDecoratorToClass", { enumerable: true, get: function () { return decorators_1.applyDecoratorToClass; } });
+Object.defineProperty(exports, "applyDecoratorsToClass", { enumerable: true, get: function () { return decorators_1.applyDecoratorsToClass; } });
+// Decorator building utilities (args-helpers specific)
+var decorator_builder_helper_1 = require("./decorator-builder.helper");
+Object.defineProperty(exports, "BaseDecoratorBuilder", { enumerable: true, get: function () { return decorator_builder_helper_1.BaseDecoratorBuilder; } });
+Object.defineProperty(exports, "DecoratorUtils", { enumerable: true, get: function () { return decorator_builder_helper_1.DecoratorUtils; } });
+Object.defineProperty(exports, "DecoratorBuilderRegistry", { enumerable: true, get: function () { return decorator_builder_helper_1.DecoratorBuilderRegistry; } });
+Object.defineProperty(exports, "addLogicalOperators", { enumerable: true, get: function () { return decorator_builder_helper_1.addLogicalOperators; } });
+// GroupByArgsFrom mixin utilities
+var groupby_args_from_helper_1 = require("./groupby-args-from.helper");
+Object.defineProperty(exports, "GroupByArgsFrom", { enumerable: true, get: function () { return groupby_args_from_helper_1.GroupByArgsFrom; } });
+Object.defineProperty(exports, "extractFindArgsMetadata", { enumerable: true, get: function () { return groupby_args_from_helper_1.extractFindArgsMetadata; } });
+Object.defineProperty(exports, "getGroupByArgsMetadata", { enumerable: true, get: function () { return groupby_args_from_helper_1.getGroupByArgsMetadata; } });
+Object.defineProperty(exports, "getGroupByFieldMetadata", { enumerable: true, get: function () { return groupby_args_from_helper_1.getGroupByFieldMetadata; } });
+Object.defineProperty(exports, "isGroupByArgsFromClass", { enumerable: true, get: function () { return groupby_args_from_helper_1.isGroupByArgsFromClass; } });
+//# sourceMappingURL=index.js.map

package/dist/helpers/args-helpers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/helpers/args-helpers/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,2BAA2B;AAC3B,iEAaiC;AAZ/B,wHAAA,eAAe,OAAA;AACf,uHAAA,cAAc,OAAA;AACd,2HAAA,kBAAkB,OAAA;AAClB,8HAAA,qBAAqB,OAAA;AACrB,iIAAA,wBAAwB,OAAA;AACxB,iIAAA,wBAAwB,OAAA;AACxB,+GAAA,MAAM,OAAA;AACN,oHAAA,WAAW,OAAA;AACX,0HAAA,iBAAiB,OAAA;AACjB,uHAAA,cAAc,OAAA;AAKhB,gCAAgC;AAChC,6DAc+B;AAb7B,uHAAA,gBAAgB,OAAA;AAChB,yHAAA,kBAAkB,OAAA;AAClB,yHAAA,kBAAkB,OAAA;AAClB,wHAAA,iBAAiB,OAAA;AACjB,0HAAA,mBAAmB,OAAA;AACnB,2HAAA,oBAAoB,OAAA;AAUtB,gEAAgE;AAChE,wDAS6B;AAR3B,qHAAA,iBAAiB,OAAA;AACjB,sHAAA,kBAAkB,OAAA;AAClB,uHAAA,mBAAmB,OAAA;AACnB,uHAAA,mBAAmB,OAAA;AACnB,wHAAA,oBAAoB,OAAA;AACpB,8GAAA,UAAU,OAAA;AAKZ,yDAAyD;AACzD,4CAKuB;AAJrB,sHAAA,wBAAwB,OAAA;AACxB,uHAAA,yBAAyB,OAAA;AACzB,mHAAA,qBAAqB,OAAA;AACrB,oHAAA,sBAAsB,OAAA;AAGxB,uDAAuD;AACvD,uEAQoC;AAPlC,gIAAA,oBAAoB,OAAA;AACpB,0HAAA,cAAc,OAAA;AACd,oIAAA,wBAAwB,OAAA;AACxB,+HAAA,mBAAmB,OAAA;AAMrB,kCAAkC;AAClC,uEAQoC;AAPlC,2HAAA,eAAe,OAAA;AACf,mIAAA,uBAAuB,OAAA;AACvB,kIAAA,sBAAsB,OAAA;AACtB,mIAAA,uBAAuB,OAAA;AACvB,kIAAA,sBAAsB,OAAA"}

package/dist/helpers/args-helpers/type-inference.helper.d.ts

@@ -0,0 +1,191 @@
+import { Type } from '@nestjs/common';
+import 'reflect-metadata';
+/**
+ * Configuration for a field in the helper functions
+ */
+export type FieldConfig = true | Type<any> | {
+    type?: Type<any>;
+    isPlain?: boolean;
+    description?: string;
+    required?: boolean;
+    example?: any;
+    deprecated?: boolean;
+    enum?: any;
+    enumName?: string;
+    isRelation?: boolean;
+};
+/**
+ * Parsed field configuration with normalized values
+ */
+export interface ParsedFieldConfig {
+    type?: Type<any>;
+    isPlain?: boolean;
+    description?: string;
+    required?: boolean;
+    example?: any;
+    deprecated?: boolean;
+    enum?: any;
+    enumName?: string;
+    isRelation?: boolean;
+}
+/**
+ * Infers the appropriate plain type (String, Number, Date) for an entity property.
+ * Used when isPlain: true is specified in the field configuration.
+ *
+ * @template T - The entity type
+ * @param entity - The entity class constructor
+ * @param propertyName - The name of the property to infer type for
+ * @returns The plain type class constructor (String, Number, Date, Boolean)
+ *
+ * @example
+ * ```typescript
+ * class Product {
+ *   name: string;    // Will infer String
+ *   price: number;   // Will infer Number
+ *   createdAt: Date; // Will infer Date
+ *   isActive: boolean; // Will infer Boolean
+ * }
+ *
+ * const nameType = inferPlainType(Product, 'name'); // String
+ * const priceType = inferPlainType(Product, 'price'); // Number
+ * ```
+ */
+export declare function inferPlainType(entity: Type<any>, propertyName: string): Type<any>;
+/**
+ * Infers the appropriate filter type for an entity property based on its TypeScript type.
+ * Uses reflection to determine the property type and maps it to the corresponding filter type.
+ *
+ * @template T - The entity type
+ * @param entity - The entity class constructor
+ * @param propertyName - The name of the property to infer type for
+ * @param config - Optional field configuration that may override the inferred type
+ * @returns The filter type class constructor
+ *
+ * @example
+ * ```typescript
+ * class Product {
+ *   name: string;    // Will infer StringFilter
+ *   price: number;   // Will infer NumberFilter
+ *   createdAt: Date; // Will infer DateFilter
+ *   isActive: boolean; // Will return Boolean
+ * }
+ *
+ * const nameFilterType = inferFilterType(Product, 'name'); // StringFilter
+ * const priceFilterType = inferFilterType(Product, 'price'); // NumberFilter
+ * ```
+ */
+export declare function inferFilterType(entity: Type<any>, propertyName: string, config?: FieldConfig): Type<any>;
+/**
+ * Checks if a given type appears to be a relation type (Where/OrderBy/GroupBy class)
+ * by examining the class name patterns commonly used in the framework
+ *
+ * @param type - The type to check
+ * @returns True if it appears to be a relation type
+ */
+export declare function isRelationType(type: Type<any>): boolean;
+/**
+ * Registry for filter types that can be set by each package
+ */
+declare class FilterTypeRegistry {
+    private static stringFilter?;
+    private static numberFilter?;
+    private static dateFilter?;
+    /**
+     * Registers filter types for the current package context
+     *
+     * @param types - Object containing the filter type constructors
+     */
+    static register(types: {
+        StringFilter: Type<any>;
+        NumberFilter: Type<any>;
+        DateFilter: Type<any>;
+    }): void;
+    /**
+     * Gets the registered StringFilter type
+     *
+     * @returns The StringFilter type constructor
+     * @throws Error if not registered
+     */
+    static getStringFilter(): Type<any>;
+    /**
+     * Gets the registered NumberFilter type
+     *
+     * @returns The NumberFilter type constructor
+     * @throws Error if not registered
+     */
+    static getNumberFilter(): Type<any>;
+    /**
+     * Gets the registered DateFilter type
+     *
+     * @returns The DateFilter type constructor
+     * @throws Error if not registered
+     */
+    static getDateFilter(): Type<any>;
+    /**
+     * Checks if filter types are registered
+     *
+     * @returns True if all filter types are registered
+     */
+    static isRegistered(): boolean;
+    /**
+     * Clears all registered filter types (mainly for testing)
+     */
+    static clear(): void;
+}
+/**
+ * Sets the default filter types for the type inference system.
+ * This should be called by each package (rest-api, graphql, rest-graphql)
+ * during initialization to provide the appropriate filter types.
+ *
+ * @param filterTypes - Object containing the filter type constructors
+ * @deprecated Use FilterTypeRegistry.register() instead
+ */
+export declare function setDefaultFilterTypes(filterTypes: {
+    StringFilter: Type<any>;
+    NumberFilter: Type<any>;
+    DateFilter: Type<any>;
+}): void;
+export { FilterTypeRegistry };
+/**
+ * Checks if a given type is a primitive type that can be auto-inferred
+ *
+ * @param type - The type to check
+ * @returns True if the type is a supported primitive
+ */
+export declare function isSupportedPrimitiveType(type: any): boolean;
+/**
+ * Gets the property type using reflection
+ *
+ * @param entity - The entity class
+ * @param propertyName - The property name
+ * @returns The reflected type or undefined if not found
+ */
+export declare function getReflectedPropertyType(entity: Type<any>, propertyName: string): any;
+/**
+ * Checks if a given type appears to be an enum
+ *
+ * @param type - The type to check
+ * @returns True if the type appears to be an enum
+ */
+export declare function isEnum(type: any): boolean;
+/**
+ * Extracts enum information for use in decorators
+ *
+ * @param enumObject - The enum object
+ * @returns Information about the enum
+ */
+export declare function getEnumInfo(enumObject: any): {
+    values: any[];
+    example: any;
+    description: string;
+};
+/**
+ * Determines if a field should be treated as an enum field
+ *
+ * @param entity - The entity class
+ * @param propertyName - The property name
+ * @param config - Field configuration
+ * @returns True if it should be treated as enum
+ */
+export declare function shouldTreatAsEnum(entity: Type<any>, propertyName: string, config?: FieldConfig): boolean;
+//# sourceMappingURL=type-inference.helper.d.ts.map

package/dist/helpers/args-helpers/type-inference.helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-inference.helper.d.ts","sourceRoot":"","sources":["../../../src/helpers/args-helpers/type-inference.helper.ts"],"names":[],"mappings":"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"}