typemold 1.0.0

package/dist/types/decorators.d.ts

@@ -0,0 +1,206 @@
+/**
+ * @sevirial/nest-mapper - Decorators
+ * Property decorators for defining mapping configurations
+ */
+import "reflect-metadata";
+import { PropertyPath, TransformFn, Constructor } from "./types";
+/**
+ * Maps a property from a source path or using a transform function.
+ *
+ * @example
+ * // Direct property mapping
+ * class UserDto {
+ *   @MapFrom('firstName')
+ *   name: string;
+ * }
+ *
+ * @example
+ * // Nested path mapping
+ * class UserDto {
+ *   @MapFrom('profile.avatar')
+ *   avatarUrl: string;
+ * }
+ *
+ * @example
+ * // Transform function with typed source
+ * class UserDto {
+ *   @MapFrom<User>((src) => src.age >= 18)  // ← IntelliSense for src!
+ *   isAdult: boolean;
+ * }
+ */
+export declare function MapFrom<TSource = any>(sourcePathOrTransform: PropertyPath | TransformFn<TSource>): PropertyDecorator;
+/**
+ * Creates a type-safe mapping configuration with full IntelliSense support.
+ * Use this builder pattern when you need autocomplete for source paths.
+ *
+ * @example
+ * interface User {
+ *   username: string;
+ *   profile: { avatar: string; bio: string };
+ * }
+ *
+ * // Option 1: Define mappings with full autocomplete
+ * const toUserDto = createMapping<User, UserDto>({
+ *   avatar: 'profile.avatar',        // ✨ Autocomplete for paths!
+ *   bio: src => src.profile.bio,     // ✨ Autocomplete for transforms!
+ * });
+ *
+ * // Usage
+ * const dto = toUserDto(userEntity);
+ *
+ * @example
+ * // Option 2: Use with Mapper
+ * const dto = Mapper.mapWith(user, toUserDto);
+ */
+export declare function createMapping<TSource, TTarget>(mappings: TypedMappingConfig<TSource, TTarget>): (source: TSource) => Partial<TTarget>;
+/**
+ * Type-safe mapping configuration object.
+ * Keys are target DTO properties, values are source paths or transform functions.
+ */
+export type TypedMappingConfig<TSource, TTarget> = {
+    [K in keyof TTarget]?: PathsOf<TSource> | ((source: TSource) => TTarget[K]);
+};
+/**
+ * Utility type that extracts all possible dot-notation paths from an object type.
+ * Provides IntelliSense for nested property paths.
+ *
+ * @example
+ * type User = { profile: { avatar: string } };
+ * type Paths = PathsOf<User>; // 'profile' | 'profile.avatar'
+ */
+export type PathsOf<T, Depth extends number = 3> = Depth extends 0 ? never : T extends object ? {
+    [K in keyof T & string]: T[K] extends object ? K | `${K}.${PathsOf<T[K], Prev[Depth]>}` : K;
+}[keyof T & string] : never;
+type Prev = [never, 0, 1, 2, 3];
+/**
+ * Automatically maps a property with the same name from source.
+ *
+ * @example
+ * class UserDto {
+ *   @AutoMap()
+ *   username: string;  // Maps from source.username
+ * }
+ */
+export declare function AutoMap(): PropertyDecorator;
+/**
+ * Assigns a property to one or more field groups for runtime projection.
+ *
+ * @example
+ * // Basic usage with strings
+ * class UserDto {
+ *   @FieldGroup('minimal', 'public')
+ *   @AutoMap()
+ *   username: string;
+ * }
+ *
+ * @example
+ * // Type-safe usage with const object (recommended for autocomplete!)
+ * const Groups = createFieldGroups('minimal', 'public', 'full');
+ *
+ * class UserDto {
+ *   @FieldGroup(Groups.minimal, Groups.public)  // ✨ Autocomplete!
+ *   @AutoMap()
+ *   username: string;
+ * }
+ */
+export declare function FieldGroup(...groups: string[]): PropertyDecorator;
+/**
+ * Creates a type-safe field groups object with autocomplete support.
+ * Use this to define your groups once and get IntelliSense everywhere!
+ *
+ * @example
+ * // Define groups once
+ * export const UserGroups = createFieldGroups('minimal', 'public', 'full');
+ *
+ * class UserDto {
+ *   @FieldGroup(UserGroups.minimal, UserGroups.public)  // ✨ Autocomplete!
+ *   @AutoMap()
+ *   username: string;
+ *
+ *   @FieldGroup(UserGroups.full)
+ *   @AutoMap()
+ *   email: string;
+ * }
+ *
+ * // Usage with type-safety
+ * Mapper.map(user, UserDto, { group: UserGroups.minimal });  // ✨ Autocomplete!
+ */
+export declare function createFieldGroups<T extends string>(...groups: T[]): {
+    readonly [K in T]: K;
+};
+/**
+ * Type for extracting group names from a created field groups object.
+ * Useful for typing function parameters.
+ *
+ * @example
+ * const Groups = createFieldGroups('minimal', 'public', 'full');
+ * type GroupName = GroupsOf<typeof Groups>; // 'minimal' | 'public' | 'full'
+ */
+export type GroupsOf<T> = T extends {
+    [K in infer U]: K;
+} ? U : never;
+/**
+ * Built-in field groups with autocomplete - use these directly!
+ * No need to define your own groups for common use cases.
+ *
+ * @example
+ * class UserDto {
+ *   @FieldGroup(Groups.MINIMAL, Groups.PUBLIC)  // ✨ Autocomplete!
+ *   @AutoMap()
+ *   username: string;
+ *
+ *   @FieldGroup(Groups.DETAILED)
+ *   @AutoMap()
+ *   email: string;
+ * }
+ *
+ * // Usage
+ * Mapper.map(user, UserDto, { group: Groups.MINIMAL });  // ✨ Autocomplete!
+ */
+export declare const Groups: Readonly<{
+    /** Minimal fields - just the essentials (e.g., id, name) */
+    readonly MINIMAL: "minimal";
+    /** Summary fields - brief overview */
+    readonly SUMMARY: "summary";
+    /** Public fields - safe to expose publicly */
+    readonly PUBLIC: "public";
+    /** Private fields - internal use only */
+    readonly PRIVATE: "private";
+    /** Detailed fields - comprehensive info */
+    readonly DETAILED: "detailed";
+    /** Full fields - everything */
+    readonly FULL: "full";
+    /** List view fields - for table/list displays */
+    readonly LIST: "list";
+    /** Detail view fields - for detail pages */
+    readonly DETAIL: "detail";
+    /** Admin fields - administrative data */
+    readonly ADMIN: "admin";
+    /** API response fields */
+    readonly API: "api";
+}>;
+/** Type representing all built-in group names */
+export type BuiltInGroup = (typeof Groups)[keyof typeof Groups];
+/**
+ * Ignores a property during mapping.
+ *
+ * @example
+ * class UserDto {
+ *   @Ignore()
+ *   internalId: string;  // Will not be mapped
+ * }
+ */
+export declare function Ignore(): PropertyDecorator;
+/**
+ * Specifies the type for nested object mapping.
+ *
+ * @example
+ * class UserDto {
+ *   @NestedType(() => AddressDto)
+ *   @MapFrom('address')
+ *   address: AddressDto;
+ * }
+ */
+export declare function NestedType<T>(typeFactory: () => Constructor<T>): PropertyDecorator;
+export {};
+//# sourceMappingURL=decorators.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/decorators.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAEL,YAAY,EACZ,WAAW,EAEX,WAAW,EACZ,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,OAAO,CAAC,OAAO,GAAG,GAAG,EACnC,qBAAqB,EAAE,YAAY,GAAG,WAAW,CAAC,OAAO,CAAC,GACzD,iBAAiB,CA2BnB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAC5C,QAAQ,EAAE,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,GAC7C,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAiBvC;AAED;;;GAGG;AACH,MAAM,MAAM,kBAAkB,CAAC,OAAO,EAAE,OAAO,IAAI;KAChD,CAAC,IAAI,MAAM,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;CAC5E,CAAC;AAgBF;;;;;;;GAOG;AACH,MAAM,MAAM,OAAO,CAAC,CAAC,EAAE,KAAK,SAAS,MAAM,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,GAC9D,KAAK,GACL,CAAC,SAAS,MAAM,GAChB;KACG,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GACxC,CAAC,GAAG,GAAG,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GACxC,CAAC;CACN,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,GACnB,KAAK,CAAC;AAGV,KAAK,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAEhC;;;;;;;;GAQG;AACH,wBAAgB,OAAO,IAAI,iBAAiB,CA2B3C;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,UAAU,CAAC,GAAG,MAAM,EAAE,MAAM,EAAE,GAAG,iBAAiB,CAsCjE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAChD,GAAG,MAAM,EAAE,CAAC,EAAE,GACb;IAAE,QAAQ,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC;CAAE,CAM1B;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,SAAS;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC;CAAE,GAAG,CAAC,GAAG,KAAK,CAAC;AAEtE;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,MAAM;IACjB,4DAA4D;;IAE5D,sCAAsC;;IAEtC,8CAA8C;;IAE9C,yCAAyC;;IAEzC,2CAA2C;;IAE3C,+BAA+B;;IAE/B,iDAAiD;;IAEjD,4CAA4C;;IAE5C,yCAAyC;;IAEzC,0BAA0B;;EAEjB,CAAC;AAEZ,iDAAiD;AACjD,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,OAAO,MAAM,CAAC,CAAC;AAEhE;;;;;;;;GAQG;AACH,wBAAgB,MAAM,IAAI,iBAAiB,CAqB1C;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC1B,WAAW,EAAE,MAAM,WAAW,CAAC,CAAC,CAAC,GAChC,iBAAiB,CASnB"}

