@rtpaulino/entity 0.21.0 → 0.23.0

package/dist/lib/property.d.ts.map

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

package/dist/lib/property.js

@@ -168,18 +168,27 @@ import { enumValidator, intValidator, minLengthValidator, maxLengthValidator, pa
  *
  *   @IntProperty({ optional: true })
  *   count?: number;
+ *
+ *   @IntProperty({ min: 0, max: 100 })
+ *   percentage!: number;
  * }
  */ export function IntProperty(options) {
-    const validators = options?.validators ? [
-        intValidator(),
-        ...options.validators
-    ] : [
-        intValidator()
+    const validators = [
+        ...options?.validators || []
     ];
+    if (options?.min !== undefined) {
+        validators.unshift(minValidator(options.min));
+    }
+    if (options?.max !== undefined) {
+        validators.unshift(maxValidator(options.max));
+    }
+    validators.unshift(intValidator());
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    const { min, max, ...restOptions } = options || {};
     return Property({
-        ...options,
+        ...restOptions,
         type: ()=>Number,
-        validators
+        validators: validators.length > 0 ? validators : undefined
     });
 }
 /**
@@ -296,9 +305,7 @@ import { enumValidator, intValidator, minLengthValidator, maxLengthValidator, pa
  *   customData!: any;
  * }
  */ export function PassthroughProperty() {
-    // Use a dummy type since type is mandatory but not used with passthrough
     return Property({
-        type: ()=>Object,
         passthrough: true
     });
 }
@@ -323,5 +330,57 @@ export const SerializableProperty = (type, data = {})=>Property({
             return type().parse(value);
         }
     });
+/**
+ * Helper decorator for discriminated entity properties.
+ * The entity type is determined at runtime using a discriminator property.
+ * Unlike EntityProperty, this does not require the type parameter upfront.
+ *
+ * @param options - Configuration for the discriminated property
+ *
+ * @example
+ * ```typescript
+ * // Define entity types
+ * @Entity({ name: 'Circle' })
+ * class Circle {
+ *   @StringProperty() readonly type = 'Circle';
+ *   @NumberProperty() radius!: number;
+ *   constructor(data: Partial<Circle>) { Object.assign(this, data); }
+ * }
+ *
+ * @Entity({ name: 'Rectangle' })
+ * class Rectangle {
+ *   @StringProperty() readonly type = 'Rectangle';
+ *   @NumberProperty() width!: number;
+ *   @NumberProperty() height!: number;
+ *   constructor(data: Partial<Rectangle>) { Object.assign(this, data); }
+ * }
+ *
+ * // Use discriminated property
+ * @Entity()
+ * class Drawing {
+ *   @DiscriminatedEntityProperty()
+ *   shape!: Circle | Rectangle;
+ *
+ *   @DiscriminatedEntityProperty({ discriminatorProperty: 'entityType' })
+ *   item!: BaseItem;
+ * }
+ *
+ * // When serialized, the discriminator is included inline:
+ * // { shape: { __type: 'Circle', radius: 5 } }
+ *
+ * // When deserialized, the discriminator is used to determine the type:
+ * const drawing = await EntityUtils.parse(Drawing, {
+ *   shape: { __type: 'Circle', radius: 5 }
+ * });
+ * // drawing.shape is a Circle instance
+ * ```
+ */ export function DiscriminatedEntityProperty(options) {
+    const discriminatorProperty = options?.discriminatorProperty ?? '__type';
+    return Property({
+        ...options,
+        discriminated: true,
+        discriminatorProperty
+    });
+}
 
 //# sourceMappingURL=property.js.map

