aws-service-stack 0.18.421 → 0.18.424

package/dist/model/filter.model.d.ts

@@ -8,6 +8,7 @@ export interface Filter extends Record<string, any> {
     searchKeyword?: string;
     rangeFilters?: RangeFilter[];
     lastKey?: string;
+    queryCountLimit?: number;
     indexName?: string;
     indexValue?: string;
     indexSortName?: string;
@@ -75,3 +76,4 @@ export declare enum AggTypeOS {
     MIN = "min",
     TREE = "tree"
 }
+//# sourceMappingURL=filter.model.d.ts.map

package/dist/model/filter.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.model.d.ts","sourceRoot":"","sources":["../../src/model/filter.model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,MAAM,WAAW,MAAO,SAAQ,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IACjB,QAAQ,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IACrB,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,oBAAY,eAAe;IACzB,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,EAAE,OAAO;IACT,EAAE,OAAO;IACT,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,UAAU,eAAe;IACzB,QAAQ,aAAa;IACrB,YAAY,iBAAiB;IAC7B,QAAQ,aAAa;IACrB,YAAY,iBAAiB;IAC7B,KAAK,UAAU;CAChB;AAED,oBAAY,WAAW;IACrB,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,EAAE,OAAO;IACT,EAAE,OAAO;CACV;AAED,oBAAY,gBAAgB;IAC1B,GAAG,QAAQ;IACX,EAAE,OAAO;CACV;AAED,oBAAY,SAAS;IACnB,KAAK,UAAU;IACf,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,IAAI,SAAS;CACd"}

package/dist/model/filter.model.js.map

@@ -1 +1 @@
-{"version":3,"file":"filter.model.js","sourceRoot":"","sources":["../../src/model/filter.model.ts"],"names":[],"mappings":";;;AA8CA,IAAY,eAkBX;AAlBD,WAAY,eAAe;IACzB,4BAAS,CAAA;IACT,4BAAS,CAAA;IACT,4BAAS,CAAA;IACT,8BAAW,CAAA;IACX,8BAAW,CAAA;IACX,8BAAW,CAAA;IACX,4BAAS,CAAA;IACT,4BAAS,CAAA;IACT,oCAAiB,CAAA;IACjB,kCAAe,CAAA;IACf,oCAAiB,CAAA;IACjB,4CAAyB,CAAA;IACzB,wCAAqB,CAAA;IACrB,gDAA6B,CAAA;IAC7B,wCAAqB,CAAA;IACrB,gDAA6B,CAAA;IAC7B,kCAAe,CAAA;AACjB,CAAC,EAlBW,eAAe,+BAAf,eAAe,QAkB1B;AAED,IAAY,WAKX;AALD,WAAY,WAAW;IACrB,0BAAW,CAAA;IACX,0BAAW,CAAA;IACX,wBAAS,CAAA;IACT,wBAAS,CAAA;AACX,CAAC,EALW,WAAW,2BAAX,WAAW,QAKtB;AAED,IAAY,gBAGX;AAHD,WAAY,gBAAgB;IAC1B,+BAAW,CAAA;IACX,6BAAS,CAAA;AACX,CAAC,EAHW,gBAAgB,gCAAhB,gBAAgB,QAG3B;AAED,IAAY,SAOX;AAPD,WAAY,SAAS;IACnB,4BAAe,CAAA;IACf,wBAAW,CAAA;IACX,wBAAW,CAAA;IACX,wBAAW,CAAA;IACX,wBAAW,CAAA;IACX,0BAAa,CAAA;AACf,CAAC,EAPW,SAAS,yBAAT,SAAS,QAOpB","sourcesContent":["import { SortOrder } from \"@chinggis/core\";\n\nexport interface Filter extends Record<string, any> {\n  page?: number; // The page number for pagination\n  size?: number; // The size of items per page\n  sortBy?: string; // The field to sort by\n  sort?: SortOrder; // Sorting order, either ascending or descending\n  searchBy?: string[]; // The field to search in\n  searchKeyword?: string; // The keyword to search for\n  rangeFilters?: RangeFilter[]; // The field to apply range filtering on\n  lastKey?: string;\n  indexName?: string;\n  indexValue?: string;\n  indexSortName?: string;\n  indexSortValue?: string;\n  fieldsInclude?: string[];\n  fieldsExclude?: string[];\n  urlRaw?: string;\n}\n\nexport type RangeFilter = {\n  fieldName: string;\n  minValue?: number | Date;\n  maxValue?: number | Date;\n  minExclude?: boolean;\n  maxExclude?: boolean;\n};\n\nexport type NumberRange = {\n  gte?: number;\n  lte?: number;\n};\n\nexport type DateRange = {\n  gte?: string;\n  lte?: string;\n};\n\nexport interface BoolQueryOS {\n  must: Array<any>;\n  must_not: Array<any>;\n  filter: Array<any>;\n  should: Array<any>;\n  minimum_should_match?: number;\n}\n\nexport enum BoolQueryTypeOS {\n  eq = \"eq\",\n  ne = \"ne\",\n  in = \"in\",\n  nin = \"nin\",\n  gte = \"gte\",\n  lte = \"lte\",\n  gt = \"gt\",\n  lt = \"lt\",\n  exists = \"exists\",\n  regex = \"regex\",\n  prefix = \"prefix\",\n  not_prefix = \"not_prefix\",\n  contains = \"contains\",\n  not_contains = \"not_contains\",\n  wildcard = \"wildcard\",\n  not_wildcard = \"not_wildcard\",\n  fuzzy = \"fuzzy\",\n}\n\nexport enum RangeTypeOS {\n  lte = \"lte\",\n  gte = \"gte\",\n  lt = \"lt\",\n  gt = \"gt\",\n}\n\nexport enum SearchOperatorOS {\n  AND = \"and\",\n  OR = \"or\",\n}\n\nexport enum AggTypeOS {\n  TERMS = \"terms\",\n  SUM = \"sum\",\n  AVG = \"avg\",\n  MAX = \"max\",\n  MIN = \"min\",\n  TREE = \"tree\",\n}\n"]}
+{"version":3,"file":"filter.model.js","sourceRoot":"","sources":["../../src/model/filter.model.ts"],"names":[],"mappings":";;;AA+CA,IAAY,eAkBX;AAlBD,WAAY,eAAe;IACzB,4BAAS,CAAA;IACT,4BAAS,CAAA;IACT,4BAAS,CAAA;IACT,8BAAW,CAAA;IACX,8BAAW,CAAA;IACX,8BAAW,CAAA;IACX,4BAAS,CAAA;IACT,4BAAS,CAAA;IACT,oCAAiB,CAAA;IACjB,kCAAe,CAAA;IACf,oCAAiB,CAAA;IACjB,4CAAyB,CAAA;IACzB,wCAAqB,CAAA;IACrB,gDAA6B,CAAA;IAC7B,wCAAqB,CAAA;IACrB,gDAA6B,CAAA;IAC7B,kCAAe,CAAA;AACjB,CAAC,EAlBW,eAAe,+BAAf,eAAe,QAkB1B;AAED,IAAY,WAKX;AALD,WAAY,WAAW;IACrB,0BAAW,CAAA;IACX,0BAAW,CAAA;IACX,wBAAS,CAAA;IACT,wBAAS,CAAA;AACX,CAAC,EALW,WAAW,2BAAX,WAAW,QAKtB;AAED,IAAY,gBAGX;AAHD,WAAY,gBAAgB;IAC1B,+BAAW,CAAA;IACX,6BAAS,CAAA;AACX,CAAC,EAHW,gBAAgB,gCAAhB,gBAAgB,QAG3B;AAED,IAAY,SAOX;AAPD,WAAY,SAAS;IACnB,4BAAe,CAAA;IACf,wBAAW,CAAA;IACX,wBAAW,CAAA;IACX,wBAAW,CAAA;IACX,wBAAW,CAAA;IACX,0BAAa,CAAA;AACf,CAAC,EAPW,SAAS,yBAAT,SAAS,QAOpB","sourcesContent":["import { SortOrder } from \"@chinggis/core\";\n\nexport interface Filter extends Record<string, any> {\n  page?: number; // The page number for pagination\n  size?: number; // The size of items per page\n  sortBy?: string; // The field to sort by\n  sort?: SortOrder; // Sorting order, either ascending or descending\n  searchBy?: string[]; // The field to search in\n  searchKeyword?: string; // The keyword to search for\n  rangeFilters?: RangeFilter[]; // The field to apply range filtering on\n  lastKey?: string;\n  queryCountLimit?: number;\n  indexName?: string;\n  indexValue?: string;\n  indexSortName?: string;\n  indexSortValue?: string;\n  fieldsInclude?: string[];\n  fieldsExclude?: string[];\n  urlRaw?: string;\n}\n\nexport type RangeFilter = {\n  fieldName: string;\n  minValue?: number | Date;\n  maxValue?: number | Date;\n  minExclude?: boolean;\n  maxExclude?: boolean;\n};\n\nexport type NumberRange = {\n  gte?: number;\n  lte?: number;\n};\n\nexport type DateRange = {\n  gte?: string;\n  lte?: string;\n};\n\nexport interface BoolQueryOS {\n  must: Array<any>;\n  must_not: Array<any>;\n  filter: Array<any>;\n  should: Array<any>;\n  minimum_should_match?: number;\n}\n\nexport enum BoolQueryTypeOS {\n  eq = \"eq\",\n  ne = \"ne\",\n  in = \"in\",\n  nin = \"nin\",\n  gte = \"gte\",\n  lte = \"lte\",\n  gt = \"gt\",\n  lt = \"lt\",\n  exists = \"exists\",\n  regex = \"regex\",\n  prefix = \"prefix\",\n  not_prefix = \"not_prefix\",\n  contains = \"contains\",\n  not_contains = \"not_contains\",\n  wildcard = \"wildcard\",\n  not_wildcard = \"not_wildcard\",\n  fuzzy = \"fuzzy\",\n}\n\nexport enum RangeTypeOS {\n  lte = \"lte\",\n  gte = \"gte\",\n  lt = \"lt\",\n  gt = \"gt\",\n}\n\nexport enum SearchOperatorOS {\n  AND = \"and\",\n  OR = \"or\",\n}\n\nexport enum AggTypeOS {\n  TERMS = \"terms\",\n  SUM = \"sum\",\n  AVG = \"avg\",\n  MAX = \"max\",\n  MIN = \"min\",\n  TREE = \"tree\",\n}\n"]}

package/dist/model/http.model.d.ts

@@ -15,3 +15,4 @@ export declare enum Action {
     UPDATE = "UPDATE",
     DELETE = "DELETE"
 }
+//# sourceMappingURL=http.model.d.ts.map

package/dist/model/http.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.model.d.ts","sourceRoot":"","sources":["../../src/model/http.model.ts"],"names":[],"mappings":"AAAA,oBAAY,UAAU;IACpB,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,KAAK,UAAU;IACf,MAAM,WAAW;CAClB;AAED,oBAAY,SAAS;IACnB,GAAG,QAAQ;IACX,IAAI,SAAS;CACd;AAED,oBAAY,MAAM;IAChB,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,MAAM,WAAW;CAClB"}

package/dist/model/index.d.ts

@@ -6,3 +6,4 @@ export * from "./validation.model";
 export * from "./dynamodb.model";
 export * from "./base.config";
 export { Permission as RolePermission } from "./role.model";
+//# sourceMappingURL=index.d.ts.map

package/dist/model/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/model/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,cAAc,CAAC"}

package/dist/model/role.model.d.ts

@@ -12,3 +12,4 @@ export interface Permission extends BaseEntity {
     };
     permissionKey: string;
 }