package/dist/types/index.d.ts

@@ -0,0 +1,46 @@
+/**
+ * typemold
+ * A lightweight, high-performance object mapper for TypeScript and Node.js
+ *
+ * @author Chetan Joshi
+ * @license MIT
+ *
+ * @example
+ * // Basic mapping
+ * import { Mapper, MapFrom, AutoMap } from 'typemold';
+ *
+ * class UserDto {
+ *   @AutoMap()
+ *   username: string;
+ *
+ *   @MapFrom('profile.avatar')
+ *   avatar: string;
+ *
+ *   @MapFrom((src) => src.age >= 18)
+ *   isAdult: boolean;
+ * }
+ *
+ * const userDto = Mapper.map(userEntity, UserDto);
+ *
+ * @example
+ * // Runtime field projection
+ * const minimal = Mapper.map(user, UserDto, { pick: ['username', 'avatar'] });
+ * const safe = Mapper.map(user, UserDto, { omit: ['email', 'password'] });
+ * const public = Mapper.map(user, UserDto, { group: 'public' });
+ *
+ * @example
+ * // NestJS integration (optional)
+ * import { MapperModule, MapperService } from 'typemold';
+ *
+ * @Module({
+ *   imports: [MapperModule.forRoot()],
+ * })
+ * export class AppModule {}
+ */
+export { Mapper } from "./mapper";
+export { MapFrom, createMapping, TypedMappingConfig, PathsOf, AutoMap, FieldGroup, createFieldGroups, GroupsOf, Groups, BuiltInGroup, Ignore, NestedType, } from "./decorators";
+export { Constructor, TransformFn, PropertyPath, MapOptions, MappingContext, TypeConverter, PropertyMappingConfig, CompiledMapper, METADATA_KEYS, } from "./types";
+export { MappingRegistry, MapperFactory } from "./registry";
+export { getNestedValue, pickKeys, omitKeys, isPlainObject, isClassInstance, } from "./utils";
+export { MapperModule, MapperModuleOptions, MapperModuleAsyncOptions, MapperService, MapperServiceOptions, MAPPER_OPTIONS, } from "./nestjs";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGlC,OAAO,EACL,OAAO,EACP,aAAa,EACb,kBAAkB,EAClB,OAAO,EACP,OAAO,EACP,UAAU,EACV,iBAAiB,EACjB,QAAQ,EACR,MAAM,EACN,YAAY,EACZ,MAAM,EACN,UAAU,GACX,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,WAAW,EACX,WAAW,EACX,YAAY,EACZ,UAAU,EACV,cAAc,EACd,aAAa,EACb,qBAAqB,EACrB,cAAc,EACd,aAAa,GACd,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG5D,OAAO,EACL,cAAc,EACd,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,eAAe,GAChB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,wBAAwB,EACxB,aAAa,EACb,oBAAoB,EACpB,cAAc,GACf,MAAM,UAAU,CAAC"}

