@cyberskill/shared 3.0.0 → 3.1.0

package/dist/node/mongo/mongo.controller.mongoose.js

@@ -0,0 +1,468 @@
+import { MONGO_SLUG_MAX_ATTEMPTS as S } from "./mongo.constant.js";
+import { populateDynamicVirtuals as f, filterDynamicVirtualsFromPopulate as y, isObject as O } from "./mongo.dynamic-populate.js";
+import { normalizeMongoFilter as d } from "../../util/object/object.util.js";
+import { generateShortId as b, generateSlug as p, generateRandomString as V } from "../../util/string/string.util.js";
+import { RESPONSE_STATUS as g } from "../../constant/response-status.js";
+import { catchError as u } from "../log/log.util.js";
+class R {
+  /**
+   * Creates a new Mongoose controller instance.
+   *
+   * @param model - The Mongoose model to operate on.
+   */
+  constructor(r) {
+    this.model = r;
+  }
+  /**
+   * Gets the model name for logging and error messages.
+   *
+   * @returns The name of the model.
+   */
+  getModelName() {
+    return this.model.modelName;
+  }
+  /**
+   * Gets the dynamic virtuals configuration from the model instance.
+   *
+   * @returns Array of dynamic virtual configurations or undefined if none exist.
+   */
+  getDynamicVirtuals() {
+    if (this.model._virtualConfigs) {
+      const s = this.model._virtualConfigs.filter((t) => typeof t.options?.ref == "function");
+      if (s.length > 0)
+        return s;
+    }
+    return this.model.schema.statics._dynamicVirtuals;
+  }
+  /**
+   * Populates dynamic virtuals for a single document.
+   *
+   * @param result - The document to populate dynamic virtuals for.
+   * @param populate - The populate options to determine which virtuals to populate.
+   * @returns The document with dynamic virtuals populated.
+   */
+  async populateDynamicVirtualsForDocument(r, e) {
+    const s = this.getDynamicVirtuals();
+    if (s && s.length > 0) {
+      const t = await f(this.model.base, [r], s, e, void 0, this.model);
+      return t && t[0] ? t[0] : r;
+    }
+    return r;
+  }
+  /**
+   * Populates dynamic virtuals for an array of documents.
+   *
+   * @param results - The documents to populate dynamic virtuals for.
+   * @param populate - The populate options to determine which virtuals to populate.
+   * @returns The documents with dynamic virtuals populated.
+   */
+  async populateDynamicVirtualsForDocuments(r, e) {
+    const s = this.getDynamicVirtuals();
+    return s && s.length > 0 && r.length > 0 ? await f(this.model.base, r, s, e, void 0, this.model) : r;
+  }
+  /**
+   * Finds a single document with optional population and projection.
+   * Automatically handles dynamic virtual population if configured.
+   *
+   * @param filter - The filter criteria to find the document.
+   * @param projection - The fields to include/exclude in the result.
+   * @param options - Query options for the operation.
+   * @param populate - Population configuration for related documents.
+   * @returns A promise that resolves to a standardized response with the found document.
+   */
+  async findOne(r = {}, e = {}, s = {}, t) {
+    try {
+      const a = d(r), c = this.model.findOne(a, e, s).maxTimeMS(3e4).lean(), n = this.getDynamicVirtuals(), i = y(t, n);
+      i && c.populate(i);
+      const o = await c.exec();
+      if (!o)
+        return {
+          success: !1,
+          message: `No ${this.getModelName()} found.`,
+          code: g.NOT_FOUND.CODE
+        };
+      const l = await this.populateDynamicVirtualsForDocument(o, t);
+      return { success: !0, result: l?.toObject?.() ?? l };
+    } catch (a) {
+      return u(a);
+    }
+  }
+  /**
+   * Finds all documents with optional population and projection.
+   * Automatically handles dynamic virtual population if configured.
+   *
+   * @param filter - The filter criteria to find documents.
+   * @param projection - The fields to include/exclude in the result.
+   * @param options - Query options for the operation.
+   * @param populate - Population configuration for related documents.
+   * @returns A promise that resolves to a standardized response with the found documents.
+   */
+  async findAll(r = {}, e = {}, s = {}, t) {
+    try {
+      const a = d(r), c = this.model.find(a, e, s).maxTimeMS(3e4).lean();
+      s.limit || c.limit(1e4);
+      const n = this.getDynamicVirtuals(), i = y(t, n);
+      i && c.populate(i);
+      const o = await c.exec();
+      return { success: !0, result: (await this.populateDynamicVirtualsForDocuments(o, t)).map((m) => m?.toObject?.() ?? m) };
+    } catch (a) {
+      return u(a);
+    }
+  }
+  /**
+   * Finds documents with pagination support.
+   * Automatically handles dynamic virtual population if configured.
+   *
+   * @param filter - The filter criteria to find documents.
+   * @param options - Pagination options including page, limit, and population.
+   * @returns A promise that resolves to a standardized response with paginated results.
+   */
+  async findPaging(r = {}, e = {}) {
+    try {
+      const s = d(r), t = this.getDynamicVirtuals(), a = { ...e };
+      e.populate && (a.populate = y(e.populate, t));
+      const c = await this.model.paginate(s, a);
+      if (t && t.length > 0) {
+        const n = await this.populateDynamicVirtualsForDocuments(c.docs, e.populate);
+        return { success: !0, result: { ...c, docs: n.map((i) => i?.toObject?.() ?? i) } };
+      }
+      return { success: !0, result: { ...c, docs: c.docs.map((n) => n?.toObject?.() ?? n) } };
+    } catch (s) {
+      return u(s);
+    }
+  }
+  /**
+   * Performs aggregation with pagination support.
+   *
+   * @param pipeline - The aggregation pipeline stages.
+   * @param options - Pagination options for the aggregation result.
+   * @returns A promise that resolves to a standardized response with paginated aggregation results.
+   */
+  async findPagingAggregate(r, e = {}) {
+    try {
+      const s = this.getDynamicVirtuals(), t = { ...e };
+      e.populate && (t.populate = y(e.populate, s));
+      const a = await this.model.aggregatePaginate(
+        this.model.aggregate(r),
+        t
+      ), c = await this.populateDynamicVirtualsForDocuments(a.docs, e.populate);
+      return { success: !0, result: { ...a, docs: c.map((n) => n?.toObject?.() ?? n) } };
+    } catch (s) {
+      return u(s);
+    }
+  }
+  /**
+   * Counts documents matching the filter criteria.
+   *
+   * @param filter - The filter criteria to count documents.
+   * @returns A promise that resolves to a standardized response with the document count.
+   */
+  async count(r = {}) {
+    try {
+      const e = d(r);
+      return { success: !0, result: await this.model.countDocuments(e) };
+    } catch (e) {
+      return u(e);
+    }
+  }
+  /**
+   * Creates a single document.
+   *
+   * @param doc - The document to create.
+   * @returns A promise that resolves to a standardized response with the created document.
+   */
+  async createOne(r) {
+    try {
+      const e = await this.model.create(r);
+      return { success: !0, result: e?.toObject?.() ?? e };
+    } catch (e) {
+      return u(e);
+    }
+  }
+  /**
+   * Creates multiple documents with bulk insertion.
+   *
+   * @param docs - An array of documents to create.
+   * @param options - Options for the bulk insertion operation.
+   * @returns A promise that resolves to a standardized response with the created documents.
+   */
+  async createMany(r, e = {}) {
+    try {
+      return { success: !0, result: (await this.model.insertMany(r, e)).map((t) => t?.toObject?.() ?? t) };
+    } catch (s) {
+      return u(s);
+    }
+  }
+  /**
+   * Updates a single document and returns the updated version.
+   *
+   * @param filter - The filter criteria to find the document to update.
+   * @param update - The update data to apply.
+   * @param options - Options for the update operation.
+   * @returns A promise that resolves to a standardized response with the updated document.
+   */
+  async updateOne(r = {}, e = {}, s = {}) {
+    try {
+      const t = d(r), a = await this.model.findOneAndUpdate(t, e, {
+        new: !0,
+        ...s
+      }).exec();
+      return a ? { success: !0, result: a?.toObject?.() ?? a } : {
+        success: !1,
+        message: `Failed to update ${this.getModelName()}.`,
+        code: g.NOT_FOUND.CODE
+      };
+    } catch (t) {
+      return u(t);
+    }
+  }
+  /**
+   * Updates multiple documents matching the filter criteria.
+   *
+   * @param filter - The filter criteria to find documents to update.
+   * @param update - The update data to apply.
+   * @param options - Options for the update operation.
+   * @returns A promise that resolves to a standardized response with the update result.
+   */
+  async updateMany(r = {}, e = {}, s = {}) {
+    try {
+      const t = d(r);
+      return { success: !0, result: await this.model.updateMany(t, e, s).exec() };
+    } catch (t) {
+      return u(t);
+    }
+  }
+  /**
+   * Deletes a single document and returns the deleted version.
+   *
+   * @param filter - The filter criteria to find the document to delete.
+   * @param options - Options for the delete operation.
+   * @returns A promise that resolves to a standardized response with the deleted document.
+   */
+  async deleteOne(r = {}, e = {}) {
+    try {
+      const s = d(r), t = await this.model.findOneAndDelete(s, e).exec();
+      return t ? { success: !0, result: t?.toObject?.() ?? t } : {
+        success: !1,
+        message: `No ${this.getModelName()} found to delete.`,
+        code: g.NOT_FOUND.CODE
+      };
+    } catch (s) {
+      return u(s);
+    }
+  }
+  /**
+   * Deletes multiple documents matching the filter criteria.
+   *
+   * @param filter - The filter criteria to find documents to delete.
+   * @param options - Options for the delete operation.
+   * @returns A promise that resolves to a standardized response with the delete result.
+   */
+  async deleteMany(r = {}, e = {}) {
+    try {
+      const s = d(r), t = await this.model.deleteMany(s, e).exec();
+      return t.deletedCount === 0 ? {
+        success: !1,
+        message: "No documents found to delete.",
+        code: g.NOT_FOUND.CODE
+      } : { success: !0, result: t };
+    } catch (s) {
+      return u(s);
+    }
+  }
+  /**
+   * Creates a unique short ID based on a given ID.
+   * This method generates multiple short IDs with increasing lengths and finds the first available one.
+   *
+   * @param id - The base ID to generate short IDs from.
+   * @param length - The initial length for short ID generation (default: 4).
+   * @returns A promise that resolves to a standardized response with the unique short ID.
+   */
+  async createShortId(r, e = 4) {
+    try {
+      const t = Array.from({ length: 10 }, (n, i) => b(r, i + e)), c = (await Promise.all(
+        t.map((n) => this.model.exists({ shortId: n }))
+      )).findIndex((n) => !n);
+      if (c !== -1) {
+        const n = t[c];
+        if (n)
+          return { success: !0, result: n };
+      }
+      return {
+        success: !1,
+        message: "Failed to create a unique shortId",
+        code: g.INTERNAL_SERVER_ERROR.CODE
+      };
+    } catch (s) {
+      return u(s);
+    }
+  }
+  /**
+   * Creates a query for slug existence checking.
+   * This method generates a query that checks for slug existence in both current and historical slug fields.
+   *
+   * @param options - Configuration for slug query generation including slug, field, and filter.
+   * @param options.slug - The slug string to check for existence.
+   * @param options.field - The field name for object-based slug checking.
+   * @param options.isObject - Whether the slug is stored as an object with nested fields.
+   * @param options.haveHistory - Whether to check historical slug fields for existence.
+   * @param options.filter - Additional filter conditions to apply to the query.
+   * @returns A MongoDB query object for checking slug existence.
+   */
+  createSlugQuery({ slug: r, field: e, isObject: s, haveHistory: t = !1, filter: a }) {
+    const c = { ...a ?? {} };
+    return s ? {
+      ...c,
+      $or: [
+        { [`slug.${e}`]: r },
+        ...t ? [{ slugHistory: { $elemMatch: { [`slug.${e}`]: r } } }] : []
+      ]
+    } : {
+      ...c,
+      $or: [
+        { slug: r },
+        ...t ? [{ slugHistory: r }] : []
+      ]
+    };
+  }
+  /**
+   * Creates a unique slug based on a given string.
+   * This method generates multiple slug variations and finds the first available one.
+   *
+   * @param options - Configuration for slug generation including slug, field, and filter.
+   * @param options.slug - The base slug string to make unique.
+   * @param options.field - The field name for object-based slug checking.
+   * @param options.isObject - Whether the slug is stored as an object with nested fields.
+   * @param options.haveHistory - Whether to check historical slug fields for uniqueness.
+   * @param options.filter - Additional filter conditions to apply when checking slug existence.
+   * @returns A promise that resolves to a unique slug string.
+   */
+  async createUniqueSlug({ slug: r, field: e, isObject: s, haveHistory: t, filter: a }) {
+    if (!r || typeof r != "string")
+      throw new Error("Invalid slug provided: must be a non-empty string");
+    const c = p(r);
+    if (!await this.model.exists(
+      this.createSlugQuery({ slug: c, field: e, isObject: s, haveHistory: t, filter: a })
+    ))
+      return c;
+    for (let l = 1; l <= S; l++) {
+      const m = `${c}-${l}`;
+      if (!await this.model.exists(
+        this.createSlugQuery({ slug: m, field: e, isObject: s, haveHistory: t, filter: a })
+      ))
+        return m;
+    }
+    const i = Date.now(), o = V(6);
+    return `${c}-${i}-${o}`;
+  }
+  /**
+   * Creates a slug for a document field.
+   * This method handles both simple string fields and object fields with nested slug generation.
+   *
+   * @param options - Configuration for slug creation including field, source document, and filter.
+   * @param options.field - The field name to create a slug for.
+   * @param options.from - The source document containing the field value.
+   * @param options.haveHistory - Whether to check historical slug fields for uniqueness.
+   * @param options.filter - Additional filter conditions to apply when checking slug existence.
+   * @returns A promise that resolves to a standardized response with the created slug(s).
+   */
+  async createSlug({ field: r, from: e, filter: s, haveHistory: t }) {
+    try {
+      const a = e[r];
+      return O(a) ? { success: !0, result: Object.fromEntries(
+        await Promise.all(
+          Object.entries(a).map(async ([o, l]) => {
+            const m = await this.createUniqueSlug({
+              slug: l,
+              field: o,
+              isObject: !0,
+              haveHistory: t,
+              filter: s
+            });
+            return [o, m];
+          })
+        )
+      ) } : { success: !0, result: await this.createUniqueSlug({
+        slug: a,
+        field: r,
+        isObject: !1,
+        haveHistory: t,
+        filter: s
+      }) };
+    } catch (a) {
+      return u(a);
+    }
+  }
+  /**
+   * Checks if a slug already exists in the collection.
+   * This method verifies slug existence in both current and historical slug fields.
+   *
+   * @param options - Configuration for slug checking including slug, field, source document, and filter.
+   * @param options.slug - The slug string to check for existence.
+   * @param options.field - The field name for object-based slug checking.
+   * @param options.from - The source document containing the field value.
+   * @param options.haveHistory - Whether to check historical slug fields for existence.
+   * @param options.filter - Additional filter conditions to apply to the query.
+   * @returns A promise that resolves to a standardized response indicating whether the slug exists.
+   */
+  async checkSlug({ slug: r, field: e, from: s, filter: t, haveHistory: a }) {
+    try {
+      const c = s[e];
+      if (O(c)) {
+        const m = Object.values(c).map((h) => p(h));
+        return (await Promise.all(
+          m.map(
+            (h) => this.model.exists(this.createSlugQuery({
+              slug: h,
+              field: e,
+              isObject: !0,
+              haveHistory: a,
+              filter: t
+            }))
+          )
+        )).some((h) => h) ? { success: !0, result: !0 } : { success: !0, result: !1 };
+      }
+      const i = p(r);
+      return { success: !0, result: await this.model.exists(this.createSlugQuery({
+        slug: i,
+        field: e,
+        isObject: !1,
+        filter: t
+      })) !== null };
+    } catch (c) {
+      return u(c);
+    }
+  }
+  /**
+   * Performs aggregation operations on the collection.
+   *
+   * @param pipeline - The aggregation pipeline stages to execute.
+   * @returns A promise that resolves to a standardized response with the aggregation results.
+   */
+  async aggregate(r) {
+    try {
+      return { success: !0, result: await this.model.aggregate(r) };
+    } catch (e) {
+      return u(e);
+    }
+  }
+  /**
+   * Retrieves distinct values for the specified key from the collection.
+   *
+   * @param key - The field for which to return distinct values.
+   * @param filter - The filter query to apply (optional).
+   * @param options - Additional options for the distinct operation (optional).
+   * @returns A promise that resolves to a standardized response with the array of distinct values.
+   */
+  async distinct(r, e = {}, s = {}) {
+    try {
+      return { success: !0, result: await this.model.distinct(r, e, s) };
+    } catch (t) {
+      return u(t);
+    }
+  }
+}
+export {
+  R as MongooseController
+};
+//# sourceMappingURL=mongo.controller.mongoose.js.map

