@point-hub/papi 0.6.6 → 0.7.2

package/lib/src/app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/app.ts"],"names":[],"mappings":"AAAA,OAAO,OAAuC,MAAM,SAAS,CAAA;AAE7D,wBAAsB,SAAS,6BAU9B"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/app.ts"],"names":[],"mappings":"AAAA,OAAO,OAAuC,MAAM,SAAS,CAAC;AAE9D,wBAAsB,SAAS,6BAU9B"}

package/lib/src/base-usecase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-usecase.d.ts","sourceRoot":"","sources":["../../src/base-usecase.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,MAAM,EAAE,SAAS,CAAA;IACjB,IAAI,EAAE,CAAC,CAAA;CACR;AAGD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE;QACP,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;KACxB,CAAA;CACF;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,QAAQ,CAAC;IACjB,KAAK,EAAE,aAAa,CAAA;CACrB;AAED;;;;;;;;;GASG;AACH,8BAAsB,WAAW,CAC/B,MAAM,EACN,aAAa,EACb,YAAY;IAEZ,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;gBAE1B,IAAI,EAAE,aAAa;IAI/B;;;;OAIG;IACH,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,YAAY,GAAG,qBAAqB,CAAC,YAAY,CAAC;IAI1E;;;;OAIG;IACH,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,aAAa,GAAG,oBAAoB;IAU1D;;;;;;OAMG;aACa,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,YAAY,CAAC,GAAG,oBAAoB,CAAC;CAC3G"}
+{"version":3,"file":"base-usecase.d.ts","sourceRoot":"","sources":["../../src/base-usecase.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,MAAM,EAAE,SAAS,CAAA;IACjB,IAAI,EAAE,CAAC,CAAA;CACR;AAGD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE;QACP,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;KACxB,CAAA;CACF;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,QAAQ,CAAC;IACjB,KAAK,EAAE,aAAa,CAAA;CACrB;AAED;;;;;;;;;GASG;AACH,8BAAsB,WAAW,CAC/B,MAAM,EACN,aAAa,EACb,YAAY;IAEZ,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;gBAE3B,IAAI,EAAE,aAAa;IAI/B;;;;OAIG;IACH,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,YAAY,GAAG,qBAAqB,CAAC,YAAY,CAAC;IAI1E;;;;OAIG;IACH,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,aAAa,GAAG,oBAAoB;IAU1D;;;;;;OAMG;aACa,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,YAAY,CAAC,GAAG,oBAAoB,CAAC;CAC3G"}

package/lib/src/console/commands/make-command/index.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.command.d.ts","sourceRoot":"","sources":["../../../../../src/console/commands/make-command/index.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAS,MAAM,wBAAwB,CAAA;AAO3D,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,WAAW;;IAe5C,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CA6B9B"}
+{"version":3,"file":"index.command.d.ts","sourceRoot":"","sources":["../../../../../src/console/commands/make-command/index.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAS,MAAM,wBAAwB,CAAC;AAO5D,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,WAAW;;IAe5C,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CA6B9B"}

package/lib/src/console/commands/make-middleware/index.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.command.d.ts","sourceRoot":"","sources":["../../../../../src/console/commands/make-middleware/index.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAS,MAAM,wBAAwB,CAAA;AAO3D,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,WAAW;;IAuB/C,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB7B,OAAO,CAAC,cAAc;IAmBtB,OAAO,CAAC,2BAA2B;CAkBpC"}
+{"version":3,"file":"index.command.d.ts","sourceRoot":"","sources":["../../../../../src/console/commands/make-middleware/index.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAS,MAAM,wBAAwB,CAAC;AAO5D,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,WAAW;;IAuB/C,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IA+B7B,OAAO,CAAC,cAAc;IAmBtB,OAAO,CAAC,2BAA2B;CAkBpC"}

package/lib/src/console/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/console/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAKnD,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAY;gBAEf,OAAO,EAAE,UAAU;IAI/B;;;;;OAKG;IACG,QAAQ;CAIf"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/console/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAKpD,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAa;gBAEhB,OAAO,EAAE,UAAU;IAI/B;;;;;OAKG;IACG,QAAQ;CAIf"}

package/lib/src/database/mongodb/mongo-error-handler.d.ts

@@ -0,0 +1,51 @@
+import { BaseError, type IError } from '@point-hub/express-error-handler';
+import { MongoServerError } from 'mongodb';
+/**
+ * Converts a MongoDB schema validation error into an HTTP validation error.
+ *
+ * Extracts missing required properties from MongoDB schema validation details
+ * and generates a validation message for each missing property.
+ *
+ * @param err - MongoDB server error with code 121.
+ * @param error - HTTP validation error to populate.
+ * @returns The HTTP validation error containing missing property errors.
+ */
+export declare function handleSchemaValidation(err: MongoServerError, error: IError): IError;
+/**
+ * Converts a MongoDB duplicate key error into an HTTP validation error.
+ *
+ * Generates a validation message for a single duplicated field or a
+ * combination of fields when a compound unique index is violated.
+ *
+ * @param err - MongoDB server error with code 11000.
+ * @param error - HTTP validation error to populate.
+ * @returns The HTTP validation error containing duplicate key errors.
+ */
+export declare function handleUniqueValidation(err: MongoServerError, error: IError): IError;
+/**
+ * Handles MongoDB server errors and converts supported errors into
+ * HTTP 422 validation errors.
+ *
+ * Supported MongoDB error codes:
+ * - 121: Document schema validation failure.
+ * - 11000: Duplicate key constraint violation.
+ *
+ * @extends BaseError
+ */
+export declare class MongoErrorHandler extends BaseError {
+    /**
+     * Creates a MongoDB error handler.
+     *
+     * @param err - MongoDB server error to handle.
+     */
+    constructor(err: MongoServerError);
+    /**
+     * Indicates whether the error is operational and expected to be handled.
+     */
+    get isOperational(): boolean;
+    /**
+     * Returns the error class name.
+     */
+    get name(): string;
+}
+//# sourceMappingURL=mongo-error-handler.d.ts.map

package/lib/src/database/mongodb/mongo-error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongo-error-handler.d.ts","sourceRoot":"","sources":["../../../../src/database/mongodb/mongo-error-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EAET,KAAK,MAAM,EAEZ,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE3C;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAYnF;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAuBnF;AAED;;;;;;;;;GASG;AACH,qBAAa,iBAAkB,SAAQ,SAAS;IAC9C;;;;OAIG;gBACS,GAAG,EAAE,gBAAgB;IAejC;;OAEG;IACH,IAAI,aAAa,YAEhB;IAED;;OAEG;IACH,IAAa,IAAI,WAEhB;CACF"}

package/lib/src/database/mongodb/mongo-error-handler.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mongo-error-handler.spec.d.ts.map

package/lib/src/database/mongodb/mongo-error-handler.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongo-error-handler.spec.d.ts","sourceRoot":"","sources":["../../../../src/database/mongodb/mongo-error-handler.spec.ts"],"names":[],"mappings":""}

package/lib/src/database/mongodb/mongo-query-builder.utils.d.ts

@@ -0,0 +1,483 @@
+import type { SortDirection } from 'mongodb';
+export interface IFieldsObject {
+    [key: string]: number;
+}
+export interface ISortObject {
+    [key: string]: SortDirection;
+}
+export interface IMongoUpdate {
+    $set?: Record<string, unknown>;
+    $unset?: Record<string, true>;
+}
+/**
+ * Parses a page query parameter into a positive integer.
+ *
+ * @param value - Page number as a string or number. Defaults to `1`.
+ * @returns Parsed page number or `1` if the value is invalid.
+ *
+ * @example
+ * parsePage('10') // => 10
+ * parsePage(10) // => 10
+ * parsePage('abc') // => 1
+ * parsePage(0) // => 1
+ */
+export declare function parsePage(value?: string | number): number;
+/**
+ * Parses a page size query parameter into a positive integer.
+ *
+ * @param value - Number of records per page. Defaults to `10`.
+ * @returns Parsed page size or `10` if the value is invalid.
+ *
+ * @example
+ * parsePageSize('10') // => 10
+ * parsePageSize(10) // => 10
+ * parsePageSize('abc') // => 10
+ * parsePageSize(0) // => 10
+ */
+export declare function parsePageSize(value?: string | number): number;
+/**
+ * Calculates the number of records to skip for pagination.
+ *
+ * @param currentPage - Current page number.
+ * @param pageSize - Number of records per page.
+ * @returns Number of records to skip.
+ *
+ * @example
+ * calculateSkip(1, 10) // => 0
+ * calculateSkip(2, 10) // => 10
+ * calculateSkip(3, 10) // => 20
+ */
+export declare function calculateSkip(currentPage: string | number, pageSize: string | number): number;
+/**
+ * Converts a comma-separated or space-separated field string
+ * into a MongoDB projection object.
+ *
+ * Supports either inclusion or exclusion projections.
+ * Excluded fields cannot be combined with included fields,
+ * except for MongoDB's special `_id` field.
+ *
+ * @param value - Comma-separated or space-separated field names to include.
+ * @param excludedFields - Field names to exclude.
+ * @returns MongoDB projection object.
+ *
+ * @example
+ * parseProjection('name, address')
+ * // => { name: 1, address: 1 }
+ *
+ * parseProjection('', ['password', 'token'])
+ * // => { password: 0, token: 0 }
+ *
+ * parseProjection('name, address', ['_id'])
+ * // => { name: 1, address: 1, _id: 0 }
+ */
+export declare function parseProjection(value?: string, excludedFields?: string[]): IFieldsObject;
+/**
+ * Converts a comma-separated or space-separated string into an array of field names.
+ *
+ * @param value - String containing field names.
+ * @returns Array of trimmed, non-empty field names.
+ *
+ * @example
+ * parseFieldList('name, address')
+ * // => ['name', 'address']
+ *
+ * parseFieldList('name address')
+ * // => ['name', 'address']
+ *
+ * parseFieldList(' name, address ')
+ * // => ['name', 'address']
+ */
+export declare function parseFieldList(value: string): string[];
+/**
+ * Creates a MongoDB projection object from an array of field names.
+ *
+ * @param fields - Array of field names.
+ * @param value - Projection value assigned to each field. Defaults to `1`.
+ * @returns MongoDB projection object.
+ *
+ * @example
+ * createProjection(['name', 'address'])
+ * // => { name: 1, address: 1 }
+ *
+ * createProjection(['name', 'address'], 0)
+ * // => { name: 0, address: 0 }
+ */
+export declare function createProjection(fields: string[], value?: number): IFieldsObject;
+/**
+ * Creates a MongoDB sort object from an array of field names.
+ *
+ * A field prefixed with `-` is sorted in descending order.
+ * Fields without a prefix are sorted in ascending order.
+ *
+ * @param fields - Array of field names with optional negative prefixes.
+ * @returns MongoDB sort object.
+ *
+ * @example
+ * createSort(['-firstName', 'lastName', 'created_at'])
+ * // => { firstName: -1, lastName: 1, created_at: 1 }
+ */
+export declare function createSort(fields: string[]): Record<string, 1 | -1>;
+/**
+ * Excludes specified fields from a MongoDB projection object.
+ *
+ * Modifies the original projection object by assigning `0`
+ * to each excluded field.
+ *
+ * @param projection - MongoDB projection object to modify.
+ * @param fields - Array of field names to exclude.
+ * @returns The modified projection object.
+ *
+ * @example
+ * excludeFields({ name: 1, address: 1 }, ['_id'])
+ * // => { name: 1, address: 1, _id: 0 }
+ */
+export declare function excludeFields(projection: IFieldsObject, fields: string[]): IFieldsObject;
+/**
+ * Parses a comma-separated field string into a MongoDB sort object.
+ *
+ * A field prefixed with `-` is sorted in descending order.
+ * Fields without a prefix are sorted in ascending order.
+ *
+ * @param value - Comma-separated field names with optional negative prefixes.
+ * @returns MongoDB sort object.
+ *
+ * @example
+ * parseSort('name, -createdAt')
+ * // => { name: 1, createdAt: -1 }
+ *
+ * parseSort('-createdAt, name')
+ * // => { createdAt: -1, name: 1 }
+ */
+export declare function parseSort(value: string): ISortObject;
+/**
+ * Adds a case-insensitive regex filter to the filters array if a value is provided.
+ *
+ * @param filters - An array of MongoDB filter objects to be modified.
+ * @param field - The field name to apply the regex on.
+ * @param value - The string value to search for (optional). If empty or only whitespace, no filter is added.
+ *
+ * @example
+ * const filters: Record<string, unknown>[] = []
+ *
+ * addRegexFilter(filters, 'name', 'john')
+ *
+ * // Result:
+ * // [{ name: { $regex: 'john', $options: 'i' } }]
+ */
+export declare const addRegexFilter: (filters: Record<string, unknown>[], field: string, value?: string) => void;
+/**
+ * Adds an exact-match filter to the filters array if a value is provided.
+ *
+ * @param filters - An array of MongoDB filter objects to be modified.
+ * @param field - The field name to match exactly.
+ * @param value - The exact value to match (optional). If empty or only whitespace, no filter is added.
+ *
+ * @example
+ * const filters: Record<string, unknown>[] = []
+ *
+ * addExactFilter(filters, 'status', 'active')
+ *
+ * // Result:
+ * // [{ status: 'active' }]
+ */
+export declare const addExactFilter: (filters: Record<string, unknown>[], field: string, value?: string) => void;
+/**
+ * Parses a boolean value from a string or boolean input.
+ *
+ * - Accepts `true` / `false` booleans directly.
+ * - Converts string values `"true"` and `"false"` to booleans.
+ * - Returns `undefined` for any other value.
+ *
+ * @param value - A boolean or a string representation of a boolean.
+ * @returns `true`, `false`, or `undefined` if the value cannot be parsed.
+ *
+ * @example
+ * parseBoolean(true)       // true
+ * parseBoolean('true')     // true
+ * parseBoolean('false')    // false
+ * parseBoolean('invalid')  // undefined
+ * parseBoolean()           // undefined
+ */
+export declare const parseBoolean: (value?: string | boolean) => boolean | undefined;
+/**
+ * Adds a boolean exact-match filter to the filters array.
+ *
+ * The filter is only added if the value can be successfully parsed
+ * into a boolean (`true` or `false`).
+ *
+ * @param filters - An array of MongoDB filter objects to be modified.
+ * @param field - The field name to match.
+ * @param value - A boolean or string (`"true"` / `"false"`) to match.
+ *
+ * @example
+ * const filters: Record<string, unknown>[] = []
+ *
+ * addBooleanFilter(filters, 'is_active', 'true')
+ * addBooleanFilter(filters, 'is_verified', false)
+ *
+ * // Result:
+ * // [
+ * //   { is_active: true },
+ * //   { is_verified: false }
+ * // ]
+ */
+export declare const addBooleanFilter: (filters: Record<string, unknown>[], field: string, value?: string | boolean) => void;
+/**
+ * Adds a MongoDB date range filter (`$gte` / `$lte`) to the filters array.
+ *
+ * The filter is only added if at least one of `value_from` or `value_to`
+ * is provided and non-empty.
+ *
+ * @param filters - An array of MongoDB filter objects to be modified.
+ * @param field - The date field name to apply the range filter on.
+ * @param value_from - The start date (inclusive) as a string.
+ * @param value_to - The end date (inclusive) as a string.
+ *
+ * @example
+ * const filters: Record<string, unknown>[] = []
+ *
+ * addDateRangeFilter(filters, 'created_at', '2026-01-01', '2026-12-31')
+ *
+ * // Result:
+ * // [
+ * //   {
+ * //     created_at: {
+ * //       $gte: new Date('2026-01-01'),
+ * //       $lte: new Date('2026-12-31')
+ * //     }
+ * //   }
+ * // ]
+ *
+ * @example
+ * const filters: Record<string, unknown>[] = []
+ *
+ * addDateRangeFilter(filters, 'created_at', '2026-01-01')
+ *
+ * // Result:
+ * // [{ created_at: { $gte: new Date('2026-01-01') } }]
+ */
+export declare const addDateRangeFilter: (filters: Record<string, unknown>[], field: string, value_from?: string, value_to?: string) => void;
+/**
+ * Adds a numeric filter to the filters array based on comparison operators or a single value.
+ *
+ * Accepts expressions like `">10<20"`, `"<=15"`, `"=5"` or `"50"` (interpreted as equality).
+ *
+ * @param filters - An array of MongoDB filter objects to be modified.
+ * @param field - The field name to apply the numeric comparison on.
+ * @param value - A string representing the numeric comparison(s).
+ *
+ * @example
+ * const filters: Record<string, unknown>[] = []
+ *
+ * addNumberFilter(filters, 'age', '>=18<65')
+ * addNumberFilter(filters, 'score', '90')
+ *
+ * // Result:
+ * // [
+ * //   { age: { $gte: 18, $lt: 65 } },
+ * //   { score: 90 }
+ * // ]
+ */
+export declare const addNumberFilter: (filters: Record<string, unknown>[], field: string, value?: string) => void;
+/**
+ * Parses a string expression into MongoDB-style numeric comparison operators.
+ *
+ * Supported formats:
+ * - `"50"` → `{ eq: 50 }`
+ * - `">10"` → `{ gt: 10 }`
+ * - `"<=15"` → `{ lte: 15 }`
+ * - `">=5<20"` → `{ gte: 5, lt: 20 }`
+ *
+ * Constraints:
+ * - Only one lower-bound (`>` or `>=`) and one upper-bound (`<` or `<=`) operator are allowed.
+ * - Returns an empty object for malformed or ambiguous expressions.
+ *
+ * @param expr - A string representing numeric comparisons.
+ * @returns An object with numeric comparison constraints.
+ *
+ * @example
+ * parseComparisons('50')
+ * // { eq: 50 }
+ *
+ * parseComparisons('>10')
+ * // { gt: 10 }
+ *
+ * parseComparisons('>=5<20')
+ * // { gte: 5, lt: 20 }
+ *
+ * parseComparisons('<=15')
+ * // { lte: 15 }
+ *
+ * parseComparisons('invalid')
+ * // {}
+ *
+ * @throws Will throw an API error if the input format is invalid or has duplicate bounds.
+ */
+export declare const parseComparisons: (expr: string) => {
+    gt?: number;
+    gte?: number;
+    lt?: number;
+    lte?: number;
+    eq?: number;
+};
+/**
+ * Checks whether a value is a plain object.
+ *
+ * Plain objects have either Object.prototype or null as their prototype.
+ * Arrays, Dates, ObjectIds, and other class instances are excluded.
+ *
+ * @param value - Value to check.
+ * @returns True if the value is a plain object.
+ */
+export declare const isPlainObject: (value: unknown) => value is Record<string, unknown>;
+/**
+ * Builds a MongoDB update document from input data.
+ *
+ * Nested plain objects are recursively flattened into dot-notation paths.
+ * Arrays and other non-plain objects are treated as complete values and
+ * assigned using `$set`.
+ *
+ * Explicit dot-notation keys can be used to update individual nested fields
+ * or array indexes without replacing the entire array.
+ *
+ * Value handling:
+ * - `undefined`: Ignored; the existing field remains unchanged.
+ * - `null`: Added to `$unset` to remove the existing field.
+ * - Plain object: Recursively flattened into dot-notation paths.
+ * - Array: Added to `$set` as a complete array.
+ * - Other values: Added to `$set`.
+ *
+ * @param rawInput - Input data to convert into MongoDB update operations.
+ * @returns MongoDB update document containing `$set` and/or `$unset`.
+ * Returns an empty object when there are no applicable updates.
+ *
+ * @example
+ * // Update primitive and nested fields.
+ * buildUpdateData({
+ *   name: 'John',
+ *   profile: {
+ *     city: 'Surabaya',
+ *     postal_code: '60123',
+ *   },
+ * });
+ *
+ * // Returns:
+ * {
+ *   $set: {
+ *     name: 'John',
+ *     'profile.city': 'Surabaya',
+ *     'profile.postal_code': '60123',
+ *   },
+ * }
+ *
+ * @example
+ * // Replace an entire array.
+ * buildUpdateData({
+ *   tags: ['developer', 'admin'],
+ * });
+ *
+ * // Returns:
+ * {
+ *   $set: {
+ *     tags: ['developer', 'admin'],
+ *   },
+ * }
+ *
+ * @example
+ * // Update a specific array index without replacing the entire array.
+ * buildUpdateData({
+ *   'tags.500': 'admin',
+ * });
+ *
+ * // Returns:
+ * {
+ *   $set: {
+ *     'tags.500': 'admin',
+ *   },
+ * }
+ *
+ * @example
+ * // Update a nested property inside an array.
+ * buildUpdateData({
+ *   'tasks.500.completed': true,
+ * });
+ *
+ * // Returns:
+ * {
+ *   $set: {
+ *     'tasks.500.completed': true,
+ *   },
+ * }
+ *
+ * @example
+ * // Remove fields using null values.
+ * buildUpdateData({
+ *   department_id: null,
+ *   profile: {
+ *     avatar: null,
+ *   },
+ * });
+ *
+ * // Returns:
+ * {
+ *   $unset: {
+ *     department_id: true,
+ *     'profile.avatar': true,
+ *   },
+ * }
+ *
+ * @example
+ * // Ignore undefined values.
+ * buildUpdateData({
+ *   name: undefined,
+ *   email: undefined,
+ * });
+ *
+ * // Returns:
+ * {}
+ *
+ * @example
+ * // Preserve Date and other non-plain object values.
+ * buildUpdateData({
+ *   updated_at: new Date(),
+ * });
+ *
+ * // Returns:
+ * {
+ *   $set: {
+ *     updated_at: Date,
+ *   },
+ * }
+ */
+export declare const buildUpdateData: (rawInput: Record<string, unknown>) => IMongoUpdate;
+/**
+ * Collection of utility functions.
+ */
+declare const _default: {
+    parsePage: typeof parsePage;
+    parsePageSize: typeof parsePageSize;
+    calculateSkip: typeof calculateSkip;
+    parseProjection: typeof parseProjection;
+    parseSort: typeof parseSort;
+    parseFieldList: typeof parseFieldList;
+    createProjection: typeof createProjection;
+    createSort: typeof createSort;
+    excludeFields: typeof excludeFields;
+    addRegexFilter: (filters: Record<string, unknown>[], field: string, value?: string) => void;
+    addExactFilter: (filters: Record<string, unknown>[], field: string, value?: string) => void;
+    parseBoolean: (value?: string | boolean) => boolean | undefined;
+    addBooleanFilter: (filters: Record<string, unknown>[], field: string, value?: string | boolean) => void;
+    addDateRangeFilter: (filters: Record<string, unknown>[], field: string, value_from?: string, value_to?: string) => void;
+    addNumberFilter: (filters: Record<string, unknown>[], field: string, value?: string) => void;
+    parseComparisons: (expr: string) => {
+        gt?: number;
+        gte?: number;
+        lt?: number;
+        lte?: number;
+        eq?: number;
+    };
+    isPlainObject: (value: unknown) => value is Record<string, unknown>;
+    buildUpdateData: (rawInput: Record<string, unknown>) => IMongoUpdate;
+};
+export default _default;
+//# sourceMappingURL=mongo-query-builder.utils.d.ts.map

package/lib/src/database/mongodb/mongo-query-builder.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongo-query-builder.utils.d.ts","sourceRoot":"","sources":["../../../../src/database/mongodb/mongo-query-builder.utils.ts"],"names":[],"mappings":"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"}

package/lib/src/database/mongodb/mongo-query-builder.utils.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mongo-query-builder.utils.spec.d.ts.map

package/lib/src/database/mongodb/mongo-query-builder.utils.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongo-query-builder.utils.spec.d.ts","sourceRoot":"","sources":["../../../../src/database/mongodb/mongo-query-builder.utils.spec.ts"],"names":[],"mappings":""}