+//# sourceMappingURL=role.model.d.ts.map

package/dist/model/role.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"role.model.d.ts","sourceRoot":"","sources":["../../src/model/role.model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,WAAW,UAAW,SAAQ,UAAU;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE;QACN,GAAG,CAAC,EAAE,OAAO,CAAC;QACd,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,GAAG,CAAC,EAAE,OAAO,CAAC;QACd,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC;IACF,aAAa,EAAE,MAAM,CAAC;CACvB"}

package/dist/model/validation.model.d.ts

@@ -24,3 +24,4 @@ export declare enum Access {
     ADMIN = "admin",
     SYSTEM = "system"
 }
+//# sourceMappingURL=validation.model.d.ts.map

package/dist/model/validation.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.model.d.ts","sourceRoot":"","sources":["../../src/model/validation.model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,uCAAuC;AACvC,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,CAAC,EAAE,GAAG,CAAC;IAChB,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED,oBAAY,WAAW;IACrB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,KAAK,UAAU;IACf,MAAM,WAAW;CAClB;AAED,oBAAY,MAAM;IAChB,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,KAAK,UAAU;IACf,KAAK,UAAU;IACf,MAAM,WAAW;CAClB"}

package/dist/provider/apigateway.d.ts

@@ -2,3 +2,4 @@ import { ApiGatewayManagementApiClient } from "@aws-sdk/client-apigatewaymanagem
 export declare class ApiGatewayManagement extends ApiGatewayManagementApiClient {
     constructor();
 }