package/dist/node/mongo/mongo.controller.mongoose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongo.controller.mongoose.js","sources":["../../../src/node/mongo/mongo.controller.mongoose.ts"],"sourcesContent":["import type { I_Return } from '#typescript/index.js';\n\nimport { RESPONSE_STATUS } from '#constant/index.js';\nimport { normalizeMongoFilter } from '#util/index.js';\nimport { generateRandomString, generateShortId, generateSlug } from '#util/string/index.js';\n\nimport type { C_Document, I_DeleteOptionsExtended, I_DynamicVirtualConfig, I_ExtendedModel, I_Input_CheckSlug, I_Input_CreateSlug, I_Input_GenerateSlug, I_PaginateOptionsWithPopulate, I_UpdateOptionsExtended, T_AggregatePaginateResult, T_DeleteResult, T_Input_Populate, T_InsertManyOptions, T_PaginateResult, T_PipelineStage, T_PopulateOptions, T_ProjectionType, T_QueryFilter, T_QueryOptions, T_UpdateQuery, T_UpdateResult } from './mongo.type.js';\n\nimport { catchError } from '../log/index.js';\nimport { MONGO_SLUG_MAX_ATTEMPTS } from './mongo.constant.js';\nimport { filterDynamicVirtualsFromPopulate, isObject, populateDynamicVirtuals } from './mongo.dynamic-populate.js';\n\n/**\n * Mongoose controller for database operations with advanced features.\n * This class provides a comprehensive interface for Mongoose operations including\n * pagination, aggregation, slug generation, and short ID creation.\n */\nexport class MongooseController<T extends Partial<C_Document>> {\n    /**\n     * Creates a new Mongoose controller instance.\n     *\n     * @param model - The Mongoose model to operate on.\n     */\n    constructor(private model: I_ExtendedModel<T>) { }\n\n    /**\n     * Gets the model name for logging and error messages.\n     *\n     * @returns The name of the model.\n     */\n    private getModelName(): string {\n        return this.model.modelName;\n    }\n\n    /**\n     * Gets the dynamic virtuals configuration from the model instance.\n     *\n     * @returns Array of dynamic virtual configurations or undefined if none exist.\n     */\n    private getDynamicVirtuals(): I_DynamicVirtualConfig<T>[] | undefined {\n        if ((this.model as any)._virtualConfigs) {\n            const allVirtuals = (this.model as any)._virtualConfigs as Array<{ name: string; options?: { ref?: unknown } }>;\n            const dynamicOnly = allVirtuals.filter(v => typeof (v.options as { ref?: unknown } | undefined)?.ref === 'function') as unknown as I_DynamicVirtualConfig<T>[];\n\n            if (dynamicOnly.length > 0) {\n                return dynamicOnly;\n            }\n        }\n\n        const schemaStatics = this.model.schema.statics as { [key: string]: unknown };\n\n        return schemaStatics['_dynamicVirtuals'] as I_DynamicVirtualConfig<T>[] | undefined;\n    }\n\n    /**\n     * Populates dynamic virtuals for a single document.\n     *\n     * @param result - The document to populate dynamic virtuals for.\n     * @param populate - The populate options to determine which virtuals to populate.\n     * @returns The document with dynamic virtuals populated.\n     */\n    private async populateDynamicVirtualsForDocument(result: T, populate?: T_Input_Populate): Promise<T> {\n        const dynamicVirtuals = this.getDynamicVirtuals();\n\n        if (dynamicVirtuals && dynamicVirtuals.length > 0) {\n            const populatedArr = await populateDynamicVirtuals(this.model.base, [result], dynamicVirtuals, populate, undefined, this.model);\n\n            return (populatedArr && populatedArr[0]) ? populatedArr[0] as T : result;\n        }\n\n        return result;\n    }\n\n    /**\n     * Populates dynamic virtuals for an array of documents.\n     *\n     * @param results - The documents to populate dynamic virtuals for.\n     * @param populate - The populate options to determine which virtuals to populate.\n     * @returns The documents with dynamic virtuals populated.\n     */\n    private async populateDynamicVirtualsForDocuments(results: T[], populate?: T_Input_Populate): Promise<T[]> {\n        const dynamicVirtuals = this.getDynamicVirtuals();\n\n        if (dynamicVirtuals && dynamicVirtuals.length > 0 && results.length > 0) {\n            const populatedResults = await populateDynamicVirtuals(this.model.base, results, dynamicVirtuals, populate, undefined, this.model) as T[];\n\n            return populatedResults;\n        }\n\n        return results;\n    }\n\n    /**\n     * Finds a single document with optional population and projection.\n     * Automatically handles dynamic virtual population if configured.\n     *\n     * @param filter - The filter criteria to find the document.\n     * @param projection - The fields to include/exclude in the result.\n     * @param options - Query options for the operation.\n     * @param populate - Population configuration for related documents.\n     * @returns A promise that resolves to a standardized response with the found document.\n     */\n    async findOne(\n        filter: T_QueryFilter<T> = {},\n        projection: T_ProjectionType<T> = {},\n        options: T_QueryOptions<T> = {},\n        populate?: T_Input_Populate,\n    ): Promise<I_Return<T>> {\n        try {\n            const normalizedFilter = normalizeMongoFilter(filter);\n            const query = this.model.findOne(normalizedFilter, projection, options).maxTimeMS(30_000).lean();\n            const dynamicVirtuals = this.getDynamicVirtuals();\n\n            const regularPopulate = filterDynamicVirtualsFromPopulate(populate, dynamicVirtuals);\n\n            if (regularPopulate) {\n                query.populate(regularPopulate as T_PopulateOptions);\n            }\n\n            const result = await query.exec();\n\n            if (!result) {\n                return {\n                    success: false,\n                    message: `No ${this.getModelName()} found.`,\n                    code: RESPONSE_STATUS.NOT_FOUND.CODE,\n                };\n            }\n\n            const finalResult = await this.populateDynamicVirtualsForDocument(result, populate);\n\n            return { success: true, result: finalResult?.toObject?.() ?? finalResult };\n        }\n        catch (error) {\n            return catchError<T>(error);\n        }\n    }\n\n    /**\n     * Finds all documents with optional population and projection.\n     * Automatically handles dynamic virtual population if configured.\n     *\n     * @param filter - The filter criteria to find documents.\n     * @param projection - The fields to include/exclude in the result.\n     * @param options - Query options for the operation.\n     * @param populate - Population configuration for related documents.\n     * @returns A promise that resolves to a standardized response with the found documents.\n     */\n    async findAll(\n        filter: T_QueryFilter<T> = {},\n        projection: T_ProjectionType<T> = {},\n        options: T_QueryOptions<T> = {},\n        populate?: T_Input_Populate,\n    ): Promise<I_Return<T[]>> {\n        try {\n            const normalizedFilter = normalizeMongoFilter(filter);\n            const query = this.model.find(normalizedFilter, projection, options).maxTimeMS(30_000).lean();\n\n            if (!options.limit) {\n                query.limit(10_000);\n            }\n            const dynamicVirtuals = this.getDynamicVirtuals();\n\n            const regularPopulate = filterDynamicVirtualsFromPopulate(populate, dynamicVirtuals);\n\n            if (regularPopulate) {\n                query.populate(regularPopulate as T_PopulateOptions);\n            }\n\n            const result = await query.exec();\n\n            const finalResult = await this.populateDynamicVirtualsForDocuments(result, populate);\n\n            return { success: true, result: finalResult.map(item => item?.toObject?.() ?? item) };\n        }\n        catch (error) {\n            return catchError<T[]>(error);\n        }\n    }\n\n    /**\n     * Finds documents with pagination support.\n     * Automatically handles dynamic virtual population if configured.\n     *\n     * @param filter - The filter criteria to find documents.\n     * @param options - Pagination options including page, limit, and population.\n     * @returns A promise that resolves to a standardized response with paginated results.\n     */\n    async findPaging(\n        filter: T_QueryFilter<T> = {},\n        options: I_PaginateOptionsWithPopulate = {},\n    ): Promise<I_Return<T_PaginateResult<T>>> {\n        try {\n            const normalizedFilter = normalizeMongoFilter(filter);\n            const dynamicVirtuals = this.getDynamicVirtuals();\n\n            const filteredOptions = { ...options };\n\n            if (options.populate) {\n                filteredOptions.populate = filterDynamicVirtualsFromPopulate(options.populate, dynamicVirtuals);\n            }\n\n            const result = await this.model.paginate(normalizedFilter, filteredOptions);\n\n            if (dynamicVirtuals && dynamicVirtuals.length > 0) {\n                const populatedDocs = await this.populateDynamicVirtualsForDocuments(result.docs, options.populate);\n\n                return { success: true, result: { ...result, docs: populatedDocs.map(item => item?.toObject?.() ?? item) } };\n            }\n\n            return { success: true, result: { ...result, docs: result.docs.map(item => item?.toObject?.() ?? item) } };\n        }\n        catch (error) {\n            return catchError<T_PaginateResult<T>>(error);\n        }\n    }\n\n    /**\n     * Performs aggregation with pagination support.\n     *\n     * @param pipeline - The aggregation pipeline stages.\n     * @param options - Pagination options for the aggregation result.\n     * @returns A promise that resolves to a standardized response with paginated aggregation results.\n     */\n    async findPagingAggregate(\n        pipeline: T_PipelineStage[],\n        options: I_PaginateOptionsWithPopulate = {},\n    ): Promise<I_Return<T_AggregatePaginateResult<T>>> {\n        try {\n            const dynamicVirtuals = this.getDynamicVirtuals();\n\n            const filteredOptions = { ...options };\n\n            if (options.populate) {\n                filteredOptions.populate = filterDynamicVirtualsFromPopulate(options.populate, dynamicVirtuals);\n            }\n\n            const result = await this.model.aggregatePaginate(\n                this.model.aggregate(pipeline),\n                filteredOptions,\n            );\n\n            const finalDocs = await this.populateDynamicVirtualsForDocuments(result.docs, options.populate);\n\n            return { success: true, result: { ...result, docs: finalDocs.map(item => item?.toObject?.() ?? item) } };\n        }\n        catch (error) {\n            return catchError<T_AggregatePaginateResult<T>>(error);\n        }\n    }\n\n    /**\n     * Counts documents matching the filter criteria.\n     *\n     * @param filter - The filter criteria to count documents.\n     * @returns A promise that resolves to a standardized response with the document count.\n     */\n    async count(filter: T_QueryFilter<T> = {}): Promise<I_Return<number>> {\n        try {\n            const normalizedFilter = normalizeMongoFilter(filter);\n            const result = await this.model.countDocuments(normalizedFilter);\n\n            return { success: true, result };\n        }\n        catch (error) {\n            return catchError<number>(error);\n        }\n    }\n\n    /**\n     * Creates a single document.\n     *\n     * @param doc - The document to create.\n     * @returns A promise that resolves to a standardized response with the created document.\n     */\n    async createOne(doc: T | Partial<T>): Promise<I_Return<T>> {\n        try {\n            const result = await this.model.create(doc as unknown as Parameters<typeof this.model.create>[0]);\n\n            return { success: true, result: (result as T)?.toObject?.() ?? result };\n        }\n        catch (error) {\n            return catchError<T>(error);\n        }\n    }\n\n    /**\n     * Creates multiple documents with bulk insertion.\n     *\n     * @param docs - An array of documents to create.\n     * @param options - Options for the bulk insertion operation.\n     * @returns A promise that resolves to a standardized response with the created documents.\n     */\n    async createMany(\n        docs: (T | Partial<T>)[],\n        options: T_InsertManyOptions = {},\n    ): Promise<I_Return<T[]>> {\n        try {\n            const createdDocuments = await this.model.insertMany(docs, options);\n\n            return { success: true, result: createdDocuments.map(item => item?.toObject?.() ?? item) as T[] };\n        }\n        catch (error) {\n            return catchError<T[]>(error);\n        }\n    }\n\n    /**\n     * Updates a single document and returns the updated version.\n     *\n     * @param filter - The filter criteria to find the document to update.\n     * @param update - The update data to apply.\n     * @param options - Options for the update operation.\n     * @returns A promise that resolves to a standardized response with the updated document.\n     */\n    async updateOne(\n        filter: T_QueryFilter<T> = {},\n        update: T_UpdateQuery<T> = {},\n        options: I_UpdateOptionsExtended = {},\n    ): Promise<I_Return<T>> {\n        try {\n            const normalizedFilter = normalizeMongoFilter(filter);\n            const result = await this.model\n                .findOneAndUpdate(normalizedFilter, update, {\n                    new: true,\n                    ...options,\n                })\n                .exec();\n\n            if (!result) {\n                return {\n                    success: false,\n                    message: `Failed to update ${this.getModelName()}.`,\n                    code: RESPONSE_STATUS.NOT_FOUND.CODE,\n                };\n            }\n\n            return { success: true, result: result?.toObject?.() ?? result };\n        }\n        catch (error) {\n            return catchError<T>(error);\n        }\n    }\n\n    /**\n     * Updates multiple documents matching the filter criteria.\n     *\n     * @param filter - The filter criteria to find documents to update.\n     * @param update - The update data to apply.\n     * @param options - Options for the update operation.\n     * @returns A promise that resolves to a standardized response with the update result.\n     */\n    async updateMany(\n        filter: T_QueryFilter<T> = {},\n        update: T_UpdateQuery<T> = {},\n        options: I_UpdateOptionsExtended = {},\n    ): Promise<I_Return<T_UpdateResult>> {\n        try {\n            const normalizedFilter = normalizeMongoFilter(filter);\n            const result = await this.model\n                .updateMany(normalizedFilter, update, options)\n                .exec();\n\n            return { success: true, result };\n        }\n        catch (error) {\n            return catchError<T_UpdateResult>(error);\n        }\n    }\n\n    /**\n     * Deletes a single document and returns the deleted version.\n     *\n     * @param filter - The filter criteria to find the document to delete.\n     * @param options - Options for the delete operation.\n     * @returns A promise that resolves to a standardized response with the deleted document.\n     */\n    async deleteOne(\n        filter: T_QueryFilter<T> = {},\n        options: I_DeleteOptionsExtended = {},\n    ): Promise<I_Return<T>> {\n        try {\n            const normalizedFilter = normalizeMongoFilter(filter);\n            const result = await this.model\n                .findOneAndDelete(normalizedFilter, options)\n                .exec();\n\n            if (!result) {\n                return {\n                    success: false,\n                    message: `No ${this.getModelName()} found to delete.`,\n                    code: RESPONSE_STATUS.NOT_FOUND.CODE,\n                };\n            }\n\n            return { success: true, result: result?.toObject?.() ?? result };\n        }\n        catch (error) {\n            return catchError<T>(error);\n        }\n    }\n\n    /**\n     * Deletes multiple documents matching the filter criteria.\n     *\n     * @param filter - The filter criteria to find documents to delete.\n     * @param options - Options for the delete operation.\n     * @returns A promise that resolves to a standardized response with the delete result.\n     */\n    async deleteMany(\n        filter: T_QueryFilter<T> = {},\n        options: I_DeleteOptionsExtended = {},\n    ): Promise<I_Return<T_DeleteResult>> {\n        try {\n            const normalizedFilter = normalizeMongoFilter(filter);\n            const result = await this.model.deleteMany(normalizedFilter, options).exec();\n\n            if (result.deletedCount === 0) {\n                return {\n                    success: false,\n                    message: `No documents found to delete.`,\n                    code: RESPONSE_STATUS.NOT_FOUND.CODE,\n                };\n            }\n\n            return { success: true, result };\n        }\n        catch (error) {\n            return catchError<T_DeleteResult>(error);\n        }\n    }\n\n    /**\n     * Creates a unique short ID based on a given ID.\n     * This method generates multiple short IDs with increasing lengths and finds the first available one.\n     *\n     * @param id - The base ID to generate short IDs from.\n     * @param length - The initial length for short ID generation (default: 4).\n     * @returns A promise that resolves to a standardized response with the unique short ID.\n     */\n    async createShortId(id: string, length = 4): Promise<I_Return<string>> {\n        try {\n            const maxRetries = 10;\n            const shortIds = Array.from({ length: maxRetries }, (_, index) =>\n                generateShortId(id, index + length));\n\n            const existenceChecks = await Promise.all(\n                shortIds.map(shortId => this.model.exists({ shortId })),\n            );\n\n            const availableIndex = existenceChecks.findIndex(exists => !exists);\n\n            if (availableIndex !== -1) {\n                const availableShortId = shortIds[availableIndex];\n\n                if (availableShortId) {\n                    return { success: true, result: availableShortId };\n                }\n            }\n\n            return {\n                success: false,\n                message: 'Failed to create a unique shortId',\n                code: RESPONSE_STATUS.INTERNAL_SERVER_ERROR.CODE,\n            };\n        }\n        catch (error) {\n            return catchError<string>(error);\n        }\n    }\n\n    /**\n     * Creates a query for slug existence checking.\n     * This method generates a query that checks for slug existence in both current and historical slug fields.\n     *\n     * @param options - Configuration for slug query generation including slug, field, and filter.\n     * @param options.slug - The slug string to check for existence.\n     * @param options.field - The field name for object-based slug checking.\n     * @param options.isObject - Whether the slug is stored as an object with nested fields.\n     * @param options.haveHistory - Whether to check historical slug fields for existence.\n     * @param options.filter - Additional filter conditions to apply to the query.\n     * @returns A MongoDB query object for checking slug existence.\n     */\n    createSlugQuery({ slug, field, isObject, haveHistory = false, filter }: I_Input_GenerateSlug<T>) {\n        const baseFilter = { ...(filter ?? {}) };\n\n        return isObject\n            ? {\n                ...baseFilter,\n                $or: [\n                    { [`slug.${field}`]: slug },\n                    ...(haveHistory ? [{ slugHistory: { $elemMatch: { [`slug.${field}`]: slug } } }] : []),\n                ],\n            }\n            : {\n                ...baseFilter,\n                $or: [\n                    { slug },\n                    ...(haveHistory ? [{ slugHistory: slug }] : []),\n                ],\n            };\n    }\n\n    /**\n     * Creates a unique slug based on a given string.\n     * This method generates multiple slug variations and finds the first available one.\n     *\n     * @param options - Configuration for slug generation including slug, field, and filter.\n     * @param options.slug - The base slug string to make unique.\n     * @param options.field - The field name for object-based slug checking.\n     * @param options.isObject - Whether the slug is stored as an object with nested fields.\n     * @param options.haveHistory - Whether to check historical slug fields for uniqueness.\n     * @param options.filter - Additional filter conditions to apply when checking slug existence.\n     * @returns A promise that resolves to a unique slug string.\n     */\n    async createUniqueSlug({ slug, field, isObject, haveHistory, filter }: I_Input_GenerateSlug<T>): Promise<string> {\n        if (!slug || typeof slug !== 'string') {\n            throw new Error('Invalid slug provided: must be a non-empty string');\n        }\n\n        const baseSlug = generateSlug(slug);\n\n        const baseExists = await this.model.exists(\n            this.createSlugQuery({ slug: baseSlug, field, isObject, haveHistory, filter }),\n        );\n\n        if (!baseExists) {\n            return baseSlug;\n        }\n\n        for (let index = 1; index <= MONGO_SLUG_MAX_ATTEMPTS; index++) {\n            const slugVariation = `${baseSlug}-${index}`;\n\n            const exists = await this.model.exists(\n                this.createSlugQuery({ slug: slugVariation, field, isObject, haveHistory, filter }),\n            );\n\n            if (!exists) {\n                return slugVariation;\n            }\n        }\n\n        const timestamp = Date.now();\n        const randomSuffix = generateRandomString(6);\n\n        return `${baseSlug}-${timestamp}-${randomSuffix}`;\n    }\n\n    /**\n     * Creates a slug for a document field.\n     * This method handles both simple string fields and object fields with nested slug generation.\n     *\n     * @param options - Configuration for slug creation including field, source document, and filter.\n     * @param options.field - The field name to create a slug for.\n     * @param options.from - The source document containing the field value.\n     * @param options.haveHistory - Whether to check historical slug fields for uniqueness.\n     * @param options.filter - Additional filter conditions to apply when checking slug existence.\n     * @returns A promise that resolves to a standardized response with the created slug(s).\n     */\n    async createSlug<R = string>({ field, from, filter, haveHistory }: I_Input_CreateSlug<T>): Promise<I_Return<R>> {\n        try {\n            const fieldValue = from[field as keyof T];\n            const isObjectValue = isObject(fieldValue);\n\n            if (isObjectValue) {\n                const uniqueSlug = Object.fromEntries(\n                    await Promise.all(\n                        Object.entries(fieldValue).map(async ([key, value]) => {\n                            const uniqueSlugForKey = await this.createUniqueSlug({\n                                slug: value as string,\n                                field: key,\n                                isObject: true,\n                                haveHistory,\n                                filter,\n                            });\n                            return [key, uniqueSlugForKey];\n                        }),\n                    ),\n                );\n\n                return { success: true, result: uniqueSlug as R };\n            }\n\n            const uniqueSlug = await this.createUniqueSlug({\n                slug: fieldValue as string,\n                field,\n                isObject: false,\n                haveHistory,\n                filter,\n            });\n\n            return { success: true, result: uniqueSlug as R };\n        }\n        catch (error) {\n            return catchError<R>(error);\n        }\n    }\n\n    /**\n     * Checks if a slug already exists in the collection.\n     * This method verifies slug existence in both current and historical slug fields.\n     *\n     * @param options - Configuration for slug checking including slug, field, source document, and filter.\n     * @param options.slug - The slug string to check for existence.\n     * @param options.field - The field name for object-based slug checking.\n     * @param options.from - The source document containing the field value.\n     * @param options.haveHistory - Whether to check historical slug fields for existence.\n     * @param options.filter - Additional filter conditions to apply to the query.\n     * @returns A promise that resolves to a standardized response indicating whether the slug exists.\n     */\n    async checkSlug({ slug, field, from, filter, haveHistory }: I_Input_CheckSlug<T>): Promise<I_Return<boolean>> {\n        try {\n            const fieldValue = from[field as keyof T];\n            const isObjectValue = isObject(fieldValue);\n\n            if (isObjectValue) {\n                const values = Object.values(fieldValue);\n                const nestedSlugs = values.map(value => generateSlug(value as string));\n\n                const existenceChecks = await Promise.all(\n                    nestedSlugs.map(nestedSlug =>\n                        this.model.exists(this.createSlugQuery({\n                            slug: nestedSlug,\n                            field,\n                            isObject: true,\n                            haveHistory,\n                            filter,\n                        })),\n                    ),\n                );\n\n                if (existenceChecks.some(exists => exists)) {\n                    return { success: true, result: true };\n                }\n\n                return { success: true, result: false };\n            }\n\n            const baseSlug = generateSlug(slug);\n            const exists = await this.model.exists(this.createSlugQuery({\n                slug: baseSlug,\n                field,\n                isObject: false,\n                filter,\n            }));\n\n            return { success: true, result: exists !== null };\n        }\n        catch (error) {\n            return catchError<boolean>(error);\n        }\n    }\n\n    /**\n     * Performs aggregation operations on the collection.\n     *\n     * @param pipeline - The aggregation pipeline stages to execute.\n     * @returns A promise that resolves to a standardized response with the aggregation results.\n     */\n    async aggregate(pipeline: T_PipelineStage[]): Promise<I_Return<T[]>> {\n        try {\n            const result = await this.model.aggregate<T>(pipeline);\n\n            return { success: true, result };\n        }\n        catch (error) {\n            return catchError<T[]>(error);\n        }\n    }\n\n    /**\n     * Retrieves distinct values for the specified key from the collection.\n     *\n     * @param key - The field for which to return distinct values.\n     * @param filter - The filter query to apply (optional).\n     * @param options - Additional options for the distinct operation (optional).\n     * @returns A promise that resolves to a standardized response with the array of distinct values.\n     */\n    async distinct(\n        key: string,\n        filter: T_QueryFilter<T> = {},\n        options: T_QueryOptions<T> = {},\n    ): Promise<I_Return<unknown[]>> {\n        try {\n            const result = await this.model.distinct(key, filter, options);\n\n            return { success: true, result };\n        }\n        catch (error) {\n            return catchError<unknown[]>(error);\n        }\n    }\n}\n"],"names":["MONGO_SLUG_MAX_ATTEMPTS","populateDynamicVirtuals","filterDynamicVirtualsFromPopulate","isObject","normalizeMongoFilter","generateShortId","generateSlug","generateRandomString","RESPONSE_STATUS","catchError","MongooseController","model","dynamicOnly","v","result","populate","dynamicVirtuals","populatedArr","results","filter","projection","options","normalizedFilter","query","regularPopulate","finalResult","error","item","filteredOptions","populatedDocs","pipeline","finalDocs","doc","docs","update","id","length","shortIds","_","index","availableIndex","shortId","exists","availableShortId","slug","field","haveHistory","baseFilter","baseSlug","slugVariation","timestamp","randomSuffix","from","fieldValue","key","value","uniqueSlugForKey","uniqueSlug","nestedSlugs","nestedSlug"],"mappings":"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"}

