@solid-nestjs/common 0.2.6 → 0.2.9

package/dist/helpers/args-helpers/decorator-builder.helper.d.ts

@@ -0,0 +1,160 @@
+import { Type } from '@nestjs/common';
+import 'reflect-metadata';
+/**
+ * Common decorator configuration interface
+ */
+export interface DecoratorConfig {
+    description?: string;
+    required?: boolean;
+    example?: any;
+    deprecated?: boolean;
+}
+/**
+ * Interface for decorator builders that create property decorators
+ */
+export interface DecoratorBuilder {
+    /**
+     * Creates validation decorators for a property
+     */
+    createValidationDecorators(config: DecoratorConfig): PropertyDecorator[];
+    /**
+     * Creates type transformation decorators
+     */
+    createTransformDecorators(type: Type<any>, config: DecoratorConfig): PropertyDecorator[];
+    /**
+     * Creates documentation decorators (Swagger/GraphQL)
+     */
+    createDocumentationDecorators(type: Type<any>, config: DecoratorConfig): PropertyDecorator[];
+    /**
+     * Creates all decorators for a property and applies them to the target class
+     */
+    applyAllDecorators(targetClass: Type<any>, propertyName: string, type: Type<any>, config: DecoratorConfig): void;
+}
+/**
+ * Base decorator builder with common validation decorators
+ */
+export declare abstract class BaseDecoratorBuilder implements DecoratorBuilder {
+    abstract createValidationDecorators(config: DecoratorConfig): PropertyDecorator[];
+    abstract createTransformDecorators(type: Type<any>, config: DecoratorConfig): PropertyDecorator[];
+    abstract createDocumentationDecorators(type: Type<any>, config: DecoratorConfig): PropertyDecorator[];
+    /**
+     * Creates all decorators for a property and applies them to the target class
+     *
+     * @param targetClass - The class to apply decorators to
+     * @param propertyName - The property name
+     * @param type - The property type
+     * @param config - Decorator configuration
+     */
+    applyAllDecorators(targetClass: Type<any>, propertyName: string, type: Type<any>, config: DecoratorConfig): void;
+    /**
+     * Creates common validation decorators that are used across all packages
+     *
+     * @param config - Configuration for the decorators
+     * @returns Array of common validation decorators
+     */
+    protected createCommonValidationDecorators(config: DecoratorConfig): PropertyDecorator[];
+    /**
+     * Creates common transformation decorators
+     *
+     * @param type - The property type
+     * @param config - Configuration for the decorators
+     * @returns Array of transformation decorators
+     */
+    protected createCommonTransformDecorators(type: Type<any>, config: DecoratorConfig): PropertyDecorator[];
+}
+/**
+ * Utility functions for working with decorators
+ */
+export declare class DecoratorUtils {
+    /**
+     * Checks if a decorator has already been applied to a property
+     *
+     * @param targetClass - The class to check
+     * @param propertyName - The property name
+     * @param decoratorKey - The metadata key to look for
+     * @returns True if the decorator has been applied
+     */
+    static hasDecorator(targetClass: Type<any>, propertyName: string, decoratorKey: string): boolean;
+    /**
+     * Gets decorator metadata for a property
+     *
+     * @param targetClass - The class to get metadata from
+     * @param propertyName - The property name
+     * @param decoratorKey - The metadata key
+     * @returns The decorator metadata
+     */
+    static getDecoratorMetadata(targetClass: Type<any>, propertyName: string, decoratorKey: string): any;
+    /**
+     * Sets decorator metadata for a property
+     *
+     * @param targetClass - The class to set metadata on
+     * @param propertyName - The property name
+     * @param decoratorKey - The metadata key
+     * @param metadata - The metadata to set
+     */
+    static setDecoratorMetadata(targetClass: Type<any>, propertyName: string, decoratorKey: string, metadata: any): void;
+    /**
+     * Merges decorator metadata with existing metadata
+     *
+     * @param targetClass - The class to merge metadata on
+     * @param propertyName - The property name
+     * @param decoratorKey - The metadata key
+     * @param newMetadata - The new metadata to merge
+     */
+    static mergeDecoratorMetadata(targetClass: Type<any>, propertyName: string, decoratorKey: string, newMetadata: any): void;
+}
+/**
+ * Factory function for creating decorator builders
+ * This will be implemented by each package (rest-api, graphql, rest-graphql)
+ */
+export interface DecoratorBuilderFactory {
+    /**
+     * Creates a decorator builder for WhereFields
+     */
+    createWhereFieldsDecoratorBuilder(): DecoratorBuilder;
+    /**
+     * Creates a decorator builder for OrderByFields
+     */
+    createOrderByFieldsDecoratorBuilder(): DecoratorBuilder;
+    /**
+     * Creates a decorator builder for GroupByFields
+     */
+    createGroupByFieldsDecoratorBuilder(): DecoratorBuilder;
+}
+/**
+ * Registry for decorator builder factories
+ * Each package will register its factory here
+ */
+export declare class DecoratorBuilderRegistry {
+    private static factories;
+    /**
+     * Registers a decorator builder factory for a package
+     *
+     * @param packageName - Name of the package (e.g., 'rest-api', 'graphql', 'rest-graphql')
+     * @param factory - The factory instance
+     */
+    static registerFactory(packageName: string, factory: DecoratorBuilderFactory): void;
+    /**
+     * Gets a decorator builder factory for a package
+     *
+     * @param packageName - Name of the package
+     * @returns The factory instance or undefined if not found
+     */
+    static getFactory(packageName: string): DecoratorBuilderFactory | undefined;
+    /**
+     * Gets all registered package names
+     *
+     * @returns Array of registered package names
+     */
+    static getRegisteredPackages(): string[];
+}
+/**
+ * Applies logical operator fields (_and, _or) to a WhereFields class
+ * This is common functionality used across all packages
+ *
+ * @param targetClass - The WhereFields class to add operators to
+ * @param decoratorBuilder - The decorator builder to use
+ * @param className - The class name for nested types
+ */
+export declare function addLogicalOperators(targetClass: Type<any>, decoratorBuilder: DecoratorBuilder, className: string): void;
+//# sourceMappingURL=decorator-builder.helper.d.ts.map

