@rtpaulino/entity 0.24.2 → 0.26.0

package/dist/lib/entity.js

@@ -1,5 +1,6 @@
-import { ENTITY_METADATA_KEY, ENTITY_OPTIONS_METADATA_KEY, ENTITY_VALIDATOR_METADATA_KEY } from './types.js';
+/* eslint-disable @typescript-eslint/no-unsafe-function-type */ import { ENTITY_METADATA_KEY, ENTITY_OPTIONS_METADATA_KEY, ENTITY_VALIDATOR_METADATA_KEY, POLYMORPHIC_VARIANT_METADATA_KEY } from './types.js';
 import { EntityRegistry } from './entity-registry.js';
+import { PolymorphicRegistry } from './polymorphic-registry.js';
 /**
  * Decorator that marks a class as an Entity.
  * This allows us to identify entity instances later.
@@ -167,5 +168,75 @@ import { EntityRegistry } from './entity-registry.js';
         Reflect.defineMetadata(ENTITY_VALIDATOR_METADATA_KEY, existingValidators, target);
     };
 }
+/**
+ * Decorator that registers a class as a polymorphic variant of a base class.
+ *
+ * Used for class hierarchies where an abstract base class has multiple concrete implementations,
+ * and a discriminator property determines which variant to instantiate during parsing.
+ *
+ * @param baseClass - The base class this variant extends (must have a @PolymorphicProperty)
+ * @param discriminatorValue - The value of the discriminator property that identifies this variant
+ *
+ * @example
+ * ```typescript
+ * enum SchemaPropertyType {
+ *   STRING = 'string',
+ *   NUMBER = 'number',
+ * }
+ *
+ * @Entity()
+ * abstract class SchemaProperty {
+ *   @StringProperty({ minLength: 1 })
+ *   name!: string;
+ *
+ *   @PolymorphicProperty(SchemaPropertyType)
+ *   type!: SchemaPropertyType;
+ * }
+ *
+ * @Entity()
+ * @PolymorphicVariant(SchemaProperty, SchemaPropertyType.STRING)
+ * class StringSchemaProperty extends SchemaProperty {
+ *   readonly type = SchemaPropertyType.STRING;
+ *
+ *   @IntProperty({ optional: true })
+ *   minLength?: number;
+ *
+ *   constructor(data: { name: string; minLength?: number }) {
+ *     super({ ...data, type: SchemaPropertyType.STRING });
+ *     this.minLength = data.minLength;
+ *   }
+ * }
+ *
+ * @Entity()
+ * @PolymorphicVariant(SchemaProperty, SchemaPropertyType.NUMBER)
+ * class NumberSchemaProperty extends SchemaProperty {
+ *   readonly type = SchemaPropertyType.NUMBER;
+ *
+ *   @NumberProperty({ optional: true })
+ *   min?: number;
+ *
+ *   constructor(data: { name: string; min?: number }) {
+ *     super({ ...data, type: SchemaPropertyType.NUMBER });
+ *     this.min = data.min;
+ *   }
+ * }
+ *
+ * // Parsing automatically selects the correct variant based on 'type'
+ * const data = { name: 'age', type: 'number', min: 0 };
+ * const prop = await EntityUtils.parse(SchemaProperty, data);
+ * // prop is NumberSchemaProperty instance
+ * ```
+ */ export function PolymorphicVariant(baseClass, discriminatorValue) {
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+    return function(target) {
+        // Register the variant in the registry
+        PolymorphicRegistry.registerVariant(baseClass, discriminatorValue, target);
+        // Store metadata on the class for introspection
+        Reflect.defineMetadata(POLYMORPHIC_VARIANT_METADATA_KEY, {
+            baseClass,
+            discriminatorValue
+        }, target);
+    };
+}
 
 //# sourceMappingURL=entity.js.map

