metal-orm 1.1.10 → 1.1.16

package/src/decorators/index.ts

@@ -1,39 +1,39 @@
-/**
- * Decorators for defining entities, columns, and relations in Metal ORM.
- */
-export * from './entity.js';
-export * from './column-decorator.js';
-export * from './relations.js';
-export * from './bootstrap.js';
-export { getDecoratorMetadata } from './decorator-metadata.js';
-
-// Transformer Decorators
-export * from './transformers/transformer-decorators.js';
-export type { 
-  PropertyTransformer, 
-  PropertyValidator, 
-  PropertySanitizer, 
-  CompositeTransformer, 
-  AutoTransformableValidator, 
-  TransformContext, 
-  AutoTransformResult, 
-  ValidationResult, 
-  TransformerMetadata, 
-  TransformerConfig 
-} from './transformers/transformer-metadata.js';
-
-// Country Identifier Validators
-export * from './validators/country-validators-decorators.js';
-export { registerValidator, resolveValidator, getRegisteredValidators, hasValidator } from './validators/country-validator-registry.js';
-export type { 
-  CountryValidator, 
-  CountryValidatorFactory, 
-  ValidationOptions, 
-  ValidationResult as CountryValidationResult, 
-  AutoCorrectionResult, 
-  ValidatorFactoryOptions 
-} from './validators/country-validators.js';
-
-// Entity Materialization - convert query results to real class instances
-export { materializeAs, DefaultEntityMaterializer, PrototypeMaterializationStrategy, ConstructorMaterializationStrategy } from '../orm/entity-materializer.js';
-export type { EntityMaterializer, EntityMaterializationStrategy } from '../orm/entity-materializer.js';
+/**
+ * Decorators for defining entities, columns, and relations in Metal ORM.
+ */
+export * from './entity.js';
+export * from './column-decorator.js';
+export * from './relations.js';
+export * from './bootstrap.js';
+export { getDecoratorMetadata } from './decorator-metadata.js';
+
+// Transformer Decorators
+export * from './transformers/transformer-decorators.js';
+export type { 
+  PropertyTransformer, 
+  PropertyValidator, 
+  PropertySanitizer, 
+  CompositeTransformer, 
+  AutoTransformableValidator, 
+  TransformContext, 
+  AutoTransformResult, 
+  ValidationResult, 
+  TransformerMetadata, 
+  TransformerConfig 
+} from './transformers/transformer-metadata.js';
+
+// Country Identifier Validators
+export * from './validators/country-validators-decorators.js';
+export { registerValidator, resolveValidator, getRegisteredValidators, hasValidator } from './validators/country-validator-registry.js';
+export type { 
+  CountryValidator, 
+  CountryValidatorFactory, 
+  ValidationOptions, 
+  ValidationResult as CountryValidationResult, 
+  AutoCorrectionResult, 
+  ValidatorFactoryOptions 
+} from './validators/country-validators.js';
+
+// Entity Materialization - convert query results to real class instances
+export { materializeAs, DefaultEntityMaterializer, PrototypeMaterializationStrategy, ConstructorMaterializationStrategy } from '../orm/entity-materializer.js';
+export type { EntityMaterializer, EntityMaterializationStrategy } from '../orm/entity-materializer.js';

package/src/decorators/relations.ts