package/dist/helpers/args-helpers/decorator-builder.helper.d.ts.map

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

package/dist/helpers/args-helpers/decorator-builder.helper.js

@@ -0,0 +1,161 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DecoratorBuilderRegistry = exports.DecoratorUtils = exports.BaseDecoratorBuilder = void 0;
+exports.addLogicalOperators = addLogicalOperators;
+const decorators_1 = require("../decorators");
+require("reflect-metadata");
+/**
+ * Base decorator builder with common validation decorators
+ */
+class BaseDecoratorBuilder {
+    /**
+     * Creates all decorators for a property and applies them to the target class
+     *
+     * @param targetClass - The class to apply decorators to
+     * @param propertyName - The property name
+     * @param type - The property type
+     * @param config - Decorator configuration
+     */
+    applyAllDecorators(targetClass, propertyName, type, config) {
+        const decorators = [
+            ...this.createValidationDecorators(config),
+            ...this.createTransformDecorators(type, config),
+            ...this.createDocumentationDecorators(type, config)
+        ];
+        for (const decorator of decorators) {
+            (0, decorators_1.applyDecoratorToProperty)(decorator, targetClass, propertyName);
+        }
+    }
+    /**
+     * Creates common validation decorators that are used across all packages
+     *
+     * @param config - Configuration for the decorators
+     * @returns Array of common validation decorators
+     */
+    createCommonValidationDecorators(config) {
+        const decorators = [];
+        // These will be imported from class-validator in the specific implementations
+        // For now, we'll return an empty array and let the package-specific implementations handle this
+        return decorators;
+    }
+    /**
+     * Creates common transformation decorators
+     *
+     * @param type - The property type
+     * @param config - Configuration for the decorators
+     * @returns Array of transformation decorators
+     */
+    createCommonTransformDecorators(type, config) {
+        const decorators = [];
+        // Type transformation decorators will be handled by package-specific implementations
+        return decorators;
+    }
+}
+exports.BaseDecoratorBuilder = BaseDecoratorBuilder;
+/**
+ * Utility functions for working with decorators
+ */
+class DecoratorUtils {
+    /**
+     * Checks if a decorator has already been applied to a property
+     *
+     * @param targetClass - The class to check
+     * @param propertyName - The property name
+     * @param decoratorKey - The metadata key to look for
+     * @returns True if the decorator has been applied
+     */
+    static hasDecorator(targetClass, propertyName, decoratorKey) {
+        return Reflect.hasMetadata(decoratorKey, targetClass.prototype, propertyName);
+    }
+    /**
+     * Gets decorator metadata for a property
+     *
+     * @param targetClass - The class to get metadata from
+     * @param propertyName - The property name
+     * @param decoratorKey - The metadata key
+     * @returns The decorator metadata
+     */
+    static getDecoratorMetadata(targetClass, propertyName, decoratorKey) {
+        return Reflect.getMetadata(decoratorKey, targetClass.prototype, propertyName);
+    }
+    /**
+     * Sets decorator metadata for a property
+     *
+     * @param targetClass - The class to set metadata on
+     * @param propertyName - The property name
+     * @param decoratorKey - The metadata key
+     * @param metadata - The metadata to set
+     */
+    static setDecoratorMetadata(targetClass, propertyName, decoratorKey, metadata) {
+        Reflect.defineMetadata(decoratorKey, metadata, targetClass.prototype, propertyName);
+    }
+    /**
+     * Merges decorator metadata with existing metadata
+     *
+     * @param targetClass - The class to merge metadata on
+     * @param propertyName - The property name
+     * @param decoratorKey - The metadata key
+     * @param newMetadata - The new metadata to merge
+     */
+    static mergeDecoratorMetadata(targetClass, propertyName, decoratorKey, newMetadata) {
+        const existing = this.getDecoratorMetadata(targetClass, propertyName, decoratorKey) || {};
+        const merged = { ...existing, ...newMetadata };
+        this.setDecoratorMetadata(targetClass, propertyName, decoratorKey, merged);
+    }
+}
+exports.DecoratorUtils = DecoratorUtils;
+/**
+ * Registry for decorator builder factories
+ * Each package will register its factory here
+ */
+class DecoratorBuilderRegistry {
+    /**
+     * Registers a decorator builder factory for a package
+     *
+     * @param packageName - Name of the package (e.g., 'rest-api', 'graphql', 'rest-graphql')
+     * @param factory - The factory instance
+     */
+    static registerFactory(packageName, factory) {
+        this.factories.set(packageName, factory);
+    }
+    /**
+     * Gets a decorator builder factory for a package
+     *
+     * @param packageName - Name of the package
+     * @returns The factory instance or undefined if not found
+     */
+    static getFactory(packageName) {
+        return this.factories.get(packageName);
+    }
+    /**
+     * Gets all registered package names
+     *
+     * @returns Array of registered package names
+     */
+    static getRegisteredPackages() {
+        return Array.from(this.factories.keys());
+    }
+}
+exports.DecoratorBuilderRegistry = DecoratorBuilderRegistry;
+DecoratorBuilderRegistry.factories = new Map();
+/**
+ * Applies logical operator fields (_and, _or) to a WhereFields class
+ * This is common functionality used across all packages
+ *
+ * @param targetClass - The WhereFields class to add operators to
+ * @param decoratorBuilder - The decorator builder to use
+ * @param className - The class name for nested types
+ */
+function addLogicalOperators(targetClass, decoratorBuilder, className) {
+    // Add _and field (array of same type)
+    decoratorBuilder.applyAllDecorators(targetClass, '_and', Array, {
+        description: `Logical AND conditions for ${className}`,
+        required: false
+    });
+    // Add _or field (array of same type)
+    decoratorBuilder.applyAllDecorators(targetClass, '_or', Array, {
+        description: `Logical OR conditions for ${className}`,
+        required: false
+    });
+}
+//# sourceMappingURL=decorator-builder.helper.js.map