+//# sourceMappingURL=apigateway.d.ts.map

package/dist/provider/apigateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apigateway.d.ts","sourceRoot":"","sources":["../../src/provider/apigateway.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,yCAAyC,CAAC;AAIxF,qBACa,oBAAqB,SAAQ,6BAA6B;;CAMtE"}

package/dist/provider/dynamodb.d.ts

@@ -1,3 +1,4 @@
 import { DynamoDBClient } from "@aws-sdk/client-dynamodb";
 export declare class DBClientDynamoDB extends DynamoDBClient {
 }
+//# sourceMappingURL=dynamodb.d.ts.map

package/dist/provider/dynamodb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamodb.d.ts","sourceRoot":"","sources":["../../src/provider/dynamodb.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,qBACa,gBAAiB,SAAQ,cAAc;CAAG"}

package/dist/provider/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./apigateway";
 export * from "./dynamodb";
 export * from "./opensearch";
+//# sourceMappingURL=index.d.ts.map

package/dist/provider/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/provider/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC"}

package/dist/provider/opensearch.d.ts

@@ -2,3 +2,4 @@ import { Client } from "@opensearch-project/opensearch";
 export declare class OpenSearchClient extends Client {
     constructor(node: string);
 }
+//# sourceMappingURL=opensearch.d.ts.map

package/dist/provider/opensearch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opensearch.d.ts","sourceRoot":"","sources":["../../src/provider/opensearch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AAKxD,qBAAa,gBAAiB,SAAQ,MAAM;gBAC9B,IAAI,EAAE,MAAM;CAYzB"}

package/dist/repositories/base-core.repo.interface.d.ts

@@ -28,12 +28,17 @@ export interface CoreRepo<T extends BaseEntity> {
      */
     findByIds(ids: string[]): Promise<T[]>;
     /**
-     * Retrieves a list of entities that match the specified filter, sorting, and pagination criteria.
+     * Reads a page of entities from the backing query mechanism.
      *
-     * @param filter - Filtering, sorting, and pagination options.
-     * @returns An array of matching entities.
+     * DynamoDB implementations must treat this as Query-only and reject non-indexed
+     * filters. Search implementations may translate the filter into their native
+     * search query format.
+     *
+     * @param filter - Query/search filter.
+     * @param debug - When true, logs the generated backing-store query.
+     * @returns One page of matching entities.
      */
-    find(filter: Filter): Promise<List<Partial<T>>>;
+    find(filter: Filter, debug?: boolean): Promise<List<Partial<T>>>;
     fieldNotExists(fieldName: string, from: number, size: number): Promise<T[]>;
     /**
      * Retrieves the first matching entity based on the specified filter.
@@ -59,3 +64,4 @@ export interface CoreRepo<T extends BaseEntity> {
      */
     getRaw?(filter: Filter): Promise<any>;
 }
+//# sourceMappingURL=base-core.repo.interface.d.ts.map

package/dist/repositories/base-core.repo.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-core.repo.interface.d.ts","sourceRoot":"","sources":["../../src/repositories/base-core.repo.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAEpD;;;GAGG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC,SAAS,UAAU;IAC5C;;;;;OAKG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAErC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAExC;;;;;;OAMG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAEvC;;;;;;;;;;OAUG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEjE,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAE5E;;;;;OAKG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAEpD;;;;;;OAMG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEvC;;;;;;OAMG;IACH,MAAM,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CAYvC"}

package/dist/repositories/base-core.repo.interface.js.map

