dyna-record 0.1.5 → 0.2.1

package/dist/src/metadata/EntityMetadata.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const zod_1 = require("zod");
 const errors_1 = require("../errors");
 const _1 = __importDefault(require("."));
+const utils_1 = require("./utils");
 /**
  * Represents metadata for an entity within the ORM system, encapsulating information about the entity's attributes, relationships, and its associated database table.
  *
@@ -116,5 +117,37 @@ class EntityMetadata {
         const errorOptions = error instanceof zod_1.ZodError ? { cause: error.issues } : undefined;
         return new errors_1.ValidationError("Validation errors", errorOptions);
     }
+    /**
+     * Returns all relationship metadata for the entity
+     */
+    get allRelationships() {
+        return Object.values(this.relationships);
+    }
+    /**
+     * Returns the BelongsToRelationship  (bidirectional to parent) metadata for the entity
+     */
+    get belongsToRelationships() {
+        return Object.values(this.relationships).filter(rel => (0, utils_1.isBelongsToRelationship)(rel));
+    }
+    /**
+     * Returns the OwnedByRelationship (unidirectional to parent) relationship metadata for an entity
+     */
+    get ownedByRelationships() {
+        return Object.values(this.relationships).filter(relMeta => (0, utils_1.isOwnedByRelationship)(relMeta));
+    }
+    /**
+     * Returns the BelongsToRelationship and OwnedByRelationship metadata objects for an entity
+     */
+    get belongsToOrOwnedByRelationships() {
+        return [...this.belongsToRelationships, ...this.ownedByRelationships];
+    }
+    /**
+     * Returns the "Has" relationship metadata for the entity (EX: "HasMany")
+     */
+    get hasRelationships() {
+        return Object.values(this.relationships).filter(relMeta => (0, utils_1.isHasOneRelationship)(relMeta) ||
+            (0, utils_1.isHasManyRelationship)(relMeta) ||
+            (0, utils_1.isHasAndBelongsToManyRelationship)(relMeta));
+    }
 }
 exports.default = EntityMetadata;

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