package/dist/helpers/args-helpers/decorator-builder.helper.js.map

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

package/dist/helpers/args-helpers/field-config.helper.d.ts

@@ -0,0 +1,98 @@
+import { Type } from '@nestjs/common';
+import { FieldConfig, ParsedFieldConfig } from './type-inference.helper';
+/**
+ * Configuration types for different helper functions
+ */
+export type WhereFieldsConfig<T> = {
+    [K in keyof T]?: FieldConfig;
+} & {
+    [relationName: string]: FieldConfig;
+};
+export type OrderByFieldConfig = true | Type<any> | {
+    description?: string;
+    required?: boolean;
+    type?: Type<any>;
+};
+export type OrderByFieldsConfig<T> = {
+    [K in keyof T]?: OrderByFieldConfig;
+} & {
+    [relationName: string]: OrderByFieldConfig;
+};
+export type GroupByFieldConfig = true | Type<any> | {
+    description?: string;
+    required?: boolean;
+    type?: Type<any>;
+};
+export type GroupByFieldsConfig<T> = {
+    [K in keyof T]?: GroupByFieldConfig;
+} & {
+    [relationName: string]: GroupByFieldConfig;
+};
+/**
+ * Options for configuring the generated class
+ */
+export interface ClassOptions {
+    name?: string;
+    description?: string;
+    isAbstract?: boolean;
+    decorators?: ClassDecorator[];
+    metadata?: Record<string, any>;
+    extends?: Type<any>;
+}
+/**
+ * Parsed class options with default values
+ */
+export interface ParsedClassOptions {
+    name: string;
+    description?: string;
+    isAbstract: boolean;
+    decorators: ClassDecorator[];
+    metadata: Record<string, any>;
+    extends?: Type<any>;
+}
+/**
+ * Parses field configuration into a normalized format
+ *
+ * @param config - Raw field configuration
+ * @returns Parsed configuration with defaults
+ */
+export declare function parseFieldConfig(config: FieldConfig): ParsedFieldConfig;
+/**
+ * Parses OrderBy field configuration
+ *
+ * @param config - Raw OrderBy field configuration
+ * @returns Parsed configuration
+ */
+export declare function parseOrderByConfig(config: OrderByFieldConfig): ParsedFieldConfig;
+/**
+ * Parses GroupBy field configuration
+ *
+ * @param config - Raw GroupBy field configuration
+ * @returns Parsed configuration
+ */
+export declare function parseGroupByConfig(config: GroupByFieldConfig): ParsedFieldConfig;
+/**
+ * Parses class options with defaults
+ *
+ * @param entityName - Name of the entity for default naming
+ * @param suffix - Suffix for the class name (e.g., 'WhereFields')
+ * @param options - Raw class options
+ * @returns Parsed options with defaults
+ */
+export declare function parseClassOptions(entityName: string, suffix: string, options?: ClassOptions): ParsedClassOptions;
+/**
+ * Validates that a field configuration object is valid
+ *
+ * @param config - Configuration to validate
+ * @param fieldName - Name of the field (for error messages)
+ * @throws Error if configuration is invalid
+ */
+export declare function validateFieldConfig(config: any, fieldName: string): void;
+/**
+ * Validates class options
+ *
+ * @param options - Options to validate
+ * @throws Error if options are invalid
+ */
+export declare function validateClassOptions(options: ClassOptions): void;
+//# sourceMappingURL=field-config.helper.d.ts.map