package/dist/types/mapper.d.ts

@@ -0,0 +1,93 @@
+/**
+ * @sevirial/nest-mapper - Core Mapper
+ * Main mapper class with static methods for easy usage
+ */
+import "reflect-metadata";
+import { Constructor, MapOptions, MappingContext, CompiledMapper, TypeConverter } from "./types";
+/**
+ * Main Mapper class - provides static methods for object mapping
+ *
+ * @example
+ * // Basic usage
+ * const userDto = Mapper.map(userEntity, UserDto);
+ *
+ * @example
+ * // With field projection
+ * const minimalUser = Mapper.map(userEntity, UserDto, { pick: ['username', 'avatar'] });
+ *
+ * @example
+ * // With field groups
+ * const publicUser = Mapper.map(userEntity, UserDto, { group: 'public' });
+ *
+ * @example
+ * // Array mapping
+ * const userDtos = Mapper.mapArray(users, UserDto);
+ */
+export declare class Mapper {
+    private static typeConverters;
+    private static globalContext;
+    /**
+     * Maps a source object to a target DTO class
+     *
+     * @param source - Source object to map from
+     * @param targetType - Target DTO class constructor
+     * @param options - Optional mapping options for field projection
+     * @returns Mapped target object
+     */
+    static map<TSource, TTarget>(source: TSource, targetType: Constructor<TTarget>, options?: MapOptions<TTarget>): TTarget;
+    /**
+     * Maps an array of source objects to target DTOs
+     *
+     * @param sources - Array of source objects
+     * @param targetType - Target DTO class constructor
+     * @param options - Optional mapping options for field projection
+     * @returns Array of mapped target objects
+     */
+    static mapArray<TSource, TTarget>(sources: TSource[], targetType: Constructor<TTarget>, options?: MapOptions<TTarget>): TTarget[];
+    /**
+     * Maps source to target and returns only specified fields (shorthand)
+     *
+     * @example
+     * const result = Mapper.pick(user, UserDto, ['username', 'avatar']);
+     */
+    static pick<TSource, TTarget, K extends keyof TTarget>(source: TSource, targetType: Constructor<TTarget>, fields: K[]): Pick<TTarget, K>;
+    /**
+     * Maps source to target excluding specified fields (shorthand)
+     *
+     * @example
+     * const result = Mapper.omit(user, UserDto, ['password', 'email']);
+     */
+    static omit<TSource, TTarget, K extends keyof TTarget>(source: TSource, targetType: Constructor<TTarget>, fields: K[]): Omit<TTarget, K>;
+    /**
+     * Maps source using a predefined field group (shorthand)
+     *
+     * @example
+     * const result = Mapper.group(user, UserDto, 'minimal');
+     */
+    static group<TSource, TTarget>(source: TSource, targetType: Constructor<TTarget>, groupName: string): Partial<TTarget>;
+    /**
+     * Creates a reusable mapper function for better performance in loops
+     *
+     * @example
+     * const mapToUserDto = Mapper.createMapper(UserDto);
+     * const users = entities.map(mapToUserDto);
+     */
+    static createMapper<TSource, TTarget>(targetType: Constructor<TTarget>, options?: MapOptions<TTarget>): (source: TSource) => TTarget;
+    /**
+     * Registers a type converter for automatic type transformations
+     */
+    static registerConverter<TSource, TTarget>(converter: TypeConverter<TSource, TTarget>): void;
+    /**
+     * Sets global context that will be available to all transform functions
+     */
+    static setGlobalContext(context: Partial<MappingContext>): void;
+    /**
+     * Clears all cached mappers (useful for testing or hot-reload scenarios)
+     */
+    static clearCache(): void;
+    /**
+     * Gets the compiled mapper for inspection (useful for debugging)
+     */
+    static getCompiledMapper<TSource, TTarget>(targetType: Constructor<TTarget>, options?: MapOptions<TTarget>): CompiledMapper<TSource, TTarget> | undefined;
+}
+//# sourceMappingURL=mapper.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mapper.d.ts","sourceRoot":"","sources":["../../src/mapper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EACL,WAAW,EACX,UAAU,EACV,cAAc,EACd,cAAc,EACd,aAAa,EAEd,MAAM,SAAS,CAAC;AAGjB;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAC,cAAc,CAAuB;IACpD,OAAO,CAAC,MAAM,CAAC,aAAa,CAAsB;IAElD;;;;;;;OAOG;IACH,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EACzB,MAAM,EAAE,OAAO,EACf,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,EAChC,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,GAC5B,OAAO;IAmBV;;;;;;;OAOG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,EAC9B,OAAO,EAAE,OAAO,EAAE,EAClB,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,EAChC,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,GAC5B,OAAO,EAAE;IA2BZ;;;;;OAKG;IACH,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,SAAS,MAAM,OAAO,EACnD,MAAM,EAAE,OAAO,EACf,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,EAChC,MAAM,EAAE,CAAC,EAAE,GACV,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAMnB;;;;;OAKG;IACH,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,SAAS,MAAM,OAAO,EACnD,MAAM,EAAE,OAAO,EACf,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,EAChC,MAAM,EAAE,CAAC,EAAE,GACV,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAMnB;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAC3B,MAAM,EAAE,OAAO,EACf,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,EAChC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC;IAInB;;;;;;OAMG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,EAClC,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,EAChC,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,GAC5B,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO;IAa/B;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,OAAO,EAAE,OAAO,EACvC,SAAS,EAAE,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,GACzC,IAAI;IAIP;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI;IAI/D;;OAEG;IACH,MAAM,CAAC,UAAU,IAAI,IAAI;IAIzB;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,OAAO,EAAE,OAAO,EACvC,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,EAChC,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,GAC5B,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,SAAS;CAOhD"}

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

