@cyberskill/shared 3.9.0 → 3.10.0

package/dist/config/lint-staged/index.js

@@ -1,6 +1,6 @@
 //#region src/config/lint-staged/index.ts
 var e = {
-	"*.ts": () => "tsc --noEmit",
+	"*.ts": () => "tsc --noEmit --incremental",
 	"*": ["eslint --fix --no-cache"]
 };
 //#endregion

package/dist/config/lint-staged/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/config/lint-staged/index.ts"],"sourcesContent":["export default {\n    '*.ts': () => 'tsc --noEmit',\n    '*': ['eslint --fix --no-cache'],\n};\n"],"mappings":";AAAA,IAAA,IAAe;CACX,cAAc;CACd,KAAK,CAAC,0BAA0B;CACnC"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/config/lint-staged/index.ts"],"sourcesContent":["export default {\n    '*.ts': () => 'tsc --noEmit --incremental',\n    '*': ['eslint --fix --no-cache'],\n};\n"],"mappings":";AAAA,IAAA,IAAe;CACX,cAAc;CACd,KAAK,CAAC,0BAA0B;CACnC"}

package/dist/config/vitest/vitest.e2e.js

@@ -1,5 +1,5 @@
 import { deepMerge as e } from "../../util/object/object.util.js";
-import { defineConfig as t } from "../../node_modules/.pnpm/vitest@4.1.0_@types_node@25.5.0_jsdom@29.0.0_@noble_hashes@1.8.0__vite@8.0.0_@types_nod_53aa4254f295b3c40bb8f17b6ab226b5/node_modules/vitest/dist/config.js";
+import { defineConfig as t } from "../../node_modules/.pnpm/vitest@4.1.0_@types_node@25.5.0_jsdom@29.0.0_@noble_hashes@1.8.0__vite@8.0.1_@types_nod_36acd00c2670b611b011192023dc5bd9/node_modules/vitest/dist/config.js";
 import n from "@vitejs/plugin-react";
 //#region src/config/vitest/vitest.e2e.ts
 function r(r) {

package/dist/config/vitest/vitest.unit.js

@@ -1,5 +1,5 @@
 import { deepMerge as e } from "../../util/object/object.util.js";
-import { defineConfig as t } from "../../node_modules/.pnpm/vitest@4.1.0_@types_node@25.5.0_jsdom@29.0.0_@noble_hashes@1.8.0__vite@8.0.0_@types_nod_53aa4254f295b3c40bb8f17b6ab226b5/node_modules/vitest/dist/config.js";
+import { defineConfig as t } from "../../node_modules/.pnpm/vitest@4.1.0_@types_node@25.5.0_jsdom@29.0.0_@noble_hashes@1.8.0__vite@8.0.1_@types_nod_36acd00c2670b611b011192023dc5bd9/node_modules/vitest/dist/config.js";
 import n from "@vitejs/plugin-react";
 //#region src/config/vitest/vitest.unit.ts
 function r(r) {

package/dist/node/express/express.util.js

@@ -49,8 +49,8 @@ function m(t) {
 		}
 	});
 }