@@ -1 +1 @@
-{"version":3,"file":"base-core.repo.interface.js","sourceRoot":"","sources":["../../src/repositories/base-core.repo.interface.ts"],"names":[],"mappings":"","sourcesContent":["import { List } from \"@chinggis/types\";\nimport { BaseEntity, Filter } from \"@chinggis/core\";\n\n/**\n * Core repository interface defining standard CRUD and query operations.\n * Designed to be implemented for different data sources such as DynamoDB or OpenSearch.\n */\nexport interface CoreRepo<T extends BaseEntity> {\n  /**\n   * Checks whether an entity with the specified ID exists.\n   *\n   * @param id - The ID of the entity to check.\n   * @returns True if the entity exists; otherwise, false.\n   */\n  exists(id: string): Promise<boolean>;\n\n  /**\n   * Retrieves a single entity by its unique identifier.\n   *\n   * @param id - The ID of the entity to retrieve.\n   * @returns The entity if found; otherwise, null.\n   */\n  findById(id: string): Promise<T | null>;\n\n  /**\n   * Retrieves multiple entities by their unique identifiers.\n   * Returns only the entities that exist (non-existent IDs are ignored).\n   *\n   * @param ids - An array of entity IDs to retrieve.\n   * @returns An array of entities that were found.\n   */\n  findByIds(ids: string[]): Promise<T[]>;\n\n  /**\n   * Retrieves a list of entities that match the specified filter, sorting, and pagination criteria.\n   *\n   * @param filter - Filtering, sorting, and pagination options.\n   * @returns An array of matching entities.\n   */\n  find(filter: Filter): Promise<List<Partial<T>>>;\n\n  fieldNotExists(fieldName: string, from: number, size: number): Promise<T[]>;\n\n  /**\n   * Retrieves the first matching entity based on the specified filter.\n   *\n   * @param filter - Filtering criteria.\n   * @returns The first matching entity if found; otherwise, null.\n   */\n  findOne(filter: Filter): Promise<Partial<T> | null>;\n\n  /**\n   * Counts the total number of entities matching the specified filter.\n   * Useful for pagination and statistics.\n   *\n   * @param filter - Filtering criteria.\n   * @returns The number of matching entities.\n   */\n  count(filter: Filter): Promise<number>;\n\n  /**\n   * (Optional) Returns the raw response from the data source.\n   * Useful for debugging or exposing advanced querying features (e.g., OpenSearch DSL).\n   *\n   * @param filter - Filtering and query options.\n   * @returns A raw result object from the data source.\n   */\n  getRaw?(filter: Filter): Promise<any>;\n\n  /**\n   * Adjusts a numeric field in the database by adding or subtracting a specified value.\n   * If the field does not exist, it will be initialized to zero before applying the adjustment.\n   *\n   * @param id - The unique identifier of the item to update.\n   * @param fieldName - The name of the numeric field to modify.\n   * @param delta - The amount to add (positive) or subtract (negative) from the field.\n   * @returns The updated item after the adjustment.\n   * @throws Will throw an error if the id is not provided.\n   */\n}\n"]}
+{"version":3,"file":"base-core.repo.interface.js","sourceRoot":"","sources":["../../src/repositories/base-core.repo.interface.ts"],"names":[],"mappings":"","sourcesContent":["import { List } from \"@chinggis/types\";\nimport { BaseEntity, Filter } from \"@chinggis/core\";\n\n/**\n * Core repository interface defining standard CRUD and query operations.\n * Designed to be implemented for different data sources such as DynamoDB or OpenSearch.\n */\nexport interface CoreRepo<T extends BaseEntity> {\n  /**\n   * Checks whether an entity with the specified ID exists.\n   *\n   * @param id - The ID of the entity to check.\n   * @returns True if the entity exists; otherwise, false.\n   */\n  exists(id: string): Promise<boolean>;\n\n  /**\n   * Retrieves a single entity by its unique identifier.\n   *\n   * @param id - The ID of the entity to retrieve.\n   * @returns The entity if found; otherwise, null.\n   */\n  findById(id: string): Promise<T | null>;\n\n  /**\n   * Retrieves multiple entities by their unique identifiers.\n   * Returns only the entities that exist (non-existent IDs are ignored).\n   *\n   * @param ids - An array of entity IDs to retrieve.\n   * @returns An array of entities that were found.\n   */\n  findByIds(ids: string[]): Promise<T[]>;\n\n  /**\n   * Reads a page of entities from the backing query mechanism.\n   *\n   * DynamoDB implementations must treat this as Query-only and reject non-indexed\n   * filters. Search implementations may translate the filter into their native\n   * search query format.\n   *\n   * @param filter - Query/search filter.\n   * @param debug - When true, logs the generated backing-store query.\n   * @returns One page of matching entities.\n   */\n  find(filter: Filter, debug?: boolean): Promise<List<Partial<T>>>;\n\n  fieldNotExists(fieldName: string, from: number, size: number): Promise<T[]>;\n\n  /**\n   * Retrieves the first matching entity based on the specified filter.\n   *\n   * @param filter - Filtering criteria.\n   * @returns The first matching entity if found; otherwise, null.\n   */\n  findOne(filter: Filter): Promise<Partial<T> | null>;\n\n  /**\n   * Counts the total number of entities matching the specified filter.\n   * Useful for pagination and statistics.\n   *\n   * @param filter - Filtering criteria.\n   * @returns The number of matching entities.\n   */\n  count(filter: Filter): Promise<number>;\n\n  /**\n   * (Optional) Returns the raw response from the data source.\n   * Useful for debugging or exposing advanced querying features (e.g., OpenSearch DSL).\n   *\n   * @param filter - Filtering and query options.\n   * @returns A raw result object from the data source.\n   */\n  getRaw?(filter: Filter): Promise<any>;\n\n  /**\n   * Adjusts a numeric field in the database by adding or subtracting a specified value.\n   * If the field does not exist, it will be initialized to zero before applying the adjustment.\n   *\n   * @param id - The unique identifier of the item to update.\n   * @param fieldName - The name of the numeric field to modify.\n   * @param delta - The amount to add (positive) or subtract (negative) from the field.\n   * @returns The updated item after the adjustment.\n   * @throws Will throw an error if the id is not provided.\n   */\n}\n"]}

package/dist/repositories/base-db.repo.d.ts

@@ -19,8 +19,8 @@ export declare class BaseRepoDBImpl<T extends BaseEntity> implements BaseRepoDB<
     deleteMany(ids: string[]): Promise<boolean>;
     findById(id: string): Promise<T>;
     findByIds(ids: string[]): Promise<T[]>;
-    find(filter: Filter): Promise<List<Partial<T>>>;
-    scan(filter: Filter): Promise<List<Partial<T>>>;
+    find(filter: Filter, debug?: boolean): Promise<List<Partial<T>>>;
+    scan(filter: Filter, debug?: boolean): Promise<List<Partial<T>>>;
     findOne(filter: Filter): Promise<T>;
     findByIndex(indexName: string, value: string): Promise<List<Partial<T>>>;
     count(filter: Filter): Promise<number>;
@@ -60,15 +60,21 @@ export declare class BaseRepoDBImpl<T extends BaseEntity> implements BaseRepoDB<
     private saveManyTransactional;
     private incrementOrDecrementFieldValue;
     /**
-     * Executes a DynamoDB Query or Scan and returns up to the desired number of items,
-     * respecting DynamoDB's 1MB limit (pagination continuation via LastEvaluatedKey).
-     * @param queryInput - QueryCommandInput or ScanCommandInput
-     * @param startKey - Optional start key for pagination
+     * Runs repeated Scan requests until enough filtered items are collected, the
+     * table ends, or the caller's scan-request limit is reached.
      */
     private sendCommandDeep;
     /**
-     * Executes a single Query/Scan and returns the result as-is.
-     * Supports pagination via ExclusiveStartKey.
+     * Enforces the per-call safety limit for scan pagination.
+     */
+    private validateScanQueryCountLimit;
+    /**
+     * Executes one DynamoDB Query/Scan page and returns DynamoDB's pagination key.
+     */
+    private sendCommandPage;
+    /**
+     * Sends one QueryCommand or ScanCommand after applying table/default limit.
      */
     private sendCommand;
 }
+//# sourceMappingURL=base-db.repo.d.ts.map

package/dist/repositories/base-db.repo.d.ts.map

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

package/dist/repositories/base-db.repo.interface.d.ts