@@ -0,0 +1,7 @@
+/**
+ * @sevirial/nest-mapper - NestJS Integration
+ * Re-exports for NestJS-specific functionality
+ */
+export { MapperModule, MapperModuleOptions, MapperModuleAsyncOptions, } from "./mapper.module";
+export { MapperService, MapperServiceOptions, MAPPER_OPTIONS, } from "./mapper.service";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/nestjs/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,cAAc,GACf,MAAM,kBAAkB,CAAC"}

package/dist/types/nestjs/mapper.module.d.ts

@@ -0,0 +1,89 @@
+/**
+ * @sevirial/nest-mapper - NestJS MapperModule
+ * Dynamic module for NestJS integration
+ */
+import { DynamicModule, Type, InjectionToken, OptionalFactoryDependency } from "@nestjs/common";
+import { MapperServiceOptions } from "./mapper.service";
+/**
+ * Module options for MapperModule.forRoot()
+ */
+export interface MapperModuleOptions extends MapperServiceOptions {
+    /**
+     * Make module global (available everywhere without importing)
+     * @default true
+     */
+    isGlobal?: boolean;
+}
+/**
+ * Async module options for MapperModule.forRootAsync()
+ */
+export interface MapperModuleAsyncOptions {
+    /**
+     * Make module global
+     */
+    isGlobal?: boolean;
+    /**
+     * Modules to import for dependency injection
+     */
+    imports?: Array<Type<unknown> | DynamicModule>;
+    /**
+     * Factory function to create options
+     */
+    useFactory: (...args: unknown[]) => Promise<MapperServiceOptions> | MapperServiceOptions;
+    /**
+     * Dependencies to inject into factory
+     */
+    inject?: Array<InjectionToken | OptionalFactoryDependency>;
+}
+/**
+ * NestJS Module for @sevirial/nest-mapper
+ *
+ * @example
+ * // Basic usage (global by default)
+ * @Module({
+ *   imports: [MapperModule.forRoot()],
+ * })
+ * export class AppModule {}
+ *
+ * @example
+ * // With options
+ * @Module({
+ *   imports: [
+ *     MapperModule.forRoot({
+ *       enableValidation: true,
+ *       converters: [myDateConverter],
+ *     }),
+ *   ],
+ * })
+ * export class AppModule {}
+ *
+ * @example
+ * // Async configuration
+ * @Module({
+ *   imports: [
+ *     MapperModule.forRootAsync({
+ *       imports: [ConfigModule],
+ *       useFactory: (config: ConfigService) => ({
+ *         enableValidation: config.get('ENABLE_VALIDATION'),
+ *       }),
+ *       inject: [ConfigService],
+ *     }),
+ *   ],
+ * })
+ * export class AppModule {}
+ */
+export declare class MapperModule {
+    /**
+     * Configure the mapper module with static options
+     */
+    static forRoot(options?: MapperModuleOptions): DynamicModule;
+    /**
+     * Configure the mapper module with async options (factory pattern)
+     */
+    static forRootAsync(options: MapperModuleAsyncOptions): DynamicModule;
+    /**
+     * For feature modules that need the mapper (when not using isGlobal)
+     */
+    static forFeature(): DynamicModule;
+}
+//# sourceMappingURL=mapper.module.d.ts.map