-function h(e, n = !1, r = "1mb", o = !1, c = {}) {
-	o !== !1 && e.set("trust proxy", o), e.use(d({
+function h(e, n = !1, r = "1mb", o = 1, c = {}) {
+	o && e.set("trust proxy", o), e.use(d({
 		crossOriginEmbedderPolicy: n ? !1 : void 0,
 		contentSecurityPolicy: n ? !1 : void 0
 	})), c !== !1 && e.use(s({
@@ -59,8 +59,7 @@ function h(e, n = !1, r = "1mb", o = !1, c = {}) {
 		standardHeaders: !0,
 		legacyHeaders: !1,
 		...c.store !== void 0 && { store: c.store },
-		...c.skip !== void 0 && { skip: c.skip },
-		...!o && { validate: { xForwardedForHeader: !1 } }
+		...c.skip !== void 0 && { skip: c.skip }
 	})), e.use(a()), e.use(t.json({ limit: r })), e.use(t.urlencoded({
 		extended: !0,
 		limit: r

package/dist/node/express/express.util.js.map

@@ -1 +1 @@
-{"version":3,"file":"express.util.js","names":[],"sources":["../../../src/node/express/express.util.ts"],"sourcesContent":["import type { INestApplication } from '@nestjs/common';\nimport type { Application, RequestHandler } from 'express';\nimport type { SessionOptions } from 'express-session';\n\nimport { NestFactory } from '@nestjs/core';\nimport bodyParser from 'body-parser';\nimport compression from 'compression';\nimport cookieParser from 'cookie-parser';\nimport cors from 'cors';\nimport express from 'express';\nimport rateLimit from 'express-rate-limit';\nimport session from 'express-session';\nimport { express as useragent } from 'express-useragent';\nimport graphqlUploadExpress from 'graphql-upload/graphqlUploadExpress.mjs';\nimport helmet from 'helmet';\nimport process from 'node:process';\n\nimport type { I_ExpressOptions, I_NestOptions, T_CorsOptions, T_CorsType } from './express.type.js';\n\n/**\n * Creates CORS options with environment-specific configuration.\n * This function generates CORS options based on the development environment,\n * including whitelist configuration for allowed origins.\n *\n * @param options - CORS configuration options.\n * @param options.isDev - Whether the application is running in development mode.\n * @param options.whiteList - Array of allowed origins for CORS requests.\n * @returns CORS options object configured for the specified environment.\n */\nexport function createCorsOptions<T extends T_CorsType>({ isDev, whiteList, ...rest }: T_CorsOptions<T>) {\n    // Safety net: warn loudly if isDev is mistakenly true in production\n    if (isDev && process.env['NODE_ENV'] === 'production') {\n        console.warn('[CORS] WARNING: isDev is true but NODE_ENV is \"production\". CORS restrictions are relaxed. This is likely a misconfiguration.');\n    }\n\n    return {\n        origin: (origin: string | undefined, callback: (err: Error | null, allow?: boolean) => void) => {\n            // Allow requests without Origin header only in development mode.\n            // In production, undefined origin (e.g., curl, server-to-server) is rejected.\n            if (isDev && !origin) {\n                callback(null, true);\n                return;\n            }\n\n            if (origin && whiteList?.includes(origin)) {\n                callback(null, true);\n            }\n            else {\n                callback(new Error('Not allowed by CORS'), false);\n            }\n        },\n        credentials: true,\n        ...rest,\n    };\n}\n\n/**\n * Creates a CORS middleware function with the specified configuration.\n * This function creates a CORS middleware that can be used with both Express and NestJS applications,\n * applying the configured CORS options for origin validation and credential handling.\n *\n * @param options - CORS configuration options to apply to the middleware.\n * @returns A CORS middleware function ready to be used in Express or NestJS applications.\n */\nexport function createCors<T extends T_CorsType>(options: T_CorsOptions<T>) {\n    return cors<cors.CorsRequest>(createCorsOptions(options));\n}\n\n/**\n * Creates a session middleware function with the specified configuration.\n * This function creates an Express session middleware that can be used to handle user sessions\n * with the provided session options including secret, cookie settings, and storage configuration.\n *\n * @param options - Session configuration options including secret, cookie settings, and storage.\n * @returns A session middleware function ready to be used in Express applications.\n */\nexport function createSession(options: SessionOptions): RequestHandler {\n    if (!options.secret) {\n        throw new Error('Session secret is required. Provide a strong secret string.');\n    }\n\n    if (!options.store && process.env['NODE_ENV'] === 'production') {\n        console.warn('[Session] WARNING: No session store configured in production. The default MemoryStore leaks memory and loses sessions on restart. Use connect-redis, connect-mongo, or another production store.');\n    }\n\n    const secureDefaults: Partial<SessionOptions> = {\n        resave: false,\n        saveUninitialized: false,\n        cookie: {\n            httpOnly: true,\n            sameSite: 'lax',\n            secure: process.env['NODE_ENV'] === 'production',\n            maxAge: 24 * 60 * 60 * 1000, // 24 hours\n        },\n    };\n\n    return session({\n        ...secureDefaults,\n        ...options,\n        cookie: { ...secureDefaults.cookie, ...options.cookie },\n    });\n}\n\n/**\n * Sets up common middleware for Express applications.\n * This function configures essential middleware including:\n * - Trust proxy settings for proper IP handling\n * - Cookie parsing for request cookies\n * - URL-encoded body parsing for form data\n * - Compression for response optimization\n * - User agent parsing for device/browser detection\n *\n * @param app - The Express application instance to configure with middleware.\n * @param isDev - Whether the application is running in development mode.\n * @param jsonLimit - Maximum request body size for JSON payloads.\n * @param trustProxy - Trust proxy setting; pass a truthy value to enable.\n * @param rateLimitOptions - Rate limit configuration, or `false` to disable.\n */\nfunction setupMiddleware(\n    app: Application,\n    isDev = false,\n    jsonLimit = '1mb',\n    trustProxy: boolean | number | string | string[] = false,\n    rateLimitOptions: false | import('./express.type.js').I_RateLimitOptions = {},\n) {\n    if (trustProxy !== false) {\n        app.set('trust proxy', trustProxy);\n    }\n\n    app.use(\n        helmet({\n            crossOriginEmbedderPolicy: isDev ? false : undefined,\n            contentSecurityPolicy: isDev ? false : undefined,\n        }),\n    );\n\n    if (rateLimitOptions !== false) {\n        app.use(\n            rateLimit({\n                windowMs: rateLimitOptions.windowMs ?? 15 * 60 * 1000,\n                limit: rateLimitOptions.limit ?? 1000,\n                standardHeaders: true,\n                legacyHeaders: false,\n                ...(rateLimitOptions.store !== undefined && { store: rateLimitOptions.store }),\n                ...(rateLimitOptions.skip !== undefined && { skip: rateLimitOptions.skip }),\n                // When trustProxy is not explicitly set, suppress the\n                // ERR_ERL_UNEXPECTED_X_FORWARDED_FOR validation that crashes on\n                // X-Forwarded-For headers behind a reverse proxy.\n                ...(!trustProxy && { validate: { xForwardedForHeader: false } }),\n            }),\n        );\n    }\n    app.use(cookieParser());\n    app.use(express.json({ limit: jsonLimit }));\n    app.use(express.urlencoded({ extended: true, limit: jsonLimit }));\n    app.use(compression());\n    app.use(useragent());\n}\n\n/**\n * Sets up static file serving for Express applications.\n * This function configures static file serving for the specified folders,\n * making files in those directories accessible via HTTP requests.\n *\n * @param app - The Express application instance to configure with static file serving.\n * @param staticFolders - A string or array of strings representing the paths to serve statically.\n */\nfunction setupStaticFolders(app: Application, staticFolders?: string | string[]) {\n    if (staticFolders) {\n        const statics = Array.isArray(staticFolders) ? staticFolders : [staticFolders];\n        statics.forEach((folder) => {\n            app.use(`/${folder}`, express.static(folder));\n        });\n    }\n}\n\n/**\n * Creates and configures an Express application with common middleware and settings.\n * This function sets up a complete Express application with:\n * - Essential middleware (cookies, body parsing, compression, user agent)\n * - Static file serving for specified folders\n * - GraphQL upload support for file uploads\n *\n * @remarks\n * **Requires Express 5.x** — This module uses Express 5 APIs and is not compatible with Express 4.\n * The peer dependency requires `express >= 5.0.0`.\n *\n * @param options - Optional configuration for the Express application including static folder paths.\n * @returns A configured Express application instance ready for use.\n */\nexport function createExpress(options?: I_ExpressOptions): Application {\n    const app = express();\n\n    setupMiddleware(app, options?.isDev, options?.jsonLimit, options?.trustProxy, options?.rateLimit);\n    setupStaticFolders(app, options?.static);\n    const uploadMiddleware = graphqlUploadExpress({\n        maxFileSize: options?.maxFileSize ?? 10_000_000,\n        maxFiles: options?.maxFiles ?? 10,\n    });\n    app.use(options?.uploadPath ?? '/graphql', uploadMiddleware);\n\n    return app;\n}\n\n/**\n * Creates and configures a NestJS application with Express integration.\n * This function sets up a NestJS application with:\n * - Express HTTP adapter configuration\n * - Common middleware (cookies, body parsing, compression, user agent)\n * - Static file serving for specified folders\n * - Global filters and pipes if provided\n *\n * @param options - Configuration options for the NestJS application including module, static folders, filters, and pipes.\n * @returns A promise that resolves to a configured NestJS application instance.\n */\nexport async function createNest(options: I_NestOptions): Promise<INestApplication> {\n    const app = await NestFactory.create(options.module);\n\n    setupMiddleware(app.getHttpAdapter().getInstance(), options.isDev, options.jsonLimit, options.trustProxy, options.rateLimit);\n    setupStaticFolders(app.getHttpAdapter().getInstance(), options.static);\n\n    if (options.filters) {\n        app.useGlobalFilters(...options.filters);\n    }\n\n    if (options.pipes) {\n        app.useGlobalPipes(...options.pipes);\n    }\n\n    return app;\n}\n\nexport { bodyParser, express };\n"],"mappings":"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"}
+{"version":3,"file":"express.util.js","names":[],"sources":["../../../src/node/express/express.util.ts"],"sourcesContent":["import type { INestApplication } from '@nestjs/common';\nimport type { Application, RequestHandler } from 'express';\nimport type { SessionOptions } from 'express-session';\n\nimport { NestFactory } from '@nestjs/core';\nimport bodyParser from 'body-parser';\nimport compression from 'compression';\nimport cookieParser from 'cookie-parser';\nimport cors from 'cors';\nimport express from 'express';\nimport rateLimit from 'express-rate-limit';\nimport session from 'express-session';\nimport { express as useragent } from 'express-useragent';\nimport graphqlUploadExpress from 'graphql-upload/graphqlUploadExpress.mjs';\nimport helmet from 'helmet';\nimport process from 'node:process';\n\nimport type { I_ExpressOptions, I_NestOptions, T_CorsOptions, T_CorsType } from './express.type.js';\n\n/**\n * Creates CORS options with environment-specific configuration.\n * This function generates CORS options based on the development environment,\n * including whitelist configuration for allowed origins.\n *\n * @param options - CORS configuration options.\n * @param options.isDev - Whether the application is running in development mode.\n * @param options.whiteList - Array of allowed origins for CORS requests.\n * @returns CORS options object configured for the specified environment.\n */\nexport function createCorsOptions<T extends T_CorsType>({ isDev, whiteList, ...rest }: T_CorsOptions<T>) {\n    // Safety net: warn loudly if isDev is mistakenly true in production\n    if (isDev && process.env['NODE_ENV'] === 'production') {\n        console.warn('[CORS] WARNING: isDev is true but NODE_ENV is \"production\". CORS restrictions are relaxed. This is likely a misconfiguration.');\n    }\n\n    return {\n        origin: (origin: string | undefined, callback: (err: Error | null, allow?: boolean) => void) => {\n            // Allow requests without Origin header only in development mode.\n            // In production, undefined origin (e.g., curl, server-to-server) is rejected.\n            if (isDev && !origin) {\n                callback(null, true);\n                return;\n            }\n\n            if (origin && whiteList?.includes(origin)) {\n                callback(null, true);\n            }\n            else {\n                callback(new Error('Not allowed by CORS'), false);\n            }\n        },\n        credentials: true,\n        ...rest,\n    };\n}\n\n/**\n * Creates a CORS middleware function with the specified configuration.\n * This function creates a CORS middleware that can be used with both Express and NestJS applications,\n * applying the configured CORS options for origin validation and credential handling.\n *\n * @param options - CORS configuration options to apply to the middleware.\n * @returns A CORS middleware function ready to be used in Express or NestJS applications.\n */\nexport function createCors<T extends T_CorsType>(options: T_CorsOptions<T>) {\n    return cors<cors.CorsRequest>(createCorsOptions(options));\n}\n\n/**\n * Creates a session middleware function with the specified configuration.\n * This function creates an Express session middleware that can be used to handle user sessions\n * with the provided session options including secret, cookie settings, and storage configuration.\n *\n * @param options - Session configuration options including secret, cookie settings, and storage.\n * @returns A session middleware function ready to be used in Express applications.\n */\nexport function createSession(options: SessionOptions): RequestHandler {\n    if (!options.secret) {\n        throw new Error('Session secret is required. Provide a strong secret string.');\n    }\n\n    if (!options.store && process.env['NODE_ENV'] === 'production') {\n        console.warn('[Session] WARNING: No session store configured in production. The default MemoryStore leaks memory and loses sessions on restart. Use connect-redis, connect-mongo, or another production store.');\n    }\n\n    const secureDefaults: Partial<SessionOptions> = {\n        resave: false,\n        saveUninitialized: false,\n        cookie: {\n            httpOnly: true,\n            sameSite: 'lax',\n            secure: process.env['NODE_ENV'] === 'production',\n            maxAge: 24 * 60 * 60 * 1000, // 24 hours\n        },\n    };\n\n    return session({\n        ...secureDefaults,\n        ...options,\n        cookie: { ...secureDefaults.cookie, ...options.cookie },\n    });\n}\n\n/**\n * Sets up common middleware for Express applications.\n * This function configures essential middleware including:\n * - Trust proxy settings for proper IP handling\n * - Cookie parsing for request cookies\n * - URL-encoded body parsing for form data\n * - Compression for response optimization\n * - User agent parsing for device/browser detection\n *\n * @param app - The Express application instance to configure with middleware.\n * @param isDev - Whether the application is running in development mode.\n * @param jsonLimit - Maximum request body size for JSON payloads.\n * @param trustProxy - Trust proxy setting; pass a truthy value to enable.\n * @param rateLimitOptions - Rate limit configuration, or `false` to disable.\n */\nfunction setupMiddleware(\n    app: Application,\n    isDev = false,\n    jsonLimit = '1mb',\n    trustProxy: boolean | number | string | string[] = 1,\n    rateLimitOptions: false | import('./express.type.js').I_RateLimitOptions = {},\n) {\n    if (trustProxy) {\n        app.set('trust proxy', trustProxy);\n    }\n\n    app.use(\n        helmet({\n            crossOriginEmbedderPolicy: isDev ? false : undefined,\n            contentSecurityPolicy: isDev ? false : undefined,\n        }),\n    );\n\n    if (rateLimitOptions !== false) {\n        app.use(\n            rateLimit({\n                windowMs: rateLimitOptions.windowMs ?? 15 * 60 * 1000,\n                limit: rateLimitOptions.limit ?? 1000,\n                standardHeaders: true,\n                legacyHeaders: false,\n                ...(rateLimitOptions.store !== undefined && { store: rateLimitOptions.store }),\n                ...(rateLimitOptions.skip !== undefined && { skip: rateLimitOptions.skip }),\n            }),\n        );\n    }\n    app.use(cookieParser());\n    app.use(express.json({ limit: jsonLimit }));\n    app.use(express.urlencoded({ extended: true, limit: jsonLimit }));\n    app.use(compression());\n    app.use(useragent());\n}\n\n/**\n * Sets up static file serving for Express applications.\n * This function configures static file serving for the specified folders,\n * making files in those directories accessible via HTTP requests.\n *\n * @param app - The Express application instance to configure with static file serving.\n * @param staticFolders - A string or array of strings representing the paths to serve statically.\n */\nfunction setupStaticFolders(app: Application, staticFolders?: string | string[]) {\n    if (staticFolders) {\n        const statics = Array.isArray(staticFolders) ? staticFolders : [staticFolders];\n        statics.forEach((folder) => {\n            app.use(`/${folder}`, express.static(folder));\n        });\n    }\n}\n\n/**\n * Creates and configures an Express application with common middleware and settings.\n * This function sets up a complete Express application with:\n * - Essential middleware (cookies, body parsing, compression, user agent)\n * - Static file serving for specified folders\n * - GraphQL upload support for file uploads\n *\n * @remarks\n * **Requires Express 5.x** — This module uses Express 5 APIs and is not compatible with Express 4.\n * The peer dependency requires `express >= 5.0.0`.\n *\n * @param options - Optional configuration for the Express application including static folder paths.\n * @returns A configured Express application instance ready for use.\n */\nexport function createExpress(options?: I_ExpressOptions): Application {\n    const app = express();\n\n    setupMiddleware(app, options?.isDev, options?.jsonLimit, options?.trustProxy, options?.rateLimit);\n    setupStaticFolders(app, options?.static);\n    const uploadMiddleware = graphqlUploadExpress({\n        maxFileSize: options?.maxFileSize ?? 10_000_000,\n        maxFiles: options?.maxFiles ?? 10,\n    });\n    app.use(options?.uploadPath ?? '/graphql', uploadMiddleware);\n\n    return app;\n}\n\n/**\n * Creates and configures a NestJS application with Express integration.\n * This function sets up a NestJS application with:\n * - Express HTTP adapter configuration\n * - Common middleware (cookies, body parsing, compression, user agent)\n * - Static file serving for specified folders\n * - Global filters and pipes if provided\n *\n * @param options - Configuration options for the NestJS application including module, static folders, filters, and pipes.\n * @returns A promise that resolves to a configured NestJS application instance.\n */\nexport async function createNest(options: I_NestOptions): Promise<INestApplication> {\n    const app = await NestFactory.create(options.module);\n\n    setupMiddleware(app.getHttpAdapter().getInstance(), options.isDev, options.jsonLimit, options.trustProxy, options.rateLimit);\n    setupStaticFolders(app.getHttpAdapter().getInstance(), options.static);\n\n    if (options.filters) {\n        app.useGlobalFilters(...options.filters);\n    }\n\n    if (options.pipes) {\n        app.useGlobalPipes(...options.pipes);\n    }\n\n    return app;\n}\n\nexport { bodyParser, express };\n"],"mappings":"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"}

package/dist/node/fs/fs.util.js

@@ -1,25 +1,25 @@
-import e from "fs-extra";
-import t from "node:path";
+import e from "node:path";
+import t from "fs-extra";
 //#region src/node/fs/fs.util.ts
-var n = e, { lstatSync: r, readdirSync: i, mkdirSync: a, readFileSync: o, unlinkSync: s, statSync: c, createWriteStream: l } = e, u = e.readJsonSync;
-function d(t, n, r) {
-	e.writeFileSync(t, n, r ?? "utf-8");
+var n = t, { lstatSync: r, readdirSync: i, mkdirSync: a, readFileSync: o, unlinkSync: s, statSync: c, createWriteStream: l } = t, u = t.readJsonSync;
+function d(e, n, r) {
+	t.writeFileSync(e, n, r ?? "utf-8");
 }
-function f(t, n, r) {
-	e.appendFileSync(t, n, r ?? "utf-8");
+function f(e, n, r) {
+	t.appendFileSync(e, n, r ?? "utf-8");
 }
-function p(...t) {
-	return t.every((t) => e.pathExistsSync(t));
+function p(...e) {
+	return e.every((e) => t.pathExistsSync(e));
 }
-function m(...t) {
-	t.forEach((t) => {
-		p(t) && e.removeSync(t);
+function m(...e) {
+	e.forEach((e) => {
+		p(e) && t.removeSync(e);
 	});
 }
 function h(n, r, i = {}) {
 	let { extensions: a, ...o } = i;
-	e.copySync(n, r, {
-		filter: (e) => c(e).isDirectory() || !a || a.length === 0 ? !0 : a.includes(t.extname(e)),
+	t.copySync(n, r, {
+		filter: (t) => c(t).isDirectory() || !a || a.length === 0 ? !0 : a.includes(e.extname(t)),
 		...o
 	});
 }

package/dist/node/mongo/index.js

@@ -1,8 +1,8 @@
 import { MONGO_MIGRATE_OPTIONS as e, MONGO_SLUG_MAX_ATTEMPTS as t } from "./mongo.constant.js";
 import { convertEnumToModelName as n, mongo as r } from "./mongo.util.js";
 import { applyNestedPopulate as i } from "./mongo.populate.js";
-import { filterDynamicVirtualsFromPopulate as a, isMongooseDoc as o, isObject as s, populateDynamicVirtuals as c, remapDynamicPopulate as l } from "./mongo.dynamic-populate.js";
-import { MongooseController as u } from "./mongo.controller.mongoose.js";
-import { MongoController as d } from "./mongo.controller.native.js";
-import { C_Collection as f, C_Db as p, C_Document as m, C_Model as h } from "./mongo.type.js";
-export { f as C_Collection, p as C_Db, m as C_Document, h as C_Model, e as MONGO_MIGRATE_OPTIONS, t as MONGO_SLUG_MAX_ATTEMPTS, d as MongoController, u as MongooseController, i as applyNestedPopulate, n as convertEnumToModelName, a as filterDynamicVirtualsFromPopulate, o as isMongooseDoc, s as isObject, r as mongo, c as populateDynamicVirtuals, l as remapDynamicPopulate };
+import { filterDynamicVirtualsFromPopulate as a, isMongooseDoc as o, populateDynamicVirtuals as s, remapDynamicPopulate as c } from "./mongo.dynamic-populate.js";
+import { MongooseController as l } from "./mongo.controller.mongoose.js";
+import { MongoController as u } from "./mongo.controller.native.js";
+import { C_Collection as d, C_Db as f, C_Document as p, C_Model as m } from "./mongo.type.js";
+export { d as C_Collection, f as C_Db, p as C_Document, m as C_Model, e as MONGO_MIGRATE_OPTIONS, t as MONGO_SLUG_MAX_ATTEMPTS, u as MongoController, l as MongooseController, i as applyNestedPopulate, n as convertEnumToModelName, a as filterDynamicVirtualsFromPopulate, o as isMongooseDoc, r as mongo, s as populateDynamicVirtuals, c as remapDynamicPopulate };

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

@@ -1,9 +1,10 @@
-import { RESPONSE_STATUS as e } from "../../constant/response-status.js";
-import { normalizeMongoFilter as t } from "../../util/object/object.util.js";
-import { generateRandomString as n, generateShortId as r, generateSlug as i } from "../../util/string/string.util.js";
-import { catchError as a, log as o } from "../log/log.util.js";
+import { isObject as e } from "../../util/common/common.util.js";
+import { RESPONSE_STATUS as t } from "../../constant/response-status.js";
+import { normalizeMongoFilter as n } from "../../util/object/object.util.js";
+import { generateRandomString as r, generateShortId as i, generateSlug as a } from "../../util/string/string.util.js";
+import { catchError as o, log as s } from "../log/log.util.js";
 import "./mongo.constant.js";
-import { filterDynamicVirtualsFromPopulate as s, isObject as c, populateDynamicVirtuals as l } from "./mongo.dynamic-populate.js";
+import { filterDynamicVirtualsFromPopulate as c, populateDynamicVirtuals as l } from "./mongo.dynamic-populate.js";
 //#region src/node/mongo/mongo.controller.mongoose.ts
 function u(e) {
 	return e?.toObject?.() ?? e;
@@ -34,46 +35,46 @@ var d = class {
 		let n = this.getDynamicVirtuals();
 		return n && n.length > 0 && e.length > 0 ? await l(this.model.base, e, n, t, void 0, this.model) : e;
 	}
-	async findOne(n = {}, r = {}, i = {}, o) {
+	async findOne(e = {}, r = {}, i = {}, a) {
 		try {
-			let a = t(n), c = this.model.findOne(a, r, i).maxTimeMS(3e4).lean(), l = s(o, this.getDynamicVirtuals());
-			l && c.populate(l);
-			let d = await c.exec();
+			let o = n(e), s = this.model.findOne(o, r, i).maxTimeMS(3e4).lean(), l = c(a, this.getDynamicVirtuals());
+			l && s.populate(l);
+			let d = await s.exec();
 			return d ? {
 				success: !0,
-				result: u(await this.populateDynamicVirtualsForDocument(d, o))
+				result: u(await this.populateDynamicVirtualsForDocument(d, a))
 			} : {
 				success: !1,
 				message: `No ${this.getModelName()} found.`,
-				code: e.NOT_FOUND.CODE
+				code: t.NOT_FOUND.CODE
 			};
 		} catch (e) {
-			return a(e);
+			return o(e);
 		}
 	}
-	async findAll(e = {}, n = {}, r = {}, i) {
+	async findAll(e = {}, t = {}, r = {}, i) {
 		try {
-			let a = t(e), c = this.model.find(a, n, r).maxTimeMS(3e4).lean();
-			r.limit || c.limit(this.defaultLimit);
-			let l = s(i, this.getDynamicVirtuals());
-			l && c.populate(l);
-			let d = await c.exec(), f = await this.populateDynamicVirtualsForDocuments(d, i), p = f.length === this.defaultLimit && !r.limit;
-			return p && o.warn(`[${this.getModelName()}] findAll returned exactly ${this.defaultLimit} documents (the default limit). Results may be truncated. Consider using pagination or setting an explicit limit.`), {
+			let a = n(e), o = this.model.find(a, t, r).maxTimeMS(3e4).lean();
+			r.limit || o.limit(this.defaultLimit);
+			let l = c(i, this.getDynamicVirtuals());
+			l && o.populate(l);
+			let d = await o.exec(), f = await this.populateDynamicVirtualsForDocuments(d, i), p = f.length === this.defaultLimit && !r.limit;
+			return p && s.warn(`[${this.getModelName()}] findAll returned exactly ${this.defaultLimit} documents (the default limit). Results may be truncated. Consider using pagination or setting an explicit limit.`), {
 				success: !0,
 				result: f.map((e) => u(e)),
 				truncated: p
 			};
 		} catch (e) {
-			return a(e);
+			return o(e);
 		}
 	}
-	async findPaging(e = {}, n = {}) {
+	async findPaging(e = {}, t = {}) {
 		try {
-			let r = t(e), i = this.getDynamicVirtuals(), a = { ...n };
-			n.populate && (a.populate = s(n.populate, i));
+			let r = n(e), i = this.getDynamicVirtuals(), a = { ...t };
+			t.populate && (a.populate = c(t.populate, i));
 			let o = await this.model.paginate(r, a);
 			if (i && i.length > 0) {
-				let e = await this.populateDynamicVirtualsForDocuments(o.docs, n.populate);
+				let e = await this.populateDynamicVirtualsForDocuments(o.docs, t.populate);
 				return {
 					success: !0,
 					result: {
@@ -90,13 +91,13 @@ var d = class {
 				}
 			};
 		} catch (e) {
-			return a(e);
+			return o(e);
 		}
 	}
 	async findPagingAggregate(e, t = {}) {
 		try {
 			let n = this.getDynamicVirtuals(), r = { ...t };
-			t.populate && (r.populate = s(t.populate, n));
+			t.populate && (r.populate = c(t.populate, n));
 			let i = await this.model.aggregatePaginate(this.model.aggregate(e), r), a = await this.populateDynamicVirtualsForDocuments(i.docs, t.populate);
 			return {
 				success: !0,
@@ -106,18 +107,18 @@ var d = class {
 				}
 			};
 		} catch (e) {
-			return a(e);
+			return o(e);
 		}
 	}
 	async count(e = {}) {
 		try {
-			let n = t(e);
+			let t = n(e);
 			return {
 				success: !0,
-				result: await this.model.countDocuments(n)
+				result: await this.model.countDocuments(t)
 			};
 		} catch (e) {
-			return a(e);
+			return o(e);
 		}
 	}
 	async createOne(e) {
@@ -128,7 +129,7 @@ var d = class {
 				result: t?.toObject?.() ?? t
 			};
 		} catch (e) {
-			return a(e);
+			return o(e);
 		}
 	}
 	async createMany(e, t = {}) {
@@ -138,12 +139,12 @@ var d = class {
 				result: (await this.model.insertMany(e, t)).map((e) => e?.toObject?.() ?? e)
 			};
 		} catch (e) {
-			return a(e);
+			return o(e);
 		}
 	}
-	async updateOne(n = {}, r = {}, i = {}) {
+	async updateOne(e = {}, r = {}, i = {}) {
 		try {
-			let a = t(n), o = await this.model.findOneAndUpdate(a, r, {
+			let a = n(e), o = await this.model.findOneAndUpdate(a, r, {
 				new: !0,
 				...i
 			}).exec();
@@ -153,66 +154,66 @@ var d = class {
 			} : {
 				success: !1,
 				message: `Failed to update ${this.getModelName()}.`,
-				code: e.NOT_FOUND.CODE
+				code: t.NOT_FOUND.CODE
 			};
 		} catch (e) {
-			return a(e);
+			return o(e);
 		}
 	}
-	async updateMany(e = {}, n = {}, r = {}) {
+	async updateMany(e = {}, t = {}, r = {}) {
 		try {
-			let i = t(e);
+			let i = n(e);
 			return {
 				success: !0,
-				result: await this.model.updateMany(i, n, r).exec()
+				result: await this.model.updateMany(i, t, r).exec()
 			};
 		} catch (e) {
-			return a(e);
+			return o(e);
 		}
 	}
-	async deleteOne(n = {}, r = {}) {
+	async deleteOne(e = {}, r = {}) {
 		try {
-			let i = t(n), a = await this.model.findOneAndDelete(i, r).exec();
+			let i = n(e), a = await this.model.findOneAndDelete(i, r).exec();
 			return a ? {
 				success: !0,
 				result: a?.toObject?.() ?? a
 			} : {
 				success: !1,
 				message: `No ${this.getModelName()} found to delete.`,
-				code: e.NOT_FOUND.CODE
+				code: t.NOT_FOUND.CODE
 			};
 		} catch (e) {
-			return a(e);
+			return o(e);
 		}
 	}
-	async deleteMany(n = {}, r = {}) {
+	async deleteMany(e = {}, r = {}) {
 		try {
-			let i = t(n), a = await this.model.deleteMany(i, r).exec();
+			let i = n(e), a = await this.model.deleteMany(i, r).exec();
 			return a.deletedCount === 0 ? {
 				success: !1,
 				message: "No documents found to delete.",
-				code: e.NOT_FOUND.CODE
+				code: t.NOT_FOUND.CODE
 			} : {
 				success: !0,
 				result: a
 			};
 		} catch (e) {
-			return a(e);
+			return o(e);
 		}
 	}
-	async createShortId(t, n = 4) {
+	async createShortId(e, n = 4) {
 		try {
-			let i = Array.from({ length: 10 }, (e, i) => r(t, i + n)), a = await this.model.find({ shortId: { $in: i } }).select("shortId").lean(), o = new Set(a.map((e) => e.shortId)), s = i.find((e) => !o.has(e));
+			let r = Array.from({ length: 10 }, (t, r) => i(e, r + n)), a = await this.model.find({ shortId: { $in: r } }).select("shortId").lean(), o = new Set(a.map((e) => e.shortId)), s = r.find((e) => !o.has(e));
 			return s ? {
 				success: !0,
 				result: s
 			} : {
 				success: !1,
 				message: "Failed to create a unique shortId",
-				code: e.INTERNAL_SERVER_ERROR.CODE
+				code: t.INTERNAL_SERVER_ERROR.CODE
 			};
 		} catch (e) {
-			return a(e);
+			return o(e);
 		}
 	}
 	createSlugQuery({ slug: e, field: t, isObject: n, haveHistory: r = !1, filter: i }) {
@@ -225,62 +226,62 @@ var d = class {
 			$or: [{ slug: e }, ...r ? [{ slugHistory: e }] : []]
 		};
 	}
-	async createUniqueSlug({ slug: e, field: t, isObject: r, haveHistory: a, filter: o }) {
+	async createUniqueSlug({ slug: e, field: t, isObject: n, haveHistory: i, filter: o }) {
 		if (!e || typeof e != "string") throw Error("Invalid slug provided: must be a non-empty string");
-		let s = i(e);
+		let s = a(e);
 		if (!await this.model.exists(this.createSlugQuery({
 			slug: s,
 			field: t,
-			isObject: r,
-			haveHistory: a,
+			isObject: n,
+			haveHistory: i,
 			filter: o
 		}))) return s;
 		let c = Array.from({ length: 100 }, (e, t) => `${s}-${t + 1}`), l = c.map((e) => this.createSlugQuery({
 			slug: e,
 			field: t,
-			isObject: r,
-			haveHistory: a,
+			isObject: n,
+			haveHistory: i,
 			filter: o
-		})), u = r ? `slug.${t}` : "slug", d = await this.model.find({ $or: l.map((e) => e.$or).flat() }).select(u).lean(), f = new Set(d.map((e) => r ? e.slug?.[t] : e.slug));
-		return c.find((e) => !f.has(e)) || `${s}-${Date.now()}-${n(6)}`;
+		})), u = n ? `slug.${t}` : "slug", d = await this.model.find({ $or: l.map((e) => e.$or).flat() }).select(u).lean(), f = new Set(d.map((e) => n ? e.slug?.[t] : e.slug));
+		return c.find((e) => !f.has(e)) || `${s}-${Date.now()}-${r(6)}`;
 	}
-	async createSlug({ field: e, from: t, filter: n, haveHistory: r }) {
+	async createSlug({ field: t, from: n, filter: r, haveHistory: i }) {
 		try {
-			let i = t[e];
-			return c(i) ? {
+			let a = n[t];
+			return e(a) ? {
 				success: !0,
-				result: Object.fromEntries(await Promise.all(Object.entries(i).map(async ([e, t]) => [e, await this.createUniqueSlug({
+				result: Object.fromEntries(await Promise.all(Object.entries(a).map(async ([e, t]) => [e, await this.createUniqueSlug({
 					slug: t,
 					field: e,
 					isObject: !0,
-					haveHistory: r,
-					filter: n
+					haveHistory: i,
+					filter: r
 				})])))
 			} : {
 				success: !0,
 				result: await this.createUniqueSlug({
-					slug: i,
-					field: e,
+					slug: a,
+					field: t,
 					isObject: !1,
-					haveHistory: r,
-					filter: n
+					haveHistory: i,
+					filter: r
 				})
 			};
 		} catch (e) {
-			return a(e);
+			return o(e);
 		}
 	}
-	async checkSlug({ slug: e, field: t, from: n, filter: r, haveHistory: o }) {
+	async checkSlug({ slug: t, field: n, from: r, filter: i, haveHistory: s }) {
 		try {
-			let a = n[t];
-			if (c(a)) {
-				let e = Object.values(a).map((e) => i(e));
+			let o = r[n];
+			if (e(o)) {
+				let e = Object.values(o).map((e) => a(e));
 				return (await Promise.all(e.map((e) => this.model.exists(this.createSlugQuery({
 					slug: e,
-					field: t,
+					field: n,
 					isObject: !0,
-					haveHistory: o,
-					filter: r
+					haveHistory: s,
+					filter: i
 				}))))).some((e) => e) ? {
 					success: !0,
 					result: !0
@@ -289,18 +290,18 @@ var d = class {
 					result: !1
 				};
 			}
-			let s = i(e);
+			let c = a(t);
 			return {
 				success: !0,
 				result: await this.model.exists(this.createSlugQuery({
-					slug: s,
-					field: t,
+					slug: c,
+					field: n,
 					isObject: !1,
-					filter: r
+					filter: i
 				})) !== null
 			};
 		} catch (e) {
-			return a(e);
+			return o(e);
 		}
 	}
 	async aggregate(e) {
@@ -310,7 +311,7 @@ var d = class {
 				result: await this.model.aggregate(e)
 			};
 		} catch (e) {
-			return a(e);
+			return o(e);
 		}
 	}
 	async distinct(e, t = {}, n = {}) {
@@ -320,7 +321,7 @@ var d = class {
 				result: await this.model.distinct(e, t, n)
 			};
 		} catch (e) {
-			return a(e);
+			return o(e);
 		}
 	}
 };