@@ -142,10 +142,30 @@ export interface BaseRepoDB<T extends BaseEntity> extends CoreRepo<T> {
     getIndexMap(): DynamoIndexMap;
     setTable(name: string): boolean;
     getTableName(): string;
-    /** Executes a DynamoDB Query strictly (requires indexName and indexValue). */
-    find(filter: Filter): Promise<List<Partial<T>>>;
-    /** Executes a DynamoDB Scan with optional non-index filters. */
-    scan(filter: Filter): Promise<List<Partial<T>>>;
+    /**
+     * Executes a DynamoDB Query strictly.
+     *
+     * The filter must contain `indexName` and `indexValue`. Sort-key fields are
+     * converted to key conditions when the selected index has `sortKeyField`.
+     * This method never falls back to Scan.
+     *
+     * @param filter - DynamoDB query filter.
+     * @param debug - When true, logs the generated QueryCommand input.
+     * @returns One DynamoDB query page.
+     */
+    find(filter: Filter, debug?: boolean): Promise<List<Partial<T>>>;
+    /**
+     * Executes a DynamoDB Scan with optional non-index filters.
+     *
+     * `queryCountLimit` is required and must be between 1 and 500. It limits how
+     * many ScanCommand requests one call may issue while trying to collect up to
+     * `size` matching items.
+     *
+     * @param filter - Scan filter. Must include `queryCountLimit`.
+     * @param debug - When true, logs each generated ScanCommand input.
+     * @returns Matching items and an optional `lastKey`.
+     */
+    scan(filter: Filter, debug?: boolean): Promise<List<Partial<T>>>;
     /**
      * Atomically increments a numeric field. Supports nested map attributes via `nestedFieldSeparator`.
      * Initializes to `0` if the field does not exist. Leaf field must be in `indexMap.numberFields`.
@@ -175,3 +195,4 @@ export interface BaseRepoDB<T extends BaseEntity> extends CoreRepo<T> {
      */
     decrementValueByField(entityId: string, fieldName: string, value?: number, nestedFieldSeparator?: string): Promise<T>;
 }
+//# sourceMappingURL=base-db.repo.interface.d.ts.map

package/dist/repositories/base-db.repo.interface.d.ts.map

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

package/dist/repositories/base-db.repo.interface.js.map

