dyna-record 0.4.1 → 0.4.7

package/dist/src/DynaRecord.d.ts

@@ -1,3 +1,4 @@
+import { type TableMetadata } from "./metadata";
 import { type FindByIdOptions, type FindByIdIncludesRes, type EntityKeyConditions, type QueryResults, Create, type CreateOptions, type UpdateOptions, type EntityAttributesInstance, type IncludedAssociations, type IndexKeyConditions, type OptionsWithoutIndex, type OptionsWithIndex } from "./operations";
 import type { DynamoTableItem, EntityClass, Optional } from "./types";
 interface DynaRecordBase {
@@ -290,6 +291,20 @@ declare abstract class DynaRecord implements DynaRecordBase {
      * @returns The partition key of the entity
      */
     partitionKeyValue(): string;
+    /**
+     * Returns serialized table metadata containing only serializable values.
+     * This method returns a plain object representation of the table metadata,
+     * with functions, class instances, and other non-serializable data converted
+     * to their string representations or omitted.
+     * @returns A plain object representation of the table metadata
+     *
+     * @example
+     * ```typescript
+     * const metadata = User.metadata();
+     * // Returns a serialized object with all metadata information
+     * ```
+     */
+    static metadata(): ReturnType<TableMetadata["toJSON"]>;
 }
 export default DynaRecord;
 //# sourceMappingURL=DynaRecord.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"DynaRecord.d.ts","sourceRoot":"","sources":["../../src/DynaRecord.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"DynaRecord.d.ts","sourceRoot":"","sources":["../../src/DynaRecord.ts"],"names":[],"mappings":"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"}

package/dist/src/DynaRecord.js

@@ -279,6 +279,24 @@ let DynaRecord = (() => {
         partitionKeyValue() {
             return this.constructor.partitionKeyValue(this.id);
         }
+        /**
+         * Returns serialized table metadata containing only serializable values.
+         * This method returns a plain object representation of the table metadata,
+         * with functions, class instances, and other non-serializable data converted
+         * to their string representations or omitted.
+         * @returns A plain object representation of the table metadata
+         *
+         * @example
+         * ```typescript
+         * const metadata = User.metadata();
+         * // Returns a serialized object with all metadata information
+         * ```
+         */
+        static metadata() {
+            const tableMetadata = metadata_1.default.getTable(this.name);
+            const entities = metadata_1.default.getEntitiesForTable(this.name);
+            return tableMetadata.toJSON(entities);
+        }
         constructor() {
             __runInitializers(this, _updatedAt_extraInitializers);
         }

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

@@ -4,7 +4,7 @@ import TableMetadata from "./TableMetadata";
 import EntityMetadata from "./EntityMetadata";
 import JoinTableMetadata from "./JoinTableMetadata";
 import type { RelationshipMetadata } from "./relationship-metadata";
-import type { AttributeMetadataStorage, TableMetadataOptions, AttributeMetadataOptions } from "./types";
+import type { AttributeMetadataStorage, EntityMetadataStorage, TableMetadataOptions, AttributeMetadataOptions } from "./types";
 /**
  * Central storage for managing and accessing all metadata related to entities, attributes, relationships, and tables within the ORM.
  * It provides methods for retrieving and adding metadata for entities and their corresponding tables, handling relationships
@@ -36,6 +36,12 @@ declare class MetadataStorage {
      * @returns joinTableName metadata
      */
     getJoinTable(joinTableName: string): JoinTableMetadata[];
+    /**
+     * Returns all entities that belong to a specific table
+     * @param {string} tableClassName - Name of the table class
+     * @returns Record of entity metadata keyed by entity class name
+     */
+    getEntitiesForTable(tableClassName: string): EntityMetadataStorage;
     /**
      * Returns attribute metadata for attributes defined keyed by entity key
      * @returns - {@link AttributeMetadataStorage}

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

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

package/dist/src/metadata/MetadataStorage.js

@@ -55,6 +55,21 @@ class MetadataStorage {
         this.init();
         return this.#joinTables[joinTableName];
     }
+    /**
+     * Returns all entities that belong to a specific table
+     * @param {string} tableClassName - Name of the table class
+     * @returns Record of entity metadata keyed by entity class name
+     */
+    getEntitiesForTable(tableClassName) {
+        this.init();
+        const entities = {};
+        for (const [entityName, entityMetadata] of Object.entries(this.#entities)) {
+            if (entityMetadata.tableClassName === tableClassName) {
+                entities[entityName] = entityMetadata;
+            }
+        }
+        return entities;
+    }
     /**
      * Returns attribute metadata for attributes defined keyed by entity key
      * @returns - {@link AttributeMetadataStorage}

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

@@ -1,5 +1,6 @@
 import { AttributeMetadata } from ".";
-import type { TableMetadataOptions, DefaultFields, KeysAttributeMetadataOptions } from "./types";
+import type { TableMetadataOptions, DefaultFields, KeysAttributeMetadataOptions, EntityMetadataStorage } from "./types";
+import { type SerializedTableMetadata } from "./schemas";
 export declare const defaultTableKeys: {
     readonly partitionKey: "PK";
     readonly sortKey: "SK";
@@ -66,6 +67,13 @@ declare class TableMetadata {
      * @param options
      */
     addSortKeyAttribute(options: KeysAttributeMetadataOptions): void;
+    /**
+     * Serializes the table metadata to a plain object containing only serializable values.
+     * This removes functions, Zod types, serializers, and other non-serializable data.
+     * @param {EntityMetadataStorage} entities - Entities that belong to this table, keyed by entity class name
+     * @returns A plain object representation of the metadata
+     */
+    toJSON(entities: EntityMetadataStorage): SerializedTableMetadata;
 }
 export default TableMetadata;
 //# sourceMappingURL=TableMetadata.d.ts.map

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,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"}
+{"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,EAC5B,qBAAqB,EACtB,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,KAAK,uBAAuB,EAE7B,MAAM,WAAW,CAAC;AAEnB,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;IAOvE;;;;;OAKG;IACI,MAAM,CAAC,QAAQ,EAAE,qBAAqB,GAAG,uBAAuB;CAMxE;AAED,eAAe,aAAa,CAAC"}

package/dist/src/metadata/TableMetadata.js

@@ -4,6 +4,7 @@ exports.tableDefaultFields = exports.defaultTableKeys = void 0;
 const zod_1 = require("zod");
 const _1 = require(".");
 const decorators_1 = require("../decorators");
+const schemas_1 = require("./schemas");
 exports.defaultTableKeys = { partitionKey: "PK", sortKey: "SK" };
 /**
  * Default fields with default table alias. Can be overwritten through {@link TableMetadataOptions} defaultFields
@@ -121,5 +122,17 @@ class TableMetadata {
         // Set the user defined primary key as reserved key so that its managed by dyna-record
         this.reservedKeys[options.attributeName] = true;
     }
+    /**
+     * Serializes the table metadata to a plain object containing only serializable values.
+     * This removes functions, Zod types, serializers, and other non-serializable data.
+     * @param {EntityMetadataStorage} entities - Entities that belong to this table, keyed by entity class name
+     * @returns A plain object representation of the metadata
+     */
+    toJSON(entities) {
+        return schemas_1.TableMetadataTransform.parse({
+            ...this,
+            entities
+        });
+    }
 }
 exports.default = TableMetadata;

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

@@ -0,0 +1,432 @@
+import { z } from "zod";
+import type { EntityClass } from "../types";
+import type DynaRecord from "../DynaRecord";
+/**
+ * Zod schema that transforms table metadata to a serializable format.
+ * This is the main schema used to serialize {@link TableMetadata} instances,
+ * extracting only serializable values and converting EntityClass references to strings.
+ *
+ * @property {string} name - The name of the table
+ * @property {string} delimiter - The delimiter used in the table's composite keys (defaults to "#")
+ * @property {Record<string, AttributeMetadataTransform>} defaultAttributes - Default attributes for the entity, keyed by entity field names
+ * @property {Record<string, AttributeMetadataTransform>} defaultTableAttributes - Default attributes for the table, keyed by table field aliases
+ * @property {AttributeMetadataTransform} partitionKeyAttribute - Metadata for the table's partition key attribute
+ * @property {AttributeMetadataTransform} sortKeyAttribute - Metadata for the table's sort key attribute
+ * @property {Record<string, EntityMetadataTransform>} entities - Entities mapped to the table, keyed by entity class name
+ *
+ * @returns A serialized table metadata object containing only serializable values
+ *
+ * @example
+ * ```typescript
+ * const metadata = TableMetadataTransform.parse(tableMetadataInstance);
+ * // Returns a plain object with all EntityClass references converted to strings
+ * ```
+ */
+export declare const TableMetadataTransform: z.ZodObject<{
+    name: z.ZodString;
+    delimiter: z.ZodString;
+    defaultAttributes: z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodObject<{
+        name: z.ZodString;
+        alias: z.ZodString;
+        nullable: z.ZodBoolean;
+        foreignKeyTarget: z.ZodOptional<z.ZodType<EntityClass<DynaRecord>, z.ZodTypeDef, EntityClass<DynaRecord>>>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        nullable: boolean;
+        alias: string;
+        foreignKeyTarget?: EntityClass<DynaRecord> | undefined;
+    }, {
+        name: string;
+        nullable: boolean;
+        alias: string;
+        foreignKeyTarget?: EntityClass<DynaRecord> | undefined;
+    }>, {
+        foreignKeyTarget?: string | undefined;
+        name: string;
+        alias: string;
+        nullable: boolean;
+    }, {
+        name: string;
+        nullable: boolean;
+        alias: string;
+        foreignKeyTarget?: EntityClass<DynaRecord> | undefined;
+    }>>;
+    defaultTableAttributes: z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodObject<{
+        name: z.ZodString;
+        alias: z.ZodString;
+        nullable: z.ZodBoolean;
+        foreignKeyTarget: z.ZodOptional<z.ZodType<EntityClass<DynaRecord>, z.ZodTypeDef, EntityClass<DynaRecord>>>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        nullable: boolean;
+        alias: string;
+        foreignKeyTarget?: EntityClass<DynaRecord> | undefined;
+    }, {
+        name: string;
+        nullable: boolean;
+        alias: string;
+        foreignKeyTarget?: EntityClass<DynaRecord> | undefined;
+    }>, {
+        foreignKeyTarget?: string | undefined;
+        name: string;
+        alias: string;
+        nullable: boolean;
+    }, {
+        name: string;
+        nullable: boolean;
+        alias: string;
+        foreignKeyTarget?: EntityClass<DynaRecord> | undefined;
+    }>>;
+    partitionKeyAttribute: z.ZodEffects<z.ZodObject<{
+        name: z.ZodString;
+        alias: z.ZodString;
+        nullable: z.ZodBoolean;
+        foreignKeyTarget: z.ZodOptional<z.ZodType<EntityClass<DynaRecord>, z.ZodTypeDef, EntityClass<DynaRecord>>>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        nullable: boolean;
+        alias: string;
+        foreignKeyTarget?: EntityClass<DynaRecord> | undefined;
+    }, {
+        name: string;
+        nullable: boolean;
+        alias: string;
+        foreignKeyTarget?: EntityClass<DynaRecord> | undefined;
+    }>, {
+        foreignKeyTarget?: string | undefined;
+        name: string;
+        alias: string;
+        nullable: boolean;
+    }, {
+        name: string;
+        nullable: boolean;
+        alias: string;
+        foreignKeyTarget?: EntityClass<DynaRecord> | undefined;
+    }>;
+    sortKeyAttribute: z.ZodEffects<z.ZodObject<{
+        name: z.ZodString;
+        alias: z.ZodString;
+        nullable: z.ZodBoolean;
+        foreignKeyTarget: z.ZodOptional<z.ZodType<EntityClass<DynaRecord>, z.ZodTypeDef, EntityClass<DynaRecord>>>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        nullable: boolean;
+        alias: string;
+        foreignKeyTarget?: EntityClass<DynaRecord> | undefined;
+    }, {
+        name: string;
+        nullable: boolean;
+        alias: string;
+        foreignKeyTarget?: EntityClass<DynaRecord> | undefined;
+    }>, {
+        foreignKeyTarget?: string | undefined;
+        name: string;
+        alias: string;
+        nullable: boolean;
+    }, {
+        name: string;
+        nullable: boolean;
+        alias: string;
+        foreignKeyTarget?: EntityClass<DynaRecord> | undefined;
+    }>;
+    entities: z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodObject<{
+        tableClassName: z.ZodString;
+        attributes: z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodObject<{
+            name: z.ZodString;
+            alias: z.ZodString;
+            nullable: z.ZodBoolean;
+            foreignKeyTarget: z.ZodOptional<z.ZodType<EntityClass<DynaRecord>, z.ZodTypeDef, EntityClass<DynaRecord>>>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            nullable: boolean;
+            alias: string;
+            foreignKeyTarget?: EntityClass<DynaRecord> | undefined;
+        }, {
+            name: string;
+            nullable: boolean;
+            alias: string;
+            foreignKeyTarget?: EntityClass<DynaRecord> | undefined;
+        }>, {
+            foreignKeyTarget?: string | undefined;
+            name: string;
+            alias: string;
+            nullable: boolean;
+        }, {
+            name: string;
+            nullable: boolean;
+            alias: string;
+            foreignKeyTarget?: EntityClass<DynaRecord> | undefined;
+        }>>;
+        tableAttributes: z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodObject<{
+            name: z.ZodString;
+            alias: z.ZodString;
+            nullable: z.ZodBoolean;
+            foreignKeyTarget: z.ZodOptional<z.ZodType<EntityClass<DynaRecord>, z.ZodTypeDef, EntityClass<DynaRecord>>>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            nullable: boolean;
+            alias: string;
+            foreignKeyTarget?: EntityClass<DynaRecord> | undefined;
+        }, {
+            name: string;
+            nullable: boolean;
+            alias: string;
+            foreignKeyTarget?: EntityClass<DynaRecord> | undefined;
+        }>, {
+            foreignKeyTarget?: string | undefined;
+            name: string;
+            alias: string;
+            nullable: boolean;
+        }, {
+            name: string;
+            nullable: boolean;
+            alias: string;
+            foreignKeyTarget?: EntityClass<DynaRecord> | undefined;
+        }>>;
+        relationships: z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodObject<{
+            type: z.ZodString;
+            propertyName: z.ZodString;
+            target: z.ZodOptional<z.ZodType<EntityClass<DynaRecord>, z.ZodTypeDef, EntityClass<DynaRecord>>>;
+            foreignKey: z.ZodOptional<z.ZodString>;
+            joinTableName: z.ZodOptional<z.ZodString>;
+            uniDirectional: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            type: string;
+            propertyName: string;
+            foreignKey?: string | undefined;
+            uniDirectional?: boolean | undefined;
+            joinTableName?: string | undefined;
+            target?: EntityClass<DynaRecord> | undefined;
+        }, {
+            type: string;
+            propertyName: string;
+            foreignKey?: string | undefined;
+            uniDirectional?: boolean | undefined;
+            joinTableName?: string | undefined;
+            target?: EntityClass<DynaRecord> | undefined;
+        }>, {
+            uniDirectional?: boolean | undefined;
+            joinTableName?: string | undefined;
+            foreignKey?: string | undefined;
+            target?: string | undefined;
+            type: string;
+            propertyName: string;
+        }, {
+            type: string;
+            propertyName: string;
+            foreignKey?: string | undefined;
+            uniDirectional?: boolean | undefined;
+            joinTableName?: string | undefined;
+            target?: EntityClass<DynaRecord> | undefined;
+        }>>;
+        idField: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        tableClassName: string;
+        attributes: Record<string, {
+            foreignKeyTarget?: string | undefined;
+            name: string;
+            alias: string;
+            nullable: boolean;
+        }>;
+        tableAttributes: Record<string, {
+            foreignKeyTarget?: string | undefined;
+            name: string;
+            alias: string;
+            nullable: boolean;
+        }>;
+        relationships: Record<string, {
+            uniDirectional?: boolean | undefined;
+            joinTableName?: string | undefined;
+            foreignKey?: string | undefined;
+            target?: string | undefined;
+            type: string;
+            propertyName: string;
+        }>;
+        idField?: string | undefined;
+    }, {
+        tableClassName: string;
+        attributes: Record<string, {
+            name: string;
+            nullable: boolean;
+            alias: string;
+            foreignKeyTarget?: EntityClass<DynaRecord> | undefined;
+        }>;
+        tableAttributes: Record<string, {
+            name: string;
+            nullable: boolean;
+            alias: string;
+            foreignKeyTarget?: EntityClass<DynaRecord> | undefined;
+        }>;
+        relationships: Record<string, {
+            type: string;
+            propertyName: string;
+            foreignKey?: string | undefined;
+            uniDirectional?: boolean | undefined;
+            joinTableName?: string | undefined;
+            target?: EntityClass<DynaRecord> | undefined;
+        }>;
+        idField?: string | undefined;
+    }>, {
+        idField?: string | undefined;
+        tableClassName: string;
+        attributes: Record<string, {
+            foreignKeyTarget?: string | undefined;
+            name: string;
+            alias: string;
+            nullable: boolean;
+        }>;
+        tableAttributes: Record<string, {
+            foreignKeyTarget?: string | undefined;
+            name: string;
+            alias: string;
+            nullable: boolean;
+        }>;
+        relationships: Record<string, {
+            uniDirectional?: boolean | undefined;
+            joinTableName?: string | undefined;
+            foreignKey?: string | undefined;
+            target?: string | undefined;
+            type: string;
+            propertyName: string;
+        }>;
+    }, {
+        tableClassName: string;
+        attributes: Record<string, {
+            name: string;
+            nullable: boolean;
+            alias: string;
+            foreignKeyTarget?: EntityClass<DynaRecord> | undefined;
+        }>;
+        tableAttributes: Record<string, {
+            name: string;
+            nullable: boolean;
+            alias: string;
+            foreignKeyTarget?: EntityClass<DynaRecord> | undefined;
+        }>;
+        relationships: Record<string, {
+            type: string;
+            propertyName: string;
+            foreignKey?: string | undefined;
+            uniDirectional?: boolean | undefined;
+            joinTableName?: string | undefined;
+            target?: EntityClass<DynaRecord> | undefined;
+        }>;
+        idField?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    delimiter: string;
+    defaultAttributes: Record<string, {
+        foreignKeyTarget?: string | undefined;
+        name: string;
+        alias: string;
+        nullable: boolean;
+    }>;
+    defaultTableAttributes: Record<string, {
+        foreignKeyTarget?: string | undefined;
+        name: string;
+        alias: string;
+        nullable: boolean;
+    }>;
+    partitionKeyAttribute: {
+        foreignKeyTarget?: string | undefined;
+        name: string;
+        alias: string;
+        nullable: boolean;
+    };
+    sortKeyAttribute: {
+        foreignKeyTarget?: string | undefined;
+        name: string;
+        alias: string;
+        nullable: boolean;
+    };
+    entities: Record<string, {
+        idField?: string | undefined;
+        tableClassName: string;
+        attributes: Record<string, {
+            foreignKeyTarget?: string | undefined;
+            name: string;
+            alias: string;
+            nullable: boolean;
+        }>;
+        tableAttributes: Record<string, {
+            foreignKeyTarget?: string | undefined;
+            name: string;
+            alias: string;
+            nullable: boolean;
+        }>;
+        relationships: Record<string, {
+            uniDirectional?: boolean | undefined;
+            joinTableName?: string | undefined;
+            foreignKey?: string | undefined;
+            target?: string | undefined;
+            type: string;
+            propertyName: string;
+        }>;
+    }>;
+}, {
+    name: string;
+    delimiter: string;
+    defaultAttributes: Record<string, {
+        name: string;
+        nullable: boolean;
+        alias: string;
+        foreignKeyTarget?: EntityClass<DynaRecord> | undefined;
+    }>;
+    defaultTableAttributes: Record<string, {
+        name: string;
+        nullable: boolean;
+        alias: string;
+        foreignKeyTarget?: EntityClass<DynaRecord> | undefined;
+    }>;
+    partitionKeyAttribute: {
+        name: string;
+        nullable: boolean;
+        alias: string;
+        foreignKeyTarget?: EntityClass<DynaRecord> | undefined;
+    };
+    sortKeyAttribute: {
+        name: string;
+        nullable: boolean;
+        alias: string;
+        foreignKeyTarget?: EntityClass<DynaRecord> | undefined;
+    };
+    entities: Record<string, {
+        tableClassName: string;
+        attributes: Record<string, {
+            name: string;
+            nullable: boolean;
+            alias: string;
+            foreignKeyTarget?: EntityClass<DynaRecord> | undefined;
+        }>;
+        tableAttributes: Record<string, {
+            name: string;
+            nullable: boolean;
+            alias: string;
+            foreignKeyTarget?: EntityClass<DynaRecord> | undefined;
+        }>;
+        relationships: Record<string, {
+            type: string;
+            propertyName: string;
+            foreignKey?: string | undefined;
+            uniDirectional?: boolean | undefined;
+            joinTableName?: string | undefined;
+            target?: EntityClass<DynaRecord> | undefined;
+        }>;
+        idField?: string | undefined;
+    }>;
+}>;
+/**
+ * Type representing the serialized output of table metadata.
+ * This type is inferred from the {@link TableMetadataTransform} schema and represents
+ * the structure of metadata after serialization, with all EntityClass references
+ * converted to strings and all non-serializable data (functions, Zod types, serializers) removed.
+ *
+ * @example
+ * ```typescript
+ * const metadata: SerializedTableMetadata = User.metadata();
+ * // metadata is a plain object with readonly properties
+ * ```
+ */
+export type SerializedTableMetadata = z.output<typeof TableMetadataTransform>;
+//# sourceMappingURL=schemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/metadata/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,UAAU,MAAM,eAAe,CAAC;AA4F5C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQjC,CAAC;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/src/metadata/schemas.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TableMetadataTransform = void 0;
+const zod_1 = require("zod");
+/**
+ * Zod schema that transforms attribute metadata to a serializable format.
+ * Extracts only serializable properties (name, alias, nullable) and converts
+ * the foreignKeyTarget EntityClass reference to its class name string.
+ *
+ * @property {string} name - The name of the attribute as defined on the entity
+ * @property {string} alias - The alias of the attribute as defined in the database table
+ * @property {boolean} nullable - Indicates whether the attribute can be null
+ * @property {EntityClass<DynaRecord>} [foreignKeyTarget] - Optional entity class reference that will be converted to its name string
+ *
+ * @returns A serialized attribute metadata object with foreignKeyTarget as a string (class name) if present
+ */
+const AttributeMetadataTransform = zod_1.z
+    .object({
+    name: zod_1.z.string(),
+    alias: zod_1.z.string(),
+    nullable: zod_1.z.boolean(),
+    foreignKeyTarget: zod_1.z.custom().optional()
+})
+    .transform(attr => ({
+    name: attr.name,
+    alias: attr.alias,
+    nullable: attr.nullable,
+    ...(attr.foreignKeyTarget != null && {
+        foreignKeyTarget: attr.foreignKeyTarget.name
+    })
+}));
+/**
+ * Zod schema that transforms relationship metadata to a serializable format.
+ * Extracts serializable properties and converts EntityClass references to their class name strings.
+ *
+ * @property {string} type - The type of the relationship (e.g., "HasMany", "BelongsTo", "HasOne", "HasAndBelongsToMany", "OwnedBy")
+ * @property {string} propertyName - The property name on the source entity that holds the relationship
+ * @property {EntityClass<DynaRecord>} [target] - Optional target entity class reference that will be converted to its name string
+ * @property {string} [foreignKey] - Optional foreign key property name
+ * @property {string} [joinTableName] - Optional join table name for many-to-many relationships
+ * @property {boolean} [uniDirectional] - Optional flag indicating if the relationship is unidirectional
+ *
+ * @returns A serialized relationship metadata object with EntityClass references converted to strings
+ */
+const RelationshipMetadataTransform = zod_1.z
+    .object({
+    type: zod_1.z.string(),
+    propertyName: zod_1.z.string(),
+    target: zod_1.z.custom().optional(),
+    foreignKey: zod_1.z.string().optional(),
+    joinTableName: zod_1.z.string().optional(),
+    uniDirectional: zod_1.z.boolean().optional()
+})
+    .transform(rel => ({
+    type: rel.type,
+    propertyName: rel.propertyName,
+    ...(rel.target != null && { target: rel.target.name }),
+    ...(rel.foreignKey != null && { foreignKey: rel.foreignKey }),
+    ...(rel.joinTableName != null && { joinTableName: rel.joinTableName }),
+    ...(rel.uniDirectional !== undefined && {
+        uniDirectional: rel.uniDirectional
+    })
+}));
+/**
+ * Zod schema that transforms entity metadata to a serializable format.
+ * Extracts serializable properties and includes nested attribute and relationship metadata.
+ *
+ * @property {string} tableClassName - The name of the table class instance to which this entity belongs
+ * @property {Record<string, AttributeMetadataTransform>} attributes - Attribute metadata keyed by entity field names
+ * @property {Record<string, AttributeMetadataTransform>} tableAttributes - Attribute metadata keyed by table column names (aliases)
+ * @property {Record<string, RelationshipMetadataTransform>} relationships - Relationship metadata keyed by entity property names
+ * @property {string} [idField] - Optional custom id field name (used with @IdAttribute decorator)
+ *
+ * @returns A serialized entity metadata object with all nested metadata transformed
+ */
+const EntityMetadataTransform = zod_1.z
+    .object({
+    tableClassName: zod_1.z.string(),
+    attributes: zod_1.z.record(AttributeMetadataTransform),
+    tableAttributes: zod_1.z.record(AttributeMetadataTransform),
+    relationships: zod_1.z.record(RelationshipMetadataTransform),
+    idField: zod_1.z.string().optional()
+})
+    .transform(entity => ({
+    tableClassName: entity.tableClassName,
+    attributes: entity.attributes,
+    tableAttributes: entity.tableAttributes,
+    relationships: entity.relationships,
+    ...(entity.idField !== undefined &&
+        entity.idField !== "" && { idField: entity.idField })
+}));
+/**
+ * Zod schema that transforms table metadata to a serializable format.
+ * This is the main schema used to serialize {@link TableMetadata} instances,
+ * extracting only serializable values and converting EntityClass references to strings.
+ *
+ * @property {string} name - The name of the table
+ * @property {string} delimiter - The delimiter used in the table's composite keys (defaults to "#")
+ * @property {Record<string, AttributeMetadataTransform>} defaultAttributes - Default attributes for the entity, keyed by entity field names
+ * @property {Record<string, AttributeMetadataTransform>} defaultTableAttributes - Default attributes for the table, keyed by table field aliases
+ * @property {AttributeMetadataTransform} partitionKeyAttribute - Metadata for the table's partition key attribute
+ * @property {AttributeMetadataTransform} sortKeyAttribute - Metadata for the table's sort key attribute
+ * @property {Record<string, EntityMetadataTransform>} entities - Entities mapped to the table, keyed by entity class name
+ *
+ * @returns A serialized table metadata object containing only serializable values
+ *
+ * @example
+ * ```typescript
+ * const metadata = TableMetadataTransform.parse(tableMetadataInstance);
+ * // Returns a plain object with all EntityClass references converted to strings
+ * ```
+ */
+exports.TableMetadataTransform = zod_1.z.object({
+    name: zod_1.z.string(),
+    delimiter: zod_1.z.string(),
+    defaultAttributes: zod_1.z.record(AttributeMetadataTransform),
+    defaultTableAttributes: zod_1.z.record(AttributeMetadataTransform),
+    partitionKeyAttribute: AttributeMetadataTransform,
+    sortKeyAttribute: AttributeMetadataTransform,
+    entities: zod_1.z.record(EntityMetadataTransform)
+});

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

@@ -40,7 +40,7 @@ type IncludedKeys<T extends DynaRecord, Inc extends IncludedAssociations<T> = []
  * entity attributes with included associations.
  */
 type EntityKeysWithIncludedAssociations<T extends DynaRecord, P extends keyof T> = {
-    [K in P]: T[K] extends DynaRecord ? EntityAttributesOnly<T> : T[K] extends DynaRecord[] ? Array<EntityAttributesOnly<T[K][number]>> : T[K];
+    [K in P]: T[K] extends DynaRecord ? EntityAttributesOnly<T[K]> : T[K] extends DynaRecord[] ? Array<EntityAttributesOnly<T[K][number]>> : T[K];
 };
 /**
  * The result type for a FindById operation that includes associations.

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/operations/FindById/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EACV,oBAAoB,EACpB,cAAc,EACd,0BAA0B,EAC3B,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,oBAAoB,CAAC,CAAC,SAAS,UAAU,IAAI,KAAK,CAAC;IAC7D,WAAW,EAAE,0BAA0B,CAAC,CAAC,CAAC,CAAC;CAC5C,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,WAAW,eAAe,CAC9B,CAAC,SAAS,UAAU,EACpB,GAAG,SAAS,oBAAoB,CAAC,CAAC,CAAC,GAAG,EAAE;IAExC,OAAO,CAAC,EAAE,GAAG,CAAC;IACd;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;IACjC,eAAe,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;CAC3C;AAED;;GAEG;AACH,KAAK,YAAY,CACf,CAAC,SAAS,UAAU,EACpB,GAAG,SAAS,oBAAoB,CAAC,CAAC,CAAC,GAAG,EAAE,IACtC,GAAG,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC;AAE/B;;;GAGG;AACH,KAAK,kCAAkC,CACrC,CAAC,SAAS,UAAU,EACpB,CAAC,SAAS,MAAM,CAAC,IACf;KACD,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,UAAU,GAC7B,oBAAoB,CAAC,CAAC,CAAC,GACvB,CAAC,CAAC,CAAC,CAAC,SAAS,UAAU,EAAE,GACvB,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GACzC,CAAC,CAAC,CAAC,CAAC;CACX,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,CAC7B,CAAC,SAAS,UAAU,EACpB,GAAG,SAAS,oBAAoB,CAAC,CAAC,CAAC,GAAG,EAAE,IACtC,kCAAkC,CACpC,CAAC,EACD,MAAM,oBAAoB,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CACzE,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/operations/FindById/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EACV,oBAAoB,EACpB,cAAc,EACd,0BAA0B,EAC3B,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,oBAAoB,CAAC,CAAC,SAAS,UAAU,IAAI,KAAK,CAAC;IAC7D,WAAW,EAAE,0BAA0B,CAAC,CAAC,CAAC,CAAC;CAC5C,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,WAAW,eAAe,CAC9B,CAAC,SAAS,UAAU,EACpB,GAAG,SAAS,oBAAoB,CAAC,CAAC,CAAC,GAAG,EAAE;IAExC,OAAO,CAAC,EAAE,GAAG,CAAC;IACd;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;IACjC,eAAe,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;CAC3C;AAED;;GAEG;AACH,KAAK,YAAY,CACf,CAAC,SAAS,UAAU,EACpB,GAAG,SAAS,oBAAoB,CAAC,CAAC,CAAC,GAAG,EAAE,IACtC,GAAG,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC;AAE/B;;;GAGG;AACH,KAAK,kCAAkC,CACrC,CAAC,SAAS,UAAU,EACpB,CAAC,SAAS,MAAM,CAAC,IACf;KACD,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,UAAU,GAC7B,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAC1B,CAAC,CAAC,CAAC,CAAC,SAAS,UAAU,EAAE,GACvB,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GACzC,CAAC,CAAC,CAAC,CAAC;CACX,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,CAC7B,CAAC,SAAS,UAAU,EACpB,GAAG,SAAS,oBAAoB,CAAC,CAAC,CAAC,GAAG,EAAE,IACtC,kCAAkC,CACpC,CAAC,EACD,MAAM,oBAAoB,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CACzE,CAAC"}

package/package.json

@@ -1,13 +1,15 @@
 {
   "name": "dyna-record",
-  "version": "0.4.1",
+  "version": "0.4.7",
   "description": "Typescript Data Modeler and ORM for Dynamo",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
     "build": "tsc",
     "watch": "tsc -w",
-    "test": "jest",
+    "typecheck": "tsc --noEmit && tsc -p tsconfig.dev.json --noEmit",
+    "typecheck:tests": "tsc -p tsconfig.dev.json --noEmit",
+    "test": "tsc -p tsconfig.dev.json --noEmit && jest",
     "test:watch": "jest --watch",
     "eslint": "npx eslint . --ext .ts",
     "eslint:fix": "npx eslint . --ext .ts --fix",