dyna-record 0.7.1 → 0.7.3

package/README.md

@@ -14,6 +14,7 @@ Note: ACID compliant according to DynamoDB [limitations](https://docs.aws.amazon
   - [Installation](#installation)
   - [Configuration](#configuration)
 - [Defining Entities](#defining-entities)
+  - [Entity inheritance and shared base classes](#entity-inheritance-and-shared-base-classes)
   - [Attributes](#attributes)
   - [Relationships](#relationships)
 - [CRUD Operations](#crud-operations)
@@ -157,6 +158,54 @@ class Course extends MyTable {
 
 > **Note:** `declare readonly type` is a pure TypeScript type annotation with zero runtime impact. The ORM sets `type` to the class name automatically. The declaration simply tells TypeScript the exact literal type, enabling typed query filters and return type narrowing.
 
+#### Entity inheritance and shared base classes
+
+Entities do not have to extend the table class directly. The `@Entity` decorator resolves an entity's table by walking the class hierarchy until it finds a class decorated with `@Table`, so shared attributes and relationships can live in an abstract base class between the table and the concrete entities:
+
+```typescript
+import {
+  Entity,
+  StringAttribute,
+  NumberAttribute,
+  BooleanAttribute
+} from "dyna-record";
+
+// Not decorated with @Entity — this class is never registered as an entity,
+// never appears in table metadata, and no records of its own type exist
+abstract class Vehicle extends MyTable {
+  @StringAttribute({ alias: "Make" })
+  public readonly make: string;
+
+  @NumberAttribute({ alias: "Year" })
+  public readonly year: number;
+}
+
+@Entity
+class Car extends Vehicle {
+  declare readonly type: "Car";
+
+  @NumberAttribute({ alias: "Doors" })
+  public readonly doors: number;
+}
+
+@Entity
+class Motorcycle extends Vehicle {
+  declare readonly type: "Motorcycle";
+
+  @BooleanAttribute({ alias: "HasSidecar" })
+  public readonly hasSidecar: boolean;
+}
+```
+
+`Car` and `Motorcycle` are full entities of `MyTable`: each inherits `make` and `year` (including runtime schema validation for them), and all CRUD operations work as if the attributes were declared on the entity itself. The abstract base class is only a container for shared code — it cannot be queried or persisted.
+
+A few things to keep in mind:
+
+- If an entity class does not extend a class decorated with `@Table` anywhere in its hierarchy, the `@Entity` decorator throws at class definition time.
+- Extending a **concrete** entity (e.g. `class Pickup extends Truck`) is supported at runtime, but TypeScript will not allow the subclass to narrow the inherited `type` literal (`"Pickup"` is not assignable to `"Truck"`). Prefer abstract base classes for shared attributes.
+- There is no polymorphic querying: entities are stored and queried by their exact class name. Querying `Car` will never return `Motorcycle` records, even though they share a base class.
+- A base class couples its subclasses to one table, since it must extend a specific table class. To share a shape across entities in different tables, use a TypeScript interface instead (each entity must still declare its own decorated attributes).
+
 ### Attributes
 
 Use the attribute decorators below to define attributes on a model. The decorator maps class properties to DynamoDB table attributes.

package/dist/src/DynaRecord.d.ts

@@ -10,7 +10,7 @@ interface DynaRecordBase {
 /**
  * Serves as an abstract base class for entities in the ORM system. It defines standard fields such as `id`, `type`, `createdAt`, and `updatedAt`, and provides static methods for CRUD operations and queries. This class encapsulates common behaviors and properties that all entities share, leveraging decorators for attribute metadata and supporting operations like finding, creating, updating, and deleting entities.
  *
- * Table classes should extend this class, and each entity should extend the table class
+ * Table classes should extend this class, and each entity should extend the table class — either directly or through intermediate abstract base classes that hold shared attributes
  *
  * Entities extending `DynaRecord` can utilize these operations to interact with their corresponding records in the database, including handling relationships between different entities.
  * @example

package/dist/src/DynaRecord.js

@@ -40,7 +40,7 @@ import { createInstance, tableItemToEntity } from "./utils.js";
 /**
  * Serves as an abstract base class for entities in the ORM system. It defines standard fields such as `id`, `type`, `createdAt`, and `updatedAt`, and provides static methods for CRUD operations and queries. This class encapsulates common behaviors and properties that all entities share, leveraging decorators for attribute metadata and supporting operations like finding, creating, updating, and deleting entities.
  *
- * Table classes should extend this class, and each entity should extend the table class
+ * Table classes should extend this class, and each entity should extend the table class — either directly or through intermediate abstract base classes that hold shared attributes
  *
  * Entities extending `DynaRecord` can utilize these operations to interact with their corresponding records in the database, including handling relationships between different entities.
  * @example

package/dist/src/decorators/Entity.d.ts

@@ -2,7 +2,7 @@ import type DynaRecord from "../DynaRecord.js";
 /**
  * A class decorator for marking a class as an entity within the context of the ORM system. This decorator is essential for registering the class as a distinct entity in the ORM's metadata system, enabling the ORM to recognize and manage instances of this class as part of its data model. By designating classes as entities, it facilitates their integration into the ORM framework, allowing for operations such as querying, persisting, and managing relationships between entities.
  *
- * IMPORTANT - All entity classes should extend a table class decorated by {@link Table}
+ * IMPORTANT - All entity classes must extend a table class decorated by {@link Table}, either directly or through intermediate classes. The entity's table is resolved by walking the class hierarchy until a class decorated with {@link Table} is found, so entities can share attributes and relationships through abstract base classes. A base class that is not decorated with `Entity` is never registered as an entity itself — only the decorated subclasses are part of the table's metadata.
  *
  * Entities MUST declare their `type` property as a string literal matching the class name.
  * This enables compile-time type safety for query filters and return types.
@@ -12,6 +12,7 @@ import type DynaRecord from "../DynaRecord.js";
  * @param target The constructor function of the class being decorated.
  * @param context The context in which the decorator is applied, provided by the TypeScript runtime.
  * @returns {void} The decorator does not return a value.
+ * @throws Error if the decorated class does not extend a class decorated with {@link Table} anywhere in its class hierarchy.
  *
  * Usage example:
  * ```typescript
@@ -21,6 +22,23 @@ import type DynaRecord from "../DynaRecord.js";
  *   // User entity implementation
  * }
  * ```
+ *
+ * Sharing attributes through an abstract base class:
+ * ```typescript
+ * // Not decorated with Entity — never registered and never persisted itself
+ * abstract class Vehicle extends MyTable {
+ *   @StringAttribute({ alias: "Make" })
+ *   public readonly make: string;
+ * }
+ *
+ * @Entity
+ * class Car extends Vehicle {
+ *   declare readonly type: "Car";
+ *   // Inherits the `make` attribute from Vehicle
+ * }
+ * ```
+ *
+ * Note: extending a concrete entity (rather than an abstract base class) is supported at runtime, but TypeScript will not allow the subclass to narrow the inherited `type` literal of its parent. Prefer abstract base classes for shared attributes.
  */
 declare function Entity<C extends abstract new (...args: never[]) => DynaRecord>(target: C & (string extends InstanceType<C>["type"] ? {
     __entityTypeError: 'Entity must declare: declare readonly type: "ClassName"';

package/dist/src/decorators/Entity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Entity.d.ts","sourceRoot":"","sources":["../../../src/decorators/Entity.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,iBAAS,MAAM,CAAC,CAAC,SAAS,QAAQ,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,UAAU,EACrE,MAAM,EAAE,CAAC,GACP,CAAC,MAAM,SAAS,YAAY,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GACnC;IACE,iBAAiB,EAAE,yDAAyD,CAAC;CAC9E,GACD,OAAO,CAAC,EACd,QAAQ,EAAE,qBAAqB,CAAC,CAAC,CAAC,GACjC,IAAI,CAKN;AAED,eAAe,MAAM,CAAC"}
+{"version":3,"file":"Entity.d.ts","sourceRoot":"","sources":["../../../src/decorators/Entity.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,iBAAS,MAAM,CAAC,CAAC,SAAS,QAAQ,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,UAAU,EACrE,MAAM,EAAE,CAAC,GACP,CAAC,MAAM,SAAS,YAAY,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GACnC;IACE,iBAAiB,EAAE,yDAAyD,CAAC;CAC9E,GACD,OAAO,CAAC,EACd,QAAQ,EAAE,qBAAqB,CAAC,CAAC,CAAC,GACjC,IAAI,CAEN;AAED,eAAe,MAAM,CAAC"}

package/dist/src/decorators/Entity.js

@@ -2,7 +2,7 @@ import Metadata from "../metadata/index.js";
 /**
  * A class decorator for marking a class as an entity within the context of the ORM system. This decorator is essential for registering the class as a distinct entity in the ORM's metadata system, enabling the ORM to recognize and manage instances of this class as part of its data model. By designating classes as entities, it facilitates their integration into the ORM framework, allowing for operations such as querying, persisting, and managing relationships between entities.
  *
- * IMPORTANT - All entity classes should extend a table class decorated by {@link Table}
+ * IMPORTANT - All entity classes must extend a table class decorated by {@link Table}, either directly or through intermediate classes. The entity's table is resolved by walking the class hierarchy until a class decorated with {@link Table} is found, so entities can share attributes and relationships through abstract base classes. A base class that is not decorated with `Entity` is never registered as an entity itself — only the decorated subclasses are part of the table's metadata.
  *
  * Entities MUST declare their `type` property as a string literal matching the class name.
  * This enables compile-time type safety for query filters and return types.
@@ -12,6 +12,7 @@ import Metadata from "../metadata/index.js";
  * @param target The constructor function of the class being decorated.
  * @param context The context in which the decorator is applied, provided by the TypeScript runtime.
  * @returns {void} The decorator does not return a value.
+ * @throws Error if the decorated class does not extend a class decorated with {@link Table} anywhere in its class hierarchy.
  *
  * Usage example:
  * ```typescript
@@ -21,9 +22,25 @@ import Metadata from "../metadata/index.js";
  *   // User entity implementation
  * }
  * ```
+ *
+ * Sharing attributes through an abstract base class:
+ * ```typescript
+ * // Not decorated with Entity — never registered and never persisted itself
+ * abstract class Vehicle extends MyTable {
+ *   @StringAttribute({ alias: "Make" })
+ *   public readonly make: string;
+ * }
+ *
+ * @Entity
+ * class Car extends Vehicle {
+ *   declare readonly type: "Car";
+ *   // Inherits the `make` attribute from Vehicle
+ * }
+ * ```
+ *
+ * Note: extending a concrete entity (rather than an abstract base class) is supported at runtime, but TypeScript will not allow the subclass to narrow the inherited `type` literal of its parent. Prefer abstract base classes for shared attributes.
  */
 function Entity(target, _context) {
-    const tableClassName = Object.getPrototypeOf(target).name;
-    Metadata.addEntity(target, tableClassName);
+    Metadata.addEntity(target);
 }
 export default Entity;

package/dist/src/decorators/Table.d.ts

@@ -3,7 +3,7 @@ import type DynaRecord from "../DynaRecord.js";
 /**
  * A class decorator for defining and customizing the table metadata associated with an entity class within the ORM system. This decorator enriches the entity with additional metadata, specifying how the entity relates to the underlying database table. By providing custom table options, such as table names or schema definitions, this decorator plays a crucial role in bridging the gap between the ORM's abstract entities and their concrete database representations.
  *
- * IMPORTANT - All entity classes should extend a table
+ * IMPORTANT - All entity classes should extend a table, either directly or through intermediate base classes (see {@link Entity})
  *
  * @param props The {@link TableMetadataOptions} object containing metadata configuration for the table. This can include options like the table's name, delimiter and default field customizations.
  * @returns A class decorator factory function that takes a target class extending `DynaRecord` and a context object provided by the TypeScript runtime. The decorator function registers the provided metadata options with the ORM's metadata system, ensuring the entity is properly configured and recognized by the ORM.

package/dist/src/decorators/Table.js

@@ -2,7 +2,7 @@ import Metadata from "../metadata/index.js";
 /**
  * A class decorator for defining and customizing the table metadata associated with an entity class within the ORM system. This decorator enriches the entity with additional metadata, specifying how the entity relates to the underlying database table. By providing custom table options, such as table names or schema definitions, this decorator plays a crucial role in bridging the gap between the ORM's abstract entities and their concrete database representations.
  *
- * IMPORTANT - All entity classes should extend a table
+ * IMPORTANT - All entity classes should extend a table, either directly or through intermediate base classes (see {@link Entity})
  *
  * @param props The {@link TableMetadataOptions} object containing metadata configuration for the table. This can include options like the table's name, delimiter and default field customizations.
  * @returns A class decorator factory function that takes a target class extending `DynaRecord` and a context object provided by the TypeScript runtime. The decorator function registers the provided metadata options with the ORM's metadata system, ensuring the entity is properly configured and recognized by the ORM.

package/dist/src/index.d.ts

@@ -3,7 +3,7 @@ export * from "./errors.js";
 export * from "./relationships/index.js";
 export * from "./dynamo-utils/errors.js";
 export type { EntityAttributesOnly, EntityAttributesInstance as EntityInstance, FindByIdIncludesRes, TypedFilterParams, TypedSortKeyCondition, SKScopedFilterParams, InferQueryResults, PartitionEntityNames, ShouldNarrow, NarrowByNames, FallbackToFilterKeys, IntersectTypeWithOr } from "./operations/index.js";
-export type { PartitionKey, SortKey, ForeignKey, NullableForeignKey, Optional } from "./types.js";
+export type { Brand, PartitionKey, SortKey, ForeignKey, NullableForeignKey, Optional } from "./types.js";
 export type { AttributeKind } from "./metadata/types.js";
 export type { SerializedTableMetadata } from "./metadata/schemas.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AAEzC,YAAY,EACV,oBAAoB,EACpB,wBAAwB,IAAI,cAAc,EAC1C,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,YAAY,EACZ,OAAO,EACP,UAAU,EACV,kBAAkB,EAClB,QAAQ,EACT,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,YAAY,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AAEzC,YAAY,EACV,oBAAoB,EACpB,wBAAwB,IAAI,cAAc,EAC1C,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,KAAK,EACL,YAAY,EACZ,OAAO,EACP,UAAU,EACV,kBAAkB,EAClB,QAAQ,EACT,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,YAAY,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/src/metadata/MetadataStorage.d.ts

@@ -60,11 +60,13 @@ declare class MetadataStorage {
      */
     addTable(tableClassName: string, options: TableMetadataOptions): void;
     /**
-     * Add an entity to metadata storage
-     * @param entityName
-     * @param tableName
+     * Add an entity to metadata storage. The table the entity belongs to is
+     * resolved by walking the entity's class hierarchy until a class decorated
+     * with the Table decorator is found, supporting entities that extend other
+     * entities or intermediate abstract classes.
+     * @param entityClass
      */
-    addEntity(entityClass: EntityMetadata["EntityClass"], tableClassName: string): void;
+    addEntity(entityClass: EntityMetadata["EntityClass"]): void;
     /**
      * Adds a relationship to an Entity's metadata storage
      * @param entityName
@@ -105,6 +107,14 @@ declare class MetadataStorage {
      * Initialize metadata object
      */
     private init;
+    /**
+     * Walks an entity class's hierarchy and returns the name of the first
+     * ancestor registered as a table via the Table decorator. Throws if the
+     * entity does not extend a table class anywhere in its hierarchy.
+     * @param entityClass
+     * @returns Name of the table class the entity belongs to
+     */
+    private resolveTableClassName;
     /**
      * Recursively search prototype chain and return TableMetadata for an entity class if it exists
      * @param classPrototype

package/dist/src/metadata/MetadataStorage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MetadataStorage.d.ts","sourceRoot":"","sources":["../../../src/metadata/MetadataStorage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,aAAa,MAAM,oBAAoB,CAAC;AAC/C,OAAO,cAAc,MAAM,qBAAqB,CAAC;AAEjD,OAAO,iBAAiB,MAAM,wBAAwB,CAAC;AAEvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,KAAK,EACV,wBAAwB,EAExB,qBAAqB,EAErB,oBAAoB,EAEpB,wBAAwB,EACzB,MAAM,YAAY,CAAC;AAEpB;;;;GAIG;AACH,cAAM,eAAe;;IAOnB;;;;OAIG;IACI,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc;IAKpD;;;;OAIG;IACI,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa;IAKjD;;;;OAIG;IACI,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa;IAMxD;;;;OAIG;IACI,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAK/D;;;;OAIG;IACI,mBAAmB,CAAC,cAAc,EAAE,MAAM,GAAG,qBAAqB;IAWzE;;;OAGG;IACI,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,wBAAwB;IAYxE;;;;OAIG;IACI,wBAAwB,CAC7B,UAAU,EAAE,MAAM,GACjB,wBAAwB;IAY3B;;;;OAIG;IACI,QAAQ,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,IAAI;IAI5E;;;;OAIG;IACI,SAAS,CACd,WAAW,EAAE,cAAc,CAAC,aAAa,CAAC,EAC1C,cAAc,EAAE,MAAM,GACrB,IAAI;IAOP;;;;OAIG;IACI,qBAAqB,CAC1B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,oBAAoB,GAC5B,IAAI;IAQP;;;;OAIG;IACI,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAW5E;;;;OAIG;IACI,kBAAkB,CACvB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,YAAY,CAAC,wBAAwB,EAAE,OAAO,CAAC,GACvD,IAAI;IAYP;;;;OAIG;IACI,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAKpE;;;;OAIG;IACI,wBAAwB,CAC7B,WAAW,EAAE,UAAU,EACvB,OAAO,EAAE,UAAU,CAAC,aAAa,CAAC,0BAA0B,CAAC,CAAC,CAAC,MAAM,CAAC,GACrE,IAAI;IAQP;;;;OAIG;IACI,mBAAmB,CACxB,WAAW,EAAE,UAAU,EACvB,OAAO,EAAE,UAAU,CAAC,aAAa,CAAC,0BAA0B,CAAC,CAAC,CAAC,MAAM,CAAC,GACrE,IAAI;IAQP;;OAEG;IACH,OAAO,CAAC,IAAI;IAUZ;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;CAe/B;AAED,eAAe,eAAe,CAAC"}
+{"version":3,"file":"MetadataStorage.d.ts","sourceRoot":"","sources":["../../../src/metadata/MetadataStorage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,aAAa,MAAM,oBAAoB,CAAC;AAC/C,OAAO,cAAc,MAAM,qBAAqB,CAAC;AAEjD,OAAO,iBAAiB,MAAM,wBAAwB,CAAC;AAEvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,KAAK,EACV,wBAAwB,EAExB,qBAAqB,EAErB,oBAAoB,EAEpB,wBAAwB,EACzB,MAAM,YAAY,CAAC;AAEpB;;;;GAIG;AACH,cAAM,eAAe;;IAOnB;;;;OAIG;IACI,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc;IAKpD;;;;OAIG;IACI,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa;IAKjD;;;;OAIG;IACI,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa;IAMxD;;;;OAIG;IACI,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAK/D;;;;OAIG;IACI,mBAAmB,CAAC,cAAc,EAAE,MAAM,GAAG,qBAAqB;IAWzE;;;OAGG;IACI,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,wBAAwB;IAYxE;;;;OAIG;IACI,wBAAwB,CAC7B,UAAU,EAAE,MAAM,GACjB,wBAAwB;IAY3B;;;;OAIG;IACI,QAAQ,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,IAAI;IAI5E;;;;;;OAMG;IACI,SAAS,CAAC,WAAW,EAAE,cAAc,CAAC,aAAa,CAAC,GAAG,IAAI;IAQlE;;;;OAIG;IACI,qBAAqB,CAC1B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,oBAAoB,GAC5B,IAAI;IAQP;;;;OAIG;IACI,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAW5E;;;;OAIG;IACI,kBAAkB,CACvB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,YAAY,CAAC,wBAAwB,EAAE,OAAO,CAAC,GACvD,IAAI;IAYP;;;;OAIG;IACI,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAKpE;;;;OAIG;IACI,wBAAwB,CAC7B,WAAW,EAAE,UAAU,EACvB,OAAO,EAAE,UAAU,CAAC,aAAa,CAAC,0BAA0B,CAAC,CAAC,CAAC,MAAM,CAAC,GACrE,IAAI;IAQP;;;;OAIG;IACI,mBAAmB,CACxB,WAAW,EAAE,UAAU,EACvB,OAAO,EAAE,UAAU,CAAC,aAAa,CAAC,0BAA0B,CAAC,CAAC,CAAC,MAAM,CAAC,GACrE,IAAI;IAQP;;OAEG;IACH,OAAO,CAAC,IAAI;IAUZ;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;IAgB7B;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;CAe/B;AAED,eAAe,eAAe,CAAC"}

package/dist/src/metadata/MetadataStorage.js

@@ -103,11 +103,14 @@ class MetadataStorage {
         this.#tables[tableClassName] = new TableMetadata(options);
     }
     /**
-     * Add an entity to metadata storage
-     * @param entityName
-     * @param tableName
+     * Add an entity to metadata storage. The table the entity belongs to is
+     * resolved by walking the entity's class hierarchy until a class decorated
+     * with the Table decorator is found, supporting entities that extend other
+     * entities or intermediate abstract classes.
+     * @param entityClass
      */
-    addEntity(entityClass, tableClassName) {
+    addEntity(entityClass) {
+        const tableClassName = this.resolveTableClassName(entityClass);
         this.#entities[entityClass.name] = new EntityMetadata(entityClass, tableClassName);
     }
     /**
@@ -193,6 +196,23 @@ class MetadataStorage {
             this.#initialized = true;
         }
     }
+    /**
+     * Walks an entity class's hierarchy and returns the name of the first
+     * ancestor registered as a table via the Table decorator. Throws if the
+     * entity does not extend a table class anywhere in its hierarchy.
+     * @param entityClass
+     * @returns Name of the table class the entity belongs to
+     */
+    resolveTableClassName(entityClass) {
+        let current = Object.getPrototypeOf(entityClass);
+        // The constructor chain ends at Function.prototype, whose name is ""
+        while (typeof current === "function" && current.name !== "") {
+            if (current.name in this.#tables)
+                return current.name;
+            current = Object.getPrototypeOf(current);
+        }
+        throw new Error(`Entity ${entityClass.name} must extend a class decorated with @Table, either directly or through its class hierarchy`);
+    }
     /**
      * Recursively search prototype chain and return TableMetadata for an entity class if it exists
      * @param classPrototype

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dyna-record",
-  "version": "0.7.1",
+  "version": "0.7.3",
   "description": "Typescript Data Modeler and ORM for Dynamo",
   "type": "module",
   "types": "./dist/index.d.ts",