@cyberskill/shared 3.2.0 → 3.3.0

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

@@ -1 +1 @@
-{"version":3,"file":"express.util.js","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 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    return {\n        origin: (origin: string | undefined, callback: (err: Error | null, allow?: boolean) => void) => {\n            if (isDev || !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    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        },\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 */\nfunction setupMiddleware(app: Application, isDev = false, jsonLimit = '1mb') {\n    app.set('trust proxy', 1);\n    app.use(\n        helmet({\n            crossOriginEmbedderPolicy: isDev ? false : undefined,\n            contentSecurityPolicy: isDev ? false : undefined,\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 * @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);\n    setupStaticFolders(app, options?.static);\n    app.use(graphqlUploadExpress({\n        maxFileSize: options?.maxFileSize ?? 10_000_000,\n        maxFiles: options?.maxFiles ?? 10,\n    }));\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);\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"],"names":["createCorsOptions","isDev","whiteList","rest","origin","callback","createCors","options","cors","createSession","secureDefaults","process","session","setupMiddleware","app","jsonLimit","helmet","cookieParser","express","compression","useragent","setupStaticFolders","staticFolders","folder","createExpress","graphqlUploadExpress","createNest","NestFactory"],"mappings":";;;;;;;;;;;AA4BO,SAASA,EAAwC,EAAE,OAAAC,GAAO,WAAAC,GAAW,GAAGC,KAA0B;AACrG,SAAO;AAAA,IACH,QAAQ,CAACC,GAA4BC,MAA2D;AAC5F,MAAIJ,KAAS,CAACG,KAAUF,GAAW,SAASE,KAAU,EAAE,IACpDC,EAAS,MAAM,EAAI,IAGnBA,EAAS,IAAI,MAAM,qBAAqB,GAAG,EAAK;AAAA,IAExD;AAAA,IACA,aAAa;AAAA,IACb,GAAGF;AAAA,EAAA;AAEX;AAUO,SAASG,EAAiCC,GAA2B;AACxE,SAAOC,EAAuBR,EAAkBO,CAAO,CAAC;AAC5D;AAUO,SAASE,EAAcF,GAAyC;AACnE,QAAMG,IAA0C;AAAA,IAC5C,QAAQ;AAAA,IACR,mBAAmB;AAAA,IACnB,QAAQ;AAAA,MACJ,UAAU;AAAA,MACV,UAAU;AAAA,MACV,QAAQC,EAAQ,IAAI,aAAgB;AAAA,IAAA;AAAA,EACxC;AAGJ,SAAOC,EAAQ;AAAA,IACX,GAAGF;AAAA,IACH,GAAGH;AAAA,IACH,QAAQ,EAAE,GAAGG,EAAe,QAAQ,GAAGH,EAAQ,OAAA;AAAA,EAAO,CACzD;AACL;AAaA,SAASM,EAAgBC,GAAkBb,IAAQ,IAAOc,IAAY,OAAO;AACzE,EAAAD,EAAI,IAAI,eAAe,CAAC,GACxBA,EAAI;AAAA,IACAE,EAAO;AAAA,MACH,2BAA2Bf,IAAQ,KAAQ;AAAA,MAC3C,uBAAuBA,IAAQ,KAAQ;AAAA,IAAA,CAC1C;AAAA,EAAA,GAELa,EAAI,IAAIG,GAAc,GACtBH,EAAI,IAAII,EAAQ,KAAK,EAAE,OAAOH,EAAA,CAAW,CAAC,GAC1CD,EAAI,IAAII,EAAQ,WAAW,EAAE,UAAU,IAAM,OAAOH,EAAA,CAAW,CAAC,GAChED,EAAI,IAAIK,GAAa,GACrBL,EAAI,IAAIM,GAAW;AACvB;AAUA,SAASC,EAAmBP,GAAkBQ,GAAmC;AAC7E,EAAIA,MACgB,MAAM,QAAQA,CAAa,IAAIA,IAAgB,CAACA,CAAa,GACrE,QAAQ,CAACC,MAAW;AACxB,IAAAT,EAAI,IAAI,IAAIS,CAAM,IAAIL,EAAQ,OAAOK,CAAM,CAAC;AAAA,EAChD,CAAC;AAET;AAYO,SAASC,EAAcjB,GAAyC;AACnE,QAAMO,IAAMI,EAAA;AAEZ,SAAAL,EAAgBC,GAAKP,GAAS,OAAOA,GAAS,SAAS,GACvDc,EAAmBP,GAAKP,GAAS,MAAM,GACvCO,EAAI,IAAIW,EAAqB;AAAA,IACzB,aAAalB,GAAS,eAAe;AAAA,IACrC,UAAUA,GAAS,YAAY;AAAA,EAAA,CAClC,CAAC,GAEKO;AACX;AAaA,eAAsBY,EAAWnB,GAAmD;AAChF,QAAMO,IAAM,MAAMa,EAAY,OAAOpB,EAAQ,MAAM;AAEnD,SAAAM,EAAgBC,EAAI,iBAAiB,YAAA,GAAeP,EAAQ,OAAOA,EAAQ,SAAS,GACpFc,EAAmBP,EAAI,eAAA,EAAiB,YAAA,GAAeP,EAAQ,MAAM,GAEjEA,EAAQ,WACRO,EAAI,iBAAiB,GAAGP,EAAQ,OAAO,GAGvCA,EAAQ,SACRO,EAAI,eAAe,GAAGP,EAAQ,KAAK,GAGhCO;AACX;"}
+{"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    return {\n        origin: (origin: string | undefined, callback: (err: Error | null, allow?: boolean) => void) => {\n            if (isDev || !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    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        },\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    app.use(\n        helmet({\n            crossOriginEmbedderPolicy: isDev ? false : undefined,\n            contentSecurityPolicy: isDev ? false : undefined,\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 * @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    app.use(graphqlUploadExpress({\n        maxFileSize: options?.maxFileSize ?? 10_000_000,\n        maxFiles: options?.maxFiles ?? 10,\n    }));\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":";;;;;;;;;;;;;AA6BA,SAAgB,EAAwC,EAAE,UAAO,cAAW,GAAG,KAA0B;AACrG,QAAO;EACH,SAAS,GAA4B,MAA2D;AAC5F,GAAI,KAAS,CAAC,KAAU,GAAW,SAAS,KAAU,GAAG,GACrD,EAAS,MAAM,GAAK,GAGpB,EAAS,gBAAI,MAAM,sBAAsB,EAAE,GAAM;;EAGzD,aAAa;EACb,GAAG;EACN;;AAWL,SAAgB,EAAiC,GAA2B;AACxE,QAAO,EAAuB,EAAkB,EAAQ,CAAC;;AAW7D,SAAgB,EAAc,GAAyC;AACnE,KAAI,CAAC,EAAQ,OACT,OAAU,MAAM,8DAA8D;CAGlF,IAAM,IAA0C;EAC5C,QAAQ;EACR,mBAAmB;EACnB,QAAQ;GACJ,UAAU;GACV,UAAU;GACV,QAAQ,EAAQ,IAAI,aAAgB;GACvC;EACJ;AAED,QAAO,EAAQ;EACX,GAAG;EACH,GAAG;EACH,QAAQ;GAAE,GAAG,EAAe;GAAQ,GAAG,EAAQ;GAAQ;EAC1D,CAAC;;AAkBN,SAAS,EACL,GACA,IAAQ,IACR,IAAY,OACZ,IAAmD,IACnD,IAA2E,EAAE,EAC/E;AA0BE,CAzBI,MAAe,MACf,EAAI,IAAI,eAAe,EAAW,EAEtC,EAAI,IACA,EAAO;EACH,2BAA2B,IAAQ,KAAQ,KAAA;EAC3C,uBAAuB,IAAQ,KAAQ,KAAA;EAC1C,CAAC,CACL,EACG,MAAqB,MACrB,EAAI,IACA,EAAU;EACN,UAAU,EAAiB,YAAY,MAAU;EACjD,OAAO,EAAiB,SAAS;EACjC,iBAAiB;EACjB,eAAe;EACf,GAAI,EAAiB,UAAU,KAAA,KAAa,EAAE,OAAO,EAAiB,OAAO;EAC7E,GAAI,EAAiB,SAAS,KAAA,KAAa,EAAE,MAAM,EAAiB,MAAM;EAC7E,CAAC,CACL,EAEL,EAAI,IAAI,GAAc,CAAC,EACvB,EAAI,IAAI,EAAQ,KAAK,EAAE,OAAO,GAAW,CAAC,CAAC,EAC3C,EAAI,IAAI,EAAQ,WAAW;EAAE,UAAU;EAAM,OAAO;EAAW,CAAC,CAAC,EACjE,EAAI,IAAI,GAAa,CAAC,EACtB,EAAI,IAAI,GAAW,CAAC;;AAWxB,SAAS,EAAmB,GAAkB,GAAmC;AAC7E,CAAI,MACgB,MAAM,QAAQ,EAAc,GAAG,IAAgB,CAAC,EAAc,EACtE,SAAS,MAAW;AACxB,IAAI,IAAI,IAAI,KAAU,EAAQ,OAAO,EAAO,CAAC;GAC/C;;AAcV,SAAgB,EAAc,GAAyC;CACnE,IAAM,IAAM,GAAS;AASrB,QAPA,EAAgB,GAAK,GAAS,OAAO,GAAS,WAAW,GAAS,YAAY,GAAS,UAAU,EACjG,EAAmB,GAAK,GAAS,OAAO,EACxC,EAAI,IAAI,EAAqB;EACzB,aAAa,GAAS,eAAe;EACrC,UAAU,GAAS,YAAY;EAClC,CAAC,CAAC,EAEI;;AAcX,eAAsB,EAAW,GAAmD;CAChF,IAAM,IAAM,MAAM,EAAY,OAAO,EAAQ,OAAO;AAapD,QAXA,EAAgB,EAAI,gBAAgB,CAAC,aAAa,EAAE,EAAQ,OAAO,EAAQ,WAAW,EAAQ,YAAY,EAAQ,UAAU,EAC5H,EAAmB,EAAI,gBAAgB,CAAC,aAAa,EAAE,EAAQ,OAAO,EAElE,EAAQ,WACR,EAAI,iBAAiB,GAAG,EAAQ,QAAQ,EAGxC,EAAQ,SACR,EAAI,eAAe,GAAG,EAAQ,MAAM,EAGjC"}