package/dist/lib/property.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/property.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-wrapper-object-types */\n/* eslint-disable @typescript-eslint/no-explicit-any */\nimport { isEqual } from 'lodash-es';\nimport {\n  AnyCtor,\n  type CtorLike,\n  type InstanceOfCtorLike,\n  PROPERTY_METADATA_KEY,\n  PROPERTY_OPTIONS_METADATA_KEY,\n  PropertyOptions,\n} from './types.js';\nimport {\n  enumValidator,\n  intValidator,\n  minLengthValidator,\n  maxLengthValidator,\n  patternValidator,\n  minValidator,\n  maxValidator,\n  arrayMinLengthValidator,\n  arrayMaxLengthValidator,\n} from './validators.js';\n\n/**\n * Property decorator that marks class properties with metadata.\n * This decorator can be used to identify and track properties within classes.\n *\n * @param options - Configuration for the property (type is required)\n *\n * @example\n * class User {\n *   @Property({ type: () => String })\n *   name: string;\n *\n *   @Property({ type: () => String, equals: (a, b) => a.toLowerCase() === b.toLowerCase() })\n *   email: string;\n *\n *   @Property({ type: () => Number })\n *   age: number;\n * }\n */\nexport function Property<T, C extends CtorLike<T>>(\n  options: PropertyOptions<T, C>,\n): PropertyDecorator {\n  return (target: object, propertyKey: string | symbol): void => {\n    if (typeof propertyKey !== 'string') {\n      return;\n    }\n\n    const existingProperties: string[] =\n      Reflect.getOwnMetadata(PROPERTY_METADATA_KEY, target) || [];\n\n    if (!existingProperties.includes(propertyKey)) {\n      existingProperties.push(propertyKey);\n    }\n\n    Reflect.defineMetadata(PROPERTY_METADATA_KEY, existingProperties, target);\n\n    if (options.passthrough === true) {\n      if (options.array === true) {\n        throw new Error(\n          `Property '${propertyKey}' has passthrough: true and array: true. Passthrough cannot be combined with array.`,\n        );\n      }\n      if (options.optional === true) {\n        throw new Error(\n          `Property '${propertyKey}' has passthrough: true and optional: true. Passthrough cannot be combined with optional.`,\n        );\n      }\n      if (options.sparse === true) {\n        throw new Error(\n          `Property '${propertyKey}' has passthrough: true and sparse: true. Passthrough cannot be combined with sparse.`,\n        );\n      }\n      if (\n        options.serialize !== undefined ||\n        options.deserialize !== undefined\n      ) {\n        throw new Error(\n          `Property '${propertyKey}' has passthrough: true and custom serialize/deserialize functions. Passthrough cannot be combined with serialize or deserialize.`,\n        );\n      }\n    }\n\n    if (options.sparse === true && options.array !== true) {\n      throw new Error(\n        `Property '${propertyKey}' has sparse: true but array is not true. The sparse option only applies to arrays.`,\n      );\n    }\n\n    if (options.arrayValidators && options.array !== true) {\n      throw new Error(\n        `Property '${propertyKey}' has arrayValidators defined but array is not true. The arrayValidators option only applies to arrays.`,\n      );\n    }\n\n    // Validate serialize/deserialize pairing\n    const hasSerialize = options.serialize !== undefined;\n    const hasDeserialize = options.deserialize !== undefined;\n    if (hasSerialize !== hasDeserialize) {\n      throw new Error(\n        `Property '${propertyKey}' must define both serialize and deserialize functions, or neither. Found only ${hasSerialize ? 'serialize' : 'deserialize'}.`,\n      );\n    }\n\n    const existingOptions: Record<\n      string,\n      PropertyOptions<any, any>\n    > = Reflect.getOwnMetadata(PROPERTY_OPTIONS_METADATA_KEY, target) || {};\n\n    existingOptions[propertyKey] = options;\n\n    Reflect.defineMetadata(\n      PROPERTY_OPTIONS_METADATA_KEY,\n      existingOptions,\n      target,\n    );\n  };\n}\n\n/**\n * Helper decorator for string properties\n * @example\n * class User {\n *   @StringProperty()\n *   name!: string;\n *\n *   @StringProperty({ optional: true })\n *   nickname?: string;\n *\n *   @StringProperty({ minLength: 3, maxLength: 50 })\n *   username!: string;\n *\n *   @StringProperty({ pattern: /^[a-z]+$/ })\n *   slug!: string;\n * }\n */\nexport function StringProperty(\n  options?: Omit<PropertyOptions<string, StringConstructor>, 'type'> & {\n    minLength?: number;\n    maxLength?: number;\n    pattern?: RegExp;\n    patternMessage?: string;\n  },\n): PropertyDecorator {\n  const validators = [...(options?.validators || [])];\n\n  if (options?.minLength !== undefined) {\n    validators.unshift(minLengthValidator(options.minLength));\n  }\n  if (options?.maxLength !== undefined) {\n    validators.unshift(maxLengthValidator(options.maxLength));\n  }\n  if (options?.pattern !== undefined) {\n    validators.unshift(\n      patternValidator(options.pattern, options.patternMessage),\n    );\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  const { minLength, maxLength, pattern, patternMessage, ...restOptions } =\n    options || {};\n\n  return Property({\n    ...restOptions,\n    type: () => String,\n    validators: validators.length > 0 ? validators : undefined,\n  });\n}\n\n/**\n * Helper decorator for enum properties (string enums)\n * Validates that the string value matches one of the enum values\n * @param enumType - The enum object (e.g., MyEnum)\n * @param options - Additional property options\n * @example\n * enum Status {\n *   Active = 'active',\n *   Inactive = 'inactive'\n * }\n *\n * class User {\n *   @EnumProperty(Status)\n *   status!: Status;\n *\n *   @EnumProperty(Status, { optional: true })\n *   previousStatus?: Status;\n * }\n */\nexport function EnumProperty<T extends Record<string, string>>(\n  enumType: T,\n  options?: Omit<PropertyOptions<string, StringConstructor>, 'type'>,\n): PropertyDecorator {\n  const validators = options?.validators\n    ? [enumValidator(enumType), ...options.validators]\n    : [enumValidator(enumType)];\n\n  return Property({ ...options, type: () => String, validators });\n}\n\n/**\n * Helper decorator for number properties\n * @example\n * class User {\n *   @NumberProperty()\n *   age!: number;\n *\n *   @NumberProperty({ optional: true })\n *   score?: number;\n *\n *   @NumberProperty({ min: 0, max: 100 })\n *   percentage!: number;\n * }\n */\nexport function NumberProperty(\n  options?: Omit<PropertyOptions<number, NumberConstructor>, 'type'> & {\n    min?: number;\n    max?: number;\n  },\n): PropertyDecorator {\n  const validators = [...(options?.validators || [])];\n\n  if (options?.min !== undefined) {\n    validators.unshift(minValidator(options.min));\n  }\n  if (options?.max !== undefined) {\n    validators.unshift(maxValidator(options.max));\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  const { min, max, ...restOptions } = options || {};\n\n  return Property({\n    ...restOptions,\n    type: () => Number,\n    validators: validators.length > 0 ? validators : undefined,\n  });\n}\n\n/**\n * Helper decorator for integer properties\n * Validates that the number is an integer (no decimal places)\n * @example\n * class User {\n *   @IntProperty()\n *   age!: number;\n *\n *   @IntProperty({ optional: true })\n *   count?: number;\n * }\n */\nexport function IntProperty(\n  options?: Omit<PropertyOptions<number, NumberConstructor>, 'type'>,\n): PropertyDecorator {\n  const validators = options?.validators\n    ? [intValidator(), ...options.validators]\n    : [intValidator()];\n\n  return Property({ ...options, type: () => Number, validators });\n}\n\n/**\n * Helper decorator for boolean properties\n * @example\n * class User {\n *   @BooleanProperty()\n *   active!: boolean;\n *\n *   @BooleanProperty({ optional: true })\n *   verified?: boolean;\n * }\n */\nexport function BooleanProperty(\n  options?: Omit<PropertyOptions<boolean, BooleanConstructor>, 'type'>,\n): PropertyDecorator {\n  return Property({ ...options, type: () => Boolean });\n}\n\n/**\n * Helper decorator for Date properties\n * @example\n * class User {\n *   @DateProperty()\n *   createdAt!: Date;\n *\n *   @DateProperty({ optional: true })\n *   deletedAt?: Date;\n * }\n */\nexport function DateProperty(\n  options?: Omit<PropertyOptions<Date, DateConstructor>, 'type'>,\n): PropertyDecorator {\n  return Property({ ...options, type: () => Date });\n}\n\n/**\n * Helper decorator for BigInt properties\n * @example\n * class User {\n *   @BigIntProperty()\n *   id!: bigint;\n *\n *   @BigIntProperty({ optional: true })\n *   balance?: bigint;\n * }\n */\nexport function BigIntProperty(\n  options?: Omit<PropertyOptions<bigint, BigIntConstructor>, 'type'>,\n): PropertyDecorator {\n  return Property({ ...options, type: () => BigInt });\n}\n\n/**\n * Helper decorator for entity properties\n * @example\n * class User {\n *   @EntityProperty(() => Address)\n *   address!: Address;\n *\n *   @EntityProperty(() => Profile, { optional: true })\n *   profile?: Profile;\n * }\n */\nexport function EntityProperty<\n  T,\n  C extends AnyCtor<T> & { new (data: any): T },\n>(\n  type: () => C,\n  options?: Omit<PropertyOptions<T, C>, 'type'>,\n): PropertyDecorator {\n  return Property<T, C>({ ...options, type });\n}\n\n/**\n * Helper decorator for array properties\n * @example\n * class User {\n *   @ArrayProperty(() => String)\n *   tags!: string[];\n *\n *   @ArrayProperty(() => Phone)\n *   phones!: Phone[];\n *\n *   @ArrayProperty(() => Number, { optional: true })\n *   scores?: number[];\n *\n *   @ArrayProperty(() => String, { sparse: true })\n *   sparseList!: (string | null)[];\n *\n *   @ArrayProperty(() => String, { minLength: 1, maxLength: 10 })\n *   limitedList!: string[];\n * }\n */\nexport function ArrayProperty<T, C extends CtorLike<T>>(\n  type: () => C,\n  options?: Omit<PropertyOptions<T, C>, 'type' | 'array'> & {\n    minLength?: number;\n    maxLength?: number;\n  },\n): PropertyDecorator {\n  const arrayValidators = [...(options?.arrayValidators || [])];\n\n  if (options?.minLength !== undefined) {\n    arrayValidators.unshift(arrayMinLengthValidator(options.minLength));\n  }\n  if (options?.maxLength !== undefined) {\n    arrayValidators.unshift(arrayMaxLengthValidator(options.maxLength));\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  const { minLength, maxLength, ...restOptions } = options || {};\n\n  return Property({\n    ...restOptions,\n    type,\n    array: true,\n    arrayValidators: arrayValidators.length > 0 ? arrayValidators : undefined,\n  });\n}\n\n/**\n * Helper decorator for passthrough properties that bypass type validation.\n * Use this for generic types like Record<string, unknown>, any, or custom objects.\n * @example\n * class Config {\n *   @PassthroughProperty()\n *   metadata!: Record<string, unknown>;\n *\n *   @PassthroughProperty()\n *   customData!: any;\n * }\n */\nexport function PassthroughProperty(): PropertyDecorator {\n  // Use a dummy type since type is mandatory but not used with passthrough\n  return Property({ type: () => Object, passthrough: true });\n}\n\nexport const StringifiableProperty = <\n  T extends { equals?(other: T): boolean; toString(): string },\n  C extends CtorLike<T> & { parse(value: string): T },\n>(\n  type: () => C,\n  data: Omit<\n    PropertyOptions<T, C>,\n    'serialize' | 'deserialize' | 'passthrough' | 'type' | 'equals'\n  > = {},\n): PropertyDecorator =>\n  Property<T, C>({\n    ...data,\n    type,\n    equals: (a, b) => (a.equals ? a.equals(b) : a.toString() === b.toString()),\n    serialize: (value) => value.toString(),\n    deserialize: (value) => {\n      if (typeof value === 'string') {\n        return type().parse(value) as InstanceOfCtorLike<C>;\n      }\n      throw new Error(`Invalid value ${type().name}: ${String(value)}`);\n    },\n  });\n\nexport const SerializableProperty = <\n  T extends { equals?(other: T): boolean; toJSON(): unknown },\n  C extends CtorLike<T> & { parse(value: unknown): T },\n>(\n  type: () => C,\n  data: Omit<\n    PropertyOptions<T, C>,\n    'serialize' | 'deserialize' | 'passthrough' | 'type' | 'equals'\n  > = {},\n) =>\n  Property({\n    ...data,\n    type,\n    equals: (a: T, b: T) =>\n      a.equals ? a.equals(b) : isEqual(a.toJSON(), b.toJSON()),\n    serialize: (value: T) => value.toJSON(),\n    deserialize: (value: unknown) => {\n      return type().parse(value) as InstanceOfCtorLike<C>;\n    },\n  });\n"],"names":["isEqual","PROPERTY_METADATA_KEY","PROPERTY_OPTIONS_METADATA_KEY","enumValidator","intValidator","minLengthValidator","maxLengthValidator","patternValidator","minValidator","maxValidator","arrayMinLengthValidator","arrayMaxLengthValidator","Property","options","target","propertyKey","existingProperties","Reflect","getOwnMetadata","includes","push","defineMetadata","passthrough","array","Error","optional","sparse","serialize","undefined","deserialize","arrayValidators","hasSerialize","hasDeserialize","existingOptions","StringProperty","validators","minLength","unshift","maxLength","pattern","patternMessage","restOptions","type","String","length","EnumProperty","enumType","NumberProperty","min","max","Number","IntProperty","BooleanProperty","Boolean","DateProperty","Date","BigIntProperty","BigInt","EntityProperty","ArrayProperty","PassthroughProperty","Object","StringifiableProperty","data","equals","a","b","toString","value","parse","name","SerializableProperty","toJSON"],"mappings":"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"}
+{"version":3,"sources":["../../src/lib/property.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-wrapper-object-types */\n/* eslint-disable @typescript-eslint/no-explicit-any */\nimport { isEqual } from 'lodash-es';\nimport {\n  AnyCtor,\n  type CtorLike,\n  type InstanceOfCtorLike,\n  PROPERTY_METADATA_KEY,\n  PROPERTY_OPTIONS_METADATA_KEY,\n  PropertyOptions,\n} from './types.js';\nimport {\n  enumValidator,\n  intValidator,\n  minLengthValidator,\n  maxLengthValidator,\n  patternValidator,\n  minValidator,\n  maxValidator,\n  arrayMinLengthValidator,\n  arrayMaxLengthValidator,\n} from './validators.js';\n\n/**\n * Property decorator that marks class properties with metadata.\n * This decorator can be used to identify and track properties within classes.\n *\n * @param options - Configuration for the property (type is required)\n *\n * @example\n * class User {\n *   @Property({ type: () => String })\n *   name: string;\n *\n *   @Property({ type: () => String, equals: (a, b) => a.toLowerCase() === b.toLowerCase() })\n *   email: string;\n *\n *   @Property({ type: () => Number })\n *   age: number;\n * }\n */\nexport function Property<T, C extends CtorLike<T>>(\n  options: PropertyOptions<T, C>,\n): PropertyDecorator {\n  return (target: object, propertyKey: string | symbol): void => {\n    if (typeof propertyKey !== 'string') {\n      return;\n    }\n\n    const existingProperties: string[] =\n      Reflect.getOwnMetadata(PROPERTY_METADATA_KEY, target) || [];\n\n    if (!existingProperties.includes(propertyKey)) {\n      existingProperties.push(propertyKey);\n    }\n\n    Reflect.defineMetadata(PROPERTY_METADATA_KEY, existingProperties, target);\n\n    if (options.passthrough === true) {\n      if (options.array === true) {\n        throw new Error(\n          `Property '${propertyKey}' has passthrough: true and array: true. Passthrough cannot be combined with array.`,\n        );\n      }\n      if (options.optional === true) {\n        throw new Error(\n          `Property '${propertyKey}' has passthrough: true and optional: true. Passthrough cannot be combined with optional.`,\n        );\n      }\n      if (options.sparse === true) {\n        throw new Error(\n          `Property '${propertyKey}' has passthrough: true and sparse: true. Passthrough cannot be combined with sparse.`,\n        );\n      }\n      if (\n        options.serialize !== undefined ||\n        options.deserialize !== undefined\n      ) {\n        throw new Error(\n          `Property '${propertyKey}' has passthrough: true and custom serialize/deserialize functions. Passthrough cannot be combined with serialize or deserialize.`,\n        );\n      }\n    }\n\n    if (options.sparse === true && options.array !== true) {\n      throw new Error(\n        `Property '${propertyKey}' has sparse: true but array is not true. The sparse option only applies to arrays.`,\n      );\n    }\n\n    if (options.arrayValidators && options.array !== true) {\n      throw new Error(\n        `Property '${propertyKey}' has arrayValidators defined but array is not true. The arrayValidators option only applies to arrays.`,\n      );\n    }\n\n    // Validate serialize/deserialize pairing\n    const hasSerialize = options.serialize !== undefined;\n    const hasDeserialize = options.deserialize !== undefined;\n    if (hasSerialize !== hasDeserialize) {\n      throw new Error(\n        `Property '${propertyKey}' must define both serialize and deserialize functions, or neither. Found only ${hasSerialize ? 'serialize' : 'deserialize'}.`,\n      );\n    }\n\n    const existingOptions: Record<\n      string,\n      PropertyOptions<any, any>\n    > = Reflect.getOwnMetadata(PROPERTY_OPTIONS_METADATA_KEY, target) || {};\n\n    existingOptions[propertyKey] = options;\n\n    Reflect.defineMetadata(\n      PROPERTY_OPTIONS_METADATA_KEY,\n      existingOptions,\n      target,\n    );\n  };\n}\n\n/**\n * Helper decorator for string properties\n * @example\n * class User {\n *   @StringProperty()\n *   name!: string;\n *\n *   @StringProperty({ optional: true })\n *   nickname?: string;\n *\n *   @StringProperty({ minLength: 3, maxLength: 50 })\n *   username!: string;\n *\n *   @StringProperty({ pattern: /^[a-z]+$/ })\n *   slug!: string;\n * }\n */\nexport function StringProperty(\n  options?: Omit<PropertyOptions<string, StringConstructor>, 'type'> & {\n    minLength?: number;\n    maxLength?: number;\n    pattern?: RegExp;\n    patternMessage?: string;\n  },\n): PropertyDecorator {\n  const validators = [...(options?.validators || [])];\n\n  if (options?.minLength !== undefined) {\n    validators.unshift(minLengthValidator(options.minLength));\n  }\n  if (options?.maxLength !== undefined) {\n    validators.unshift(maxLengthValidator(options.maxLength));\n  }\n  if (options?.pattern !== undefined) {\n    validators.unshift(\n      patternValidator(options.pattern, options.patternMessage),\n    );\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  const { minLength, maxLength, pattern, patternMessage, ...restOptions } =\n    options || {};\n\n  return Property({\n    ...restOptions,\n    type: () => String,\n    validators: validators.length > 0 ? validators : undefined,\n  });\n}\n\n/**\n * Helper decorator for enum properties (string enums)\n * Validates that the string value matches one of the enum values\n * @param enumType - The enum object (e.g., MyEnum)\n * @param options - Additional property options\n * @example\n * enum Status {\n *   Active = 'active',\n *   Inactive = 'inactive'\n * }\n *\n * class User {\n *   @EnumProperty(Status)\n *   status!: Status;\n *\n *   @EnumProperty(Status, { optional: true })\n *   previousStatus?: Status;\n * }\n */\nexport function EnumProperty<T extends Record<string, string>>(\n  enumType: T,\n  options?: Omit<PropertyOptions<string, StringConstructor>, 'type'>,\n): PropertyDecorator {\n  const validators = options?.validators\n    ? [enumValidator(enumType), ...options.validators]\n    : [enumValidator(enumType)];\n\n  return Property({ ...options, type: () => String, validators });\n}\n\n/**\n * Helper decorator for number properties\n * @example\n * class User {\n *   @NumberProperty()\n *   age!: number;\n *\n *   @NumberProperty({ optional: true })\n *   score?: number;\n *\n *   @NumberProperty({ min: 0, max: 100 })\n *   percentage!: number;\n * }\n */\nexport function NumberProperty(\n  options?: Omit<PropertyOptions<number, NumberConstructor>, 'type'> & {\n    min?: number;\n    max?: number;\n  },\n): PropertyDecorator {\n  const validators = [...(options?.validators || [])];\n\n  if (options?.min !== undefined) {\n    validators.unshift(minValidator(options.min));\n  }\n  if (options?.max !== undefined) {\n    validators.unshift(maxValidator(options.max));\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  const { min, max, ...restOptions } = options || {};\n\n  return Property({\n    ...restOptions,\n    type: () => Number,\n    validators: validators.length > 0 ? validators : undefined,\n  });\n}\n\n/**\n * Helper decorator for integer properties\n * Validates that the number is an integer (no decimal places)\n * @example\n * class User {\n *   @IntProperty()\n *   age!: number;\n *\n *   @IntProperty({ optional: true })\n *   count?: number;\n *\n *   @IntProperty({ min: 0, max: 100 })\n *   percentage!: number;\n * }\n */\nexport function IntProperty(\n  options?: Omit<PropertyOptions<number, NumberConstructor>, 'type'> & {\n    min?: number;\n    max?: number;\n  },\n): PropertyDecorator {\n  const validators = [...(options?.validators || [])];\n\n  if (options?.min !== undefined) {\n    validators.unshift(minValidator(options.min));\n  }\n  if (options?.max !== undefined) {\n    validators.unshift(maxValidator(options.max));\n  }\n\n  validators.unshift(intValidator());\n\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  const { min, max, ...restOptions } = options || {};\n\n  return Property({\n    ...restOptions,\n    type: () => Number,\n    validators: validators.length > 0 ? validators : undefined,\n  });\n}\n\n/**\n * Helper decorator for boolean properties\n * @example\n * class User {\n *   @BooleanProperty()\n *   active!: boolean;\n *\n *   @BooleanProperty({ optional: true })\n *   verified?: boolean;\n * }\n */\nexport function BooleanProperty(\n  options?: Omit<PropertyOptions<boolean, BooleanConstructor>, 'type'>,\n): PropertyDecorator {\n  return Property({ ...options, type: () => Boolean });\n}\n\n/**\n * Helper decorator for Date properties\n * @example\n * class User {\n *   @DateProperty()\n *   createdAt!: Date;\n *\n *   @DateProperty({ optional: true })\n *   deletedAt?: Date;\n * }\n */\nexport function DateProperty(\n  options?: Omit<PropertyOptions<Date, DateConstructor>, 'type'>,\n): PropertyDecorator {\n  return Property({ ...options, type: () => Date });\n}\n\n/**\n * Helper decorator for BigInt properties\n * @example\n * class User {\n *   @BigIntProperty()\n *   id!: bigint;\n *\n *   @BigIntProperty({ optional: true })\n *   balance?: bigint;\n * }\n */\nexport function BigIntProperty(\n  options?: Omit<PropertyOptions<bigint, BigIntConstructor>, 'type'>,\n): PropertyDecorator {\n  return Property({ ...options, type: () => BigInt });\n}\n\n/**\n * Helper decorator for entity properties\n * @example\n * class User {\n *   @EntityProperty(() => Address)\n *   address!: Address;\n *\n *   @EntityProperty(() => Profile, { optional: true })\n *   profile?: Profile;\n * }\n */\nexport function EntityProperty<\n  T,\n  C extends AnyCtor<T> & { new (data: any): T },\n>(\n  type: () => C,\n  options?: Omit<PropertyOptions<T, C>, 'type'>,\n): PropertyDecorator {\n  return Property<T, C>({ ...options, type });\n}\n\n/**\n * Helper decorator for array properties\n * @example\n * class User {\n *   @ArrayProperty(() => String)\n *   tags!: string[];\n *\n *   @ArrayProperty(() => Phone)\n *   phones!: Phone[];\n *\n *   @ArrayProperty(() => Number, { optional: true })\n *   scores?: number[];\n *\n *   @ArrayProperty(() => String, { sparse: true })\n *   sparseList!: (string | null)[];\n *\n *   @ArrayProperty(() => String, { minLength: 1, maxLength: 10 })\n *   limitedList!: string[];\n * }\n */\nexport function ArrayProperty<T, C extends CtorLike<T>>(\n  type: () => C,\n  options?: Omit<PropertyOptions<T, C>, 'type' | 'array'> & {\n    minLength?: number;\n    maxLength?: number;\n  },\n): PropertyDecorator {\n  const arrayValidators = [...(options?.arrayValidators || [])];\n\n  if (options?.minLength !== undefined) {\n    arrayValidators.unshift(arrayMinLengthValidator(options.minLength));\n  }\n  if (options?.maxLength !== undefined) {\n    arrayValidators.unshift(arrayMaxLengthValidator(options.maxLength));\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  const { minLength, maxLength, ...restOptions } = options || {};\n\n  return Property({\n    ...restOptions,\n    type,\n    array: true,\n    arrayValidators: arrayValidators.length > 0 ? arrayValidators : undefined,\n  });\n}\n\n/**\n * Helper decorator for passthrough properties that bypass type validation.\n * Use this for generic types like Record<string, unknown>, any, or custom objects.\n * @example\n * class Config {\n *   @PassthroughProperty()\n *   metadata!: Record<string, unknown>;\n *\n *   @PassthroughProperty()\n *   customData!: any;\n * }\n */\nexport function PassthroughProperty(): PropertyDecorator {\n  return Property({ passthrough: true });\n}\n\nexport const StringifiableProperty = <\n  T extends { equals?(other: T): boolean; toString(): string },\n  C extends CtorLike<T> & { parse(value: string): T },\n>(\n  type: () => C,\n  data: Omit<\n    PropertyOptions<T, C>,\n    'serialize' | 'deserialize' | 'passthrough' | 'type' | 'equals'\n  > = {},\n): PropertyDecorator =>\n  Property<T, C>({\n    ...data,\n    type,\n    equals: (a, b) => (a.equals ? a.equals(b) : a.toString() === b.toString()),\n    serialize: (value) => value.toString(),\n    deserialize: (value) => {\n      if (typeof value === 'string') {\n        return type().parse(value) as InstanceOfCtorLike<C>;\n      }\n      throw new Error(`Invalid value ${type().name}: ${String(value)}`);\n    },\n  });\n\nexport const SerializableProperty = <\n  T extends { equals?(other: T): boolean; toJSON(): unknown },\n  C extends CtorLike<T> & { parse(value: unknown): T },\n>(\n  type: () => C,\n  data: Omit<\n    PropertyOptions<T, C>,\n    'serialize' | 'deserialize' | 'passthrough' | 'type' | 'equals'\n  > = {},\n) =>\n  Property({\n    ...data,\n    type,\n    equals: (a: T, b: T) =>\n      a.equals ? a.equals(b) : isEqual(a.toJSON(), b.toJSON()),\n    serialize: (value: T) => value.toJSON(),\n    deserialize: (value: unknown) => {\n      return type().parse(value) as InstanceOfCtorLike<C>;\n    },\n  });\n\n/**\n * Helper decorator for discriminated entity properties.\n * The entity type is determined at runtime using a discriminator property.\n * Unlike EntityProperty, this does not require the type parameter upfront.\n *\n * @param options - Configuration for the discriminated property\n *\n * @example\n * ```typescript\n * // Define entity types\n * @Entity({ name: 'Circle' })\n * class Circle {\n *   @StringProperty() readonly type = 'Circle';\n *   @NumberProperty() radius!: number;\n *   constructor(data: Partial<Circle>) { Object.assign(this, data); }\n * }\n *\n * @Entity({ name: 'Rectangle' })\n * class Rectangle {\n *   @StringProperty() readonly type = 'Rectangle';\n *   @NumberProperty() width!: number;\n *   @NumberProperty() height!: number;\n *   constructor(data: Partial<Rectangle>) { Object.assign(this, data); }\n * }\n *\n * // Use discriminated property\n * @Entity()\n * class Drawing {\n *   @DiscriminatedEntityProperty()\n *   shape!: Circle | Rectangle;\n *\n *   @DiscriminatedEntityProperty({ discriminatorProperty: 'entityType' })\n *   item!: BaseItem;\n * }\n *\n * // When serialized, the discriminator is included inline:\n * // { shape: { __type: 'Circle', radius: 5 } }\n *\n * // When deserialized, the discriminator is used to determine the type:\n * const drawing = await EntityUtils.parse(Drawing, {\n *   shape: { __type: 'Circle', radius: 5 }\n * });\n * // drawing.shape is a Circle instance\n * ```\n */\nexport function DiscriminatedEntityProperty(\n  options?: Omit<PropertyOptions<any, any>, 'type' | 'discriminated'> & {\n    discriminatorProperty?: string;\n  },\n): PropertyDecorator {\n  const discriminatorProperty = options?.discriminatorProperty ?? '__type';\n\n  return Property({\n    ...options,\n    discriminated: true,\n    discriminatorProperty,\n  });\n}\n"],"names":["isEqual","PROPERTY_METADATA_KEY","PROPERTY_OPTIONS_METADATA_KEY","enumValidator","intValidator","minLengthValidator","maxLengthValidator","patternValidator","minValidator","maxValidator","arrayMinLengthValidator","arrayMaxLengthValidator","Property","options","target","propertyKey","existingProperties","Reflect","getOwnMetadata","includes","push","defineMetadata","passthrough","array","Error","optional","sparse","serialize","undefined","deserialize","arrayValidators","hasSerialize","hasDeserialize","existingOptions","StringProperty","validators","minLength","unshift","maxLength","pattern","patternMessage","restOptions","type","String","length","EnumProperty","enumType","NumberProperty","min","max","Number","IntProperty","BooleanProperty","Boolean","DateProperty","Date","BigIntProperty","BigInt","EntityProperty","ArrayProperty","PassthroughProperty","StringifiableProperty","data","equals","a","b","toString","value","parse","name","SerializableProperty","toJSON","DiscriminatedEntityProperty","discriminatorProperty","discriminated"],"mappings":"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"}

package/dist/lib/test-entities.d.ts

@@ -0,0 +1,474 @@
+import 'reflect-metadata';
+import { Problem } from './problem.js';
+/**
+ * Basic entity with common primitive types
+ * Features: String, Number, Boolean properties
+ */
+export declare class TestUser {
+    name: string;
+    age: number;
+    active: boolean;
+    constructor(data: {
+        name: string;
+        age: number;
+        active: boolean;
+    });
+}
+/**
+ * Entity with different primitive combinations
+ * Features: String, Number, Int, Date properties
+ */
+export declare class TestProduct {
+    id: string;
+    name: string;
+    price: number;
+    quantity: number;
+    createdAt: Date;
+    constructor(data: {
+        id: string;
+        name: string;
+        price: number;
+        quantity: number;
+        createdAt: Date;
+    });
+}
+/**
+ * Entity with Date and BigInt types
+ * Features: DateProperty, BigIntProperty
+ */
+export declare class EntityWithSpecialTypes {
+    timestamp: Date;
+    largeNumber: bigint;
+    label: string;
+    constructor(data: {
+        timestamp: Date;
+        largeNumber: bigint;
+        label: string;
+    });
+}
+/**
+ * Entity with property-level validators
+ * Features: String validators (minLength, maxLength, pattern)
+ */
+export declare class ValidatedEntity {
+    username: string;
+    email: string;
+    age: number;
+    constructor(data: {
+        username: string;
+        email: string;
+        age: number;
+    });
+}
+/**
+ * Entity with cross-property validation
+ * Features: @EntityValidator decorator
+ */
+export declare class CrossValidatedEntity {
+    password: string;
+    confirmPassword: string;
+    startDate: Date;
+    endDate: Date;
+    constructor(data: {
+        password: string;
+        confirmPassword: string;
+        startDate: Date;
+        endDate: Date;
+    });
+    validatePasswords(): Problem[];
+    validateDates(): Problem[];
+}
+/**
+ * Entity with mix of optional and required properties
+ * Features: optional flag
+ */
+export declare class OptionalFieldsEntity {
+    requiredField: string;
+    optionalField?: string;
+    optionalNumber?: number;
+    requiredBoolean: boolean;
+    constructor(data: {
+        requiredField: string;
+        optionalField?: string;
+        optionalNumber?: number;
+        requiredBoolean: boolean;
+    });
+}
+/**
+ * Entity with various default value strategies
+ * Features: Static defaults, factory defaults, async factory defaults
+ */
+export declare class EntityWithDefaults {
+    name: string;
+    counter: number;
+    timestamp: Date;
+    asyncField: string;
+    enabled: boolean;
+    constructor(data: {
+        name?: string;
+        counter?: number;
+        timestamp?: Date;
+        asyncField?: string;
+        enabled?: boolean;
+    });
+}
+/**
+ * Entity with various array configurations
+ * Features: Regular arrays, sparse arrays, array validators
+ */
+export declare class EntityWithArrays {
+    tags: string[];
+    ratings: number[];
+    sparseArray: (string | null | undefined)[];
+    users: TestUser[];
+    constructor(data: {
+        tags: string[];
+        ratings: number[];
+        sparseArray: (string | null | undefined)[];
+        users: TestUser[];
+    });
+}
+export declare enum UserRole {
+    ADMIN = "admin",
+    USER = "user",
+    GUEST = "guest"
+}
+export declare enum ProductStatus {
+    DRAFT = "draft",
+    PUBLISHED = "published",
+    ARCHIVED = "archived"
+}
+/**
+ * Entity with enum properties
+ * Features: EnumProperty decorator
+ */
+export declare class EntityWithEnum {
+    name: string;
+    role: UserRole;
+    status: ProductStatus;
+    constructor(data: {
+        name: string;
+        role: UserRole;
+        status: ProductStatus;
+    });
+}
+/**
+ * Level 1: Simple address entity
+ * Features: Basic nested entity
+ */
+export declare class TestAddress {
+    street: string;
+    city: string;
+    country: string;
+    zipCode: number;
+    constructor(data: {
+        street: string;
+        city: string;
+        country: string;
+        zipCode: number;
+    });
+}
+/**
+ * Level 2: Company with nested address
+ * Features: 1-level nesting
+ */
+export declare class TestCompany {
+    name: string;
+    address: TestAddress;
+    employeeCount: number;
+    constructor(data: {
+        name: string;
+        address: TestAddress;
+        employeeCount: number;
+    });
+}
+/**
+ * Level 3: Employee with nested company (which has nested address)
+ * Features: 2-level nesting
+ */
+export declare class TestEmployee {
+    name: string;
+    email: string;
+    company: TestCompany;
+    salary: number;
+    hireDate: Date;
+    constructor(data: {
+        name: string;
+        email: string;
+        company: TestCompany;
+        salary: number;
+        hireDate: Date;
+    });
+}
+/**
+ * Entity with optional nested entities
+ * Features: Optional nested entities
+ */
+export declare class EntityWithOptionalNested {
+    id: string;
+    billingAddress?: TestAddress;
+    shippingAddress?: TestAddress;
+    constructor(data: {
+        id: string;
+        billingAddress?: TestAddress;
+        shippingAddress?: TestAddress;
+    });
+}
+/**
+ * Collection entity wrapping string array
+ * Features: @CollectionEntity decorator, unwraps to array
+ */
+export declare class TestTags {
+    readonly collection: string[];
+    constructor(data: {
+        collection: string[];
+    });
+}
+/**
+ * Collection entity wrapping number array
+ * Features: @CollectionEntity with numbers
+ */
+export declare class TestIdList {
+    readonly collection: number[];
+    constructor(data: {
+        collection: number[];
+    });
+}
+/**
+ * Collection entity with entity items
+ * Features: @CollectionEntity with nested entities
+ */
+export declare class TestUserCollection {
+    readonly collection: TestUser[];
+    constructor(data: {
+        collection: TestUser[];
+    });
+}
+/**
+ * Stringifiable entity for user IDs
+ * Features: @Stringifiable decorator, unwraps to string
+ */
+export declare class TestUserId {
+    readonly value: string;
+    constructor(data: {
+        value: string;
+    });
+}
+/**
+ * Stringifiable entity for emails with validation
+ * Features: @Stringifiable with validation
+ */
+export declare class TestEmail {
+    readonly value: string;
+    constructor(data: {
+        value: string;
+    });
+}
+/**
+ * Entity using stringifiable properties
+ * Features: Properties that are stringifiable entities
+ */
+export declare class EntityWithStringifiable {
+    userId: TestUserId;
+    email: TestEmail;
+    name: string;
+    constructor(data: {
+        userId: TestUserId;
+        email: TestEmail;
+        name: string;
+    });
+}
+export interface ILogger {
+    log(message: string): void;
+}
+export declare const LOGGER_TOKEN: unique symbol;
+/**
+ * Entity with injected properties
+ * Features: @InjectedProperty decorator
+ */
+export declare class EntityWithDI {
+    name: string;
+    logger: ILogger;
+    constructor(data: {
+        name: string;
+        logger?: ILogger;
+    });
+    logName(): void;
+}
+/**
+ * Entity with passthrough properties
+ * Features: @PassthroughProperty for unknown types
+ */
+export declare class EntityWithPassthrough {
+    id: string;
+    metadata: Record<string, unknown>;
+    config: unknown;
+    constructor(data: {
+        id: string;
+        metadata: Record<string, unknown>;
+        config: unknown;
+    });
+}
+/**
+ * Custom serializable class
+ */
+export declare class CustomValue {
+    x: number;
+    y: number;
+    constructor(x: number, y: number);
+    toData(): {
+        x: number;
+        y: number;
+    };
+    static fromData(data: {
+        x: number;
+        y: number;
+    }): CustomValue;
+}
+/**
+ * Entity with custom serialize/deserialize
+ * Features: Custom serialization functions
+ */
+export declare class EntityWithCustomSerialization {
+    name: string;
+    position: CustomValue;
+    constructor(data: {
+        name: string;
+        position: CustomValue;
+    });
+}
+/**
+ * Custom class with equals method
+ */
+export declare class CustomPoint {
+    x: number;
+    y: number;
+    constructor(x: number, y: number);
+    equals(other: CustomPoint): boolean;
+    toString(): string;
+    static fromString(str: string): CustomPoint;
+}
+/**
+ * Entity with custom equals function
+ * Features: Custom equality comparison
+ */
+export declare class EntityWithCustomEquals {
+    id: string;
+    location: CustomPoint;
+    constructor(data: {
+        id: string;
+        location: CustomPoint;
+    });
+}
+/**
+ * Custom class implementing Serializable interface
+ */
+export declare class SerializableValue {
+    data: string;
+    constructor(data: string);
+    toJSON(): string;
+    equals(other: SerializableValue): boolean;
+    static parse(json: unknown): SerializableValue;
+}
+/**
+ * Entity using SerializableProperty
+ * Features: @SerializableProperty decorator
+ */
+export declare class EntityWithSerializable {
+    name: string;
+    value: SerializableValue;
+    constructor(data: {
+        name: string;
+        value: SerializableValue;
+    });
+}
+/**
+ * Custom class implementing Parseable interface
+ */
+export declare class ParseableValue {
+    data: number;
+    constructor(data: number);
+    toString(): string;
+    equals(other: ParseableValue): boolean;
+    static parse(str: string): ParseableValue;
+}
+/**
+ * Entity using StringifiableProperty
+ * Features: @StringifiableProperty decorator
+ */
+export declare class EntityWithParseable {
+    label: string;
+    value: ParseableValue;
+    constructor(data: {
+        label: string;
+        value: ParseableValue;
+    });
+}
+/**
+ * Entity with Zod validation
+ * Features: @ZodProperty decorator
+ */
+export declare class EntityWithZod {
+    username: string;
+    email: string;
+    count: number;
+    constructor(data: {
+        username: string;
+        email: string;
+        count: number;
+    });
+}
+/**
+ * Entity with immutable (preventUpdates) properties
+ * Features: preventUpdates flag
+ */
+export declare class EntityWithImmutable {
+    readonly id: string;
+    name: string;
+    readonly createdAt: Date;
+    value: number;
+    constructor(data: {
+        id: string;
+        name: string;
+        createdAt: Date;
+        value: number;
+    });
+}
+/**
+ * Complex entity combining multiple features
+ * Features: All common features in one entity
+ * - Primitives, enums, nested entities, arrays
+ * - Optional fields, defaults, validation
+ * - Custom serialization, stringifiable properties
+ */
+export declare class ComplexEntity {
+    readonly id: string;
+    name: string;
+    role: UserRole;
+    userId: TestUserId;
+    address: TestAddress;
+    tags: string[];
+    products: TestProduct[];
+    score?: number;
+    createdAt: Date;
+    updatedAt?: Date;
+    active: boolean;
+    metadata: Record<string, unknown>;
+    constructor(data: {
+        id: string;
+        name: string;
+        role: UserRole;
+        userId: TestUserId;
+        address: TestAddress;
+        tags: string[];
+        products: TestProduct[];
+        score?: number;
+        createdAt?: Date;
+        updatedAt?: Date;
+        active?: boolean;
+        metadata: Record<string, unknown>;
+    });
+    validateProducts(): Problem[];
+}
+export declare function resetFactoryCallCount(): void;
+//# sourceMappingURL=test-entities.d.ts.map