package/dist/types/nestjs/mapper.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapper.module.d.ts","sourceRoot":"","sources":["../../../src/nestjs/mapper.module.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,aAAa,EAGb,IAAI,EACJ,cAAc,EACd,yBAAyB,EAC1B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAEL,oBAAoB,EAErB,MAAM,kBAAkB,CAAC;AAE1B;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,oBAAoB;IAC/D;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,aAAa,CAAC,CAAC;IAE/C;;OAEG;IACH,UAAU,EAAE,CACV,GAAG,IAAI,EAAE,OAAO,EAAE,KACf,OAAO,CAAC,oBAAoB,CAAC,GAAG,oBAAoB,CAAC;IAE1D;;OAEG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC,cAAc,GAAG,yBAAyB,CAAC,CAAC;CAC5D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,qBACa,YAAY;IACvB;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,aAAa;IAgB5D;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,wBAAwB,GAAG,aAAa;IAkBrE;;OAEG;IACH,MAAM,CAAC,UAAU,IAAI,aAAa;CAOnC"}

package/dist/types/nestjs/mapper.service.d.ts

@@ -0,0 +1,80 @@
+/**
+ * @sevirial/nest-mapper - NestJS MapperService
+ * Injectable service for NestJS dependency injection
+ */
+import { Constructor, MapOptions, TypeConverter } from "../types";
+/**
+ * Injection token for MapperModule options
+ */
+export declare const MAPPER_OPTIONS: unique symbol;
+/**
+ * Options for MapperService
+ */
+export interface MapperServiceOptions {
+    /**
+     * Enable validation integration with class-validator
+     */
+    enableValidation?: boolean;
+    /**
+     * Custom type converters
+     */
+    converters?: TypeConverter[];
+    /**
+     * Global extras available to all transform functions
+     */
+    globalExtras?: Record<string, unknown>;
+}
+/**
+ * Injectable mapper service for NestJS
+ *
+ * @example
+ * @Injectable()
+ * export class UserService {
+ *   constructor(private readonly mapper: MapperService) {}
+ *
+ *   async getUser(id: string): Promise<UserDto> {
+ *     const user = await this.userRepo.findOne(id);
+ *     return this.mapper.map(user, UserDto);
+ *   }
+ * }
+ */
+export declare class MapperService {
+    private readonly options;
+    private validator;
+    constructor(options?: MapperServiceOptions);
+    /**
+     * Lazily loads class-validator for hybrid integration
+     */
+    private initializeValidator;
+    /**
+     * Maps a source object to a target DTO
+     */
+    map<TSource, TTarget>(source: TSource, targetType: Constructor<TTarget>, options?: MapOptions<TTarget>): TTarget;
+    /**
+     * Maps an array of source objects to target DTOs
+     */
+    mapArray<TSource, TTarget>(sources: TSource[], targetType: Constructor<TTarget>, options?: MapOptions<TTarget>): TTarget[];
+    /**
+     * Maps and validates the result using class-validator (if enabled)
+     *
+     * @throws ValidationError[] if validation fails
+     */
+    mapAndValidate<TSource, TTarget extends object>(source: TSource, targetType: Constructor<TTarget>, options?: MapOptions<TTarget>): Promise<TTarget>;
+    /**
+     * Pick specific fields (shorthand)
+     */
+    pick<TSource, TTarget, K extends keyof TTarget>(source: TSource, targetType: Constructor<TTarget>, fields: K[]): Pick<TTarget, K>;
+    /**
+     * Omit specific fields (shorthand)
+     */
+    omit<TSource, TTarget, K extends keyof TTarget>(source: TSource, targetType: Constructor<TTarget>, fields: K[]): Omit<TTarget, K>;
+    /**
+     * Use a field group (shorthand)
+     */
+    group<TSource, TTarget>(source: TSource, targetType: Constructor<TTarget>, groupName: string): Partial<TTarget>;
+    /**
+     * Creates a reusable mapper function
+     */
+    createMapper<TSource, TTarget>(targetType: Constructor<TTarget>, options?: MapOptions<TTarget>): (source: TSource) => TTarget;
+}
+//# sourceMappingURL=mapper.service.d.ts.map