package/dist/helpers/args-helpers/field-config.helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-config.helper.d.ts","sourceRoot":"","sources":["../../../src/helpers/args-helpers/field-config.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEzE;;GAEG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI;KAChC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW;CAC7B,GAAG;IAEF,CAAC,YAAY,EAAE,MAAM,GAAG,WAAW,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAC1B,IAAI,GACJ,IAAI,CAAC,GAAG,CAAC,GACT;IACE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;CAClB,CAAC;AAEN,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI;KAClC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,kBAAkB;CACpC,GAAG;IAEF,CAAC,YAAY,EAAE,MAAM,GAAG,kBAAkB,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAC1B,IAAI,GACJ,IAAI,CAAC,GAAG,CAAC,GACT;IACE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;CAClB,CAAC;AAEN,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI;KAClC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,kBAAkB;CACpC,GAAG;IAEF,CAAC,YAAY,EAAE,MAAM,GAAG,kBAAkB,CAAC;CAC5C,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,OAAO,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,iBAAiB,CAcvE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,iBAAiB,CAchF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,iBAAiB,CAchF;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,YAAY,GACrB,kBAAkB,CASpB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAoCxE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAwBhE"}

package/dist/helpers/args-helpers/field-config.helper.js

@@ -0,0 +1,143 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseFieldConfig = parseFieldConfig;
+exports.parseOrderByConfig = parseOrderByConfig;
+exports.parseGroupByConfig = parseGroupByConfig;
+exports.parseClassOptions = parseClassOptions;
+exports.validateFieldConfig = validateFieldConfig;
+exports.validateClassOptions = validateClassOptions;
+/**
+ * Parses field configuration into a normalized format
+ *
+ * @param config - Raw field configuration
+ * @returns Parsed configuration with defaults
+ */
+function parseFieldConfig(config) {
+    if (config === true) {
+        return {};
+    }
+    if (typeof config === 'function') {
+        return { type: config };
+    }
+    if (typeof config === 'object' && config !== null) {
+        return { ...config };
+    }
+    throw new Error(`Invalid field configuration: ${config}`);
+}
+/**
+ * Parses OrderBy field configuration
+ *
+ * @param config - Raw OrderBy field configuration
+ * @returns Parsed configuration
+ */
+function parseOrderByConfig(config) {
+    if (config === true) {
+        return {};
+    }
+    if (typeof config === 'function') {
+        return { type: config };
+    }
+    if (typeof config === 'object' && config !== null) {
+        return { ...config };
+    }
+    throw new Error(`Invalid OrderBy field configuration: ${config}`);
+}
+/**
+ * Parses GroupBy field configuration
+ *
+ * @param config - Raw GroupBy field configuration
+ * @returns Parsed configuration
+ */
+function parseGroupByConfig(config) {
+    if (config === true) {
+        return { type: Boolean };
+    }
+    if (typeof config === 'function') {
+        return { type: config };
+    }
+    if (typeof config === 'object' && config !== null) {
+        return { ...config };
+    }
+    throw new Error(`Invalid GroupBy field configuration: ${config}`);
+}
+/**
+ * Parses class options with defaults
+ *
+ * @param entityName - Name of the entity for default naming
+ * @param suffix - Suffix for the class name (e.g., 'WhereFields')
+ * @param options - Raw class options
+ * @returns Parsed options with defaults
+ */
+function parseClassOptions(entityName, suffix, options) {
+    return {
+        name: options?.name || `${entityName}${suffix}`,
+        description: options?.description,
+        isAbstract: options?.isAbstract ?? true,
+        decorators: options?.decorators || [],
+        metadata: options?.metadata || {},
+        extends: options?.extends
+    };
+}
+/**
+ * Validates that a field configuration object is valid
+ *
+ * @param config - Configuration to validate
+ * @param fieldName - Name of the field (for error messages)
+ * @throws Error if configuration is invalid
+ */
+function validateFieldConfig(config, fieldName) {
+    if (config === undefined || config === null) {
+        throw new Error(`Field configuration for '${fieldName}' cannot be null or undefined`);
+    }
+    if (config === true) {
+        return; // Valid simple configuration
+    }
+    if (typeof config === 'function') {
+        return; // Valid type configuration
+    }
+    if (typeof config === 'object') {
+        // Validate object configuration
+        const validKeys = ['type', 'isPlain', 'description', 'required', 'example', 'deprecated', 'enum', 'enumName', 'isRelation'];
+        const configKeys = Object.keys(config);
+        for (const key of configKeys) {
+            if (!validKeys.includes(key)) {
+                throw new Error(`Invalid configuration key '${key}' for field '${fieldName}'. Valid keys: ${validKeys.join(', ')}`);
+            }
+        }
+        if (config.type && typeof config.type !== 'function') {
+            throw new Error(`Type for field '${fieldName}' must be a class constructor`);
+        }
+        if (config.enumName && typeof config.enumName !== 'string') {
+            throw new Error(`enumName for field '${fieldName}' must be a string`);
+        }
+        return;
+    }
+    throw new Error(`Invalid configuration type for field '${fieldName}'. Expected: true, Type<any>, or configuration object`);
+}
+/**
+ * Validates class options
+ *
+ * @param options - Options to validate
+ * @throws Error if options are invalid
+ */
+function validateClassOptions(options) {
+    if (options.name && typeof options.name !== 'string') {
+        throw new Error('Class name must be a string');
+    }
+    if (options.description && typeof options.description !== 'string') {
+        throw new Error('Class description must be a string');
+    }
+    if (options.isAbstract !== undefined && typeof options.isAbstract !== 'boolean') {
+        throw new Error('isAbstract option must be a boolean');
+    }
+    if (options.decorators && !Array.isArray(options.decorators)) {
+        throw new Error('decorators option must be an array');
+    }
+    if (options.metadata && typeof options.metadata !== 'object') {
+        throw new Error('metadata option must be an object');
+    }
+    if (options.extends && typeof options.extends !== 'function') {
+        throw new Error('extends option must be a class constructor');
+    }
+}
+//# sourceMappingURL=field-config.helper.js.map

