dyna-record 0.4.10 → 0.4.11

package/README.md

@@ -183,6 +183,7 @@ const addressSchema = {
   zip: { type: "number", nullable: true },
   tags: { type: "array", items: { type: "string" } },
   category: { type: "enum", values: ["home", "work", "other"] },
+  createdDate: { type: "date" },
   geo: {
     type: "object",
     fields: {
@@ -202,8 +203,8 @@ class Store extends MyTable {
 }
 ```
 
-- **Supported field types:** `"string"`, `"number"`, `"boolean"`, `"enum"` (via `values`), nested `"object"` (via `fields`), and `"array"` (via `items`)
-- **Nullable fields:** Set `nullable: true` on individual fields within the schema to allow `null` values
+- **Supported field types:** `"string"`, `"number"`, `"boolean"`, `"date"` (stored as ISO strings, exposed as `Date` objects), `"enum"` (via `values`), nested `"object"` (via `fields`), and `"array"` (via `items`)
+- **Nullable fields:** Set `nullable: true` on individual fields within the schema to remove them
 - **Nullable object attributes:** Set `nullable: true` on the decorator options to make the entire object optional
 - **Alias support:** Use the `alias` option to map to a different DynamoDB attribute name
 - **Storage:** Objects are stored as native DynamoDB Map types
@@ -221,7 +222,7 @@ const schema = {
   // Top-level enum: inferred as "active" | "inactive"
   status: { type: "enum", values: ["active", "inactive"] },
 
-  // Nullable enum: inferred as "home" | "work" | "other" | null | undefined
+  // Nullable enum: inferred as "home" | "work" | "other" | undefined
   category: { type: "enum", values: ["home", "work", "other"], nullable: true },
 
   // Enum inside a nested object

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

@@ -40,7 +40,7 @@ export interface ObjectAttributeOptions<S extends ObjectSchema> extends Attribut
  * - `"object"` — nested objects (arbitrarily deep)
  * - `"array"` — lists of any field type
  *
- * All field types support `nullable: true` to allow `null` values.
+ * All field types support `nullable: true` to remove them
  *
  * @template T The class type that the decorator is applied to
  * @template S The ObjectSchema type used for validation and type inference

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

@@ -1 +1 @@
-{"version":3,"file":"ObjectAttribute.d.ts","sourceRoot":"","sources":["../../../../src/decorators/attributes/ObjectAttribute.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAE/C,OAAO,KAAK,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAY,MAAM,SAAS,CAAC;AAEzE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,sBAAsB,CAAC,CAAC,SAAS,YAAY,CAC5D,SAAQ,gBAAgB;IACxB;;;;OAIG;IACH,MAAM,EAAE,CAAC,CAAC;CACX;AAsED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiEG;AACH,iBAAS,eAAe,CACtB,CAAC,SAAS,UAAU,EACpB,KAAK,CAAC,CAAC,SAAS,YAAY,EAC5B,CAAC,SAAS,sBAAsB,CAAC,CAAC,CAAC,EACnC,KAAK,EAAE,CAAC,YAEE,SAAS,WACR,yBAAyB,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,UAgBjE;AAED,eAAe,eAAe,CAAC"}
+{"version":3,"file":"ObjectAttribute.d.ts","sourceRoot":"","sources":["../../../../src/decorators/attributes/ObjectAttribute.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAE/C,OAAO,KAAK,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAY,MAAM,SAAS,CAAC;AAGzE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,sBAAsB,CAAC,CAAC,SAAS,YAAY,CAC5D,SAAQ,gBAAgB;IACxB;;;;OAIG;IACH,MAAM,EAAE,CAAC,CAAC;CACX;AAyED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiEG;AACH,iBAAS,eAAe,CACtB,CAAC,SAAS,UAAU,EACpB,KAAK,CAAC,CAAC,SAAS,YAAY,EAC5B,CAAC,SAAS,sBAAsB,CAAC,CAAC,CAAC,EACnC,KAAK,EAAE,CAAC,YAEE,SAAS,WACR,yBAAyB,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,UAkBjE;AAED,eAAe,eAAe,CAAC"}

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

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const zod_1 = require("zod");
 const metadata_1 = __importDefault(require("../../metadata"));
+const serializers_1 = require("./serializers");
 /**
  * Converts an {@link ObjectSchema} to a Zod schema for runtime validation.
  *
@@ -29,7 +30,7 @@ function objectSchemaToZod(schema) {
  * - `"boolean"` → `z.boolean()`
  * - `"enum"` → `z.enum(values)` for string literal validation
  *
- * When `nullable` is `true`, wraps the type with `.nullable().optional()`.
+ * When `nullable` is `true`, wraps the type with `.optional().nullable()`.
  *
  * @param fieldDef The field definition to convert
  * @returns A ZodType that validates values matching the field definition
@@ -52,6 +53,9 @@ function fieldDefToZod(fieldDef) {
         case "boolean":
             zodType = zod_1.z.boolean();
             break;
+        case "date":
+            zodType = zod_1.z.date();
+            break;
         case "enum":
             zodType = zod_1.z.enum(fieldDef.values);
             break;
@@ -62,7 +66,7 @@ function fieldDefToZod(fieldDef) {
         }
     }
     if (fieldDef.nullable === true) {
-        zodType = zodType.nullable().optional();
+        zodType = zodType.optional().nullable();
     }
     return zodType;
 }
@@ -80,7 +84,7 @@ function fieldDefToZod(fieldDef) {
  * - `"object"` — nested objects (arbitrarily deep)
  * - `"array"` — lists of any field type
  *
- * All field types support `nullable: true` to allow `null` values.
+ * All field types support `nullable: true` to remove them
  *
  * @template T The class type that the decorator is applied to
  * @template S The ObjectSchema type used for validation and type inference
@@ -138,10 +142,12 @@ function ObjectAttribute(props) {
             context.addInitializer(function () {
                 const { schema, ...restProps } = props;
                 const zodSchema = objectSchemaToZod(schema);
+                const serializers = (0, serializers_1.createObjectSerializer)(schema);
                 metadata_1.default.addEntityAttribute(this.constructor.name, {
                     attributeName: context.name.toString(),
                     nullable: props?.nullable,
                     type: zodSchema,
+                    serializers,
                     ...restProps
                 });
             });

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

@@ -10,5 +10,5 @@ export { default as IdAttribute } from "./IdAttribute";
 export { default as ObjectAttribute } from "./ObjectAttribute";
 export type { ObjectAttributeOptions } from "./ObjectAttribute";
 export * from "./serializers";
-export type { ObjectSchema, InferObjectSchema, FieldDef, PrimitiveFieldDef, ObjectFieldDef, ArrayFieldDef, EnumFieldDef } from "./types";
+export type { ObjectSchema, InferObjectSchema, FieldDef, PrimitiveFieldDef, ObjectFieldDef, ArrayFieldDef, EnumFieldDef, DateFieldDef } from "./types";
 //# 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,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,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,YAAY,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAChE,cAAc,eAAe,CAAC;AAC9B,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,QAAQ,EACR,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,YAAY,EACb,MAAM,SAAS,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,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,YAAY,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAChE,cAAc,eAAe,CAAC;AAC9B,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,QAAQ,EACR,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,YAAY,EACZ,YAAY,EACb,MAAM,SAAS,CAAC"}

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

@@ -1,4 +1,6 @@
 import type { NativeAttributeValue } from "@aws-sdk/util-dynamodb";
+import type { ObjectSchema } from "./types";
+import type { Serializers } from "../../metadata/types";
 /**
  * Provides serialization and deserialization functions for date attributes when interfacing with a DynamoDB table, enabling the conversion between the table's string-based date representation and JavaScript's `Date` object. DynamoDb dos not support Date types naturally, this utility allows for Date attributes to be serialized to an entity and stored as ISO strings in Dynamo.
  *
@@ -10,4 +12,50 @@ export declare const dateSerializer: {
     toEntityAttribute: (val: NativeAttributeValue) => any;
     toTableAttribute: (val?: Date) => string | undefined;
 };
+/**
+ * Recursively walks an {@link ObjectSchema} and converts the entity value to its
+ * DynamoDB representation.
+ *
+ * - `"date"` fields are converted from `Date` objects to ISO 8601 strings.
+ * - `"object"` fields recurse into their nested schema.
+ * - `"array"` fields map each item through the same conversion.
+ * - `null` and `undefined` values are stripped from the result so that nullable
+ *   fields set to `null` are removed from the stored object rather than persisted
+ *   as `null` in DynamoDB.
+ * - All other field types pass through unchanged.
+ *
+ * @param schema The {@link ObjectSchema} describing the object shape
+ * @param value  The entity-level object value to convert
+ * @returns A new object suitable for DynamoDB storage
+ */
+export declare function objectToTableItem(schema: ObjectSchema, value: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Recursively walks an {@link ObjectSchema} and converts a DynamoDB table item
+ * back to its entity representation.
+ *
+ * - `"date"` fields are converted from ISO 8601 strings to `Date` objects.
+ * - `"object"` fields recurse into their nested schema.
+ * - `"array"` fields map each item through the same conversion.
+ * - `null` and `undefined` values are stripped from the result so that absent
+ *   fields are represented as `undefined` (omitted) on the entity, consistent
+ *   with root-level nullable attribute behaviour.
+ * - All other field types pass through unchanged.
+ *
+ * @param schema The {@link ObjectSchema} describing the object shape
+ * @param value  The DynamoDB table item to convert
+ * @returns A new object with entity-level types (e.g. `Date` instead of string)
+ */
+export declare function tableItemToObject(schema: ObjectSchema, value: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Creates a {@link Serializers} pair for an {@link ObjectSchema}.
+ *
+ * The returned serializers handle:
+ * - Converting `Date` fields to/from ISO 8601 strings for DynamoDB storage.
+ * - Stripping `null` and `undefined` values so that nullable fields set to
+ *   `null` during updates are removed from the stored object.
+ *
+ * @param schema The {@link ObjectSchema} describing the object shape
+ * @returns A `Serializers` object with `toTableAttribute` and `toEntityAttribute` functions
+ */
+export declare function createObjectSerializer(schema: ObjectSchema): Serializers;
 //# 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,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAEnE;;;;;;GAMG;AACH,eAAO,MAAM,cAAc;6BACA,oBAAoB;6BAMpB,IAAI;CAC9B,CAAC"}
+{"version":3,"file":"serializers.d.ts","sourceRoot":"","sources":["../../../../src/decorators/attributes/serializers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAY,MAAM,SAAS,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD;;;;;;GAMG;AACH,eAAO,MAAM,cAAc;6BACA,oBAAoB;6BAMpB,IAAI;CAC9B,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUzB;AAiBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUzB;AAiBD;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,YAAY,GAAG,WAAW,CAOxE"}

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

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.dateSerializer = void 0;
+exports.objectToTableItem = objectToTableItem;
+exports.tableItemToObject = tableItemToObject;
+exports.createObjectSerializer = createObjectSerializer;
 /**
  * Provides serialization and deserialization functions for date attributes when interfacing with a DynamoDB table, enabling the conversion between the table's string-based date representation and JavaScript's `Date` object. DynamoDb dos not support Date types naturally, this utility allows for Date attributes to be serialized to an entity and stored as ISO strings in Dynamo.
  *
@@ -17,3 +20,98 @@ exports.dateSerializer = {
     },
     toTableAttribute: (val) => val?.toISOString() ?? undefined
 };
+/**
+ * Recursively walks an {@link ObjectSchema} and converts the entity value to its
+ * DynamoDB representation.
+ *
+ * - `"date"` fields are converted from `Date` objects to ISO 8601 strings.
+ * - `"object"` fields recurse into their nested schema.
+ * - `"array"` fields map each item through the same conversion.
+ * - `null` and `undefined` values are stripped from the result so that nullable
+ *   fields set to `null` are removed from the stored object rather than persisted
+ *   as `null` in DynamoDB.
+ * - All other field types pass through unchanged.
+ *
+ * @param schema The {@link ObjectSchema} describing the object shape
+ * @param value  The entity-level object value to convert
+ * @returns A new object suitable for DynamoDB storage
+ */
+function objectToTableItem(schema, value) {
+    const result = {};
+    for (const [key, fieldDef] of Object.entries(schema)) {
+        const val = value[key];
+        if (val === undefined || val === null) {
+            continue;
+        }
+        result[key] = convertFieldToTableItem(fieldDef, val);
+    }
+    return result;
+}
+function convertFieldToTableItem(fieldDef, val) {
+    switch (fieldDef.type) {
+        case "date":
+            return val.toISOString();
+        case "object":
+            return objectToTableItem(fieldDef.fields, val);
+        case "array":
+            return val.map(item => convertFieldToTableItem(fieldDef.items, item));
+        default:
+            return val;
+    }
+}
+/**
+ * Recursively walks an {@link ObjectSchema} and converts a DynamoDB table item
+ * back to its entity representation.
+ *
+ * - `"date"` fields are converted from ISO 8601 strings to `Date` objects.
+ * - `"object"` fields recurse into their nested schema.
+ * - `"array"` fields map each item through the same conversion.
+ * - `null` and `undefined` values are stripped from the result so that absent
+ *   fields are represented as `undefined` (omitted) on the entity, consistent
+ *   with root-level nullable attribute behaviour.
+ * - All other field types pass through unchanged.
+ *
+ * @param schema The {@link ObjectSchema} describing the object shape
+ * @param value  The DynamoDB table item to convert
+ * @returns A new object with entity-level types (e.g. `Date` instead of string)
+ */
+function tableItemToObject(schema, value) {
+    const result = {};
+    for (const [key, fieldDef] of Object.entries(schema)) {
+        const val = value[key];
+        if (val === undefined || val === null) {
+            continue;
+        }
+        result[key] = convertFieldToEntityValue(fieldDef, val);
+    }
+    return result;
+}
+function convertFieldToEntityValue(fieldDef, val) {
+    switch (fieldDef.type) {
+        case "date":
+            return new Date(val);
+        case "object":
+            return tableItemToObject(fieldDef.fields, val);
+        case "array":
+            return val.map(item => convertFieldToEntityValue(fieldDef.items, item));
+        default:
+            return val;
+    }
+}
+/**
+ * Creates a {@link Serializers} pair for an {@link ObjectSchema}.
+ *
+ * The returned serializers handle:
+ * - Converting `Date` fields to/from ISO 8601 strings for DynamoDB storage.
+ * - Stripping `null` and `undefined` values so that nullable fields set to
+ *   `null` during updates are removed from the stored object.
+ *
+ * @param schema The {@link ObjectSchema} describing the object shape
+ * @returns A `Serializers` object with `toTableAttribute` and `toEntityAttribute` functions
+ */
+function createObjectSerializer(schema) {
+    return {
+        toTableAttribute: (val) => objectToTableItem(schema, val),
+        toEntityAttribute: (val) => tableItemToObject(schema, val)
+    };
+}

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

@@ -8,16 +8,18 @@
  * | `"string"`  | `string`        |
  * | `"number"`  | `number`        |
  * | `"boolean"` | `boolean`       |
+ * | `"date"`    | `Date`          |
  */
 export interface PrimitiveTypeMap {
     string: string;
     number: number;
     boolean: boolean;
+    date: Date;
 }
 /**
  * The allowed primitive type strings for object schema fields.
  *
- * Derived from the keys of {@link PrimitiveTypeMap}: `"string" | "number" | "boolean"`.
+ * Derived from the keys of {@link PrimitiveTypeMap}: `"string" | "number" | "boolean" | "date"`.
  */
 export type PrimitiveFieldType = keyof PrimitiveTypeMap;
 /**
@@ -35,7 +37,7 @@ export type PrimitiveFieldType = keyof PrimitiveTypeMap;
 export interface PrimitiveFieldDef {
     /** The primitive type — `"string"`, `"number"`, or `"boolean"`. */
     type: PrimitiveFieldType;
-    /** When `true`, the field accepts `null` and becomes optional (`T | null | undefined`). */
+    /** When `true`, the field becomes optional (`T | undefined`). */
     nullable?: boolean;
 }
 /**
@@ -61,7 +63,7 @@ export interface ObjectFieldDef {
     type: "object";
     /** The nested {@link ObjectSchema} describing the object's shape. */
     fields: ObjectSchema;
-    /** When `true`, the field accepts `null` and becomes optional. */
+    /** When `true`, the field becomes optional. */
     nullable?: boolean;
 }
 /**
@@ -83,7 +85,7 @@ export interface ArrayFieldDef {
     type: "array";
     /** A {@link FieldDef} describing the type of each array element. */
     items: FieldDef;
-    /** When `true`, the field accepts `null` and becomes optional. */
+    /** When `true`, the field becomes optional. */
     nullable?: boolean;
 }
 /**
@@ -120,7 +122,7 @@ export interface ArrayFieldDef {
  * type T = InferObjectSchema<typeof schema>;
  * // {
  * //   status: "active" | "inactive";
- * //   category?: "home" | "work" | "other" | null;
+ * //   category?: "home" | "work" | "other";
  * //   geo: { accuracy: "precise" | "approximate" };
  * //   roles: ("admin" | "user" | "guest")[];
  * // }
@@ -138,7 +140,27 @@ export interface EnumFieldDef {
      * Must contain at least one value (enforced by the `[string, ...string[]]` tuple type).
      */
     values: readonly [string, ...string[]];
-    /** When `true`, the field accepts `null` and becomes optional. */
+    /** When `true`, the field becomes optional. */
+    nullable?: boolean;
+}
+/**
+ * A schema field definition for a date type.
+ *
+ * Date fields are stored as ISO 8601 strings in DynamoDB and exposed as
+ * JavaScript `Date` objects on entities, mirroring `@DateAttribute` behavior.
+ *
+ * @example
+ * ```typescript
+ * const schema = {
+ *   createdDate: { type: "date" },
+ *   deletedAt: { type: "date", nullable: true }
+ * } as const satisfies ObjectSchema;
+ * ```
+ */
+export interface DateFieldDef {
+    /** Must be `"date"` to indicate a date field. */
+    type: "date";
+    /** When `true`, the field becomes optional (`Date | undefined`). */
     nullable?: boolean;
 }
 /**
@@ -146,13 +168,14 @@ export interface EnumFieldDef {
  *
  * This is the union of all supported field types:
  * - {@link PrimitiveFieldDef} — `"string"`, `"number"`, `"boolean"`
+ * - {@link DateFieldDef} — dates stored as ISO strings, exposed as `Date` objects
  * - {@link ObjectFieldDef} — nested objects via `fields`
  * - {@link ArrayFieldDef} — arrays/lists via `items`
  * - {@link EnumFieldDef} — string literal enums via `values`
  *
  * Each variant is discriminated by the `type` property.
  */
-export type FieldDef = PrimitiveFieldDef | ObjectFieldDef | ArrayFieldDef | EnumFieldDef;
+export type FieldDef = PrimitiveFieldDef | DateFieldDef | ObjectFieldDef | ArrayFieldDef | EnumFieldDef;
 /**
  * Declarative schema for describing the shape of an object attribute.
  *
@@ -193,7 +216,7 @@ export type InferFieldDef<F extends FieldDef> = F extends ArrayFieldDef ? Array<
  * - Enum fields become a union of their `values` (`values[number]`)
  * - Nested object fields recurse through `InferObjectSchema`
  * - Array fields become `T[]` where `T` is inferred from `items`
- * - Fields with `nullable: true` become optional and accept `null` (`T | null | undefined`)
+ * - Fields with `nullable: true` become optional (`T | undefined`)
  *
  * @example
  * ```typescript
@@ -211,13 +234,13 @@ export type InferFieldDef<F extends FieldDef> = F extends ArrayFieldDef ? Array<
  * //   status: "active" | "inactive";
  * //   tags: string[];
  * //   geo: { lat: number; lng: number };
- * //   age?: number | null;
+ * //   age?: number;
  * // }
  * ```
  */
 export type InferObjectSchema<S extends ObjectSchema> = {
     [K in keyof S as S[K]["nullable"] extends true ? never : K]: InferFieldDef<S[K]>;
 } & {
-    [K in keyof S as S[K]["nullable"] extends true ? K : never]?: InferFieldDef<S[K]> | null;
+    [K in keyof S as S[K]["nullable"] extends true ? K : never]?: InferFieldDef<S[K]>;
 };
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/decorators/attributes/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,gBAAgB,CAAC;AAExD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,iBAAiB;IAChC,mEAAmE;IACnE,IAAI,EAAE,kBAAkB,CAAC;IACzB,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,cAAc;IAC7B,4DAA4D;IAC5D,IAAI,EAAE,QAAQ,CAAC;IACf,qEAAqE;IACrE,MAAM,EAAE,YAAY,CAAC;IACrB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,IAAI,EAAE,OAAO,CAAC;IACd,oEAAoE;IACpE,KAAK,EAAE,QAAQ,CAAC;IAChB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,WAAW,YAAY;IAC3B,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;OAOG;IACH,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IACvC,kEAAkE;IAClE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,QAAQ,GAChB,iBAAiB,GACjB,cAAc,GACd,aAAa,GACb,YAAY,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAEpD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,QAAQ,IAAI,CAAC,SAAS,aAAa,GACnE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAChC,CAAC,SAAS,cAAc,GACtB,iBAAiB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAC9B,CAAC,SAAS,YAAY,GACpB,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GACnB,CAAC,SAAS,iBAAiB,GACzB,gBAAgB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAC3B,KAAK,CAAC;AAEhB;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,YAAY,IAAI;KACrD,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,IAAI,GAAG,KAAK,GAAG,CAAC,GAAG,aAAa,CACxE,CAAC,CAAC,CAAC,CAAC,CACL;CACF,GAAG;KACD,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,IAAI,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,aAAa,CACzE,CAAC,CAAC,CAAC,CAAC,CACL,GAAG,IAAI;CACT,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/decorators/attributes/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,IAAI,CAAC;CACZ;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,gBAAgB,CAAC;AAExD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,iBAAiB;IAChC,mEAAmE;IACnE,IAAI,EAAE,kBAAkB,CAAC;IACzB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,cAAc;IAC7B,4DAA4D;IAC5D,IAAI,EAAE,QAAQ,CAAC;IACf,qEAAqE;IACrE,MAAM,EAAE,YAAY,CAAC;IACrB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,IAAI,EAAE,OAAO,CAAC;IACd,oEAAoE;IACpE,KAAK,EAAE,QAAQ,CAAC;IAChB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,WAAW,YAAY;IAC3B,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;OAOG;IACH,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IACvC,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,QAAQ,GAChB,iBAAiB,GACjB,YAAY,GACZ,cAAc,GACd,aAAa,GACb,YAAY,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAEpD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,QAAQ,IAAI,CAAC,SAAS,aAAa,GACnE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAChC,CAAC,SAAS,cAAc,GACtB,iBAAiB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAC9B,CAAC,SAAS,YAAY,GACpB,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GACnB,CAAC,SAAS,iBAAiB,GACzB,gBAAgB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAC3B,KAAK,CAAC;AAEhB;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,YAAY,IAAI;KACrD,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,IAAI,GAAG,KAAK,GAAG,CAAC,GAAG,aAAa,CACxE,CAAC,CAAC,CAAC,CAAC,CACL;CACF,GAAG;KACD,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,IAAI,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,aAAa,CACzE,CAAC,CAAC,CAAC,CAAC,CACL;CACF,CAAC"}

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

@@ -9,14 +9,28 @@ import type { EntityDefinedAttributes } from "../types";
 type NullableProperties<T> = {
     [K in keyof T]: undefined extends T[K] ? K : never;
 }[keyof T];
+/**
+ * Recursively resolves the value type for `AllowNullForNullable`.
+ *
+ * For plain object types (not `Date`, arrays, primitives, or functions),
+ * recurses via {@link AllowNullForNullable} so that nullable fields within
+ * object schemas (e.g. `@ObjectAttribute`) also receive `| null` during updates.
+ *
+ * Primitives, `Date`, arrays, and functions pass through unchanged.
+ */
+type AllowNullForNullableValue<T> = T extends Date | readonly unknown[] | string | number | boolean | null | undefined | ((...args: unknown[]) => unknown) ? T : T extends Record<string, unknown> ? AllowNullForNullable<T> : T;
 /**
  * Transforms a type `T` by allowing `null` as an additional type for its nullable properties.
  *
+ * Recurses into plain object values (e.g. object schema attributes) so that
+ * nullable fields at any depth receive `| null`, matching root-level nullable
+ * attribute behavior during updates.
+ *
  * @typeParam T - The type whose properties are to be transformed.
  * @returns A new type with properties of `T` where each nullable property is also allowed to be `null`.
  */
 type AllowNullForNullable<T> = {
-    [K in keyof T]: K extends NullableProperties<T> ? T[K] | null : T[K];
+    [K in keyof T]: K extends NullableProperties<T> ? AllowNullForNullableValue<NonNullable<T[K]>> | null | undefined : AllowNullForNullableValue<T[K]>;
 };
 /**
  * Attributes of an entity to update. Not all properties are required. Setting a nullable property to null will remove the attribute from the item

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/operations/Update/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAExD;;;;;GAKG;AACH,KAAK,kBAAkB,CAAC,CAAC,IAAI;KAC1B,CAAC,IAAI,MAAM,CAAC,GAAG,SAAS,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK;CACnD,CAAC,MAAM,CAAC,CAAC,CAAC;AAEX;;;;;GAKG;AACH,KAAK,oBAAoB,CAAC,CAAC,IAAI;KAC5B,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,SAAS,kBAAkB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;CACrE,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,UAAU,IAAI,OAAO,CACvD,oBAAoB,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,CACjD,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;OAKG;IACH,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,UAAU,IAAI,IAAI,CACxD,OAAO,CAAC,CAAC,CAAC,EACV,WAAW,CACZ,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/operations/Update/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAExD;;;;;GAKG;AACH,KAAK,kBAAkB,CAAC,CAAC,IAAI;KAC1B,CAAC,IAAI,MAAM,CAAC,GAAG,SAAS,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK;CACnD,CAAC,MAAM,CAAC,CAAC,CAAC;AAEX;;;;;;;;GAQG;AACH,KAAK,yBAAyB,CAAC,CAAC,IAAI,CAAC,SACjC,IAAI,GACJ,SAAS,OAAO,EAAE,GAClB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,GACT,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,GACjC,CAAC,GACD,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,oBAAoB,CAAC,CAAC,CAAC,GACvB,CAAC,CAAC;AAER;;;;;;;;;GASG;AACH,KAAK,oBAAoB,CAAC,CAAC,IAAI;KAC5B,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,SAAS,kBAAkB,CAAC,CAAC,CAAC,GAC3C,yBAAyB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,GAC/D,yBAAyB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACpC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,UAAU,IAAI,OAAO,CACvD,oBAAoB,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,CACjD,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;OAKG;IACH,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,UAAU,IAAI,IAAI,CACxD,OAAO,CAAC,CAAC,CAAC,EACV,WAAW,CACZ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dyna-record",
-  "version": "0.4.10",
+  "version": "0.4.11",
   "description": "Typescript Data Modeler and ORM for Dynamo",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",