package/dist/types/nestjs/mapper.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapper.service.d.ts","sourceRoot":"","sources":["../../../src/nestjs/mapper.service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,cAAc,eAA2B,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;OAEG;IACH,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;IAE7B;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED;;;;;;;;;;;;;GAaG;AACH,qBACa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAC/C,OAAO,CAAC,SAAS,CACV;gBAG+B,OAAO,CAAC,EAAE,oBAAoB;IAsBpE;;OAEG;YACW,mBAAmB;IAUjC;;OAEG;IACH,GAAG,CAAC,OAAO,EAAE,OAAO,EAClB,MAAM,EAAE,OAAO,EACf,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,EAChC,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,GAC5B,OAAO;IAIV;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,EACvB,OAAO,EAAE,OAAO,EAAE,EAClB,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,EAChC,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,GAC5B,OAAO,EAAE;IAIZ;;;;OAIG;IACG,cAAc,CAAC,OAAO,EAAE,OAAO,SAAS,MAAM,EAClD,MAAM,EAAE,OAAO,EACf,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,EAChC,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC;IAanB;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,SAAS,MAAM,OAAO,EAC5C,MAAM,EAAE,OAAO,EACf,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,EAChC,MAAM,EAAE,CAAC,EAAE,GACV,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAInB;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,SAAS,MAAM,OAAO,EAC5C,MAAM,EAAE,OAAO,EACf,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,EAChC,MAAM,EAAE,CAAC,EAAE,GACV,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAInB;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,OAAO,EACpB,MAAM,EAAE,OAAO,EACf,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,EAChC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC;IAInB;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,OAAO,EAC3B,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,EAChC,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,GAC5B,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO;CAGhC"}

