aws-service-stack 0.18.421 → 0.18.425

package/dist/service/crud-operations.js

@@ -0,0 +1,459 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenSearchOperations = exports.DynamoScanOperations = exports.DynamoFindOperations = exports.DynamoWriteOperations = void 0;
+const index_1 = require("../index");
+const exception_1 = require("../exception");
+const opensearch_parser_1 = require("../utils/opensearch/opensearch.parser");
+const dayjs_1 = __importDefault(require("dayjs"));
+/**
+ * Maps public owner aliases to the entity-specific owner field names.
+ */
+function parseOwnerFields(filter, entityConfig) {
+    if (!filter)
+        return null;
+    const parsedFilter = filter;
+    log.debug("input filter", parsedFilter);
+    if (parsedFilter.ownerParentId && !entityConfig.OWNER_PARENT_ID_FIELD_NAME) {
+        parsedFilter.profileId = parsedFilter.ownerParentId;
+        delete parsedFilter.ownerParentId;
+    }
+    if (!parsedFilter.profileId)
+        delete parsedFilter.profileId;
+    if (parsedFilter.ownerParentId && entityConfig.OWNER_PARENT_ID_FIELD_NAME) {
+        parsedFilter[entityConfig.OWNER_PARENT_ID_FIELD_NAME] = parsedFilter.ownerParentId;
+        if (entityConfig.OWNER_PARENT_ID_FIELD_NAME !== "ownerParentId")
+            delete parsedFilter.ownerParentId;
+    }
+    if (parsedFilter.profileId && entityConfig.OWNER_ID_FIELD_NAME) {
+        parsedFilter[entityConfig.OWNER_ID_FIELD_NAME] = parsedFilter.profileId;
+        if (entityConfig.OWNER_ID_FIELD_NAME !== "profileId")
+            delete parsedFilter.profileId;
+    }
+    if (parsedFilter.ownerId && entityConfig.OWNER_ID_FIELD_NAME) {
+        parsedFilter[entityConfig.OWNER_ID_FIELD_NAME] = parsedFilter.ownerId;
+        if (entityConfig.OWNER_ID_FIELD_NAME !== "ownerId")
+            delete parsedFilter.ownerId;
+    }
+    log.debug("parsedFilter", parsedFilter);
+    return parsedFilter;
+}
+class DynamoWriteOperations {
+    repoDB;
+    config;
+    constructor(repoDB, config) {
+        this.repoDB = repoDB;
+        this.config = config;
+    }
+    deleteFields(entityId, fields) {
+        return this.repoDB.deleteFields(entityId, fields);
+    }
+    incrementValueByField(entityId, fieldName, value) {
+        return this.repoDB.incrementValueByField(entityId, fieldName, value);
+    }
+    decrementValueByField(entityId, fieldName, value) {
+        return this.repoDB.decrementValueByField(entityId, fieldName, value);
+    }
+    async save(entity, ownerId, parentId, createdByUser) {
+        entity = this.setSystemData(entity, index_1.Action.CREATE, createdByUser);
+        if (ownerId && this.config.OWNER_ID_FIELD_NAME)
+            entity[this.config.OWNER_ID_FIELD_NAME] = ownerId;
+        if (parentId && this.config.OWNER_PARENT_ID_FIELD_NAME)
+            entity[this.config.OWNER_PARENT_ID_FIELD_NAME] = parentId;
+        return this.repoDB.save(entity);
+    }
+    async saveAll(entities, ownerId, parentId, createdByUser, isTransactional) {
+        const entitiesUpdated = [];
+        for (const item of entities) {
+            const entity = this.setSystemData(item, index_1.Action.CREATE, createdByUser || ownerId);
+            if (parentId && this.config.OWNER_PARENT_ID_FIELD_NAME)
+                entity[this.config.OWNER_PARENT_ID_FIELD_NAME] = parentId;
+            if (ownerId && this.config.OWNER_ID_FIELD_NAME)
+                entity[this.config.OWNER_ID_FIELD_NAME] = ownerId;
+            entitiesUpdated.push(entity);
+        }
+        return this.repoDB.saveMany(entitiesUpdated, isTransactional);
+    }
+    async update(entity, requestUser, fields) {
+        const fieldName = this.config.DYNAMO_DB?.MAP?.partitionKey ?? "id";
+        if (fields && fields.length > 0)
+            fields.push(fieldName);
+        if (fields && fields.length > 0)
+            entity = (0, index_1.removeFields)([entity], fields)[0];
+        if (!entity || !entity[fieldName])
+            throw new exception_1.ErrorHttp(exception_1.HTTP.BAD_REQUEST, `id required`);
+        const item = await this.repoDB.findById(entity[fieldName]);
+        if (!entity || !item)
+            throw new exception_1.ErrorHttp(exception_1.HTTP.BAD_REQUEST, `id not found`);
+        if (requestUser &&
+            !requestUser.isScope &&
+            !requestUser.isAdmin &&
+            (item[this.config.OWNER_ID_FIELD_NAME] !== requestUser.profile ||
+                item[this.config.OWNER_PARENT_ID_FIELD_NAME] !== requestUser.parentId))
+            throw new exception_1.ErrorHttp(exception_1.HTTP.FORBIDDEN, `No permission to resource: ${entity.id}`);
+        entity = this.setSystemData(entity, index_1.Action.UPDATE, requestUser, item);
+        return this.repoDB.update(entity);
+    }
+    updateAll(entities, fields, requestUser, isTransactional) {
+        if (requestUser)
+            log.warn("this methode is under development, cannot check ownership by updateAll");
+        return this.repoDB.updateMany(entities, fields, isTransactional);
+    }
+    updateFields(entity, fields) {
+        if (!entity || !fields?.length)
+            return Promise.resolve(entity);
+        return this.repoDB.updateFields(entity, [...fields]);
+    }
+    async remove(entityId, requestUser) {
+        if (!entityId)
+            throw new Error("Entity id required");
+        if (requestUser && requestUser.isAdmin)
+            return this.repoDB.delete(entityId);
+        const entity = await this.repoDB.findById(entityId);
+        if (!entity)
+            throw new Error("Entity not found");
+        if (requestUser &&
+            !requestUser.isScope &&
+            (entity[this.config.OWNER_ID_FIELD_NAME] !== requestUser.profile ||
+                entity[this.config.OWNER_PARENT_ID_FIELD_NAME] !== requestUser.parentId))
+            throw new exception_1.ErrorHttp(exception_1.HTTP.FORBIDDEN, `No permission to resource: ${entity.id}`);
+        return this.repoDB.delete(entityId);
+    }
+    removeAll(entityIds, requestUser) {
+        if (requestUser)
+            log.warn("this methode is under development, cannot check ownership by removeAll");
+        return this.repoDB.deleteMany(entityIds);
+    }
+    async changeOwner(entityId, ownerId) {
+        const entity = await this.repoDB.findById(entityId);
+        entity[this.config.OWNER_ID_FIELD_NAME] = ownerId;
+        return this.repoDB.update(entity);
+    }
+    async findById(entityId, requestUser) {
+        const entity = await this.repoDB.findById(entityId);
+        if (!entity)
+            return null;
+        if (!requestUser || requestUser.isAdmin)
+            return entity;
+        const isOwnerParent = entity[this.config.OWNER_PARENT_ID_FIELD_NAME] == requestUser.profile;
+        const isParent = entity[this.config.OWNER_ID_FIELD_NAME] == requestUser.profile;
+        if (!requestUser.profile || isOwnerParent || isParent)
+            return entity;
+        return null;
+    }
+    async findByIds(entityIds, requestUser) {
+        if (entityIds.length > 25)
+            throw new exception_1.ErrorDynamoDB(this.repoDB.getTableName(), "findByIds", "Too many entities");
+        const entities = await this.repoDB.findByIds(entityIds);
+        if (!requestUser || requestUser.isAdmin)
+            return entities;
+        const ownEntities = [];
+        for (const entity of entities) {
+            if (entity[this.config.OWNER_PARENT_ID_FIELD_NAME] == requestUser.profile ||
+                entity[this.config.OWNER_ID_FIELD_NAME] == requestUser.profile) {
+                ownEntities.push(entity);
+            }
+        }
+        return ownEntities;
+    }
+    /**
+     * Applies generated id, timestamps, audit user, and optional change history.
+     */
+    setSystemData(itemNew, action, requestUser, itemOld) {
+        if (!action || action === index_1.Action.DELETE || action === index_1.Action.READ)
+            return itemNew;
+        const date = (0, dayjs_1.default)().toISOString();
+        const user = this.extractUser(requestUser);
+        switch (action) {
+            case index_1.Action.CREATE:
+                return this.handleCreate(itemNew, user, date);
+            case index_1.Action.UPDATE:
+                return this.handleUpdate(itemNew, itemOld, user, date);
+            default:
+                return itemNew;
+        }
+    }
+    /**
+     * Normalizes a raw username or Cognito user into a stored audit username.
+     */
+    extractUser(requestUser) {
+        if (!requestUser)
+            return undefined;
+        if (typeof requestUser === "string")
+            return requestUser;
+        return requestUser.username;
+    }
+    /**
+     * Populates system fields that are required when creating an entity.
+     */
+    handleCreate(entity, user, date) {
+        const dayjsData = (0, dayjs_1.default)(new Date(date));
+        const noIdExist = entity[this.config.DYNAMO_DB.MAP.partitionKey ?? "id"] === undefined;
+        if (noIdExist)
+            entity[this.config.DYNAMO_DB.MAP.partitionKey ?? "id"] = crypto.randomUUID();
+        entity.createdAt = date;
+        if (user)
+            entity.createdBy = user;
+        entity.year = dayjsData.year().toString();
+        entity.yearMonth = dayjsData.format("YYYY-MM");
+        if (!entity.updatedAt) {
+            entity.updatedAt = entity.createdAt;
+        }
+        if (!this.config.TRACE_CHANGE?.fields)
+            return entity;
+        entity.history = this.addHistory(entity.history, { action: index_1.Action.CREATE, user, date });
+        return entity;
+    }
+    /**
+     * Populates update metadata and records traced field changes when configured.
+     */
+    handleUpdate(entity, itemOld, user, date) {
+        if (user)
+            entity.updatedBy = user;
+        entity.history = entity.history || itemOld?.history;
+        entity.updatedAt = date;
+        if (!this.config.TRACE_CHANGE?.fields || !itemOld) {
+            return entity;
+        }
+        const changes = (0, index_1.computeChangedFields)(itemOld, entity, this.config.TRACE_CHANGE);
+        if (changes.length > 0) {
+            entity.history = this.addHistory(entity.history, {
+                action: index_1.Action.UPDATE,
+                user,
+                date,
+                changes,
+            });
+        }
+        return entity;
+    }
+    /**
+     * Appends a non-empty history entry while keeping the in-entity history bounded.
+     */
+    addHistory(history, entry) {
+        if (!entry.changes || entry.changes.length === 0) {
+            return history || [];
+        }
+        const newHistory = [...(history || [])];
+        const MAX_HISTORY_ENTRIES = 100;
+        if (newHistory.length >= MAX_HISTORY_ENTRIES) {
+            newHistory.shift();
+        }
+        newHistory.push(entry);
+        return newHistory;
+    }
+}
+exports.DynamoWriteOperations = DynamoWriteOperations;
+class DynamoFindOperations {
+    repoDB;
+    config;
+    constructor(repoDB, config) {
+        this.repoDB = repoDB;
+        this.config = config;
+    }
+    async findQuery(queryParams) {
+        const filter = (0, index_1.parseIndexFilter)(queryParams, this.getIndexMap());
+        this.checkIsIndexedField(filter);
+        return this.find(filter);
+    }
+    async findAll() {
+        throw new exception_1.ErrorDynamoDB(this.repoDB.getTableName(), "findAll", "findAll requires an index filter; use scan() otherwise");
+    }
+    async findAllMatch(filter) {
+        if (typeof filter === "string")
+            filter = (0, index_1.parseIndexFilter)(filter, this.getIndexMap());
+        this.checkIsIndexedField(filter);
+        return this.fetchAll(filter);
+    }
+    async findAllByIndex(indexName, indexValue) {
+        const filter = { indexName: indexName, indexValue: indexValue };
+        this.checkIsIndexedField(filter);
+        const parsedFilter = (0, index_1.parseIndexFilter)(filter, this.getIndexMap());
+        return this.fetchAll(parsedFilter);
+    }
+    async findByField(fieldName, fieldValue) {
+        const filter = { [fieldName]: fieldValue, size: 100 };
+        this.checkIsIndexedField(filter);
+        const parsedFilter = (0, index_1.parseIndexFilter)(fieldName + "=" + fieldValue + "&size=100", this.getIndexMap());
+        return (await this.find(parsedFilter));
+    }
+    async findFirst(fieldName, fieldValue) {
+        const filter = { [fieldName]: fieldValue };
+        this.checkIsIndexedField(filter);
+        const result = await this.findByField(fieldName, fieldValue);
+        return result.items.length > 0 ? result.items[0] : null;
+    }
+    async find(filter, debug) {
+        if (typeof filter === "string")
+            filter = (0, index_1.parseIndexFilter)(filter, this.getIndexMap());
+        let parsedFilter = parseOwnerFields(filter, this.config);
+        this.checkIsIndexedField(parsedFilter);
+        parsedFilter = (0, index_1.parseIndexFilter)(filter, this.getIndexMap());
+        return this.repoDB.find(parsedFilter, debug);
+    }
+    async *findStream(filter, size) {
+        let lastKey = "";
+        const pageSize = size ?? 50;
+        do {
+            const filterStr = `size=${pageSize}&${filter}${lastKey ? `&lastKey=${encodeURIComponent(lastKey)}` : ""}`;
+            const itemList = await this.findQuery(filterStr);
+            yield* itemList.items;
+            lastKey = itemList.lastKey;
+        } while (lastKey);
+    }
+    /**
+     * Walks DynamoDB Query pages for indexed find-all helpers.
+     */
+    async fetchAll(filter) {
+        if (typeof filter === "string")
+            filter = (0, index_1.parseFilter)(filter);
+        const result = [];
+        do {
+            const response = await this.repoDB.find(filter);
+            result.push(...response.items);
+            filter.lastKey = response.lastKey;
+        } while (filter.lastKey);
+        return result;
+    }
+    /**
+     * Rejects find filters containing fields outside the configured index map.
+     */
+    checkIsIndexedField(filter) {
+        if (!filter || typeof filter !== "object") {
+            return;
+        }
+        const indexMap = this.getIndexMap();
+        if (!indexMap || indexMap.size === 0) {
+            throw new exception_1.ErrorHttp(exception_1.HTTP.BAD_REQUEST, "No indexes configured for this table");
+        }
+        const validFields = new Set();
+        if (indexMap.partitionKey) {
+            validFields.add(indexMap.partitionKey);
+        }
+        for (const [, indexConfig] of indexMap.entries()) {
+            if (indexConfig.field) {
+                validFields.add(indexConfig.field);
+            }
+            if (indexConfig.rFields) {
+                indexConfig.rFields.forEach((field) => validFields.add(field));
+            }
+            if (indexConfig.sortKeyField) {
+                validFields.add(indexConfig.sortKeyField);
+            }
+        }
+        const invalidFields = [];
+        for (const fieldName of Object.keys(filter)) {
+            if (["indexName", "indexValue", "size", "lastKey", "fieldsInclude", "fieldsExclude", "rangeFilters"].includes(fieldName)) {
+                continue;
+            }
+            const rangeSuffixes = ["Min", "Max", "From", "To", "Start", "End"];
+            const isRangeField = rangeSuffixes.some((suffix) => fieldName.endsWith(suffix));
+            if (isRangeField) {
+                continue;
+            }
+            if (!validFields.has(fieldName)) {
+                invalidFields.push(fieldName);
+            }
+        }
+        if (invalidFields.length > 0) {
+            const availableFields = Array.from(validFields).sort();
+            throw new exception_1.ErrorHttp(exception_1.HTTP.BAD_REQUEST, `Invalid field names in filter: ${invalidFields.join(", ")}. Available fields: ${availableFields.join(", ")}`);
+        }
+    }
+    /**
+     * Returns the DynamoDB index map from the operation config snapshot.
+     */
+    getIndexMap() {
+        return this.config.DYNAMO_DB?.MAP;
+    }
+}
+exports.DynamoFindOperations = DynamoFindOperations;
+class DynamoScanOperations {
+    repoDB;
+    config;
+    constructor(repoDB, config) {
+        this.repoDB = repoDB;
+        this.config = config;
+    }
+    async scan(filter, debug) {
+        const parsedFilter = (0, index_1.parseIndexFilter)(filter, this.getIndexMap());
+        return this.repoDB.scan(parsedFilter, debug);
+    }
+    /**
+     * Returns the DynamoDB index map used for scan filter parsing.
+     */
+    getIndexMap() {
+        return this.config.DYNAMO_DB?.MAP;
+    }
+}
+exports.DynamoScanOperations = DynamoScanOperations;
+class OpenSearchOperations {
+    repoES;
+    config;
+    constructor(repoES, config) {
+        this.repoES = repoES;
+        this.config = config;
+    }
+    async searchQuery(queryParams, debug) {
+        const query = (0, opensearch_parser_1.buildSearchQueryOS)(queryParams, this.config);
+        return this.repoES.search(query, debug);
+    }
+    searchQueryTotalCount(queryParams) {
+        const query = (0, opensearch_parser_1.buildSearchQueryOS)(queryParams, this.config);
+        return this.repoES.count(query);
+    }
+    async search(filter, debug) {
+        if (typeof filter === "string")
+            filter = (0, index_1.parseIndexFilter)(filter, this.getIndexMap());
+        let parsedFilter = parseOwnerFields(filter, this.config);
+        parsedFilter = this.setIndexField(parsedFilter);
+        return this.repoES.find(parsedFilter, debug);
+    }
+    searchFieldNotExist(fieldName, from, size) {
+        return this.repoES.fieldNotExists(fieldName, from, size);
+    }
+    async *searchStream(filter, pageSize = 50) {
+        let pageNumber = 1;
+        while (true) {
+            const filterStr = `page=${pageNumber++}&size=${pageSize}&${filter}`;
+            const resultList = await this.searchQuery(filterStr);
+            yield* resultList.items;
+            if (resultList.items.length < pageSize)
+                break;
+        }
+    }
+    async *searchStreamAggr(filter, pageSize = 50) {
+        let pageNumber = 1;
+        while (true) {
+            const filterStr = `page=${pageNumber++}&size=${pageSize}&${filter}`;
+            const resultList = await this.searchQuery(filterStr);
+            yield resultList;
+            if (resultList.items.length < pageSize)
+                break;
+        }
+    }
+    /**
+     * Converts a DynamoDB index name to its OpenSearch field name for search filters.
+     */
+    setIndexField(filter) {
+        if (!filter.indexName || !filter.indexValue)
+            return filter;
+        const indexMap = this.config.DYNAMO_DB.MAP;
+        if (!indexMap || indexMap.size === 0)
+            return filter;
+        const indexConfig = indexMap.get(filter.indexName);
+        if (!indexConfig)
+            return filter;
+        filter.indexName = indexConfig.field;
+        return filter;
+    }
+    /**
+     * Returns the DynamoDB index map used to parse shared filter strings.
+     */
+    getIndexMap() {
+        return this.config.DYNAMO_DB?.MAP;
+    }
+}
+exports.OpenSearchOperations = OpenSearchOperations;
+//# sourceMappingURL=crud-operations.js.map