@@ -1 +1 @@
-{"version":3,"file":"base-db.repo.interface.js","sourceRoot":"","sources":["../../src/repositories/base-db.repo.interface.ts"],"names":[],"mappings":"","sourcesContent":["import { DynamoIndexMap, List } from \"../index\";\nimport { CoreRepo } from \"./base-core.repo.interface\";\n\nimport { BaseEntity, Filter } from \"@chinggis/types\";\n\nexport interface BaseRepoDB<T extends BaseEntity> extends CoreRepo<T> {\n  /**\n   * Saves an entity by either creating it (if it does not exist) or updating it (if it does).\n   *\n   * @param entity - The entity to save.\n   * @returns The saved entity.\n   */\n  save(entity: Partial<T>): Promise<T>;\n\n  /**\n   * Saves multiple entities by either creating or updating each one.\n   *\n   * @param entities - An array of entities to save.\n   * @param isTransactional - Optional flag to indicate if the operation should be transactional.\n   * @returns An array of saved entities.\n   */\n  saveMany(entities: Partial<T>[], isTransactional?: boolean): Promise<Partial<T>[]>;\n\n  /**\n   * Updates an existing entity.\n   * Fails if the entity does not exist.\n   *\n   * @param entity - The entity with updated data.\n   * @returns The updated entity.\n   */\n  update(entity: Partial<T>): Promise<T>;\n\n  /**\n   * Updates only selected fields of one entity identified by its partition key.\n   * Supports nested paths using dot notation (e.g. `author.name`).\n   *\n   * This is a convenience wrapper over `updateMany` for single-item updates.\n   *\n   * @param entityId - Partition key value of the entity.\n   * @param fields - Field names that should be updated.\n   * @returns True if the update request is accepted; otherwise, false.\n   */\n  updateFields(entity: Partial<T>, fields: string[]): Promise<Partial<T>>;\n\n  /**\n   * Updates multiple existing entities.\n   *\n   * If `fieldNames` is **not provided**, the method performs a **batch update**\n   * (e.g., using `BatchWriteItem` in DynamoDB, if supported). In this case, entire entities\n   * are replaced or merged as a whole.\n   *\n   * If `fieldNames` **is provided**, each entity is updated individually, and only the\n   * specified fields in `fieldNames` will be modified. This approach avoids overwriting\n   * the entire entity and is useful for partial updates.\n   * Field names support dot notation for nested updates (e.g. `author.name`).\n   *\n   * Note:\n   * - Entities must already exist in the data store.\n   * - Batch update is not truly atomic; some partial updates may occur if errors happen mid-way.\n   * - If partial field updates are needed, `fieldNames` must be used.\n   *\n   * @param entities - An array of entities with partial data to update.\n   * @param isTransactional - Optional flag to indicate if the operation should be transactional.\n   * @param fields - field names to update\n   * @returns An array of successfully updated entities.\n   */\n  updateMany(entities: Partial<T>[], fields: string[], isTransactional?: boolean): Promise<boolean>;\n\n  /**\n   * Deletes an entity by its unique identifier.\n   *\n   * @param id - The ID of the entity to delete.\n   * @returns True if the entity was successfully deleted; otherwise, false.\n   */\n  delete(id: string): Promise<boolean>;\n\n  /**\n   * Deletes multiple entities by their unique identifiers.\n   *\n   * @param ids - An array of entity IDs to delete.\n   * @returns True if all entities were successfully deleted; otherwise, false.\n   */\n  deleteMany(ids: string[]): Promise<boolean>;\n\n  /**\n   * Executes a transactional write operation.\n   * DynamoDB typically supports this for atomic operations.\n   *\n   * @param operations - An array of write operations (create, update, delete) to perform atomically.\n   * @returns True if the transaction was successful; otherwise, false.\n   */\n  transactionWrite(operations: {\n    create?: { tableName: string; item: Record<string, any> }[];\n    update?: {\n      tableName: string;\n      key: { id: string };\n      updateData: Record<string, any>;\n    }[];\n    delete?: { tableName: string; key: { id: string } }[];\n  }): Promise<boolean>;\n\n  /**\n   * Executes a transactional read operation.\n   * DynamoDB typically supports this for atomic read operations.\n   *\n   * @param operations - An array of read operations to perform atomically.\n   * @returns An array of results from the transaction.\n   */\n  transactionRead<T>(operations: { id: string; sortKey?: string }[]): Promise<T[]>;\n\n  /**\n   * (Optional) Executes a transactional write operation.\n   * DynamoDB typically only supports this.\n   *\n   * @param operations - An array of write operations to perform atomically.\n   * @returns True if the transaction was successful; otherwise, false.\n   */\n  transactWrite?(operations: any[]): Promise<boolean>;\n\n  /**\n   * Deletes one or more fields (attributes) from a DynamoDB item by its partition key.\n   *\n   * This method uses the `REMOVE` operation of the UpdateExpression to remove specific fields\n   * from an existing item in the table. It dynamically constructs the expression and returns\n   * the updated item (after removal).\n   *\n   * @param id - The value of the partition key for the item to update.\n   * @param fieldNames - An array of attribute names to be removed from the item.\n   * @returns The updated item as a partial object, or `undefined` if no update was performed.\n   */\n  deleteFields(id: string, fieldNames: string[]): Promise<Partial<T>>;\n\n  /**\n   * (Optional) Executes a transactional read operation.\n   * DynamoDB typically only supports this.\n   *\n   * @param operations - An array of read operations to perform atomically.\n   * @returns An array of results from the transaction.\n   */\n  transactRead?<TResult = any>(operations: any[]): Promise<TResult[]>;\n\n  setIndexMap(value: DynamoIndexMap): boolean;\n\n  getIndexMap(): DynamoIndexMap;\n\n  setTable(name: string): boolean;\n\n  getTableName(): string;\n\n  /** Executes a DynamoDB Query strictly (requires indexName and indexValue). */\n  find(filter: Filter): Promise<List<Partial<T>>>;\n\n  /** Executes a DynamoDB Scan with optional non-index filters. */\n  scan(filter: Filter): Promise<List<Partial<T>>>;\n\n  /**\n   * Atomically increments a numeric field. Supports nested map attributes via `nestedFieldSeparator`.\n   * Initializes to `0` if the field does not exist. Leaf field must be in `indexMap.numberFields`.\n   *\n   * @param entityId - Partition key of the item.\n   * @param fieldName - Field name or separator-delimited path (e.g. `\"stats.views\"`).\n   * @param value - Amount to increment. Defaults to `1`. Must be positive.\n   * @param nestedFieldSeparator - If provided, splits `fieldName` into a nested path.\n   *\n   * @example\n   * repo.incrementValueByField(id, \"views\");\n   * repo.incrementValueByField(id, \"stats.monthly.views\", 5, \".\");\n   */\n  incrementValueByField(entityId: string, fieldName: string, value?: number, nestedFieldSeparator?: string): Promise<T>;\n\n  /**\n   * Atomically decrements a numeric field. Supports nested map attributes via `nestedFieldSeparator`.\n   * Initializes to `0` if the field does not exist. Leaf field must be in `indexMap.numberFields`.\n   *\n   * @param entityId - Partition key of the item.\n   * @param fieldName - Field name or separator-delimited path (e.g. `\"stats.stock\"`).\n   * @param value - Amount to decrement. Defaults to `-1`. Must be negative.\n   * @param nestedFieldSeparator - If provided, splits `fieldName` into a nested path.\n   *\n   * @example\n   * repo.decrementValueByField(id, \"stock\");\n   * repo.decrementValueByField(id, \"stats.monthly.stock\", -3, \".\");\n   */\n  decrementValueByField(entityId: string, fieldName: string, value?: number, nestedFieldSeparator?: string): Promise<T>;\n}\n"]}
+{"version":3,"file":"base-db.repo.interface.js","sourceRoot":"","sources":["../../src/repositories/base-db.repo.interface.ts"],"names":[],"mappings":"","sourcesContent":["import { DynamoIndexMap, List } from \"../index\";\nimport { CoreRepo } from \"./base-core.repo.interface\";\n\nimport { BaseEntity, Filter } from \"@chinggis/types\";\n\nexport interface BaseRepoDB<T extends BaseEntity> extends CoreRepo<T> {\n  /**\n   * Saves an entity by either creating it (if it does not exist) or updating it (if it does).\n   *\n   * @param entity - The entity to save.\n   * @returns The saved entity.\n   */\n  save(entity: Partial<T>): Promise<T>;\n\n  /**\n   * Saves multiple entities by either creating or updating each one.\n   *\n   * @param entities - An array of entities to save.\n   * @param isTransactional - Optional flag to indicate if the operation should be transactional.\n   * @returns An array of saved entities.\n   */\n  saveMany(entities: Partial<T>[], isTransactional?: boolean): Promise<Partial<T>[]>;\n\n  /**\n   * Updates an existing entity.\n   * Fails if the entity does not exist.\n   *\n   * @param entity - The entity with updated data.\n   * @returns The updated entity.\n   */\n  update(entity: Partial<T>): Promise<T>;\n\n  /**\n   * Updates only selected fields of one entity identified by its partition key.\n   * Supports nested paths using dot notation (e.g. `author.name`).\n   *\n   * This is a convenience wrapper over `updateMany` for single-item updates.\n   *\n   * @param entityId - Partition key value of the entity.\n   * @param fields - Field names that should be updated.\n   * @returns True if the update request is accepted; otherwise, false.\n   */\n  updateFields(entity: Partial<T>, fields: string[]): Promise<Partial<T>>;\n\n  /**\n   * Updates multiple existing entities.\n   *\n   * If `fieldNames` is **not provided**, the method performs a **batch update**\n   * (e.g., using `BatchWriteItem` in DynamoDB, if supported). In this case, entire entities\n   * are replaced or merged as a whole.\n   *\n   * If `fieldNames` **is provided**, each entity is updated individually, and only the\n   * specified fields in `fieldNames` will be modified. This approach avoids overwriting\n   * the entire entity and is useful for partial updates.\n   * Field names support dot notation for nested updates (e.g. `author.name`).\n   *\n   * Note:\n   * - Entities must already exist in the data store.\n   * - Batch update is not truly atomic; some partial updates may occur if errors happen mid-way.\n   * - If partial field updates are needed, `fieldNames` must be used.\n   *\n   * @param entities - An array of entities with partial data to update.\n   * @param isTransactional - Optional flag to indicate if the operation should be transactional.\n   * @param fields - field names to update\n   * @returns An array of successfully updated entities.\n   */\n  updateMany(entities: Partial<T>[], fields: string[], isTransactional?: boolean): Promise<boolean>;\n\n  /**\n   * Deletes an entity by its unique identifier.\n   *\n   * @param id - The ID of the entity to delete.\n   * @returns True if the entity was successfully deleted; otherwise, false.\n   */\n  delete(id: string): Promise<boolean>;\n\n  /**\n   * Deletes multiple entities by their unique identifiers.\n   *\n   * @param ids - An array of entity IDs to delete.\n   * @returns True if all entities were successfully deleted; otherwise, false.\n   */\n  deleteMany(ids: string[]): Promise<boolean>;\n\n  /**\n   * Executes a transactional write operation.\n   * DynamoDB typically supports this for atomic operations.\n   *\n   * @param operations - An array of write operations (create, update, delete) to perform atomically.\n   * @returns True if the transaction was successful; otherwise, false.\n   */\n  transactionWrite(operations: {\n    create?: { tableName: string; item: Record<string, any> }[];\n    update?: {\n      tableName: string;\n      key: { id: string };\n      updateData: Record<string, any>;\n    }[];\n    delete?: { tableName: string; key: { id: string } }[];\n  }): Promise<boolean>;\n\n  /**\n   * Executes a transactional read operation.\n   * DynamoDB typically supports this for atomic read operations.\n   *\n   * @param operations - An array of read operations to perform atomically.\n   * @returns An array of results from the transaction.\n   */\n  transactionRead<T>(operations: { id: string; sortKey?: string }[]): Promise<T[]>;\n\n  /**\n   * (Optional) Executes a transactional write operation.\n   * DynamoDB typically only supports this.\n   *\n   * @param operations - An array of write operations to perform atomically.\n   * @returns True if the transaction was successful; otherwise, false.\n   */\n  transactWrite?(operations: any[]): Promise<boolean>;\n\n  /**\n   * Deletes one or more fields (attributes) from a DynamoDB item by its partition key.\n   *\n   * This method uses the `REMOVE` operation of the UpdateExpression to remove specific fields\n   * from an existing item in the table. It dynamically constructs the expression and returns\n   * the updated item (after removal).\n   *\n   * @param id - The value of the partition key for the item to update.\n   * @param fieldNames - An array of attribute names to be removed from the item.\n   * @returns The updated item as a partial object, or `undefined` if no update was performed.\n   */\n  deleteFields(id: string, fieldNames: string[]): Promise<Partial<T>>;\n\n  /**\n   * (Optional) Executes a transactional read operation.\n   * DynamoDB typically only supports this.\n   *\n   * @param operations - An array of read operations to perform atomically.\n   * @returns An array of results from the transaction.\n   */\n  transactRead?<TResult = any>(operations: any[]): Promise<TResult[]>;\n\n  setIndexMap(value: DynamoIndexMap): boolean;\n\n  getIndexMap(): DynamoIndexMap;\n\n  setTable(name: string): boolean;\n\n  getTableName(): string;\n\n  /**\n   * Executes a DynamoDB Query strictly.\n   *\n   * The filter must contain `indexName` and `indexValue`. Sort-key fields are\n   * converted to key conditions when the selected index has `sortKeyField`.\n   * This method never falls back to Scan.\n   *\n   * @param filter - DynamoDB query filter.\n   * @param debug - When true, logs the generated QueryCommand input.\n   * @returns One DynamoDB query page.\n   */\n  find(filter: Filter, debug?: boolean): Promise<List<Partial<T>>>;\n\n  /**\n   * Executes a DynamoDB Scan with optional non-index filters.\n   *\n   * `queryCountLimit` is required and must be between 1 and 500. It limits how\n   * many ScanCommand requests one call may issue while trying to collect up to\n   * `size` matching items.\n   *\n   * @param filter - Scan filter. Must include `queryCountLimit`.\n   * @param debug - When true, logs each generated ScanCommand input.\n   * @returns Matching items and an optional `lastKey`.\n   */\n  scan(filter: Filter, debug?: boolean): Promise<List<Partial<T>>>;\n\n  /**\n   * Atomically increments a numeric field. Supports nested map attributes via `nestedFieldSeparator`.\n   * Initializes to `0` if the field does not exist. Leaf field must be in `indexMap.numberFields`.\n   *\n   * @param entityId - Partition key of the item.\n   * @param fieldName - Field name or separator-delimited path (e.g. `\"stats.views\"`).\n   * @param value - Amount to increment. Defaults to `1`. Must be positive.\n   * @param nestedFieldSeparator - If provided, splits `fieldName` into a nested path.\n   *\n   * @example\n   * repo.incrementValueByField(id, \"views\");\n   * repo.incrementValueByField(id, \"stats.monthly.views\", 5, \".\");\n   */\n  incrementValueByField(entityId: string, fieldName: string, value?: number, nestedFieldSeparator?: string): Promise<T>;\n\n  /**\n   * Atomically decrements a numeric field. Supports nested map attributes via `nestedFieldSeparator`.\n   * Initializes to `0` if the field does not exist. Leaf field must be in `indexMap.numberFields`.\n   *\n   * @param entityId - Partition key of the item.\n   * @param fieldName - Field name or separator-delimited path (e.g. `\"stats.stock\"`).\n   * @param value - Amount to decrement. Defaults to `-1`. Must be negative.\n   * @param nestedFieldSeparator - If provided, splits `fieldName` into a nested path.\n   *\n   * @example\n   * repo.decrementValueByField(id, \"stock\");\n   * repo.decrementValueByField(id, \"stats.monthly.stock\", -3, \".\");\n   */\n  decrementValueByField(entityId: string, fieldName: string, value?: number, nestedFieldSeparator?: string): Promise<T>;\n}\n"]}