package/dist/node/express/index.js

@@ -1,14 +1,3 @@
-import { createCors as s, createCorsOptions as t, createExpress as o, createNest as a, createSession as p } from "./express.util.js";
-import { Router as f, default as x } from "express";
-import { default as m } from "body-parser";
-export {
-  f as Router,
-  m as bodyParser,
-  s as createCors,
-  t as createCorsOptions,
-  o as createExpress,
-  a as createNest,
-  p as createSession,
-  x as express
-};
-//# sourceMappingURL=index.js.map
+import { Router as e } from "./express.type.js";
+import { bodyParser as t, createCors as n, createCorsOptions as r, createExpress as i, createNest as a, createSession as o, express as s } from "./express.util.js";
+export { e as Router, t as bodyParser, n as createCors, r as createCorsOptions, i as createExpress, a as createNest, o as createSession, s as express };

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

@@ -1,57 +1,33 @@
-import c from "fs-extra";
-import y from "node:path";
-const l = c, {
-  lstatSync: m,
-  readdirSync: x,
-  mkdirSync: E,
-  readFileSync: f,
-  unlinkSync: F,
-  statSync: S,
-  createWriteStream: v
-} = c, g = c.readJsonSync;
-function u(n, t, e) {
-  c.writeFileSync(n, t, e ?? "utf-8");
+import e from "fs-extra";
+import t from "node:path";
+//#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");
 }
-function p(n, t, e) {
-  c.appendFileSync(n, t, e ?? "utf-8");
+function f(t, n, r) {
+	e.appendFileSync(t, n, r ?? "utf-8");
 }
-function o(...n) {
-  return n.every((t) => c.pathExistsSync(t));
+function p(...t) {
+	return t.every((t) => e.pathExistsSync(t));
 }
-function k(...n) {
-  n.forEach((t) => {
-    o(t) && c.removeSync(t);
-  });
+function m(...t) {
+	t.forEach((t) => {
+		p(t) && e.removeSync(t);
+	});
 }
-function w(n, t, e = {}) {
-  const { extensions: i, ...s } = e;
-  c.copySync(n, t, {
-    filter: (r) => S(r).isDirectory() || !i || i.length === 0 ? !0 : i.includes(y.extname(r)),
-    ...s
-  });
+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)),
+		...o
+	});
 }
