@opble/repository-dynamodb 1.0.0

package/dist/index.cjs

@@ -0,0 +1,324 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  AbstractDynamoDBRepository: () => AbstractDynamoDBRepository,
+  QueryAllSchema: () => QueryAllSchema,
+  QueryWithPaginationSchema: () => QueryWithPaginationSchema,
+  QueryWithSortingSchema: () => QueryWithSortingSchema,
+  ScanFilterSchema: () => ScanFilterSchema,
+  TableKeychema: () => TableKeychema,
+  TableSpecSchema: () => TableSpecSchema
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/repository.ts
+var import_client_dynamodb = require("@aws-sdk/client-dynamodb");
+var import_lib_dynamodb = require("@aws-sdk/lib-dynamodb");
+var import_debug = require("@opble/debug");
+var import_entity = require("@opble/entity");
+var debug = (0, import_debug.createDebug)("opble:repository-dynamodb");
+var SORT_ASCENDING = "asc";
+var BATCH_SIZE = 50;
+function now() {
+  return Math.floor(Date.now() / 1e3);
+}
+var AbstractDynamoDBRepository = class {
+  constructor(table, factory) {
+    this.table = table;
+    this.factory = factory;
+    this.client = import_lib_dynamodb.DynamoDBDocumentClient.from(new import_client_dynamodb.DynamoDBClient({}));
+  }
+  client;
+  getKey(id) {
+    return {
+      [this.table.keys.hashKey]: id.hashKey,
+      ...this.table.keys.sortKey ? { [this.table.keys.sortKey]: id.sortKey } : {}
+    };
+  }
+  async query(hashKey, query, pagination, sorting) {
+    let lastEvaluatedKey;
+    let currentPage = 1;
+    let resultItems = [];
+    const filterReturnedItemsExcludeSortKey = (items) => {
+      return query?.excludeSortKey && this.table.keys.sortKey ? items.filter(
+        (item) => item[this.table.keys.sortKey] !== query.excludeSortKey
+      ) : items;
+    };
+    do {
+      const command = new import_lib_dynamodb.QueryCommand({
+        TableName: this.table.name,
+        KeyConditionExpression: `#${this.table.keys.hashKey} = :hashKeyValue`,
+        ExpressionAttributeNames: {
+          [`#${this.table.keys.hashKey}`]: this.table.keys.hashKey
+        },
+        ExpressionAttributeValues: {
+          ":hashKeyValue": hashKey
+        },
+        ExclusiveStartKey: lastEvaluatedKey
+      });
+      if (pagination) {
+        command.input.Limit = pagination.limit;
+      }
+      if (sorting) {
+        command.input.ScanIndexForward = sorting.sortOrder === "asc";
+      }
+      if (query) {
+        if (query.index) {
+          command.input.IndexName = query.index.name;
+          command.input.KeyConditionExpression = `#${query.index.keys.hashKey} = :hashKeyValue`;
+          command.input.ExpressionAttributeNames = {
+            [`#${query.index.keys.hashKey}`]: query.index.keys.hashKey
+          };
+        }
+        const sortKey = query.index?.keys.sortKey ?? this.table.keys.sortKey;
+        if (query.sortKeyBeginsWith && sortKey) {
+          command.input.KeyConditionExpression = `${command.input.KeyConditionExpression} AND begins_with(#${sortKey}, :sortKeyBeginsWith)`;
+          command.input.ExpressionAttributeNames ??= {};
+          command.input.ExpressionAttributeNames[`#${sortKey}`] = sortKey;
+          command.input.ExpressionAttributeValues ??= {};
+          command.input.ExpressionAttributeValues[":sortKeyBeginsWith"] = query.sortKeyBeginsWith;
+        } else if (query.sortKey && sortKey) {
+          command.input.KeyConditionExpression = `${command.input.KeyConditionExpression} AND #${sortKey} = :sortKeyValue`;
+          command.input.ExpressionAttributeNames ??= {};
+          command.input.ExpressionAttributeNames[`#${sortKey}`] = sortKey;
+          command.input.ExpressionAttributeValues ??= {};
+          command.input.ExpressionAttributeValues[":sortKeyValue"] = query.sortKey;
+        } else if (query.sortKeyBetween && sortKey) {
+          command.input.KeyConditionExpression = `${command.input.KeyConditionExpression} AND #${sortKey} BETWEEN :sortKeyStart AND :sortKeyEnd`;
+          command.input.ExpressionAttributeNames ??= {};
+          command.input.ExpressionAttributeNames[`#${sortKey}`] = sortKey;
+          command.input.ExpressionAttributeValues ??= {};
+          command.input.ExpressionAttributeValues[":sortKeyStart"] = query.sortKeyBetween.start;
+          command.input.ExpressionAttributeValues[":sortKeyEnd"] = query.sortKeyBetween.end;
+        }
+      }
+      debug("command#input", command.input);
+      const result = await this.client.send(command);
+      lastEvaluatedKey = result.LastEvaluatedKey;
+      if (!pagination) {
+        resultItems.push(
+          ...filterReturnedItemsExcludeSortKey(result.Items ?? [])
+        );
+      } else if (currentPage === pagination.page) {
+        resultItems = filterReturnedItemsExcludeSortKey(result.Items ?? []);
+        break;
+      }
+      currentPage++;
+    } while (lastEvaluatedKey);
+    const strict = !query || !query.index;
+    return resultItems.map((item) => this.factory.create(item, { strict }));
+  }
+  async queryInBulk(keys, query) {
+    const chunks = [];
+    for (let i = 0; i < keys.length; i += BATCH_SIZE) {
+      chunks.push(keys.slice(i, i + BATCH_SIZE));
+    }
+    const results = await Promise.all(
+      chunks.map(async (chunk) => {
+        const command = new import_lib_dynamodb.BatchGetCommand({
+          RequestItems: {
+            [this.table.name]: { Keys: chunk }
+          }
+        });
+        const response = await this.client.send(command);
+        return response.Responses?.[this.table.name] ?? [];
+      })
+    );
+    const mergedItems = results.flat();
+    const items = mergedItems.map((item) => this.factory.create(item));
+    if (query && query.sortBy) {
+      const sortOrder = query.sortOrder ?? SORT_ASCENDING;
+      items.sort((a, b) => {
+        if (a[query.sortBy] < b[query.sortBy])
+          return sortOrder === SORT_ASCENDING ? -1 : 1;
+        if (a[query.sortBy] > b[query.sortBy])
+          return sortOrder === SORT_ASCENDING ? 1 : -1;
+        return 0;
+      });
+    }
+    return items;
+  }
+  async scan(pagination, filter) {
+    let lastEvaluatedKey;
+    let currentPage = 1;
+    let resultItems = [];
+    do {
+      const command = new import_lib_dynamodb.ScanCommand({
+        TableName: this.table.name,
+        ExclusiveStartKey: lastEvaluatedKey
+      });
+      if (pagination) {
+        command.input.Limit = pagination.limit;
+      }
+      if (filter) {
+        command.input.FilterExpression = filter.filterExpression;
+        command.input.ExpressionAttributeNames = filter.expressionAttributeNames;
+        command.input.ExpressionAttributeValues = filter.expressionAttributeValues;
+      }
+      const result = await this.client.send(command);
+      lastEvaluatedKey = result.LastEvaluatedKey;
+      if (!pagination) {
+        resultItems.push(...result.Items ?? []);
+      } else if (currentPage === pagination.page) {
+        resultItems = result.Items ?? [];
+        break;
+      }
+      currentPage++;
+    } while (lastEvaluatedKey);
+    return resultItems.map((item) => this.factory.create(item));
+  }
+  async deleteAll(hashKey) {
+    const items = await this.query(hashKey);
+    const keys = items.map((item) => {
+      if (this.table.keys.sortKey) {
+        return {
+          [this.table.keys.hashKey]: hashKey,
+          [this.table.keys.sortKey]: item[this.table.keys.sortKey]
+        };
+      } else {
+        return {
+          [this.table.keys.hashKey]: hashKey
+        };
+      }
+    });
+    await this.deleteInBulk(keys);
+  }
+  async deleteInBulk(keys) {
+    const batches = [];
+    while (keys.length > 0) {
+      batches.push(keys.splice(0, BATCH_SIZE));
+    }
+    for (const batch of batches) {
+      const deleteRequests = batch.map((key) => ({
+        DeleteRequest: { Key: key }
+      }));
+      const command = new import_lib_dynamodb.BatchWriteCommand({
+        RequestItems: {
+          [this.table.name]: deleteRequests
+        }
+      });
+      try {
+        const response = await this.client.send(command);
+        debug("[INFO] Batch delete response:", response);
+        if (response.UnprocessedItems && response.UnprocessedItems[this.table.name]) {
+          debug("[WARN] Unprocessed items found. Retrying...");
+          const unprocessedItems = response.UnprocessedItems[this.table.name];
+          if (unprocessedItems === void 0) {
+            continue;
+          }
+          const unprocessedKeys = unprocessedItems.map((item) => item.DeleteRequest?.Key).filter((key) => key != null);
+          await this.deleteInBulk(unprocessedKeys);
+        }
+      } catch (error) {
+        debug("[ERROR] Error deleting items in batch:", error);
+      }
+    }
+  }
+  async get(id) {
+    const command = new import_lib_dynamodb.GetCommand({
+      TableName: this.table.name,
+      Key: this.getKey(id)
+    });
+    const result = await this.client.send(command);
+    return result.Item ? this.factory.create(result.Item) : null;
+  }
+  /**
+   * Allow to manipulate the data before saving
+   * @param item
+   * @returns
+   */
+  beforeSave(item) {
+    if ((0, import_entity.isTimestamps)(item)) {
+      item.updatedAt = now();
+    } else if ((0, import_entity.isTimestamp)(item)) {
+      item.timestamp = now();
+    }
+    return item;
+  }
+  async save(item) {
+    item = this.beforeSave(item);
+    const command = new import_lib_dynamodb.PutCommand({
+      TableName: this.table.name,
+      Item: { ...item }
+    });
+    await this.client.send(command);
+    return item;
+  }
+  async delete(id) {
+    await this.client.send(
+      new import_lib_dynamodb.DeleteCommand({
+        TableName: this.table.name,
+        Key: this.getKey(id)
+      })
+    );
+  }
+};
+
+// src/types.ts
+var import_zod = require("zod");
+var TableKeychema = import_zod.z.object({
+  hashKey: import_zod.z.string(),
+  sortKey: import_zod.z.union([import_zod.z.string(), import_zod.z.number()]).optional()
+});
+var TableSpecSchema = import_zod.z.object({
+  name: import_zod.z.string(),
+  keys: import_zod.z.object({
+    hashKey: import_zod.z.string(),
+    sortKey: import_zod.z.string().optional()
+  })
+});
+var QueryWithPaginationSchema = import_zod.z.object({
+  page: import_zod.z.string().optional().transform((val) => val ? parseInt(val, 10) : 1).refine((val) => val >= 1, { message: "Page must be at least 1" }),
+  limit: import_zod.z.string().optional().transform((val) => val ? parseInt(val, 10) : 25).refine((val) => val >= 5 && val <= 100, {
+    message: "Limit must be between 5 and 100"
+  })
+});
+var QueryWithSortingSchema = import_zod.z.object({
+  sortBy: import_zod.z.string().optional(),
+  sortOrder: import_zod.z.enum(["asc", "desc"]).optional().transform((val) => val ?? "asc")
+});
+var QueryAllSchema = import_zod.z.object({
+  excludeSortKey: import_zod.z.string().optional(),
+  sortKeyBetween: import_zod.z.object({
+    start: import_zod.z.string(),
+    end: import_zod.z.string()
+  }).optional(),
+  sortKeyBeginsWith: import_zod.z.string().optional(),
+  sortKey: import_zod.z.any().optional(),
+  index: TableSpecSchema.optional()
+});
+var ScanFilterSchema = import_zod.z.object({
+  filterExpression: import_zod.z.string(),
+  expressionAttributeNames: import_zod.z.record(import_zod.z.string(), import_zod.z.string()),
+  expressionAttributeValues: import_zod.z.record(import_zod.z.string(), import_zod.z.any())
+});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AbstractDynamoDBRepository,
+  QueryAllSchema,
+  QueryWithPaginationSchema,
+  QueryWithSortingSchema,
+  ScanFilterSchema,
+  TableKeychema,
+  TableSpecSchema
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/repository.ts","../src/types.ts"],"sourcesContent":["export * from './repository';\nexport * from './types';\n","import { DynamoDBClient } from '@aws-sdk/client-dynamodb';\nimport {\n  BatchGetCommand,\n  BatchWriteCommand,\n  DeleteCommand,\n  DynamoDBDocumentClient,\n  GetCommand,\n  PutCommand,\n  QueryCommand,\n  ScanCommand,\n} from '@aws-sdk/lib-dynamodb';\nimport { createDebug } from '@opble/debug';\nimport { Factory, HashMap } from '@opble/types';\nimport { isTimestamp, isTimestamps } from '@opble/entity';\nimport {\n  DynamoDBRepository,\n  QueryAll,\n  QueryWithPagination,\n  QueryWithSorting,\n  ScanFilter,\n  TableKey,\n  TableSpec,\n} from './types';\n\nconst debug = createDebug('opble:repository-dynamodb');\nconst SORT_ASCENDING = 'asc';\nconst BATCH_SIZE = 50;\n\nfunction now(): number {\n  return Math.floor(Date.now() / 1000);\n}\n\nexport class AbstractDynamoDBRepository<\n  T extends HashMap,\n  ID extends TableKey = TableKey,\n> implements DynamoDBRepository<T, ID> {\n  protected client: DynamoDBDocumentClient;\n\n  constructor(\n    protected table: TableSpec,\n    protected factory: Factory<T>\n  ) {\n    this.client = DynamoDBDocumentClient.from(new DynamoDBClient({}));\n  }\n\n  protected getKey(id: ID): HashMap {\n    return {\n      [this.table.keys.hashKey]: id.hashKey,\n      ...(this.table.keys.sortKey\n        ? { [this.table.keys.sortKey]: id.sortKey }\n        : {}),\n    };\n  }\n\n  async query(\n    hashKey: unknown,\n    query?: QueryAll,\n    pagination?: QueryWithPagination,\n    sorting?: Pick<QueryWithSorting, 'sortOrder'>\n  ): Promise<T[]> {\n    /**\n     * Internal state for pagination\n     * - lastEvaluatedKey tells DynamoDB where to resume from\n     * - currentPage helps us skip earlier pages\n     * - resultItems will store the final page’s items\n     */\n    let lastEvaluatedKey: Record<string, unknown> | undefined;\n    let currentPage = 1;\n    let resultItems: HashMap[] = [];\n    const filterReturnedItemsExcludeSortKey = (items: HashMap[]) => {\n      /**\n       * Business rule: Exclude a specific sortKey (if requested)\n       * This is used to skip “parent” or “header” records within the same partition.\n       */\n      return query?.excludeSortKey && this.table.keys.sortKey\n        ? items.filter(\n            (item) => item[this.table.keys.sortKey!] !== query.excludeSortKey\n          )\n        : items;\n    };\n\n    do {\n      /**\n       * Prepare the QueryCommand\n       * - Basic condition: match all items with the given hash key\n       * - Add pagination via Limit + ExclusiveStartKey\n       */\n      const command = new QueryCommand({\n        TableName: this.table.name,\n        KeyConditionExpression: `#${this.table.keys.hashKey} = :hashKeyValue`,\n        ExpressionAttributeNames: {\n          [`#${this.table.keys.hashKey}`]: this.table.keys.hashKey,\n        },\n        ExpressionAttributeValues: {\n          ':hashKeyValue': hashKey,\n        },\n        ExclusiveStartKey: lastEvaluatedKey,\n      });\n\n      if (pagination) {\n        command.input.Limit = pagination.limit;\n      }\n      if (sorting) {\n        command.input.ScanIndexForward = sorting.sortOrder === 'asc';\n      }\n\n      /**\n       * Apply optional filters if provided\n       */\n      if (query) {\n        // If querying a secondary index\n        if (query.index) {\n          command.input.IndexName = query.index.name;\n          command.input.KeyConditionExpression = `#${query.index.keys.hashKey} = :hashKeyValue`;\n          command.input.ExpressionAttributeNames = {\n            [`#${query.index.keys.hashKey}`]: query.index.keys.hashKey,\n          };\n        }\n\n        // If we want to match only sort keys starting with a specific prefix\n        const sortKey = query.index?.keys.sortKey ?? this.table.keys.sortKey;\n        if (query.sortKeyBeginsWith && sortKey) {\n          command.input.KeyConditionExpression = `${command.input.KeyConditionExpression} AND begins_with(#${sortKey}, :sortKeyBeginsWith)`;\n          command.input.ExpressionAttributeNames ??= {};\n          command.input.ExpressionAttributeNames[`#${sortKey}`] = sortKey;\n          command.input.ExpressionAttributeValues ??= {};\n          command.input.ExpressionAttributeValues[':sortKeyBeginsWith'] =\n            query.sortKeyBeginsWith;\n        } else if (query.sortKey && sortKey) {\n          command.input.KeyConditionExpression = `${command.input.KeyConditionExpression} AND #${sortKey} = :sortKeyValue`;\n          command.input.ExpressionAttributeNames ??= {};\n          command.input.ExpressionAttributeNames[`#${sortKey}`] = sortKey;\n          command.input.ExpressionAttributeValues ??= {};\n          command.input.ExpressionAttributeValues[':sortKeyValue'] =\n            query.sortKey;\n        } else if (query.sortKeyBetween && sortKey) {\n          command.input.KeyConditionExpression = `${command.input.KeyConditionExpression} AND #${sortKey} BETWEEN :sortKeyStart AND :sortKeyEnd`;\n          command.input.ExpressionAttributeNames ??= {};\n          command.input.ExpressionAttributeNames[`#${sortKey}`] = sortKey;\n          command.input.ExpressionAttributeValues ??= {};\n          command.input.ExpressionAttributeValues[':sortKeyStart'] =\n            query.sortKeyBetween.start;\n          command.input.ExpressionAttributeValues[':sortKeyEnd'] =\n            query.sortKeyBetween.end;\n        }\n      }\n      debug('command#input', command.input);\n\n      // Execute the query\n      const result = await this.client.send(command);\n\n      // Keep the pagination pointer (if DynamoDB says there’s more data)\n      lastEvaluatedKey = result.LastEvaluatedKey;\n\n      if (!pagination) {\n        // pagination is disabled, fetch until no results found\n        resultItems.push(\n          ...filterReturnedItemsExcludeSortKey(result.Items ?? [])\n        );\n      } else if (currentPage === pagination.page) {\n        /**\n         * Once we reach the desired page, capture those items.\n         * DynamoDB doesn’t support direct page jumps — we simulate it by looping\n         * until we reach the correct page number.\n         */\n\n        resultItems = filterReturnedItemsExcludeSortKey(result.Items ?? []);\n        break; // Stop — we’ve collected the requested page\n      }\n\n      currentPage++; // Move to next page and continue querying\n    } while (lastEvaluatedKey);\n\n    /**\n     * Map each DynamoDB item into an instance of your model class (T)\n     * When querrying with index, turn strict to false\n     */\n    const strict = !query || !query.index;\n    return resultItems.map((item) => this.factory.create(item, { strict }));\n  }\n\n  async queryInBulk(keys: HashMap[], query?: QueryWithSorting): Promise<T[]> {\n    // Split keys into chunks of BATCH_SIZE (DynamoDB BatchGet limit)\n    const chunks: HashMap[][] = [];\n    for (let i = 0; i < keys.length; i += BATCH_SIZE) {\n      chunks.push(keys.slice(i, i + BATCH_SIZE));\n    }\n\n    // Execute all batch requests concurrently\n    const results = await Promise.all(\n      chunks.map(async (chunk) => {\n        const command = new BatchGetCommand({\n          RequestItems: {\n            [this.table.name]: { Keys: chunk },\n          },\n        });\n        const response = await this.client.send(command);\n        return response.Responses?.[this.table.name] ?? [];\n      })\n    );\n\n    // Merge all items from all responses\n    const mergedItems = results.flat();\n\n    // Convert each item to T using factory\n    const items = mergedItems.map((item) => this.factory.create(item));\n\n    // Sort if query.sortBy is specified\n    if (query && query.sortBy) {\n      const sortOrder = query.sortOrder ?? SORT_ASCENDING;\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      items.sort((a: any, b: any) => {\n        if (a[query.sortBy!] < b[query.sortBy!])\n          return sortOrder === SORT_ASCENDING ? -1 : 1;\n        if (a[query.sortBy!] > b[query.sortBy!])\n          return sortOrder === SORT_ASCENDING ? 1 : -1;\n        return 0;\n      });\n    }\n\n    return items;\n  }\n\n  async scan(\n    pagination?: QueryWithPagination,\n    filter?: ScanFilter\n  ): Promise<T[]> {\n    /**\n     * Internal state for pagination\n     * - lastEvaluatedKey tells DynamoDB where to resume from\n     * - currentPage helps us skip earlier pages\n     * - resultItems will store the final page’s items\n     */\n    let lastEvaluatedKey: Record<string, unknown> | undefined;\n    let currentPage = 1;\n    let resultItems: HashMap[] = [];\n\n    do {\n      /**\n       * Prepare the ScanCommand\n       * - Add pagination via Limit + ExclusiveStartKey\n       */\n      const command = new ScanCommand({\n        TableName: this.table.name,\n        ExclusiveStartKey: lastEvaluatedKey,\n      });\n\n      if (pagination) {\n        command.input.Limit = pagination.limit;\n      }\n\n      if (filter) {\n        command.input.FilterExpression = filter.filterExpression;\n        command.input.ExpressionAttributeNames =\n          filter.expressionAttributeNames;\n        command.input.ExpressionAttributeValues =\n          filter.expressionAttributeValues;\n      }\n\n      /**\n       * Execute the scan\n       */\n      const result = await this.client.send(command);\n\n      // Keep the pagination pointer (if DynamoDB says there’s more data)\n      lastEvaluatedKey = result.LastEvaluatedKey;\n\n      if (!pagination) {\n        // pagination is disabled, fetch until no results found\n        resultItems.push(...(result.Items ?? []));\n      } else if (currentPage === pagination.page) {\n        /**\n         * Once we reach the desired page, capture those items.\n         * DynamoDB doesn’t support direct page jumps — we simulate it by looping\n         * until we reach the correct page number.\n         */\n\n        resultItems = result.Items ?? [];\n        break; // Stop — we’ve collected the requested page\n      }\n\n      currentPage++; // Move to next page and continue querying\n    } while (lastEvaluatedKey);\n\n    /**\n     * Map each DynamoDB item into an instance of your model class (T)\n     */\n    return resultItems.map((item) => this.factory.create(item));\n  }\n\n  async deleteAll(hashKey: unknown): Promise<void> {\n    const items = await this.query(hashKey);\n    const keys = items.map((item) => {\n      if (this.table.keys.sortKey) {\n        return {\n          [this.table.keys.hashKey]: hashKey,\n          [this.table.keys.sortKey]:\n            item[this.table.keys.sortKey as keyof typeof item],\n        };\n      } else {\n        return {\n          [this.table.keys.hashKey]: hashKey,\n        };\n      }\n    });\n\n    await this.deleteInBulk(keys);\n  }\n\n  async deleteInBulk(keys: HashMap[]): Promise<void> {\n    const batches = [];\n    while (keys.length > 0) {\n      batches.push(keys.splice(0, BATCH_SIZE));\n    }\n\n    for (const batch of batches) {\n      // Create delete requests for each item in the batch\n      const deleteRequests = batch.map((key) => ({\n        DeleteRequest: { Key: key },\n      }));\n\n      // Execute the BatchWriteCommand\n      const command = new BatchWriteCommand({\n        RequestItems: {\n          [this.table.name]: deleteRequests,\n        },\n      });\n\n      try {\n        const response = await this.client.send(command);\n        debug('[INFO] Batch delete response:', response);\n\n        // Check if there are unprocessed items and retry them if necessary\n        if (\n          response.UnprocessedItems &&\n          response.UnprocessedItems[this.table.name]\n        ) {\n          debug('[WARN] Unprocessed items found. Retrying...');\n          const unprocessedItems = response.UnprocessedItems[this.table.name];\n          if (unprocessedItems === undefined) {\n            continue;\n          }\n          const unprocessedKeys = unprocessedItems\n            .map((item) => item.DeleteRequest?.Key)\n            .filter((key): key is Record<string, unknown> => key != null); // Filter out undefined keys\n\n          await this.deleteInBulk(unprocessedKeys);\n        }\n      } catch (error) {\n        debug('[ERROR] Error deleting items in batch:', error);\n      }\n    }\n  }\n\n  async get(id: ID): Promise<T | null> {\n    const command = new GetCommand({\n      TableName: this.table.name,\n      Key: this.getKey(id),\n    });\n\n    const result = await this.client.send(command);\n    return result.Item ? this.factory.create(result.Item) : null;\n  }\n\n  /**\n   * Allow to manipulate the data before saving\n   * @param item\n   * @returns\n   */\n  protected beforeSave(item: T): T {\n    if (isTimestamps(item)) {\n      item.updatedAt = now();\n    } else if (isTimestamp(item)) {\n      item.timestamp = now();\n    }\n\n    return item;\n  }\n\n  async save(item: T): Promise<T> {\n    item = this.beforeSave(item);\n    const command = new PutCommand({\n      TableName: this.table.name,\n      Item: { ...item },\n    });\n    await this.client.send(command);\n\n    return item;\n  }\n\n  async delete(id: ID): Promise<void | T> {\n    await this.client.send(\n      new DeleteCommand({\n        TableName: this.table.name,\n        Key: this.getKey(id),\n      })\n    );\n  }\n}\n","import { z } from 'zod';\nimport {\n  DeletableRepository,\n  HashMap,\n  ReadableRepository,\n  SavableRepository,\n} from '@opble/types';\n\nexport const TableKeychema = z.object({\n  hashKey: z.string(),\n  sortKey: z.union([z.string(), z.number()]).optional(),\n});\n\nexport const TableSpecSchema = z.object({\n  name: z.string(),\n  keys: z.object({\n    hashKey: z.string(),\n    sortKey: z.string().optional(),\n  }),\n});\n\nexport const QueryWithPaginationSchema = z.object({\n  page: z\n    .string()\n    .optional()\n    .transform((val) => (val ? parseInt(val, 10) : 1)) // default 1\n    .refine((val) => val >= 1, { message: 'Page must be at least 1' }),\n\n  limit: z\n    .string()\n    .optional()\n    .transform((val) => (val ? parseInt(val, 10) : 25)) // default 25\n    .refine((val) => val >= 5 && val <= 100, {\n      message: 'Limit must be between 5 and 100',\n    }),\n});\n\nexport const QueryWithSortingSchema = z.object({\n  sortBy: z.string().optional(),\n  sortOrder: z\n    .enum(['asc', 'desc'])\n    .optional()\n    .transform((val) => val ?? 'asc'),\n});\n\nexport const QueryAllSchema = z.object({\n  excludeSortKey: z.string().optional(),\n  sortKeyBetween: z\n    .object({\n      start: z.string(),\n      end: z.string(),\n    })\n    .optional(),\n  sortKeyBeginsWith: z.string().optional(),\n  sortKey: z.any().optional(),\n  index: TableSpecSchema.optional(),\n});\n\nexport const ScanFilterSchema = z.object({\n  filterExpression: z.string(),\n  expressionAttributeNames: z.record(z.string(), z.string()),\n  expressionAttributeValues: z.record(z.string(), z.any()),\n});\n\nexport type TableKey = z.infer<typeof TableKeychema>;\nexport type TableSpec = z.infer<typeof TableSpecSchema>;\n\nexport type QueryWithPagination = z.infer<typeof QueryWithPaginationSchema>;\nexport type QueryWithSorting = z.infer<typeof QueryWithSortingSchema>;\nexport type QueryAll = z.infer<typeof QueryAllSchema>;\nexport type ScanFilter = z.infer<typeof ScanFilterSchema>;\n\n/**\n * A generic repository interface specifically designed for DynamoDB operations.\n * It extends the basic CRUD repositories (Readable, Savable, Deletable) and adds\n * DynamoDB-specific methods for efficient querying, scanning, bulk operations,\n * and deletion patterns commonly used with DynamoDB's key structure.\n *\n * @template T - The type of the entity/document stored in DynamoDB (must be a HashMap / Record<string, unknown>)\n * @template ID - The type used to identify items. Defaults to `TableKey` (hash + optional sort key).\n */\nexport interface DynamoDBRepository<T extends HashMap, ID = TableKey>\n  extends\n    ReadableRepository<T, ID>,\n    SavableRepository<T>,\n    DeletableRepository<T, ID> {\n  /**\n   * Queries items using a partition key (hashKey) and optional sort key conditions.\n   * This is the most common and efficient way to read data from a DynamoDB table\n   * when you know the partition key.\n   *\n   * @param hashKey - The value of the partition key (hash key)\n   * @param query - Optional advanced query conditions for sort key (begins_with, between, specific value, etc.)\n   * @param pagination - Optional pagination parameters (page & limit)\n   * @param sorting - Optional sort direction (only 'sortOrder' is used)\n   * @returns Promise of array of matching items (T[])\n   *\n   * @example\n   * repo.query(\"user#123\", { sortKeyBeginsWith: \"order#\" }, { limit: 20 }, { sortOrder: \"desc\" })\n   */\n  query(\n    hashKey: unknown,\n    query?: QueryAll,\n    pagination?: QueryWithPagination,\n    sorting?: Pick<QueryWithSorting, 'sortOrder'>\n  ): Promise<T[]>;\n\n  /**\n   * Batch retrieves multiple items using their full composite keys (hash + sort).\n   * This method uses `BatchGetItem` under the hood — much more efficient than individual gets\n   * when fetching many items by primary key.\n   *\n   * @param keys - Array of objects containing at least `{ hashKey, sortKey? }`\n   * @param query - Optional sorting preferences (rarely used in batch get)\n   * @returns Promise of array of found items (in the order requested, missing items are omitted)\n   *\n   * @example\n   * repo.queryInBulk([\n   *   { hashKey: \"user#abc\", sortKey: \"profile\" },\n   *   { hashKey: \"user#abc\", sortKey: \"settings\" }\n   * ])\n   */\n  queryInBulk(keys: HashMap[], query?: QueryWithSorting): Promise<T[]>;\n\n  /**\n   * Performs a full table or index scan with optional filtering and pagination.\n   * Scans are less efficient than queries — use only when you cannot use a partition key.\n   *\n   * @param pagination - Optional page & limit controls\n   * @param filter - Optional raw filter expression (FilterExpression + attribute names/values)\n   * @returns Promise of array of matching items\n   *\n   * @warning Scans can be expensive and slow on large tables — prefer query() when possible\n   */\n  scan(pagination?: QueryWithPagination, filter?: ScanFilter): Promise<T[]>;\n\n  /**\n   * Deletes **all items** that share the same partition key (hashKey).\n   * Useful for cleaning up all records related to a specific entity (e.g. all orders of a user).\n   *\n   * @param hashKey - The partition key value whose items should be deleted\n   * @returns Promise that resolves when deletion is complete\n   *\n   * @warning This operation may consume many write capacity units if the partition is large.\n   * Consider using Query + BatchWriteItem in production for very large partitions.\n   */\n  deleteAll(hashKey: unknown): Promise<void>;\n\n  /**\n   * Deletes multiple items in a single BatchWriteItem call using their full keys.\n   * Most efficient way to delete many known items at once.\n   *\n   * @param keys - Array of objects with hashKey and sortKey\n   * @returns Promise that resolves when all deletions are complete\n   *\n   * @example\n   * repo.deleteInBulk([\n   *   { hashKey: \"user#123\", sortKey: \"session#abc123\" },\n   *   { hashKey: \"user#123\", sortKey: \"session#def456\" }\n   * ])\n   */\n  deleteInBulk(keys: HashMap[]): Promise<void>;\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,155 @@
+import { DynamoDBDocumentClient } from '@aws-sdk/lib-dynamodb';
+import { HashMap, ReadableRepository, SavableRepository, DeletableRepository, Factory } from '@opble/types';
+import { z } from 'zod';
+
+declare const TableKeychema: z.ZodObject<{
+    hashKey: z.ZodString;
+    sortKey: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+}, z.core.$strip>;
+declare const TableSpecSchema: z.ZodObject<{
+    name: z.ZodString;
+    keys: z.ZodObject<{
+        hashKey: z.ZodString;
+        sortKey: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+declare const QueryWithPaginationSchema: z.ZodObject<{
+    page: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<number, string | undefined>>;
+    limit: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<number, string | undefined>>;
+}, z.core.$strip>;
+declare const QueryWithSortingSchema: z.ZodObject<{
+    sortBy: z.ZodOptional<z.ZodString>;
+    sortOrder: z.ZodPipe<z.ZodOptional<z.ZodEnum<{
+        asc: "asc";
+        desc: "desc";
+    }>>, z.ZodTransform<"asc" | "desc", "asc" | "desc" | undefined>>;
+}, z.core.$strip>;
+declare const QueryAllSchema: z.ZodObject<{
+    excludeSortKey: z.ZodOptional<z.ZodString>;
+    sortKeyBetween: z.ZodOptional<z.ZodObject<{
+        start: z.ZodString;
+        end: z.ZodString;
+    }, z.core.$strip>>;
+    sortKeyBeginsWith: z.ZodOptional<z.ZodString>;
+    sortKey: z.ZodOptional<z.ZodAny>;
+    index: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        keys: z.ZodObject<{
+            hashKey: z.ZodString;
+            sortKey: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const ScanFilterSchema: z.ZodObject<{
+    filterExpression: z.ZodString;
+    expressionAttributeNames: z.ZodRecord<z.ZodString, z.ZodString>;
+    expressionAttributeValues: z.ZodRecord<z.ZodString, z.ZodAny>;
+}, z.core.$strip>;
+type TableKey = z.infer<typeof TableKeychema>;
+type TableSpec = z.infer<typeof TableSpecSchema>;
+type QueryWithPagination = z.infer<typeof QueryWithPaginationSchema>;
+type QueryWithSorting = z.infer<typeof QueryWithSortingSchema>;
+type QueryAll = z.infer<typeof QueryAllSchema>;
+type ScanFilter = z.infer<typeof ScanFilterSchema>;
+/**
+ * A generic repository interface specifically designed for DynamoDB operations.
+ * It extends the basic CRUD repositories (Readable, Savable, Deletable) and adds
+ * DynamoDB-specific methods for efficient querying, scanning, bulk operations,
+ * and deletion patterns commonly used with DynamoDB's key structure.
+ *
+ * @template T - The type of the entity/document stored in DynamoDB (must be a HashMap / Record<string, unknown>)
+ * @template ID - The type used to identify items. Defaults to `TableKey` (hash + optional sort key).
+ */
+interface DynamoDBRepository<T extends HashMap, ID = TableKey> extends ReadableRepository<T, ID>, SavableRepository<T>, DeletableRepository<T, ID> {
+    /**
+     * Queries items using a partition key (hashKey) and optional sort key conditions.
+     * This is the most common and efficient way to read data from a DynamoDB table
+     * when you know the partition key.
+     *
+     * @param hashKey - The value of the partition key (hash key)
+     * @param query - Optional advanced query conditions for sort key (begins_with, between, specific value, etc.)
+     * @param pagination - Optional pagination parameters (page & limit)
+     * @param sorting - Optional sort direction (only 'sortOrder' is used)
+     * @returns Promise of array of matching items (T[])
+     *
+     * @example
+     * repo.query("user#123", { sortKeyBeginsWith: "order#" }, { limit: 20 }, { sortOrder: "desc" })
+     */
+    query(hashKey: unknown, query?: QueryAll, pagination?: QueryWithPagination, sorting?: Pick<QueryWithSorting, 'sortOrder'>): Promise<T[]>;
+    /**
+     * Batch retrieves multiple items using their full composite keys (hash + sort).
+     * This method uses `BatchGetItem` under the hood — much more efficient than individual gets
+     * when fetching many items by primary key.
+     *
+     * @param keys - Array of objects containing at least `{ hashKey, sortKey? }`
+     * @param query - Optional sorting preferences (rarely used in batch get)
+     * @returns Promise of array of found items (in the order requested, missing items are omitted)
+     *
+     * @example
+     * repo.queryInBulk([
+     *   { hashKey: "user#abc", sortKey: "profile" },
+     *   { hashKey: "user#abc", sortKey: "settings" }
+     * ])
+     */
+    queryInBulk(keys: HashMap[], query?: QueryWithSorting): Promise<T[]>;
+    /**
+     * Performs a full table or index scan with optional filtering and pagination.
+     * Scans are less efficient than queries — use only when you cannot use a partition key.
+     *
+     * @param pagination - Optional page & limit controls
+     * @param filter - Optional raw filter expression (FilterExpression + attribute names/values)
+     * @returns Promise of array of matching items
+     *
+     * @warning Scans can be expensive and slow on large tables — prefer query() when possible
+     */
+    scan(pagination?: QueryWithPagination, filter?: ScanFilter): Promise<T[]>;
+    /**
+     * Deletes **all items** that share the same partition key (hashKey).
+     * Useful for cleaning up all records related to a specific entity (e.g. all orders of a user).
+     *
+     * @param hashKey - The partition key value whose items should be deleted
+     * @returns Promise that resolves when deletion is complete
+     *
+     * @warning This operation may consume many write capacity units if the partition is large.
+     * Consider using Query + BatchWriteItem in production for very large partitions.
+     */
+    deleteAll(hashKey: unknown): Promise<void>;
+    /**
+     * Deletes multiple items in a single BatchWriteItem call using their full keys.
+     * Most efficient way to delete many known items at once.
+     *
+     * @param keys - Array of objects with hashKey and sortKey
+     * @returns Promise that resolves when all deletions are complete
+     *
+     * @example
+     * repo.deleteInBulk([
+     *   { hashKey: "user#123", sortKey: "session#abc123" },
+     *   { hashKey: "user#123", sortKey: "session#def456" }
+     * ])
+     */
+    deleteInBulk(keys: HashMap[]): Promise<void>;
+}
+
+declare class AbstractDynamoDBRepository<T extends HashMap, ID extends TableKey = TableKey> implements DynamoDBRepository<T, ID> {
+    protected table: TableSpec;
+    protected factory: Factory<T>;
+    protected client: DynamoDBDocumentClient;
+    constructor(table: TableSpec, factory: Factory<T>);
+    protected getKey(id: ID): HashMap;
+    query(hashKey: unknown, query?: QueryAll, pagination?: QueryWithPagination, sorting?: Pick<QueryWithSorting, 'sortOrder'>): Promise<T[]>;
+    queryInBulk(keys: HashMap[], query?: QueryWithSorting): Promise<T[]>;
+    scan(pagination?: QueryWithPagination, filter?: ScanFilter): Promise<T[]>;
+    deleteAll(hashKey: unknown): Promise<void>;
+    deleteInBulk(keys: HashMap[]): Promise<void>;
+    get(id: ID): Promise<T | null>;
+    /**
+     * Allow to manipulate the data before saving
+     * @param item
+     * @returns
+     */
+    protected beforeSave(item: T): T;
+    save(item: T): Promise<T>;
+    delete(id: ID): Promise<void | T>;
+}
+
+export { AbstractDynamoDBRepository, type DynamoDBRepository, type QueryAll, QueryAllSchema, type QueryWithPagination, QueryWithPaginationSchema, type QueryWithSorting, QueryWithSortingSchema, type ScanFilter, ScanFilterSchema, type TableKey, TableKeychema, type TableSpec, TableSpecSchema };

package/dist/index.d.ts

@@ -0,0 +1,155 @@
+import { DynamoDBDocumentClient } from '@aws-sdk/lib-dynamodb';
+import { HashMap, ReadableRepository, SavableRepository, DeletableRepository, Factory } from '@opble/types';
+import { z } from 'zod';
+
+declare const TableKeychema: z.ZodObject<{
+    hashKey: z.ZodString;
+    sortKey: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+}, z.core.$strip>;
+declare const TableSpecSchema: z.ZodObject<{
+    name: z.ZodString;
+    keys: z.ZodObject<{
+        hashKey: z.ZodString;
+        sortKey: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+declare const QueryWithPaginationSchema: z.ZodObject<{
+    page: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<number, string | undefined>>;
+    limit: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<number, string | undefined>>;
+}, z.core.$strip>;
+declare const QueryWithSortingSchema: z.ZodObject<{
+    sortBy: z.ZodOptional<z.ZodString>;
+    sortOrder: z.ZodPipe<z.ZodOptional<z.ZodEnum<{
+        asc: "asc";
+        desc: "desc";
+    }>>, z.ZodTransform<"asc" | "desc", "asc" | "desc" | undefined>>;
+}, z.core.$strip>;
+declare const QueryAllSchema: z.ZodObject<{
+    excludeSortKey: z.ZodOptional<z.ZodString>;
+    sortKeyBetween: z.ZodOptional<z.ZodObject<{
+        start: z.ZodString;
+        end: z.ZodString;
+    }, z.core.$strip>>;
+    sortKeyBeginsWith: z.ZodOptional<z.ZodString>;
+    sortKey: z.ZodOptional<z.ZodAny>;
+    index: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        keys: z.ZodObject<{
+            hashKey: z.ZodString;
+            sortKey: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const ScanFilterSchema: z.ZodObject<{
+    filterExpression: z.ZodString;
+    expressionAttributeNames: z.ZodRecord<z.ZodString, z.ZodString>;
+    expressionAttributeValues: z.ZodRecord<z.ZodString, z.ZodAny>;
+}, z.core.$strip>;
+type TableKey = z.infer<typeof TableKeychema>;
+type TableSpec = z.infer<typeof TableSpecSchema>;
+type QueryWithPagination = z.infer<typeof QueryWithPaginationSchema>;
+type QueryWithSorting = z.infer<typeof QueryWithSortingSchema>;
+type QueryAll = z.infer<typeof QueryAllSchema>;
+type ScanFilter = z.infer<typeof ScanFilterSchema>;
+/**
+ * A generic repository interface specifically designed for DynamoDB operations.
+ * It extends the basic CRUD repositories (Readable, Savable, Deletable) and adds
+ * DynamoDB-specific methods for efficient querying, scanning, bulk operations,
+ * and deletion patterns commonly used with DynamoDB's key structure.
+ *
+ * @template T - The type of the entity/document stored in DynamoDB (must be a HashMap / Record<string, unknown>)
+ * @template ID - The type used to identify items. Defaults to `TableKey` (hash + optional sort key).
+ */
+interface DynamoDBRepository<T extends HashMap, ID = TableKey> extends ReadableRepository<T, ID>, SavableRepository<T>, DeletableRepository<T, ID> {
+    /**
+     * Queries items using a partition key (hashKey) and optional sort key conditions.
+     * This is the most common and efficient way to read data from a DynamoDB table
+     * when you know the partition key.
+     *
+     * @param hashKey - The value of the partition key (hash key)
+     * @param query - Optional advanced query conditions for sort key (begins_with, between, specific value, etc.)
+     * @param pagination - Optional pagination parameters (page & limit)
+     * @param sorting - Optional sort direction (only 'sortOrder' is used)
+     * @returns Promise of array of matching items (T[])
+     *
+     * @example
+     * repo.query("user#123", { sortKeyBeginsWith: "order#" }, { limit: 20 }, { sortOrder: "desc" })
+     */
+    query(hashKey: unknown, query?: QueryAll, pagination?: QueryWithPagination, sorting?: Pick<QueryWithSorting, 'sortOrder'>): Promise<T[]>;
+    /**
+     * Batch retrieves multiple items using their full composite keys (hash + sort).
+     * This method uses `BatchGetItem` under the hood — much more efficient than individual gets
+     * when fetching many items by primary key.
+     *
+     * @param keys - Array of objects containing at least `{ hashKey, sortKey? }`
+     * @param query - Optional sorting preferences (rarely used in batch get)
+     * @returns Promise of array of found items (in the order requested, missing items are omitted)
+     *
+     * @example
+     * repo.queryInBulk([
+     *   { hashKey: "user#abc", sortKey: "profile" },
+     *   { hashKey: "user#abc", sortKey: "settings" }
+     * ])
+     */
+    queryInBulk(keys: HashMap[], query?: QueryWithSorting): Promise<T[]>;
+    /**
+     * Performs a full table or index scan with optional filtering and pagination.
+     * Scans are less efficient than queries — use only when you cannot use a partition key.
+     *
+     * @param pagination - Optional page & limit controls
+     * @param filter - Optional raw filter expression (FilterExpression + attribute names/values)
+     * @returns Promise of array of matching items
+     *
+     * @warning Scans can be expensive and slow on large tables — prefer query() when possible
+     */
+    scan(pagination?: QueryWithPagination, filter?: ScanFilter): Promise<T[]>;
+    /**
+     * Deletes **all items** that share the same partition key (hashKey).
+     * Useful for cleaning up all records related to a specific entity (e.g. all orders of a user).
+     *
+     * @param hashKey - The partition key value whose items should be deleted
+     * @returns Promise that resolves when deletion is complete
+     *
+     * @warning This operation may consume many write capacity units if the partition is large.
+     * Consider using Query + BatchWriteItem in production for very large partitions.
+     */
+    deleteAll(hashKey: unknown): Promise<void>;
+    /**
+     * Deletes multiple items in a single BatchWriteItem call using their full keys.
+     * Most efficient way to delete many known items at once.
+     *
+     * @param keys - Array of objects with hashKey and sortKey
+     * @returns Promise that resolves when all deletions are complete
+     *
+     * @example
+     * repo.deleteInBulk([
+     *   { hashKey: "user#123", sortKey: "session#abc123" },
+     *   { hashKey: "user#123", sortKey: "session#def456" }
+     * ])
+     */
+    deleteInBulk(keys: HashMap[]): Promise<void>;
+}
+
+declare class AbstractDynamoDBRepository<T extends HashMap, ID extends TableKey = TableKey> implements DynamoDBRepository<T, ID> {
+    protected table: TableSpec;
+    protected factory: Factory<T>;
+    protected client: DynamoDBDocumentClient;
+    constructor(table: TableSpec, factory: Factory<T>);
+    protected getKey(id: ID): HashMap;
+    query(hashKey: unknown, query?: QueryAll, pagination?: QueryWithPagination, sorting?: Pick<QueryWithSorting, 'sortOrder'>): Promise<T[]>;
+    queryInBulk(keys: HashMap[], query?: QueryWithSorting): Promise<T[]>;
+    scan(pagination?: QueryWithPagination, filter?: ScanFilter): Promise<T[]>;
+    deleteAll(hashKey: unknown): Promise<void>;
+    deleteInBulk(keys: HashMap[]): Promise<void>;
+    get(id: ID): Promise<T | null>;
+    /**
+     * Allow to manipulate the data before saving
+     * @param item
+     * @returns
+     */
+    protected beforeSave(item: T): T;
+    save(item: T): Promise<T>;
+    delete(id: ID): Promise<void | T>;
+}
+
+export { AbstractDynamoDBRepository, type DynamoDBRepository, type QueryAll, QueryAllSchema, type QueryWithPagination, QueryWithPaginationSchema, type QueryWithSorting, QueryWithSortingSchema, type ScanFilter, ScanFilterSchema, type TableKey, TableKeychema, type TableSpec, TableSpecSchema };

package/dist/index.js

@@ -0,0 +1,300 @@
+// src/repository.ts
+import { DynamoDBClient } from "@aws-sdk/client-dynamodb";
+import {
+  BatchGetCommand,
+  BatchWriteCommand,
+  DeleteCommand,
+  DynamoDBDocumentClient,
+  GetCommand,
+  PutCommand,
+  QueryCommand,
+  ScanCommand
+} from "@aws-sdk/lib-dynamodb";
+import { createDebug } from "@opble/debug";
+import { isTimestamp, isTimestamps } from "@opble/entity";
+var debug = createDebug("opble:repository-dynamodb");
+var SORT_ASCENDING = "asc";
+var BATCH_SIZE = 50;
+function now() {
+  return Math.floor(Date.now() / 1e3);
+}
+var AbstractDynamoDBRepository = class {
+  constructor(table, factory) {
+    this.table = table;
+    this.factory = factory;
+    this.client = DynamoDBDocumentClient.from(new DynamoDBClient({}));
+  }
+  client;
+  getKey(id) {
+    return {
+      [this.table.keys.hashKey]: id.hashKey,
+      ...this.table.keys.sortKey ? { [this.table.keys.sortKey]: id.sortKey } : {}
+    };
+  }
+  async query(hashKey, query, pagination, sorting) {
+    let lastEvaluatedKey;
+    let currentPage = 1;
+    let resultItems = [];
+    const filterReturnedItemsExcludeSortKey = (items) => {
+      return query?.excludeSortKey && this.table.keys.sortKey ? items.filter(
+        (item) => item[this.table.keys.sortKey] !== query.excludeSortKey
+      ) : items;
+    };
+    do {
+      const command = new QueryCommand({
+        TableName: this.table.name,
+        KeyConditionExpression: `#${this.table.keys.hashKey} = :hashKeyValue`,
+        ExpressionAttributeNames: {
+          [`#${this.table.keys.hashKey}`]: this.table.keys.hashKey
+        },
+        ExpressionAttributeValues: {
+          ":hashKeyValue": hashKey
+        },
+        ExclusiveStartKey: lastEvaluatedKey
+      });
+      if (pagination) {
+        command.input.Limit = pagination.limit;
+      }
+      if (sorting) {
+        command.input.ScanIndexForward = sorting.sortOrder === "asc";
+      }
+      if (query) {
+        if (query.index) {
+          command.input.IndexName = query.index.name;
+          command.input.KeyConditionExpression = `#${query.index.keys.hashKey} = :hashKeyValue`;
+          command.input.ExpressionAttributeNames = {
+            [`#${query.index.keys.hashKey}`]: query.index.keys.hashKey
+          };
+        }
+        const sortKey = query.index?.keys.sortKey ?? this.table.keys.sortKey;
+        if (query.sortKeyBeginsWith && sortKey) {
+          command.input.KeyConditionExpression = `${command.input.KeyConditionExpression} AND begins_with(#${sortKey}, :sortKeyBeginsWith)`;
+          command.input.ExpressionAttributeNames ??= {};
+          command.input.ExpressionAttributeNames[`#${sortKey}`] = sortKey;
+          command.input.ExpressionAttributeValues ??= {};
+          command.input.ExpressionAttributeValues[":sortKeyBeginsWith"] = query.sortKeyBeginsWith;
+        } else if (query.sortKey && sortKey) {
+          command.input.KeyConditionExpression = `${command.input.KeyConditionExpression} AND #${sortKey} = :sortKeyValue`;
+          command.input.ExpressionAttributeNames ??= {};
+          command.input.ExpressionAttributeNames[`#${sortKey}`] = sortKey;
+          command.input.ExpressionAttributeValues ??= {};
+          command.input.ExpressionAttributeValues[":sortKeyValue"] = query.sortKey;
+        } else if (query.sortKeyBetween && sortKey) {
+          command.input.KeyConditionExpression = `${command.input.KeyConditionExpression} AND #${sortKey} BETWEEN :sortKeyStart AND :sortKeyEnd`;
+          command.input.ExpressionAttributeNames ??= {};
+          command.input.ExpressionAttributeNames[`#${sortKey}`] = sortKey;
+          command.input.ExpressionAttributeValues ??= {};
+          command.input.ExpressionAttributeValues[":sortKeyStart"] = query.sortKeyBetween.start;
+          command.input.ExpressionAttributeValues[":sortKeyEnd"] = query.sortKeyBetween.end;
+        }
+      }
+      debug("command#input", command.input);
+      const result = await this.client.send(command);
+      lastEvaluatedKey = result.LastEvaluatedKey;
+      if (!pagination) {
+        resultItems.push(
+          ...filterReturnedItemsExcludeSortKey(result.Items ?? [])
+        );
+      } else if (currentPage === pagination.page) {
+        resultItems = filterReturnedItemsExcludeSortKey(result.Items ?? []);
+        break;
+      }
+      currentPage++;
+    } while (lastEvaluatedKey);
+    const strict = !query || !query.index;
+    return resultItems.map((item) => this.factory.create(item, { strict }));
+  }
+  async queryInBulk(keys, query) {
+    const chunks = [];
+    for (let i = 0; i < keys.length; i += BATCH_SIZE) {
+      chunks.push(keys.slice(i, i + BATCH_SIZE));
+    }
+    const results = await Promise.all(
+      chunks.map(async (chunk) => {
+        const command = new BatchGetCommand({
+          RequestItems: {
+            [this.table.name]: { Keys: chunk }
+          }
+        });
+        const response = await this.client.send(command);
+        return response.Responses?.[this.table.name] ?? [];
+      })
+    );
+    const mergedItems = results.flat();
+    const items = mergedItems.map((item) => this.factory.create(item));
+    if (query && query.sortBy) {
+      const sortOrder = query.sortOrder ?? SORT_ASCENDING;
+      items.sort((a, b) => {
+        if (a[query.sortBy] < b[query.sortBy])
+          return sortOrder === SORT_ASCENDING ? -1 : 1;
+        if (a[query.sortBy] > b[query.sortBy])
+          return sortOrder === SORT_ASCENDING ? 1 : -1;
+        return 0;
+      });
+    }
+    return items;
+  }
+  async scan(pagination, filter) {
+    let lastEvaluatedKey;
+    let currentPage = 1;
+    let resultItems = [];
+    do {
+      const command = new ScanCommand({
+        TableName: this.table.name,
+        ExclusiveStartKey: lastEvaluatedKey
+      });
+      if (pagination) {
+        command.input.Limit = pagination.limit;
+      }
+      if (filter) {
+        command.input.FilterExpression = filter.filterExpression;
+        command.input.ExpressionAttributeNames = filter.expressionAttributeNames;
+        command.input.ExpressionAttributeValues = filter.expressionAttributeValues;
+      }
+      const result = await this.client.send(command);
+      lastEvaluatedKey = result.LastEvaluatedKey;
+      if (!pagination) {
+        resultItems.push(...result.Items ?? []);
+      } else if (currentPage === pagination.page) {
+        resultItems = result.Items ?? [];
+        break;
+      }
+      currentPage++;
+    } while (lastEvaluatedKey);
+    return resultItems.map((item) => this.factory.create(item));
+  }
+  async deleteAll(hashKey) {
+    const items = await this.query(hashKey);
+    const keys = items.map((item) => {
+      if (this.table.keys.sortKey) {
+        return {
+          [this.table.keys.hashKey]: hashKey,
+          [this.table.keys.sortKey]: item[this.table.keys.sortKey]
+        };
+      } else {
+        return {
+          [this.table.keys.hashKey]: hashKey
+        };
+      }
+    });
+    await this.deleteInBulk(keys);
+  }
+  async deleteInBulk(keys) {
+    const batches = [];
+    while (keys.length > 0) {
+      batches.push(keys.splice(0, BATCH_SIZE));
+    }
+    for (const batch of batches) {
+      const deleteRequests = batch.map((key) => ({
+        DeleteRequest: { Key: key }
+      }));
+      const command = new BatchWriteCommand({
+        RequestItems: {
+          [this.table.name]: deleteRequests
+        }
+      });
+      try {
+        const response = await this.client.send(command);
+        debug("[INFO] Batch delete response:", response);
+        if (response.UnprocessedItems && response.UnprocessedItems[this.table.name]) {
+          debug("[WARN] Unprocessed items found. Retrying...");
+          const unprocessedItems = response.UnprocessedItems[this.table.name];
+          if (unprocessedItems === void 0) {
+            continue;
+          }
+          const unprocessedKeys = unprocessedItems.map((item) => item.DeleteRequest?.Key).filter((key) => key != null);
+          await this.deleteInBulk(unprocessedKeys);
+        }
+      } catch (error) {
+        debug("[ERROR] Error deleting items in batch:", error);
+      }
+    }
+  }
+  async get(id) {
+    const command = new GetCommand({
+      TableName: this.table.name,
+      Key: this.getKey(id)
+    });
+    const result = await this.client.send(command);
+    return result.Item ? this.factory.create(result.Item) : null;
+  }
+  /**
+   * Allow to manipulate the data before saving
+   * @param item
+   * @returns
+   */
+  beforeSave(item) {
+    if (isTimestamps(item)) {
+      item.updatedAt = now();
+    } else if (isTimestamp(item)) {
+      item.timestamp = now();
+    }
+    return item;
+  }
+  async save(item) {
+    item = this.beforeSave(item);
+    const command = new PutCommand({
+      TableName: this.table.name,
+      Item: { ...item }
+    });
+    await this.client.send(command);
+    return item;
+  }
+  async delete(id) {
+    await this.client.send(
+      new DeleteCommand({
+        TableName: this.table.name,
+        Key: this.getKey(id)
+      })
+    );
+  }
+};
+
+// src/types.ts
+import { z } from "zod";
+var TableKeychema = z.object({
+  hashKey: z.string(),
+  sortKey: z.union([z.string(), z.number()]).optional()
+});
+var TableSpecSchema = z.object({
+  name: z.string(),
+  keys: z.object({
+    hashKey: z.string(),
+    sortKey: z.string().optional()
+  })
+});
+var QueryWithPaginationSchema = z.object({
+  page: z.string().optional().transform((val) => val ? parseInt(val, 10) : 1).refine((val) => val >= 1, { message: "Page must be at least 1" }),
+  limit: z.string().optional().transform((val) => val ? parseInt(val, 10) : 25).refine((val) => val >= 5 && val <= 100, {
+    message: "Limit must be between 5 and 100"
+  })
+});
+var QueryWithSortingSchema = z.object({
+  sortBy: z.string().optional(),
+  sortOrder: z.enum(["asc", "desc"]).optional().transform((val) => val ?? "asc")
+});
+var QueryAllSchema = z.object({
+  excludeSortKey: z.string().optional(),
+  sortKeyBetween: z.object({
+    start: z.string(),
+    end: z.string()
+  }).optional(),
+  sortKeyBeginsWith: z.string().optional(),
+  sortKey: z.any().optional(),
+  index: TableSpecSchema.optional()
+});
+var ScanFilterSchema = z.object({
+  filterExpression: z.string(),
+  expressionAttributeNames: z.record(z.string(), z.string()),
+  expressionAttributeValues: z.record(z.string(), z.any())
+});
+export {
+  AbstractDynamoDBRepository,
+  QueryAllSchema,
+  QueryWithPaginationSchema,
+  QueryWithSortingSchema,
+  ScanFilterSchema,
+  TableKeychema,
+  TableSpecSchema
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/repository.ts","../src/types.ts"],"sourcesContent":["import { DynamoDBClient } from '@aws-sdk/client-dynamodb';\nimport {\n  BatchGetCommand,\n  BatchWriteCommand,\n  DeleteCommand,\n  DynamoDBDocumentClient,\n  GetCommand,\n  PutCommand,\n  QueryCommand,\n  ScanCommand,\n} from '@aws-sdk/lib-dynamodb';\nimport { createDebug } from '@opble/debug';\nimport { Factory, HashMap } from '@opble/types';\nimport { isTimestamp, isTimestamps } from '@opble/entity';\nimport {\n  DynamoDBRepository,\n  QueryAll,\n  QueryWithPagination,\n  QueryWithSorting,\n  ScanFilter,\n  TableKey,\n  TableSpec,\n} from './types';\n\nconst debug = createDebug('opble:repository-dynamodb');\nconst SORT_ASCENDING = 'asc';\nconst BATCH_SIZE = 50;\n\nfunction now(): number {\n  return Math.floor(Date.now() / 1000);\n}\n\nexport class AbstractDynamoDBRepository<\n  T extends HashMap,\n  ID extends TableKey = TableKey,\n> implements DynamoDBRepository<T, ID> {\n  protected client: DynamoDBDocumentClient;\n\n  constructor(\n    protected table: TableSpec,\n    protected factory: Factory<T>\n  ) {\n    this.client = DynamoDBDocumentClient.from(new DynamoDBClient({}));\n  }\n\n  protected getKey(id: ID): HashMap {\n    return {\n      [this.table.keys.hashKey]: id.hashKey,\n      ...(this.table.keys.sortKey\n        ? { [this.table.keys.sortKey]: id.sortKey }\n        : {}),\n    };\n  }\n\n  async query(\n    hashKey: unknown,\n    query?: QueryAll,\n    pagination?: QueryWithPagination,\n    sorting?: Pick<QueryWithSorting, 'sortOrder'>\n  ): Promise<T[]> {\n    /**\n     * Internal state for pagination\n     * - lastEvaluatedKey tells DynamoDB where to resume from\n     * - currentPage helps us skip earlier pages\n     * - resultItems will store the final page’s items\n     */\n    let lastEvaluatedKey: Record<string, unknown> | undefined;\n    let currentPage = 1;\n    let resultItems: HashMap[] = [];\n    const filterReturnedItemsExcludeSortKey = (items: HashMap[]) => {\n      /**\n       * Business rule: Exclude a specific sortKey (if requested)\n       * This is used to skip “parent” or “header” records within the same partition.\n       */\n      return query?.excludeSortKey && this.table.keys.sortKey\n        ? items.filter(\n            (item) => item[this.table.keys.sortKey!] !== query.excludeSortKey\n          )\n        : items;\n    };\n\n    do {\n      /**\n       * Prepare the QueryCommand\n       * - Basic condition: match all items with the given hash key\n       * - Add pagination via Limit + ExclusiveStartKey\n       */\n      const command = new QueryCommand({\n        TableName: this.table.name,\n        KeyConditionExpression: `#${this.table.keys.hashKey} = :hashKeyValue`,\n        ExpressionAttributeNames: {\n          [`#${this.table.keys.hashKey}`]: this.table.keys.hashKey,\n        },\n        ExpressionAttributeValues: {\n          ':hashKeyValue': hashKey,\n        },\n        ExclusiveStartKey: lastEvaluatedKey,\n      });\n\n      if (pagination) {\n        command.input.Limit = pagination.limit;\n      }\n      if (sorting) {\n        command.input.ScanIndexForward = sorting.sortOrder === 'asc';\n      }\n\n      /**\n       * Apply optional filters if provided\n       */\n      if (query) {\n        // If querying a secondary index\n        if (query.index) {\n          command.input.IndexName = query.index.name;\n          command.input.KeyConditionExpression = `#${query.index.keys.hashKey} = :hashKeyValue`;\n          command.input.ExpressionAttributeNames = {\n            [`#${query.index.keys.hashKey}`]: query.index.keys.hashKey,\n          };\n        }\n\n        // If we want to match only sort keys starting with a specific prefix\n        const sortKey = query.index?.keys.sortKey ?? this.table.keys.sortKey;\n        if (query.sortKeyBeginsWith && sortKey) {\n          command.input.KeyConditionExpression = `${command.input.KeyConditionExpression} AND begins_with(#${sortKey}, :sortKeyBeginsWith)`;\n          command.input.ExpressionAttributeNames ??= {};\n          command.input.ExpressionAttributeNames[`#${sortKey}`] = sortKey;\n          command.input.ExpressionAttributeValues ??= {};\n          command.input.ExpressionAttributeValues[':sortKeyBeginsWith'] =\n            query.sortKeyBeginsWith;\n        } else if (query.sortKey && sortKey) {\n          command.input.KeyConditionExpression = `${command.input.KeyConditionExpression} AND #${sortKey} = :sortKeyValue`;\n          command.input.ExpressionAttributeNames ??= {};\n          command.input.ExpressionAttributeNames[`#${sortKey}`] = sortKey;\n          command.input.ExpressionAttributeValues ??= {};\n          command.input.ExpressionAttributeValues[':sortKeyValue'] =\n            query.sortKey;\n        } else if (query.sortKeyBetween && sortKey) {\n          command.input.KeyConditionExpression = `${command.input.KeyConditionExpression} AND #${sortKey} BETWEEN :sortKeyStart AND :sortKeyEnd`;\n          command.input.ExpressionAttributeNames ??= {};\n          command.input.ExpressionAttributeNames[`#${sortKey}`] = sortKey;\n          command.input.ExpressionAttributeValues ??= {};\n          command.input.ExpressionAttributeValues[':sortKeyStart'] =\n            query.sortKeyBetween.start;\n          command.input.ExpressionAttributeValues[':sortKeyEnd'] =\n            query.sortKeyBetween.end;\n        }\n      }\n      debug('command#input', command.input);\n\n      // Execute the query\n      const result = await this.client.send(command);\n\n      // Keep the pagination pointer (if DynamoDB says there’s more data)\n      lastEvaluatedKey = result.LastEvaluatedKey;\n\n      if (!pagination) {\n        // pagination is disabled, fetch until no results found\n        resultItems.push(\n          ...filterReturnedItemsExcludeSortKey(result.Items ?? [])\n        );\n      } else if (currentPage === pagination.page) {\n        /**\n         * Once we reach the desired page, capture those items.\n         * DynamoDB doesn’t support direct page jumps — we simulate it by looping\n         * until we reach the correct page number.\n         */\n\n        resultItems = filterReturnedItemsExcludeSortKey(result.Items ?? []);\n        break; // Stop — we’ve collected the requested page\n      }\n\n      currentPage++; // Move to next page and continue querying\n    } while (lastEvaluatedKey);\n\n    /**\n     * Map each DynamoDB item into an instance of your model class (T)\n     * When querrying with index, turn strict to false\n     */\n    const strict = !query || !query.index;\n    return resultItems.map((item) => this.factory.create(item, { strict }));\n  }\n\n  async queryInBulk(keys: HashMap[], query?: QueryWithSorting): Promise<T[]> {\n    // Split keys into chunks of BATCH_SIZE (DynamoDB BatchGet limit)\n    const chunks: HashMap[][] = [];\n    for (let i = 0; i < keys.length; i += BATCH_SIZE) {\n      chunks.push(keys.slice(i, i + BATCH_SIZE));\n    }\n\n    // Execute all batch requests concurrently\n    const results = await Promise.all(\n      chunks.map(async (chunk) => {\n        const command = new BatchGetCommand({\n          RequestItems: {\n            [this.table.name]: { Keys: chunk },\n          },\n        });\n        const response = await this.client.send(command);\n        return response.Responses?.[this.table.name] ?? [];\n      })\n    );\n\n    // Merge all items from all responses\n    const mergedItems = results.flat();\n\n    // Convert each item to T using factory\n    const items = mergedItems.map((item) => this.factory.create(item));\n\n    // Sort if query.sortBy is specified\n    if (query && query.sortBy) {\n      const sortOrder = query.sortOrder ?? SORT_ASCENDING;\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      items.sort((a: any, b: any) => {\n        if (a[query.sortBy!] < b[query.sortBy!])\n          return sortOrder === SORT_ASCENDING ? -1 : 1;\n        if (a[query.sortBy!] > b[query.sortBy!])\n          return sortOrder === SORT_ASCENDING ? 1 : -1;\n        return 0;\n      });\n    }\n\n    return items;\n  }\n\n  async scan(\n    pagination?: QueryWithPagination,\n    filter?: ScanFilter\n  ): Promise<T[]> {\n    /**\n     * Internal state for pagination\n     * - lastEvaluatedKey tells DynamoDB where to resume from\n     * - currentPage helps us skip earlier pages\n     * - resultItems will store the final page’s items\n     */\n    let lastEvaluatedKey: Record<string, unknown> | undefined;\n    let currentPage = 1;\n    let resultItems: HashMap[] = [];\n\n    do {\n      /**\n       * Prepare the ScanCommand\n       * - Add pagination via Limit + ExclusiveStartKey\n       */\n      const command = new ScanCommand({\n        TableName: this.table.name,\n        ExclusiveStartKey: lastEvaluatedKey,\n      });\n\n      if (pagination) {\n        command.input.Limit = pagination.limit;\n      }\n\n      if (filter) {\n        command.input.FilterExpression = filter.filterExpression;\n        command.input.ExpressionAttributeNames =\n          filter.expressionAttributeNames;\n        command.input.ExpressionAttributeValues =\n          filter.expressionAttributeValues;\n      }\n\n      /**\n       * Execute the scan\n       */\n      const result = await this.client.send(command);\n\n      // Keep the pagination pointer (if DynamoDB says there’s more data)\n      lastEvaluatedKey = result.LastEvaluatedKey;\n\n      if (!pagination) {\n        // pagination is disabled, fetch until no results found\n        resultItems.push(...(result.Items ?? []));\n      } else if (currentPage === pagination.page) {\n        /**\n         * Once we reach the desired page, capture those items.\n         * DynamoDB doesn’t support direct page jumps — we simulate it by looping\n         * until we reach the correct page number.\n         */\n\n        resultItems = result.Items ?? [];\n        break; // Stop — we’ve collected the requested page\n      }\n\n      currentPage++; // Move to next page and continue querying\n    } while (lastEvaluatedKey);\n\n    /**\n     * Map each DynamoDB item into an instance of your model class (T)\n     */\n    return resultItems.map((item) => this.factory.create(item));\n  }\n\n  async deleteAll(hashKey: unknown): Promise<void> {\n    const items = await this.query(hashKey);\n    const keys = items.map((item) => {\n      if (this.table.keys.sortKey) {\n        return {\n          [this.table.keys.hashKey]: hashKey,\n          [this.table.keys.sortKey]:\n            item[this.table.keys.sortKey as keyof typeof item],\n        };\n      } else {\n        return {\n          [this.table.keys.hashKey]: hashKey,\n        };\n      }\n    });\n\n    await this.deleteInBulk(keys);\n  }\n\n  async deleteInBulk(keys: HashMap[]): Promise<void> {\n    const batches = [];\n    while (keys.length > 0) {\n      batches.push(keys.splice(0, BATCH_SIZE));\n    }\n\n    for (const batch of batches) {\n      // Create delete requests for each item in the batch\n      const deleteRequests = batch.map((key) => ({\n        DeleteRequest: { Key: key },\n      }));\n\n      // Execute the BatchWriteCommand\n      const command = new BatchWriteCommand({\n        RequestItems: {\n          [this.table.name]: deleteRequests,\n        },\n      });\n\n      try {\n        const response = await this.client.send(command);\n        debug('[INFO] Batch delete response:', response);\n\n        // Check if there are unprocessed items and retry them if necessary\n        if (\n          response.UnprocessedItems &&\n          response.UnprocessedItems[this.table.name]\n        ) {\n          debug('[WARN] Unprocessed items found. Retrying...');\n          const unprocessedItems = response.UnprocessedItems[this.table.name];\n          if (unprocessedItems === undefined) {\n            continue;\n          }\n          const unprocessedKeys = unprocessedItems\n            .map((item) => item.DeleteRequest?.Key)\n            .filter((key): key is Record<string, unknown> => key != null); // Filter out undefined keys\n\n          await this.deleteInBulk(unprocessedKeys);\n        }\n      } catch (error) {\n        debug('[ERROR] Error deleting items in batch:', error);\n      }\n    }\n  }\n\n  async get(id: ID): Promise<T | null> {\n    const command = new GetCommand({\n      TableName: this.table.name,\n      Key: this.getKey(id),\n    });\n\n    const result = await this.client.send(command);\n    return result.Item ? this.factory.create(result.Item) : null;\n  }\n\n  /**\n   * Allow to manipulate the data before saving\n   * @param item\n   * @returns\n   */\n  protected beforeSave(item: T): T {\n    if (isTimestamps(item)) {\n      item.updatedAt = now();\n    } else if (isTimestamp(item)) {\n      item.timestamp = now();\n    }\n\n    return item;\n  }\n\n  async save(item: T): Promise<T> {\n    item = this.beforeSave(item);\n    const command = new PutCommand({\n      TableName: this.table.name,\n      Item: { ...item },\n    });\n    await this.client.send(command);\n\n    return item;\n  }\n\n  async delete(id: ID): Promise<void | T> {\n    await this.client.send(\n      new DeleteCommand({\n        TableName: this.table.name,\n        Key: this.getKey(id),\n      })\n    );\n  }\n}\n","import { z } from 'zod';\nimport {\n  DeletableRepository,\n  HashMap,\n  ReadableRepository,\n  SavableRepository,\n} from '@opble/types';\n\nexport const TableKeychema = z.object({\n  hashKey: z.string(),\n  sortKey: z.union([z.string(), z.number()]).optional(),\n});\n\nexport const TableSpecSchema = z.object({\n  name: z.string(),\n  keys: z.object({\n    hashKey: z.string(),\n    sortKey: z.string().optional(),\n  }),\n});\n\nexport const QueryWithPaginationSchema = z.object({\n  page: z\n    .string()\n    .optional()\n    .transform((val) => (val ? parseInt(val, 10) : 1)) // default 1\n    .refine((val) => val >= 1, { message: 'Page must be at least 1' }),\n\n  limit: z\n    .string()\n    .optional()\n    .transform((val) => (val ? parseInt(val, 10) : 25)) // default 25\n    .refine((val) => val >= 5 && val <= 100, {\n      message: 'Limit must be between 5 and 100',\n    }),\n});\n\nexport const QueryWithSortingSchema = z.object({\n  sortBy: z.string().optional(),\n  sortOrder: z\n    .enum(['asc', 'desc'])\n    .optional()\n    .transform((val) => val ?? 'asc'),\n});\n\nexport const QueryAllSchema = z.object({\n  excludeSortKey: z.string().optional(),\n  sortKeyBetween: z\n    .object({\n      start: z.string(),\n      end: z.string(),\n    })\n    .optional(),\n  sortKeyBeginsWith: z.string().optional(),\n  sortKey: z.any().optional(),\n  index: TableSpecSchema.optional(),\n});\n\nexport const ScanFilterSchema = z.object({\n  filterExpression: z.string(),\n  expressionAttributeNames: z.record(z.string(), z.string()),\n  expressionAttributeValues: z.record(z.string(), z.any()),\n});\n\nexport type TableKey = z.infer<typeof TableKeychema>;\nexport type TableSpec = z.infer<typeof TableSpecSchema>;\n\nexport type QueryWithPagination = z.infer<typeof QueryWithPaginationSchema>;\nexport type QueryWithSorting = z.infer<typeof QueryWithSortingSchema>;\nexport type QueryAll = z.infer<typeof QueryAllSchema>;\nexport type ScanFilter = z.infer<typeof ScanFilterSchema>;\n\n/**\n * A generic repository interface specifically designed for DynamoDB operations.\n * It extends the basic CRUD repositories (Readable, Savable, Deletable) and adds\n * DynamoDB-specific methods for efficient querying, scanning, bulk operations,\n * and deletion patterns commonly used with DynamoDB's key structure.\n *\n * @template T - The type of the entity/document stored in DynamoDB (must be a HashMap / Record<string, unknown>)\n * @template ID - The type used to identify items. Defaults to `TableKey` (hash + optional sort key).\n */\nexport interface DynamoDBRepository<T extends HashMap, ID = TableKey>\n  extends\n    ReadableRepository<T, ID>,\n    SavableRepository<T>,\n    DeletableRepository<T, ID> {\n  /**\n   * Queries items using a partition key (hashKey) and optional sort key conditions.\n   * This is the most common and efficient way to read data from a DynamoDB table\n   * when you know the partition key.\n   *\n   * @param hashKey - The value of the partition key (hash key)\n   * @param query - Optional advanced query conditions for sort key (begins_with, between, specific value, etc.)\n   * @param pagination - Optional pagination parameters (page & limit)\n   * @param sorting - Optional sort direction (only 'sortOrder' is used)\n   * @returns Promise of array of matching items (T[])\n   *\n   * @example\n   * repo.query(\"user#123\", { sortKeyBeginsWith: \"order#\" }, { limit: 20 }, { sortOrder: \"desc\" })\n   */\n  query(\n    hashKey: unknown,\n    query?: QueryAll,\n    pagination?: QueryWithPagination,\n    sorting?: Pick<QueryWithSorting, 'sortOrder'>\n  ): Promise<T[]>;\n\n  /**\n   * Batch retrieves multiple items using their full composite keys (hash + sort).\n   * This method uses `BatchGetItem` under the hood — much more efficient than individual gets\n   * when fetching many items by primary key.\n   *\n   * @param keys - Array of objects containing at least `{ hashKey, sortKey? }`\n   * @param query - Optional sorting preferences (rarely used in batch get)\n   * @returns Promise of array of found items (in the order requested, missing items are omitted)\n   *\n   * @example\n   * repo.queryInBulk([\n   *   { hashKey: \"user#abc\", sortKey: \"profile\" },\n   *   { hashKey: \"user#abc\", sortKey: \"settings\" }\n   * ])\n   */\n  queryInBulk(keys: HashMap[], query?: QueryWithSorting): Promise<T[]>;\n\n  /**\n   * Performs a full table or index scan with optional filtering and pagination.\n   * Scans are less efficient than queries — use only when you cannot use a partition key.\n   *\n   * @param pagination - Optional page & limit controls\n   * @param filter - Optional raw filter expression (FilterExpression + attribute names/values)\n   * @returns Promise of array of matching items\n   *\n   * @warning Scans can be expensive and slow on large tables — prefer query() when possible\n   */\n  scan(pagination?: QueryWithPagination, filter?: ScanFilter): Promise<T[]>;\n\n  /**\n   * Deletes **all items** that share the same partition key (hashKey).\n   * Useful for cleaning up all records related to a specific entity (e.g. all orders of a user).\n   *\n   * @param hashKey - The partition key value whose items should be deleted\n   * @returns Promise that resolves when deletion is complete\n   *\n   * @warning This operation may consume many write capacity units if the partition is large.\n   * Consider using Query + BatchWriteItem in production for very large partitions.\n   */\n  deleteAll(hashKey: unknown): Promise<void>;\n\n  /**\n   * Deletes multiple items in a single BatchWriteItem call using their full keys.\n   * Most efficient way to delete many known items at once.\n   *\n   * @param keys - Array of objects with hashKey and sortKey\n   * @returns Promise that resolves when all deletions are complete\n   *\n   * @example\n   * repo.deleteInBulk([\n   *   { hashKey: \"user#123\", sortKey: \"session#abc123\" },\n   *   { hashKey: \"user#123\", sortKey: \"session#def456\" }\n   * ])\n   */\n  deleteInBulk(keys: HashMap[]): Promise<void>;\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@opble/repository-dynamodb",
+  "description": "Provide DynamoDB repository implementation.",
+  "version": "1.0.0",
+  "license": "UNLICENSED",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "import": "./dist/index.js",
+    "require": "./dist/index.cjs"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/opble/node-packages.git",
+    "directory": "packages/repository-dynamodb"
+  },
+  "keywords": [
+    "opble",
+    "dynamodb",
+    "repository"
+  ],
+  "bugs": {
+    "url": "https://github.com/opble/node-packages/issues"
+  },
+  "homepage": "https://github.com/opble/node-packages#readme",
+  "publishConfig": {
+    "access": "public",
+    "provenance": false
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "devDependencies": {
+    "@opble/typescript-config": "0.0.0",
+    "@opble/eslint-config": "0.0.0"
+  },
+  "dependencies": {
+    "@aws-sdk/client-dynamodb": "^3.971.0",
+    "@aws-sdk/lib-dynamodb": "^3.971.0",
+    "@opble/debug": "^1.0.0",
+    "@opble/entity": "^1.0.0",
+    "@opble/types": "^1.3.0",
+    "zod": "^4.3.5"
+  },
+  "scripts": {
+    "build": "tsup",
+    "clean": "rm -rf dist",
+    "lint": "eslint \"src/**/*.ts*\" --max-warnings 0",
+    "test": "true"
+  }
+}