dyna-record 0.0.19 → 0.1.0

package/dist/src/decorators/attributes/StringAttribute.d.ts

@@ -0,0 +1,28 @@
+import type DynaRecord from "../../DynaRecord";
+import type { AttributeDecoratorContext, AttributeOptions, NotForeignKey } from "../types";
+/**
+ * A decorator for marking class fields as string attributes within the context of a single-table design entity, with a specific restriction against using foreign key types.
+ *
+ * IMPORTANT! - This decorator explicitly disallows the use of {@link ForeignKey} type to maintain clear separation between entity relationships and string attributes for improved data integrity and type safety.
+ *
+ * @template T The entity the decorator is applied to.
+ * @template K The type of the attribute, restricted to string attribute values and excluding foreign key types.
+ * @param props An optional object of {@link AttributeOptions}, including configuration options such as metadata attributes and additional property characteristics.
+ * @returns A class field decorator function that targets and initializes the class's prototype to register the attribute with the ORM's metadata system, ensuring proper handling and validation of the entity's string values.
+ *
+ * Usage example:
+ * ```typescript
+ * class Product extends BaseEntity {
+ *   @StringAttribute({ alias: 'SKU' })
+ *   public stockKeepingUnit: string; // Simple string attribute representing the product's SKU
+ *
+ *   @StringAttribute({ alias: 'MyNullableField', nullable: true })
+ *   public myField?: string; // Set to Optional
+ * }
+ * ```
+ *
+ * Here, `@StringAttribute` decorates `stockKeepingUnit` of `Product` as a simple, non-foreign key attribute, facilitating its management within the ORM system.
+ */
+declare function StringAttribute<T extends DynaRecord, K extends string, P extends AttributeOptions>(props?: P): (_value: undefined, context: AttributeDecoratorContext<T, NotForeignKey<K>, P>) => void;
+export default StringAttribute;
+//# sourceMappingURL=StringAttribute.d.ts.map

package/dist/src/decorators/attributes/StringAttribute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StringAttribute.d.ts","sourceRoot":"","sources":["../../../../src/decorators/attributes/StringAttribute.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAE/C,OAAO,KAAK,EACV,yBAAyB,EACzB,gBAAgB,EAChB,aAAa,EACd,MAAM,UAAU,CAAC;AAElB;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,iBAAS,eAAe,CACtB,CAAC,SAAS,UAAU,EACpB,CAAC,SAAS,MAAM,EAChB,CAAC,SAAS,gBAAgB,EAC1B,KAAK,CAAC,EAAE,CAAC,YAEC,SAAS,WACR,0BAA0B,CAAC,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,UAe7D;AAED,eAAe,eAAe,CAAC"}

package/dist/src/decorators/attributes/{Attribute.js → StringAttribute.js}

@@ -3,39 +3,44 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+const zod_1 = require("zod");
 const metadata_1 = __importDefault(require("../../metadata"));
 /**
- * A decorator for marking class fields as attributes within the context of a single-table design entity, with a specific restriction against using foreign key types.
+ * A decorator for marking class fields as string attributes within the context of a single-table design entity, with a specific restriction against using foreign key types.
  *
- * IMPORTANT! - This decorator explicitly disallows the use of {@link ForeignKey} and {@link NullableForeignKey} types to maintain clear separation between entity relationships and scalar attributes for improved data integrity and type safety.
+ * IMPORTANT! - This decorator explicitly disallows the use of {@link ForeignKey} type to maintain clear separation between entity relationships and string attributes for improved data integrity and type safety.
  *
  * @template T The entity the decorator is applied to.
- * @template K The type of the attribute, restricted to native scalar attribute values and excluding foreign key types.
+ * @template K The type of the attribute, restricted to string attribute values and excluding foreign key types.
  * @param props An optional object of {@link AttributeOptions}, including configuration options such as metadata attributes and additional property characteristics.
- * @returns A class field decorator function that targets and initializes the class's prototype to register the attribute with the ORM's metadata system, ensuring proper handling and validation of the entity's scalar values.
+ * @returns A class field decorator function that targets and initializes the class's prototype to register the attribute with the ORM's metadata system, ensuring proper handling and validation of the entity's string values.
  *
  * Usage example:
  * ```typescript
  * class Product extends BaseEntity {
- *   @Attribute({ alias: 'SKU' })
- *   public stockKeepingUnit: string; // Simple scalar attribute representing the product's SKU
+ *   @StringAttribute({ alias: 'SKU' })
+ *   public stockKeepingUnit: string; // Simple string attribute representing the product's SKU
+ *
+ *   @StringAttribute({ alias: 'MyNullableField', nullable: true })
+ *   public myField?: string; // Set to Optional
  * }
  * ```
  *
- * Here, `@Attribute` decorates `stockKeepingUnit` of `Product` as a simple, non-foreign key attribute, facilitating its management within the ORM system.
+ * Here, `@StringAttribute` decorates `stockKeepingUnit` of `Product` as a simple, non-foreign key attribute, facilitating its management within the ORM system.
  */