-function J(n, t) {
-  const e = `
-${t}
-`;
-  o(n) ? f(n, "utf-8").split(`
-`).includes(t) || p(n, e) : u(n, e);
+function g(e, t) {
+	let n = `\n${t}\n`;
+	p(e) ? o(e, "utf-8").split("\n").includes(t) || f(e, n) : d(e, n);
 }
-export {
-  J as addGitIgnoreEntry,
-  p as appendFileSync,
-  w as copySync,
-  v as createWriteStream,
-  l as fs,
-  m as lstatSync,
-  E as mkdirSync,
-  o as pathExistsSync,
-  f as readFileSync,
-  g as readJsonSync,
-  x as readdirSync,
-  k as removeSync,
-  S as statSync,
-  F as unlinkSync,
-  u as writeFileSync
-};
-//# sourceMappingURL=fs.util.js.map
+//#endregion
+export { g as addGitIgnoreEntry, f as appendFileSync, h as copySync, l as createWriteStream, n as fs, r as lstatSync, a as mkdirSync, p as pathExistsSync, o as readFileSync, u as readJsonSync, i as readdirSync, m as removeSync, c as statSync, s as unlinkSync, d as writeFileSync };
+
+//# sourceMappingURL=fs.util.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"fs.util.js","sources":["../../../src/node/fs/fs.util.ts"],"sourcesContent":["import fsExtra from 'fs-extra';\nimport path from 'node:path';\n\nimport type { I_CopySyncOptions } from './fs.type.js';\n\n/**\n * Re-export of the fs-extra module for file system operations.\n */\nexport const fs = fsExtra;\n\nexport const {\n    lstatSync,\n    readdirSync,\n    mkdirSync,\n    readFileSync,\n    unlinkSync,\n    statSync,\n    createWriteStream,\n} = fsExtra;\n\nexport const readJsonSync: typeof fsExtra.readJsonSync = fsExtra.readJsonSync;\n\n/**\n * Writes data to a file synchronously with UTF-8 encoding as default.\n * This function provides a simplified interface for writing files with automatic UTF-8 encoding\n * when no specific options are provided.\n *\n * @param file - The file path or file descriptor to write to.\n * @param data - The data to write to the file (string or Uint8Array).\n * @param options - Optional write file options (defaults to UTF-8 encoding).\n */\nexport function writeFileSync(file: fsExtra.PathOrFileDescriptor, data: string | Uint8Array, options?: fsExtra.WriteFileOptions): void {\n    fsExtra.writeFileSync(file, data, options ?? 'utf-8');\n}\n\n/**\n * Appends data to a file synchronously with UTF-8 encoding as default.\n * This function provides a simplified interface for appending to files with automatic UTF-8 encoding\n * when no specific options are provided.\n *\n * @param path - The file path or file descriptor to append to.\n * @param data - The data to append to the file (string or Uint8Array).\n * @param options - Optional write file options (defaults to UTF-8 encoding).\n */\nexport function appendFileSync(path: fsExtra.PathOrFileDescriptor, data: string | Uint8Array, options?: fsExtra.WriteFileOptions): void {\n    fsExtra.appendFileSync(path, data, options ?? 'utf-8');\n}\n\n/**\n * Checks if all specified paths exist synchronously.\n * This function verifies that every path in the provided array exists in the file system.\n * Returns true only if all paths exist, false if any path is missing.\n *\n * @param paths - An array of file or directory paths to check for existence.\n * @returns True if all paths exist, false if any path is missing.\n */\nexport function pathExistsSync(...paths: string[]) {\n    return paths.every(path => fsExtra.pathExistsSync(path));\n}\n\n/**\n * Removes files or directories synchronously if they exist.\n * This function safely removes multiple files or directories by checking for existence\n * before attempting removal, preventing errors for non-existent paths.\n *\n * @param paths - An array of file or directory paths to remove.\n */\nexport function removeSync(...paths: string[]) {\n    paths.forEach((filePath) => {\n        if (pathExistsSync(filePath)) {\n            fsExtra.removeSync(filePath);\n        }\n    });\n}\n\n/**\n * Copies files and directories synchronously with optional filtering.\n * This function copies files from source to destination with support for:\n * - Extension-based filtering (only copy files with specified extensions)\n * - Directory preservation (always copy directories regardless of extension filter)\n * - Additional copy options from fs-extra\n *\n * @param src - The source path to copy from.\n * @param dest - The destination path to copy to.\n * @param options - Optional copy configuration including extensions filter and other fs-extra options.\n */\nexport function copySync(src: string, dest: string, options: I_CopySyncOptions = {}): void {\n    const { extensions, ...rest } = options;\n\n    fsExtra.copySync(src, dest, {\n        filter: (srcPath: string) => {\n            if (statSync(srcPath).isDirectory()) {\n                return true;\n            }\n\n            if (!extensions || extensions.length === 0) {\n                return true;\n            }\n\n            return extensions.includes(path.extname(srcPath));\n        },\n        ...rest,\n    });\n}\n\n/**\n * Adds an entry to the .gitignore file if it doesn't already exist.\n * Creates the .gitignore file if it doesn't exist.\n *\n * @param gitIgnorePath - The absolute path to the .gitignore file.\n * @param entry - The entry name to add (e.g. '.agent', '.simple-git-hooks.json').\n */\nexport function addGitIgnoreEntry(gitIgnorePath: string, entry: string): void {\n    const gitIgnoreContent = `\\n${entry}\\n`;\n\n    if (pathExistsSync(gitIgnorePath)) {\n        const gitignore = readFileSync(gitIgnorePath, 'utf-8').split('\\n');\n\n        if (!gitignore.includes(entry)) {\n            appendFileSync(gitIgnorePath, gitIgnoreContent);\n        }\n    }\n    else {\n        writeFileSync(gitIgnorePath, gitIgnoreContent);\n    }\n}\n"],"names":["fsExtra","path","fs","lstatSync","readdirSync","mkdirSync","readFileSync","unlinkSync","statSync","createWriteStream","readJsonSync","writeFileSync","file","data","options","appendFileSync","pathExistsSync","paths","removeSync","filePath","copySync","src","dest","extensions","rest","srcPath","addGitIgnoreEntry","gitIgnorePath","entry","gitIgnoreContent"],"mappings":"AAQO,OAAAA,OAAA;AAAA,OAAAC,OAAA;AAAA,MAAMC,IAAKF,GAEL;AAAA,EACT,WAAAG;AAAA,EACA,aAAAC;AAAA,EACA,WAAAC;AAAA,EACA,cAAAC;AAAA,EACA,YAAAC;AAAA,EACA,UAAAC;AAAA,EACA,mBAAAC;AACJ,IAAIT,GAESU,IAA4CV,EAAQ;AAW1D,SAASW,EAAcC,GAAoCC,GAA2BC,GAA0C;AACnI,EAAAd,EAAQ,cAAcY,GAAMC,GAAMC,KAAW,OAAO;AACxD;AAWO,SAASC,EAAed,GAAoCY,GAA2BC,GAA0C;AACpI,EAAAd,EAAQ,eAAeC,GAAMY,GAAMC,KAAW,OAAO;AACzD;AAUO,SAASE,KAAkBC,GAAiB;AAC/C,SAAOA,EAAM,MAAM,CAAAhB,MAAQD,EAAQ,eAAeC,CAAI,CAAC;AAC3D;AASO,SAASiB,KAAcD,GAAiB;AAC3C,EAAAA,EAAM,QAAQ,CAACE,MAAa;AACxB,IAAIH,EAAeG,CAAQ,KACvBnB,EAAQ,WAAWmB,CAAQ;AAAA,EAEnC,CAAC;AACL;AAaO,SAASC,EAASC,GAAaC,GAAcR,IAA6B,CAAA,GAAU;AACvF,QAAM,EAAE,YAAAS,GAAY,GAAGC,EAAA,IAASV;AAEhC,EAAAd,EAAQ,SAASqB,GAAKC,GAAM;AAAA,IACxB,QAAQ,CAACG,MACDjB,EAASiB,CAAO,EAAE,iBAIlB,CAACF,KAAcA,EAAW,WAAW,IAC9B,KAGJA,EAAW,SAAStB,EAAK,QAAQwB,CAAO,CAAC;AAAA,IAEpD,GAAGD;AAAA,EAAA,CACN;AACL;AASO,SAASE,EAAkBC,GAAuBC,GAAqB;AAC1E,QAAMC,IAAmB;AAAA,EAAKD,CAAK;AAAA;AAEnC,EAAIZ,EAAeW,CAAa,IACVrB,EAAaqB,GAAe,OAAO,EAAE,MAAM;AAAA,CAAI,EAElD,SAASC,CAAK,KACzBb,EAAeY,GAAeE,CAAgB,IAIlDlB,EAAcgB,GAAeE,CAAgB;AAErD;"}
+{"version":3,"file":"fs.util.js","names":[],"sources":["../../../src/node/fs/fs.util.ts"],"sourcesContent":["import fsExtra from 'fs-extra';\nimport path from 'node:path';\n\nimport type { I_CopySyncOptions } from './fs.type.js';\n\n/**\n * Re-export of the fs-extra module for file system operations.\n */\nexport const fs = fsExtra;\n\nexport const {\n    lstatSync,\n    readdirSync,\n    mkdirSync,\n    readFileSync,\n    unlinkSync,\n    statSync,\n    createWriteStream,\n} = fsExtra;\n\nexport const readJsonSync: typeof fsExtra.readJsonSync = fsExtra.readJsonSync;\n\n/**\n * Writes data to a file synchronously with UTF-8 encoding as default.\n * This function provides a simplified interface for writing files with automatic UTF-8 encoding\n * when no specific options are provided.\n *\n * @param file - The file path or file descriptor to write to.\n * @param data - The data to write to the file (string or Uint8Array).\n * @param options - Optional write file options (defaults to UTF-8 encoding).\n */\nexport function writeFileSync(file: fsExtra.PathOrFileDescriptor, data: string | Uint8Array, options?: fsExtra.WriteFileOptions): void {\n    fsExtra.writeFileSync(file, data, options ?? 'utf-8');\n}\n\n/**\n * Appends data to a file synchronously with UTF-8 encoding as default.\n * This function provides a simplified interface for appending to files with automatic UTF-8 encoding\n * when no specific options are provided.\n *\n * @param path - The file path or file descriptor to append to.\n * @param data - The data to append to the file (string or Uint8Array).\n * @param options - Optional write file options (defaults to UTF-8 encoding).\n */\nexport function appendFileSync(path: fsExtra.PathOrFileDescriptor, data: string | Uint8Array, options?: fsExtra.WriteFileOptions): void {\n    fsExtra.appendFileSync(path, data, options ?? 'utf-8');\n}\n\n/**\n * Checks if all specified paths exist synchronously.\n * This function verifies that every path in the provided array exists in the file system.\n * Returns true only if all paths exist, false if any path is missing.\n *\n * @param paths - An array of file or directory paths to check for existence.\n * @returns True if all paths exist, false if any path is missing.\n */\nexport function pathExistsSync(...paths: string[]) {\n    return paths.every(path => fsExtra.pathExistsSync(path));\n}\n\n/**\n * Removes files or directories synchronously if they exist.\n * This function safely removes multiple files or directories by checking for existence\n * before attempting removal, preventing errors for non-existent paths.\n *\n * @param paths - An array of file or directory paths to remove.\n */\nexport function removeSync(...paths: string[]) {\n    paths.forEach((filePath) => {\n        if (pathExistsSync(filePath)) {\n            fsExtra.removeSync(filePath);\n        }\n    });\n}\n\n/**\n * Copies files and directories synchronously with optional filtering.\n * This function copies files from source to destination with support for:\n * - Extension-based filtering (only copy files with specified extensions)\n * - Directory preservation (always copy directories regardless of extension filter)\n * - Additional copy options from fs-extra\n *\n * @param src - The source path to copy from.\n * @param dest - The destination path to copy to.\n * @param options - Optional copy configuration including extensions filter and other fs-extra options.\n */\nexport function copySync(src: string, dest: string, options: I_CopySyncOptions = {}): void {\n    const { extensions, ...rest } = options;\n\n    fsExtra.copySync(src, dest, {\n        filter: (srcPath: string) => {\n            if (statSync(srcPath).isDirectory()) {\n                return true;\n            }\n\n            if (!extensions || extensions.length === 0) {\n                return true;\n            }\n\n            return extensions.includes(path.extname(srcPath));\n        },\n        ...rest,\n    });\n}\n\n/**\n * Adds an entry to the .gitignore file if it doesn't already exist.\n * Creates the .gitignore file if it doesn't exist.\n *\n * @param gitIgnorePath - The absolute path to the .gitignore file.\n * @param entry - The entry name to add (e.g. '.agent', '.simple-git-hooks.json').\n */\nexport function addGitIgnoreEntry(gitIgnorePath: string, entry: string): void {\n    const gitIgnoreContent = `\\n${entry}\\n`;\n\n    if (pathExistsSync(gitIgnorePath)) {\n        const gitignore = readFileSync(gitIgnorePath, 'utf-8').split('\\n');\n\n        if (!gitignore.includes(entry)) {\n            appendFileSync(gitIgnorePath, gitIgnoreContent);\n        }\n    }\n    else {\n        writeFileSync(gitIgnorePath, gitIgnoreContent);\n    }\n}\n"],"mappings":";;;AAQA,IAAa,IAAK,GAEL,EACT,cACA,gBACA,cACA,iBACA,eACA,aACA,yBACA,GAES,IAA4C,EAAQ;AAWjE,SAAgB,EAAc,GAAoC,GAA2B,GAA0C;AACnI,GAAQ,cAAc,GAAM,GAAM,KAAW,QAAQ;;AAYzD,SAAgB,EAAe,GAAoC,GAA2B,GAA0C;AACpI,GAAQ,eAAe,GAAM,GAAM,KAAW,QAAQ;;AAW1D,SAAgB,EAAe,GAAG,GAAiB;AAC/C,QAAO,EAAM,OAAM,MAAQ,EAAQ,eAAe,EAAK,CAAC;;AAU5D,SAAgB,EAAW,GAAG,GAAiB;AAC3C,GAAM,SAAS,MAAa;AACxB,EAAI,EAAe,EAAS,IACxB,EAAQ,WAAW,EAAS;GAElC;;AAcN,SAAgB,EAAS,GAAa,GAAc,IAA6B,EAAE,EAAQ;CACvF,IAAM,EAAE,eAAY,GAAG,MAAS;AAEhC,GAAQ,SAAS,GAAK,GAAM;EACxB,SAAS,MACD,EAAS,EAAQ,CAAC,aAAa,IAI/B,CAAC,KAAc,EAAW,WAAW,IAC9B,KAGJ,EAAW,SAAS,EAAK,QAAQ,EAAQ,CAAC;EAErD,GAAG;EACN,CAAC;;AAUN,SAAgB,EAAkB,GAAuB,GAAqB;CAC1E,IAAM,IAAmB,KAAK,EAAM;AAEpC,CAAI,EAAe,EAAc,GACX,EAAa,GAAe,QAAQ,CAAC,MAAM,KAAK,CAEnD,SAAS,EAAM,IAC1B,EAAe,GAAe,EAAiB,GAInD,EAAc,GAAe,EAAiB"}

package/dist/node/fs/index.js

@@ -1,19 +1,2 @@
-import { addGitIgnoreEntry as c, appendFileSync as r, copySync as y, createWriteStream as t, fs as S, lstatSync as a, mkdirSync as i, pathExistsSync as d, readFileSync as o, readJsonSync as s, readdirSync as l, removeSync as p, statSync as m, unlinkSync as F, writeFileSync as f } from "./fs.util.js";
-export {
-  c as addGitIgnoreEntry,
-  r as appendFileSync,
-  y as copySync,
-  t as createWriteStream,
-  S as fs,
-  a as lstatSync,
-  i as mkdirSync,
-  d as pathExistsSync,
-  o as readFileSync,
-  s as readJsonSync,
-  l as readdirSync,
-  p as removeSync,
-  m as statSync,
-  F as unlinkSync,
-  f as writeFileSync
-};
-//# sourceMappingURL=index.js.map
+import { addGitIgnoreEntry as e, appendFileSync as t, copySync as n, createWriteStream as r, fs as i, lstatSync as a, mkdirSync as o, pathExistsSync as s, readFileSync as c, readJsonSync as l, readdirSync as u, removeSync as d, statSync as f, unlinkSync as p, writeFileSync as m } from "./fs.util.js";
+export { e as addGitIgnoreEntry, t as appendFileSync, n as copySync, r as createWriteStream, i as fs, a as lstatSync, o as mkdirSync, s as pathExistsSync, c as readFileSync, l as readJsonSync, u as readdirSync, d as removeSync, f as statSync, p as unlinkSync, m as writeFileSync };

package/dist/node/log/index.js

@@ -1,9 +1,3 @@
 import { E_IssueType as e } from "./log.type.js";
-import { catchError as p, log as E, throwError as c } from "./log.util.js";
-export {
-  e as E_IssueType,
-  p as catchError,
-  E as log,
-  c as throwError
-};
-//# sourceMappingURL=index.js.map
+import { catchError as t, log as n, throwError as r } from "./log.util.js";
+export { e as E_IssueType, t as catchError, n as log, r as throwError };

package/dist/node/log/log.type.js

@@ -1,5 +1,8 @@
-var n = /* @__PURE__ */ ((r) => (r.Error = "error", r.Warning = "warning", r))(n || {});
-export {
-  n as E_IssueType
-};
-//# sourceMappingURL=log.type.js.map
+//#region src/node/log/log.type.ts
+var e = /* @__PURE__ */ function(e) {
+	return e.Error = "error", e.Warning = "warning", e;
+}({});
+//#endregion
+export { e as E_IssueType };
+
+//# sourceMappingURL=log.type.js.map

package/dist/node/log/log.type.js.map

@@ -1 +1 @@
-{"version":3,"file":"log.type.js","sources":["../../../src/node/log/log.type.ts"],"sourcesContent":["import type { I_Log as I_LogCommon } from '#typescript/index.js';\n\n/**\n * Enum representing the type of issues for logging and error handling.\n * - Error: Represents an error issue.\n * - Warning: Represents a warning issue.\n */\nexport enum E_IssueType {\n    Error = 'error',\n    Warning = 'warning',\n}\n\nexport interface I_IssueEntry {\n    type: E_IssueType;\n    file: string;\n    message: string;\n    position?: string;\n    rule?: string;\n}\n\nexport interface I_ThrowError {\n    message?: string;\n    status?: {\n        CODE: string | number;\n        MESSAGE: string;\n    };\n    type?: 'graphql' | 'rest';\n}\n\nexport interface I_Log extends I_LogCommon {\n    printBoxedLog: (\n        title: string,\n        issues: I_IssueEntry[],\n        color?: string,\n    ) => void;\n}\n\nexport interface I_CatchErrorOptions {\n    shouldLog?: boolean;\n    returnValue?: unknown;\n    callback?: (error: Error) => void;\n}\n"],"names":["E_IssueType"],"mappings":"AAOO,IAAKA,sBAAAA,OACRA,EAAA,QAAQ,SACRA,EAAA,UAAU,WAFFA,IAAAA,KAAA,CAAA,CAAA;"}
+{"version":3,"file":"log.type.js","names":[],"sources":["../../../src/node/log/log.type.ts"],"sourcesContent":["import type { I_Log as I_LogCommon } from '#typescript/index.js';\n\n/**\n * Enum representing the type of issues for logging and error handling.\n * - Error: Represents an error issue.\n * - Warning: Represents a warning issue.\n */\nexport enum E_IssueType {\n    Error = 'error',\n    Warning = 'warning',\n}\n\nexport interface I_IssueEntry {\n    type: E_IssueType;\n    file: string;\n    message: string;\n    position?: string;\n    rule?: string;\n}\n\nexport interface I_ThrowError {\n    message?: string;\n    status?: {\n        CODE: string | number;\n        MESSAGE: string;\n    };\n    type?: 'graphql' | 'rest';\n}\n\nexport interface I_Log extends I_LogCommon {\n    printBoxedLog: (\n        title: string,\n        issues: I_IssueEntry[],\n        color?: string,\n    ) => void;\n}\n\nexport interface I_CatchErrorOptions {\n    shouldLog?: boolean;\n    returnValue?: unknown;\n    callback?: (error: Error) => void;\n}\n"],"mappings":";AAOA,IAAY,IAAL,yBAAA,GAAA;QACH,EAAA,QAAA,SACA,EAAA,UAAA;KACH"}

package/dist/node/log/log.util.js

@@ -1,73 +1,56 @@
-import l from "chalk";
-import r from "consola";
-import { GraphQLError as h } from "graphql";
-import { getEnv as u } from "../../config/env/env.util.js";
-import { RESPONSE_STATUS as f } from "../../constant/response-status.js";
-const R = u();
-function S({
-  message: e,
-  status: o = f.INTERNAL_SERVER_ERROR,
-  type: n = "graphql"
-}) {
-  const t = e ?? o.MESSAGE ?? "Internal server error";
-  throw n === "graphql" ? new h(t, {
-    extensions: { code: o.CODE }
-  }) : new Error(t);
+import { RESPONSE_STATUS as e } from "../../constant/response-status.js";
+import { getEnv as t } from "../../config/env/env.util.js";
+import { GraphQLError as n } from "graphql";
+import r from "chalk";
+import i from "consola";
+//#region src/node/log/log.util.ts
+var a = !1;
+function o() {
+	a || (a = !0, t().DEBUG || (i.level = 4));
+}
+function s({ message: t, status: r = e.INTERNAL_SERVER_ERROR, type: i = "graphql" }) {
+	let a = t ?? r.MESSAGE ?? "Internal server error";
+	throw i === "graphql" ? new n(a, { extensions: { code: r.CODE } }) : Error(a);
 }
-R.DEBUG || (r.level = 4);
 function c(e) {
-  const o = l[e];
-  return typeof o == "function" ? o : l.green;
+	let t = r[e];
+	return typeof t == "function" ? t : r.green;
 }
-const m = {
-  silent: r.silent,
-  level: r.level,
-  fatal: r.fatal,
-  error: r.error,
-  warn: r.warn,
-  log: r.log,
-  info: r.info,
-  success: r.success,
-  ready: r.ready,
-  start: r.start,
-  box: r.box,
-  debug: r.debug,
-  trace: r.trace,
-  verbose: r.verbose,
-  /**
-   * Prints a boxed log with structured issue information.
-   * This method displays issues (errors or warnings) in a formatted box with:
-   * - File paths and line/column positions
-   * - Rule violations (if applicable)
-   * - Error/warning messages
-   * - Color-coded output based on issue type
-   *
-   * @param title - The title to display in the box header.
-   * @param issues - An array of issue entries to display.
-   * @param color - The color to use for highlighting (defaults to 'red').
-   */
-  printBoxedLog(e, o, n = "red") {
-    if (!o?.length) {
-      r.box(l.green(e));
-      return;
-    }
-    o.forEach(({ file: t, position: s, rule: a, message: g }) => {
-      const i = s ? `:${s}` : "", E = `${t}${i}`;
-      r.log(`${l.gray("File:")} ${l.blue(E)}`), a && r.log(`   ${c(n)("Rule:")} ${a}`), r.log(`   ${c(n)("Message:")} ${g}`);
-    }), r.box(c(n)(`${e} : ${o.length}`)), r.log(l.gray("─".repeat(40)));
-  }
+var l = {
+	silent: i.silent,
+	level: i.level,
+	fatal: i.fatal,
+	error: i.error,
+	warn: i.warn,
+	log: i.log,
+	info: i.info,
+	success: i.success,
+	ready: i.ready,
+	start: i.start,
+	box: i.box,
+	debug: i.debug,
+	trace: i.trace,
+	verbose: i.verbose,
+	printBoxedLog(e, t, n = "red") {
+		if (!t?.length) {
+			i.box(r.green(e));
+			return;
+		}
+		t.forEach(({ file: e, position: t, rule: a, message: o }) => {
+			let s = `${e}${t ? `:${t}` : ""}`;
+			i.log(`${r.gray("File:")} ${r.blue(s)}`), a && i.log(`   ${c(n)("Rule:")} ${a}`), i.log(`   ${c(n)("Message:")} ${o}`);
+		}), i.box(c(n)(`${e} : ${t.length}`)), i.log(r.gray("─".repeat(40)));
+	}
 };
-function v(e, o) {
-  const { shouldLog: n = !0, returnValue: t, callback: s } = o ?? {}, a = e instanceof Error ? e : new Error(typeof e == "string" ? e : "Unknown error");
-  return n && m.error(a.message), s && typeof s == "function" && s(a), t || {
-    success: !1,
-    message: a.message,
-    code: f.INTERNAL_SERVER_ERROR.CODE
-  };
+function u(t, n) {
+	let { shouldLog: r = !0, returnValue: i, callback: a } = n ?? {}, s = t instanceof Error ? t : Error(typeof t == "string" ? t : "Unknown error");
+	return r && (o(), l.error(s.message)), a && typeof a == "function" && a(s), i === void 0 ? {
+		success: !1,
+		message: s.message,
+		code: e.INTERNAL_SERVER_ERROR.CODE
+	} : i;
 }
-export {
-  v as catchError,
-  m as log,
-  S as throwError
-};
-//# sourceMappingURL=log.util.js.map
+//#endregion
+export { u as catchError, l as log, s as throwError };
+
+//# sourceMappingURL=log.util.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"log.util.js","sources":["../../../src/node/log/log.util.ts"],"sourcesContent":["import type { ChalkInstance } from 'chalk';\n\nimport chalk from 'chalk';\nimport consola from 'consola';\nimport { GraphQLError } from 'graphql';\n\nimport type { I_Return } from '#typescript/index.js';\n\nimport { getEnv } from '#config/env/index.js';\nimport { RESPONSE_STATUS } from '#constant/index.js';\n\nimport type { I_CatchErrorOptions, I_IssueEntry, I_Log, I_ThrowError } from './log.type.js';\n\nconst env = getEnv();\n\n/**\n * Throws a standardized error with optional status information and type specification.\n * This function creates and throws errors that can be either GraphQL errors (with extensions)\n * or standard JavaScript errors, depending on the specified type.\n *\n * @param options - Error configuration including message, status information, and error type.\n * @param options.message - The error message to display.\n * @param options.status - The response status information (defaults to INTERNAL_SERVER_ERROR).\n * @param options.type - The type of error to throw ('graphql' or 'rest', defaults to 'graphql').\n * @throws {GraphQLError} When type is 'graphql', throws a GraphQL error with extensions.\n * @throws {Error} When type is 'rest' or unspecified, throws a standard JavaScript error.\n */\nexport function throwError({\n    message,\n    status = RESPONSE_STATUS.INTERNAL_SERVER_ERROR,\n    type = 'graphql',\n}: I_ThrowError): never {\n    const responseMessage\n        = message ?? status.MESSAGE ?? 'Internal server error';\n\n    if (type === 'graphql') {\n        throw new GraphQLError(responseMessage, {\n            extensions: { code: status.CODE },\n        });\n    }\n\n    else {\n        throw new Error(responseMessage);\n    }\n}\n\nif (!env.DEBUG) {\n    consola.level = 4;\n}\n\n/**\n * Gets a chalk color instance by keyword name.\n * This function safely retrieves a chalk color function by name, falling back to green\n * if the specified color is not available or invalid.\n *\n * @param color - The color keyword to get the chalk instance for.\n * @returns A chalk instance for the specified color, or green as fallback.\n */\nfunction chalkKeyword(color: string): ChalkInstance {\n    const chalkColor = chalk[color as keyof typeof chalk];\n\n    return typeof chalkColor === 'function' ? (chalkColor as ChalkInstance) : chalk.green;\n}\n\n/**\n * Enhanced logging interface that extends consola with custom functionality.\n * This object provides all standard consola logging methods plus additional features\n * like boxed log printing for structured error/warning display.\n */\nexport const log: I_Log = {\n    silent: consola.silent,\n    level: consola.level,\n    fatal: consola.fatal,\n    error: consola.error,\n    warn: consola.warn,\n    log: consola.log,\n    info: consola.info,\n    success: consola.success,\n    ready: consola.ready,\n    start: consola.start,\n    box: consola.box,\n    debug: consola.debug,\n    trace: consola.trace,\n    verbose: consola.verbose,\n    /**\n     * Prints a boxed log with structured issue information.\n     * This method displays issues (errors or warnings) in a formatted box with:\n     * - File paths and line/column positions\n     * - Rule violations (if applicable)\n     * - Error/warning messages\n     * - Color-coded output based on issue type\n     *\n     * @param title - The title to display in the box header.\n     * @param issues - An array of issue entries to display.\n     * @param color - The color to use for highlighting (defaults to 'red').\n     */\n    printBoxedLog(title: string, issues: I_IssueEntry[], color = 'red') {\n        if (!issues?.length) {\n            consola.box(chalk.green(title));\n            return;\n        }\n\n        issues.forEach(({ file, position, rule, message }) => {\n            const positionSuffix = position ? `:${position}` : '';\n            const filePath = `${file}${positionSuffix}`;\n            consola.log(`${chalk.gray('File:')} ${chalk.blue(filePath)}`);\n\n            if (rule) {\n                consola.log(`   ${chalkKeyword(color)('Rule:')} ${rule}`);\n            }\n\n            consola.log(`   ${chalkKeyword(color)('Message:')} ${message}`);\n        });\n\n        consola.box(chalkKeyword(color)(`${title} : ${issues.length}`));\n\n        consola.log(chalk.gray('─'.repeat(40)));\n    },\n};\n\n/**\n * Catches and handles errors with configurable behavior.\n * This function provides a standardized way to handle errors with options for:\n * - Logging control (whether to log the error)\n * - Return value specification (what to return on error)\n * - Custom callback execution (additional error handling)\n *\n * @param errorInput - The error to catch and handle.\n * @param options - Configuration options for error handling behavior.\n * @returns Either the specified return value or a standardized error response object.\n */\nexport function catchError<T = unknown>(errorInput: unknown, options: I_CatchErrorOptions & { returnValue: T }): T;\nexport function catchError<T = unknown>(errorInput: unknown, options?: I_CatchErrorOptions): I_Return<T>;\nexport function catchError<T = unknown>(errorInput: unknown, options?: I_CatchErrorOptions): I_Return<T> | T {\n    const { shouldLog = true, returnValue, callback } = options ?? {};\n\n    const error = errorInput instanceof Error\n        ? errorInput\n        : new Error(typeof errorInput === 'string' ? errorInput : 'Unknown error');\n\n    if (shouldLog) {\n        log.error(error.message);\n    }\n\n    if (callback && typeof callback === 'function') {\n        callback(error);\n    }\n\n    if (returnValue) {\n        return returnValue as T;\n    }\n\n    return {\n        success: false,\n        message: error.message,\n        code: RESPONSE_STATUS.INTERNAL_SERVER_ERROR.CODE,\n    };\n}\n"],"names":["env","getEnv","throwError","message","status","RESPONSE_STATUS","type","responseMessage","GraphQLError","consola","chalkKeyword","color","chalkColor","chalk","log","title","issues","file","position","rule","positionSuffix","filePath","catchError","errorInput","options","shouldLog","returnValue","callback","error"],"mappings":";;;;;AAaA,MAAMA,IAAMC,EAAA;AAcL,SAASC,EAAW;AAAA,EACvB,SAAAC;AAAA,EACA,QAAAC,IAASC,EAAgB;AAAA,EACzB,MAAAC,IAAO;AACX,GAAwB;AACpB,QAAMC,IACAJ,KAAWC,EAAO,WAAW;AAEnC,QAAIE,MAAS,YACH,IAAIE,EAAaD,GAAiB;AAAA,IACpC,YAAY,EAAE,MAAMH,EAAO,KAAA;AAAA,EAAK,CACnC,IAIK,IAAI,MAAMG,CAAe;AAEvC;AAEKP,EAAI,UACLS,EAAQ,QAAQ;AAWpB,SAASC,EAAaC,GAA8B;AAChD,QAAMC,IAAaC,EAAMF,CAA2B;AAEpD,SAAO,OAAOC,KAAe,aAAcA,IAA+BC,EAAM;AACpF;AAOO,MAAMC,IAAa;AAAA,EACtB,QAAQL,EAAQ;AAAA,EAChB,OAAOA,EAAQ;AAAA,EACf,OAAOA,EAAQ;AAAA,EACf,OAAOA,EAAQ;AAAA,EACf,MAAMA,EAAQ;AAAA,EACd,KAAKA,EAAQ;AAAA,EACb,MAAMA,EAAQ;AAAA,EACd,SAASA,EAAQ;AAAA,EACjB,OAAOA,EAAQ;AAAA,EACf,OAAOA,EAAQ;AAAA,EACf,KAAKA,EAAQ;AAAA,EACb,OAAOA,EAAQ;AAAA,EACf,OAAOA,EAAQ;AAAA,EACf,SAASA,EAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAajB,cAAcM,GAAeC,GAAwBL,IAAQ,OAAO;AAChE,QAAI,CAACK,GAAQ,QAAQ;AACjB,MAAAP,EAAQ,IAAII,EAAM,MAAME,CAAK,CAAC;AAC9B;AAAA,IACJ;AAEA,IAAAC,EAAO,QAAQ,CAAC,EAAE,MAAAC,GAAM,UAAAC,GAAU,MAAAC,GAAM,SAAAhB,QAAc;AAClD,YAAMiB,IAAiBF,IAAW,IAAIA,CAAQ,KAAK,IAC7CG,IAAW,GAAGJ,CAAI,GAAGG,CAAc;AACzC,MAAAX,EAAQ,IAAI,GAAGI,EAAM,KAAK,OAAO,CAAC,IAAIA,EAAM,KAAKQ,CAAQ,CAAC,EAAE,GAExDF,KACAV,EAAQ,IAAI,MAAMC,EAAaC,CAAK,EAAE,OAAO,CAAC,IAAIQ,CAAI,EAAE,GAG5DV,EAAQ,IAAI,MAAMC,EAAaC,CAAK,EAAE,UAAU,CAAC,IAAIR,CAAO,EAAE;AAAA,IAClE,CAAC,GAEDM,EAAQ,IAAIC,EAAaC,CAAK,EAAE,GAAGI,CAAK,MAAMC,EAAO,MAAM,EAAE,CAAC,GAE9DP,EAAQ,IAAII,EAAM,KAAK,IAAI,OAAO,EAAE,CAAC,CAAC;AAAA,EAC1C;AACJ;AAeO,SAASS,EAAwBC,GAAqBC,GAAgD;AACzG,QAAM,EAAE,WAAAC,IAAY,IAAM,aAAAC,GAAa,UAAAC,EAAA,IAAaH,KAAW,CAAA,GAEzDI,IAAQL,aAAsB,QAC9BA,IACA,IAAI,MAAM,OAAOA,KAAe,WAAWA,IAAa,eAAe;AAU7E,SARIE,KACAX,EAAI,MAAMc,EAAM,OAAO,GAGvBD,KAAY,OAAOA,KAAa,cAChCA,EAASC,CAAK,GAGdF,KAIG;AAAA,IACH,SAAS;AAAA,IACT,SAASE,EAAM;AAAA,IACf,MAAMvB,EAAgB,sBAAsB;AAAA,EAAA;AAEpD;"}
+{"version":3,"file":"log.util.js","names":[],"sources":["../../../src/node/log/log.util.ts"],"sourcesContent":["import type { ChalkInstance } from 'chalk';\n\nimport chalk from 'chalk';\nimport consola from 'consola';\nimport { GraphQLError } from 'graphql';\n\nimport type { I_Return } from '#typescript/index.js';\n\nimport { getEnv } from '#config/env/index.js';\nimport { RESPONSE_STATUS } from '#constant/index.js';\n\nimport type { I_CatchErrorOptions, I_IssueEntry, I_Log, I_ThrowError } from './log.type.js';\n\nlet _logLevelConfigured = false;\n\n/**\n * Lazily configures the consola log level based on the DEBUG environment variable.\n * Only runs once on first invocation to avoid repeated env loading.\n */\nfunction ensureLogLevel() {\n    if (!_logLevelConfigured) {\n        _logLevelConfigured = true;\n        const env = getEnv();\n\n        if (!env.DEBUG) {\n            consola.level = 4;\n        }\n    }\n}\n\n/**\n * Throws a standardized error with optional status information and type specification.\n * This function creates and throws errors that can be either GraphQL errors (with extensions)\n * or standard JavaScript errors, depending on the specified type.\n *\n * @param options - Error configuration including message, status information, and error type.\n * @param options.message - The error message to display.\n * @param options.status - The response status information (defaults to INTERNAL_SERVER_ERROR).\n * @param options.type - The type of error to throw ('graphql' or 'rest', defaults to 'graphql').\n * @throws {GraphQLError} When type is 'graphql', throws a GraphQL error with extensions.\n * @throws {Error} When type is 'rest' or unspecified, throws a standard JavaScript error.\n */\nexport function throwError({\n    message,\n    status = RESPONSE_STATUS.INTERNAL_SERVER_ERROR,\n    type = 'graphql',\n}: I_ThrowError): never {\n    const responseMessage\n        = message ?? status.MESSAGE ?? 'Internal server error';\n\n    if (type === 'graphql') {\n        throw new GraphQLError(responseMessage, {\n            extensions: { code: status.CODE },\n        });\n    }\n\n    else {\n        throw new Error(responseMessage);\n    }\n}\n\n/**\n * Gets a chalk color instance by keyword name.\n * This function safely retrieves a chalk color function by name, falling back to green\n * if the specified color is not available or invalid.\n *\n * @param color - The color keyword to get the chalk instance for.\n * @returns A chalk instance for the specified color, or green as fallback.\n */\nfunction chalkKeyword(color: string): ChalkInstance {\n    const chalkColor = chalk[color as keyof typeof chalk];\n\n    return typeof chalkColor === 'function' ? (chalkColor as ChalkInstance) : chalk.green;\n}\n\n/**\n * Enhanced logging interface that extends consola with custom functionality.\n * This object provides all standard consola logging methods plus additional features\n * like boxed log printing for structured error/warning display.\n */\nexport const log: I_Log = {\n    silent: consola.silent,\n    level: consola.level,\n    fatal: consola.fatal,\n    error: consola.error,\n    warn: consola.warn,\n    log: consola.log,\n    info: consola.info,\n    success: consola.success,\n    ready: consola.ready,\n    start: consola.start,\n    box: consola.box,\n    debug: consola.debug,\n    trace: consola.trace,\n    verbose: consola.verbose,\n    /**\n     * Prints a boxed log with structured issue information.\n     * This method displays issues (errors or warnings) in a formatted box with:\n     * - File paths and line/column positions\n     * - Rule violations (if applicable)\n     * - Error/warning messages\n     * - Color-coded output based on issue type\n     *\n     * @param title - The title to display in the box header.\n     * @param issues - An array of issue entries to display.\n     * @param color - The color to use for highlighting (defaults to 'red').\n     */\n    printBoxedLog(title: string, issues: I_IssueEntry[], color = 'red') {\n        if (!issues?.length) {\n            consola.box(chalk.green(title));\n            return;\n        }\n\n        issues.forEach(({ file, position, rule, message }) => {\n            const positionSuffix = position ? `:${position}` : '';\n            const filePath = `${file}${positionSuffix}`;\n            consola.log(`${chalk.gray('File:')} ${chalk.blue(filePath)}`);\n\n            if (rule) {\n                consola.log(`   ${chalkKeyword(color)('Rule:')} ${rule}`);\n            }\n\n            consola.log(`   ${chalkKeyword(color)('Message:')} ${message}`);\n        });\n\n        consola.box(chalkKeyword(color)(`${title} : ${issues.length}`));\n\n        consola.log(chalk.gray('─'.repeat(40)));\n    },\n};\n\n/**\n * Catches and handles errors with configurable behavior.\n * This function provides a standardized way to handle errors with options for:\n * - Logging control (whether to log the error)\n * - Return value specification (what to return on error)\n * - Custom callback execution (additional error handling)\n *\n * @param errorInput - The error to catch and handle.\n * @param options - Configuration options for error handling behavior.\n * @returns Either the specified return value or a standardized error response object.\n */\nexport function catchError<T = unknown>(errorInput: unknown, options: I_CatchErrorOptions & { returnValue: T }): T;\nexport function catchError<T = unknown>(errorInput: unknown, options?: I_CatchErrorOptions): I_Return<T>;\nexport function catchError<T = unknown>(errorInput: unknown, options?: I_CatchErrorOptions): I_Return<T> | T {\n    const { shouldLog = true, returnValue, callback } = options ?? {};\n\n    const error = errorInput instanceof Error\n        ? errorInput\n        : new Error(typeof errorInput === 'string' ? errorInput : 'Unknown error');\n\n    if (shouldLog) {\n        ensureLogLevel();\n        log.error(error.message);\n    }\n\n    if (callback && typeof callback === 'function') {\n        callback(error);\n    }\n\n    if (returnValue !== undefined) {\n        return returnValue as T;\n    }\n\n    return {\n        success: false,\n        message: error.message,\n        code: RESPONSE_STATUS.INTERNAL_SERVER_ERROR.CODE,\n    };\n}\n"],"mappings":";;;;;;AAaA,IAAI,IAAsB;AAM1B,SAAS,IAAiB;AACtB,CAAK,MACD,IAAsB,IACV,GAAQ,CAEX,UACL,EAAQ,QAAQ;;AAiB5B,SAAgB,EAAW,EACvB,YACA,YAAS,EAAgB,uBACzB,UAAO,aACa;CACpB,IAAM,IACA,KAAW,EAAO,WAAW;AAS/B,OAPA,MAAS,YACH,IAAI,EAAa,GAAiB,EACpC,YAAY,EAAE,MAAM,EAAO,MAAM,EACpC,CAAC,GAIQ,MAAM,EAAgB;;AAYxC,SAAS,EAAa,GAA8B;CAChD,IAAM,IAAa,EAAM;AAEzB,QAAO,OAAO,KAAe,aAAc,IAA+B,EAAM;;AAQpF,IAAa,IAAa;CACtB,QAAQ,EAAQ;CAChB,OAAO,EAAQ;CACf,OAAO,EAAQ;CACf,OAAO,EAAQ;CACf,MAAM,EAAQ;CACd,KAAK,EAAQ;CACb,MAAM,EAAQ;CACd,SAAS,EAAQ;CACjB,OAAO,EAAQ;CACf,OAAO,EAAQ;CACf,KAAK,EAAQ;CACb,OAAO,EAAQ;CACf,OAAO,EAAQ;CACf,SAAS,EAAQ;CAajB,cAAc,GAAe,GAAwB,IAAQ,OAAO;AAChE,MAAI,CAAC,GAAQ,QAAQ;AACjB,KAAQ,IAAI,EAAM,MAAM,EAAM,CAAC;AAC/B;;AAiBJ,EAdA,EAAO,SAAS,EAAE,SAAM,aAAU,SAAM,iBAAc;GAElD,IAAM,IAAW,GAAG,IADG,IAAW,IAAI,MAAa;AAQnD,GANA,EAAQ,IAAI,GAAG,EAAM,KAAK,QAAQ,CAAC,GAAG,EAAM,KAAK,EAAS,GAAG,EAEzD,KACA,EAAQ,IAAI,MAAM,EAAa,EAAM,CAAC,QAAQ,CAAC,GAAG,IAAO,EAG7D,EAAQ,IAAI,MAAM,EAAa,EAAM,CAAC,WAAW,CAAC,GAAG,IAAU;IACjE,EAEF,EAAQ,IAAI,EAAa,EAAM,CAAC,GAAG,EAAM,KAAK,EAAO,SAAS,CAAC,EAE/D,EAAQ,IAAI,EAAM,KAAK,IAAI,OAAO,GAAG,CAAC,CAAC;;CAE9C;AAeD,SAAgB,EAAwB,GAAqB,GAAgD;CACzG,IAAM,EAAE,eAAY,IAAM,gBAAa,gBAAa,KAAW,EAAE,EAE3D,IAAQ,aAAsB,QAC9B,IACI,MAAM,OAAO,KAAe,WAAW,IAAa,gBAAgB;AAe9E,QAbI,MACA,GAAgB,EAChB,EAAI,MAAM,EAAM,QAAQ,GAGxB,KAAY,OAAO,KAAa,cAChC,EAAS,EAAM,EAGf,MAAgB,KAAA,IAIb;EACH,SAAS;EACT,SAAS,EAAM;EACf,MAAM,EAAgB,sBAAsB;EAC/C,GAPU"}

package/dist/node/mongo/index.js

@@ -1,26 +1,8 @@
-import { MONGO_MIGRATE_OPTIONS as r, MONGO_SLUG_MAX_ATTEMPTS as t } from "./mongo.constant.js";
-import { filterDynamicVirtualsFromPopulate as m, isMongooseDoc as p, isObject as n, populateDynamicVirtuals as a, remapDynamicPopulate as M } from "./mongo.dynamic-populate.js";
-import { applyNestedPopulate as _ } from "./mongo.populate.js";
-import { C_Collection as f, C_Db as u, C_Document as s, C_Model as x } from "./mongo.type.js";
-import { convertEnumToModelName as O, mongo as D } from "./mongo.util.js";
-import { MongoController as N } from "./mongo.controller.native.js";
-import { MongooseController as g } from "./mongo.controller.mongoose.js";
-export {
-  f as C_Collection,
-  u as C_Db,
-  s as C_Document,
-  x as C_Model,
-  r as MONGO_MIGRATE_OPTIONS,
-  t as MONGO_SLUG_MAX_ATTEMPTS,
-  N as MongoController,
-  g as MongooseController,
-  _ as applyNestedPopulate,
-  O as convertEnumToModelName,
-  m as filterDynamicVirtualsFromPopulate,
-  p as isMongooseDoc,
-  n as isObject,
-  D as mongo,
-  a as populateDynamicVirtuals,
-  M as remapDynamicPopulate
-};
-//# sourceMappingURL=index.js.map
+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 };

package/dist/node/mongo/mongo.constant.js

@@ -1,6 +1,6 @@
-const O = "MONGO_MIGRATE_OPTIONS", M = 100;
-export {
-  O as MONGO_MIGRATE_OPTIONS,
-  M as MONGO_SLUG_MAX_ATTEMPTS
-};
-//# sourceMappingURL=mongo.constant.js.map
+//#region src/node/mongo/mongo.constant.ts
+var e = "MONGO_MIGRATE_OPTIONS", t = 100;
+//#endregion
+export { e as MONGO_MIGRATE_OPTIONS, t as MONGO_SLUG_MAX_ATTEMPTS };
+
+//# sourceMappingURL=mongo.constant.js.map

package/dist/node/mongo/mongo.constant.js.map

@@ -1 +1 @@
-{"version":3,"file":"mongo.constant.js","sources":["../../../src/node/mongo/mongo.constant.ts"],"sourcesContent":["/**\n * Environment variable key for MongoDB migration options.\n * This constant defines the environment variable name that can be used to configure\n * MongoDB migration settings and options for database schema management.\n */\nexport const MONGO_MIGRATE_OPTIONS = 'MONGO_MIGRATE_OPTIONS';\n\n/**\n * Maximum number of attempts to generate a unique slug.\n * This constant defines the maximum number of attempts to generate a unique slug\n * before giving up and returning a fallback slug.\n */\nexport const MONGO_SLUG_MAX_ATTEMPTS = 100;\n"],"names":["MONGO_MIGRATE_OPTIONS","MONGO_SLUG_MAX_ATTEMPTS"],"mappings":"AAKO,MAAMA,IAAwB,yBAOxBC,IAA0B;"}
+{"version":3,"file":"mongo.constant.js","names":[],"sources":["../../../src/node/mongo/mongo.constant.ts"],"sourcesContent":["/**\n * Environment variable key for MongoDB migration options.\n * This constant defines the environment variable name that can be used to configure\n * MongoDB migration settings and options for database schema management.\n */\nexport const MONGO_MIGRATE_OPTIONS = 'MONGO_MIGRATE_OPTIONS';\n\n/**\n * Maximum number of attempts to generate a unique slug.\n * This constant defines the maximum number of attempts to generate a unique slug\n * before giving up and returning a fallback slug.\n */\nexport const MONGO_SLUG_MAX_ATTEMPTS = 100;\n"],"mappings":";AAKA,IAAa,IAAwB,yBAOxB,IAA0B"}

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

@@ -7,12 +7,17 @@ import { C_Document, I_DeleteOptionsExtended, I_ExtendedModel, I_Input_CheckSlug
  */
 export declare class MongooseController<T extends Partial<C_Document>> {
     private model;
+    private defaultLimit;
     /**
      * Creates a new Mongoose controller instance.
      *
      * @param model - The Mongoose model to operate on.
+     * @param options - Optional configuration for the controller.
+     * @param options.defaultLimit - Maximum documents returned by findAll when no limit is specified (default: 10,000).
      */
-    constructor(model: I_ExtendedModel<T>);
+    constructor(model: I_ExtendedModel<T>, options?: {
+        defaultLimit?: number;
+    });
     /**
      * Gets the model name for logging and error messages.
      *