@@ -1 +1 @@
-{"version":3,"file":"TableMetadata.d.ts","sourceRoot":"","sources":["../../../src/metadata/TableMetadata.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,GAAG,CAAC;AAEtC,OAAO,KAAK,EACV,oBAAoB,EACpB,aAAa,EAGb,4BAA4B,EAC7B,MAAM,SAAS,CAAC;AAEjB,eAAO,MAAM,gBAAgB;;;CAAiD,CAAC;AAE/E;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CACrC,aAAa,EACb;IAAE,KAAK,EAAE,aAAa,CAAA;CAAE,CAQhB,CAAC;AAEX;;;;;;;;;;;;;GAaG;AACH,cAAM,aAAa;IACjB,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,iBAAiB,EAAE,MAAM,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAC;IAC5E,SAAgB,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACnE,qBAAqB,EAAE,iBAAiB,CAAC;IACzC,gBAAgB,EAAE,iBAAiB,CAAC;IAE3C;;;;;;;;;;;;;;;;OAgBG;IACI,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;gBAE9B,OAAO,EAAE,oBAAoB;IA4BzC;;;;OAIG;IACH,OAAO,CAAC,8BAA8B;IAgCtC;;;OAGG;IACI,wBAAwB,CAAC,OAAO,EAAE,4BAA4B,GAAG,IAAI;IAO5E;;;OAGG;IACI,mBAAmB,CAAC,OAAO,EAAE,4BAA4B,GAAG,IAAI;CAMxE;AAED,eAAe,aAAa,CAAC"}
+{"version":3,"file":"TableMetadata.d.ts","sourceRoot":"","sources":["../../../src/metadata/TableMetadata.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,GAAG,CAAC;AAEtC,OAAO,KAAK,EACV,oBAAoB,EACpB,aAAa,EAGb,4BAA4B,EAC7B,MAAM,SAAS,CAAC;AAEjB,eAAO,MAAM,gBAAgB;;;CAAiD,CAAC;AAE/E;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CACrC,aAAa,EACb;IAAE,KAAK,EAAE,aAAa,CAAA;CAAE,CAMhB,CAAC;AAEX;;;;;;;;;;;;;GAaG;AACH,cAAM,aAAa;IACjB,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,iBAAiB,EAAE,MAAM,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAC;IAC5E,SAAgB,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACnE,qBAAqB,EAAE,iBAAiB,CAAC;IACzC,gBAAgB,EAAE,iBAAiB,CAAC;IAE3C;;;;;;;;;;;;;;;;OAgBG;IACI,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;gBAE9B,OAAO,EAAE,oBAAoB;IA4BzC;;;;OAIG;IACH,OAAO,CAAC,8BAA8B;IAgCtC;;;OAGG;IACI,wBAAwB,CAAC,OAAO,EAAE,4BAA4B,GAAG,IAAI;IAO5E;;;OAGG;IACI,mBAAmB,CAAC,OAAO,EAAE,4BAA4B,GAAG,IAAI;CAMxE;AAED,eAAe,aAAa,CAAC"}

package/dist/src/metadata/TableMetadata.js

@@ -12,9 +12,7 @@ exports.tableDefaultFields = {
     id: { alias: "id" },
     type: { alias: "type" },
     createdAt: { alias: "createdAt" },
-    updatedAt: { alias: "updatedAt" },
-    foreignKey: { alias: "foreignKey" },
-    foreignEntityType: { alias: "foreignEntityType" }
+    updatedAt: { alias: "updatedAt" }
 };
 /**
  * Represents the metadata for a table within the ORM framework, encapsulating information such as table name, key attributes, and default field mappings. This class is fundamental for defining how entities are mapped to their underlying database tables, providing a schema-like structure that includes both key configuration and default attribute handling.

package/dist/src/metadata/relationship-metadata/BelongsToRelationship.d.ts

@@ -1,7 +1,7 @@
 import type { ForeignKeyProperty } from "../../types";
 import RelationshipMetadata from "./RelationshipMetadata";
 /**
- * Represents a "Belongs To" relationship metadata within the ORM system.
+ * Represents a "Belongs To" relationship metadata within the ORM system. These are bidirectional relationships to the parent.
  *
  * @extends {RelationshipMetadata} Inherits the base functionality and properties of `RelationshipMetadata`.
  * @property {"BelongsTo"} type - The type of the relationship, statically set to "BelongsTo" to signify the nature of the relationship.

package/dist/src/metadata/relationship-metadata/BelongsToRelationship.js

@@ -5,7 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const RelationshipMetadata_1 = __importDefault(require("./RelationshipMetadata"));
 /**
- * Represents a "Belongs To" relationship metadata within the ORM system.
+ * Represents a "Belongs To" relationship metadata within the ORM system. These are bidirectional relationships to the parent.
  *
  * @extends {RelationshipMetadata} Inherits the base functionality and properties of `RelationshipMetadata`.
  * @property {"BelongsTo"} type - The type of the relationship, statically set to "BelongsTo" to signify the nature of the relationship.

package/dist/src/metadata/relationship-metadata/HasManyRelationship.d.ts

@@ -3,15 +3,16 @@ import RelationshipMetadata from "./RelationshipMetadata";
 /**
  * Extends `RelationshipMetadata` to specifically handle "HasMany" relationship metadata within the ORM system.
  *
- *
  * @property {"HasMany"} type - A literal string that explicitly defines the type of relationship as "HasMany". This classification helps the ORM to apply the correct logic for relationship handling.
  * @property {ForeignKeyProperty} foreignKey - The attribute in the associated entity that serves as a foreign key, linking back to the partition key of the owning entity. This key is essential for maintaining the integrity of the "HasMany" relationship.
+ * @property {boolean} uniDirectional - Indicates whether the relationship is unidirectional. If `true`, the relationship supports access patterns in only one direction (from the owning entity to the related entities), reducing denormalized data. This is useful when bidirectional access patterns are unnecessary.
  *
  * @param {RelationshipMetadata} item - An existing set of relationship metadata that should be applied to the newly created `HasManyRelationship` instance. This parameter allows for the inheritance and augmentation of relationship properties.
  */
 declare class HasManyRelationship extends RelationshipMetadata {
     type: "HasMany";
     foreignKey: ForeignKeyProperty;
+    uniDirectional?: boolean;
     constructor(item: RelationshipMetadata);
 }
 export default HasManyRelationship;

package/dist/src/metadata/relationship-metadata/HasManyRelationship.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HasManyRelationship.d.ts","sourceRoot":"","sources":["../../../../src/metadata/relationship-metadata/HasManyRelationship.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,oBAAoB,MAAM,wBAAwB,CAAC;AAE1D;;;;;;;;GAQG;AACH,cAAM,mBAAoB,SAAQ,oBAAoB;IACpD,IAAI,EAAE,SAAS,CAAa;IAC5B,UAAU,EAAE,kBAAkB,CAAC;gBAEnB,IAAI,EAAE,oBAAoB;CAMvC;AAED,eAAe,mBAAmB,CAAC"}
+{"version":3,"file":"HasManyRelationship.d.ts","sourceRoot":"","sources":["../../../../src/metadata/relationship-metadata/HasManyRelationship.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,oBAAoB,MAAM,wBAAwB,CAAC;AAE1D;;;;;;;;GAQG;AACH,cAAM,mBAAoB,SAAQ,oBAAoB;IACpD,IAAI,EAAE,SAAS,CAAa;IAC5B,UAAU,EAAE,kBAAkB,CAAC;IAC/B,cAAc,CAAC,EAAE,OAAO,CAAS;gBAErB,IAAI,EAAE,oBAAoB;CAMvC;AAED,eAAe,mBAAmB,CAAC"}

package/dist/src/metadata/relationship-metadata/HasManyRelationship.js

@@ -7,15 +7,16 @@ const RelationshipMetadata_1 = __importDefault(require("./RelationshipMetadata")
 /**
  * Extends `RelationshipMetadata` to specifically handle "HasMany" relationship metadata within the ORM system.
  *
- *
  * @property {"HasMany"} type - A literal string that explicitly defines the type of relationship as "HasMany". This classification helps the ORM to apply the correct logic for relationship handling.
  * @property {ForeignKeyProperty} foreignKey - The attribute in the associated entity that serves as a foreign key, linking back to the partition key of the owning entity. This key is essential for maintaining the integrity of the "HasMany" relationship.
+ * @property {boolean} uniDirectional - Indicates whether the relationship is unidirectional. If `true`, the relationship supports access patterns in only one direction (from the owning entity to the related entities), reducing denormalized data. This is useful when bidirectional access patterns are unnecessary.
  *
  * @param {RelationshipMetadata} item - An existing set of relationship metadata that should be applied to the newly created `HasManyRelationship` instance. This parameter allows for the inheritance and augmentation of relationship properties.
  */
 class HasManyRelationship extends RelationshipMetadata_1.default {
     type = "HasMany";
     foreignKey;
+    uniDirectional = false;
     constructor(item) {
         super();
         if (item !== undefined) {

package/dist/src/metadata/relationship-metadata/OwnedByRelationship.d.ts

@@ -0,0 +1,18 @@
+import type { ForeignKeyProperty } from "../../types";
+import RelationshipMetadata from "./RelationshipMetadata";
+/**
+ * Represents an "Owned By" relationship metadata within the ORM system. These are uni-directional relationships to the parent
+ *
+ * @extends {RelationshipMetadata} Inherits the base functionality and properties of `RelationshipMetadata`.
+ * @property {"OwnedBy"} type - The type of the relationship, statically set to "OwnedBy" to signify a unidirectional relationship where the current entity is owned by another entity.
+ * @property {ForeignKeyProperty} foreignKey - The attribute representing the foreign key in the relationship. This specifies the field in the current entity that links to the owning entity, enabling relationship queries and operations.
+ *
+ * @param {RelationshipMetadata} item - The initial relationship metadata to be copied into this "Owned By" relationship instance. This facilitates the creation and setup of relationship metadata based on existing configurations.
+ */
+declare class OwnedByRelationship extends RelationshipMetadata {
+    type: "OwnedBy";
+    foreignKey: ForeignKeyProperty;
+    constructor(item: RelationshipMetadata);
+}
+export default OwnedByRelationship;
+//# sourceMappingURL=OwnedByRelationship.d.ts.map

package/dist/src/metadata/relationship-metadata/OwnedByRelationship.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OwnedByRelationship.d.ts","sourceRoot":"","sources":["../../../../src/metadata/relationship-metadata/OwnedByRelationship.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,oBAAoB,MAAM,wBAAwB,CAAC;AAE1D;;;;;;;;GAQG;AACH,cAAM,mBAAoB,SAAQ,oBAAoB;IACpD,IAAI,EAAE,SAAS,CAAa;IAC5B,UAAU,EAAE,kBAAkB,CAAC;gBAEnB,IAAI,EAAE,oBAAoB;CAMvC;AAED,eAAe,mBAAmB,CAAC"}

package/dist/src/metadata/relationship-metadata/OwnedByRelationship.js

@@ -0,0 +1,26 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const RelationshipMetadata_1 = __importDefault(require("./RelationshipMetadata"));
+/**
+ * Represents an "Owned By" relationship metadata within the ORM system. These are uni-directional relationships to the parent
+ *
+ * @extends {RelationshipMetadata} Inherits the base functionality and properties of `RelationshipMetadata`.
+ * @property {"OwnedBy"} type - The type of the relationship, statically set to "OwnedBy" to signify a unidirectional relationship where the current entity is owned by another entity.
+ * @property {ForeignKeyProperty} foreignKey - The attribute representing the foreign key in the relationship. This specifies the field in the current entity that links to the owning entity, enabling relationship queries and operations.
+ *
+ * @param {RelationshipMetadata} item - The initial relationship metadata to be copied into this "Owned By" relationship instance. This facilitates the creation and setup of relationship metadata based on existing configurations.
+ */
+class OwnedByRelationship extends RelationshipMetadata_1.default {
+    type = "OwnedBy";
+    foreignKey;
+    constructor(item) {
+        super();
+        if (item !== undefined) {
+            Object.assign(this, item);
+        }
+    }
+}
+exports.default = OwnedByRelationship;

package/dist/src/metadata/relationship-metadata/RelationshipMetadata.d.ts

@@ -1,6 +1,6 @@
 import type DynaRecord from "../../DynaRecord";
 import type { EntityClass } from "../../types";
-type RelationshipType = "HasMany" | "BelongsTo" | "HasOne" | "HasAndBelongsToMany";
+type RelationshipType = "HasMany" | "BelongsTo" | "HasOne" | "HasAndBelongsToMany" | "OwnedBy";
 /**
  * Serves as the base class for defining metadata related to various types of relationships within the ORM system, such as "HasMany", "BelongsTo", "HasOne", and "HasAndBelongsToMany". This abstract class provides a common structure for relationship metadata, encapsulating the relationship type, target entity, and property name.
  *

package/dist/src/metadata/relationship-metadata/RelationshipMetadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RelationshipMetadata.d.ts","sourceRoot":"","sources":["../../../../src/metadata/relationship-metadata/RelationshipMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,KAAK,gBAAgB,GACjB,SAAS,GACT,WAAW,GACX,QAAQ,GACR,qBAAqB,CAAC;AAE1B;;;;;;;;;;GAUG;AACH,uBAAe,oBAAoB;IACjC,SAAgB,IAAI,EAAE,gBAAgB,CAAC;IAChC,MAAM,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;IAChC,YAAY,EAAE,MAAM,UAAU,CAAC;CACvC;AAED,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"RelationshipMetadata.d.ts","sourceRoot":"","sources":["../../../../src/metadata/relationship-metadata/RelationshipMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,KAAK,gBAAgB,GACjB,SAAS,GACT,WAAW,GACX,QAAQ,GACR,qBAAqB,GACrB,SAAS,CAAC;AAEd;;;;;;;;;;GAUG;AACH,uBAAe,oBAAoB;IACjC,SAAgB,IAAI,EAAE,gBAAgB,CAAC;IAChC,MAAM,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;IAChC,YAAY,EAAE,MAAM,UAAU,CAAC;CACvC;AAED,eAAe,oBAAoB,CAAC"}

package/dist/src/metadata/relationship-metadata/index.d.ts

@@ -2,6 +2,7 @@ import BelongsToRelationship from "./BelongsToRelationship";
 import HasAndBelongsToManyRelationship from "./HasAndBelongsToManyRelationship";
 import HasManyRelationship from "./HasManyRelationship";
 import HasOneRelationship from "./HasOneRelationship";
+import OwnedByRelationship from "./OwnedByRelationship";
 export * from "./types";
-export { BelongsToRelationship, HasAndBelongsToManyRelationship, HasManyRelationship, HasOneRelationship };
+export { BelongsToRelationship, HasAndBelongsToManyRelationship, HasManyRelationship, HasOneRelationship, OwnedByRelationship };
 //# sourceMappingURL=index.d.ts.map

package/dist/src/metadata/relationship-metadata/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/metadata/relationship-metadata/index.ts"],"names":[],"mappings":"AAAA,OAAO,qBAAqB,MAAM,yBAAyB,CAAC;AAC5D,OAAO,+BAA+B,MAAM,mCAAmC,CAAC;AAChF,OAAO,mBAAmB,MAAM,uBAAuB,CAAC;AACxD,OAAO,kBAAkB,MAAM,sBAAsB,CAAC;AAEtD,cAAc,SAAS,CAAC;AAExB,OAAO,EACL,qBAAqB,EACrB,+BAA+B,EAC/B,mBAAmB,EACnB,kBAAkB,EACnB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/metadata/relationship-metadata/index.ts"],"names":[],"mappings":"AAAA,OAAO,qBAAqB,MAAM,yBAAyB,CAAC;AAC5D,OAAO,+BAA+B,MAAM,mCAAmC,CAAC;AAChF,OAAO,mBAAmB,MAAM,uBAAuB,CAAC;AACxD,OAAO,kBAAkB,MAAM,sBAAsB,CAAC;AACtD,OAAO,mBAAmB,MAAM,uBAAuB,CAAC;AAExD,cAAc,SAAS,CAAC;AAExB,OAAO,EACL,qBAAqB,EACrB,+BAA+B,EAC/B,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACpB,CAAC"}

package/dist/src/metadata/relationship-metadata/index.js

@@ -17,7 +17,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HasOneRelationship = exports.HasManyRelationship = exports.HasAndBelongsToManyRelationship = exports.BelongsToRelationship = void 0;
+exports.OwnedByRelationship = exports.HasOneRelationship = exports.HasManyRelationship = exports.HasAndBelongsToManyRelationship = exports.BelongsToRelationship = void 0;
 const BelongsToRelationship_1 = __importDefault(require("./BelongsToRelationship"));
 exports.BelongsToRelationship = BelongsToRelationship_1.default;
 const HasAndBelongsToManyRelationship_1 = __importDefault(require("./HasAndBelongsToManyRelationship"));
@@ -26,4 +26,6 @@ const HasManyRelationship_1 = __importDefault(require("./HasManyRelationship"));
 exports.HasManyRelationship = HasManyRelationship_1.default;
 const HasOneRelationship_1 = __importDefault(require("./HasOneRelationship"));
 exports.HasOneRelationship = HasOneRelationship_1.default;
+const OwnedByRelationship_1 = __importDefault(require("./OwnedByRelationship"));
+exports.OwnedByRelationship = OwnedByRelationship_1.default;
 __exportStar(require("./types"), exports);

package/dist/src/metadata/relationship-metadata/types.d.ts

@@ -2,6 +2,7 @@ import type BelongsToRelationship from "./BelongsToRelationship";
 import type HasAndBelongsToManyRelationship from "./HasAndBelongsToManyRelationship";
 import type HasManyRelationship from "./HasManyRelationship";
 import type HasOneRelationship from "./HasOneRelationship";
+import type OwnedByRelationship from "./OwnedByRelationship";
 /**
  * A union type that encompasses all possible relationship metadata classes within the ORM system. This type is used to represent the metadata for various types of relationships that can exist between entities, such as "BelongsTo", "HasMany", "HasOne", and "HasAndBelongsToMany" relationships.
  *
@@ -10,7 +11,11 @@ import type HasOneRelationship from "./HasOneRelationship";
  * - `BelongsToRelationship`: Represents a "BelongsTo" relationship, indicating that the entity has a foreign key pointing to another entity.
  * - `HasManyRelationship`: Represents a "HasMany" relationship, indicating that the entity can be associated with multiple instances of another entity.
  * - `HasOneRelationship`: Represents a "HasOne" relationship, indicating that the entity is associated with at most one instance of another entity.
- * - `HasAndBelongsToManyRelationship`: Represents a "HasAndBelongsToMany" relationship, facilitated by a join table, indicating that the entity can have many-to-many associations with another entity.
+ * - `OwnedByRelationship`: Represents an "OwnedBy" relationship, indicating a unidirectional relationship where the current entity is owned by another entity. This relationship focuses on linking the entity to its owner without requiring reverse associations.
  */
-export type RelationshipMetadata = BelongsToRelationship | HasManyRelationship | HasOneRelationship | HasAndBelongsToManyRelationship;
+export type RelationshipMetadata = BelongsToRelationship | HasManyRelationship | HasOneRelationship | HasAndBelongsToManyRelationship | OwnedByRelationship;
+/**
+ * An array of "Has" relationships (EX: "HasMany")
+ */
+export type HasRelationships = Array<HasManyRelationship | HasOneRelationship | HasAndBelongsToManyRelationship>;
 //# sourceMappingURL=types.d.ts.map

package/dist/src/metadata/relationship-metadata/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/metadata/relationship-metadata/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,qBAAqB,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,+BAA+B,MAAM,mCAAmC,CAAC;AACrF,OAAO,KAAK,mBAAmB,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,kBAAkB,MAAM,sBAAsB,CAAC;AAE3D;;;;;;;;;GASG;AACH,MAAM,MAAM,oBAAoB,GAC5B,qBAAqB,GACrB,mBAAmB,GACnB,kBAAkB,GAClB,+BAA+B,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/metadata/relationship-metadata/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,qBAAqB,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,+BAA+B,MAAM,mCAAmC,CAAC;AACrF,OAAO,KAAK,mBAAmB,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,kBAAkB,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,mBAAmB,MAAM,uBAAuB,CAAC;AAE7D;;;;;;;;;GASG;AACH,MAAM,MAAM,oBAAoB,GAC5B,qBAAqB,GACrB,mBAAmB,GACnB,kBAAkB,GAClB,+BAA+B,GAC/B,mBAAmB,CAAC;AAExB;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,KAAK,CAClC,mBAAmB,GAAG,kBAAkB,GAAG,+BAA+B,CAC3E,CAAC"}

package/dist/src/metadata/relationship-metadata/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/metadata/relationship-metadata/utils.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpD,eAAO,MAAM,0BAA0B,YAC5B,oBAAoB,KAC5B,oBAaF,CAAC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/metadata/relationship-metadata/utils.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpD,eAAO,MAAM,0BAA0B,YAC5B,oBAAoB,KAC5B,oBAeF,CAAC"}

package/dist/src/metadata/relationship-metadata/utils.js

@@ -8,6 +8,7 @@ const BelongsToRelationship_1 = __importDefault(require("./BelongsToRelationship
 const HasAndBelongsToManyRelationship_1 = __importDefault(require("./HasAndBelongsToManyRelationship"));
 const HasManyRelationship_1 = __importDefault(require("./HasManyRelationship"));
 const HasOneRelationship_1 = __importDefault(require("./HasOneRelationship"));
+const OwnedByRelationship_1 = __importDefault(require("./OwnedByRelationship"));
 const createRelationshipInstance = (options) => {
     switch (options.type) {
         case "BelongsTo":
@@ -18,6 +19,8 @@ const createRelationshipInstance = (options) => {
             return new HasManyRelationship_1.default(options);
         case "HasOne":
             return new HasOneRelationship_1.default(options);
+        case "OwnedBy":
+            return new OwnedByRelationship_1.default(options);
         default:
             throw new Error("Invalid relationship type");
     }

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

@@ -1,7 +1,6 @@
 import type { NativeScalarAttributeValue } from "@aws-sdk/util-dynamodb";
-import type { AttributeMetadata, EntityMetadata, JoinTableMetadata, RelationshipMetadata, TableMetadata } from ".";
+import type { AttributeMetadata, BelongsToRelationship, EntityMetadata, JoinTableMetadata, OwnedByRelationship, RelationshipMetadata, TableMetadata } from ".";
 import type DynaRecord from "../DynaRecord";
-import type { BelongsToLink } from "../relationships";
 import type { MakeOptional } from "../types";
 import type { ZodType } from "zod";
 /**
@@ -35,11 +34,11 @@ export type JoinTableMetadataStorage = Record<string, JoinTableMetadata[]>;
  */
 export type DefaultDateFields = "createdAt" | "updatedAt";
 /**
- * Specifies the default fields used in entities, including fields from `DynaRecord` or `BelongsToLink`. Instance methods are excluded
+ * Specifies the default fields used in entities, including fields from `DynaRecord`. Instance methods are excluded
  */
 export type DefaultFields = {
     [K in keyof DynaRecord]: DynaRecord[K] extends (...args: any[]) => any ? never : K;
-}[keyof DynaRecord] | keyof BelongsToLink;
+}[keyof DynaRecord];
 /**
  * Defines the structure for default fields within a table, mapping field names to their `AttributeMetadata` aliases.
  */
@@ -91,4 +90,8 @@ export interface AttributeMetadataOptions {
     nullable?: boolean;
     serializers?: Serializers;
 }
+/**
+ * A relationship that is either BelongsTo (bi-directional to parent) or OwnedBy (uni directional to parent)
+ */
+export type BelongsToOrOwnedByRelationship = BelongsToRelationship | OwnedByRelationship;
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/metadata/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,aAAa,EACd,MAAM,GAAG,CAAC;AACX,OAAO,KAAK,UAAU,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAEnC;;GAEG;AACH,MAAM,MAAM,kCAAkC,GAAG,OAAO,CACtD,oBAAoB,EACpB;IAAE,UAAU,EAAE,MAAM,UAAU,CAAA;CAAE,CACjC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;AAEzE;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;AAE/E;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAEjE;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAC;AAE3E;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,WAAW,CAAC;AAE1D;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB;KACG,CAAC,IAAI,MAAM,UAAU,GAAG,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAClE,KAAK,GACL,CAAC;CACN,CAAC,MAAM,UAAU,CAAC,GACnB,MAAM,aAAa,CAAC;AAExB;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,CACrC,aAAa,EACb,IAAI,CAAC,iBAAiB,EAAE,OAAO,CAAC,CACjC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,WAAW,CAAC,GAAG;IAC7E,aAAa,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC7C,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG,YAAY,CACrD,IAAI,CAAC,wBAAwB,EAAE,UAAU,CAAC,EAC1C,OAAO,CACR,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,0BAA0B,KAAK,GAAG,CAAC;AAE1E;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,GAAG,KAAK,0BAA0B,CAAC;AAEzE;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,iBAAiB,EAAE,gBAAgB,CAAC;IACpC;;OAEG;IACH,gBAAgB,EAAE,eAAe,CAAC;CACnC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,wBAAwB;IACvC,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/metadata/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,KAAK,EACV,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACd,MAAM,GAAG,CAAC;AACX,OAAO,KAAK,UAAU,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAEnC;;GAEG;AACH,MAAM,MAAM,kCAAkC,GAAG,OAAO,CACtD,oBAAoB,EACpB;IAAE,UAAU,EAAE,MAAM,UAAU,CAAA;CAAE,CACjC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;AAEzE;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;AAE/E;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAEjE;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAC;AAE3E;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,WAAW,CAAC;AAE1D;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;KACzB,CAAC,IAAI,MAAM,UAAU,GAAG,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAClE,KAAK,GACL,CAAC;CACN,CAAC,MAAM,UAAU,CAAC,CAAC;AAEpB;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,CACrC,aAAa,EACb,IAAI,CAAC,iBAAiB,EAAE,OAAO,CAAC,CACjC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,WAAW,CAAC,GAAG;IAC7E,aAAa,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC7C,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG,YAAY,CACrD,IAAI,CAAC,wBAAwB,EAAE,UAAU,CAAC,EAC1C,OAAO,CACR,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,0BAA0B,KAAK,GAAG,CAAC;AAE1E;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,GAAG,KAAK,0BAA0B,CAAC;AAEzE;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,iBAAiB,EAAE,gBAAgB,CAAC;IACpC;;OAEG;IACH,gBAAgB,EAAE,eAAe,CAAC;CACnC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,wBAAwB;IACvC,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,MAAM,8BAA8B,GACtC,qBAAqB,GACrB,mBAAmB,CAAC"}

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

@@ -1,6 +1,6 @@
-import type { RelationshipMetadata, HasManyRelationship, BelongsToRelationship, HasOneRelationship, HasAndBelongsToManyRelationship } from ".";
+import type { RelationshipMetadata, HasManyRelationship, BelongsToRelationship, HasOneRelationship, HasAndBelongsToManyRelationship, OwnedByRelationship } from ".";
 import type DynaRecord from "../DynaRecord";
-import type { RelationshipMetadataWithForeignKey } from "./types";
+import type { BelongsToOrOwnedByRelationship, RelationshipMetadataWithForeignKey } from "./types";
 import type { EntityClass } from "../types";
 /**
  * Type guard to check if the relationship is a HasMany
@@ -18,6 +18,10 @@ export declare const isHasOneRelationship: (rel: RelationshipMetadata) => rel is
  * Type guard to check if the relationship is a HasOne
  */
 export declare const isHasAndBelongsToManyRelationship: (rel: RelationshipMetadata) => rel is HasAndBelongsToManyRelationship;
+/**
+ * Type guard to check if the relationship is of type OwnedBy
+ */
+export declare const isOwnedByRelationship: (rel: RelationshipMetadata) => rel is OwnedByRelationship;
 /**
  * Type guard to check if the relationship metadata includes a foreignKey
  * @param rel
@@ -30,7 +34,7 @@ export declare const isRelationshipMetadataWithForeignKey: (rel: RelationshipMet
  * @param rel
  * @returns
  */
-export declare const doesEntityBelongToRelAsHasOne: <T extends DynaRecord>(Entity: EntityClass<T>, rel: BelongsToRelationship) => boolean;
+export declare const doesEntityBelongToRelAsHasOne: <T extends DynaRecord>(Entity: EntityClass<T>, rel: BelongsToOrOwnedByRelationship) => boolean;
 /**
  * Returns true if an "Entity" BelongsTo the provided relationship as a HasMany
  * @param Entity
@@ -38,5 +42,5 @@ export declare const doesEntityBelongToRelAsHasOne: <T extends DynaRecord>(Entit
  * @param foreignKey
  * @returns
  */
-export declare const doesEntityBelongToRelAsHasMany: <T extends DynaRecord>(Entity: EntityClass<T>, rel: BelongsToRelationship) => boolean;
+export declare const doesEntityBelongToRelAsHasMany: <T extends DynaRecord>(Entity: EntityClass<T>, rel: BelongsToOrOwnedByRelationship) => boolean;
 //# sourceMappingURL=utils.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/metadata/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,+BAA+B,EAChC,MAAM,GAAG,CAAC;AACX,OAAO,KAAK,UAAU,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C;;GAEG;AACH,eAAO,MAAM,qBAAqB,QAC3B,oBAAoB,+BAG1B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,QAC7B,oBAAoB,iCAG1B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,QAC1B,oBAAoB,8BAG1B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iCAAiC,QACvC,oBAAoB,2CAG1B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oCAAoC,QAC1C,oBAAoB,8CAG1B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,sDAEnC,qBAAqB,KACzB,OAMF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,8BAA8B,sDAEpC,qBAAqB,KACzB,OAMF,CAAC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/metadata/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,+BAA+B,EAC/B,mBAAmB,EACpB,MAAM,GAAG,CAAC;AACX,OAAO,KAAK,UAAU,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EACV,8BAA8B,EAC9B,kCAAkC,EACnC,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C;;GAEG;AACH,eAAO,MAAM,qBAAqB,QAC3B,oBAAoB,KACxB,GAAG,IAAI,mBAET,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,QAC7B,oBAAoB,KACxB,GAAG,IAAI,qBAET,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,QAC1B,oBAAoB,KACxB,GAAG,IAAI,kBAET,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iCAAiC,QACvC,oBAAoB,KACxB,GAAG,IAAI,+BAET,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,QAC3B,oBAAoB,KACxB,GAAG,IAAI,mBAET,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oCAAoC,QAC1C,oBAAoB,KACxB,GAAG,IAAI,kCAET,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,GAAI,CAAC,SAAS,UAAU,UACxD,WAAW,CAAC,CAAC,CAAC,OACjB,8BAA8B,KAClC,OAMF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,8BAA8B,GAAI,CAAC,SAAS,UAAU,UACzD,WAAW,CAAC,CAAC,CAAC,OACjB,8BAA8B,KAClC,OAMF,CAAC"}

package/dist/src/metadata/utils.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.doesEntityBelongToRelAsHasMany = exports.doesEntityBelongToRelAsHasOne = exports.isRelationshipMetadataWithForeignKey = exports.isHasAndBelongsToManyRelationship = exports.isHasOneRelationship = exports.isBelongsToRelationship = exports.isHasManyRelationship = void 0;
+exports.doesEntityBelongToRelAsHasMany = exports.doesEntityBelongToRelAsHasOne = exports.isRelationshipMetadataWithForeignKey = exports.isOwnedByRelationship = exports.isHasAndBelongsToManyRelationship = exports.isHasOneRelationship = exports.isBelongsToRelationship = exports.isHasManyRelationship = void 0;
 const _1 = __importDefault(require("./"));
 /**
  * Type guard to check if the relationship is a HasMany
@@ -33,6 +33,13 @@ const isHasAndBelongsToManyRelationship = (rel) => {
     return rel.type === "HasAndBelongsToMany" && rel.joinTableName !== undefined;
 };
 exports.isHasAndBelongsToManyRelationship = isHasAndBelongsToManyRelationship;
+/**
+ * Type guard to check if the relationship is of type OwnedBy
+ */
+const isOwnedByRelationship = (rel) => {
+    return rel.type === "OwnedBy";
+};
+exports.isOwnedByRelationship = isOwnedByRelationship;
 /**
  * Type guard to check if the relationship metadata includes a foreignKey
  * @param rel

package/dist/src/operations/Create/Create.d.ts

@@ -2,13 +2,22 @@ import type DynaRecord from "../../DynaRecord";
 import type { EntityClass } from "../../types";
 import OperationBase from "../OperationBase";
 import type { CreateOptions } from "./types";
-import { type EntityAttributes } from "../types";
+import { type EntityAttributesOnly } from "../types";
 /**
- * Represents the operation for creating a new entity in the database, including handling its attributes and any related entities' associations. It will handle de-normalizing data to support relationships
+ * Represents an operation to create a new entity record in DynamoDB, including all necessary
+ * denormalized relationship records. This ensures that "BelongsTo" and "HasMany" relationships
+ * are properly maintained at the time of entity creation.
  *
- * It encapsulates the logic required to translate entity attributes to a format suitable for DynamoDB, execute the creation transaction, and manage any relationships defined by the entity, such as "BelongsTo" or "HasMany" links.
+ * **What it does:**
+ * - Converts the given attributes into a DynamoDB-compatible format.
+ * - Inserts a new entity record, ensuring no duplicate primary key conflicts.
+ * - For each "BelongsTo" relationship that includes a foreign key:
+ *   - Verifies the referenced entity exists.
+ *   - Creates a denormalized link record in the related entity's partition.
+ * - If the entity's relationships imply additional denormalized records in its own partition,
+ *   those are also created after verifying the related entities exist.
  *
- * Only attributes defined on the model can be configured, and will be enforced via types and runtime schema validation.
+ * Only attributes defined on the entity model can be set, validated both at compile-time and runtime.
  *
  * @template T - The type of the entity being created, extending `DynaRecord`.
  */
@@ -16,27 +25,97 @@ declare class Create<T extends DynaRecord> extends OperationBase<T> {
     #private;
     constructor(Entity: EntityClass<T>);
     /**
-     * Create an entity transaction, including relationship transactions (EX: Creating BelongsToLinks for HasMany, checking existence of relationships, etc)
-     * @param attributes
-     * @returns
+     * Executes the create operation.
+     *
+     * **What it does:**
+     * - Parses and validates the provided attributes against the entity schema.
+     * - Generates any required reserved attributes (like `id`, `createdAt`, and `updatedAt`).
+     * - Inserts the new entity record into DynamoDB, ensuring it doesn't already exist.
+     * - For each defined "BelongsTo" relationship, ensures the related entity exists and creates
+     *   a corresponding denormalized "link" record.
+     * - If the entity's creation implies that related records must also be denormalized into its own
+     *   partition (due to "BelongsTo" links), retrieves and inserts those link records.
+     *
+     * @param attributes - Attributes to initialize the new entity. Must be defined on the model and valid per schema constraints.
+     * @returns A promise that resolves to the newly created entity with all attributes, including automatically set fields.
+     * @throws If the entity already exists, a uniqueness violation error is raised.
+     * @throws If a required foreign key does not correspond to an existing entity, an error is raised.
      */
-    run(attributes: CreateOptions<T>): Promise<EntityAttributes<T>>;
+    run(attributes: CreateOptions<T>): Promise<EntityAttributesOnly<T>>;
     /**
-     * Builds the entity attributes
-     * @param attributes
-     * @returns
+     * Builds and returns entity attributes that must be reserved for system usage.
+     *
+     * **What it does:**
+     * - Generates a unique entity ID if the entity's schema does not specify an `id` field.
+     * - Sets `createdAt` and `updatedAt` to the current time.
+     * - Builds the partition and sort key values based on the entity's class and generated ID.
+     *
+     * @param entityAttrs - The user-provided entity attributes.
+     * @returns The combined attributes including all reserved fields.
+     * @private
      */
     private buildReservedAttributes;
     /**
-     * Build the transaction for the parent entity Create item request
-     * @param tableItem
+     * Adds a "PutItem" transaction for the new entity record.
+     *
+     * **What it does:**
+     * - Ensures the primary key does not already exist, preventing duplication.
+     *
+     * @param tableItem - The DynamoDB table item for the entity to put.
+     * @param id - The unique identifier of the new entity.
+     * @private
      */
     private buildPutItemTransaction;
     /**
-     * Build transaction items for associations
-     * @param entityData
+     * Adds "PutItem" transactions to create denormalized "BelongsTo" link records in the related entity's partitions.
+     *
+     * **What it does:**
+     * - For each "BelongsTo" relationship with a defined foreign key, checks that the related entity exists.
+     * - Inserts a "link" item into the related entity's partition to maintain denormalized relationships.
+     *
+     * @param entityData - The complete set of entity attributes for the new entity.
+     * @param tableItem - The main entity's DynamoDB table item.
+     * @private
      */
-    private buildRelationshipTransactions;
+    private buildBelongsToTransactions;
+    /**
+     * Retrieves the DynamoDB items for all entities that the new entity references via "BelongsTo" relationships.
+     *
+     * **What it does:**
+     * - For each "BelongsTo" relationship, queries DynamoDB for the related entity record.
+     * - Returns all found related items as an array.
+     * - If no relationships or no foreign keys are present, returns an empty array.
+     *
+     * @param entityData - The attributes of the entity being created.
+     * @returns A promise that resolves to an array of related DynamoDB items.
+     * @private
+     */
+    private getBelongsToTableItems;
+    /**
+     * Adds a condition check transaction to ensure that the entity referenced by a "BelongsTo" foreign key exists.
+     *
+     * **What it does:**
+     * - Checks the existence of the related entity before creating the link item.
+     * - If the related entity does not exist, the transaction will fail, preventing creation of dangling references.
+     *
+     * @param rel - The "BelongsTo" relationship metadata.
+     * @param relationshipId - The foreign key value referencing the related entity.
+     * @private
+     */
+    private buildRelationshipExistsConditionTransaction;
+    /**
+     * For each related entity referenced by a "BelongsTo" relationship, insert a denormalized copy of that entity
+     * into the new entity's partition. This maintains a consistent, denormalized view of relationships.
+     *
+     * **What it does:**
+     * - Adds "PutItem" operations to create link records in the newly created entity's partition.
+     * - Ensures these link records don't already exist.
+     *
+     * @param entityId - The newly created entity's ID.
+     * @param belongsToTableItems - The table items representing each related "BelongsTo" entity.
+     * @private
+     */
+    private buildAddBelongsToLinkToSelfTransactions;
 }
 export default Create;
 //# sourceMappingURL=Create.d.ts.map

package/dist/src/operations/Create/Create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Create.d.ts","sourceRoot":"","sources":["../../../../src/operations/Create/Create.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAE/C,OAAO,KAAK,EAAmB,WAAW,EAAE,MAAM,aAAa,CAAC;AAGhE,OAAO,aAAa,MAAM,kBAAkB,CAAC;AAE7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,UAAU,CAAC;AAElB;;;;;;;;GAQG;AACH,cAAM,MAAM,CAAC,CAAC,SAAS,UAAU,CAAE,SAAQ,aAAa,CAAC,CAAC,CAAC;;gBAG7C,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;IAMlC;;;;OAIG;IACU,GAAG,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAiB5E;;;;OAIG;IACH,OAAO,CAAC,uBAAuB;IA+B/B;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAiB/B;;;OAGG;YACW,6BAA6B;CAU5C;AAED,eAAe,MAAM,CAAC"}
+{"version":3,"file":"Create.d.ts","sourceRoot":"","sources":["../../../../src/operations/Create/Create.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAE/C,OAAO,KAAK,EAAmB,WAAW,EAAE,MAAM,aAAa,CAAC;AAOhE,OAAO,aAAa,MAAM,kBAAkB,CAAC;AAE7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,UAAU,CAAC;AAIlB;;;;;;;;;;;;;;;;;GAiBG;AACH,cAAM,MAAM,CAAC,CAAC,SAAS,UAAU,CAAE,SAAQ,aAAa,CAAC,CAAC,CAAC;;gBAG7C,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;IAKlC;;;;;;;;;;;;;;;;OAgBG;IACU,GAAG,CACd,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC,GAC3B,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC;IA4BnC;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,uBAAuB;IA8B/B;;;;;;;;;OASG;IACH,OAAO,CAAC,uBAAuB;IAiB/B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,0BAA0B;IAkClC;;;;;;;;;;;OAWG;YACW,sBAAsB;IAmCpC;;;;;;;;;;OAUG;IACH,OAAO,CAAC,2CAA2C;IAmBnD;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,uCAAuC;CA0BhD;AAED,eAAe,MAAM,CAAC"}