@nxgt/shared-mongo 1.0.0

package/dist/types/soft-delete.d.ts

@@ -0,0 +1,627 @@
+declare module 'mongoose' {
+	export interface Model<
+		TRawDocType,
+		TQueryHelpers = object,
+		TInstanceMethods = object,
+		TVirtuals = object,
+		THydratedDocumentType = HydratedDocument<
+			TRawDocType,
+			TVirtuals & TInstanceMethods,
+			TQueryHelpers,
+			TVirtuals
+		>,
+		TSchema = any,
+		TLeanResultType = TRawDocType,
+	> extends NodeJS.EventEmitter,
+			IndexManager,
+			SessionStarter {
+		/** Schema the model uses. */
+		schema: Schema<TRawDocType>;
+
+		softDeleteById<ResultDoc = THydratedDocumentType>(
+			id: mongodb.ObjectId | any,
+			autor?: string,
+			options?: QueryOptions<TRawDocType> | null,
+		): QueryWithHelpers<
+			ResultDoc | null,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'softDelete',
+			TInstanceMethods
+		>;
+
+		restoreById<ResultDoc = THydratedDocumentType>(
+			id: mongodb.ObjectId | any,
+			autor?: string,
+			options?: QueryOptions<TRawDocType> | null,
+		): QueryWithHelpers<
+			ResultDoc | null,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'restore',
+			TInstanceMethods
+		>;
+
+		countDocumentsDeleted(
+			filter?: QueryFilter<TRawDocType>,
+			options?:
+				| (mongodb.CountOptions & MongooseBaseQueryOptions<TRawDocType>)
+				| null,
+		): QueryWithHelpers<
+			number,
+			THydratedDocumentType,
+			TQueryHelpers,
+			TRawDocType,
+			'countDocumentsDeleted',
+			TInstanceMethods
+		>;
+
+		countDocumentsWithDeleted(
+			filter?: QueryFilter<TRawDocType>,
+			options?:
+				| (mongodb.CountOptions & MongooseBaseQueryOptions<TRawDocType>)
+				| null,
+		): QueryWithHelpers<
+			number,
+			THydratedDocumentType,
+			TQueryHelpers,
+			TRawDocType,
+			'countDocumentsWithDeleted',
+			TInstanceMethods
+		>;
+
+		findOneDeleted<ResultDoc = THydratedDocumentType>(
+			filter: QueryFilter<TRawDocType>,
+			projection: ProjectionType<TRawDocType> | null | undefined,
+			options: QueryOptions<TRawDocType> & { lean: true },
+		): QueryWithHelpers<
+			GetLeanResultType<TRawDocType, TRawDocType, 'findOneDeleted'> | null,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'findOneDeleted',
+			TInstanceMethods
+		>;
+
+		findOneWithDeleted<ResultDoc = THydratedDocumentType>(
+			filter: QueryFilter<TRawDocType>,
+			projection: ProjectionType<TRawDocType> | null | undefined,
+			options: QueryOptions<TRawDocType> & { lean: true },
+		): QueryWithHelpers<
+			GetLeanResultType<TRawDocType, TRawDocType, 'findOneWithDeleted'> | null,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'findOneWithDeleted',
+			TInstanceMethods
+		>;
+
+		findOneDeleted<ResultDoc = THydratedDocumentType>(
+			filter?: QueryFilter<TRawDocType>,
+			projection?: ProjectionType<TRawDocType> | null,
+			options?: QueryOptions<TRawDocType> | null,
+		): QueryWithHelpers<
+			ResultDoc | null,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'findOneDeleted',
+			TInstanceMethods
+		>;
+
+		findOneWithDeleted<ResultDoc = THydratedDocumentType>(
+			filter?: QueryFilter<TRawDocType>,
+			projection?: ProjectionType<TRawDocType> | null,
+			options?: QueryOptions<TRawDocType> | null,
+		): QueryWithHelpers<
+			ResultDoc | null,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'findOneWithDeleted',
+			TInstanceMethods
+		>;
+
+		findOneDeleted<ResultDoc = THydratedDocumentType>(
+			filter?: QueryFilter<TRawDocType>,
+			projection?: ProjectionType<TRawDocType> | null,
+		): QueryWithHelpers<
+			ResultDoc | null,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'findOneDeleted',
+			TInstanceMethods
+		>;
+
+		findOneWithDeleted<ResultDoc = THydratedDocumentType>(
+			filter?: QueryFilter<TRawDocType>,
+			projection?: ProjectionType<TRawDocType> | null,
+		): QueryWithHelpers<
+			ResultDoc | null,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'findOneWithDeleted',
+			TInstanceMethods
+		>;
+
+		findOneDeleted<ResultDoc = THydratedDocumentType>(
+			filter?: QueryFilter<TRawDocType>,
+		): QueryWithHelpers<
+			ResultDoc | null,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'findOneDeleted',
+			TInstanceMethods
+		>;
+
+		findOneWithDeleted<ResultDoc = THydratedDocumentType>(
+			filter?: QueryFilter<TRawDocType>,
+		): QueryWithHelpers<
+			ResultDoc | null,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'findOneWithDeleted',
+			TInstanceMethods
+		>;
+
+		findDeleted<ResultDoc = THydratedDocumentType>(
+			filter: QueryFilter<TRawDocType>,
+			projection: ProjectionType<TRawDocType> | null | undefined,
+			options: QueryOptions<TRawDocType> & { lean: true },
+		): QueryWithHelpers<
+			GetLeanResultType<TRawDocType, TRawDocType[], 'findDeleted'>,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'findDeleted',
+			TInstanceMethods
+		>;
+
+		findWithDeleted<ResultDoc = THydratedDocumentType>(
+			filter: QueryFilter<TRawDocType>,
+			projection: ProjectionType<TRawDocType> | null | undefined,
+			options: QueryOptions<TRawDocType> & { lean: true },
+		): QueryWithHelpers<
+			GetLeanResultType<TRawDocType, TRawDocType[], 'findWithDeleted'>,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'findWithDeleted',
+			TInstanceMethods
+		>;
+
+		findDeleted<ResultDoc = THydratedDocumentType>(
+			filter: QueryFilter<TRawDocType>,
+			projection?: ProjectionType<TRawDocType> | null | undefined,
+			options?: QueryOptions<TRawDocType> | null | undefined,
+		): QueryWithHelpers<
+			Array<ResultDoc>,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'findDeleted',
+			TInstanceMethods
+		>;
+
+		findWithDeleted<ResultDoc = THydratedDocumentType>(
+			filter: QueryFilter<TRawDocType>,
+			projection?: ProjectionType<TRawDocType> | null | undefined,
+			options?: QueryOptions<TRawDocType> | null | undefined,
+		): QueryWithHelpers<
+			Array<ResultDoc>,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'findWithDeleted',
+			TInstanceMethods
+		>;
+
+		findDeleted<ResultDoc = THydratedDocumentType>(
+			filter: QueryFilter<TRawDocType>,
+			projection?: ProjectionType<TRawDocType> | null | undefined,
+		): QueryWithHelpers<
+			Array<ResultDoc>,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'findDeleted',
+			TInstanceMethods
+		>;
+
+		findWithDeleted<ResultDoc = THydratedDocumentType>(
+			filter: QueryFilter<TRawDocType>,
+			projection?: ProjectionType<TRawDocType> | null | undefined,
+		): QueryWithHelpers<
+			Array<ResultDoc>,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'findWithDeleted',
+			TInstanceMethods
+		>;
+
+		findDeleted<ResultDoc = THydratedDocumentType>(
+			filter: QueryFilter<TRawDocType>,
+		): QueryWithHelpers<
+			Array<ResultDoc>,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'findDeleted',
+			TInstanceMethods
+		>;
+
+		findWithDeleted<ResultDoc = THydratedDocumentType>(
+			filter: QueryFilter<TRawDocType>,
+		): QueryWithHelpers<
+			Array<ResultDoc>,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'findWithDeleted',
+			TInstanceMethods
+		>;
+
+		findDeleted<ResultDoc = THydratedDocumentType>(): QueryWithHelpers<
+			Array<ResultDoc>,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'findDeleted',
+			TInstanceMethods
+		>;
+
+		findWithDeleted<ResultDoc = THydratedDocumentType>(): QueryWithHelpers<
+			Array<ResultDoc>,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'findWithDeleted',
+			TInstanceMethods
+		>;
+
+		findOneAndReplaceDeleted<ResultDoc = THydratedDocumentType>(
+			filter: QueryFilter<TRawDocType>,
+			replacement: TRawDocType | AnyObject,
+			options: QueryOptions<TRawDocType> & { lean: true },
+		): QueryWithHelpers<
+			GetLeanResultType<TRawDocType, TRawDocType, 'findOneAndReplace'> | null,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'findOneAndReplaceDeleted',
+			TInstanceMethods
+		>;
+
+		findOneAndReplaceWithDeleted<ResultDoc = THydratedDocumentType>(
+			filter: QueryFilter<TRawDocType>,
+			replacement: TRawDocType | AnyObject,
+			options: QueryOptions<TRawDocType> & { lean: true },
+		): QueryWithHelpers<
+			GetLeanResultType<TRawDocType, TRawDocType, 'findOneAndReplace'> | null,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'findOneAndReplaceWithDeleted',
+			TInstanceMethods
+		>;
+
+		findOneAndReplaceDeleted<ResultDoc = THydratedDocumentType>(
+			filter: QueryFilter<TRawDocType>,
+			replacement: TRawDocType | AnyObject,
+			options: QueryOptions<TRawDocType> & { includeResultMetadata: true },
+		): QueryWithHelpers<
+			ModifyResult<ResultDoc>,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'findOneAndReplaceDeleted',
+			TInstanceMethods
+		>;
+
+		findOneAndReplaceWithDeleted<ResultDoc = THydratedDocumentType>(
+			filter: QueryFilter<TRawDocType>,
+			replacement: TRawDocType | AnyObject,
+			options: QueryOptions<TRawDocType> & { includeResultMetadata: true },
+		): QueryWithHelpers<
+			ModifyResult<ResultDoc>,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'findOneAndReplaceWithDeleted',
+			TInstanceMethods
+		>;
+
+		findOneAndReplaceDeleted<ResultDoc = THydratedDocumentType>(
+			filter: QueryFilter<TRawDocType>,
+			replacement: TRawDocType | AnyObject,
+			options: QueryOptions<TRawDocType> & { upsert: true } & ReturnsNewDoc,
+		): QueryWithHelpers<
+			ResultDoc,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'findOneAndReplaceDeleted',
+			TInstanceMethods
+		>;
+
+		findOneAndReplaceWithDeleted<ResultDoc = THydratedDocumentType>(
+			filter: QueryFilter<TRawDocType>,
+			replacement: TRawDocType | AnyObject,
+			options: QueryOptions<TRawDocType> & { upsert: true } & ReturnsNewDoc,
+		): QueryWithHelpers<
+			ResultDoc,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'findOneAndReplaceWithDeleted',
+			TInstanceMethods
+		>;
+
+		findOneAndReplaceDeleted<ResultDoc = THydratedDocumentType>(
+			filter?: QueryFilter<TRawDocType>,
+			replacement?: TRawDocType | AnyObject,
+			options?: QueryOptions<TRawDocType> | null,
+		): QueryWithHelpers<
+			ResultDoc | null,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'findOneAndReplaceDeleted',
+			TInstanceMethods
+		>;
+
+		findOneAndReplaceWithDeleted<ResultDoc = THydratedDocumentType>(
+			filter?: QueryFilter<TRawDocType>,
+			replacement?: TRawDocType | AnyObject,
+			options?: QueryOptions<TRawDocType> | null,
+		): QueryWithHelpers<
+			ResultDoc | null,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'findOneAndReplaceWithDeleted',
+			TInstanceMethods
+		>;
+
+		findOneAndUpdateDeleted<ResultDoc = THydratedDocumentType>(
+			filter: QueryFilter<TRawDocType>,
+			update: UpdateQuery<TRawDocType>,
+			options: QueryOptions<TRawDocType> & {
+				includeResultMetadata: true;
+				lean: true;
+			},
+		): QueryWithHelpers<
+			ModifyResult<TRawDocType>,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'findOneAndUpdateDeleted',
+			TInstanceMethods
+		>;
+
+		findOneAndUpdateWithDeleted<ResultDoc = THydratedDocumentType>(
+			filter: QueryFilter<TRawDocType>,
+			update: UpdateQuery<TRawDocType>,
+			options: QueryOptions<TRawDocType> & {
+				includeResultMetadata: true;
+				lean: true;
+			},
+		): QueryWithHelpers<
+			ModifyResult<TRawDocType>,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'findOneAndUpdateWithDeleted',
+			TInstanceMethods
+		>;
+
+		findOneAndUpdateDeleted<ResultDoc = THydratedDocumentType>(
+			filter: QueryFilter<TRawDocType>,
+			update: UpdateQuery<TRawDocType>,
+			options: QueryOptions<TRawDocType> & { lean: true },
+		): QueryWithHelpers<
+			GetLeanResultType<
+				TRawDocType,
+				TRawDocType,
+				'findOneAndUpdateDeleted'
+			> | null,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'findOneAndUpdateDeleted',
+			TInstanceMethods
+		>;
+
+		findOneAndUpdateWithDeleted<ResultDoc = THydratedDocumentType>(
+			filter: QueryFilter<TRawDocType>,
+			update: UpdateQuery<TRawDocType>,
+			options: QueryOptions<TRawDocType> & { lean: true },
+		): QueryWithHelpers<
+			GetLeanResultType<
+				TRawDocType,
+				TRawDocType,
+				'findOneAndUpdateWithDeleted'
+			> | null,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'findOneAndUpdateWithDeleted',
+			TInstanceMethods
+		>;
+
+		findOneAndUpdateDeleted<ResultDoc = THydratedDocumentType>(
+			filter: QueryFilter<TRawDocType>,
+			update: UpdateQuery<TRawDocType>,
+			options: QueryOptions<TRawDocType> & { includeResultMetadata: true },
+		): QueryWithHelpers<
+			ModifyResult<ResultDoc>,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'findOneAndUpdateDeleted',
+			TInstanceMethods
+		>;
+
+		findOneAndUpdateWithDeleted<ResultDoc = THydratedDocumentType>(
+			filter: QueryFilter<TRawDocType>,
+			update: UpdateQuery<TRawDocType>,
+			options: QueryOptions<TRawDocType> & { includeResultMetadata: true },
+		): QueryWithHelpers<
+			ModifyResult<ResultDoc>,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'findOneAndUpdateWithDeleted',
+			TInstanceMethods
+		>;
+
+		findOneAndUpdateDeleted<ResultDoc = THydratedDocumentType>(
+			filter: QueryFilter<TRawDocType>,
+			update: UpdateQuery<TRawDocType>,
+			options: QueryOptions<TRawDocType> & { upsert: true } & ReturnsNewDoc,
+		): QueryWithHelpers<
+			ResultDoc,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'findOneAndUpdateDeleted',
+			TInstanceMethods
+		>;
+
+		findOneAndUpdateWithDeleted<ResultDoc = THydratedDocumentType>(
+			filter: QueryFilter<TRawDocType>,
+			update: UpdateQuery<TRawDocType>,
+			options: QueryOptions<TRawDocType> & { upsert: true } & ReturnsNewDoc,
+		): QueryWithHelpers<
+			ResultDoc,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'findOneAndUpdateWithDeleted',
+			TInstanceMethods
+		>;
+
+		findOneAndUpdateDeleted<ResultDoc = THydratedDocumentType>(
+			filter?: QueryFilter<TRawDocType>,
+			update?: UpdateQuery<TRawDocType>,
+			options?: QueryOptions<TRawDocType> | null,
+		): QueryWithHelpers<
+			ResultDoc | null,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'findOneAndUpdateDeleted',
+			TInstanceMethods
+		>;
+
+		findOneAndUpdateWithDeleted<ResultDoc = THydratedDocumentType>(
+			filter?: QueryFilter<TRawDocType>,
+			update?: UpdateQuery<TRawDocType>,
+			options?: QueryOptions<TRawDocType> | null,
+		): QueryWithHelpers<
+			ResultDoc | null,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'findOneAndUpdateWithDeleted',
+			TInstanceMethods
+		>;
+
+		replaceOneDeleted<ResultDoc = THydratedDocumentType>(
+			filter?: QueryFilter<TRawDocType>,
+			replacement?: TRawDocType | AnyObject,
+			options?:
+				| (mongodb.ReplaceOptions & MongooseQueryOptions<TRawDocType>)
+				| null,
+		): QueryWithHelpers<
+			UpdateWriteOpResult,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'replaceOneDeleted',
+			TInstanceMethods
+		>;
+
+		replaceOneWithDeleted<ResultDoc = THydratedDocumentType>(
+			filter?: QueryFilter<TRawDocType>,
+			replacement?: TRawDocType | AnyObject,
+			options?:
+				| (mongodb.ReplaceOptions & MongooseQueryOptions<TRawDocType>)
+				| null,
+		): QueryWithHelpers<
+			UpdateWriteOpResult,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'replaceOneWithDeleted',
+			TInstanceMethods
+		>;
+
+		updateManyDeleted<ResultDoc = THydratedDocumentType>(
+			filter?: QueryFilter<TRawDocType>,
+			update?: UpdateQuery<TRawDocType> | UpdateWithAggregationPipeline,
+			options?:
+				| (mongodb.UpdateOptions & MongooseUpdateQueryOptions<TRawDocType>)
+				| null,
+		): QueryWithHelpers<
+			UpdateWriteOpResult,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'updateManyDeleted',
+			TInstanceMethods
+		>;
+
+		updateManyWithDeleted<ResultDoc = THydratedDocumentType>(
+			filter?: QueryFilter<TRawDocType>,
+			update?: UpdateQuery<TRawDocType> | UpdateWithAggregationPipeline,
+			options?:
+				| (mongodb.UpdateOptions & MongooseUpdateQueryOptions<TRawDocType>)
+				| null,
+		): QueryWithHelpers<
+			UpdateWriteOpResult,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'updateManyWithDeleted',
+			TInstanceMethods
+		>;
+
+		updateOneDeleted<ResultDoc = THydratedDocumentType>(
+			filter?: QueryFilter<TRawDocType>,
+			update?: UpdateQuery<TRawDocType> | UpdateWithAggregationPipeline,
+			options?:
+				| (mongodb.UpdateOptions & MongooseUpdateQueryOptions<TRawDocType>)
+				| null,
+		): QueryWithHelpers<
+			UpdateWriteOpResult,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'updateOneDeleted',
+			TInstanceMethods
+		>;
+
+		updateOneWithDeleted<ResultDoc = THydratedDocumentType>(
+			filter?: QueryFilter<TRawDocType>,
+			update?: UpdateQuery<TRawDocType> | UpdateWithAggregationPipeline,
+			options?:
+				| (mongodb.UpdateOptions & MongooseUpdateQueryOptions<TRawDocType>)
+				| null,
+		): QueryWithHelpers<
+			UpdateWriteOpResult,
+			ResultDoc,
+			TQueryHelpers,
+			TRawDocType,
+			'updateOneWithDeleted',
+			TInstanceMethods
+		>;
+	}
+}