package/dist/service/crud-operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crud-operations.js","sourceRoot":"","sources":["../../src/service/crud-operations.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  Action,\n  BaseEntity,\n  BaseRepoDB,\n  BaseRepoES,\n  ChangeHistory,\n  CognitoUser,\n  computeChangedFields,\n  Filter,\n  List,\n  parseFilter,\n  parseIndexFilter,\n  removeFields,\n} from \"../index\";\nimport { ErrorDynamoDB, ErrorHttp, HTTP } from \"../exception\";\nimport { buildSearchQueryOS } from \"../utils/opensearch/opensearch.parser\";\nimport { EntityConfig } from \"@chinggis/types\";\nimport dayjs from \"dayjs\";\n\n/**\n * Maps public owner aliases to the entity-specific owner field names.\n */\nfunction parseOwnerFields(filter: Filter, entityConfig: EntityConfig): Filter {\n  if (!filter) return null;\n\n  const parsedFilter = filter;\n\n  log.debug(\"input filter\", parsedFilter);\n\n  if (parsedFilter.ownerParentId && !entityConfig.OWNER_PARENT_ID_FIELD_NAME) {\n    parsedFilter.profileId = parsedFilter.ownerParentId;\n    delete parsedFilter.ownerParentId;\n  }\n  if (!parsedFilter.profileId) delete parsedFilter.profileId;\n\n  if (parsedFilter.ownerParentId && entityConfig.OWNER_PARENT_ID_FIELD_NAME) {\n    parsedFilter[entityConfig.OWNER_PARENT_ID_FIELD_NAME] = parsedFilter.ownerParentId;\n    if (entityConfig.OWNER_PARENT_ID_FIELD_NAME !== \"ownerParentId\") delete parsedFilter.ownerParentId;\n  }\n\n  if (parsedFilter.profileId && entityConfig.OWNER_ID_FIELD_NAME) {\n    parsedFilter[entityConfig.OWNER_ID_FIELD_NAME] = parsedFilter.profileId;\n    if (entityConfig.OWNER_ID_FIELD_NAME !== \"profileId\") delete parsedFilter.profileId;\n  }\n\n  if (parsedFilter.ownerId && entityConfig.OWNER_ID_FIELD_NAME) {\n    parsedFilter[entityConfig.OWNER_ID_FIELD_NAME] = parsedFilter.ownerId;\n    if (entityConfig.OWNER_ID_FIELD_NAME !== \"ownerId\") delete parsedFilter.ownerId;\n  }\n  log.debug(\"parsedFilter\", parsedFilter);\n\n  return parsedFilter;\n}\n\nexport class DynamoWriteOperations<T extends BaseEntity, D extends BaseRepoDB<T>> {\n  constructor(\n    private readonly repoDB: D,\n    private readonly config: EntityConfig,\n  ) {}\n\n  deleteFields(entityId: string, fields: string[]): Promise<Partial<T>> {\n    return this.repoDB.deleteFields(entityId, fields);\n  }\n\n  incrementValueByField(entityId: string, fieldName: string, value?: number): Promise<T> {\n    return this.repoDB.incrementValueByField(entityId, fieldName, value);\n  }\n\n  decrementValueByField(entityId: string, fieldName: string, value?: number): Promise<T> {\n    return this.repoDB.decrementValueByField(entityId, fieldName, value);\n  }\n\n  async save(entity: Partial<T>, ownerId: string, parentId?: string, createdByUser?: string | CognitoUser): Promise<T> {\n    entity = this.setSystemData(entity, Action.CREATE, createdByUser);\n\n    if (ownerId && this.config.OWNER_ID_FIELD_NAME) entity[this.config.OWNER_ID_FIELD_NAME] = ownerId;\n    if (parentId && this.config.OWNER_PARENT_ID_FIELD_NAME) entity[this.config.OWNER_PARENT_ID_FIELD_NAME] = parentId;\n\n    return this.repoDB.save(entity);\n  }\n\n  async saveAll(\n    entities: Partial<T>[],\n    ownerId: string,\n    parentId?: string,\n    createdByUser?: string | CognitoUser,\n    isTransactional?: boolean,\n  ): Promise<Partial<T>[]> {\n    const entitiesUpdated = [];\n\n    for (const item of entities) {\n      const entity = this.setSystemData(item, Action.CREATE, createdByUser || ownerId);\n\n      if (parentId && this.config.OWNER_PARENT_ID_FIELD_NAME) entity[this.config.OWNER_PARENT_ID_FIELD_NAME] = parentId;\n      if (ownerId && this.config.OWNER_ID_FIELD_NAME) entity[this.config.OWNER_ID_FIELD_NAME] = ownerId;\n\n      entitiesUpdated.push(entity);\n    }\n\n    return this.repoDB.saveMany(entitiesUpdated, isTransactional);\n  }\n\n  async update(entity: Partial<T>, requestUser?: CognitoUser, fields?: string[]): Promise<T> {\n    const fieldName = this.config.DYNAMO_DB?.MAP?.partitionKey ?? \"id\";\n    if (fields && fields.length > 0) fields.push(fieldName);\n    if (fields && fields.length > 0) entity = removeFields([entity], fields)[0];\n\n    if (!entity || !entity[fieldName]) throw new ErrorHttp(HTTP.BAD_REQUEST, `id required`);\n\n    const item = await this.repoDB.findById(entity[fieldName]);\n\n    if (!entity || !item) throw new ErrorHttp(HTTP.BAD_REQUEST, `id not found`);\n\n    if (\n      requestUser &&\n      !requestUser.isScope &&\n      !requestUser.isAdmin &&\n      (item[this.config.OWNER_ID_FIELD_NAME] !== requestUser.profile ||\n        item[this.config.OWNER_PARENT_ID_FIELD_NAME] !== requestUser.parentId)\n    )\n      throw new ErrorHttp(HTTP.FORBIDDEN, `No permission to resource: ${entity.id}`);\n\n    entity = this.setSystemData(entity, Action.UPDATE, requestUser, item);\n\n    return this.repoDB.update(entity);\n  }\n\n  updateAll(\n    entities: Partial<T>[],\n    fields: string[],\n    requestUser?: CognitoUser,\n    isTransactional?: boolean,\n  ): Promise<boolean> {\n    if (requestUser) log.warn(\"this methode is under development, cannot check ownership by updateAll\");\n\n    return this.repoDB.updateMany(entities, fields, isTransactional);\n  }\n\n  updateFields(entity: Partial<T>, fields: string[]): Promise<Partial<T>> {\n    if (!entity || !fields?.length) return Promise.resolve(entity);\n    return this.repoDB.updateFields(entity, [...fields]);\n  }\n\n  async remove(entityId: string, requestUser?: CognitoUser): Promise<boolean> {\n    if (!entityId) throw new Error(\"Entity id required\");\n\n    if (requestUser && requestUser.isAdmin) return this.repoDB.delete(entityId);\n\n    const entity = await this.repoDB.findById(entityId);\n    if (!entity) throw new Error(\"Entity not found\");\n\n    if (\n      requestUser &&\n      !requestUser.isScope &&\n      (entity[this.config.OWNER_ID_FIELD_NAME] !== requestUser.profile ||\n        entity[this.config.OWNER_PARENT_ID_FIELD_NAME] !== requestUser.parentId)\n    )\n      throw new ErrorHttp(HTTP.FORBIDDEN, `No permission to resource: ${entity.id}`);\n\n    return this.repoDB.delete(entityId);\n  }\n\n  removeAll(entityIds: string[], requestUser?: CognitoUser): Promise<boolean> {\n    if (requestUser) log.warn(\"this methode is under development, cannot check ownership by removeAll\");\n    return this.repoDB.deleteMany(entityIds);\n  }\n\n  async changeOwner(entityId: string, ownerId: string): Promise<T> {\n    const entity = await this.repoDB.findById(entityId);\n    entity[this.config.OWNER_ID_FIELD_NAME] = ownerId;\n    return this.repoDB.update(entity);\n  }\n\n  async findById(entityId: string, requestUser?: CognitoUser): Promise<T> {\n    const entity = await this.repoDB.findById(entityId);\n\n    if (!entity) return null;\n    if (!requestUser || requestUser.isAdmin) return entity;\n\n    const isOwnerParent = entity[this.config.OWNER_PARENT_ID_FIELD_NAME] == requestUser.profile;\n    const isParent = entity[this.config.OWNER_ID_FIELD_NAME] == requestUser.profile;\n\n    if (!requestUser.profile || isOwnerParent || isParent) return entity;\n\n    return null;\n  }\n\n  async findByIds(entityIds: string[], requestUser?: CognitoUser): Promise<T[]> {\n    if (entityIds.length > 25) throw new ErrorDynamoDB(this.repoDB.getTableName(), \"findByIds\", \"Too many entities\");\n\n    const entities = await this.repoDB.findByIds(entityIds);\n\n    if (!requestUser || requestUser.isAdmin) return entities;\n\n    const ownEntities = [];\n    for (const entity of entities) {\n      if (\n        entity[this.config.OWNER_PARENT_ID_FIELD_NAME] == requestUser.profile ||\n        entity[this.config.OWNER_ID_FIELD_NAME] == requestUser.profile\n      ) {\n        ownEntities.push(entity);\n      }\n    }\n    return ownEntities;\n  }\n\n  /**\n   * Applies generated id, timestamps, audit user, and optional change history.\n   */\n  private setSystemData(itemNew: Partial<T>, action: Action, requestUser?: string | CognitoUser, itemOld?: T): T {\n    if (!action || action === Action.DELETE || action === Action.READ) return itemNew as T;\n\n    const date = dayjs().toISOString();\n    const user = this.extractUser(requestUser);\n\n    switch (action) {\n      case Action.CREATE:\n        return this.handleCreate(itemNew, user, date);\n      case Action.UPDATE:\n        return this.handleUpdate(itemNew, itemOld, user, date);\n      default:\n        return itemNew as T;\n    }\n  }\n\n  /**\n   * Normalizes a raw username or Cognito user into a stored audit username.\n   */\n  private extractUser(requestUser: string | CognitoUser): string {\n    if (!requestUser) return undefined;\n\n    if (typeof requestUser === \"string\") return requestUser;\n\n    return requestUser.username;\n  }\n\n  /**\n   * Populates system fields that are required when creating an entity.\n   */\n  private handleCreate(entity: Partial<T>, user: string, date: string): T {\n    const dayjsData = dayjs(new Date(date));\n\n    const noIdExist = entity[this.config.DYNAMO_DB.MAP.partitionKey ?? \"id\"] === undefined;\n    if (noIdExist) entity[this.config.DYNAMO_DB.MAP.partitionKey ?? \"id\"] = crypto.randomUUID();\n\n    entity.createdAt = date;\n    if (user) entity.createdBy = user;\n    entity.year = dayjsData.year().toString();\n    entity.yearMonth = dayjsData.format(\"YYYY-MM\");\n\n    if (!entity.updatedAt) {\n      entity.updatedAt = entity.createdAt;\n    }\n\n    if (!this.config.TRACE_CHANGE?.fields) return entity as T;\n\n    entity.history = this.addHistory(entity.history, { action: Action.CREATE, user, date });\n    return entity as T;\n  }\n\n  /**\n   * Populates update metadata and records traced field changes when configured.\n   */\n  private handleUpdate(entity: Partial<T>, itemOld: T | undefined, user: string, date: string): T {\n    if (user) entity.updatedBy = user;\n    entity.history = entity.history || itemOld?.history;\n\n    entity.updatedAt = date;\n\n    if (!this.config.TRACE_CHANGE?.fields || !itemOld) {\n      return entity as T;\n    }\n\n    const changes = computeChangedFields(itemOld, entity, this.config.TRACE_CHANGE);\n    if (changes.length > 0) {\n      entity.history = this.addHistory(entity.history, {\n        action: Action.UPDATE,\n        user,\n        date,\n        changes,\n      });\n    }\n\n    return entity as T;\n  }\n\n  /**\n   * Appends a non-empty history entry while keeping the in-entity history bounded.\n   */\n  private addHistory(history: ChangeHistory[] | undefined, entry: ChangeHistory): ChangeHistory[] {\n    if (!entry.changes || entry.changes.length === 0) {\n      return history || [];\n    }\n\n    const newHistory = [...(history || [])];\n\n    const MAX_HISTORY_ENTRIES = 100;\n    if (newHistory.length >= MAX_HISTORY_ENTRIES) {\n      newHistory.shift();\n    }\n\n    newHistory.push(entry);\n    return newHistory;\n  }\n}\n\nexport class DynamoFindOperations<T extends BaseEntity, D extends BaseRepoDB<T>> {\n  constructor(\n    private readonly repoDB: D,\n    private readonly config: EntityConfig,\n  ) {}\n\n  async findQuery(queryParams: string): Promise<List<Partial<T>>> {\n    const filter = parseIndexFilter(queryParams, this.getIndexMap());\n    this.checkIsIndexedField(filter);\n    return this.find(filter);\n  }\n\n  async findAll(): Promise<T[]> {\n    throw new ErrorDynamoDB(\n      this.repoDB.getTableName(),\n      \"findAll\",\n      \"findAll requires an index filter; use scan() otherwise\",\n    );\n  }\n\n  async findAllMatch(filter: Filter | string): Promise<T[]> {\n    if (typeof filter === \"string\") filter = parseIndexFilter(filter, this.getIndexMap());\n    this.checkIsIndexedField(filter);\n    return this.fetchAll(filter);\n  }\n\n  async findAllByIndex(indexName: string, indexValue: any): Promise<T[]> {\n    const filter = { indexName: indexName, indexValue: indexValue };\n    this.checkIsIndexedField(filter);\n\n    const parsedFilter = parseIndexFilter(filter, this.getIndexMap());\n    return this.fetchAll(parsedFilter);\n  }\n\n  async findByField(fieldName: string, fieldValue: any): Promise<List<T>> {\n    const filter = { [fieldName]: fieldValue, size: 100 };\n    this.checkIsIndexedField(filter);\n    const parsedFilter = parseIndexFilter(fieldName + \"=\" + fieldValue + \"&size=100\", this.getIndexMap());\n    return (await this.find(parsedFilter)) as List<T>;\n  }\n\n  async findFirst(fieldName: string, fieldValue: string | boolean | number | Date): Promise<T> {\n    const filter = { [fieldName]: fieldValue };\n    this.checkIsIndexedField(filter);\n\n    const result = await this.findByField(fieldName, fieldValue);\n    return result.items.length > 0 ? result.items[0] : null;\n  }\n\n  async find(filter: Filter | string, debug?: boolean): Promise<List<Partial<T>>> {\n    if (typeof filter === \"string\") filter = parseIndexFilter(filter, this.getIndexMap());\n\n    let parsedFilter = parseOwnerFields(filter, this.config);\n    this.checkIsIndexedField(parsedFilter);\n\n    parsedFilter = parseIndexFilter(filter, this.getIndexMap());\n    return this.repoDB.find(parsedFilter, debug);\n  }\n\n  async *findStream(filter: string, size?: number): AsyncGenerator<T> {\n    let lastKey: string = \"\";\n    const pageSize = size ?? 50;\n\n    do {\n      const filterStr = `size=${pageSize}&${filter}${lastKey ? `&lastKey=${encodeURIComponent(lastKey)}` : \"\"}`;\n      const itemList = await this.findQuery(filterStr);\n\n      yield* itemList.items as T[];\n\n      lastKey = itemList.lastKey;\n    } while (lastKey);\n  }\n\n  /**\n   * Walks DynamoDB Query pages for indexed find-all helpers.\n   */\n  private async fetchAll(filter: Filter | string): Promise<T[]> {\n    if (typeof filter === \"string\") filter = parseFilter(filter);\n\n    const result: Partial<T>[] = [];\n    do {\n      const response = await this.repoDB.find(filter);\n      result.push(...response.items);\n      filter.lastKey = response.lastKey;\n    } while (filter.lastKey);\n\n    return result as T[];\n  }\n\n  /**\n   * Rejects find filters containing fields outside the configured index map.\n   */\n  private checkIsIndexedField(filter: Filter): void {\n    if (!filter || typeof filter !== \"object\") {\n      return;\n    }\n\n    const indexMap = this.getIndexMap();\n    if (!indexMap || indexMap.size === 0) {\n      throw new ErrorHttp(HTTP.BAD_REQUEST, \"No indexes configured for this table\");\n    }\n\n    const validFields = new Set<string>();\n\n    if (indexMap.partitionKey) {\n      validFields.add(indexMap.partitionKey);\n    }\n\n    for (const [, indexConfig] of indexMap.entries()) {\n      if (indexConfig.field) {\n        validFields.add(indexConfig.field);\n      }\n      if (indexConfig.rFields) {\n        indexConfig.rFields.forEach((field) => validFields.add(field));\n      }\n      if (indexConfig.sortKeyField) {\n        validFields.add(indexConfig.sortKeyField);\n      }\n    }\n\n    const invalidFields: string[] = [];\n    for (const fieldName of Object.keys(filter)) {\n      if (\n        [\"indexName\", \"indexValue\", \"size\", \"lastKey\", \"fieldsInclude\", \"fieldsExclude\", \"rangeFilters\"].includes(\n          fieldName,\n        )\n      ) {\n        continue;\n      }\n\n      const rangeSuffixes = [\"Min\", \"Max\", \"From\", \"To\", \"Start\", \"End\"];\n      const isRangeField = rangeSuffixes.some((suffix) => fieldName.endsWith(suffix));\n      if (isRangeField) {\n        continue;\n      }\n\n      if (!validFields.has(fieldName)) {\n        invalidFields.push(fieldName);\n      }\n    }\n\n    if (invalidFields.length > 0) {\n      const availableFields = Array.from(validFields).sort();\n      throw new ErrorHttp(\n        HTTP.BAD_REQUEST,\n        `Invalid field names in filter: ${invalidFields.join(\", \")}. Available fields: ${availableFields.join(\", \")}`,\n      );\n    }\n  }\n\n  /**\n   * Returns the DynamoDB index map from the operation config snapshot.\n   */\n  private getIndexMap() {\n    return this.config.DYNAMO_DB?.MAP;\n  }\n}\n\nexport class DynamoScanOperations<T extends BaseEntity, D extends BaseRepoDB<T>> {\n  constructor(\n    private readonly repoDB: D,\n    private readonly config: EntityConfig,\n  ) {}\n\n  async scan(filter: Filter | string, debug?: boolean): Promise<List<Partial<T>>> {\n    const parsedFilter = parseIndexFilter(filter, this.getIndexMap());\n    return this.repoDB.scan(parsedFilter, debug);\n  }\n\n  /**\n   * Returns the DynamoDB index map used for scan filter parsing.\n   */\n  private getIndexMap() {\n    return this.config.DYNAMO_DB?.MAP;\n  }\n}\n\nexport class OpenSearchOperations<T extends BaseEntity, S extends BaseRepoES<T>> {\n  constructor(\n    private readonly repoES: S,\n    private readonly config: EntityConfig,\n  ) {}\n\n  async searchQuery(\n    queryParams: any,\n    debug?: boolean,\n  ): Promise<{ items: Partial<T>[]; total: number; aggs?: Record<string, any> }> {\n    const query = buildSearchQueryOS(queryParams, this.config);\n\n    return this.repoES.search(query, debug);\n  }\n\n  searchQueryTotalCount(queryParams: any): Promise<number> {\n    const query = buildSearchQueryOS(queryParams, this.config);\n\n    return this.repoES.count(query);\n  }\n\n  async search(filter: Filter | string, debug?: boolean): Promise<List<Partial<T>>> {\n    if (typeof filter === \"string\") filter = parseIndexFilter(filter, this.getIndexMap());\n\n    let parsedFilter = parseOwnerFields(filter, this.config);\n    parsedFilter = this.setIndexField(parsedFilter);\n\n    return this.repoES.find(parsedFilter, debug);\n  }\n\n  searchFieldNotExist(fieldName: string, from: number, size: number): Promise<Partial<T>[]> {\n    return this.repoES.fieldNotExists(fieldName, from, size);\n  }\n\n  async *searchStream(filter: string, pageSize = 50): AsyncGenerator<T> {\n    let pageNumber = 1;\n\n    while (true) {\n      const filterStr = `page=${pageNumber++}&size=${pageSize}&${filter}`;\n      const resultList = await this.searchQuery(filterStr);\n      yield* resultList.items as T[];\n      if (resultList.items.length < pageSize) break;\n    }\n  }\n\n  async *searchStreamAggr(\n    filter: string,\n    pageSize = 50,\n  ): AsyncGenerator<{ items: Partial<T>[]; total: number; aggs?: Record<string, any> }> {\n    let pageNumber = 1;\n\n    while (true) {\n      const filterStr = `page=${pageNumber++}&size=${pageSize}&${filter}`;\n      const resultList = await this.searchQuery(filterStr);\n      yield resultList;\n      if (resultList.items.length < pageSize) break;\n    }\n  }\n\n  /**\n   * Converts a DynamoDB index name to its OpenSearch field name for search filters.\n   */\n  private setIndexField(filter: Filter): Filter {\n    if (!filter.indexName || !filter.indexValue) return filter;\n\n    const indexMap = this.config.DYNAMO_DB.MAP;\n    if (!indexMap || indexMap.size === 0) return filter;\n\n    const indexConfig = indexMap.get(filter.indexName);\n    if (!indexConfig) return filter;\n\n    filter.indexName = indexConfig.field;\n    return filter;\n  }\n\n  /**\n   * Returns the DynamoDB index map used to parse shared filter strings.\n   */\n  private getIndexMap() {\n    return this.config.DYNAMO_DB?.MAP;\n  }\n}\n"]}