-function Attribute(props) {
+function StringAttribute(props) {
     return function (_value, context) {
         if (context.kind === "field") {
             context.addInitializer(function () {
                 const entity = Object.getPrototypeOf(this);
                 metadata_1.default.addEntityAttribute(entity.constructor.name, {
                     attributeName: context.name.toString(),
-                    nullable: false,
+                    nullable: props?.nullable,
+                    type: zod_1.z.string(),
                     ...props
                 });
             });
         }
     };
 }
-exports.default = Attribute;
+exports.default = StringAttribute;

package/dist/src/decorators/attributes/index.d.ts

@@ -1,10 +1,9 @@
-export { default as Attribute } from "./Attribute";
-export { default as NullableAttribute } from "./NullableAttribute";
 export { default as PartitionKeyAttribute } from "./PartitionKeyAttribute";
 export { default as SortKeyAttribute } from "./SortKeyAttribute";
 export { default as ForeignKeyAttribute } from "./ForeignKeyAttribute";
-export { default as NullableForeignKeyAttribute } from "./NullableForeignKeyAttribute";
 export { default as DateAttribute } from "./DateAttribute";
-export { default as DateNullableAttribute } from "./DateNullableAttribute";
+export { default as StringAttribute } from "./StringAttribute";
+export { default as BooleanAttribute } from "./BooleanAttribute";
+export { default as NumberAttribute } from "./NumberAttribute";
 export * from "./serializers";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/decorators/attributes/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,OAAO,IAAI,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAC3E,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/decorators/attributes/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,cAAc,eAAe,CAAC"}

package/dist/src/decorators/attributes/index.js

@@ -17,21 +17,19 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DateNullableAttribute = exports.DateAttribute = exports.NullableForeignKeyAttribute = exports.ForeignKeyAttribute = exports.SortKeyAttribute = exports.PartitionKeyAttribute = exports.NullableAttribute = exports.Attribute = void 0;
-var Attribute_1 = require("./Attribute");
-Object.defineProperty(exports, "Attribute", { enumerable: true, get: function () { return __importDefault(Attribute_1).default; } });
-var NullableAttribute_1 = require("./NullableAttribute");
-Object.defineProperty(exports, "NullableAttribute", { enumerable: true, get: function () { return __importDefault(NullableAttribute_1).default; } });
+exports.NumberAttribute = exports.BooleanAttribute = exports.StringAttribute = exports.DateAttribute = exports.ForeignKeyAttribute = exports.SortKeyAttribute = exports.PartitionKeyAttribute = void 0;
 var PartitionKeyAttribute_1 = require("./PartitionKeyAttribute");
 Object.defineProperty(exports, "PartitionKeyAttribute", { enumerable: true, get: function () { return __importDefault(PartitionKeyAttribute_1).default; } });
 var SortKeyAttribute_1 = require("./SortKeyAttribute");
 Object.defineProperty(exports, "SortKeyAttribute", { enumerable: true, get: function () { return __importDefault(SortKeyAttribute_1).default; } });
 var ForeignKeyAttribute_1 = require("./ForeignKeyAttribute");
 Object.defineProperty(exports, "ForeignKeyAttribute", { enumerable: true, get: function () { return __importDefault(ForeignKeyAttribute_1).default; } });
-var NullableForeignKeyAttribute_1 = require("./NullableForeignKeyAttribute");
-Object.defineProperty(exports, "NullableForeignKeyAttribute", { enumerable: true, get: function () { return __importDefault(NullableForeignKeyAttribute_1).default; } });
 var DateAttribute_1 = require("./DateAttribute");
 Object.defineProperty(exports, "DateAttribute", { enumerable: true, get: function () { return __importDefault(DateAttribute_1).default; } });
-var DateNullableAttribute_1 = require("./DateNullableAttribute");
-Object.defineProperty(exports, "DateNullableAttribute", { enumerable: true, get: function () { return __importDefault(DateNullableAttribute_1).default; } });
+var StringAttribute_1 = require("./StringAttribute");
+Object.defineProperty(exports, "StringAttribute", { enumerable: true, get: function () { return __importDefault(StringAttribute_1).default; } });
+var BooleanAttribute_1 = require("./BooleanAttribute");
+Object.defineProperty(exports, "BooleanAttribute", { enumerable: true, get: function () { return __importDefault(BooleanAttribute_1).default; } });
+var NumberAttribute_1 = require("./NumberAttribute");
+Object.defineProperty(exports, "NumberAttribute", { enumerable: true, get: function () { return __importDefault(NumberAttribute_1).default; } });
 __exportStar(require("./serializers"), exports);

package/dist/src/decorators/attributes/serializers.d.ts

@@ -8,6 +8,6 @@ import type { NativeScalarAttributeValue } from "@aws-sdk/util-dynamodb";
  */
 export declare const dateSerializer: {
     toEntityAttribute: (val: NativeScalarAttributeValue) => number | bigint | boolean | Date | import("@aws-sdk/util-dynamodb").NumberValue | ArrayBuffer | Blob | DataView | null | undefined;
-    toTableAttribute: (val: Date) => string;
+    toTableAttribute: (val?: Date) => string | undefined;
 };
 //# sourceMappingURL=serializers.d.ts.map

package/dist/src/decorators/attributes/serializers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serializers.d.ts","sourceRoot":"","sources":["../../../../src/decorators/attributes/serializers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAEzE;;;;;;GAMG;AACH,eAAO,MAAM,cAAc;6BACA,0BAA0B;4BAM3B,IAAI;CAC7B,CAAC"}
+{"version":3,"file":"serializers.d.ts","sourceRoot":"","sources":["../../../../src/decorators/attributes/serializers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAEzE;;;;;;GAMG;AACH,eAAO,MAAM,cAAc;6BACA,0BAA0B;6BAM1B,IAAI;CAC9B,CAAC"}

package/dist/src/decorators/attributes/serializers.js

@@ -15,5 +15,5 @@ exports.dateSerializer = {
         }
         return val;
     },
-    toTableAttribute: (val) => val.toISOString()
+    toTableAttribute: (val) => val?.toISOString() ?? undefined
 };

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