package/dist/types/registry.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @sevirial/nest-mapper - Mapping Registry
+ * Singleton registry for storing and caching mapping configurations
+ */
+import "reflect-metadata";
+import { Constructor, MappingRegistryEntry, CompiledMapper, MapOptions } from "./types";
+/**
+ * Global mapping registry - singleton pattern for performance
+ */
+declare class MappingRegistryClass {
+    private readonly registry;
+    private readonly compiledMappers;
+    /**
+     * Gets or creates a registry entry for a target DTO class
+     */
+    getEntry<TTarget>(targetType: Constructor<TTarget>): MappingRegistryEntry<unknown, TTarget>;
+    /**
+     * Creates a mapping entry by reading decorator metadata
+     */
+    private createEntryFromMetadata;
+    /**
+     * Gets a compiled mapper for the given target type and options signature
+     */
+    getCompiledMapper<TSource, TTarget>(targetType: Constructor<TTarget>, optionsKey?: string): CompiledMapper<TSource, TTarget> | undefined;
+    /**
+     * Stores a compiled mapper for reuse
+     */
+    setCompiledMapper<TSource, TTarget>(targetType: Constructor<TTarget>, optionsKey: string, mapper: CompiledMapper<TSource, TTarget>): void;
+    /**
+     * Clears all cached mappers (useful for testing)
+     */
+    clearCache(): void;
+    /**
+     * Generates a cache key for mapping options
+     */
+    getOptionsKey<TTarget>(options?: MapOptions<TTarget>): string;
+}
+/**
+ * Singleton instance
+ */
+export declare const MappingRegistry: MappingRegistryClass;
+/**
+ * Mapper Factory - Creates optimized mapping functions
+ */
+export declare class MapperFactory {
+    /**
+     * Creates a compiled mapper for the given target type with optional field projection
+     */
+    static createMapper<TSource, TTarget>(targetType: Constructor<TTarget>, options?: MapOptions<TTarget>): CompiledMapper<TSource, TTarget>;
+    /**
+     * Determines which properties to map based on options
+     */
+    private static getPropertiesToMap;
+    /**
+     * Builds an optimized mapping function
+     */
+    private static buildMapper;
+}
+export {};
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EACL,WAAW,EACX,oBAAoB,EAEpB,cAAc,EAEd,UAAU,EAEX,MAAM,SAAS,CAAC;AAGjB;;GAEG;AACH,cAAM,oBAAoB;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgD;IACzE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAG5B;IAEJ;;OAEG;IACH,QAAQ,CAAC,OAAO,EACd,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,GAC/B,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC;IAWzC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAmB/B;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAChC,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,EAChC,UAAU,GAAE,MAAkB,GAC7B,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,SAAS;IAK/C;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAChC,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,EAChC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,GACvC,IAAI;IASP;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,MAAM;CAO9D;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,sBAA6B,CAAC;AAE1D;;GAEG;AACH,qBAAa,aAAa;IACxB;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,EAClC,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,EAChC,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,GAC5B,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC;IA8BnC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAoCjC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;CAwD3B"}