package/dist/helpers/args-helpers/field-config.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-config.helper.js","sourceRoot":"","sources":["../../../src/helpers/args-helpers/field-config.helper.ts"],"names":[],"mappings":";;AA2EA,4CAcC;AAQD,gDAcC;AAQD,gDAcC;AAUD,8CAaC;AASD,kDAoCC;AAQD,oDAwBC;AApKD;;;;;GAKG;AACH,SAAgB,gBAAgB,CAAC,MAAmB;IAClD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;QACjC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,CAAC;IAED,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAClD,OAAO,EAAE,GAAG,MAAM,EAAE,CAAC;IACvB,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,gCAAgC,MAAM,EAAE,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;GAKG;AACH,SAAgB,kBAAkB,CAAC,MAA0B;IAC3D,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;QACjC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,CAAC;IAED,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAClD,OAAO,EAAE,GAAG,MAAM,EAAE,CAAC;IACvB,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,wCAAwC,MAAM,EAAE,CAAC,CAAC;AACpE,CAAC;AAED;;;;;GAKG;AACH,SAAgB,kBAAkB,CAAC,MAA0B;IAC3D,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;QACjC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,CAAC;IAED,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAClD,OAAO,EAAE,GAAG,MAAM,EAAE,CAAC;IACvB,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,wCAAwC,MAAM,EAAE,CAAC,CAAC;AACpE,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,iBAAiB,CAC/B,UAAkB,EAClB,MAAc,EACd,OAAsB;IAEtB,OAAO;QACL,IAAI,EAAE,OAAO,EAAE,IAAI,IAAI,GAAG,UAAU,GAAG,MAAM,EAAE;QAC/C,WAAW,EAAE,OAAO,EAAE,WAAW;QACjC,UAAU,EAAE,OAAO,EAAE,UAAU,IAAI,IAAI;QACvC,UAAU,EAAE,OAAO,EAAE,UAAU,IAAI,EAAE;QACrC,QAAQ,EAAE,OAAO,EAAE,QAAQ,IAAI,EAAE;QACjC,OAAO,EAAE,OAAO,EAAE,OAAO;KAC1B,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,mBAAmB,CAAC,MAAW,EAAE,SAAiB;IAChE,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,4BAA4B,SAAS,+BAA+B,CAAC,CAAC;IACxF,CAAC;IAED,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO,CAAC,6BAA6B;IACvC,CAAC;IAED,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;QACjC,OAAO,CAAC,2BAA2B;IACrC,CAAC;IAED,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,gCAAgC;QAChC,MAAM,SAAS,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;QAC5H,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEvC,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;YAC7B,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,8BAA8B,GAAG,gBAAgB,SAAS,kBAAkB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACtH,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CAAC,mBAAmB,SAAS,+BAA+B,CAAC,CAAC;QAC/E,CAAC;QAED,IAAI,MAAM,CAAC,QAAQ,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC3D,MAAM,IAAI,KAAK,CAAC,uBAAuB,SAAS,oBAAoB,CAAC,CAAC;QACxE,CAAC;QAED,OAAO;IACT,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,yCAAyC,SAAS,uDAAuD,CAAC,CAAC;AAC7H,CAAC;AAED;;;;;GAKG;AACH,SAAgB,oBAAoB,CAAC,OAAqB;IACxD,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IAED,IAAI,OAAO,CAAC,WAAW,IAAI,OAAO,OAAO,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,IAAI,OAAO,OAAO,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QAChF,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IAED,IAAI,OAAO,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,IAAI,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,OAAO,CAAC,OAAO,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;AACH,CAAC"}