@@ -22,9 +22,18 @@ export interface AttributeOptions {
      * scenarios where column names in the database differ from attribute names in the code.
      */
     alias?: string;
+    /**
+     * Whether or not the attribute is nullable. Defaults to false
+     */
+    nullable?: boolean;
 }
+/**
+ * Attribute options for attributes which are not nullable
+ */
+export type NonNullAttributeOptions = Omit<AttributeOptions, "nullable">;
 /**
  * Do not allow ForeignKey or NullableForeignKey types when using the Attribute decorator
  */
 export type NotForeignKey<T> = T extends ForeignKey | NullableForeignKey ? never : T;
+export type AttributeDecoratorContext<T extends DynaRecord, K, P extends AttributeOptions> = ClassFieldDecoratorContext<T, P["nullable"] extends true ? Optional<K> : K>;
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/decorators/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzE;;GAEG;AACH,MAAM,MAAM,sBAAsB,CAAC,CAAC,SAAS,UAAU,IAAI;KACxD,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,UAAU,GACnC,CAAC,GACD,CAAC,CAAC,CAAC,CAAC,SAAS,kBAAkB,GAC7B,QAAQ,CAAC,CAAC,CAAC,GACX,KAAK;CACZ,CAAC,MAAM,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;;OASG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,SAAS,UAAU,GAAG,kBAAkB,GACpE,KAAK,GACL,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/decorators/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzE;;GAEG;AACH,MAAM,MAAM,sBAAsB,CAAC,CAAC,SAAS,UAAU,IAAI;KACxD,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,UAAU,GACnC,CAAC,GACD,CAAC,CAAC,CAAC,CAAC,SAAS,kBAAkB,GAC7B,QAAQ,CAAC,CAAC,CAAC,GACX,KAAK;CACZ,CAAC,MAAM,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;;OASG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC;AAEzE;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,SAAS,UAAU,GAAG,kBAAkB,GACpE,KAAK,GACL,CAAC,CAAC;AAEN,MAAM,MAAM,yBAAyB,CACnC,CAAC,SAAS,UAAU,EACpB,CAAC,EACD,CAAC,SAAS,gBAAgB,IACxB,0BAA0B,CAAC,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,SAAS,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC"}

package/dist/src/errors.d.ts