package/dist/utils/clear-database.d.ts

@@ -0,0 +1,24 @@
+import type { Connection } from 'mongoose';
+/**
+ * Empties every non-view, non-system collection on `connection`.
+ *
+ * Test-suite helper, deliberately living here rather than in each app: it used
+ * to exist as five identical unguarded copies here and five more in
+ * `sellix-monorepo`, and one shell export was enough to point a whole suite at a
+ * real database and empty it — which is how `sellix` was lost once. Bun gives
+ * the process environment precedence over `--env-file`, so `MONGODB_URI` set in
+ * a shell silently beats `.env.test` — and the centralized env layout makes a
+ * forgotten `--env-file=.env.test` resolve to the production URI just as
+ * quietly.
+ *
+ * Hence the guard, and hence both halves of it: `NODE_ENV` and the database
+ * name are each individually defeatable by exactly the kind of stray export
+ * that caused the incident, so both must hold. An unconnected connection
+ * reports an empty name and is refused, so this fails closed.
+ *
+ * `Bun.env` rather than an app's parsed env: this package has no schema of its
+ * own to load, and reading the raw value is the point — the guard must see what
+ * the process actually got, not what a `.default()` filled in.
+ */
+export declare function clearDatabase(connection?: Connection): Promise<void>;
+//# sourceMappingURL=clear-database.d.ts.map