@@ -1,231 +1,231 @@
-import { CascadeMode, RelationKinds } from '../schema/relation.js';
-import {
-  EntityOrTableTarget,
-  EntityOrTableTargetResolver,
-  RelationMetadata
-} from '../orm/entity-metadata.js';
-import { resolveFieldDecoratorInfo } from './decorator-metadata.js';
-
-interface BaseRelationOptions {
-  target: EntityOrTableTargetResolver;
-  cascade?: CascadeMode;
-  localKey?: string;
-}
-
-/**
- * Options for HasMany relation.
- */
-export interface HasManyOptions extends BaseRelationOptions {
-  foreignKey?: string;
-}
-
-/**
- * Options for HasOne relation.
- */
-export interface HasOneOptions extends BaseRelationOptions {
-  foreignKey?: string;
-}
-
-/**
- * Options for BelongsTo relation.
- */
-export interface BelongsToOptions extends BaseRelationOptions {
-  foreignKey?: string;
-}
-
-/**
- * Options for BelongsToMany relation.
- */
-export interface BelongsToManyOptions<
-  TTarget extends EntityOrTableTarget = EntityOrTableTarget,
-  TPivot extends EntityOrTableTarget = EntityOrTableTarget
-> {
-  target: EntityOrTableTargetResolver<TTarget>;
-  pivotTable: EntityOrTableTargetResolver<TPivot>;
-  pivotForeignKeyToRoot?: string;
-  pivotForeignKeyToTarget?: string;
-  localKey?: string;
-  targetKey?: string;
-  pivotPrimaryKey?: string;
-  defaultPivotColumns?: string[];
-  cascade?: CascadeMode;
-}
-
-const createFieldDecorator = (metadataFactory: (propertyName: string) => RelationMetadata) => {
-  return function (targetOrValue: unknown, contextOrProperty: unknown) {
-    const { propertyName, bag } = resolveFieldDecoratorInfo(
-      targetOrValue,
-      contextOrProperty,
-      'Relation'
-    );
-    const relationMetadata = metadataFactory(propertyName);
-
-    if (!bag.relations.some(entry => entry.propertyName === propertyName)) {
-      bag.relations.push({ propertyName, relation: relationMetadata });
-    }
-  };
-};
-
-/**
- * Decorator to define a HasMany relation on an entity property.
- * @param options - The relation options.
- * @returns A property decorator that registers the relation metadata.
- */
-export function HasMany(options: HasManyOptions) {
-  return createFieldDecorator(propertyName => ({
-    kind: RelationKinds.HasMany,
-    propertyKey: propertyName,
-    target: options.target,
-    foreignKey: options.foreignKey,
-    localKey: options.localKey,
-    cascade: options.cascade
-  }));
-}
-
-/**
- * Decorator to define a HasOne relation on an entity property.
- * @param options - The relation options.
- * @returns A property decorator that registers the relation metadata.
- */
-export function HasOne(options: HasOneOptions) {
-  return createFieldDecorator(propertyName => ({
-    kind: RelationKinds.HasOne,
-    propertyKey: propertyName,
-    target: options.target,
-    foreignKey: options.foreignKey,
-    localKey: options.localKey,
-    cascade: options.cascade
-  }));
-}
-
-/**
- * Decorator to define a BelongsTo relation on an entity property.
- * @param options - The relation options.
- * @returns A property decorator that registers the relation metadata.
- */
-export function BelongsTo(options: BelongsToOptions) {
-  return createFieldDecorator(propertyName => ({
-    kind: RelationKinds.BelongsTo,
-    propertyKey: propertyName,
-    target: options.target,
-    foreignKey: options.foreignKey ?? `${propertyName}_id`,
-    localKey: options.localKey,
-    cascade: options.cascade
-  }));
-}
-
-/**
- * Decorator to define a BelongsToMany relation on an entity property.
- * @param options - The relation options.
- * @returns A property decorator that registers the relation metadata.
- */
-export function BelongsToMany<
-  TTarget extends EntityOrTableTarget = EntityOrTableTarget,
-  TPivot extends EntityOrTableTarget = EntityOrTableTarget
->(options: BelongsToManyOptions<TTarget, TPivot>) {
-  return createFieldDecorator(propertyName => ({
-    kind: RelationKinds.BelongsToMany,
-    propertyKey: propertyName,
-    target: options.target,
-    pivotTable: options.pivotTable,
-    pivotForeignKeyToRoot: options.pivotForeignKeyToRoot,
-    pivotForeignKeyToTarget: options.pivotForeignKeyToTarget,
-    localKey: options.localKey,
-    targetKey: options.targetKey,
-    pivotPrimaryKey: options.pivotPrimaryKey,
-    defaultPivotColumns: options.defaultPivotColumns,
-    cascade: options.cascade
-  }));
-}
-
-/**
- * Options for MorphTo relation.
- */
-export interface MorphToOptions {
-  typeField: string;
-  idField: string;
-  targets: Record<string, EntityOrTableTargetResolver>;
-  targetKey?: string;
-  cascade?: CascadeMode;
-}
-
-/**
- * Options for MorphOne relation.
- */
-export interface MorphOneOptions {
-  target: EntityOrTableTargetResolver;
-  morphName: string;
-  typeValue: string;
-  typeField?: string;
-  idField?: string;
-  localKey?: string;
-  cascade?: CascadeMode;
-}
-
-/**
- * Options for MorphMany relation.
- */
-export interface MorphManyOptions {
-  target: EntityOrTableTargetResolver;
-  morphName: string;
-  typeValue: string;
-  typeField?: string;
-  idField?: string;
-  localKey?: string;
-  cascade?: CascadeMode;
-}
-
-/**
- * Decorator to define a MorphTo relation on an entity property.
- * @param options - The relation options.
- * @returns A property decorator that registers the relation metadata.
- */
-export function MorphTo(options: MorphToOptions) {
-  return createFieldDecorator(propertyName => ({
-    kind: RelationKinds.MorphTo,
-    propertyKey: propertyName,
-    typeField: options.typeField,
-    idField: options.idField,
-    targets: options.targets,
-    targetKey: options.targetKey,
-    cascade: options.cascade
-  }));
-}
-
-/**
- * Decorator to define a MorphOne relation on an entity property.
- * @param options - The relation options.
- * @returns A property decorator that registers the relation metadata.
- */
-export function MorphOne(options: MorphOneOptions) {
-  return createFieldDecorator(propertyName => ({
-    kind: RelationKinds.MorphOne,
-    propertyKey: propertyName,
-    target: options.target,
-    morphName: options.morphName,
-    typeValue: options.typeValue,
-    typeField: options.typeField,
-    idField: options.idField,
-    localKey: options.localKey,
-    cascade: options.cascade
-  }));
-}
-
-/**
- * Decorator to define a MorphMany relation on an entity property.
- * @param options - The relation options.
- * @returns A property decorator that registers the relation metadata.
- */
-export function MorphMany(options: MorphManyOptions) {
-  return createFieldDecorator(propertyName => ({
-    kind: RelationKinds.MorphMany,
-    propertyKey: propertyName,
-    target: options.target,
-    morphName: options.morphName,
-    typeValue: options.typeValue,
-    typeField: options.typeField,
-    idField: options.idField,
-    localKey: options.localKey,
-    cascade: options.cascade
-  }));
-}
+import { CascadeMode, RelationKinds } from '../schema/relation.js';
+import {
+  EntityOrTableTarget,
+  EntityOrTableTargetResolver,
+  RelationMetadata
+} from '../orm/entity-metadata.js';
+import { resolveFieldDecoratorInfo } from './decorator-metadata.js';
+
+interface BaseRelationOptions {
+  target: EntityOrTableTargetResolver;
+  cascade?: CascadeMode;
+  localKey?: string;
+}
+
+/**
+ * Options for HasMany relation.
+ */
+export interface HasManyOptions extends BaseRelationOptions {
+  foreignKey?: string;
+}
+
+/**
+ * Options for HasOne relation.
+ */
+export interface HasOneOptions extends BaseRelationOptions {
+  foreignKey?: string;
+}
+
+/**
+ * Options for BelongsTo relation.
+ */
+export interface BelongsToOptions extends BaseRelationOptions {
+  foreignKey?: string;
+}
+
+/**
+ * Options for BelongsToMany relation.
+ */
+export interface BelongsToManyOptions<
+  TTarget extends EntityOrTableTarget = EntityOrTableTarget,
+  TPivot extends EntityOrTableTarget = EntityOrTableTarget
+> {
+  target: EntityOrTableTargetResolver<TTarget>;
+  pivotTable: EntityOrTableTargetResolver<TPivot>;
+  pivotForeignKeyToRoot?: string;
+  pivotForeignKeyToTarget?: string;
+  localKey?: string;
+  targetKey?: string;
+  pivotPrimaryKey?: string;
+  defaultPivotColumns?: string[];
+  cascade?: CascadeMode;
+}
+
+const createFieldDecorator = (metadataFactory: (propertyName: string) => RelationMetadata) => {
+  return function (targetOrValue: unknown, contextOrProperty: unknown) {
+    const { propertyName, bag } = resolveFieldDecoratorInfo(
+      targetOrValue,
+      contextOrProperty,
+      'Relation'
+    );
+    const relationMetadata = metadataFactory(propertyName);
+
+    if (!bag.relations.some(entry => entry.propertyName === propertyName)) {
+      bag.relations.push({ propertyName, relation: relationMetadata });
+    }
+  };
+};
+
+/**
+ * Decorator to define a HasMany relation on an entity property.
+ * @param options - The relation options.
+ * @returns A property decorator that registers the relation metadata.
+ */
+export function HasMany(options: HasManyOptions) {
+  return createFieldDecorator(propertyName => ({
+    kind: RelationKinds.HasMany,
+    propertyKey: propertyName,
+    target: options.target,
+    foreignKey: options.foreignKey,
+    localKey: options.localKey,
+    cascade: options.cascade
+  }));
+}
+
+/**
+ * Decorator to define a HasOne relation on an entity property.
+ * @param options - The relation options.
+ * @returns A property decorator that registers the relation metadata.
+ */
+export function HasOne(options: HasOneOptions) {
+  return createFieldDecorator(propertyName => ({
+    kind: RelationKinds.HasOne,
+    propertyKey: propertyName,
+    target: options.target,
+    foreignKey: options.foreignKey,
+    localKey: options.localKey,
+    cascade: options.cascade
+  }));
+}
+
+/**
+ * Decorator to define a BelongsTo relation on an entity property.
+ * @param options - The relation options.
+ * @returns A property decorator that registers the relation metadata.
+ */
+export function BelongsTo(options: BelongsToOptions) {
+  return createFieldDecorator(propertyName => ({
+    kind: RelationKinds.BelongsTo,
+    propertyKey: propertyName,
+    target: options.target,
+    foreignKey: options.foreignKey ?? `${propertyName}_id`,
+    localKey: options.localKey,
+    cascade: options.cascade
+  }));
+}
+
+/**
+ * Decorator to define a BelongsToMany relation on an entity property.
+ * @param options - The relation options.
+ * @returns A property decorator that registers the relation metadata.
+ */
+export function BelongsToMany<
+  TTarget extends EntityOrTableTarget = EntityOrTableTarget,
+  TPivot extends EntityOrTableTarget = EntityOrTableTarget
+>(options: BelongsToManyOptions<TTarget, TPivot>) {
+  return createFieldDecorator(propertyName => ({
+    kind: RelationKinds.BelongsToMany,
+    propertyKey: propertyName,
+    target: options.target,
+    pivotTable: options.pivotTable,
+    pivotForeignKeyToRoot: options.pivotForeignKeyToRoot,
+    pivotForeignKeyToTarget: options.pivotForeignKeyToTarget,
+    localKey: options.localKey,
+    targetKey: options.targetKey,
+    pivotPrimaryKey: options.pivotPrimaryKey,
+    defaultPivotColumns: options.defaultPivotColumns,
+    cascade: options.cascade
+  }));
+}
+
+/**
+ * Options for MorphTo relation.
+ */
+export interface MorphToOptions {
+  typeField: string;
+  idField: string;
+  targets: Record<string, EntityOrTableTargetResolver>;
+  targetKey?: string;
+  cascade?: CascadeMode;
+}
+
+/**
+ * Options for MorphOne relation.
+ */
+export interface MorphOneOptions {
+  target: EntityOrTableTargetResolver;
+  morphName: string;
+  typeValue: string;
+  typeField?: string;
+  idField?: string;
+  localKey?: string;
+  cascade?: CascadeMode;
+}
+
+/**
+ * Options for MorphMany relation.
+ */
+export interface MorphManyOptions {
+  target: EntityOrTableTargetResolver;
+  morphName: string;
+  typeValue: string;
+  typeField?: string;
+  idField?: string;
+  localKey?: string;
+  cascade?: CascadeMode;
+}
+
+/**
+ * Decorator to define a MorphTo relation on an entity property.
+ * @param options - The relation options.
+ * @returns A property decorator that registers the relation metadata.
+ */
+export function MorphTo(options: MorphToOptions) {
+  return createFieldDecorator(propertyName => ({
+    kind: RelationKinds.MorphTo,
+    propertyKey: propertyName,
+    typeField: options.typeField,
+    idField: options.idField,
+    targets: options.targets,
+    targetKey: options.targetKey,
+    cascade: options.cascade
+  }));
+}
+
+/**
+ * Decorator to define a MorphOne relation on an entity property.
+ * @param options - The relation options.
+ * @returns A property decorator that registers the relation metadata.
+ */
+export function MorphOne(options: MorphOneOptions) {
+  return createFieldDecorator(propertyName => ({
+    kind: RelationKinds.MorphOne,
+    propertyKey: propertyName,
+    target: options.target,
+    morphName: options.morphName,
+    typeValue: options.typeValue,
+    typeField: options.typeField,
+    idField: options.idField,
+    localKey: options.localKey,
+    cascade: options.cascade
+  }));
+}
+
+/**
+ * Decorator to define a MorphMany relation on an entity property.
+ * @param options - The relation options.
+ * @returns A property decorator that registers the relation metadata.
+ */
+export function MorphMany(options: MorphManyOptions) {
+  return createFieldDecorator(propertyName => ({
+    kind: RelationKinds.MorphMany,
+    propertyKey: propertyName,
+    target: options.target,
+    morphName: options.morphName,
+    typeValue: options.typeValue,
+    typeField: options.typeField,
+    idField: options.idField,
+    localKey: options.localKey,
+    cascade: options.cascade
+  }));
+}