@@ -10,4 +10,10 @@ export declare class NullConstraintViolationError extends Error {
 export declare class NotFoundError extends Error {
     readonly code = "NotFoundError";
 }
+/**
+ * Represents an error indicating that an entities attributes are not valid
+ */
+export declare class ValidationError extends Error {
+    readonly code = "ValidationError";
+}
 //# sourceMappingURL=errors.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,SAAgB,IAAI,kCAAkC;CACvD;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,SAAgB,IAAI,mBAAmB;CACxC"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,SAAgB,IAAI,kCAAkC;CACvD;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,SAAgB,IAAI,mBAAmB;CACxC;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,SAAgB,IAAI,qBAAqB;CAC1C"}

package/dist/src/errors.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.NotFoundError = exports.NullConstraintViolationError = void 0;
+exports.ValidationError = exports.NotFoundError = exports.NullConstraintViolationError = void 0;
 /**
  * Represents an error indicating a violation of a null constraint within the ORM system. This error is typically thrown when an operation attempts to set a non-nullable attribute to `null`, which would violate the data integrity rules of the database schema.
  */
@@ -15,3 +15,10 @@ class NotFoundError extends Error {
     code = "NotFoundError";
 }
 exports.NotFoundError = NotFoundError;
+/**
+ * Represents an error indicating that an entities attributes are not valid
+ */
+class ValidationError extends Error {
+    code = "ValidationError";
+}
+exports.ValidationError = ValidationError;

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

@@ -1,3 +1,4 @@
+import { type ZodType } from "zod";
 import type { AttributeMetadataOptions, Serializers } from "./types";
 /**
  * Represents the metadata for an attribute of an entity, including its name, alias (if any), nullability, and serialization strategies.
@@ -8,6 +9,7 @@ import type { AttributeMetadataOptions, Serializers } from "./types";
  * @property {string} alias - The name of the attribute as defined in the database table. If not provided, it defaults to the name of the attribute. This alias is used for database operations to map the attribute to its corresponding database column.
  * @property {boolean} nullable - Indicates whether the attribute can be `null`, defining the attribute's nullability constraint within the database.
  * @property {Serializers | undefined} serializers - Optional serialization strategies for converting the attribute between its database representation and its entity representation. This is particularly useful for custom data types not natively supported by DynamoDB.
+ * @property {ZodType} type - Zod validator to run on the attribute
  *
  * @param {AttributeMetadataOptions} options - Configuration options for the attribute metadata, including the attribute's name, optional alias, nullability, and serialization strategies.
  */
@@ -16,6 +18,7 @@ declare class AttributeMetadata {
     readonly alias: string;
     readonly nullable: boolean;
     readonly serializers?: Serializers;
+    readonly type: ZodType;
     constructor(options: AttributeMetadataOptions);
 }
 export default AttributeMetadata;

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

@@ -1 +1 @@
-{"version":3,"file":"AttributeMetadata.d.ts","sourceRoot":"","sources":["../../../src/metadata/AttributeMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAErE;;;;;;;;;;;GAWG;AACH,cAAM,iBAAiB;IACrB,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,KAAK,EAAE,MAAM,CAAC;IAC9B,SAAgB,QAAQ,EAAE,OAAO,CAAC;IAClC,SAAgB,WAAW,CAAC,EAAE,WAAW,CAAC;gBAE9B,OAAO,EAAE,wBAAwB;CAM9C;AAED,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"AttributeMetadata.d.ts","sourceRoot":"","sources":["../../../src/metadata/AttributeMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,KAAK,CAAC;AACnC,OAAO,KAAK,EAAE,wBAAwB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAErE;;;;;;;;;;;;GAYG;AACH,cAAM,iBAAiB;IACrB,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,KAAK,EAAE,MAAM,CAAC;IAC9B,SAAgB,QAAQ,EAAE,OAAO,CAAC;IAClC,SAAgB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1C,SAAgB,IAAI,EAAE,OAAO,CAAC;gBAElB,OAAO,EAAE,wBAAwB;CAY9C;AAED,eAAe,iBAAiB,CAAC"}

package/dist/src/metadata/AttributeMetadata.js

@@ -9,6 +9,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * @property {string} alias - The name of the attribute as defined in the database table. If not provided, it defaults to the name of the attribute. This alias is used for database operations to map the attribute to its corresponding database column.
  * @property {boolean} nullable - Indicates whether the attribute can be `null`, defining the attribute's nullability constraint within the database.
  * @property {Serializers | undefined} serializers - Optional serialization strategies for converting the attribute between its database representation and its entity representation. This is particularly useful for custom data types not natively supported by DynamoDB.
+ * @property {ZodType} type - Zod validator to run on the attribute
  *
  * @param {AttributeMetadataOptions} options - Configuration options for the attribute metadata, including the attribute's name, optional alias, nullability, and serialization strategies.
  */
@@ -17,11 +18,18 @@ class AttributeMetadata {
     alias;
     nullable;
     serializers;
+    type;
     constructor(options) {
         this.name = options.attributeName;
         this.alias = options.alias ?? options.attributeName;
-        this.nullable = options.nullable;
+        this.nullable = options.nullable ?? false;
         this.serializers = options.serializers;
+        if (options.nullable === true) {
+            this.type = options.type.optional().nullable();
+        }
+        else {
+            this.type = options.type;
+        }
     }
 }
 exports.default = AttributeMetadata;

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

@@ -14,6 +14,7 @@ type EntityClass = new (...args: any) => DynaRecord;
  * @param {string} tableClassName - The name of the table class instance that maps to the database table of the entity.
  */
 declare class EntityMetadata {
+    #private;
     /**
      * The name of the table class instance to which this entity belongs
      */
@@ -37,6 +38,21 @@ declare class EntityMetadata {
      * @param attrMeta
      */
     addAttribute(attrMeta: AttributeMetadata): void;
+    /**
+     * Validate all an entities attributes (used on create)
+     * @param attributes
+     */
+    validateFull(attributes: DynaRecord): void;
+    /**
+     * Validate partial entities attributes (used on update)
+     * @param attributes
+     */
+    validatePartial(attributes: Partial<DynaRecord>): void;
+    /**
+     * Throw validation errors with the cause
+     * @param error
+     */
+    private handleValidationError;
 }
 export default EntityMetadata;
 //# sourceMappingURL=EntityMetadata.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"EntityMetadata.d.ts","sourceRoot":"","sources":["../../../src/metadata/EntityMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,EACjC,MAAM,GAAG,CAAC;AACX,OAAO,KAAK,UAAU,MAAM,eAAe,CAAC;AAE5C,KAAK,WAAW,GAAG,KAAK,GAAG,IAAI,EAAE,GAAG,KAAK,UAAU,CAAC;AAEpD;;;;;;;;;;;GAWG;AACH,cAAM,cAAc;IAClB;;OAEG;IACH,SAAgB,cAAc,EAAE,MAAM,CAAC;IACvC;;OAEG;IACH,SAAgB,UAAU,EAAE,wBAAwB,CAAC;IACrD;;OAEG;IACH,SAAgB,eAAe,EAAE,wBAAwB,CAAC;IAE1D;;OAEG;IACH,SAAgB,aAAa,EAAE,2BAA2B,CAAC;IAE3D,SAAgB,WAAW,EAAE,WAAW,CAAC;gBAE7B,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM;IAS5D;;;OAGG;IACI,YAAY,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;CAIvD;AAED,eAAe,cAAc,CAAC"}
+{"version":3,"file":"EntityMetadata.d.ts","sourceRoot":"","sources":["../../../src/metadata/EntityMetadata.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,EACjC,MAAM,GAAG,CAAC;AACX,OAAO,KAAK,UAAU,MAAM,eAAe,CAAC;AAG5C,KAAK,WAAW,GAAG,KAAK,GAAG,IAAI,EAAE,GAAG,KAAK,UAAU,CAAC;AAEpD;;;;;;;;;;;GAWG;AACH,cAAM,cAAc;;IAClB;;OAEG;IACH,SAAgB,cAAc,EAAE,MAAM,CAAC;IACvC;;OAEG;IACH,SAAgB,UAAU,EAAE,wBAAwB,CAAC;IACrD;;OAEG;IACH,SAAgB,eAAe,EAAE,wBAAwB,CAAC;IAE1D;;OAEG;IACH,SAAgB,aAAa,EAAE,2BAA2B,CAAC;IAE3D,SAAgB,WAAW,EAAE,WAAW,CAAC;gBAiB7B,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM;IAS5D;;;OAGG;IACI,YAAY,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAOtD;;;OAGG;IACI,YAAY,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAYjD;;;OAGG;IACI,eAAe,CAAC,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI;IAY7D;;;OAGG;IACH,OAAO,CAAC,qBAAqB;CAK9B;AAED,eAAe,cAAc,CAAC"}

package/dist/src/metadata/EntityMetadata.js

@@ -1,5 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const zod_1 = require("zod");
+const errors_1 = require("../errors");
 /**
  * Represents metadata for an entity within the ORM system, encapsulating information about the entity's attributes, relationships, and its associated database table.
  *
@@ -30,6 +32,18 @@ class EntityMetadata {
      */
     relationships;
     EntityClass;
+    /**
+     * Zod schema for runtime validation on entity attributes. Validates all attributes (used on Create)
+     */
+    #schema;
+    /**
+     * Zod schema for runtime validation on entity attributes. Validates partial attributes (used on Update)
+     */
+    #schemaPartial;
+    /**
+     * Object containing zod attributes. Built programmatically via decorators and used to create schemas
+     */
+    #zodAttributes = {};
     constructor(entityClass, tableClassName) {
         this.EntityClass = entityClass;
         this.tableClassName = tableClassName;
@@ -44,6 +58,45 @@ class EntityMetadata {
     addAttribute(attrMeta) {
         this.attributes[attrMeta.name] = attrMeta;
         this.tableAttributes[attrMeta.alias] = attrMeta;
+        this.#zodAttributes[attrMeta.name] = attrMeta.type;
+    }
+    /**
+     * Validate all an entities attributes (used on create)
+     * @param attributes
+     */
+    validateFull(attributes) {
+        if (this.#schema === undefined) {
+            this.#schema = zod_1.z.object(this.#zodAttributes);
+        }
+        try {
+            this.#schema.parse(attributes);
+        }
+        catch (error) {
+            this.handleValidationError(error);
+        }
+    }
+    /**
+     * Validate partial entities attributes (used on update)
+     * @param attributes
+     */
+    validatePartial(attributes) {
+        if (this.#schemaPartial === undefined) {
+            this.#schemaPartial = zod_1.z.object(this.#zodAttributes).partial();
+        }
+        try {
+            this.#schemaPartial.parse(attributes);
+        }
+        catch (error) {
+            this.handleValidationError(error);
+        }
+    }
+    /**
+     * Throw validation errors with the cause
+     * @param error
+     */
+    handleValidationError(error) {
+        const errorOptions = error instanceof zod_1.ZodError ? { cause: error.issues } : undefined;
+        throw new errors_1.ValidationError("Validation errors", errorOptions);
     }
 }
 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":"AAAA,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;gBAE/B,OAAO,EAAE,oBAAoB;IAsBzC;;;;OAIG;IACH,OAAO,CAAC,8BAA8B;IA+BtC;;;OAGG;IACI,wBAAwB,CAAC,OAAO,EAAE,4BAA4B,GAAG,IAAI;IAK5E;;;OAGG;IACI,mBAAmB,CAAC,OAAO,EAAE,4BAA4B,GAAG,IAAI;CAIxE;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,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;gBAE/B,OAAO,EAAE,oBAAoB;IAwBzC;;;;OAIG;IACH,OAAO,CAAC,8BAA8B;IAgCtC;;;OAGG;IACI,wBAAwB,CAAC,OAAO,EAAE,4BAA4B,GAAG,IAAI;IAK5E;;;OAGG;IACI,mBAAmB,CAAC,OAAO,EAAE,4BAA4B,GAAG,IAAI;CAIxE;AAED,eAAe,aAAa,CAAC"}

package/dist/src/metadata/TableMetadata.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.tableDefaultFields = exports.defaultTableKeys = void 0;
+const zod_1 = require("zod");
 const _1 = require(".");
 const decorators_1 = require("../decorators");
 exports.defaultTableKeys = { partitionKey: "PK", sortKey: "SK" };
@@ -47,13 +48,15 @@ class TableMetadata {
             name: "",
             alias: exports.defaultTableKeys.partitionKey,
             nullable: false,
-            serializers: { toEntityAttribute: () => "", toTableAttribute: () => "" }
+            serializers: { toEntityAttribute: () => "", toTableAttribute: () => "" },
+            type: zod_1.z.string()
         };
         this.sortKeyAttribute = {
             name: "",
             alias: exports.defaultTableKeys.sortKey,
             nullable: false,
-            serializers: { toEntityAttribute: () => "", toTableAttribute: () => "" }
+            serializers: { toEntityAttribute: () => "", toTableAttribute: () => "" },
+            type: zod_1.z.string()
         };
     }
     /**
@@ -73,7 +76,8 @@ class TableMetadata {
                 name: entityKey,
                 alias,
                 nullable: false,
-                serializers: isDateField ? decorators_1.dateSerializer : undefined
+                serializers: isDateField ? decorators_1.dateSerializer : undefined,
+                type: isDateField ? zod_1.z.date() : zod_1.z.unknown()
             };
             acc.entityDefaults[entityKey] = meta;
             acc.tableDefaults[alias] = meta;

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

@@ -3,6 +3,7 @@ import type { AttributeMetadata, EntityMetadata, JoinTableMetadata, Relationship
 import type DynaRecord from "../DynaRecord";
 import type { BelongsToLink } from "../relationships";
 import type { MakeOptional } from "../types";
+import type { ZodType } from "zod";
 /**
  * Represents relationship metadata that includes a foreign key reference to another entity.
  */
@@ -83,8 +84,9 @@ export interface Serializers {
  */
 export interface AttributeMetadataOptions {
     attributeName: string;
+    type: ZodType;
     alias?: string;
-    nullable: boolean;
+    nullable?: boolean;
     serializers?: Serializers;
 }
 //# 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;AAE7C;;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,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC;AAEnE;;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,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,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,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,GAAG,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC;AAEnE;;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"}

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,EAAE,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD;;;;;;GAMG;AACH,cAAM,MAAM,CAAC,CAAC,SAAS,UAAU,CAAE,SAAQ,aAAa,CAAC,CAAC,CAAC;;gBAG7C,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;IAKlC;;;;OAIG;IACU,GAAG,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAa5E;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAsBvB;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAW/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;AAGhE,OAAO,aAAa,MAAM,kBAAkB,CAAC;AAE7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAGjD;;;;;;GAMG;AACH,cAAM,MAAM,CAAC,CAAC,SAAS,UAAU,CAAE,SAAQ,aAAa,CAAC,CAAC,CAAC;;gBAG7C,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;IAKlC;;;;OAIG;IACU,GAAG,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAgB5E;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAsBvB;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAW/B;;;OAGG;YACW,6BAA6B;CAU5C;AAED,eAAe,MAAM,CAAC"}

package/dist/src/operations/Create/Create.js

@@ -8,6 +8,7 @@ const dynamo_utils_1 = require("../../dynamo-utils");
 const utils_1 = require("../../utils");
 const OperationBase_1 = __importDefault(require("../OperationBase"));
 const utils_2 = require("../utils");
+const metadata_1 = __importDefault(require("../../metadata"));
 /**
  * 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
  *
@@ -28,6 +29,8 @@ class Create extends OperationBase_1.default {
      */
     async run(attributes) {
         const entityData = this.buildEntityData(attributes);
+        const entityMeta = metadata_1.default.getEntity(this.EntityClass.name);
+        entityMeta.validateFull(entityData);
         const tableItem = (0, utils_1.entityToTableItem)(this.EntityClass, entityData);
         this.buildPutItemTransaction(tableItem);
         await this.buildRelationshipTransactions(entityData);

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

@@ -1 +1 @@
-{"version":3,"file":"Update.d.ts","sourceRoot":"","sources":["../../../../src/operations/Update/Update.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAa/C,OAAO,aAAa,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;;;GAMG;AACH,cAAM,MAAM,CAAC,CAAC,SAAS,UAAU,CAAE,SAAQ,aAAa,CAAC,CAAC,CAAC;;gBAK7C,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;IAKlC;;;;OAIG;IACU,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzE;;;;OAIG;IACH,OAAO,CAAC,0BAA0B;IAkClC;;;;;;OAMG;YACW,6BAA6B;IAsB3C;;;;;OAKG;IACH,OAAO,CAAC,sCAAsC;IAyB9C;;OAEG;YACW,SAAS;CAOxB;AAED,eAAe,MAAM,CAAC"}
+{"version":3,"file":"Update.d.ts","sourceRoot":"","sources":["../../../../src/operations/Update/Update.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAa/C,OAAO,aAAa,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C;;;;;;GAMG;AACH,cAAM,MAAM,CAAC,CAAC,SAAS,UAAU,CAAE,SAAQ,aAAa,CAAC,CAAC,CAAC;;gBAK7C,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;IAKlC;;;;OAIG;IACU,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IASzE;;;;OAIG;IACH,OAAO,CAAC,0BAA0B;IAkClC;;;;;;OAMG;YACW,6BAA6B;IAsB3C;;;;;OAKG;IACH,OAAO,CAAC,sCAAsC;IAyB9C;;OAEG;YACW,SAAS;CAOxB;AAED,eAAe,MAAM,CAAC"}

package/dist/src/operations/Update/Update.js

@@ -7,6 +7,7 @@ const dynamo_utils_1 = require("../../dynamo-utils");
 const utils_1 = require("../../utils");
 const utils_2 = require("../utils");
 const OperationBase_1 = __importDefault(require("../OperationBase"));
+const metadata_1 = __importDefault(require("../../metadata"));
 /**
  * Facilitates the operation of updating an existing entity in the database, including handling updates to its attributes and managing changes to its relationships. It will de-normalize data to support relationship links
  *
@@ -27,6 +28,8 @@ class Update extends OperationBase_1.default {
      * @param attributes Attributes on the model to update.
      */
     async run(id, attributes) {
+        const entityMeta = metadata_1.default.getEntity(this.EntityClass.name);
+        entityMeta.validatePartial(attributes);
         this.buildUpdateItemTransaction(id, attributes);
         await this.buildRelationshipTransactions(id, attributes);
         await this.#transactionBuilder.executeTransaction();

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

@@ -48,7 +48,7 @@ export type RelationshipAttributeNames<T> = {
  */
 export type EntityAttributes<T extends DynaRecord> = Omit<T, RelationshipAttributeNames<T>>;
 /**
- * Attributes that are defined on the Entity using the @Attribute decorators. This excludes:
+ * Attributes that are defined on the Entity using the attribute decorators. This excludes:
  *   - relationship attributes
  *   - partition key attribute
  *   - sort key attribute

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dyna-record",
-  "version": "0.0.19",
+  "version": "0.1.0",
   "description": "Typescript Object Relational Mapper (ORM) for Dynamo",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -27,7 +27,8 @@
     "@aws-sdk/client-dynamodb": "^3.502.0",
     "@aws-sdk/lib-dynamodb": "^3.502.0",
     "@aws-sdk/util-dynamodb": "^3.509.0",
-    "uuid": "^9.0.1"
+    "uuid": "^9.0.1",
+    "zod": "^3.23.8"
   },
   "devDependencies": {
     "@aws-sdk/types": "^3.502.0",

package/dist/src/decorators/attributes/Attribute.d.ts

@@ -1,26 +0,0 @@
-import type DynaRecord from "../../DynaRecord";
-import type { AttributeOptions, NotForeignKey } from "../types";
-import { type NativeScalarAttributeValue } from "@aws-sdk/util-dynamodb";
-/**
- * A decorator for marking class fields as attributes within the context of a single-table design entity, with a specific restriction against using foreign key types.
- *
- * IMPORTANT! - This decorator explicitly disallows the use of {@link ForeignKey} and {@link NullableForeignKey} types to maintain clear separation between entity relationships and scalar attributes for improved data integrity and type safety.
- *
- * @template T The entity the decorator is applied to.
- * @template K The type of the attribute, restricted to native scalar attribute values and excluding foreign key types.
- * @param props An optional object of {@link AttributeOptions}, including configuration options such as metadata attributes and additional property characteristics.
- * @returns A class field decorator function that targets and initializes the class's prototype to register the attribute with the ORM's metadata system, ensuring proper handling and validation of the entity's scalar values.
- *
- * Usage example:
- * ```typescript
- * class Product extends BaseEntity {
- *   @Attribute({ alias: 'SKU' })
- *   public stockKeepingUnit: string; // Simple scalar attribute representing the product's SKU
- * }
- * ```
- *
- * Here, `@Attribute` decorates `stockKeepingUnit` of `Product` as a simple, non-foreign key attribute, facilitating its management within the ORM system.
- */
-declare function Attribute<T extends DynaRecord, K extends NativeScalarAttributeValue>(props?: AttributeOptions): (_value: undefined, context: ClassFieldDecoratorContext<T, NotForeignKey<K>>) => void;
-export default Attribute;
-//# sourceMappingURL=Attribute.d.ts.map

package/dist/src/decorators/attributes/Attribute.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Attribute.d.ts","sourceRoot":"","sources":["../../../../src/decorators/attributes/Attribute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAE/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAChE,OAAO,EAAE,KAAK,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAEzE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,iBAAS,SAAS,CAAC,CAAC,SAAS,UAAU,EAAE,CAAC,SAAS,0BAA0B,EAC3E,KAAK,CAAC,EAAE,gBAAgB,YAGd,SAAS,WACR,2BAA2B,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,UAc3D;AAED,eAAe,SAAS,CAAC"}

package/dist/src/decorators/attributes/DateNullableAttribute.d.ts

@@ -1,26 +0,0 @@
-import type DynaRecord from "../../DynaRecord";
-import type { Optional } from "../../types";
-import type { AttributeOptions } from "../types";
-/**
- * Similar to '@Attribute' but specific to Dates since Dates are not native types to dynamo
- *
- * IMPORTANT - For optimal type safety mark the class field property as optional
- *
- * @template T The class type that the decorator is applied to, ensuring type safety and integration within specific class instances.
- * @template K A type constraint extending `Date`, ensuring that the decorator is only applied to class fields specifically intended to represent dates.
- * @param props An {@link AttributeOptions} object providing configuration options for the attribute, such as its `alias` which allows the attribute to be referred to by an alternative name in the database context. The `nullable` property is also set to `false` by default, indicating that the date attribute must not be empty.
- * @returns A class field decorator function that operates within the class field's context. It configures the field as a date attribute and defines how it should be serialized and deserialized to/from DynamoDB.
- *
- * Usage example:
- * ```typescript
- * class MyEntity extends MyTable {
- *   @DateNullableAttribute({ alias: 'MyField' })
- *   public myField?: Date; // Set to Optional
- * }
- * ```
- *
- * Here, `@Attribute` decorates `myField` of `MyEntity`, marking it as an entity attribute with an alias 'MyField' for ORM purposes.
- */
-declare function DateNullableAttribute<T extends DynaRecord, K extends Date>(props?: AttributeOptions): (_value: undefined, context: ClassFieldDecoratorContext<T, Optional<K>>) => void;
-export default DateNullableAttribute;
-//# sourceMappingURL=DateNullableAttribute.d.ts.map

package/dist/src/decorators/attributes/DateNullableAttribute.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"DateNullableAttribute.d.ts","sourceRoot":"","sources":["../../../../src/decorators/attributes/DateNullableAttribute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAE/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAGjD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,iBAAS,qBAAqB,CAAC,CAAC,SAAS,UAAU,EAAE,CAAC,SAAS,IAAI,EACjE,KAAK,CAAC,EAAE,gBAAgB,YAGd,SAAS,WACR,2BAA2B,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,UAetD;AAED,eAAe,qBAAqB,CAAC"}