package/dist/utils/clear-database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clear-database.d.ts","sourceRoot":"","sources":["../../src/utils/clear-database.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAG3C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,aAAa,CAClC,UAAU,GAAE,UAAgC,GAC1C,OAAO,CAAC,IAAI,CAAC,CAwBf"}

package/dist/utils/error.utils.d.ts

@@ -0,0 +1,4 @@
+import { CustomException } from '@nxgt/shared-exceptions';
+import mongoose from 'mongoose';
+export declare function castError(error: mongoose.MongooseError): CustomException<any>;
+//# sourceMappingURL=error.utils.d.ts.map

package/dist/utils/error.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.utils.d.ts","sourceRoot":"","sources":["../../src/utils/error.utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,QAAQ,MAAM,UAAU,CAAC;AAEhC,wBAAgB,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,aAAa,wBA+CtD"}

package/dist/utils/filter.utils.d.ts

@@ -0,0 +1,40 @@
+import type { DateRangeFilter, StringArrayFilter } from '@nxgt/shared/models';
+import type { QueryFilter } from 'mongoose';
+/**
+ * Helper to build MongoDB date range filter from DateRangeFilter
+ * @param dateRange - The date range filter with from and to dates
+ * @returns MongoDB date range filter ($gte and/or $lte)
+ */
+export declare function buildDateRangeFilter(dateRange: DateRangeFilter | undefined): any;
+/**
+ * Helper to build MongoDB filter from ArrayFilter
+ * @param arrayFilter - The array filter with values and operator
+ * @returns MongoDB filter query ($in or $all)
+ */
+export declare function buildArrayFilter(arrayFilter?: StringArrayFilter | null): string[] | {
+    $all: string[];
+} | undefined;
+/**
+ * Helper to add a filter condition to a query object
+ */
+export declare function addFilterCondition(query: QueryFilter<any>, field: string, condition: any): void;
+/**
+ * Helper to build a case-insensitive substring match from a search term
+ *
+ * Returns the bare condition, like every other builder here — it is
+ * `addFilterCondition` that keys it by field. Returning `{ [field]: … }` had it
+ * keyed twice, so Mongoose saw `{ username: { username: { $regex } } }` and
+ * threw a CastError on every user search.
+ *
+ * The term reaches this from a request body, so it is escaped rather than
+ * compiled as written: unescaped, a caller can hand the database a
+ * catastrophically backtracking pattern.
+ *
+ * @param value - The search term, as the caller typed it
+ * @returns MongoDB regex condition ($regex and $options), or undefined
+ */
+export declare function buildRegexFilter(value: string | undefined): {
+    $regex: string;
+    $options: string;
+} | undefined;
+//# sourceMappingURL=filter.utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filter.utils.d.ts","sourceRoot":"","sources":["../../src/utils/filter.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,eAAe,GAAG,SAAS,OAgB1E;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,CAAC,EAAE,iBAAiB,GAAG,IAAI;;cAQtE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,WAAW,CAAC,GAAG,CAAC,EACvB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,GAAG,GACZ,IAAI,CAIN;AASD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS;;;cAKzD"}