typemold 1.0.0

package/dist/types/types.d.ts

@@ -0,0 +1,120 @@
+/**
+ * @sevirial/nest-mapper - Type Definitions
+ * Core types for the high-performance object mapper
+ */
+/**
+ * Constructor type for class instantiation
+ */
+export type Constructor<T = any> = new (...args: any[]) => T;
+/**
+ * Transform function that converts source value to target value
+ */
+export type TransformFn<TSource = any, TResult = any> = (source: TSource, context?: MappingContext) => TResult;
+/**
+ * Property path as string (supports nested paths like 'profile.avatar')
+ */
+export type PropertyPath = string;
+/**
+ * Mapping configuration for a single property
+ */
+export interface PropertyMappingConfig {
+    /** Target property name on the DTO */
+    targetKey: string;
+    /** Source property path or transform function */
+    source: PropertyPath | TransformFn;
+    /** Whether this is a transform function */
+    isTransform: boolean;
+    /** Field groups this property belongs to */
+    groups: string[];
+    /** Whether to ignore this property */
+    ignore: boolean;
+}
+/**
+ * Compiled mapping function for optimal performance
+ */
+export type CompiledMapper<TSource = any, TTarget = any> = (source: TSource, context?: MappingContext) => TTarget;
+/**
+ * Context passed during mapping operations
+ */
+export interface MappingContext {
+    /** Extra data available to transform functions */
+    extras?: Record<string, unknown>;
+    /** Current depth for circular reference detection */
+    depth?: number;
+    /** Already mapped objects for circular reference handling */
+    visited?: WeakMap<object, unknown>;
+}
+/**
+ * Options for mapping operations with runtime field projection
+ */
+export interface MapOptions<TTarget = any> {
+    /**
+     * Pick only specific fields from the target DTO
+     * @example { pick: ['username', 'avatar'] }
+     */
+    pick?: (keyof TTarget)[];
+    /**
+     * Omit specific fields from the target DTO
+     * @example { omit: ['password', 'email'] }
+     */
+    omit?: (keyof TTarget)[];
+    /**
+     * Use a predefined field group
+     * @example { group: 'minimal' }
+     */
+    group?: string;
+    /**
+     * Extra context data available to transform functions
+     */
+    extras?: Record<string, unknown>;
+}
+/**
+ * Configuration for the MapperModule
+ */
+export interface MapperModuleOptions {
+    /**
+     * Enable validation integration with class-validator
+     * @default false
+     */
+    enableValidation?: boolean;
+    /**
+     * Global options applied to all mappings
+     */
+    globalOptions?: Partial<MapOptions>;
+    /**
+     * Custom type converters
+     */
+    converters?: TypeConverter[];
+}
+/**
+ * Type converter for automatic type transformations
+ */
+export interface TypeConverter<TSource = any, TTarget = any> {
+    /** Source type to convert from */
+    sourceType: Constructor<TSource> | string;
+    /** Target type to convert to */
+    targetType: Constructor<TTarget> | string;
+    /** Conversion function */
+    convert: (value: TSource) => TTarget;
+}
+/**
+ * Metadata key constants
+ */
+export declare const METADATA_KEYS: {
+    readonly PROPERTY_MAPPINGS: symbol;
+    readonly FIELD_GROUPS: symbol;
+    readonly AUTO_MAP: symbol;
+    readonly IGNORE: symbol;
+    readonly NESTED_TYPE: symbol;
+};
+/**
+ * Internal mapping registry entry
+ */
+export interface MappingRegistryEntry<TSource = any, TTarget = any> {
+    sourceType?: Constructor<TSource>;
+    targetType: Constructor<TTarget>;
+    compiledMapper?: CompiledMapper<TSource, TTarget>;
+    propertyConfigs: Map<string, PropertyMappingConfig>;
+    fieldGroups: Map<string, Set<string>>;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/types/utils.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @sevirial/nest-mapper - Utility Functions
+ * Helper functions for the mapping engine
+ */
+export declare function getNestedValue<T = unknown>(obj: Record<string, unknown> | null | undefined, path: string): T | undefined;
+/**
+ * Checks if a value is a plain object (not an array, Date, etc.)
+ */
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+/**
+ * Checks if a value is a class instance (not a plain object)
+ */
+export declare function isClassInstance(value: unknown): boolean;
+/**
+ * Creates a shallow clone of an object with only specified keys
+ */
+export declare function pickKeys<T extends Record<string, unknown>>(obj: T, keys: (keyof T)[]): Partial<T>;
+/**
+ * Creates a shallow clone of an object without specified keys
+ */
+export declare function omitKeys<T extends Record<string, unknown>>(obj: T, keys: (keyof T)[]): Partial<T>;
+/**
+ * Gets all property keys including inherited ones
+ */
+export declare function getAllPropertyKeys(target: object): string[];
+/**
+ * Deep clones an object (for handling circular references)
+ */
+export declare function deepClone<T>(obj: T, visited?: WeakMap<object, unknown>): T;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAcH,wBAAgB,cAAc,CAAC,CAAC,GAAG,OAAO,EACxC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,EAC/C,IAAI,EAAE,MAAM,GACX,CAAC,GAAG,SAAS,CAyBf;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAIlC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAIvD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxD,GAAG,EAAE,CAAC,EACN,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,GAChB,OAAO,CAAC,CAAC,CAAC,CAQZ;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxD,GAAG,EAAE,CAAC,EACN,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,GAChB,OAAO,CAAC,CAAC,CAAC,CASZ;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAc3D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EACzB,GAAG,EAAE,CAAC,EACN,OAAO,2BAAiC,GACvC,CAAC,CA6BH"}

package/package.json

@@ -0,0 +1,92 @@
+{
+  "name": "typemold",
+  "version": "1.0.0",
+  "description": "A lightweight, high-performance object mapper for TypeScript and Node.js with runtime field projection",
+  "author": {
+    "name": "Chetan Joshi",
+    "email": "chetanjoshi707@gmail.com",
+    "url": "https://github.com/ErrorX407"
+  },
+  "license": "MIT",
+  "main": "dist/cjs/index.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "require": "./dist/cjs/index.js",
+      "import": "./dist/esm/index.js",
+      "types": "./dist/types/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "npm run build:cjs && npm run build:esm && npm run build:types",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build:types": "tsc -p tsconfig.types.json",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "benchmark": "ts-node benchmarks/index.ts",
+    "lint": "eslint src --ext .ts",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "keywords": [
+    "mapper",
+    "object-mapper",
+    "dto",
+    "typescript",
+    "nestjs",
+    "nodejs",
+    "transform",
+    "serialization",
+    "automapper",
+    "type-safe"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ErrorX407/typemold.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ErrorX407/typemold/issues"
+  },
+  "homepage": "https://github.com/ErrorX407/typemold#readme",
+  "peerDependencies": {
+    "reflect-metadata": "^0.1.13 || ^0.2.0",
+    "@nestjs/common": ">=9.0.0",
+    "@nestjs/core": ">=9.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@nestjs/common": {
+      "optional": true
+    },
+    "@nestjs/core": {
+      "optional": true
+    }
+  },
+  "optionalDependencies": {
+    "class-validator": ">=0.14.0"
+  },
+  "devDependencies": {
+    "@nestjs/common": "^10.0.0",
+    "@nestjs/core": "^10.0.0",
+    "@nestjs/testing": "^10.0.0",
+    "@types/jest": "^29.5.0",
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "class-validator": "^0.14.0",
+    "eslint": "^8.0.0",
+    "jest": "^29.5.0",
+    "reflect-metadata": "^0.2.0",
+    "ts-jest": "^29.1.0",
+    "ts-node": "^10.9.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}