package/dist/node/mongo/mongo.controller.native.d.ts

@@ -0,0 +1,84 @@
+import { I_Return } from '../../typescript/index.js';
+import { C_Db, C_Document, T_DeleteResult, T_Filter, T_UpdateResult, T_WithId } from './mongo.type.js';
+/**
+ * MongoDB native driver controller for direct database operations.
+ * This class provides a simplified interface for MongoDB operations using the native driver,
+ * with automatic generic field generation and standardized response formatting.
+ */
+export declare class MongoController<D extends Partial<C_Document>> {
+    private collection;
+    /**
+     * Creates a new MongoDB controller instance.
+     *
+     * @param db - The MongoDB database instance.
+     * @param collectionName - The name of the collection to operate on.
+     */
+    constructor(db: C_Db, collectionName: string);
+    /**
+     * Creates a single document in the collection.
+     * This method adds generic fields (id, isDel, timestamps) to the document before insertion.
+     *
+     * @param document - The document to create, with or without generic fields.
+     * @returns A promise that resolves to a standardized response with the created document.
+     */
+    createOne(document: D | Partial<D>): Promise<I_Return<D | Partial<D>>>;
+    /**
+     * Creates multiple documents in the collection.
+     * This method adds generic fields to each document before bulk insertion.
+     *
+     * @param documents - An array of documents to create.
+     * @returns A promise that resolves to a standardized response with the created documents.
+     */
+    createMany(documents: (D | Partial<D>)[]): Promise<I_Return<(D | Partial<D>)[]>>;
+    /**
+     * Finds a single document by filter criteria.
+     *
+     * @param filter - The filter criteria to find the document.
+     * @returns A promise that resolves to a standardized response with the found document.
+     */
+    findOne(filter: T_Filter<D>): Promise<I_Return<T_WithId<D>>>;
+    /**
+     * Finds all documents matching the filter criteria.
+     *
+     * @param filter - The filter criteria to find documents (defaults to empty object for all documents).
+     * @returns A promise that resolves to a standardized response with the found documents.
+     */
+    findAll(filter?: T_Filter<D>): Promise<I_Return<T_WithId<D>[]>>;
+    /**
+     * Counts documents matching the filter criteria.
+     *
+     * @param filter - The filter criteria to count documents (defaults to empty object for all documents).
+     * @returns A promise that resolves to a standardized response with the document count.
+     */
+    count(filter?: T_Filter<D>): Promise<I_Return<number>>;
+    /**
+     * Updates a single document matching the filter criteria.
+     *
+     * @param filter - The filter criteria to find the document to update.
+     * @param update - The update data to apply to the document.
+     * @returns A promise that resolves to a standardized response with the update result.
+     */
+    updateOne(filter: T_Filter<D>, update: Partial<D>): Promise<I_Return<T_UpdateResult>>;
+    /**
+     * Updates multiple documents matching the filter criteria.
+     *
+     * @param filter - The filter criteria to find documents to update.
+     * @param update - The update data to apply to the documents.
+     * @returns A promise that resolves to a standardized response with the update result.
+     */
+    updateMany(filter: T_Filter<D>, update: Partial<D>): Promise<I_Return<T_UpdateResult>>;
+    /**
+     * Deletes a single document matching the filter criteria.
+     *
+     * @param filter - The filter criteria to find the document to delete.
+     * @returns A promise that resolves to a standardized response with the delete result.
+     */
+    deleteOne(filter: T_Filter<D>): Promise<I_Return<T_DeleteResult>>;
+    /**
+     * Deletes multiple documents matching the filter criteria.
+     *
+     * @param filter - The filter criteria to find documents to delete.
+     * @returns A promise that resolves to a standardized response with the delete result.
+     */
+    deleteMany(filter: T_Filter<D>): Promise<I_Return<T_DeleteResult>>;
+}