package/dist/repositories/base-db.repo.js

@@ -256,7 +256,7 @@ class BaseRepoDBImpl {
         }
         return items;
     }
-    async find(filter) {
+    async find(filter, debug) {
         if (!filter)
             filter = { size: this.DYNAMO_QUERY_LIMIT };
         // Enforce Query-only: require indexName & indexValue; otherwise instruct the caller to use scan
@@ -269,16 +269,17 @@ class BaseRepoDBImpl {
             filterCondition: (0, index_1.buildDynamoDBFilterConditions)(filter, this._indexMap),
             indexMap: this._indexMap,
         });
-        const response = await this.sendCommandDeep(dbQuery, filter?.lastKey);
+        const response = await this.sendCommandPage(dbQuery, filter?.lastKey, debug);
         const fieldsRemoved = (0, index_1.removeFields)(response?.items, filter.fieldsInclude, filter.fieldsExclude);
         return { items: fieldsRemoved, lastKey: response?.lastKey };
     }
-    async scan(filter) {
+    async scan(filter, debug) {
         if (!filter)
             filter = { size: this.DYNAMO_QUERY_LIMIT };
+        const queryCountLimit = this.validateScanQueryCountLimit(filter);
         const expression = (0, index_1.buildDynamoDBFilterConditions)(filter, this._indexMap);
         const scanInput = (0, index_1.buildDynamoDBScanCommand)({ tableName: this._tableName, filter, expression });
-        const response = await this.sendCommandDeep(scanInput, filter?.lastKey);
+        const response = await this.sendCommandDeep(scanInput, filter?.lastKey, queryCountLimit, filter?.size ?? this.DYNAMO_QUERY_LIMIT, debug);
         const fieldsRemoved = (0, index_1.removeFields)(response?.items, filter.fieldsInclude, filter.fieldsExclude);
         return { items: fieldsRemoved, lastKey: response?.lastKey };
     }
@@ -497,14 +498,12 @@ class BaseRepoDBImpl {
         return (0, util_dynamodb_1.unmarshall)(result.Attributes);
     }
     /**
-     * Executes a DynamoDB Query or Scan and returns up to the desired number of items,
-     * respecting DynamoDB's 1MB limit (pagination continuation via LastEvaluatedKey).
-     * @param queryInput - QueryCommandInput or ScanCommandInput
-     * @param startKey - Optional start key for pagination
+     * Runs repeated Scan requests until enough filtered items are collected, the
+     * table ends, or the caller's scan-request limit is reached.
      */
-    async sendCommandDeep(queryInput, startKey) {
+    async sendCommandDeep(queryInput, startKey, queryCountLimit, size = this.DYNAMO_QUERY_LIMIT, debug) {
         const result = { items: [] };
-        const size = queryInput?.Limit ?? 10;
+        let scannedCount = 0;
         let lastEvaluatedKey;
         if (startKey) {
             lastEvaluatedKey =
@@ -513,52 +512,97 @@ class BaseRepoDBImpl {
                     : startKey;
         }
         do {
+            const remainingQueryCount = queryCountLimit === undefined ? undefined : queryCountLimit - scannedCount;
+            if (remainingQueryCount !== undefined && remainingQueryCount <= 0) {
+                result.lastKey = lastEvaluatedKey ? (0, index_1.toBase64)(JSON.stringify(lastEvaluatedKey)) : undefined;
+                return result;
+            }
             const response = await this.sendCommand({
                 ...queryInput,
                 ExclusiveStartKey: lastEvaluatedKey,
-            });
+            }, debug);
+            const responseItems = response.Items ?? [];
+            scannedCount++;
+            if (result.items.length + responseItems.length > size) {
+                const takeCount = size - result.items.length;
+                const lastIncludedIndex = takeCount - 1;
+                result.items.push(...(0, index_1.unMarshall)(responseItems.slice(0, takeCount)));
+                const index = this._indexMap.get(queryInput.IndexName);
+                result.lastKey = (0, index_1.generateLastEvaluatedKey)(responseItems[lastIncludedIndex], index?.field ?? this._indexMap.partitionKey, index?.sortKeyField);
+                return result;
+            }
             // no more items to fetch
             if (response.LastEvaluatedKey == undefined) {
-                result?.items.push(...(0, index_1.unMarshall)(response.Items));
+                result?.items.push(...(0, index_1.unMarshall)(responseItems));
                 result.lastKey = undefined;
                 return result;
             }
-            if (response?.Items.length === 0 && response.LastEvaluatedKey) {
+            if (responseItems.length === 0 && response.LastEvaluatedKey) {
                 lastEvaluatedKey = response.LastEvaluatedKey;
+                if (queryCountLimit !== undefined && scannedCount >= queryCountLimit) {
+                    result.lastKey = (0, index_1.toBase64)(JSON.stringify(response.LastEvaluatedKey));
+                    return result;
+                }
                 continue;
             }
-            if (result?.items.length + response?.Items.length <= size) {
-                result?.items.push(...(0, index_1.unMarshall)(response.Items));
+            if (result?.items.length + responseItems.length <= size) {
+                result?.items.push(...(0, index_1.unMarshall)(responseItems));
                 lastEvaluatedKey = response.LastEvaluatedKey;
                 if (result?.items.length === size) {
                     result.lastKey = (0, index_1.toBase64)(JSON.stringify(response.LastEvaluatedKey));
                     return result;
                 }
+                if (queryCountLimit !== undefined && scannedCount >= queryCountLimit) {
+                    result.lastKey = (0, index_1.toBase64)(JSON.stringify(response.LastEvaluatedKey));
+                    return result;
+                }
                 continue;
             }
-            const elementIndex = size - result?.items.length - 1;
-            result?.items.push(...(0, index_1.unMarshall)(response.Items.slice(0, elementIndex)));
-            const index = this._indexMap.get(queryInput.IndexName);
-            result.lastKey = (0, index_1.generateLastEvaluatedKey)(response.Items[elementIndex], index?.field, index?.sortKeyField);
-            break;
         } while (lastEvaluatedKey);
         return result;
     }
     /**
-     * Executes a single Query/Scan and returns the result as-is.
-     * Supports pagination via ExclusiveStartKey.
+     * Enforces the per-call safety limit for scan pagination.
+     */
+    validateScanQueryCountLimit(filter) {
+        const value = Number(filter.queryCountLimit);
+        if (!Number.isInteger(value) || value <= 0) {
+            throw new errors_1.ErrorDynamoDB(this._tableName, "scan", "scan requires queryCountLimit");
+        }
+        if (value > 500) {
+            throw new errors_1.ErrorDynamoDB(this._tableName, "scan", "scan queryCountLimit must not be greater than 500");
+        }
+        return value;
+    }
+    /**
+     * Executes one DynamoDB Query/Scan page and returns DynamoDB's pagination key.
+     */
+    async sendCommandPage(queryInput, startKey, debug) {
+        if (startKey) {
+            queryInput.ExclusiveStartKey =
+                typeof startKey === "string" ? (0, index_1.parseLastEvaluatedKey)(startKey) : startKey;
+        }
+        const response = await this.sendCommand(queryInput, debug);
+        return {
+            items: (0, index_1.unMarshall)(response.Items),
+            lastKey: response.LastEvaluatedKey ? (0, index_1.toBase64)(JSON.stringify(response.LastEvaluatedKey)) : undefined,
+        };
+    }
+    /**
+     * Sends one QueryCommand or ScanCommand after applying table/default limit.
      */
-    async sendCommand(commandInput) {
+    async sendCommand(commandInput, debug) {
         commandInput.TableName = this._tableName;
         // if (startKey) {
         //   commandInput.ExclusiveStartKey = typeof startKey === "string" ? parseLastEvaluatedKey(startKey) : startKey;
         // }
-        if (!commandInput.Limit) {
+        const isQuery = "KeyConditionExpression" in commandInput;
+        if (isQuery && !commandInput.Limit) {
             commandInput.Limit = this.DYNAMO_QUERY_LIMIT;
         }
-        const isQuery = "KeyConditionExpression" in commandInput;
         const command = isQuery ? new client_dynamodb_1.QueryCommand(commandInput) : new client_dynamodb_1.ScanCommand(commandInput);
-        log.debug("Sending command:", commandInput);
+        if (debug)
+            log.debug("Sending command:", commandInput);
         if (!this.dynamoDb)
             throw new errors_1.ErrorDynamoDB(this._tableName, commandInput, "dynamoDB client not initialized");
         try {