package/dist/lib/entity.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/entity.ts"],"sourcesContent":["import {\n  ENTITY_METADATA_KEY,\n  ENTITY_OPTIONS_METADATA_KEY,\n  ENTITY_VALIDATOR_METADATA_KEY,\n} from './types.js';\nimport { EntityRegistry } from './entity-registry.js';\n\n/**\n * Options for Entity decorator\n */\nexport interface EntityOptions {\n  /**\n   * Optional name for the entity. Used for discriminated entity deserialization.\n   * If not specified, the class name will be used.\n   * Must be unique across all entities - conflicts will throw an error.\n   */\n  name?: string;\n  /**\n   * Whether this entity represents a collection.\n   * Collection entities must have a 'collection' property that is an array.\n   * When serialized, collection entities are unwrapped to just their array.\n   * When deserialized from an array, the array is wrapped in { collection: [...] }.\n   */\n  collection?: boolean;\n  /**\n   * Whether this entity represents a stringifiable value.\n   * Stringifiable classes must have a 'value' property that is a string.\n   * When serialized, stringifiable instances are unwrapped to just their string.\n   * When deserialized from a string, the string is wrapped in { value: \"...\" }.\n   */\n  stringifiable?: boolean;\n  /**\n   * The name of the single \"wrapper\" property for entities that act as transparent wrappers.\n   * When set, this property name is excluded from error paths during validation.\n   * Used by @CollectionEntity ('collection') and @Stringifiable ('value').\n   */\n  wrapperProperty?: string;\n  /**\n   * Whether to register this entity in the EntityRegistry.\n   * Set to false for dynamic entities to prevent memory leaks.\n   * Defaults to true.\n   */\n  register?: boolean;\n}\n\n/**\n * Decorator that marks a class as an Entity.\n * This allows us to identify entity instances later.\n *\n * @param options - Optional configuration for the entity\n *\n * @example\n * ```typescript\n * @Entity()\n * class User {\n *   name: string;\n * }\n *\n * @Entity({ name: 'CustomUser' })\n * class User {\n *   name: string;\n * }\n *\n * @Entity({ collection: true })\n * class Tags {\n *   @ArrayProperty(() => String)\n *   collection: string[];\n * }\n * ```\n */\nexport function Entity(options: EntityOptions = {}): ClassDecorator {\n  // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type\n  return function (target: Function) {\n    // Store metadata on the class constructor\n    Reflect.defineMetadata(ENTITY_METADATA_KEY, true, target);\n\n    // Determine the entity name - use provided name or fall back to class name\n    const entityName = options.name ?? target.name;\n\n    // Register the entity in the global registry (unless explicitly disabled)\n    const shouldRegister = options.register !== false;\n    if (shouldRegister) {\n      EntityRegistry.register(entityName, target);\n    }\n\n    // Store the name in options for later retrieval\n    const optionsWithName = { ...options, name: entityName };\n\n    Reflect.defineMetadata(\n      ENTITY_OPTIONS_METADATA_KEY,\n      optionsWithName,\n      target,\n    );\n  };\n}\n\n/**\n * Decorator that marks a class as a Collection Entity.\n * This is syntax sugar for @Entity({ collection: true }).\n *\n * Collection entities must have a 'collection' property that is an array.\n * When serialized with EntityUtils.toJSON(), they are unwrapped to just the array.\n * When deserialized from an array, the array is wrapped in { collection: [...] }.\n *\n * @example\n * ```typescript\n * @CollectionEntity()\n * class Tags {\n *   @ArrayProperty(() => String)\n *   readonly collection: string[];\n *\n *   constructor(data: { collection: string[] }) {\n *     this.collection = data.collection;\n *   }\n * }\n *\n * @Entity()\n * class Article {\n *   @EntityProperty(() => Tags)\n *   tags!: Tags;\n * }\n *\n * const article = new Article(...);\n * const json = EntityUtils.toJSON(article);\n * // { tags: [\"tag1\", \"tag2\"] } - unwrapped to array\n *\n * // Also works when serializing the collection directly:\n * const tagsJson = EntityUtils.toJSON(tags);\n * // [\"tag1\", \"tag2\"] - unwrapped to array\n * ```\n */\nexport function CollectionEntity(\n  options: Pick<EntityOptions, 'name'> = {},\n): ClassDecorator {\n  return Entity({\n    collection: true,\n    wrapperProperty: 'collection',\n    ...options,\n  });\n}\n\n/**\n * Decorator that marks a class as Stringifiable.\n * This is syntax sugar for @Entity({ stringifiable: true }).\n *\n * Stringifiable classes must have a 'value' property that is a string.\n * When serialized with EntityUtils.toJSON(), they are unwrapped to just the string.\n * When deserialized from a string, the string is wrapped in { value: \"...\" }.\n *\n * @example\n * ```typescript\n * @Stringifiable()\n * class UserId {\n *   @StringProperty()\n *   readonly value: string;\n *\n *   constructor(data: { value: string }) {\n *     this.value = data.value;\n *   }\n * }\n *\n * @Entity()\n * class User {\n *   @EntityProperty(() => UserId)\n *   id!: UserId;\n * }\n *\n * const user = new User(...);\n * const json = EntityUtils.toJSON(user);\n * // { id: \"user-123\" } - unwrapped to string\n *\n * // Also works when serializing the stringifiable directly:\n * const userId = new UserId({ value: \"user-123\" });\n * const idJson = EntityUtils.toJSON(userId);\n * // \"user-123\" - unwrapped to string\n *\n * // Parse from string:\n * const parsed = await EntityUtils.parse(UserId, \"user-456\");\n * // UserId { value: \"user-456\" }\n * ```\n */\nexport function Stringifiable(\n  options: Pick<EntityOptions, 'name'> = {},\n): ClassDecorator {\n  return Entity({ stringifiable: true, wrapperProperty: 'value', ...options });\n}\n\n/**\n * Decorator that marks a method as an entity validator.\n * The method should return an array of Problems.\n *\n * @example\n * ```typescript\n * @Entity()\n * class User {\n *   @Property({ type: () => String }) firstName!: string;\n *   @Property({ type: () => String }) lastName!: string;\n *\n *   @EntityValidator()\n *   validateNames(): Problem[] {\n *     const problems: Problem[] = [];\n *     if (this.firstName === this.lastName) {\n *       problems.push(new Problem({\n *         property: 'firstName',\n *         message: 'First and last name cannot be the same'\n *       }));\n *     }\n *     return problems;\n *   }\n * }\n * ```\n */\nexport function EntityValidator(): MethodDecorator {\n  return (target: object, propertyKey: string | symbol): void => {\n    if (typeof propertyKey !== 'string') {\n      return;\n    }\n\n    const existingValidators: string[] =\n      Reflect.getOwnMetadata(ENTITY_VALIDATOR_METADATA_KEY, target) || [];\n\n    if (!existingValidators.includes(propertyKey)) {\n      existingValidators.push(propertyKey);\n    }\n\n    Reflect.defineMetadata(\n      ENTITY_VALIDATOR_METADATA_KEY,\n      existingValidators,\n      target,\n    );\n  };\n}\n"],"names":["ENTITY_METADATA_KEY","ENTITY_OPTIONS_METADATA_KEY","ENTITY_VALIDATOR_METADATA_KEY","EntityRegistry","Entity","options","target","Reflect","defineMetadata","entityName","name","shouldRegister","register","optionsWithName","CollectionEntity","collection","wrapperProperty","Stringifiable","stringifiable","EntityValidator","propertyKey","existingValidators","getOwnMetadata","includes","push"],"mappings":"AAAA,SACEA,mBAAmB,EACnBC,2BAA2B,EAC3BC,6BAA6B,QACxB,aAAa;AACpB,SAASC,cAAc,QAAQ,uBAAuB;AAwCtD;;;;;;;;;;;;;;;;;;;;;;;;CAwBC,GACD,OAAO,SAASC,OAAOC,UAAyB,CAAC,CAAC;IAChD,sEAAsE;IACtE,OAAO,SAAUC,MAAgB;QAC/B,0CAA0C;QAC1CC,QAAQC,cAAc,CAACR,qBAAqB,MAAMM;QAElD,2EAA2E;QAC3E,MAAMG,aAAaJ,QAAQK,IAAI,IAAIJ,OAAOI,IAAI;QAE9C,0EAA0E;QAC1E,MAAMC,iBAAiBN,QAAQO,QAAQ,KAAK;QAC5C,IAAID,gBAAgB;YAClBR,eAAeS,QAAQ,CAACH,YAAYH;QACtC;QAEA,gDAAgD;QAChD,MAAMO,kBAAkB;YAAE,GAAGR,OAAO;YAAEK,MAAMD;QAAW;QAEvDF,QAAQC,cAAc,CACpBP,6BACAY,iBACAP;IAEJ;AACF;AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkCC,GACD,OAAO,SAASQ,iBACdT,UAAuC,CAAC,CAAC;IAEzC,OAAOD,OAAO;QACZW,YAAY;QACZC,iBAAiB;QACjB,GAAGX,OAAO;IACZ;AACF;AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuCC,GACD,OAAO,SAASY,cACdZ,UAAuC,CAAC,CAAC;IAEzC,OAAOD,OAAO;QAAEc,eAAe;QAAMF,iBAAiB;QAAS,GAAGX,OAAO;IAAC;AAC5E;AAEA;;;;;;;;;;;;;;;;;;;;;;;;CAwBC,GACD,OAAO,SAASc;IACd,OAAO,CAACb,QAAgBc;QACtB,IAAI,OAAOA,gBAAgB,UAAU;YACnC;QACF;QAEA,MAAMC,qBACJd,QAAQe,cAAc,CAACpB,+BAA+BI,WAAW,EAAE;QAErE,IAAI,CAACe,mBAAmBE,QAAQ,CAACH,cAAc;YAC7CC,mBAAmBG,IAAI,CAACJ;QAC1B;QAEAb,QAAQC,cAAc,CACpBN,+BACAmB,oBACAf;IAEJ;AACF"}
+{"version":3,"sources":["../../src/lib/entity.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-unsafe-function-type */\nimport {\n  ENTITY_METADATA_KEY,\n  ENTITY_OPTIONS_METADATA_KEY,\n  ENTITY_VALIDATOR_METADATA_KEY,\n  POLYMORPHIC_VARIANT_METADATA_KEY,\n} from './types.js';\nimport { EntityRegistry } from './entity-registry.js';\nimport { PolymorphicRegistry } from './polymorphic-registry.js';\n\n/**\n * Options for Entity decorator\n */\nexport interface EntityOptions {\n  /**\n   * Optional name for the entity. Used for discriminated entity deserialization.\n   * If not specified, the class name will be used.\n   * Must be unique across all entities - conflicts will throw an error.\n   */\n  name?: string;\n  /**\n   * Whether this entity represents a collection.\n   * Collection entities must have a 'collection' property that is an array.\n   * When serialized, collection entities are unwrapped to just their array.\n   * When deserialized from an array, the array is wrapped in { collection: [...] }.\n   */\n  collection?: boolean;\n  /**\n   * Whether this entity represents a stringifiable value.\n   * Stringifiable classes must have a 'value' property that is a string.\n   * When serialized, stringifiable instances are unwrapped to just their string.\n   * When deserialized from a string, the string is wrapped in { value: \"...\" }.\n   */\n  stringifiable?: boolean;\n  /**\n   * The name of the single \"wrapper\" property for entities that act as transparent wrappers.\n   * When set, this property name is excluded from error paths during validation.\n   * Used by @CollectionEntity ('collection') and @Stringifiable ('value').\n   */\n  wrapperProperty?: string;\n  /**\n   * Whether to register this entity in the EntityRegistry.\n   * Set to false for dynamic entities to prevent memory leaks.\n   * Defaults to true.\n   */\n  register?: boolean;\n}\n\n/**\n * Decorator that marks a class as an Entity.\n * This allows us to identify entity instances later.\n *\n * @param options - Optional configuration for the entity\n *\n * @example\n * ```typescript\n * @Entity()\n * class User {\n *   name: string;\n * }\n *\n * @Entity({ name: 'CustomUser' })\n * class User {\n *   name: string;\n * }\n *\n * @Entity({ collection: true })\n * class Tags {\n *   @ArrayProperty(() => String)\n *   collection: string[];\n * }\n * ```\n */\nexport function Entity(options: EntityOptions = {}): ClassDecorator {\n  // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type\n  return function (target: Function) {\n    // Store metadata on the class constructor\n    Reflect.defineMetadata(ENTITY_METADATA_KEY, true, target);\n\n    // Determine the entity name - use provided name or fall back to class name\n    const entityName = options.name ?? target.name;\n\n    // Register the entity in the global registry (unless explicitly disabled)\n    const shouldRegister = options.register !== false;\n    if (shouldRegister) {\n      EntityRegistry.register(entityName, target);\n    }\n\n    // Store the name in options for later retrieval\n    const optionsWithName = { ...options, name: entityName };\n\n    Reflect.defineMetadata(\n      ENTITY_OPTIONS_METADATA_KEY,\n      optionsWithName,\n      target,\n    );\n  };\n}\n\n/**\n * Decorator that marks a class as a Collection Entity.\n * This is syntax sugar for @Entity({ collection: true }).\n *\n * Collection entities must have a 'collection' property that is an array.\n * When serialized with EntityUtils.toJSON(), they are unwrapped to just the array.\n * When deserialized from an array, the array is wrapped in { collection: [...] }.\n *\n * @example\n * ```typescript\n * @CollectionEntity()\n * class Tags {\n *   @ArrayProperty(() => String)\n *   readonly collection: string[];\n *\n *   constructor(data: { collection: string[] }) {\n *     this.collection = data.collection;\n *   }\n * }\n *\n * @Entity()\n * class Article {\n *   @EntityProperty(() => Tags)\n *   tags!: Tags;\n * }\n *\n * const article = new Article(...);\n * const json = EntityUtils.toJSON(article);\n * // { tags: [\"tag1\", \"tag2\"] } - unwrapped to array\n *\n * // Also works when serializing the collection directly:\n * const tagsJson = EntityUtils.toJSON(tags);\n * // [\"tag1\", \"tag2\"] - unwrapped to array\n * ```\n */\nexport function CollectionEntity(\n  options: Pick<EntityOptions, 'name'> = {},\n): ClassDecorator {\n  return Entity({\n    collection: true,\n    wrapperProperty: 'collection',\n    ...options,\n  });\n}\n\n/**\n * Decorator that marks a class as Stringifiable.\n * This is syntax sugar for @Entity({ stringifiable: true }).\n *\n * Stringifiable classes must have a 'value' property that is a string.\n * When serialized with EntityUtils.toJSON(), they are unwrapped to just the string.\n * When deserialized from a string, the string is wrapped in { value: \"...\" }.\n *\n * @example\n * ```typescript\n * @Stringifiable()\n * class UserId {\n *   @StringProperty()\n *   readonly value: string;\n *\n *   constructor(data: { value: string }) {\n *     this.value = data.value;\n *   }\n * }\n *\n * @Entity()\n * class User {\n *   @EntityProperty(() => UserId)\n *   id!: UserId;\n * }\n *\n * const user = new User(...);\n * const json = EntityUtils.toJSON(user);\n * // { id: \"user-123\" } - unwrapped to string\n *\n * // Also works when serializing the stringifiable directly:\n * const userId = new UserId({ value: \"user-123\" });\n * const idJson = EntityUtils.toJSON(userId);\n * // \"user-123\" - unwrapped to string\n *\n * // Parse from string:\n * const parsed = await EntityUtils.parse(UserId, \"user-456\");\n * // UserId { value: \"user-456\" }\n * ```\n */\nexport function Stringifiable(\n  options: Pick<EntityOptions, 'name'> = {},\n): ClassDecorator {\n  return Entity({ stringifiable: true, wrapperProperty: 'value', ...options });\n}\n\n/**\n * Decorator that marks a method as an entity validator.\n * The method should return an array of Problems.\n *\n * @example\n * ```typescript\n * @Entity()\n * class User {\n *   @Property({ type: () => String }) firstName!: string;\n *   @Property({ type: () => String }) lastName!: string;\n *\n *   @EntityValidator()\n *   validateNames(): Problem[] {\n *     const problems: Problem[] = [];\n *     if (this.firstName === this.lastName) {\n *       problems.push(new Problem({\n *         property: 'firstName',\n *         message: 'First and last name cannot be the same'\n *       }));\n *     }\n *     return problems;\n *   }\n * }\n * ```\n */\nexport function EntityValidator(): MethodDecorator {\n  return (target: object, propertyKey: string | symbol): void => {\n    if (typeof propertyKey !== 'string') {\n      return;\n    }\n\n    const existingValidators: string[] =\n      Reflect.getOwnMetadata(ENTITY_VALIDATOR_METADATA_KEY, target) || [];\n\n    if (!existingValidators.includes(propertyKey)) {\n      existingValidators.push(propertyKey);\n    }\n\n    Reflect.defineMetadata(\n      ENTITY_VALIDATOR_METADATA_KEY,\n      existingValidators,\n      target,\n    );\n  };\n}\n\n/**\n * Decorator that registers a class as a polymorphic variant of a base class.\n *\n * Used for class hierarchies where an abstract base class has multiple concrete implementations,\n * and a discriminator property determines which variant to instantiate during parsing.\n *\n * @param baseClass - The base class this variant extends (must have a @PolymorphicProperty)\n * @param discriminatorValue - The value of the discriminator property that identifies this variant\n *\n * @example\n * ```typescript\n * enum SchemaPropertyType {\n *   STRING = 'string',\n *   NUMBER = 'number',\n * }\n *\n * @Entity()\n * abstract class SchemaProperty {\n *   @StringProperty({ minLength: 1 })\n *   name!: string;\n *\n *   @PolymorphicProperty(SchemaPropertyType)\n *   type!: SchemaPropertyType;\n * }\n *\n * @Entity()\n * @PolymorphicVariant(SchemaProperty, SchemaPropertyType.STRING)\n * class StringSchemaProperty extends SchemaProperty {\n *   readonly type = SchemaPropertyType.STRING;\n *\n *   @IntProperty({ optional: true })\n *   minLength?: number;\n *\n *   constructor(data: { name: string; minLength?: number }) {\n *     super({ ...data, type: SchemaPropertyType.STRING });\n *     this.minLength = data.minLength;\n *   }\n * }\n *\n * @Entity()\n * @PolymorphicVariant(SchemaProperty, SchemaPropertyType.NUMBER)\n * class NumberSchemaProperty extends SchemaProperty {\n *   readonly type = SchemaPropertyType.NUMBER;\n *\n *   @NumberProperty({ optional: true })\n *   min?: number;\n *\n *   constructor(data: { name: string; min?: number }) {\n *     super({ ...data, type: SchemaPropertyType.NUMBER });\n *     this.min = data.min;\n *   }\n * }\n *\n * // Parsing automatically selects the correct variant based on 'type'\n * const data = { name: 'age', type: 'number', min: 0 };\n * const prop = await EntityUtils.parse(SchemaProperty, data);\n * // prop is NumberSchemaProperty instance\n * ```\n */\nexport function PolymorphicVariant<T extends Function>(\n  baseClass: T,\n  discriminatorValue: unknown,\n): ClassDecorator {\n  // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type\n  return function (target: Function) {\n    // Register the variant in the registry\n    PolymorphicRegistry.registerVariant(baseClass, discriminatorValue, target);\n\n    // Store metadata on the class for introspection\n    Reflect.defineMetadata(\n      POLYMORPHIC_VARIANT_METADATA_KEY,\n      { baseClass, discriminatorValue },\n      target,\n    );\n  };\n}\n"],"names":["ENTITY_METADATA_KEY","ENTITY_OPTIONS_METADATA_KEY","ENTITY_VALIDATOR_METADATA_KEY","POLYMORPHIC_VARIANT_METADATA_KEY","EntityRegistry","PolymorphicRegistry","Entity","options","target","Reflect","defineMetadata","entityName","name","shouldRegister","register","optionsWithName","CollectionEntity","collection","wrapperProperty","Stringifiable","stringifiable","EntityValidator","propertyKey","existingValidators","getOwnMetadata","includes","push","PolymorphicVariant","baseClass","discriminatorValue","registerVariant"],"mappings":"AAAA,6DAA6D,GAC7D,SACEA,mBAAmB,EACnBC,2BAA2B,EAC3BC,6BAA6B,EAC7BC,gCAAgC,QAC3B,aAAa;AACpB,SAASC,cAAc,QAAQ,uBAAuB;AACtD,SAASC,mBAAmB,QAAQ,4BAA4B;AAwChE;;;;;;;;;;;;;;;;;;;;;;;;CAwBC,GACD,OAAO,SAASC,OAAOC,UAAyB,CAAC,CAAC;IAChD,sEAAsE;IACtE,OAAO,SAAUC,MAAgB;QAC/B,0CAA0C;QAC1CC,QAAQC,cAAc,CAACV,qBAAqB,MAAMQ;QAElD,2EAA2E;QAC3E,MAAMG,aAAaJ,QAAQK,IAAI,IAAIJ,OAAOI,IAAI;QAE9C,0EAA0E;QAC1E,MAAMC,iBAAiBN,QAAQO,QAAQ,KAAK;QAC5C,IAAID,gBAAgB;YAClBT,eAAeU,QAAQ,CAACH,YAAYH;QACtC;QAEA,gDAAgD;QAChD,MAAMO,kBAAkB;YAAE,GAAGR,OAAO;YAAEK,MAAMD;QAAW;QAEvDF,QAAQC,cAAc,CACpBT,6BACAc,iBACAP;IAEJ;AACF;AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkCC,GACD,OAAO,SAASQ,iBACdT,UAAuC,CAAC,CAAC;IAEzC,OAAOD,OAAO;QACZW,YAAY;QACZC,iBAAiB;QACjB,GAAGX,OAAO;IACZ;AACF;AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuCC,GACD,OAAO,SAASY,cACdZ,UAAuC,CAAC,CAAC;IAEzC,OAAOD,OAAO;QAAEc,eAAe;QAAMF,iBAAiB;QAAS,GAAGX,OAAO;IAAC;AAC5E;AAEA;;;;;;;;;;;;;;;;;;;;;;;;CAwBC,GACD,OAAO,SAASc;IACd,OAAO,CAACb,QAAgBc;QACtB,IAAI,OAAOA,gBAAgB,UAAU;YACnC;QACF;QAEA,MAAMC,qBACJd,QAAQe,cAAc,CAACtB,+BAA+BM,WAAW,EAAE;QAErE,IAAI,CAACe,mBAAmBE,QAAQ,CAACH,cAAc;YAC7CC,mBAAmBG,IAAI,CAACJ;QAC1B;QAEAb,QAAQC,cAAc,CACpBR,+BACAqB,oBACAf;IAEJ;AACF;AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0DC,GACD,OAAO,SAASmB,mBACdC,SAAY,EACZC,kBAA2B;IAE3B,sEAAsE;IACtE,OAAO,SAAUrB,MAAgB;QAC/B,uCAAuC;QACvCH,oBAAoByB,eAAe,CAACF,WAAWC,oBAAoBrB;QAEnE,gDAAgD;QAChDC,QAAQC,cAAc,CACpBP,kCACA;YAAEyB;YAAWC;QAAmB,GAChCrB;IAEJ;AACF"}

package/dist/lib/polymorphic-registry.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Registry for polymorphic entity variants.
+ * Maps base classes to their discriminator properties and variant implementations.
+ */
+export declare class PolymorphicRegistry {
+    /**
+     * Maps base class -> discriminator property name
+     */
+    private static discriminatorProperties;
+    /**
+     * Maps base class -> (discriminator value -> variant class)
+     */
+    private static variants;
+    /**
+     * Registers a discriminator property for a base class.
+     * @param baseClass - The base class that has a polymorphic discriminator
+     * @param propertyName - The name of the discriminator property
+     * @throws Error if a discriminator property is already registered for this class
+     */
+    static setDiscriminatorProperty(baseClass: Function, propertyName: string): void;
+    /**
+     * Gets the discriminator property name for a base class.
+     * @param baseClass - The base class to look up
+     * @returns The discriminator property name, or undefined if not found
+     */
+    static getDiscriminatorProperty(baseClass: Function): string | undefined;
+    /**
+     * Registers a variant class for a base class and discriminator value.
+     * @param baseClass - The base class this variant extends
+     * @param discriminatorValue - The value of the discriminator property that identifies this variant
+     * @param variantClass - The concrete variant class
+     * @throws Error if a variant is already registered for this discriminator value
+     */
+    static registerVariant(baseClass: Function, discriminatorValue: unknown, variantClass: Function): void;
+    /**
+     * Gets the variant class for a base class and discriminator value.
+     * @param baseClass - The base class to look up
+     * @param discriminatorValue - The discriminator value to match
+     * @returns The variant class, or undefined if not found
+     */
+    static getVariant(baseClass: Function, discriminatorValue: unknown): Function | undefined;
+    /**
+     * Gets all registered variants for a base class.
+     * @param baseClass - The base class to look up
+     * @returns Array of variant registrations with their discriminator values
+     */
+    static getAllVariants(baseClass: Function): Array<{
+        discriminatorValue: unknown;
+        variantClass: Function;
+    }>;
+    /**
+     * Clears all registrations. Useful for testing.
+     * @internal
+     */
+    static clear(): void;
+}
+//# sourceMappingURL=polymorphic-registry.d.ts.map

package/dist/lib/polymorphic-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polymorphic-registry.d.ts","sourceRoot":"","sources":["../../src/lib/polymorphic-registry.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,qBAAa,mBAAmB;IAC9B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB,CAA+B;IAErE;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA+C;IAEtE;;;;;OAKG;IACH,MAAM,CAAC,wBAAwB,CAC7B,SAAS,EAAE,QAAQ,EACnB,YAAY,EAAE,MAAM,GACnB,IAAI;IAYP;;;;OAIG;IACH,MAAM,CAAC,wBAAwB,CAAC,SAAS,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS;IAIxE;;;;;;OAMG;IACH,MAAM,CAAC,eAAe,CACpB,SAAS,EAAE,QAAQ,EACnB,kBAAkB,EAAE,OAAO,EAC3B,YAAY,EAAE,QAAQ,GACrB,IAAI;IAoBP;;;;;OAKG;IACH,MAAM,CAAC,UAAU,CACf,SAAS,EAAE,QAAQ,EACnB,kBAAkB,EAAE,OAAO,GAC1B,QAAQ,GAAG,SAAS;IAMvB;;;;OAIG;IACH,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,QAAQ,GAAG,KAAK,CAAC;QAChD,kBAAkB,EAAE,OAAO,CAAC;QAC5B,YAAY,EAAE,QAAQ,CAAC;KACxB,CAAC;IAYF;;;OAGG;IACH,MAAM,CAAC,KAAK,IAAI,IAAI;CAIrB"}

package/dist/lib/polymorphic-registry.js

@@ -0,0 +1,83 @@
+/* eslint-disable @typescript-eslint/no-unsafe-function-type */ /**
+ * Registry for polymorphic entity variants.
+ * Maps base classes to their discriminator properties and variant implementations.
+ */ export class PolymorphicRegistry {
+    static{
+        /**
+   * Maps base class -> discriminator property name
+   */ this.discriminatorProperties = new Map();
+    }
+    static{
+        /**
+   * Maps base class -> (discriminator value -> variant class)
+   */ this.variants = new Map();
+    }
+    /**
+   * Registers a discriminator property for a base class.
+   * @param baseClass - The base class that has a polymorphic discriminator
+   * @param propertyName - The name of the discriminator property
+   * @throws Error if a discriminator property is already registered for this class
+   */ static setDiscriminatorProperty(baseClass, propertyName) {
+        const existing = this.discriminatorProperties.get(baseClass);
+        if (existing && existing !== propertyName) {
+            throw new Error(`Base class '${baseClass.name}' already has a polymorphic discriminator property '${existing}'. ` + `Cannot register another discriminator '${propertyName}'. ` + `Only one discriminator property per class hierarchy is allowed.`);
+        }
+        this.discriminatorProperties.set(baseClass, propertyName);
+    }
+    /**
+   * Gets the discriminator property name for a base class.
+   * @param baseClass - The base class to look up
+   * @returns The discriminator property name, or undefined if not found
+   */ static getDiscriminatorProperty(baseClass) {
+        return this.discriminatorProperties.get(baseClass);
+    }
+    /**
+   * Registers a variant class for a base class and discriminator value.
+   * @param baseClass - The base class this variant extends
+   * @param discriminatorValue - The value of the discriminator property that identifies this variant
+   * @param variantClass - The concrete variant class
+   * @throws Error if a variant is already registered for this discriminator value
+   */ static registerVariant(baseClass, discriminatorValue, variantClass) {
+        let variantMap = this.variants.get(baseClass);
+        if (!variantMap) {
+            variantMap = new Map();
+            this.variants.set(baseClass, variantMap);
+        }
+        const existing = variantMap.get(discriminatorValue);
+        if (existing && existing !== variantClass) {
+            throw new Error(`Duplicate polymorphic variant registration for base class '${baseClass.name}' ` + `with discriminator value '${String(discriminatorValue)}'. ` + `Existing variant: '${existing.name}', attempted: '${variantClass.name}'. ` + `Each discriminator value must map to exactly one variant class.`);
+        }
+        variantMap.set(discriminatorValue, variantClass);
+    }
+    /**
+   * Gets the variant class for a base class and discriminator value.
+   * @param baseClass - The base class to look up
+   * @param discriminatorValue - The discriminator value to match
+   * @returns The variant class, or undefined if not found
+   */ static getVariant(baseClass, discriminatorValue) {
+        const variantMap = this.variants.get(baseClass);
+        if (!variantMap) return undefined;
+        return variantMap.get(discriminatorValue);
+    }
+    /**
+   * Gets all registered variants for a base class.
+   * @param baseClass - The base class to look up
+   * @returns Array of variant registrations with their discriminator values
+   */ static getAllVariants(baseClass) {
+        const variantMap = this.variants.get(baseClass);
+        if (!variantMap) return [];
+        return Array.from(variantMap.entries()).map(([discriminatorValue, variantClass])=>({
+                discriminatorValue,
+                variantClass
+            }));
+    }
+    /**
+   * Clears all registrations. Useful for testing.
+   * @internal
+   */ static clear() {
+        this.discriminatorProperties.clear();
+        this.variants.clear();
+    }
+}
+
+//# sourceMappingURL=polymorphic-registry.js.map

package/dist/lib/polymorphic-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/polymorphic-registry.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-unsafe-function-type */\n\n/**\n * Registry for polymorphic entity variants.\n * Maps base classes to their discriminator properties and variant implementations.\n */\nexport class PolymorphicRegistry {\n  /**\n   * Maps base class -> discriminator property name\n   */\n  private static discriminatorProperties = new Map<Function, string>();\n\n  /**\n   * Maps base class -> (discriminator value -> variant class)\n   */\n  private static variants = new Map<Function, Map<unknown, Function>>();\n\n  /**\n   * Registers a discriminator property for a base class.\n   * @param baseClass - The base class that has a polymorphic discriminator\n   * @param propertyName - The name of the discriminator property\n   * @throws Error if a discriminator property is already registered for this class\n   */\n  static setDiscriminatorProperty(\n    baseClass: Function,\n    propertyName: string,\n  ): void {\n    const existing = this.discriminatorProperties.get(baseClass);\n    if (existing && existing !== propertyName) {\n      throw new Error(\n        `Base class '${baseClass.name}' already has a polymorphic discriminator property '${existing}'. ` +\n          `Cannot register another discriminator '${propertyName}'. ` +\n          `Only one discriminator property per class hierarchy is allowed.`,\n      );\n    }\n    this.discriminatorProperties.set(baseClass, propertyName);\n  }\n\n  /**\n   * Gets the discriminator property name for a base class.\n   * @param baseClass - The base class to look up\n   * @returns The discriminator property name, or undefined if not found\n   */\n  static getDiscriminatorProperty(baseClass: Function): string | undefined {\n    return this.discriminatorProperties.get(baseClass);\n  }\n\n  /**\n   * Registers a variant class for a base class and discriminator value.\n   * @param baseClass - The base class this variant extends\n   * @param discriminatorValue - The value of the discriminator property that identifies this variant\n   * @param variantClass - The concrete variant class\n   * @throws Error if a variant is already registered for this discriminator value\n   */\n  static registerVariant(\n    baseClass: Function,\n    discriminatorValue: unknown,\n    variantClass: Function,\n  ): void {\n    let variantMap = this.variants.get(baseClass);\n    if (!variantMap) {\n      variantMap = new Map();\n      this.variants.set(baseClass, variantMap);\n    }\n\n    const existing = variantMap.get(discriminatorValue);\n    if (existing && existing !== variantClass) {\n      throw new Error(\n        `Duplicate polymorphic variant registration for base class '${baseClass.name}' ` +\n          `with discriminator value '${String(discriminatorValue)}'. ` +\n          `Existing variant: '${existing.name}', attempted: '${variantClass.name}'. ` +\n          `Each discriminator value must map to exactly one variant class.`,\n      );\n    }\n\n    variantMap.set(discriminatorValue, variantClass);\n  }\n\n  /**\n   * Gets the variant class for a base class and discriminator value.\n   * @param baseClass - The base class to look up\n   * @param discriminatorValue - The discriminator value to match\n   * @returns The variant class, or undefined if not found\n   */\n  static getVariant(\n    baseClass: Function,\n    discriminatorValue: unknown,\n  ): Function | undefined {\n    const variantMap = this.variants.get(baseClass);\n    if (!variantMap) return undefined;\n    return variantMap.get(discriminatorValue);\n  }\n\n  /**\n   * Gets all registered variants for a base class.\n   * @param baseClass - The base class to look up\n   * @returns Array of variant registrations with their discriminator values\n   */\n  static getAllVariants(baseClass: Function): Array<{\n    discriminatorValue: unknown;\n    variantClass: Function;\n  }> {\n    const variantMap = this.variants.get(baseClass);\n    if (!variantMap) return [];\n\n    return Array.from(variantMap.entries()).map(\n      ([discriminatorValue, variantClass]) => ({\n        discriminatorValue,\n        variantClass,\n      }),\n    );\n  }\n\n  /**\n   * Clears all registrations. Useful for testing.\n   * @internal\n   */\n  static clear(): void {\n    this.discriminatorProperties.clear();\n    this.variants.clear();\n  }\n}\n"],"names":["PolymorphicRegistry","discriminatorProperties","Map","variants","setDiscriminatorProperty","baseClass","propertyName","existing","get","Error","name","set","getDiscriminatorProperty","registerVariant","discriminatorValue","variantClass","variantMap","String","getVariant","undefined","getAllVariants","Array","from","entries","map","clear"],"mappings":"AAAA,6DAA6D,GAE7D;;;CAGC,GACD,OAAO,MAAMA;;QACX;;GAEC,QACcC,0BAA0B,IAAIC;;;QAE7C;;GAEC,QACcC,WAAW,IAAID;;IAE9B;;;;;GAKC,GACD,OAAOE,yBACLC,SAAmB,EACnBC,YAAoB,EACd;QACN,MAAMC,WAAW,IAAI,CAACN,uBAAuB,CAACO,GAAG,CAACH;QAClD,IAAIE,YAAYA,aAAaD,cAAc;YACzC,MAAM,IAAIG,MACR,CAAC,YAAY,EAAEJ,UAAUK,IAAI,CAAC,oDAAoD,EAAEH,SAAS,GAAG,CAAC,GAC/F,CAAC,uCAAuC,EAAED,aAAa,GAAG,CAAC,GAC3D,CAAC,+DAA+D,CAAC;QAEvE;QACA,IAAI,CAACL,uBAAuB,CAACU,GAAG,CAACN,WAAWC;IAC9C;IAEA;;;;GAIC,GACD,OAAOM,yBAAyBP,SAAmB,EAAsB;QACvE,OAAO,IAAI,CAACJ,uBAAuB,CAACO,GAAG,CAACH;IAC1C;IAEA;;;;;;GAMC,GACD,OAAOQ,gBACLR,SAAmB,EACnBS,kBAA2B,EAC3BC,YAAsB,EAChB;QACN,IAAIC,aAAa,IAAI,CAACb,QAAQ,CAACK,GAAG,CAACH;QACnC,IAAI,CAACW,YAAY;YACfA,aAAa,IAAId;YACjB,IAAI,CAACC,QAAQ,CAACQ,GAAG,CAACN,WAAWW;QAC/B;QAEA,MAAMT,WAAWS,WAAWR,GAAG,CAACM;QAChC,IAAIP,YAAYA,aAAaQ,cAAc;YACzC,MAAM,IAAIN,MACR,CAAC,2DAA2D,EAAEJ,UAAUK,IAAI,CAAC,EAAE,CAAC,GAC9E,CAAC,0BAA0B,EAAEO,OAAOH,oBAAoB,GAAG,CAAC,GAC5D,CAAC,mBAAmB,EAAEP,SAASG,IAAI,CAAC,eAAe,EAAEK,aAAaL,IAAI,CAAC,GAAG,CAAC,GAC3E,CAAC,+DAA+D,CAAC;QAEvE;QAEAM,WAAWL,GAAG,CAACG,oBAAoBC;IACrC;IAEA;;;;;GAKC,GACD,OAAOG,WACLb,SAAmB,EACnBS,kBAA2B,EACL;QACtB,MAAME,aAAa,IAAI,CAACb,QAAQ,CAACK,GAAG,CAACH;QACrC,IAAI,CAACW,YAAY,OAAOG;QACxB,OAAOH,WAAWR,GAAG,CAACM;IACxB;IAEA;;;;GAIC,GACD,OAAOM,eAAef,SAAmB,EAGtC;QACD,MAAMW,aAAa,IAAI,CAACb,QAAQ,CAACK,GAAG,CAACH;QACrC,IAAI,CAACW,YAAY,OAAO,EAAE;QAE1B,OAAOK,MAAMC,IAAI,CAACN,WAAWO,OAAO,IAAIC,GAAG,CACzC,CAAC,CAACV,oBAAoBC,aAAa,GAAM,CAAA;gBACvCD;gBACAC;YACF,CAAA;IAEJ;IAEA;;;GAGC,GACD,OAAOU,QAAc;QACnB,IAAI,CAACxB,uBAAuB,CAACwB,KAAK;QAClC,IAAI,CAACtB,QAAQ,CAACsB,KAAK;IACrB;AACF"}

package/dist/lib/property.d.ts

@@ -345,4 +345,75 @@ export declare function discriminatedEntityPropertyOptions(options?: Omit<Proper
 export declare function DiscriminatedEntityProperty(options?: Omit<PropertyOptions<any, any>, 'type' | 'discriminated'> & {
     discriminatorProperty?: string;
 }): PropertyDecorator;
+/**
+ * Decorator that marks a property as a polymorphic discriminator.
+ *
+ * Used for class hierarchies where an abstract base class has multiple concrete implementations,
+ * and the discriminator property value determines which subclass to instantiate.
+ *
+ * The discriminator is a regular class property (not injected during serialization like @DiscriminatedEntityProperty).
+ *
+ * This decorator can be used standalone (it will treat the property as a string) or combined
+ * with another type decorator for more specific typing.
+ *
+ * @param enumType - Optional enum, union type, or stringifiable type for the discriminator (used for validation and schema generation)
+ *
+ * @example
+ * ```typescript
+ * // With regular enum
+ * enum SchemaPropertyType {
+ *   STRING = 'string',
+ *   NUMBER = 'number',
+ * }
+ *
+ * @Entity()
+ * abstract class SchemaProperty {
+ *   @StringProperty({ minLength: 1 })
+ *   name!: string;
+ *
+ *   @PolymorphicProperty(SchemaPropertyType)
+ *   type!: SchemaPropertyType;
+ * }
+ *
+ * @Entity()
+ * @PolymorphicVariant(SchemaProperty, SchemaPropertyType.STRING)
+ * class StringSchemaProperty extends SchemaProperty {
+ *   type = SchemaPropertyType.STRING;
+ *
+ *   @IntProperty({ optional: true })
+ *   minLength?: number;
+ * }
+ *
+ * // With stringifiable type
+ * class Status {
+ *   static ACTIVE = new Status('active');
+ *   static INACTIVE = new Status('inactive');
+ *
+ *   constructor(private value: string) {}
+ *   toString() { return this.value; }
+ *   static parse(value: string) {
+ *     if (value === 'active') return Status.ACTIVE;
+ *     if (value === 'inactive') return Status.INACTIVE;
+ *     throw new Error('Invalid status');
+ *   }
+ * }
+ *
+ * @Entity()
+ * abstract class Record {
+ *   @PolymorphicProperty(() => Status)
+ *   status!: Status;
+ * }
+ *
+ * // Parsing automatically instantiates the correct subclass
+ * const data = { name: 'age', type: 'string', minLength: 5 };
+ * const prop = await EntityUtils.parse(SchemaProperty, data);
+ * // prop is StringSchemaProperty instance
+ * ```
+ */
+export declare function PolymorphicProperty<T extends {
+    equals?(other: T): boolean;
+    toString(): string;
+}, C extends CtorLike<T> & {
+    parse(value: string): T;
+}>(enumTypeOrFactory?: Record<string, string> | (() => C)): PropertyDecorator;
 //# sourceMappingURL=property.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"property.d.ts","sourceRoot":"","sources":["../../src/lib/property.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,OAAO,EACP,KAAK,QAAQ,EAIb,eAAe,EAChB,MAAM,YAAY,CAAC;AAapB;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,EAC/C,OAAO,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,GAC7B,iBAAiB,CA2EnB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM,CAAC,GAAG;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GACA,eAAe,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAwB5C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAC5B,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM,CAAC,GAAG;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GACA,iBAAiB,CAEnB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAClE,QAAQ,EAAE,CAAC,EACX,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM,CAAC,GACjE,eAAe,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAM5C;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC3D,QAAQ,EAAE,CAAC,EACX,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM,CAAC,GACjE,iBAAiB,CAEnB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM,CAAC,GAAG;IACnE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GACA,eAAe,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAkB5C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC5B,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM,CAAC,GAAG;IACnE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GACA,iBAAiB,CAEnB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM,CAAC,GAAG;IACnE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GACA,eAAe,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAoB5C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CACzB,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM,CAAC,GAAG;IACnE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GACA,iBAAiB,CAEnB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,kBAAkB,CAAC,EAAE,MAAM,CAAC,GACnE,eAAe,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAE9C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,kBAAkB,CAAC,EAAE,MAAM,CAAC,GACnE,iBAAiB,CAEnB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,eAAe,CAAC,EAAE,MAAM,CAAC,GAC7D,eAAe,CAAC,IAAI,EAAE,eAAe,CAAC,CAExC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,eAAe,CAAC,EAAE,MAAM,CAAC,GAC7D,iBAAiB,CAEnB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM,CAAC,GACjE,eAAe,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAE5C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM,CAAC,GACjE,iBAAiB,CAEnB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,CAAC,EACD,CAAC,SAAS,OAAO,CAAC,CAAC,CAAC,GAAG;IAAE,KAAK,IAAI,EAAE,GAAG,GAAG,CAAC,CAAA;CAAE,EAE7C,IAAI,EAAE,MAAM,CAAC,EACb,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,GAC5C,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAEvB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,CAAC,EACD,CAAC,SAAS,OAAO,CAAC,CAAC,CAAC,GAAG;IAAE,KAAK,IAAI,EAAE,GAAG,GAAG,CAAC,CAAA;CAAE,EAE7C,IAAI,EAAE,MAAM,CAAC,EACb,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,GAC5C,iBAAiB,CAEnB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,EAC3D,IAAI,EAAE,MAAM,CAAC,EACb,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACA,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAmBvB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,EACpD,IAAI,EAAE,MAAM,CAAC,EACb,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACA,iBAAiB,CAmBnB;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,aAAa,CAAC,GACtD,eAAe,CAEjB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,IAAI,iBAAiB,CAEvD;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,CAAC,SAAS;IAAE,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC;IAAC,QAAQ,IAAI,MAAM,CAAA;CAAE,EAC5D,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,GAAG;IAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,CAAA;CAAE,EAEnD,IAAI,EAAE,MAAM,CAAC,EACb,OAAO,CAAC,EAAE,IAAI,CACZ,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,EACrB,WAAW,GAAG,aAAa,GAAG,aAAa,GAAG,MAAM,GAAG,QAAQ,CAChE,GACA,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAavB;AAED,eAAO,MAAM,qBAAqB,GAChC,CAAC,SAAS;IAAE,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC;IAAC,QAAQ,IAAI,MAAM,CAAA;CAAE,EAC5D,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,GAAG;IAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,CAAA;CAAE,EAEnD,MAAM,MAAM,CAAC,EACb,OAAM,IAAI,CACR,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,EACrB,WAAW,GAAG,aAAa,GAAG,aAAa,GAAG,MAAM,GAAG,QAAQ,CAC3D,KACL,iBACuD,CAAC;AAE3D,eAAO,MAAM,oBAAoB,GAC/B,CAAC,SAAS;IAAE,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC;IAAC,MAAM,IAAI,OAAO,CAAA;CAAE,EAC3D,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,GAAG;IAAE,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,CAAC,CAAA;CAAE,EAEpD,MAAM,MAAM,CAAC,EACb,OAAM,IAAI,CACR,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,EACrB,WAAW,GAAG,aAAa,GAAG,aAAa,GAAG,MAAM,GAAG,QAAQ,CAC3D,sBAWJ,CAAC;AAEL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH;;;GAGG;AACH,wBAAgB,kCAAkC,CAChD,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,GAAG;IACpE,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC,GACA,eAAe,CAAC,GAAG,EAAE,GAAG,CAAC,CAQ3B;AAED,wBAAgB,2BAA2B,CACzC,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,GAAG;IACpE,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC,GACA,iBAAiB,CAEnB"}
+{"version":3,"file":"property.d.ts","sourceRoot":"","sources":["../../src/lib/property.ts"],"names":[],"mappings":"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"}

package/dist/lib/property.js

@@ -1,6 +1,7 @@
 /* eslint-disable @typescript-eslint/no-wrapper-object-types */ /* eslint-disable @typescript-eslint/no-explicit-any */ import { isEqual } from 'lodash-es';
-import { PROPERTY_METADATA_KEY, PROPERTY_OPTIONS_METADATA_KEY } from './types.js';
+import { PROPERTY_METADATA_KEY, PROPERTY_OPTIONS_METADATA_KEY, POLYMORPHIC_PROPERTY_METADATA_KEY } from './types.js';
 import { enumValidator, intValidator, minLengthValidator, maxLengthValidator, patternValidator, minValidator, maxValidator, arrayMinLengthValidator, arrayMaxLengthValidator } from './validators.js';
+import { PolymorphicRegistry } from './polymorphic-registry.js';
 /**
  * Property decorator that marks class properties with metadata.
  * This decorator can be used to identify and track properties within classes.
@@ -488,5 +489,112 @@ export const SerializableProperty = (type, data = {})=>Property({
 export function DiscriminatedEntityProperty(options) {
     return Property(discriminatedEntityPropertyOptions(options));
 }
+/**
+ * Decorator that marks a property as a polymorphic discriminator.
+ *
+ * Used for class hierarchies where an abstract base class has multiple concrete implementations,
+ * and the discriminator property value determines which subclass to instantiate.
+ *
+ * The discriminator is a regular class property (not injected during serialization like @DiscriminatedEntityProperty).
+ *
+ * This decorator can be used standalone (it will treat the property as a string) or combined
+ * with another type decorator for more specific typing.
+ *
+ * @param enumType - Optional enum, union type, or stringifiable type for the discriminator (used for validation and schema generation)
+ *
+ * @example
+ * ```typescript
+ * // With regular enum
+ * enum SchemaPropertyType {
+ *   STRING = 'string',
+ *   NUMBER = 'number',
+ * }
+ *
+ * @Entity()
+ * abstract class SchemaProperty {
+ *   @StringProperty({ minLength: 1 })
+ *   name!: string;
+ *
+ *   @PolymorphicProperty(SchemaPropertyType)
+ *   type!: SchemaPropertyType;
+ * }
+ *
+ * @Entity()
+ * @PolymorphicVariant(SchemaProperty, SchemaPropertyType.STRING)
+ * class StringSchemaProperty extends SchemaProperty {
+ *   type = SchemaPropertyType.STRING;
+ *
+ *   @IntProperty({ optional: true })
+ *   minLength?: number;
+ * }
+ *
+ * // With stringifiable type
+ * class Status {
+ *   static ACTIVE = new Status('active');
+ *   static INACTIVE = new Status('inactive');
+ *
+ *   constructor(private value: string) {}
+ *   toString() { return this.value; }
+ *   static parse(value: string) {
+ *     if (value === 'active') return Status.ACTIVE;
+ *     if (value === 'inactive') return Status.INACTIVE;
+ *     throw new Error('Invalid status');
+ *   }
+ * }
+ *
+ * @Entity()
+ * abstract class Record {
+ *   @PolymorphicProperty(() => Status)
+ *   status!: Status;
+ * }
+ *
+ * // Parsing automatically instantiates the correct subclass
+ * const data = { name: 'age', type: 'string', minLength: 5 };
+ * const prop = await EntityUtils.parse(SchemaProperty, data);
+ * // prop is StringSchemaProperty instance
+ * ```
+ */ export function PolymorphicProperty(enumTypeOrFactory) {
+    return (target, propertyKey)=>{
+        if (typeof propertyKey !== 'string') {
+            return;
+        }
+        // Store the polymorphic property metadata
+        Reflect.defineMetadata(POLYMORPHIC_PROPERTY_METADATA_KEY, propertyKey, target.constructor);
+        // Register in PolymorphicRegistry
+        PolymorphicRegistry.setDiscriminatorProperty(target.constructor, propertyKey);
+        // Check if property already has options (from another decorator)
+        const existingOptions = Reflect.getOwnMetadata(PROPERTY_OPTIONS_METADATA_KEY, target, propertyKey);
+        if (existingOptions) {
+            // Update existing options to add polymorphic flags
+            const updatedOptions = {
+                ...existingOptions,
+                polymorphicDiscriminator: true,
+                polymorphicEnumType: enumTypeOrFactory
+            };
+            Reflect.defineMetadata(PROPERTY_OPTIONS_METADATA_KEY, updatedOptions, target, propertyKey);
+        } else {
+            // No existing decorator - check if it's a stringifiable type or enum
+            const isStringifiable = typeof enumTypeOrFactory === 'function';
+            if (isStringifiable) {
+                // Apply StringifiableProperty decorator with polymorphic flags
+                const stringifiableOpts = stringifiablePropertyOptions(enumTypeOrFactory);
+                const options = {
+                    ...stringifiableOpts,
+                    polymorphicDiscriminator: true,
+                    polymorphicEnumType: enumTypeOrFactory
+                };
+                Property(options)(target, propertyKey);
+            } else {
+                // Apply Property decorator with string type (for enum discriminators)
+                const options = {
+                    type: ()=>String,
+                    polymorphicDiscriminator: true,
+                    polymorphicEnumType: enumTypeOrFactory
+                };
+                Property(options)(target, propertyKey);
+            }
+        }
+    };
+}
 
 //# sourceMappingURL=property.js.map