dyno-table 0.1.8 → 0.2.0-0

package/dist/entity.cjs

@@ -1,37 +1,101 @@
 'use strict';
 
+// src/conditions.ts
+var createComparisonCondition = (type) => (attr, value) => ({
+  type,
+  attr,
+  value
+});
+var eq = createComparisonCondition("eq");
+
 // src/entity.ts
 function defineEntity(config) {
+  const entityTypeAttributeName = config.settings?.entityTypeAttributeName ?? "entityType";
+  const generateTimestamps = () => {
+    const timestamps = {};
+    if (config.settings?.timestamps) {
+      const now = /* @__PURE__ */ new Date();
+      if (config.settings.timestamps.createdAt) {
+        const attributeName = config.settings.timestamps.createdAt.attributeName ?? "createdAt";
+        timestamps[attributeName] = config.settings.timestamps.createdAt.format === "UNIX" ? Math.floor(Date.now() / 1e3) : now.toISOString();
+      }
+      if (config.settings.timestamps.updatedAt) {
+        const attributeName = config.settings.timestamps.updatedAt.attributeName ?? "updatedAt";
+        timestamps[attributeName] = config.settings.timestamps.updatedAt.format === "UNIX" ? Math.floor(Date.now() / 1e3) : now.toISOString();
+      }
+    }
+    return timestamps;
+  };
   return {
+    name: config.name,
     createRepository: (table) => {
       const repository = {
-        _hooks: config.hooks,
         create: (data) => {
-          const builder = table.create(data);
+          const builder = table.create({
+            ...data,
+            [entityTypeAttributeName]: config.name,
+            ...generateTimestamps()
+          });
           const originalExecute = builder.execute;
           builder.execute = async () => {
             const validationResult = await config.schema["~standard"].validate(data);
             if ("issues" in validationResult && validationResult.issues) {
               throw new Error(`Validation failed: ${validationResult.issues.map((i) => i.message).join(", ")}`);
             }
-            Object.assign(builder, { item: validationResult.value });
-            const result = await originalExecute.call(builder);
-            if (!result) {
-              throw new Error("Failed to create item");
-            }
-            return result;
+            const primaryKey = config.primaryKey.generateKey(validationResult.value);
+            const indexes = Object.entries(config.indexes ?? {}).reduce(
+              (acc, [indexName, index]) => {
+                const key = index.generateKey(validationResult.value);
+                const gsiConfig = table.gsis[indexName];
+                if (!gsiConfig) {
+                  throw new Error(`GSI configuration not found for index: ${indexName}`);
+                }
+                if (key.pk) {
+                  acc[gsiConfig.partitionKey] = key.pk;
+                }
+                if (key.sk && gsiConfig.sortKey) {
+                  acc[gsiConfig.sortKey] = key.sk;
+                }
+                return acc;
+              },
+              {}
+            );
+            Object.assign(builder, {
+              item: {
+                ...validationResult.value,
+                [entityTypeAttributeName]: config.name,
+                [table.partitionKey]: primaryKey.pk,
+                ...table.sortKey ? { [table.sortKey]: primaryKey.sk } : {},
+                ...indexes,
+                ...generateTimestamps()
+              }
+            });
+            return await originalExecute.call(builder);
           };
           return builder;
         },
         upsert: (data) => {
-          const builder = table.put(data);
+          const primaryKey = config.primaryKey.generateKey(data);
+          const builder = table.put({
+            [table.partitionKey]: primaryKey.pk,
+            ...table.sortKey ? { [table.sortKey]: primaryKey.sk } : {},
+            ...data,
+            [entityTypeAttributeName]: config.name,
+            ...generateTimestamps()
+          });
           const originalExecute = builder.execute;
           builder.execute = async () => {
             const validationResult = await config.schema["~standard"].validate(data);
             if ("issues" in validationResult && validationResult.issues) {
               throw new Error(`Validation failed: ${validationResult.issues.map((i) => i.message).join(", ")}`);
             }
-            Object.assign(builder, { item: validationResult.value });
+            Object.assign(builder, {
+              item: {
+                ...validationResult.value,
+                [entityTypeAttributeName]: config.name,
+                ...generateTimestamps()
+              }
+            });
             const result = await originalExecute.call(builder);
             if (!result) {
               throw new Error("Failed to upsert item");
@@ -41,69 +105,77 @@ function defineEntity(config) {
           return builder;
         },
         get: (key) => {
-          const builder = table.get(key);
-          const originalExecute = builder.execute;
-          builder.execute = async () => {
-            const result = await originalExecute.call(builder);
-            const item = result?.item;
-            return {
-              item: config.hooks?.afterGet ? await config.hooks.afterGet(item) : item
-            };
-          };
-          return builder;
+          const primaryKeyObj = config.primaryKey.generateKey(key);
+          return table.get(primaryKeyObj);
         },
         update: (key, data) => {
-          const builder = table.update(key);
-          const originalExecute = builder.execute;
-          builder.execute = async () => {
-            const result = await originalExecute.call(builder);
-            if (!result?.item) {
-              throw new Error("Failed to update item");
-            }
-            return result.item;
-          };
+          const primaryKeyObj = config.primaryKey.generateKey(key);
+          const builder = table.update(primaryKeyObj);
+          builder.condition(eq(entityTypeAttributeName, config.name));
+          const timestamps = {};
+          if (config.settings?.timestamps?.updatedAt) {
+            const now = /* @__PURE__ */ new Date();
+            const attributeName = config.settings.timestamps.updatedAt.attributeName ?? "updatedAt";
+            timestamps[attributeName] = config.settings.timestamps.updatedAt.format === "UNIX" ? Math.floor(Date.now() / 1e3) : now.toISOString();
+          }
+          builder.set({
+            ...data,
+            ...timestamps
+          });
           return builder;
         },
         delete: (key) => {
-          return table.delete(key);
+          const primaryKeyObj = config.primaryKey.generateKey(key);
+          const builder = table.delete(primaryKeyObj);
+          builder.condition(eq(entityTypeAttributeName, config.name));
+          return builder;
         },
-        query: {},
-        // Add a method to create a query builder
-        queryBuilder: (key) => {
-          const primaryKey = {
-            pk: key.pk,
-            ...key.sk ? { sk: (op) => op.eq(key.sk) } : {}
+        query: Object.entries(config.queries || {}).reduce((acc, [key, inputCallback]) => {
+          acc[key] = (input) => {
+            const queryEntity = {
+              scan: repository.scan,
+              get: (key2) => table.get(key2),
+              query: (keyCondition) => {
+                return table.query(keyCondition);
+              }
+            };
+            const queryBuilderCallback = inputCallback(input);
+            const builder = queryBuilderCallback(queryEntity);
+            if (builder && typeof builder === "object" && "filter" in builder && typeof builder.filter === "function") {
+              builder.filter(eq(entityTypeAttributeName, config.name));
+            }
+            if (builder && typeof builder === "object" && "execute" in builder) {
+              const originalExecute = builder.execute;
+              builder.execute = async () => {
+                const queryFn = config.queries[key];
+                if (queryFn && typeof queryFn === "function") {
+                  const schema = queryFn.schema;
+                  if (schema?.["~standard"]?.validate && typeof schema["~standard"].validate === "function") {
+                    const validationResult = schema["~standard"].validate(input);
+                    if ("issues" in validationResult && validationResult.issues) {
+                      throw new Error(
+                        `Validation failed: ${validationResult.issues.map((issue) => issue.message).join(", ")}`
+                      );
+                    }
+                  }
+                }
+                const result = await originalExecute.call(builder);
+                if (!result) {
+                  throw new Error("Failed to execute query");
+                }
+                return result;
+              };
+            }
+            return builder;
           };
-          return table.query(primaryKey);
-        },
-        // Implement findBy method to find entities by their attributes
-        findBy: (attribute, value, options) => {
-          const scanBuilder = table.scan().filter((op) => op.eq(attribute, value));
-          if (options?.limit) {
-            scanBuilder.limit(options.limit);
-          }
-          if (options?.lastEvaluatedKey) {
-            scanBuilder.startFrom(options.lastEvaluatedKey);
-          }
-          return scanBuilder;
-        },
-        // Implement scan method to scan all entities
-        scan: (options) => {
+          return acc;
+        }, {}),
+        scan: () => {
           const scanBuilder = table.scan();
-          if (options?.limit) {
-            scanBuilder.limit(options.limit);
-          }
-          if (options?.lastEvaluatedKey) {
-            scanBuilder.startFrom(options.lastEvaluatedKey);
-          }
+          scanBuilder.filter(eq(entityTypeAttributeName, config.name));
           return scanBuilder;
         }
       };
-      if (config.queries) {
-        for (const [key, queryFn] of Object.entries(config.queries)) {
-          repository.query[key] = queryFn.bind(repository);
-        }
-      }
       return repository;
     }
   };
@@ -111,28 +183,13 @@ function defineEntity(config) {
 function createQueries() {
   return {
     input: (schema) => ({
-      // biome-ignore lint/complexity/noBannedTypes: <explanation>
       query: (handler) => {
-        const queryFn = async function(input) {
-          const validationResult = await schema["~standard"].validate(input);
-          if ("issues" in validationResult && validationResult.issues) {
-            throw new Error(`Validation failed: ${validationResult.issues.map((i) => i.message).join(", ")}`);
-          }
-          const queryBuilder = handler({ input: validationResult.value, entity: this });
-          const result = await queryBuilder.execute();
-          let items = result.items;
-          if (this._hooks?.afterGet) {
-            const processedItems = await Promise.all(
-              // biome-ignore lint/style/noNonNullAssertion: The method will exit as it's confirmed above
-              items.map(async (item) => await this._hooks.afterGet(item))
-            );
-            items = processedItems.filter((item) => item !== null);
-          }
-          return {
-            items,
-            lastEvaluatedKey: result.lastEvaluatedKey
+        const queryFn = (input) => {
+          return (entity) => {
+            return handler({ input, entity });
           };
         };
+        queryFn.schema = schema;
         return queryFn;
       }
     })
@@ -140,22 +197,24 @@ function createQueries() {
 }
 function createIndex() {
   return {
-    partitionKey: (pkFn) => ({
-      sortKey: (skFn) => ({
-        name: "custom",
-        partitionKey: "pk",
-        sortKey: "sk",
-        generateKey: (item) => ({
-          pk: pkFn(item),
-          sk: skFn(item)
-        })
-      }),
-      // Allow creating an index with only a partition key
-      withoutSortKey: () => ({
-        name: "custom",
-        partitionKey: "pk",
-        generateKey: (item) => ({
-          pk: pkFn(item)
+    input: (schema) => ({
+      partitionKey: (pkFn) => ({
+        sortKey: (skFn) => ({
+          name: "custom",
+          partitionKey: "pk",
+          sortKey: "sk",
+          generateKey: (item) => ({
+            pk: pkFn(item),
+            sk: skFn(item)
+          })
+        }),
+        // Allow creating an index with only a partition key
+        withoutSortKey: () => ({
+          name: "custom",
+          partitionKey: "pk",
+          generateKey: (item) => ({
+            pk: pkFn(item)
+          })
         })
       })
     })

package/dist/entity.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/entity.ts"],"names":[],"mappings":"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","file":"entity.cjs","sourcesContent":["import type { Table } from \"./table\";\nimport type { StandardSchemaV1 } from \"./standard-schema\";\nimport type { PrimaryKeyWithoutExpression } from \"./conditions\";\nimport type { Index } from \"./types\";\nimport type { QueryBuilder } from \"./builders/query-builder\";\nimport type { Path, PathType } from \"./builders/types\";\nimport type { KeyConditionOperator } from \"./conditions\";\nimport type { ScanBuilder } from \"./builders/scan-builder\";\nimport type { DeleteBuilder } from \"./builders/delete-builder\";\nimport type { UpdateBuilder } from \"./builders/update-builder\";\nimport type { GetBuilder } from \"./builders/get-builder\";\nimport type { PutBuilder } from \"./builders/put-builder\";\n\nexport interface EntityHooks<T extends Record<string, unknown>> {\n  beforeCreate?: (data: T) => Promise<T> | T;\n  afterCreate?: (data: T) => Promise<T> | T;\n  beforeUpdate?: (data: Partial<T>) => Promise<Partial<T>> | Partial<T>;\n  afterUpdate?: (data: T) => Promise<T> | T;\n  afterGet?: (data: T | undefined) => Promise<T | undefined> | T | undefined;\n}\n\n// Define a type for query functions\nexport type QueryFunction<T extends Record<string, unknown>, I, R = T[]> = (input: I) => R;\n\n// Define a type for the query record\nexport type QueryRecord<T extends Record<string, unknown>> = Record<string, QueryBuilder<T>>;\n\n// Define a type for the result of a query builder\nexport type QueryBuilderResult<T extends Record<string, unknown>> = {\n  items: T[];\n  lastEvaluatedKey?: Record<string, unknown>;\n};\n\nexport interface EntityConfig<T extends Record<string, unknown>, Q extends QueryRecord<T> = {}> {\n  name: string;\n  schema: StandardSchemaV1<T>;\n  primaryKey: Index;\n  indexes?: Record<string, Index>;\n  queries?: Q;\n  hooks?: EntityHooks<T>;\n}\n\nexport interface PaginationOptions {\n  limit?: number;\n  lastEvaluatedKey?: Record<string, any>;\n}\n\nexport interface PaginatedResult<T> {\n  items: T[];\n  lastEvaluatedKey?: Record<string, any>;\n  hasMore: boolean;\n}\n\nexport interface EntityRepository<T extends Record<string, unknown>, Q extends QueryRecord<T> = {}> {\n  _hooks?: EntityHooks<T>;\n  create: (data: T) => PutBuilder<T>;\n  upsert: (data: T) => PutBuilder<T>;\n  get: (key: PrimaryKeyWithoutExpression) => GetBuilder<T>;\n  update: (key: PrimaryKeyWithoutExpression, data: Partial<T>) => UpdateBuilder<T>;\n  delete: (key: PrimaryKeyWithoutExpression) => DeleteBuilder;\n  query: Q;\n  // Add a method to create a query builder\n  queryBuilder: (key: PrimaryKeyWithoutExpression) => QueryBuilder<T, any>;\n  // Add a method to find entities by their attributes\n  findBy: <K extends keyof T>(attribute: K, value: T[K], options?: PaginationOptions) => any; // Returns ScanBuilder<T>\n  // Add a method to scan all entities\n  scan: (options?: PaginationOptions) => ScanBuilder<T>;\n}\n\nexport function defineEntity<T extends Record<string, unknown>, Q extends QueryRecord<T> = {}>(\n  config: EntityConfig<T, Q>,\n) {\n  return {\n    createRepository: (table: Table): EntityRepository<T, Q> => {\n      // Create a repository with hooks attached\n      const repository = {\n        _hooks: config.hooks,\n        create: (data: T) => {\n          // We need to handle the async operations when the consumer calls execute\n          const builder = table.create(data);\n\n          // Wrap the builder's execute method to apply validation only (no hooks)\n          const originalExecute = builder.execute;\n          builder.execute = async () => {\n            // Validate data against schema\n            const validationResult = await config.schema[\"~standard\"].validate(data);\n            if (\"issues\" in validationResult && validationResult.issues) {\n              throw new Error(`Validation failed: ${validationResult.issues.map((i) => i.message).join(\", \")}`);\n            }\n\n            // Update the item in the builder with the validated data\n            Object.assign(builder, { item: validationResult.value });\n\n            // Execute the builder\n            const result = await originalExecute.call(builder);\n            if (!result) {\n              throw new Error(\"Failed to create item\");\n            }\n\n            return result;\n          };\n\n          return builder;\n        },\n\n        upsert: (data: T) => {\n          // We need to handle the async operations when the consumer calls execute\n          const builder = table.put(data);\n\n          // Wrap the builder's execute method to apply validation only (no hooks)\n          const originalExecute = builder.execute;\n          builder.execute = async () => {\n            // Validate data against schema\n            const validationResult = await config.schema[\"~standard\"].validate(data);\n            if (\"issues\" in validationResult && validationResult.issues) {\n              throw new Error(`Validation failed: ${validationResult.issues.map((i) => i.message).join(\", \")}`);\n            }\n\n            // Update the item in the builder with the validated data\n            Object.assign(builder, { item: validationResult.value });\n\n            // Execute the builder\n            const result = await originalExecute.call(builder);\n            if (!result) {\n              throw new Error(\"Failed to upsert item\");\n            }\n\n            return result;\n          };\n\n          return builder;\n        },\n\n        get: (key: PrimaryKeyWithoutExpression) => {\n          const builder = table.get<T>(key);\n\n          // Wrap the builder's execute method to apply afterGet hook\n          const originalExecute = builder.execute;\n\n          builder.execute = async () => {\n            const result = await originalExecute.call(builder);\n            const item = result?.item;\n\n            // Apply afterGet hook if exists\n            return {\n              item: config.hooks?.afterGet ? await config.hooks.afterGet(item as T) : item,\n            };\n          };\n\n          return builder;\n        },\n\n        update: (key: PrimaryKeyWithoutExpression, data: Partial<T>) => {\n          // Create a builder without hooks\n          const builder = table.update<T>(key);\n\n          // Wrap the builder's execute method to handle errors\n          const originalExecute = builder.execute;\n          builder.execute = async () => {\n            const result = await originalExecute.call(builder);\n            if (!result?.item) {\n              throw new Error(\"Failed to update item\");\n            }\n\n            // Return the item without applying hooks\n            return result.item as T;\n          };\n\n          return builder;\n        },\n\n        delete: (key: PrimaryKeyWithoutExpression) => {\n          return table.delete(key);\n        },\n\n        query: {} as Q,\n\n        // Add a method to create a query builder\n        queryBuilder: (key: PrimaryKeyWithoutExpression) => {\n          // Convert PrimaryKeyWithoutExpression to PrimaryKey\n          const primaryKey = {\n            pk: key.pk,\n            ...(key.sk ? { sk: (op: KeyConditionOperator) => op.eq(key.sk as string) } : {}),\n          };\n          return table.query<T>(primaryKey);\n        },\n\n        // Implement findBy method to find entities by their attributes\n        findBy: <K extends keyof T>(attribute: K, value: T[K], options?: PaginationOptions) => {\n          // Use scan with a filter to find entities by attribute\n          const scanBuilder = table.scan<T>().filter((op) => op.eq(attribute as string as Path<T>, value as any));\n\n          // Apply pagination options if provided\n          if (options?.limit) {\n            scanBuilder.limit(options.limit);\n          }\n\n          if (options?.lastEvaluatedKey) {\n            scanBuilder.startFrom(options.lastEvaluatedKey);\n          }\n\n          // Return the builder without applying hooks\n          return scanBuilder;\n        },\n\n        // Implement scan method to scan all entities\n        scan: (options?: PaginationOptions) => {\n          // Create a scan builder\n          const scanBuilder = table.scan<T>();\n\n          // Apply pagination options if provided\n          if (options?.limit) {\n            scanBuilder.limit(options.limit);\n          }\n\n          if (options?.lastEvaluatedKey) {\n            scanBuilder.startFrom(options.lastEvaluatedKey);\n          }\n\n          // Return the builder without applying hooks\n          return scanBuilder;\n        },\n      };\n\n      // Bind query functions to the repository after it's fully defined\n      if (config.queries) {\n        for (const [key, queryFn] of Object.entries(config.queries)) {\n          // biome-ignore lint/suspicious/noExplicitAny: Let the magic happen\n          (repository.query as any)[key] = queryFn.bind(repository);\n        }\n      }\n\n      return repository;\n    },\n  };\n}\n\nexport function createQueries<T extends Record<string, unknown>>() {\n  return {\n    input: <I, R = QueryBuilderResult<T>>(schema: StandardSchemaV1<I>) => ({\n      // biome-ignore lint/complexity/noBannedTypes: <explanation>\n      query: <Q extends QueryRecord<T> = {}>(\n        // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n        handler: (params: { input: I; entity: EntityRepository<T, Q> }) => QueryBuilder<T, any>,\n      ): QueryFunction<T, I, R> => {\n        // Return a function that will be bound to the repository when it's created\n        const queryFn = async function (this: EntityRepository<T, Q>, input: I): Promise<R> {\n          // Validate input against schema\n          const validationResult = await schema[\"~standard\"].validate(input);\n          if (\"issues\" in validationResult && validationResult.issues) {\n            throw new Error(`Validation failed: ${validationResult.issues.map((i) => i.message).join(\", \")}`);\n          }\n\n          // Use 'this' as the entity repository (will be bound when the repository is created)\n          const queryBuilder = handler({ input: validationResult.value, entity: this });\n\n          // Execute the query\n          const result = await queryBuilder.execute();\n\n          // Apply afterGet hook to each item if exists\n          let items = result.items;\n          if (this._hooks?.afterGet) {\n            const processedItems = await Promise.all(\n              // biome-ignore lint/style/noNonNullAssertion: The method will exit as it's confirmed above\n              items.map(async (item) => await this._hooks!.afterGet!(item as T)),\n            );\n            items = processedItems.filter((item): item is NonNullable<typeof item> => item !== null) as T[];\n          }\n\n          // Return the full result with processed items\n          return {\n            items,\n            lastEvaluatedKey: result.lastEvaluatedKey,\n          } as unknown as R;\n        };\n\n        return queryFn as unknown as QueryFunction<T, I, R>;\n      },\n    }),\n  };\n}\n\nexport interface IndexDefinition<T extends Record<string, unknown>> extends Index {\n  name: string;\n  generateKey: (item: T) => { pk: string; sk?: string };\n}\n\nexport function createIndex<T extends Record<string, unknown>>() {\n  return {\n    partitionKey: <P extends (item: T) => string>(pkFn: P) => ({\n      sortKey: <S extends (item: T) => string>(skFn: S) =>\n        ({\n          name: \"custom\",\n          partitionKey: \"pk\",\n          sortKey: \"sk\",\n          generateKey: (item: T) => ({\n            pk: pkFn(item),\n            sk: skFn(item),\n          }),\n        }) as IndexDefinition<T>,\n\n      // Allow creating an index with only a partition key\n      withoutSortKey: () =>\n        ({\n          name: \"custom\",\n          partitionKey: \"pk\",\n          generateKey: (item: T) => ({\n            pk: pkFn(item),\n          }),\n        }) as IndexDefinition<T>,\n    }),\n  };\n}\n"]}
+{"version":3,"sources":["../src/conditions.ts","../src/entity.ts"],"names":["key"],"mappings":";;;AA+FO,IAAM,yBACX,GAAA,CAAC,IACD,KAAA,CAAC,MAAc,KAA+B,MAAA;AAAA,EAC5C,IAAA;AAAA,EACA,IAAA;AAAA,EACA;AACF,CAAA,CAAA;AAQK,IAAM,EAAA,GAAK,0BAA0B,IAAI,CAAA;;;ACwBzC,SAAS,aACd,MACA,EAAA;AACA,EAAM,MAAA,uBAAA,GAA0B,MAAO,CAAA,QAAA,EAAU,uBAA2B,IAAA,YAAA;AAkB5E,EAAA,MAAM,qBAAqB,MAAuC;AAChE,IAAA,MAAM,aAA8C,EAAC;AAErD,IAAI,IAAA,MAAA,CAAO,UAAU,UAAY,EAAA;AAC/B,MAAM,MAAA,GAAA,uBAAU,IAAK,EAAA;AAErB,MAAI,IAAA,MAAA,CAAO,QAAS,CAAA,UAAA,CAAW,SAAW,EAAA;AACxC,QAAA,MAAM,aAAgB,GAAA,MAAA,CAAO,QAAS,CAAA,UAAA,CAAW,UAAU,aAAiB,IAAA,WAAA;AAC5E,QAAA,UAAA,CAAW,aAAa,CACtB,GAAA,MAAA,CAAO,QAAS,CAAA,UAAA,CAAW,UAAU,MAAW,KAAA,MAAA,GAAS,IAAK,CAAA,KAAA,CAAM,KAAK,GAAI,EAAA,GAAI,GAAI,CAAA,GAAI,IAAI,WAAY,EAAA;AAAA;AAG7G,MAAI,IAAA,MAAA,CAAO,QAAS,CAAA,UAAA,CAAW,SAAW,EAAA;AACxC,QAAA,MAAM,aAAgB,GAAA,MAAA,CAAO,QAAS,CAAA,UAAA,CAAW,UAAU,aAAiB,IAAA,WAAA;AAC5E,QAAA,UAAA,CAAW,aAAa,CACtB,GAAA,MAAA,CAAO,QAAS,CAAA,UAAA,CAAW,UAAU,MAAW,KAAA,MAAA,GAAS,IAAK,CAAA,KAAA,CAAM,KAAK,GAAI,EAAA,GAAI,GAAI,CAAA,GAAI,IAAI,WAAY,EAAA;AAAA;AAC7G;AAGF,IAAO,OAAA,UAAA;AAAA,GACT;AAEA,EAAO,OAAA;AAAA,IACL,MAAM,MAAO,CAAA,IAAA;AAAA,IACb,gBAAA,EAAkB,CAAC,KAA4C,KAAA;AAE7D,MAAA,MAAM,UAAa,GAAA;AAAA,QACjB,MAAA,EAAQ,CAAC,IAAY,KAAA;AAEnB,UAAM,MAAA,OAAA,GAAU,MAAM,MAAU,CAAA;AAAA,YAC9B,GAAG,IAAA;AAAA,YACH,CAAC,uBAAuB,GAAG,MAAO,CAAA,IAAA;AAAA,YAClC,GAAG,kBAAmB;AAAA,WACvB,CAAA;AAGD,UAAA,MAAM,kBAAkB,OAAQ,CAAA,OAAA;AAChC,UAAA,OAAA,CAAQ,UAAU,YAAY;AAE5B,YAAA,MAAM,mBAAmB,MAAM,MAAA,CAAO,OAAO,WAAW,CAAA,CAAE,SAAS,IAAI,CAAA;AACvE,YAAI,IAAA,QAAA,IAAY,gBAAoB,IAAA,gBAAA,CAAiB,MAAQ,EAAA;AAC3D,cAAA,MAAM,IAAI,KAAA,CAAM,CAAsB,mBAAA,EAAA,gBAAA,CAAiB,OAAO,GAAI,CAAA,CAAC,CAAM,KAAA,CAAA,CAAE,OAAO,CAAA,CAAE,IAAK,CAAA,IAAI,CAAC,CAAE,CAAA,CAAA;AAAA;AAGlG,YAAA,MAAM,UAAa,GAAA,MAAA,CAAO,UAAW,CAAA,WAAA,CAAY,iBAAiB,KAAqB,CAAA;AAEvF,YAAA,MAAM,UAAU,MAAO,CAAA,OAAA,CAAQ,OAAO,OAAW,IAAA,EAAE,CAAE,CAAA,MAAA;AAAA,cACnD,CAAC,GAAA,EAAK,CAAC,SAAA,EAAW,KAAK,CAAM,KAAA;AAC3B,gBAAA,MAAM,GAAO,GAAA,KAAA,CAA6B,WAAY,CAAA,gBAAA,CAAiB,KAAK,CAAA;AAC5E,gBAAM,MAAA,SAAA,GAAY,KAAM,CAAA,IAAA,CAAK,SAAS,CAAA;AAEtC,gBAAA,IAAI,CAAC,SAAW,EAAA;AACd,kBAAA,MAAM,IAAI,KAAA,CAAM,CAA0C,uCAAA,EAAA,SAAS,CAAE,CAAA,CAAA;AAAA;AAGvE,gBAAA,IAAI,IAAI,EAAI,EAAA;AACV,kBAAI,GAAA,CAAA,SAAA,CAAU,YAAY,CAAA,GAAI,GAAI,CAAA,EAAA;AAAA;AAEpC,gBAAI,IAAA,GAAA,CAAI,EAAM,IAAA,SAAA,CAAU,OAAS,EAAA;AAC/B,kBAAI,GAAA,CAAA,SAAA,CAAU,OAAO,CAAA,GAAI,GAAI,CAAA,EAAA;AAAA;AAE/B,gBAAO,OAAA,GAAA;AAAA,eACT;AAAA,cACA;AAAC,aACH;AAGA,YAAA,MAAA,CAAO,OAAO,OAAS,EAAA;AAAA,cACrB,IAAM,EAAA;AAAA,gBACJ,GAAG,gBAAiB,CAAA,KAAA;AAAA,gBACpB,CAAC,uBAAuB,GAAG,MAAO,CAAA,IAAA;AAAA,gBAClC,CAAC,KAAA,CAAM,YAAY,GAAG,UAAW,CAAA,EAAA;AAAA,gBACjC,GAAI,KAAM,CAAA,OAAA,GAAU,EAAE,CAAC,KAAM,CAAA,OAAO,GAAG,UAAA,CAAW,EAAG,EAAA,GAAI,EAAC;AAAA,gBAC1D,GAAG,OAAA;AAAA,gBACH,GAAG,kBAAmB;AAAA;AACxB,aACD,CAAA;AAGD,YAAO,OAAA,MAAM,eAAgB,CAAA,IAAA,CAAK,OAAO,CAAA;AAAA,WAC3C;AAEA,UAAO,OAAA,OAAA;AAAA,SACT;AAAA,QAEA,MAAA,EAAQ,CAAC,IAAgB,KAAA;AACvB,UAAA,MAAM,UAAa,GAAA,MAAA,CAAO,UAAW,CAAA,WAAA,CAAY,IAAI,CAAA;AAGrD,UAAM,MAAA,OAAA,GAAU,MAAM,GAAO,CAAA;AAAA,YAC3B,CAAC,KAAA,CAAM,YAAY,GAAG,UAAW,CAAA,EAAA;AAAA,YACjC,GAAI,KAAM,CAAA,OAAA,GAAU,EAAE,CAAC,KAAM,CAAA,OAAO,GAAG,UAAA,CAAW,EAAG,EAAA,GAAI,EAAC;AAAA,YAC1D,GAAG,IAAA;AAAA,YACH,CAAC,uBAAuB,GAAG,MAAO,CAAA,IAAA;AAAA,YAClC,GAAG,kBAAmB;AAAA,WACvB,CAAA;AAGD,UAAA,MAAM,kBAAkB,OAAQ,CAAA,OAAA;AAChC,UAAA,OAAA,CAAQ,UAAU,YAAY;AAE5B,YAAA,MAAM,mBAAmB,MAAM,MAAA,CAAO,OAAO,WAAW,CAAA,CAAE,SAAS,IAAI,CAAA;AACvE,YAAI,IAAA,QAAA,IAAY,gBAAoB,IAAA,gBAAA,CAAiB,MAAQ,EAAA;AAC3D,cAAA,MAAM,IAAI,KAAA,CAAM,CAAsB,mBAAA,EAAA,gBAAA,CAAiB,OAAO,GAAI,CAAA,CAAC,CAAM,KAAA,CAAA,CAAE,OAAO,CAAA,CAAE,IAAK,CAAA,IAAI,CAAC,CAAE,CAAA,CAAA;AAAA;AAIlG,YAAA,MAAA,CAAO,OAAO,OAAS,EAAA;AAAA,cACrB,IAAM,EAAA;AAAA,gBACJ,GAAG,gBAAiB,CAAA,KAAA;AAAA,gBACpB,CAAC,uBAAuB,GAAG,MAAO,CAAA,IAAA;AAAA,gBAClC,GAAG,kBAAmB;AAAA;AACxB,aACD,CAAA;AAGD,YAAA,MAAM,MAAS,GAAA,MAAM,eAAgB,CAAA,IAAA,CAAK,OAAO,CAAA;AACjD,YAAA,IAAI,CAAC,MAAQ,EAAA;AACX,cAAM,MAAA,IAAI,MAAM,uBAAuB,CAAA;AAAA;AAGzC,YAAO,OAAA,MAAA;AAAA,WACT;AAEA,UAAO,OAAA,OAAA;AAAA,SACT;AAAA,QAEA,GAAA,EAAK,CAAc,GAAW,KAAA;AAE5B,UAAA,MAAM,aAAgB,GAAA,MAAA,CAAO,UAAW,CAAA,WAAA,CAAY,GAAG,CAAA;AACvD,UAAO,OAAA,KAAA,CAAM,IAAO,aAAa,CAAA;AAAA,SACnC;AAAA,QAEA,MAAA,EAAQ,CAAc,GAAA,EAAQ,IAAqB,KAAA;AAEjD,UAAA,MAAM,aAAgB,GAAA,MAAA,CAAO,UAAW,CAAA,WAAA,CAAY,GAAG,CAAA;AACvD,UAAM,MAAA,OAAA,GAAU,KAAM,CAAA,MAAA,CAAU,aAAa,CAAA;AAC7C,UAAA,OAAA,CAAQ,SAAU,CAAA,EAAA,CAAG,uBAAyB,EAAA,MAAA,CAAO,IAAI,CAAC,CAAA;AAG1D,UAAA,MAAM,aAA8C,EAAC;AACrD,UAAI,IAAA,MAAA,CAAO,QAAU,EAAA,UAAA,EAAY,SAAW,EAAA;AAC1C,YAAM,MAAA,GAAA,uBAAU,IAAK,EAAA;AACrB,YAAA,MAAM,aAAgB,GAAA,MAAA,CAAO,QAAS,CAAA,UAAA,CAAW,UAAU,aAAiB,IAAA,WAAA;AAC5E,YAAA,UAAA,CAAW,aAAa,CACtB,GAAA,MAAA,CAAO,QAAS,CAAA,UAAA,CAAW,UAAU,MAAW,KAAA,MAAA,GAC5C,IAAK,CAAA,KAAA,CAAM,KAAK,GAAI,EAAA,GAAI,GAAI,CAAA,GAC5B,IAAI,WAAY,EAAA;AAAA;AAIxB,UAAA,OAAA,CAAQ,GAAI,CAAA;AAAA,YACV,GAAG,IAAA;AAAA,YACH,GAAG;AAAA,WACJ,CAAA;AAED,UAAO,OAAA,OAAA;AAAA,SACT;AAAA,QAEA,MAAA,EAAQ,CAAc,GAAW,KAAA;AAE/B,UAAA,MAAM,aAAgB,GAAA,MAAA,CAAO,UAAW,CAAA,WAAA,CAAY,GAAG,CAAA;AACvD,UAAM,MAAA,OAAA,GAAU,KAAM,CAAA,MAAA,CAAO,aAAa,CAAA;AAC1C,UAAA,OAAA,CAAQ,SAAU,CAAA,EAAA,CAAG,uBAAyB,EAAA,MAAA,CAAO,IAAI,CAAC,CAAA;AAC1D,UAAO,OAAA,OAAA;AAAA,SACT;AAAA,QAEA,KAAO,EAAA,MAAA,CAAO,OAAQ,CAAA,MAAA,CAAO,WAAW,EAAE,CAAE,CAAA,MAAA,CAAO,CAAC,GAAA,EAAK,CAAC,GAAA,EAAK,aAAa,CAAM,KAAA;AAEhF,UAAI,GAAA,CAAA,GAAG,CAAI,GAAA,CAAC,KAAmB,KAAA;AAE7B,YAAA,MAAM,WAA8B,GAAA;AAAA,cAClC,MAAM,UAAW,CAAA,IAAA;AAAA,cACjB,GAAK,EAAA,CAACA,IAAqC,KAAA,KAAA,CAAM,IAAOA,IAAG,CAAA;AAAA,cAC3D,KAAA,EAAO,CAAC,YAA6B,KAAA;AACnC,gBAAO,OAAA,KAAA,CAAM,MAAS,YAAY,CAAA;AAAA;AACpC,aACF;AAGA,YAAM,MAAA,oBAAA,GAAuB,cAAc,KAAK,CAAA;AAKhD,YAAM,MAAA,OAAA,GAAU,qBAAqB,WAAW,CAAA;AAGhD,YAAI,IAAA,OAAA,IAAW,OAAO,OAAY,KAAA,QAAA,IAAY,YAAY,OAAW,IAAA,OAAO,OAAQ,CAAA,MAAA,KAAW,UAAY,EAAA;AACzG,cAAA,OAAA,CAAQ,MAAO,CAAA,EAAA,CAAG,uBAAyB,EAAA,MAAA,CAAO,IAAI,CAAC,CAAA;AAAA;AAIzD,YAAA,IAAI,OAAW,IAAA,OAAO,OAAY,KAAA,QAAA,IAAY,aAAa,OAAS,EAAA;AAClE,cAAA,MAAM,kBAAkB,OAAQ,CAAA,OAAA;AAChC,cAAA,OAAA,CAAQ,UAAU,YAAY;AAE5B,gBAAM,MAAA,OAAA,GACJ,MAAO,CAAA,OAAA,CACP,GAAG,CAAA;AAEL,gBAAI,IAAA,OAAA,IAAW,OAAO,OAAA,KAAY,UAAY,EAAA;AAE5C,kBAAA,MAAM,SAAS,OAAQ,CAAA,MAAA;AACvB,kBAAI,IAAA,MAAA,GAAS,WAAW,CAAG,EAAA,QAAA,IAAY,OAAO,MAAO,CAAA,WAAW,CAAE,CAAA,QAAA,KAAa,UAAY,EAAA;AACzF,oBAAA,MAAM,gBAAmB,GAAA,MAAA,CAAO,WAAW,CAAA,CAAE,SAAS,KAAK,CAAA;AAC3D,oBAAI,IAAA,QAAA,IAAY,gBAAoB,IAAA,gBAAA,CAAiB,MAAQ,EAAA;AAC3D,sBAAA,MAAM,IAAI,KAAA;AAAA,wBACR,CAAA,mBAAA,EAAsB,gBAAiB,CAAA,MAAA,CAAO,GAAI,CAAA,CAAC,KAAU,KAAA,KAAA,CAAM,OAAO,CAAA,CAAE,IAAK,CAAA,IAAI,CAAC,CAAA;AAAA,uBACxF;AAAA;AACF;AACF;AAIF,gBAAA,MAAM,MAAS,GAAA,MAAM,eAAgB,CAAA,IAAA,CAAK,OAAO,CAAA;AACjD,gBAAA,IAAI,CAAC,MAAQ,EAAA;AACX,kBAAM,MAAA,IAAI,MAAM,yBAAyB,CAAA;AAAA;AAE3C,gBAAO,OAAA,MAAA;AAAA,eACT;AAAA;AAGF,YAAO,OAAA,OAAA;AAAA,WACT;AACA,UAAO,OAAA,GAAA;AAAA,SACT,EAAG,EAAO,CAAA;AAAA,QAEV,MAAM,MAAM;AACV,UAAM,MAAA,WAAA,GAAc,MAAM,IAAQ,EAAA;AAClC,UAAA,WAAA,CAAY,MAAO,CAAA,EAAA,CAAG,uBAAyB,EAAA,MAAA,CAAO,IAAI,CAAC,CAAA;AAE3D,UAAO,OAAA,WAAA;AAAA;AACT,OACF;AAEA,MAAO,OAAA,UAAA;AAAA;AACT,GACF;AACF;AAEO,SAAS,aAAsC,GAAA;AACpD,EAAO,OAAA;AAAA,IACL,KAAA,EAAO,CAAI,MAAiC,MAAA;AAAA,MAC1C,KAAA,EAAO,CAIL,OACG,KAAA;AAEH,QAAM,MAAA,OAAA,GAAU,CAAC,KAAa,KAAA;AAE5B,UAAA,OAAO,CAAC,MAA2B,KAAA;AACjC,YAAA,OAAO,OAAQ,CAAA,EAAE,KAAO,EAAA,MAAA,EAAQ,CAAA;AAAA,WAClC;AAAA,SACF;AAGA,QAAA,OAAA,CAAQ,MAAS,GAAA,MAAA;AAGjB,QAAO,OAAA,OAAA;AAAA;AACT,KACF;AAAA,GACF;AACF;AAOO,SAAS,WAAc,GAAA;AAC5B,EAAO,OAAA;AAAA,IACL,KAAA,EAAO,CAAuB,MAAiC,MAAA;AAAA,MAC7D,YAAA,EAAc,CAAgC,IAAa,MAAA;AAAA,QACzD,OAAA,EAAS,CAAgC,IACtC,MAAA;AAAA,UACC,IAAM,EAAA,QAAA;AAAA,UACN,YAAc,EAAA,IAAA;AAAA,UACd,OAAS,EAAA,IAAA;AAAA,UACT,WAAA,EAAa,CAAC,IAAa,MAAA;AAAA,YACzB,EAAA,EAAI,KAAK,IAAI,CAAA;AAAA,YACb,EAAA,EAAI,KAAK,IAAI;AAAA,WACf;AAAA,SACF,CAAA;AAAA;AAAA,QAGF,gBAAgB,OACb;AAAA,UACC,IAAM,EAAA,QAAA;AAAA,UACN,YAAc,EAAA,IAAA;AAAA,UACd,WAAA,EAAa,CAAC,IAAa,MAAA;AAAA,YACzB,EAAA,EAAI,KAAK,IAAI;AAAA,WACf;AAAA,SACF;AAAA,OACJ;AAAA,KACF;AAAA,GACF;AACF","file":"entity.cjs","sourcesContent":["import type { Path, PathType } from \"./builders/types\";\nimport type { DynamoItem } from \"./types\";\n\n/**\n * Supported comparison operators for DynamoDB conditions.\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html AWS DynamoDB - Comparison Operator Reference}\n *\n * - eq: Equals (=)\n * - ne: Not equals (≠ / <>)\n * - lt: Less than (<)\n * - lte: Less than or equal to (≤)\n * - gt: Greater than (>)\n * - gte: Greater than or equal to (≥)\n * - between: Between two values (inclusive)\n * - beginsWith: Checks if string attribute begins with specified substring\n * - contains: Checks if string/set attribute contains specified value\n * - attributeExists: Checks if attribute exists\n * - attributeNotExists: Checks if attribute does not exist\n */\nexport type ComparisonOperator =\n  | \"eq\"\n  | \"ne\"\n  | \"lt\"\n  | \"lte\"\n  | \"gt\"\n  | \"gte\"\n  | \"between\"\n  | \"beginsWith\"\n  | \"contains\"\n  | \"attributeExists\"\n  | \"attributeNotExists\";\n\n/**\n * Logical operators for combining multiple conditions.\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Logical AWS DynamoDB - Logical Operator Reference}\n *\n * - and: Evaluates to true if all conditions are true\n * - or: Evaluates to true if any condition is true\n * - not: Negate the result of a condition\n */\nexport type LogicalOperator = \"and\" | \"or\" | \"not\";\n\n/**\n * Represents a DynamoDB condition expression.\n * Can be either a comparison condition or a logical combination of conditions.\n *\n * @example\n * // Simple comparison condition\n * const condition: Condition = {\n *   type: \"eq\",\n *   attr: \"status\",\n *   value: \"ACTIVE\"\n * };\n *\n * @example\n * // Logical combination of conditions\n * const condition: Condition = {\n *   type: \"and\",\n *   conditions: [\n *     { type: \"eq\", attr: \"status\", value: \"ACTIVE\" },\n *     { type: \"gt\", attr: \"age\", value: 5 }\n *   ]\n * };\n */\nexport interface Condition {\n  /** The type of condition (comparison or logical operator) */\n  type: ComparisonOperator | LogicalOperator;\n  /** The attribute name for comparison conditions */\n  attr?: string;\n  /** The value to compare against for comparison conditions */\n  value?: unknown;\n  /** Array of conditions for logical operators (and/or) */\n  conditions?: Condition[];\n  /** Single condition for the 'not' operator */\n  condition?: Condition;\n}\n\n/**\n * Parameters used to build DynamoDB expression strings.\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.ExpressionAttributeNames.html Expression Attribute Names}\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.ExpressionAttributeValues.html Expression Attribute Values}\n */\nexport interface ExpressionParams {\n  /** Map of attribute name placeholders to actual attribute names */\n  expressionAttributeNames: Record<string, string>;\n  /** Map of value placeholders to actual values */\n  expressionAttributeValues: DynamoItem;\n  /** Counter for generating unique value placeholders */\n  valueCounter: { count: number };\n}\n\n/**\n * Creates a comparison condition builder function for the specified operator.\n * @internal\n */\nexport const createComparisonCondition =\n  (type: ComparisonOperator) =>\n  (attr: string, value: unknown): Condition => ({\n    type,\n    attr,\n    value,\n  });\n\n/**\n * Creates an equals (=) condition\n * @example\n * eq(\"status\", \"ACTIVE\") // status = \"ACTIVE\"\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html}\n */\nexport const eq = createComparisonCondition(\"eq\");\n\n/**\n * Creates a not equals (≠) condition\n * @example\n * ne(\"status\", \"DELETED\") // status <> \"DELETED\"\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html}\n */\nexport const ne = createComparisonCondition(\"ne\");\n\n/**\n * Creates a less than (<) condition\n * @example\n * lt(\"age\", 18) // age < 18\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html}\n */\nexport const lt = createComparisonCondition(\"lt\");\n\n/**\n * Creates a less than or equal to (≤) condition\n * @example\n * lte(\"age\", 18) // age <= 18\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html}\n */\nexport const lte = createComparisonCondition(\"lte\");\n\n/**\n * Creates a greater than (>) condition\n * @example\n * gt(\"price\", 100) // price > 100\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html}\n */\nexport const gt = createComparisonCondition(\"gt\");\n\n/**\n * Creates a greater than or equal to (≥) condition\n * @example\n * gte(\"price\", 100) // price >= 100\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html}\n */\nexport const gte = createComparisonCondition(\"gte\");\n\n/**\n * Creates a between condition that checks if a value is within a range (inclusive)\n * @example\n * between(\"age\", 18, 65) // age BETWEEN 18 AND 65\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators AWS DynamoDB - BETWEEN}\n */\nexport const between = (attr: string, lower: unknown, upper: unknown): Condition => ({\n  type: \"between\",\n  attr,\n  value: [lower, upper],\n});\n\n/**\n * Creates a begins_with condition that checks if a string attribute starts with a substring\n * @example\n * beginsWith(\"email\", \"@example.com\") // begins_with(email, \"@example.com\")\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions AWS DynamoDB - begins_with}\n */\nexport const beginsWith = createComparisonCondition(\"beginsWith\");\n\n/**\n * Creates a contains condition that checks if a string contains a substring or if a set contains an element\n * @example\n * contains(\"tags\", \"important\") // contains(tags, \"important\")\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions AWS DynamoDB - contains}\n */\nexport const contains = createComparisonCondition(\"contains\");\n\n/**\n * Creates a condition that checks if an attribute exists\n * @example\n * attributeExists(\"email\") // attribute_exists(email)\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions AWS DynamoDB - attribute_exists}\n */\nexport const attributeExists = (attr: string): Condition => ({\n  type: \"attributeExists\",\n  attr,\n});\n\n/**\n * Creates a condition that checks if an attribute does not exist\n * @example\n * attributeNotExists(\"deletedAt\") // attribute_not_exists(deletedAt)\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions AWS DynamoDB - attribute_not_exists}\n */\nexport const attributeNotExists = (attr: string): Condition => ({\n  type: \"attributeNotExists\",\n  attr,\n});\n\n// --- Logical Operators ---\n\n/**\n * Combines multiple conditions with AND operator\n * @example\n * and(\n *   eq(\"status\", \"ACTIVE\"),\n *   gt(\"age\", 18)\n * ) // status = \"ACTIVE\" AND age > 18\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Logical AWS DynamoDB - AND}\n */\nexport const and = (...conditions: Condition[]): Condition => ({\n  type: \"and\",\n  conditions,\n});\n\n/**\n * Combines multiple conditions with OR operator\n * @example\n * or(\n *   eq(\"status\", \"PENDING\"),\n *   eq(\"status\", \"PROCESSING\")\n * ) // status = \"PENDING\" OR status = \"PROCESSING\"\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Logical AWS DynamoDB - OR}\n */\nexport const or = (...conditions: Condition[]): Condition => ({\n  type: \"or\",\n  conditions,\n});\n\n/**\n * Negates a condition\n * @example\n * not(eq(\"status\", \"DELETED\")) // NOT status = \"DELETED\"\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Logical AWS DynamoDB - NOT}\n */\nexport const not = (condition: Condition): Condition => ({\n  type: \"not\",\n  condition,\n});\n\n/**\n * Type-safe operators for building key conditions in DynamoDB queries.\n * Only includes operators that are valid for key conditions.\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Query.html#Query.KeyConditionExpressions AWS DynamoDB - Key Condition Expressions}\n *\n * @example\n * // Using with sort key conditions\n * table.query({\n *   pk: \"USER#123\",\n *   sk: op => op.beginsWith(\"ORDER#\")\n * })\n */\nexport type KeyConditionOperator = {\n  /** Equals comparison for key attributes */\n  eq: (value: unknown) => Condition;\n  /** Less than comparison for key attributes */\n  lt: (value: unknown) => Condition;\n  /** Less than or equal comparison for key attributes */\n  lte: (value: unknown) => Condition;\n  /** Greater than comparison for key attributes */\n  gt: (value: unknown) => Condition;\n  /** Greater than or equal comparison for key attributes */\n  gte: (value: unknown) => Condition;\n  /** Between range comparison for key attributes */\n  between: (lower: unknown, upper: unknown) => Condition;\n  /** Begins with comparison for key attributes */\n  beginsWith: (value: unknown) => Condition;\n  /** Combines multiple key conditions with AND */\n  and: (...conditions: Condition[]) => Condition;\n};\n\n/**\n * Type-safe operators for building conditions in DynamoDB operations.\n * Includes all available condition operators with proper type inference.\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html AWS DynamoDB - Condition Expressions}\n *\n * @example\n * // Using with type-safe conditions\n * interface User {\n *   status: string;\n *   age: number;\n *   email?: string;\n * }\n *\n * table.scan<User>()\n *   .where(op => op.and(\n *     op.eq(\"status\", \"ACTIVE\"),\n *     op.gt(\"age\", 18),\n *     op.attributeExists(\"email\")\n *   ))\n *\n * @template T The type of the item being operated on\n */\nexport type ConditionOperator<T extends DynamoItem> = {\n  eq: <K extends Path<T>>(attr: K, value: PathType<T, K>) => Condition;\n  ne: <K extends Path<T>>(attr: K, value: PathType<T, K>) => Condition;\n  lt: <K extends Path<T>>(attr: K, value: PathType<T, K>) => Condition;\n  lte: <K extends Path<T>>(attr: K, value: PathType<T, K>) => Condition;\n  gt: <K extends Path<T>>(attr: K, value: PathType<T, K>) => Condition;\n  gte: <K extends Path<T>>(attr: K, value: PathType<T, K>) => Condition;\n  between: <K extends Path<T>>(attr: K, lower: PathType<T, K>, upper: PathType<T, K>) => Condition;\n  beginsWith: <K extends Path<T>>(attr: K, value: PathType<T, K>) => Condition;\n  contains: <K extends Path<T>>(attr: K, value: PathType<T, K>) => Condition;\n  attributeExists: <K extends Path<T>>(attr: K) => Condition;\n  attributeNotExists: <K extends Path<T>>(attr: K) => Condition;\n  and: (...conditions: Condition[]) => Condition;\n  or: (...conditions: Condition[]) => Condition;\n  not: (condition: Condition) => Condition;\n};\n\n/**\n * Primary key type for QUERY operations.\n * Allows building complex key conditions for the sort key.\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Query.html AWS DynamoDB - Query Operations}\n *\n * @example\n * // Query items with a specific partition key and sort key prefix\n * table.query({\n *   pk: \"USER#123\",\n *   sk: op => op.beginsWith(\"ORDER#2023\")\n * })\n *\n * @example\n * // Query items within a specific sort key range\n * table.query({\n *   pk: \"USER#123\",\n *   sk: op => op.between(\"ORDER#2023-01\", \"ORDER#2023-12\")\n * })\n */\nexport type PrimaryKey = {\n  /** Partition key value */\n  pk: string;\n  /** Optional sort key condition builder */\n  sk?: (op: KeyConditionOperator) => Condition;\n};\n\n/**\n * Primary key type for GET and DELETE operations.\n * Used when you need to specify exact key values without conditions.\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithItems.html AWS DynamoDB - Working with Items}\n *\n * @example\n * // Get a specific item by its complete primary key\n * table.get({\n *   pk: \"USER#123\",\n *   sk: \"PROFILE#123\"\n * })\n *\n * @example\n * // Delete a specific item by its complete primary key\n * table.delete({\n *   pk: \"USER#123\",\n *   sk: \"ORDER#456\"\n * })\n */\nexport type PrimaryKeyWithoutExpression = {\n  /** Partition key value */\n  pk: string;\n  /** Optional sort key value */\n  sk?: string;\n};\n","import type { DeleteBuilder } from \"./builders/delete-builder\";\nimport type { GetBuilder } from \"./builders/get-builder\";\nimport type { PutBuilder } from \"./builders/put-builder\";\nimport type { ScanBuilder } from \"./builders/scan-builder\";\nimport type { UpdateBuilder } from \"./builders/update-builder\";\nimport type { StandardSchemaV1 } from \"./standard-schema\";\nimport type { Table } from \"./table\";\nimport type { DynamoItem, Index, TableConfig } from \"./types\";\nimport { eq, type PrimaryKey, type PrimaryKeyWithoutExpression } from \"./conditions\";\nimport type { QueryBuilder } from \"./builders/query-builder\";\n\n// Define the QueryFunction type with a generic return type\nexport type QueryFunction<T extends DynamoItem, I, R> = (input: I) => R;\n\n// Define a type for the query record that preserves the input type for each query function\nexport type QueryFunctionWithSchema<T extends DynamoItem, I, R> = QueryFunction<T, I, R> & {\n  schema?: StandardSchemaV1<I>;\n};\n\nexport type QueryRecord<T extends DynamoItem> = {\n  // biome-ignore lint/suspicious/noExplicitAny: This is for flexibility\n  [K: string]: QueryFunctionWithSchema<T, any, ScanBuilder<T> | QueryBuilder<T, TableConfig> | GetBuilder<T>>;\n};\n\n// Define a type for entity with only scan, get and query methods\nexport type QueryEntity<T extends DynamoItem> = {\n  scan: () => ScanBuilder<T>;\n  get: (key: PrimaryKeyWithoutExpression) => GetBuilder<T>;\n  query: (keyCondition: PrimaryKey) => QueryBuilder<T, TableConfig>;\n};\n\ninterface Settings {\n  /**\n   * Defaults to \"entityType\"\n   */\n  entityTypeAttributeName?: string;\n  timestamps?: {\n    createdAt?: {\n      /**\n       * ISO vs Unix trade-offs\n       *\n       * Both options support between, greater than and less than comparisons.\n       *\n       * ISO:\n       * - Human readable, but requires more storage space\n       * - Does not work with DynamoDBs TTL feature.\n       *\n       * UNIX:\n       * - Less readable, but requires less storage space.\n       * - Works with DynamoDBs TTL feature.\n       */\n      format: \"ISO\" | \"UNIX\";\n      /**\n       * Defaults to \"createdAt\"\n       */\n      attributeName?: string;\n    };\n    updatedAt?: {\n      /**\n       * ISO vs Unix trade-offs\n       *\n       * Both options support between, greater than and less than comparisons.\n       *\n       * ISO:\n       * - Human readable, but requires more storage space\n       * - Does not work with DynamoDBs TTL feature.\n       *\n       * UNIX:\n       * - Less readable, but requires less storage space.\n       * - Works with DynamoDBs TTL feature.\n       */\n      format: \"ISO\" | \"UNIX\";\n      /**\n       * Defaults to \"updatedAt\"\n       */\n      attributeName?: string;\n    };\n  };\n}\n\nexport interface EntityConfig<\n  T extends DynamoItem,\n  I extends DynamoItem = T,\n  Q extends QueryRecord<T> = QueryRecord<T>,\n> {\n  name: string;\n  schema: StandardSchemaV1<T>;\n  primaryKey: IndexDefinition<I>;\n  indexes?: Record<string, Index>;\n  queries: Q;\n  settings?: Settings;\n}\n\nexport interface EntityRepository<\n  /**\n   * The Entity Type\n   */\n  T extends DynamoItem,\n  /**\n   * The Primary Index (Partition index) Type\n   */\n  I extends DynamoItem = T,\n  /**\n   * The Queries object\n   */\n  Q extends QueryRecord<T> = QueryRecord<T>,\n> {\n  create: (data: T) => PutBuilder<T>;\n  upsert: (data: T & I) => PutBuilder<T>;\n  get: (key: I) => GetBuilder<T>;\n  update: (key: I, data: Partial<T>) => UpdateBuilder<T>;\n  delete: (key: I) => DeleteBuilder;\n  query: Q;\n  scan: () => ScanBuilder<T>;\n}\n\n/**\n * Creates an entity definition with type-safe operations\n *\n * @example\n * ```typescript\n * interface User {\n *   id: string;\n *   name: string;\n * }\n *\n * const UserEntity = defineEntity<User>({\n *   name: \"User\",\n *   schema: userSchema,\n *   primaryKey: primaryKey,\n * });\n * ```\n */\nexport function defineEntity<T extends DynamoItem, I extends DynamoItem = T, Q extends QueryRecord<T> = QueryRecord<T>>(\n  config: EntityConfig<T, I, Q>,\n) {\n  const entityTypeAttributeName = config.settings?.entityTypeAttributeName ?? \"entityType\";\n\n  /**\n   * Generates an object containing timestamp attributes based on the given configuration settings.\n   * The function determines the presence and format of \"createdAt\" and \"updatedAt\" timestamps dynamically.\n   *\n   * @returns {Record<string, string | number>} An object containing one or both of the \"createdAt\" and \"updatedAt\" timestamp attributes, depending on the configuration. Each timestamp can be formatted as either an ISO string or a UNIX timestamp.\n   *\n   * @throws Will not throw errors but depends on `config.settings?.timestamps` to be properly defined.\n   * - If `createdAt` is configured, the function adds a timestamp using the attribute name specified in `config.settings.timestamps.createdAt.attributeName` or defaults to \"createdAt\".\n   * - If `updatedAt` is configured, the function adds a timestamp using the attribute name specified in `config.settings.timestamps.updatedAt.attributeName` or defaults to \"updatedAt\".\n   *\n   * Configuration Details:\n   *  - `config.settings.timestamps.createdAt.format`: Determines the format of the \"createdAt\" timestamp. Accepts \"UNIX\" or defaults to ISO string.\n   *  - `config.settings.timestamps.updatedAt.format`: Determines the format of the \"updatedAt\" timestamp. Accepts \"UNIX\" or defaults to ISO string.\n   *\n   * The returned object keys and values depend on the provided configuration.\n   */\n  const generateTimestamps = (): Record<string, string | number> => {\n    const timestamps: Record<string, string | number> = {};\n\n    if (config.settings?.timestamps) {\n      const now = new Date();\n\n      if (config.settings.timestamps.createdAt) {\n        const attributeName = config.settings.timestamps.createdAt.attributeName ?? \"createdAt\";\n        timestamps[attributeName] =\n          config.settings.timestamps.createdAt.format === \"UNIX\" ? Math.floor(Date.now() / 1000) : now.toISOString();\n      }\n\n      if (config.settings.timestamps.updatedAt) {\n        const attributeName = config.settings.timestamps.updatedAt.attributeName ?? \"updatedAt\";\n        timestamps[attributeName] =\n          config.settings.timestamps.updatedAt.format === \"UNIX\" ? Math.floor(Date.now() / 1000) : now.toISOString();\n      }\n    }\n\n    return timestamps;\n  };\n\n  return {\n    name: config.name,\n    createRepository: (table: Table): EntityRepository<T, I, Q> => {\n      // Create a repository\n      const repository = {\n        create: (data: T) => {\n          // We need to handle the async operations when the consumer calls execute\n          const builder = table.create<T>({\n            ...data,\n            [entityTypeAttributeName]: config.name,\n            ...generateTimestamps(),\n          });\n\n          // Wrap the builder's execute method to apply validation only\n          const originalExecute = builder.execute;\n          builder.execute = async () => {\n            // Validate data against schema\n            const validationResult = await config.schema[\"~standard\"].validate(data);\n            if (\"issues\" in validationResult && validationResult.issues) {\n              throw new Error(`Validation failed: ${validationResult.issues.map((i) => i.message).join(\", \")}`);\n            }\n\n            const primaryKey = config.primaryKey.generateKey(validationResult.value as unknown as I);\n\n            const indexes = Object.entries(config.indexes ?? {}).reduce(\n              (acc, [indexName, index]) => {\n                const key = (index as IndexDefinition<T>).generateKey(validationResult.value);\n                const gsiConfig = table.gsis[indexName];\n\n                if (!gsiConfig) {\n                  throw new Error(`GSI configuration not found for index: ${indexName}`);\n                }\n\n                if (key.pk) {\n                  acc[gsiConfig.partitionKey] = key.pk;\n                }\n                if (key.sk && gsiConfig.sortKey) {\n                  acc[gsiConfig.sortKey] = key.sk;\n                }\n                return acc;\n              },\n              {} as Record<string, string>,\n            );\n\n            // Update the item in the builder with the validated data, entity type, and timestamps\n            Object.assign(builder, {\n              item: {\n                ...validationResult.value,\n                [entityTypeAttributeName]: config.name,\n                [table.partitionKey]: primaryKey.pk,\n                ...(table.sortKey ? { [table.sortKey]: primaryKey.sk } : {}),\n                ...indexes,\n                ...generateTimestamps(),\n              },\n            });\n\n            // Execute the builder\n            return await originalExecute.call(builder);\n          };\n\n          return builder;\n        },\n\n        upsert: (data: T & I) => {\n          const primaryKey = config.primaryKey.generateKey(data);\n\n          // We need to handle the async operations when the consumer calls execute\n          const builder = table.put<T>({\n            [table.partitionKey]: primaryKey.pk,\n            ...(table.sortKey ? { [table.sortKey]: primaryKey.sk } : {}),\n            ...data,\n            [entityTypeAttributeName]: config.name,\n            ...generateTimestamps(),\n          });\n\n          // Wrap the builder's execute method to apply validation only\n          const originalExecute = builder.execute;\n          builder.execute = async () => {\n            // Validate data against schema\n            const validationResult = await config.schema[\"~standard\"].validate(data);\n            if (\"issues\" in validationResult && validationResult.issues) {\n              throw new Error(`Validation failed: ${validationResult.issues.map((i) => i.message).join(\", \")}`);\n            }\n\n            // Update the item in the builder with the validated data, entity type, and timestamps\n            Object.assign(builder, {\n              item: {\n                ...validationResult.value,\n                [entityTypeAttributeName]: config.name,\n                ...generateTimestamps(),\n              },\n            });\n\n            // Execute the builder\n            const result = await originalExecute.call(builder);\n            if (!result) {\n              throw new Error(\"Failed to upsert item\");\n            }\n\n            return result;\n          };\n\n          return builder;\n        },\n\n        get: <K extends I>(key: K) => {\n          // Transform the input key into a PrimaryKeyWithoutExpression using the primary key definition\n          const primaryKeyObj = config.primaryKey.generateKey(key);\n          return table.get<T>(primaryKeyObj);\n        },\n\n        update: <K extends I>(key: K, data: Partial<T>) => {\n          // Transform the input key into a PrimaryKeyWithoutExpression using the primary key definition\n          const primaryKeyObj = config.primaryKey.generateKey(key);\n          const builder = table.update<T>(primaryKeyObj);\n          builder.condition(eq(entityTypeAttributeName, config.name));\n\n          // Generate updatedAt timestamp if configured\n          const timestamps: Record<string, string | number> = {};\n          if (config.settings?.timestamps?.updatedAt) {\n            const now = new Date();\n            const attributeName = config.settings.timestamps.updatedAt.attributeName ?? \"updatedAt\";\n            timestamps[attributeName] =\n              config.settings.timestamps.updatedAt.format === \"UNIX\"\n                ? Math.floor(Date.now() / 1000)\n                : now.toISOString();\n          }\n\n          // Merge the data with timestamps\n          builder.set({\n            ...data,\n            ...timestamps,\n          });\n\n          return builder;\n        },\n\n        delete: <K extends I>(key: K) => {\n          // Transform the input key into a PrimaryKeyWithoutExpression using the primary key definition\n          const primaryKeyObj = config.primaryKey.generateKey(key);\n          const builder = table.delete(primaryKeyObj);\n          builder.condition(eq(entityTypeAttributeName, config.name));\n          return builder;\n        },\n\n        query: Object.entries(config.queries || {}).reduce((acc, [key, inputCallback]) => {\n          // @ts-expect-error - We need to cast the queryFn to a function that takes an unknown input\n          acc[key] = (input: unknown) => {\n            // Create a QueryEntity object with only the necessary methods\n            const queryEntity: QueryEntity<T> = {\n              scan: repository.scan,\n              get: (key: PrimaryKeyWithoutExpression) => table.get<T>(key),\n              query: (keyCondition: PrimaryKey) => {\n                return table.query<T>(keyCondition);\n              },\n            };\n\n            // Execute the query function to get the builder - This type is incorrect and needs to be fixed\n            const queryBuilderCallback = inputCallback(input);\n\n            // Run the inner handler which allows the user to apply their desired contraints\n            // to the query builder of their choice\n            // @ts-expect-error - We need to cast the queryBuilderCallback to a function that takes a QueryEntity\n            const builder = queryBuilderCallback(queryEntity);\n\n            // Add entity type filter if the builder has filter method\n            if (builder && typeof builder === \"object\" && \"filter\" in builder && typeof builder.filter === \"function\") {\n              builder.filter(eq(entityTypeAttributeName, config.name));\n            }\n\n            // Wrap the builder's execute method if it exists\n            if (builder && typeof builder === \"object\" && \"execute\" in builder) {\n              const originalExecute = builder.execute;\n              builder.execute = async () => {\n                // Validate the input before executing the query\n                const queryFn = (\n                  config.queries as unknown as Record<string, QueryFunctionWithSchema<T, I, typeof builder>>\n                )[key];\n\n                if (queryFn && typeof queryFn === \"function\") {\n                  // Get the schema from the query function\n                  const schema = queryFn.schema;\n                  if (schema?.[\"~standard\"]?.validate && typeof schema[\"~standard\"].validate === \"function\") {\n                    const validationResult = schema[\"~standard\"].validate(input);\n                    if (\"issues\" in validationResult && validationResult.issues) {\n                      throw new Error(\n                        `Validation failed: ${validationResult.issues.map((issue) => issue.message).join(\", \")}`,\n                      );\n                    }\n                  }\n                }\n\n                // Execute the original builder\n                const result = await originalExecute.call(builder);\n                if (!result) {\n                  throw new Error(\"Failed to execute query\");\n                }\n                return result;\n              };\n            }\n\n            return builder;\n          };\n          return acc;\n        }, {} as Q),\n\n        scan: () => {\n          const scanBuilder = table.scan<T>();\n          scanBuilder.filter(eq(entityTypeAttributeName, config.name));\n\n          return scanBuilder;\n        },\n      };\n\n      return repository;\n    },\n  };\n}\n\nexport function createQueries<T extends DynamoItem>() {\n  return {\n    input: <I>(schema: StandardSchemaV1<I>) => ({\n      query: <\n        Q extends QueryRecord<T> = QueryRecord<T>,\n        R = ScanBuilder<T> | QueryBuilder<T, TableConfig> | GetBuilder<T>,\n      >(\n        handler: (params: { input: I; entity: QueryEntity<T> }) => R,\n      ) => {\n        // Create a query function that conforms to QueryFunctionWithSchema type\n        const queryFn = (input: I) => {\n          // This function will be called by the repository later with the real queryEntity\n          return (entity: QueryEntity<T>) => {\n            return handler({ input, entity });\n          };\n        };\n\n        // Attach the schema to the function for validation purposes\n        queryFn.schema = schema;\n\n        // Return the query function (this satisfies the QueryFunctionWithSchema type)\n        return queryFn as unknown as QueryFunctionWithSchema<T, I, R>;\n      },\n    }),\n  };\n}\n\nexport interface IndexDefinition<T extends DynamoItem> extends Index {\n  name: string;\n  generateKey: (item: T) => { pk: string; sk?: string };\n}\n\nexport function createIndex() {\n  return {\n    input: <T extends DynamoItem>(schema: StandardSchemaV1<T>) => ({\n      partitionKey: <P extends (item: T) => string>(pkFn: P) => ({\n        sortKey: <S extends (item: T) => string>(skFn: S) =>\n          ({\n            name: \"custom\",\n            partitionKey: \"pk\",\n            sortKey: \"sk\",\n            generateKey: (item: T) => ({\n              pk: pkFn(item),\n              sk: skFn(item),\n            }),\n          }) as IndexDefinition<T>,\n\n        // Allow creating an index with only a partition key\n        withoutSortKey: () =>\n          ({\n            name: \"custom\",\n            partitionKey: \"pk\",\n            generateKey: (item: T) => ({\n              pk: pkFn(item),\n            }),\n          }) as IndexDefinition<T>,\n      }),\n    }),\n  };\n}\n"]}

package/dist/entity.d.cts

@@ -0,0 +1,149 @@
+import { DeleteBuilder } from './builders/delete-builder.cjs';
+import { S as ScanBuilder, G as GetBuilder, T as Table } from './table-BEhBPy2G.cjs';
+import { PutBuilder } from './builders/put-builder.cjs';
+import { UpdateBuilder } from './builders/update-builder.cjs';
+import { StandardSchemaV1 } from './standard-schema.cjs';
+import { DynamoItem, TableConfig, Index } from './types.cjs';
+import { P as PrimaryKeyWithoutExpression, a as PrimaryKey } from './conditions-ChhQWd6z.cjs';
+import { Q as QueryBuilder } from './query-builder-D2FM9rsu.cjs';
+import './builders/transaction-builder.cjs';
+import '@aws-sdk/lib-dynamodb';
+import './builder-types-DtwbqMeF.cjs';
+import './builders/condition-check-builder.cjs';
+import './builders/paginator.cjs';
+
+type QueryFunction<T extends DynamoItem, I, R> = (input: I) => R;
+type QueryFunctionWithSchema<T extends DynamoItem, I, R> = QueryFunction<T, I, R> & {
+    schema?: StandardSchemaV1<I>;
+};
+type QueryRecord<T extends DynamoItem> = {
+    [K: string]: QueryFunctionWithSchema<T, any, ScanBuilder<T> | QueryBuilder<T, TableConfig> | GetBuilder<T>>;
+};
+type QueryEntity<T extends DynamoItem> = {
+    scan: () => ScanBuilder<T>;
+    get: (key: PrimaryKeyWithoutExpression) => GetBuilder<T>;
+    query: (keyCondition: PrimaryKey) => QueryBuilder<T, TableConfig>;
+};
+interface Settings {
+    /**
+     * Defaults to "entityType"
+     */
+    entityTypeAttributeName?: string;
+    timestamps?: {
+        createdAt?: {
+            /**
+             * ISO vs Unix trade-offs
+             *
+             * Both options support between, greater than and less than comparisons.
+             *
+             * ISO:
+             * - Human readable, but requires more storage space
+             * - Does not work with DynamoDBs TTL feature.
+             *
+             * UNIX:
+             * - Less readable, but requires less storage space.
+             * - Works with DynamoDBs TTL feature.
+             */
+            format: "ISO" | "UNIX";
+            /**
+             * Defaults to "createdAt"
+             */
+            attributeName?: string;
+        };
+        updatedAt?: {
+            /**
+             * ISO vs Unix trade-offs
+             *
+             * Both options support between, greater than and less than comparisons.
+             *
+             * ISO:
+             * - Human readable, but requires more storage space
+             * - Does not work with DynamoDBs TTL feature.
+             *
+             * UNIX:
+             * - Less readable, but requires less storage space.
+             * - Works with DynamoDBs TTL feature.
+             */
+            format: "ISO" | "UNIX";
+            /**
+             * Defaults to "updatedAt"
+             */
+            attributeName?: string;
+        };
+    };
+}
+interface EntityConfig<T extends DynamoItem, I extends DynamoItem = T, Q extends QueryRecord<T> = QueryRecord<T>> {
+    name: string;
+    schema: StandardSchemaV1<T>;
+    primaryKey: IndexDefinition<I>;
+    indexes?: Record<string, Index>;
+    queries: Q;
+    settings?: Settings;
+}
+interface EntityRepository<
+/**
+ * The Entity Type
+ */
+T extends DynamoItem, 
+/**
+ * The Primary Index (Partition index) Type
+ */
+I extends DynamoItem = T, 
+/**
+ * The Queries object
+ */
+Q extends QueryRecord<T> = QueryRecord<T>> {
+    create: (data: T) => PutBuilder<T>;
+    upsert: (data: T & I) => PutBuilder<T>;
+    get: (key: I) => GetBuilder<T>;
+    update: (key: I, data: Partial<T>) => UpdateBuilder<T>;
+    delete: (key: I) => DeleteBuilder;
+    query: Q;
+    scan: () => ScanBuilder<T>;
+}
+/**
+ * Creates an entity definition with type-safe operations
+ *
+ * @example
+ * ```typescript
+ * interface User {
+ *   id: string;
+ *   name: string;
+ * }
+ *
+ * const UserEntity = defineEntity<User>({
+ *   name: "User",
+ *   schema: userSchema,
+ *   primaryKey: primaryKey,
+ * });
+ * ```
+ */
+declare function defineEntity<T extends DynamoItem, I extends DynamoItem = T, Q extends QueryRecord<T> = QueryRecord<T>>(config: EntityConfig<T, I, Q>): {
+    name: string;
+    createRepository: (table: Table) => EntityRepository<T, I, Q>;
+};
+declare function createQueries<T extends DynamoItem>(): {
+    input: <I>(schema: StandardSchemaV1<I>) => {
+        query: <Q extends QueryRecord<T> = QueryRecord<T>, R = ScanBuilder<T, TableConfig> | QueryBuilder<T, TableConfig> | GetBuilder<T>>(handler: (params: {
+            input: I;
+            entity: QueryEntity<T>;
+        }) => R) => QueryFunctionWithSchema<T, I, R>;
+    };
+};
+interface IndexDefinition<T extends DynamoItem> extends Index {
+    name: string;
+    generateKey: (item: T) => {
+        pk: string;
+        sk?: string;
+    };
+}
+declare function createIndex(): {
+    input: <T extends DynamoItem>(schema: StandardSchemaV1<T>) => {
+        partitionKey: <P extends (item: T) => string>(pkFn: P) => {
+            sortKey: <S extends (item: T) => string>(skFn: S) => IndexDefinition<T>;
+            withoutSortKey: () => IndexDefinition<T>;
+        };
+    };
+};
+
+export { type EntityConfig, type EntityRepository, type IndexDefinition, type QueryEntity, type QueryFunction, type QueryFunctionWithSchema, type QueryRecord, createIndex, createQueries, defineEntity };