package/dist/helpers/args-helpers/groupby-args-from.helper.d.ts

@@ -0,0 +1,87 @@
+import { Type } from '@nestjs/common';
+import 'reflect-metadata';
+/**
+ * Configuration for GroupByArgsFrom mixin
+ */
+export interface GroupByArgsFromConfig {
+    findArgsType: Type<any>;
+    groupByFields: string[];
+    className?: string;
+    description?: string;
+}
+/**
+ * Extracted metadata from FindArgs class for GroupBy generation
+ */
+export interface FindArgsMetadata {
+    className: string;
+    properties: Array<{
+        name: string;
+        type: any;
+        isOptional: boolean;
+        description?: string;
+    }>;
+    entityType?: Type<any>;
+}
+/**
+ * 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();
+ * }
+ * ```
+ */
+export declare function GroupByArgsFrom<T>(config: GroupByArgsFromConfig): Type<any>;
+/**
+ * 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
+ */
+export declare function extractFindArgsMetadata(findArgsType: Type<any>): FindArgsMetadata;
+/**
+ * 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
+ */
+export declare function getGroupByArgsMetadata(groupByClass: Type<any>): any;
+/**
+ * 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
+ */
+export declare function getGroupByFieldMetadata(groupByClass: Type<any>, fieldName: string): any;
+/**
+ * Validates that a class was created by GroupByArgsFrom
+ *
+ * @param groupByClass - The class to validate
+ * @returns True if the class was created by GroupByArgsFrom
+ */
+export declare function isGroupByArgsFromClass(groupByClass: Type<any>): boolean;
+//# sourceMappingURL=groupby-args-from.helper.d.ts.map