metal-orm 1.0.73 → 1.0.74

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "metal-orm",
-  "version": "1.0.73",
+  "version": "1.0.74",
   "type": "module",
   "types": "./dist/index.d.ts",
   "engines": {

package/src/decorators/bootstrap.ts

@@ -25,14 +25,14 @@ import {
 
 import { tableRef, type TableRef } from '../schema/table.js';
 import {
-  SelectableKeys,
-  ColumnDef,
-  HasManyCollection,
-  HasOneReference,
-  BelongsToReference,
-  ManyToManyCollection,
-  EntityInstance
-} from '../schema/types.js';
+  SelectableKeys,
+  ColumnDef,
+  HasManyCollection,
+  HasOneReference,
+  BelongsToReference,
+  ManyToManyCollection,
+  EntityInstance
+} from '../schema/types.js';
 
 const unwrapTarget = (target: EntityOrTableTargetResolver): EntityOrTableTarget => {
   // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
@@ -197,9 +197,9 @@ type NonFunctionKeys<T> = {
 type RelationKeys<TEntity extends object> =
   Exclude<NonFunctionKeys<TEntity>, SelectableKeys<TEntity>> & string;
 
-type EntityTable<TEntity extends object> =
-  Omit<TableDef<{ [K in SelectableKeys<TEntity>]: ColumnDef }>, 'relations'> & {
-    relations: {
+type EntityTable<TEntity extends object> =
+  Omit<TableDef<{ [K in SelectableKeys<TEntity>]: ColumnDef }>, 'relations'> & {
+    relations: {
       [K in RelationKeys<TEntity>]:
       NonNullable<TEntity[K]> extends HasManyCollection<infer TChild>
       ? HasManyRelation<EntityTable<NonNullable<TChild> & object>>
@@ -215,18 +215,18 @@ type EntityTable<TEntity extends object> =
       : NonNullable<TEntity[K]> extends object
       ? BelongsToRelation<EntityTable<NonNullable<TEntity[K]> & object>>
       : never;
-    };
-  };
-
-export type DecoratedEntityInstance<TEntity extends object> =
-  TEntity & EntityInstance<EntityTable<TEntity>>;
-
-export const selectFromEntity = <TEntity extends object>(
-  ctor: EntityConstructor<TEntity>
-): SelectQueryBuilder<DecoratedEntityInstance<TEntity>, EntityTable<TEntity>> => {
-  const table = getTableDefFromEntity(ctor);
-  if (!table) {
-    throw new Error(`Entity '${ctor.name}' is not registered with decorators or has not been bootstrapped`);
+    };
+  };
+
+export type DecoratedEntityInstance<TEntity extends object> =
+  TEntity & EntityInstance<EntityTable<TEntity>>;
+
+export const selectFromEntity = <TEntity extends object>(
+  ctor: EntityConstructor<TEntity>
+): SelectQueryBuilder<DecoratedEntityInstance<TEntity>, EntityTable<TEntity>> => {
+  const table = getTableDefFromEntity(ctor);
+  if (!table) {
+    throw new Error(`Entity '${ctor.name}' is not registered with decorators or has not been bootstrapped`);
   }
   return new SelectQueryBuilder(
     table as unknown as EntityTable<TEntity>,
@@ -245,12 +245,29 @@ export const selectFromEntity = <TEntity extends object>(
  * Lazily bootstraps entity metadata (via getTableDefFromEntity) and returns a
  * `tableRef(...)`-style proxy so users can write `u.id` instead of `u.columns.id`.
  */
-export const entityRef = <TEntity extends object>(
-  ctor: EntityConstructor<TEntity>
-): TableRef<EntityTable<TEntity>> => {
-  const table = getTableDefFromEntity(ctor);
-  if (!table) {
-    throw new Error(`Entity '${ctor.name}' is not registered with decorators or has not been bootstrapped`);
-  }
-  return tableRef(table as EntityTable<TEntity>);
-};
+export const entityRef = <TEntity extends object>(
+  ctor: EntityConstructor<TEntity>
+): TableRef<EntityTable<TEntity>> => {
+  const table = getTableDefFromEntity(ctor);
+  if (!table) {
+    throw new Error(`Entity '${ctor.name}' is not registered with decorators or has not been bootstrapped`);
+  }
+  return tableRef(table as EntityTable<TEntity>);
+};
+
+type EntityRefsTuple<T extends readonly EntityConstructor<object>[]> = {
+  [K in keyof T]: T[K] extends EntityConstructor<infer TEntity>
+  ? TableRef<EntityTable<TEntity & object>>
+  : never;
+};
+
+/**
+ * Public API: variadic entity references.
+ * Usage:
+ *   const [u, p] = entityRefs(User, Post);
+ */
+export const entityRefs = <T extends readonly EntityConstructor<object>[]>(
+  ...ctors: T
+): EntityRefsTuple<T> => {
+  return ctors.map(ctor => entityRef(ctor)) as EntityRefsTuple<T>;
+};

package/src/decorators/index.ts

@@ -1,12 +1,12 @@
-/**
- * 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';
-
-// 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';
+
+// 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';