package/dist/service/crud.service.d.ts

@@ -1,10 +1,14 @@
-import { BaseEntity, BaseRepoDB, BaseRepoES, CognitoUser, DynamoIndexMap, Filter, List } from "../index";
+import { BaseEntity, BaseRepoDB, BaseRepoES, CognitoUser, DynamoIndexMap, ErrorReason, Filter, HttpStatus, List } from "../index";
 import { EntityConfig } from "../model/index.js";
 import { CrudService } from "./crud.service.interface";
 export declare abstract class CrudServiceImpl<T extends BaseEntity, D extends BaseRepoDB<T>, S extends BaseRepoES<T>> implements CrudService<T> {
     protected repoDB: D;
     protected repoES: S;
     protected config: EntityConfig;
+    private writeOps;
+    private findOps;
+    private scanOps;
+    private searchOps;
     protected constructor(repoDB: D, repoES: S);
     getTableName(): string;
     findQuery(queryParams: string): Promise<List<Partial<T>>>;
@@ -17,7 +21,7 @@ export declare abstract class CrudServiceImpl<T extends BaseEntity, D extends Ba
     searchQueryTotalCount(queryParams: any): Promise<number>;
     incrementValueByField(entityId: string, fieldName: string, value?: number): Promise<T>;
     decrementValueByField(entityId: string, fieldName: string, value?: number): Promise<T>;
-    search(filter: Filter | string): Promise<List<Partial<T>>>;
+    search(filter: Filter | string, debug?: boolean): Promise<List<Partial<T>>>;
     searchFieldNotExist(fieldName: string, from: number, size: number): Promise<Partial<T>[]>;
     save(entity: Partial<T>, ownerId: string, parentId?: string, createdByUser?: string | CognitoUser): Promise<T>;
     saveAll(entities: Partial<T>[], ownerId: string, parentId?: string, createdByUser?: string | CognitoUser, isTransactional?: boolean): Promise<Partial<T>[]>;
@@ -38,7 +42,7 @@ export declare abstract class CrudServiceImpl<T extends BaseEntity, D extends Ba
     findAllByIndex(indexName: string, indexValue: any): Promise<T[]>;
     findByField(fieldName: string, fieldValue: any): Promise<List<T>>;
     findFirst(fieldName: string, fieldValue: string | boolean | number | Date): Promise<T>;
-    find(filter: Filter | string): Promise<List<Partial<T>>>;
+    find(filter: Filter | string, debug?: boolean): Promise<List<Partial<T>>>;
     findStream(filter: string, size?: number): AsyncGenerator<T>;
     searchStream(filter: string, size?: number): AsyncGenerator<T>;
     searchStreamAggr(filter: string, size?: number): AsyncGenerator<{
@@ -48,30 +52,20 @@ export declare abstract class CrudServiceImpl<T extends BaseEntity, D extends Ba
     }>;
     findById(entityId: string, requestUser?: CognitoUser): Promise<T>;
     findByIds(entityIds: string[], requestUser?: CognitoUser): Promise<T[]>;
-    scan(filter: Filter): Promise<List<Partial<T>>>;
+    scan(filter: Filter | string, debug?: boolean): Promise<List<Partial<T>>>;
     throwErrorHttp(error: {
         message: string;
         code: number;
     }, message?: string, errorContent?: any): void;
     throwErrorsHttp(code: number, message: string, errorContent?: any): void;
+    throwHttpError(status: HttpStatus, message: string, content?: any, reason?: ErrorReason): void;
     throwErrorDatabase(tableName: string, command: any, errorContent?: any): void;
     throwErrorValidation(entityName: string, validation: Map<string, any>, errorContent?: any): void;
     throwError(code: number, message: string, errorContent?: any): void;
     setConfig(config: EntityConfig): void;
     /**
-     * Validates that all field names in the filter exist in the index map.
-     * Throws a Bad Request error if any field is not found in the available indexes.
-     *
-     * @param filter - The filter object containing field names to validate
-     * @throws ErrorHttp with status 400 if validation fails
+     * Creates operation delegates with the current config snapshot.
      */
-    private checkIsIndexedField;
-    private fetchAll;
-    private parseOwnerFields;
-    private setSystemData;
-    private extractUser;
-    private handleCreate;
-    private handleUpdate;
-    private addHistory;
-    private setIndexField;
+    private initializeOperations;
 }
+//# sourceMappingURL=crud.service.d.ts.map

package/dist/service/crud.service.d.ts.map

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