@lyxa.ai/core 1.0.103 → 1.0.104-debug.1

package/dist/utilities/error-middleware.js.map

@@ -1 +1 @@
-{"version":3,"file":"error-middleware.js","sourceRoot":"/","sources":["utilities/error-middleware.ts"],"names":[],"mappings":"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","sourcesContent":["import { TRPCError } from '@trpc/server';\r\nimport { ErrorHandler } from './error-handler';\r\nimport * as util from 'util';\r\n\r\n/**\r\n * Parameters for the tRPC error handler\r\n * @typedef {Object} ErrorHandlerParams\r\n * @property {TRPCError|Error|unknown} error - The error object to handle\r\n * @property {'query'|'mutation'|'subscription'|'unknown'} type - The type of tRPC procedure\r\n * @property {string|undefined} path - The path of the tRPC procedure\r\n * @property {Record<string,any>|undefined} ctx - The context of the request\r\n * @property {any} req - The request object\r\n * @property {unknown} input - The input parameters for the procedure\r\n */\r\ninterface ErrorHandlerParams {\r\n\terror: TRPCError | Error | unknown;\r\n\ttype: 'query' | 'mutation' | 'subscription' | 'unknown';\r\n\tpath: string | undefined;\r\n\tctx: Record<string, any> | undefined;\r\n\treq: any;\r\n\tinput: unknown;\r\n}\r\n\r\n/**\r\n * Structure of validation errors from zod validation\r\n * @typedef {Object} ValidationError\r\n * @property {string} code - The error code (e.g., 'invalid_type')\r\n * @property {string} expected - The expected type or value\r\n * @property {string} received - The received type or value\r\n * @property {(string|number)[]} path - The path to the field with the error\r\n * @property {string} message - The error message\r\n */\r\ninterface ValidationError {\r\n\tcode: string;\r\n\texpected: string;\r\n\treceived: string;\r\n\tpath: (string | number)[];\r\n\tmessage: string;\r\n}\r\n\r\n/**\r\n * Central error handler for tRPC HTTP server.\r\n *\r\n * This handler provides comprehensive error logging with structured, formatted output in the console.\r\n * It specializes in handling validation errors from zod schemas, presenting them in a readable format\r\n * both for console debugging and client response.\r\n *\r\n * Key features:\r\n * - Beautiful console formatting with box-styled outputs\r\n * - Special handling for validation errors with field-by-field breakdown\r\n * - Proper handling of nested error objects and stack traces\r\n * - Integration with ErrorHandler utility for extracting additional metadata\r\n * - Client-friendly error message formatting for validation errors\r\n *\r\n * @param {ErrorHandlerParams} params - The error handler parameters\r\n * @param {TRPCError|Error|unknown} params.error - The error that occurred\r\n * @param {'query'|'mutation'|'subscription'|'unknown'} params.type - Type of tRPC procedure\r\n * @param {string|undefined} params.path - Path of the tRPC procedure\r\n * @param {Record<string,any>|undefined} params.ctx - Request context\r\n * @param {any} params.req - The request object\r\n * @param {unknown} params.input - The input parameters\r\n *\r\n * @returns {void}\r\n */\r\nexport function handleTRPCError({ error, type, path, ctx }: ErrorHandlerParams): void {\r\n\tconst errorContext = {\r\n\t\tprocedurePath: path ?? 'unknown',\r\n\t\tprocedureType: type,\r\n\t\trequestId: ctx?.requestId ?? 'unknown',\r\n\t\ttimestamp: new Date().toISOString(),\r\n\t};\r\n\r\n\tconsole.error(error);\r\n\r\n\t// Print a clear error header with context\r\n\tconsole.error('\\n\\n');\r\n\tconsole.error('╔═══════════════════════════════════════════════════════════════════╗');\r\n\tconsole.error('║                       🔥 TRPC ERROR 🔥                           ║');\r\n\tconsole.error('╚═══════════════════════════════════════════════════════════════════╝');\r\n\r\n\t// Print context information in a structured format\r\n\tconsole.error('\\n📋 Error Context:');\r\n\tconsole.error('┌─────────────────────────────────────────────────────────────────┐');\r\n\tconsole.error(`│ Path:      ${errorContext.procedurePath.padEnd(52)} │`);\r\n\tconsole.error(`│ Type:      ${errorContext.procedureType.padEnd(52)} │`);\r\n\tconsole.error(`│ Request ID: ${errorContext.requestId.padEnd(51)} │`);\r\n\tconsole.error(`│ Timestamp: ${errorContext.timestamp.padEnd(51)} │`);\r\n\tconsole.error('└─────────────────────────────────────────────────────────────────┘');\r\n\r\n\tif (error instanceof TRPCError) {\r\n\t\t// Print basic error info\r\n\t\tconsole.error('\\n🚨 Error Details:');\r\n\t\tconsole.error('┌─────────────────────────────────────────────────────────────────┐');\r\n\t\tconsole.error(`│ Code:    ${error.code.padEnd(54)} │`);\r\n\t\tconsole.error('└─────────────────────────────────────────────────────────────────┘');\r\n\r\n\t\t// Handle validation errors specially\r\n\t\tif (error.code === 'BAD_REQUEST') {\r\n\t\t\ttry {\r\n\t\t\t\tif (error.message.trim().startsWith('[') && error.message.includes('\"code\"')) {\r\n\t\t\t\t\tconst validationErrors = JSON.parse(error.message) as ValidationError[];\r\n\r\n\t\t\t\t\tconsole.error('\\n📋 Validation Errors:');\r\n\r\n\t\t\t\t\tvalidationErrors.forEach((err, index) => {\r\n\t\t\t\t\t\tconst fieldPath = err.path.join('.');\r\n\t\t\t\t\t\tconsole.error(`│ ${(index + 1).toString().padStart(2)}. Field: ${fieldPath.padEnd(52)} │`);\r\n\t\t\t\t\t\tconsole.error(`│    Error: ${err.message.padEnd(53)} │`);\r\n\t\t\t\t\t\tconsole.error(`│    Expected: ${err.expected?.padEnd(50) || 'N/A'.padEnd(50)} │`);\r\n\t\t\t\t\t\tconsole.error(`│    Received: ${err.received?.padEnd(50) || 'N/A'.padEnd(50)} │`);\r\n\r\n\t\t\t\t\t\t// Add a separator between errors, except for the last one\r\n\t\t\t\t\t\tif (index < validationErrors.length - 1) {\r\n\t\t\t\t\t\t\tconsole.error('│                                                                 │');\r\n\t\t\t\t\t\t}\r\n\t\t\t\t\t});\r\n\r\n\t\t\t\t\t// Format field errors for the client response\r\n\t\t\t\t\tconst fieldErrors = validationErrors.map(err => `(${err.path.join('.')}: ${err.message})`);\r\n\r\n\t\t\t\t\terror.message = `Validation failed: ${fieldErrors.join(', ')}`;\r\n\r\n\t\t\t\t\t// Print the formatted client message\r\n\t\t\t\t\tconsole.error('\\n📤 Client Response Message:');\r\n\r\n\t\t\t\t\t// Split the message into multiple lines if it's too long\r\n\t\t\t\t\tconst message = error.message;\r\n\t\t\t\t\tconst chunkSize = 65;\r\n\r\n\t\t\t\t\tfor (let i = 0; i < message.length; i += chunkSize) {\r\n\t\t\t\t\t\tconst chunk = message.substring(i, i + chunkSize);\r\n\t\t\t\t\t\tconsole.error(`│ ${chunk.padEnd(65)}`);\r\n\t\t\t\t\t}\r\n\r\n\t\t\t\t\treturn;\r\n\t\t\t\t}\r\n\t\t\t} catch (parseError) {\r\n\t\t\t\tconsole.error('\\n⚠️ Error Parsing Validation Error:');\r\n\t\t\t\tconsole.error(\r\n\t\t\t\t\t`│ ${parseError instanceof Error ? parseError.message.padEnd(65) : String(parseError).padEnd(65)}`\r\n\t\t\t\t);\r\n\t\t\t}\r\n\t\t}\r\n\r\n\t\t// Print the error message\r\n\t\tconsole.error('\\n📝 Error Message:');\r\n\r\n\t\t// Split the message into multiple lines if it's too long\r\n\t\tconst message = error.message;\r\n\t\tconst chunkSize = 65;\r\n\r\n\t\tfor (let i = 0; i < message.length; i += chunkSize) {\r\n\t\t\tconst chunk = message.substring(i, i + chunkSize);\r\n\t\t\tconsole.error(`│ ${chunk.padEnd(65)}`);\r\n\t\t}\r\n\r\n\t\t// Print the error cause if available\r\n\t\tif (error.cause) {\r\n\t\t\tconsole.error('\\n🔍 Error Cause:');\r\n\r\n\t\t\t// Use util.inspect to format the cause object nicely\r\n\t\t\tconst causeString = util.inspect(error.cause, { depth: 4, colors: true });\r\n\t\t\tconst causeLines = causeString.split('\\n');\r\n\r\n\t\t\tcauseLines.forEach(line => {\r\n\t\t\t\t// Remove ANSI color codes for padding calculation\r\n\t\t\t\tconst plainLine = line.replace(/\\x1b\\[\\d+m/g, '');\r\n\t\t\t\tconsole.error(`│ ${line.padEnd(65 - (line.length - plainLine.length))}`);\r\n\t\t\t});\r\n\t\t}\r\n\r\n\t\t// Print stack trace if available\r\n\t\tif (error.stack) {\r\n\t\t\tconsole.error('\\n📚 Stack Trace:');\r\n\r\n\t\t\tconst stackLines = error.stack.split('\\n');\r\n\t\t\tstackLines.forEach(line => {\r\n\t\t\t\t// Truncate or split long lines\r\n\t\t\t\tif (line.length > 65) {\r\n\t\t\t\t\tfor (let i = 0; i < line.length; i += 65) {\r\n\t\t\t\t\t\tconst chunk = line.substring(i, i + 65);\r\n\t\t\t\t\t\tconsole.error(`│ ${chunk.padEnd(65)}`);\r\n\t\t\t\t\t}\r\n\t\t\t\t} else {\r\n\t\t\t\t\tconsole.error(`│ ${line.padEnd(65)}`);\r\n\t\t\t\t}\r\n\t\t\t});\r\n\t\t}\r\n\t} else if (error instanceof Error) {\r\n\t\t// Handle standard errors\r\n\t\tconsole.error('\\n🚨 Standard Error:');\r\n\t\tconsole.error('┌─────────────────────────────────────────────────────────────────┐');\r\n\t\tconsole.error(`│ Name:    ${error.name.padEnd(54)} │`);\r\n\t\tconsole.error(`│ Message: ${error.message.padEnd(54)} │`);\r\n\t\tconsole.error('└─────────────────────────────────────────────────────────────────┘');\r\n\r\n\t\t// Print stack trace if available\r\n\t\tif (error.stack) {\r\n\t\t\tconsole.error('\\n📚 Stack Trace:');\r\n\r\n\t\t\tconst stackLines = error.stack.split('\\n');\r\n\t\t\tstackLines.forEach(line => {\r\n\t\t\t\t// Truncate or split long lines\r\n\t\t\t\tif (line.length > 65) {\r\n\t\t\t\t\tfor (let i = 0; i < line.length; i += 65) {\r\n\t\t\t\t\t\tconst chunk = line.substring(i, i + 65);\r\n\t\t\t\t\t\tconsole.error(`│ ${chunk.padEnd(65)} │`);\r\n\t\t\t\t\t}\r\n\t\t\t\t} else {\r\n\t\t\t\t\tconsole.error(`│ ${line.padEnd(65)} │`);\r\n\t\t\t\t}\r\n\t\t\t});\r\n\t\t}\r\n\t} else {\r\n\t\t// Handle unknown errors\r\n\t\tconsole.error('\\n❓ Unknown Error:');\r\n\r\n\t\tconst errorString = util.inspect(error, { depth: 4, colors: true });\r\n\t\tconst errorLines = errorString.split('\\n');\r\n\r\n\t\terrorLines.forEach(line => {\r\n\t\t\t// Remove ANSI color codes for padding calculation\r\n\t\t\tconst plainLine = line.replace(/\\x1b\\[\\d+m/g, '');\r\n\t\t\tconsole.error(`│ ${line.padEnd(65 - (line.length - plainLine.length))}`);\r\n\t\t});\r\n\t}\r\n\r\n\t// Use ErrorHandler's methods for additional metadata\r\n\ttry {\r\n\t\tconst errorMeta = ErrorHandler.extractErrorMetadata(error);\r\n\r\n\t\tif (errorMeta && Object.keys(errorMeta).length > 0) {\r\n\t\t\tconsole.error('\\n🔬 Additional Error Metadata:');\r\n\r\n\t\t\tconst metaString = util.inspect(errorMeta, { depth: 4, colors: true });\r\n\t\t\tconst metaLines = metaString.split('\\n');\r\n\r\n\t\t\tmetaLines.forEach(line => {\r\n\t\t\t\t// Remove ANSI color codes for padding calculation\r\n\t\t\t\tconst plainLine = line.replace(/\\x1b\\[\\d+m/g, '');\r\n\t\t\t\tconsole.error(`│ ${line.padEnd(65 - (line.length - plainLine.length))}`);\r\n\t\t\t});\r\n\t\t}\r\n\t} catch (handlingError) {\r\n\t\tconsole.error('\\n⚠️ Error While Extracting Metadata:');\r\n\t\tconsole.error(\r\n\t\t\t`│ ${\r\n\t\t\t\thandlingError instanceof Error ? handlingError.message.padEnd(65) : String(handlingError).padEnd(65)\r\n\t\t\t}`\r\n\t\t);\r\n\t}\r\n\r\n\tconsole.error('\\n\\n');\r\n}\r\n"]}
+{"version":3,"file":"error-middleware.js","sourceRoot":"/","sources":["utilities/error-middleware.ts"],"names":[],"mappings":"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","sourcesContent":["import { TRPCError } from '@trpc/server';\nimport { ErrorHandler } from './error-handler';\nimport * as util from 'util';\n\n/**\n * Parameters for the tRPC error handler\n * @typedef {Object} ErrorHandlerParams\n * @property {TRPCError|Error|unknown} error - The error object to handle\n * @property {'query'|'mutation'|'subscription'|'unknown'} type - The type of tRPC procedure\n * @property {string|undefined} path - The path of the tRPC procedure\n * @property {Record<string,any>|undefined} ctx - The context of the request\n * @property {any} req - The request object\n * @property {unknown} input - The input parameters for the procedure\n */\ninterface ErrorHandlerParams {\n\terror: TRPCError | Error | unknown;\n\ttype: 'query' | 'mutation' | 'subscription' | 'unknown';\n\tpath: string | undefined;\n\tctx: Record<string, any> | undefined;\n\treq: any;\n\tinput: unknown;\n}\n\n/**\n * Structure of validation errors from zod validation\n * @typedef {Object} ValidationError\n * @property {string} code - The error code (e.g., 'invalid_type')\n * @property {string} expected - The expected type or value\n * @property {string} received - The received type or value\n * @property {(string|number)[]} path - The path to the field with the error\n * @property {string} message - The error message\n */\ninterface ValidationError {\n\tcode: string;\n\texpected: string;\n\treceived: string;\n\tpath: (string | number)[];\n\tmessage: string;\n}\n\n/**\n * Central error handler for tRPC HTTP server.\n *\n * This handler provides comprehensive error logging with structured, formatted output in the console.\n * It specializes in handling validation errors from zod schemas, presenting them in a readable format\n * both for console debugging and client response.\n *\n * Key features:\n * - Beautiful console formatting with box-styled outputs\n * - Special handling for validation errors with field-by-field breakdown\n * - Proper handling of nested error objects and stack traces\n * - Integration with ErrorHandler utility for extracting additional metadata\n * - Client-friendly error message formatting for validation errors\n *\n * @param {ErrorHandlerParams} params - The error handler parameters\n * @param {TRPCError|Error|unknown} params.error - The error that occurred\n * @param {'query'|'mutation'|'subscription'|'unknown'} params.type - Type of tRPC procedure\n * @param {string|undefined} params.path - Path of the tRPC procedure\n * @param {Record<string,any>|undefined} params.ctx - Request context\n * @param {any} params.req - The request object\n * @param {unknown} params.input - The input parameters\n *\n * @returns {void}\n */\nexport function handleTRPCError({ error, type, path, ctx }: ErrorHandlerParams): void {\n\tconst errorContext = {\n\t\tprocedurePath: path ?? 'unknown',\n\t\tprocedureType: type,\n\t\trequestId: ctx?.requestId ?? 'unknown',\n\t\ttimestamp: new Date().toISOString(),\n\t};\n\n\tconsole.error(error);\n\n\t// Print a clear error header with context\n\tconsole.error('\\n\\n');\n\tconsole.error('╔═══════════════════════════════════════════════════════════════════╗');\n\tconsole.error('║                       🔥 TRPC ERROR 🔥                           ║');\n\tconsole.error('╚═══════════════════════════════════════════════════════════════════╝');\n\n\t// Print context information in a structured format\n\tconsole.error('\\n📋 Error Context:');\n\tconsole.error('┌─────────────────────────────────────────────────────────────────┐');\n\tconsole.error(`│ Path:      ${errorContext.procedurePath.padEnd(52)} │`);\n\tconsole.error(`│ Type:      ${errorContext.procedureType.padEnd(52)} │`);\n\tconsole.error(`│ Request ID: ${errorContext.requestId.padEnd(51)} │`);\n\tconsole.error(`│ Timestamp: ${errorContext.timestamp.padEnd(51)} │`);\n\tconsole.error('└─────────────────────────────────────────────────────────────────┘');\n\n\tif (error instanceof TRPCError) {\n\t\t// Print basic error info\n\t\tconsole.error('\\n🚨 Error Details:');\n\t\tconsole.error('┌─────────────────────────────────────────────────────────────────┐');\n\t\tconsole.error(`│ Code:    ${error.code.padEnd(54)} │`);\n\t\tconsole.error('└─────────────────────────────────────────────────────────────────┘');\n\n\t\t// Handle validation errors specially\n\t\tif (error.code === 'BAD_REQUEST') {\n\t\t\ttry {\n\t\t\t\tif (error.message.trim().startsWith('[') && error.message.includes('\"code\"')) {\n\t\t\t\t\tconst validationErrors = JSON.parse(error.message) as ValidationError[];\n\n\t\t\t\t\tconsole.error('\\n📋 Validation Errors:');\n\n\t\t\t\t\tvalidationErrors.forEach((err, index) => {\n\t\t\t\t\t\tconst fieldPath = err.path.join('.');\n\t\t\t\t\t\tconsole.error(`│ ${(index + 1).toString().padStart(2)}. Field: ${fieldPath.padEnd(52)} │`);\n\t\t\t\t\t\tconsole.error(`│    Error: ${err.message.padEnd(53)} │`);\n\t\t\t\t\t\tconsole.error(`│    Expected: ${err.expected?.padEnd(50) || 'N/A'.padEnd(50)} │`);\n\t\t\t\t\t\tconsole.error(`│    Received: ${err.received?.padEnd(50) || 'N/A'.padEnd(50)} │`);\n\n\t\t\t\t\t\t// Add a separator between errors, except for the last one\n\t\t\t\t\t\tif (index < validationErrors.length - 1) {\n\t\t\t\t\t\t\tconsole.error('│                                                                 │');\n\t\t\t\t\t\t}\n\t\t\t\t\t});\n\n\t\t\t\t\t// Format field errors for the client response\n\t\t\t\t\tconst fieldErrors = validationErrors.map(err => `(${err.path.join('.')}: ${err.message})`);\n\n\t\t\t\t\terror.message = `Validation failed: ${fieldErrors.join(', ')}`;\n\n\t\t\t\t\t// Print the formatted client message\n\t\t\t\t\tconsole.error('\\n📤 Client Response Message:');\n\n\t\t\t\t\t// Split the message into multiple lines if it's too long\n\t\t\t\t\tconst message = error.message;\n\t\t\t\t\tconst chunkSize = 65;\n\n\t\t\t\t\tfor (let i = 0; i < message.length; i += chunkSize) {\n\t\t\t\t\t\tconst chunk = message.substring(i, i + chunkSize);\n\t\t\t\t\t\tconsole.error(`│ ${chunk.padEnd(65)}`);\n\t\t\t\t\t}\n\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t} catch (parseError) {\n\t\t\t\tconsole.error('\\n⚠️ Error Parsing Validation Error:');\n\t\t\t\tconsole.error(\n\t\t\t\t\t`│ ${parseError instanceof Error ? parseError.message.padEnd(65) : String(parseError).padEnd(65)}`\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\n\t\t// Print the error message\n\t\tconsole.error('\\n📝 Error Message:');\n\n\t\t// Split the message into multiple lines if it's too long\n\t\tconst message = error.message;\n\t\tconst chunkSize = 65;\n\n\t\tfor (let i = 0; i < message.length; i += chunkSize) {\n\t\t\tconst chunk = message.substring(i, i + chunkSize);\n\t\t\tconsole.error(`│ ${chunk.padEnd(65)}`);\n\t\t}\n\n\t\t// Print the error cause if available\n\t\tif (error.cause) {\n\t\t\tconsole.error('\\n🔍 Error Cause:');\n\n\t\t\t// Use util.inspect to format the cause object nicely\n\t\t\tconst causeString = util.inspect(error.cause, { depth: 4, colors: true });\n\t\t\tconst causeLines = causeString.split('\\n');\n\n\t\t\tcauseLines.forEach(line => {\n\t\t\t\t// Remove ANSI color codes for padding calculation\n\t\t\t\tconst plainLine = line.replace(/\\x1b\\[\\d+m/g, '');\n\t\t\t\tconsole.error(`│ ${line.padEnd(65 - (line.length - plainLine.length))}`);\n\t\t\t});\n\t\t}\n\n\t\t// Print stack trace if available\n\t\tif (error.stack) {\n\t\t\tconsole.error('\\n📚 Stack Trace:');\n\n\t\t\tconst stackLines = error.stack.split('\\n');\n\t\t\tstackLines.forEach(line => {\n\t\t\t\t// Truncate or split long lines\n\t\t\t\tif (line.length > 65) {\n\t\t\t\t\tfor (let i = 0; i < line.length; i += 65) {\n\t\t\t\t\t\tconst chunk = line.substring(i, i + 65);\n\t\t\t\t\t\tconsole.error(`│ ${chunk.padEnd(65)}`);\n\t\t\t\t\t}\n\t\t\t\t} else {\n\t\t\t\t\tconsole.error(`│ ${line.padEnd(65)}`);\n\t\t\t\t}\n\t\t\t});\n\t\t}\n\t} else if (error instanceof Error) {\n\t\t// Handle standard errors\n\t\tconsole.error('\\n🚨 Standard Error:');\n\t\tconsole.error('┌─────────────────────────────────────────────────────────────────┐');\n\t\tconsole.error(`│ Name:    ${error.name.padEnd(54)} │`);\n\t\tconsole.error(`│ Message: ${error.message.padEnd(54)} │`);\n\t\tconsole.error('└─────────────────────────────────────────────────────────────────┘');\n\n\t\t// Print stack trace if available\n\t\tif (error.stack) {\n\t\t\tconsole.error('\\n📚 Stack Trace:');\n\n\t\t\tconst stackLines = error.stack.split('\\n');\n\t\t\tstackLines.forEach(line => {\n\t\t\t\t// Truncate or split long lines\n\t\t\t\tif (line.length > 65) {\n\t\t\t\t\tfor (let i = 0; i < line.length; i += 65) {\n\t\t\t\t\t\tconst chunk = line.substring(i, i + 65);\n\t\t\t\t\t\tconsole.error(`│ ${chunk.padEnd(65)} │`);\n\t\t\t\t\t}\n\t\t\t\t} else {\n\t\t\t\t\tconsole.error(`│ ${line.padEnd(65)} │`);\n\t\t\t\t}\n\t\t\t});\n\t\t}\n\t} else {\n\t\t// Handle unknown errors\n\t\tconsole.error('\\n❓ Unknown Error:');\n\n\t\tconst errorString = util.inspect(error, { depth: 4, colors: true });\n\t\tconst errorLines = errorString.split('\\n');\n\n\t\terrorLines.forEach(line => {\n\t\t\t// Remove ANSI color codes for padding calculation\n\t\t\tconst plainLine = line.replace(/\\x1b\\[\\d+m/g, '');\n\t\t\tconsole.error(`│ ${line.padEnd(65 - (line.length - plainLine.length))}`);\n\t\t});\n\t}\n\n\t// Use ErrorHandler's methods for additional metadata\n\ttry {\n\t\tconst errorMeta = ErrorHandler.extractErrorMetadata(error);\n\n\t\tif (errorMeta && Object.keys(errorMeta).length > 0) {\n\t\t\tconsole.error('\\n🔬 Additional Error Metadata:');\n\n\t\t\tconst metaString = util.inspect(errorMeta, { depth: 4, colors: true });\n\t\t\tconst metaLines = metaString.split('\\n');\n\n\t\t\tmetaLines.forEach(line => {\n\t\t\t\t// Remove ANSI color codes for padding calculation\n\t\t\t\tconst plainLine = line.replace(/\\x1b\\[\\d+m/g, '');\n\t\t\t\tconsole.error(`│ ${line.padEnd(65 - (line.length - plainLine.length))}`);\n\t\t\t});\n\t\t}\n\t} catch (handlingError) {\n\t\tconsole.error('\\n⚠️ Error While Extracting Metadata:');\n\t\tconsole.error(\n\t\t\t`│ ${\n\t\t\t\thandlingError instanceof Error ? handlingError.message.padEnd(65) : String(handlingError).padEnd(65)\n\t\t\t}`\n\t\t);\n\t}\n\n\tconsole.error('\\n\\n');\n}\n"]}

package/dist/utilities/pagination.d.ts

@@ -9,29 +9,29 @@ export declare function createPaginatedSchema<ItemType extends z.ZodTypeAny>(ite
         totalElements: z.ZodNumber;
         totalPages: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
-        size: number;
         page: number;
+        size: number;
         totalElements: number;
         totalPages: number;
     }, {
-        size: number;
         page: number;
+        size: number;
         totalElements: number;
         totalPages: number;
     }>;
     items: z.ZodArray<ItemType, "many">;
 }, "strip", z.ZodTypeAny, {
     metadata: {
-        size: number;
         page: number;
+        size: number;
         totalElements: number;
         totalPages: number;
     };
     items: ItemType["_output"][];
 }, {
     metadata: {
-        size: number;
         page: number;
+        size: number;
         totalElements: number;
         totalPages: number;
     };
@@ -57,8 +57,8 @@ export interface PaginatorOptions<TClass extends AnyParamConstructor<any>> {
 export declare function createRawDocumentPaginatorObject<T extends AnyParamConstructor<any>>(model: ReturnModelType<T>): (options: PaginatorOptions<T>) => Promise<RawPaginatedResult<T>>;
 export declare function createPaginatorObject<T extends AnyParamConstructor<any>>(model: ReturnModelType<T>, itemSchema: z.ZodTypeAny, transformFn?: (doc: DocumentType<T>) => z.infer<typeof itemSchema>): (options: PaginatorOptions<T>) => Promise<{
     metadata: {
-        size: number;
         page: number;
+        size: number;
         totalElements: number;
         totalPages: number;
     };

package/dist/utilities/pagination.js.map

@@ -1 +1 @@
-{"version":3,"file":"pagination.js","sourceRoot":"/","sources":["utilities/pagination.ts"],"names":[],"mappings":"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","sourcesContent":["import { DocumentType, ReturnModelType } from '@typegoose/typegoose';\r\nimport { FilterQuery, PopulateOptions } from 'mongoose';\r\nimport { z } from 'zod';\r\nimport { AnyParamConstructor } from '@typegoose/typegoose/lib/types';\r\nimport { FilterDTO, PaginatedResponse } from './validation';\r\n\r\n/**\r\n * A helper to create a paginated Zod schema for an item type.\r\n */\r\nexport function createPaginatedSchema<ItemType extends z.ZodTypeAny>(itemSchema: ItemType) {\r\n\treturn z.object({\r\n\t\tmetadata: z.object({\r\n\t\t\tpage: z.number(),\r\n\t\t\tsize: z.number(),\r\n\t\t\ttotalElements: z.number(),\r\n\t\t\ttotalPages: z.number(),\r\n\t\t}),\r\n\t\titems: z.array(itemSchema),\r\n\t});\r\n}\r\n\r\nexport interface RawPaginatedResult<T extends AnyParamConstructor<any>> {\r\n\tmetadata: {\r\n\t\tpage: number;\r\n\t\tsize: number;\r\n\t\ttotalElements: number;\r\n\t\ttotalPages: number;\r\n\t};\r\n\tdocuments: DocumentType<T>[];\r\n}\r\n\r\n/**\r\n * The common pagination options.\r\n */\r\nexport interface PaginatorOptions<TClass extends AnyParamConstructor<any>> {\r\n\tquery?: FilterQuery<DocumentType<TClass>>;\r\n\tpage?: number;\r\n\tsize?: number;\r\n\tsort?: Record<string, 1 | -1>;\r\n\tselect?: Record<string, 0 | 1>;\r\n\tpopulate?: PopulateOptions | (PopulateOptions | string)[];\r\n}\r\n\r\n/**\r\n * This internal function wraps the common query logic:\r\n *  - filter, page, size, sort, populate\r\n *  - fetch documents, count documents\r\n *  - compute totalPages\r\n * Returns a standard object with `metadata` & `documents`.\r\n */\r\nasync function _basePaginate<T extends AnyParamConstructor<any>>(\r\n\tmodel: ReturnModelType<T>,\r\n\toptions: PaginatorOptions<T>\r\n): Promise<RawPaginatedResult<T>> {\r\n\tconst { query = {}, page = 1, size = 10, sort = {}, select, populate } = options;\r\n\r\n\tconst skip = (page - 1) * size;\r\n\r\n\tlet result = model.find(query).sort(sort).skip(skip).limit(size);\r\n\r\n\tif (select) {\r\n\t\tresult = result.select(select) as any;\r\n\t}\r\n\tif (populate) {\r\n\t\tresult = result.populate(populate);\r\n\t}\r\n\r\n\tconst [documents, totalElements] = await Promise.all([result.exec(), model.countDocuments(query)]);\r\n\r\n\tconst totalPages = Math.ceil(totalElements / size);\r\n\r\n\treturn {\r\n\t\tmetadata: {\r\n\t\t\tpage,\r\n\t\t\tsize,\r\n\t\t\ttotalElements,\r\n\t\t\ttotalPages,\r\n\t\t},\r\n\t\tdocuments: documents as unknown as DocumentType<T>[],\r\n\t};\r\n}\r\n\r\n/**\r\n * Creates a paginator returning raw documents.\r\n *\r\n * @param model The Typegoose model\r\n * @returns A function that, when passed `PaginatorOptions`, returns raw docs + metadata.\r\n */\r\nexport function createRawDocumentPaginatorObject<T extends AnyParamConstructor<any>>(\r\n\tmodel: ReturnModelType<T>\r\n) {\r\n\treturn async function paginate(options: PaginatorOptions<T>): Promise<RawPaginatedResult<T>> {\r\n\t\tconst { metadata, documents } = await _basePaginate(model, options);\r\n\r\n\t\treturn {\r\n\t\t\tmetadata,\r\n\t\t\tdocuments,\r\n\t\t};\r\n\t};\r\n}\r\n\r\n/**\r\n * Creates a paginator that returns Zod-validated items.\r\n *\r\n * @param model       The Typegoose model\r\n * @param itemSchema  A Zod schema describing the shape of each item\r\n * @param transformFn Optional transform function to convert raw doc -> item\r\n */\r\nexport function createPaginatorObject<T extends AnyParamConstructor<any>>(\r\n\tmodel: ReturnModelType<T>,\r\n\titemSchema: z.ZodTypeAny,\r\n\ttransformFn?: (doc: DocumentType<T>) => z.infer<typeof itemSchema>\r\n) {\r\n\tconst PaginatedSchema = createPaginatedSchema(itemSchema);\r\n\r\n\treturn async function paginate(options: PaginatorOptions<T>) {\r\n\t\tconst { metadata, documents } = await _basePaginate(model, options);\r\n\r\n\t\tconst items = transformFn ? documents.map(transformFn) : documents;\r\n\r\n\t\tconst paginatedResult = {\r\n\t\t\tmetadata,\r\n\t\t\titems,\r\n\t\t};\r\n\r\n\t\treturn PaginatedSchema.parse(paginatedResult);\r\n\t};\r\n}\r\nexport async function paginateAggregation(\r\n\tmodel: any,\r\n\tpipeline: any[],\r\n\tpage: number = 1,\r\n\tsize: number = 10,\r\n\tsort: any = { createdAt: -1 }\r\n) {\r\n\t// Calculate skip and limit based on the page and size\r\n\tconst skip = (page - 1) * size;\r\n\tconst limit = size;\r\n\r\n\t// Copy the pipeline to avoid mutation\r\n\tconst pipelineWithCount = [...pipeline];\r\n\r\n\t// Step 1: Calculate total count\r\n\tpipelineWithCount.push({ $count: 'totalCount' });\r\n\r\n\t// Step 2: Execute to get total count\r\n\tconst totalCountResult = await model.aggregate(pipelineWithCount).exec();\r\n\tconst totalElements = totalCountResult?.[0]?.totalCount || 0;\r\n\tconst totalPages = Math.ceil(totalElements / size);\r\n\r\n\t// Step 3: Apply pagination to the original pipeline\r\n\tconst paginatedPipeline = [...pipeline];\r\n\tpaginatedPipeline.push({ $sort: sort });\r\n\tpaginatedPipeline.push({ $skip: skip });\r\n\tpaginatedPipeline.push({ $limit: limit });\r\n\r\n\t// Step 4: Execute the paginated pipeline\r\n\tconst data = await model.aggregate(paginatedPipeline).exec();\r\n\r\n\t// Return the paginated data with metadata\r\n\treturn {\r\n\t\tmetadata: {\r\n\t\t\tpage,\r\n\t\t\tsize,\r\n\t\t\ttotalElements,\r\n\t\t\ttotalPages,\r\n\t\t},\r\n\t\tdocuments: data,\r\n\t};\r\n}\r\n"]}
+{"version":3,"file":"pagination.js","sourceRoot":"/","sources":["utilities/pagination.ts"],"names":[],"mappings":"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","sourcesContent":["import { DocumentType, ReturnModelType } from '@typegoose/typegoose';\nimport { FilterQuery, PopulateOptions } from 'mongoose';\nimport { z } from 'zod';\nimport { AnyParamConstructor } from '@typegoose/typegoose/lib/types';\nimport { FilterDTO, PaginatedResponse } from './validation';\n\n/**\n * A helper to create a paginated Zod schema for an item type.\n */\nexport function createPaginatedSchema<ItemType extends z.ZodTypeAny>(itemSchema: ItemType) {\n\treturn z.object({\n\t\tmetadata: z.object({\n\t\t\tpage: z.number(),\n\t\t\tsize: z.number(),\n\t\t\ttotalElements: z.number(),\n\t\t\ttotalPages: z.number(),\n\t\t}),\n\t\titems: z.array(itemSchema),\n\t});\n}\n\nexport interface RawPaginatedResult<T extends AnyParamConstructor<any>> {\n\tmetadata: {\n\t\tpage: number;\n\t\tsize: number;\n\t\ttotalElements: number;\n\t\ttotalPages: number;\n\t};\n\tdocuments: DocumentType<T>[];\n}\n\n/**\n * The common pagination options.\n */\nexport interface PaginatorOptions<TClass extends AnyParamConstructor<any>> {\n\tquery?: FilterQuery<DocumentType<TClass>>;\n\tpage?: number;\n\tsize?: number;\n\tsort?: Record<string, 1 | -1>;\n\tselect?: Record<string, 0 | 1>;\n\tpopulate?: PopulateOptions | (PopulateOptions | string)[];\n}\n\n/**\n * This internal function wraps the common query logic:\n *  - filter, page, size, sort, populate\n *  - fetch documents, count documents\n *  - compute totalPages\n * Returns a standard object with `metadata` & `documents`.\n */\nasync function _basePaginate<T extends AnyParamConstructor<any>>(\n\tmodel: ReturnModelType<T>,\n\toptions: PaginatorOptions<T>\n): Promise<RawPaginatedResult<T>> {\n\tconst { query = {}, page = 1, size = 10, sort = {}, select, populate } = options;\n\n\tconst skip = (page - 1) * size;\n\n\tlet result = model.find(query).sort(sort).skip(skip).limit(size);\n\n\tif (select) {\n\t\tresult = result.select(select) as any;\n\t}\n\tif (populate) {\n\t\tresult = result.populate(populate);\n\t}\n\n\tconst [documents, totalElements] = await Promise.all([result.exec(), model.countDocuments(query)]);\n\n\tconst totalPages = Math.ceil(totalElements / size);\n\n\treturn {\n\t\tmetadata: {\n\t\t\tpage,\n\t\t\tsize,\n\t\t\ttotalElements,\n\t\t\ttotalPages,\n\t\t},\n\t\tdocuments: documents as unknown as DocumentType<T>[],\n\t};\n}\n\n/**\n * Creates a paginator returning raw documents.\n *\n * @param model The Typegoose model\n * @returns A function that, when passed `PaginatorOptions`, returns raw docs + metadata.\n */\nexport function createRawDocumentPaginatorObject<T extends AnyParamConstructor<any>>(\n\tmodel: ReturnModelType<T>\n) {\n\treturn async function paginate(options: PaginatorOptions<T>): Promise<RawPaginatedResult<T>> {\n\t\tconst { metadata, documents } = await _basePaginate(model, options);\n\n\t\treturn {\n\t\t\tmetadata,\n\t\t\tdocuments,\n\t\t};\n\t};\n}\n\n/**\n * Creates a paginator that returns Zod-validated items.\n *\n * @param model       The Typegoose model\n * @param itemSchema  A Zod schema describing the shape of each item\n * @param transformFn Optional transform function to convert raw doc -> item\n */\nexport function createPaginatorObject<T extends AnyParamConstructor<any>>(\n\tmodel: ReturnModelType<T>,\n\titemSchema: z.ZodTypeAny,\n\ttransformFn?: (doc: DocumentType<T>) => z.infer<typeof itemSchema>\n) {\n\tconst PaginatedSchema = createPaginatedSchema(itemSchema);\n\n\treturn async function paginate(options: PaginatorOptions<T>) {\n\t\tconst { metadata, documents } = await _basePaginate(model, options);\n\n\t\tconst items = transformFn ? documents.map(transformFn) : documents;\n\n\t\tconst paginatedResult = {\n\t\t\tmetadata,\n\t\t\titems,\n\t\t};\n\n\t\treturn PaginatedSchema.parse(paginatedResult);\n\t};\n}\nexport async function paginateAggregation(\n\tmodel: any,\n\tpipeline: any[],\n\tpage: number = 1,\n\tsize: number = 10,\n\tsort: any = { createdAt: -1 }\n) {\n\t// Calculate skip and limit based on the page and size\n\tconst skip = (page - 1) * size;\n\tconst limit = size;\n\n\t// Copy the pipeline to avoid mutation\n\tconst pipelineWithCount = [...pipeline];\n\n\t// Step 1: Calculate total count\n\tpipelineWithCount.push({ $count: 'totalCount' });\n\n\t// Step 2: Execute to get total count\n\tconst totalCountResult = await model.aggregate(pipelineWithCount).exec();\n\tconst totalElements = totalCountResult?.[0]?.totalCount || 0;\n\tconst totalPages = Math.ceil(totalElements / size);\n\n\t// Step 3: Apply pagination to the original pipeline\n\tconst paginatedPipeline = [...pipeline];\n\tpaginatedPipeline.push({ $sort: sort });\n\tpaginatedPipeline.push({ $skip: skip });\n\tpaginatedPipeline.push({ $limit: limit });\n\n\t// Step 4: Execute the paginated pipeline\n\tconst data = await model.aggregate(paginatedPipeline).exec();\n\n\t// Return the paginated data with metadata\n\treturn {\n\t\tmetadata: {\n\t\t\tpage,\n\t\t\tsize,\n\t\t\ttotalElements,\n\t\t\ttotalPages,\n\t\t},\n\t\tdocuments: data,\n\t};\n}\n"]}

package/dist/utilities/response.js.map

@@ -1 +1 @@
-{"version":3,"file":"response.js","sourceRoot":"/","sources":["utilities/response.ts"],"names":[],"mappings":";;;AAAO,MAAM,QAAQ,GAAG,CAAI,OAAe,EAAE,IAAQ,EAAE,EAAE,CAAC,CAAC;IAC1D,OAAO,EAAE,IAAI;IACb,OAAO;IACP,IAAI;CACJ,CAAC,CAAC;AAJU,QAAA,QAAQ,YAIlB","sourcesContent":["export const response = <T>(message: string, data?: T) => ({\r\n\tsuccess: true,\r\n\tmessage,\r\n\tdata,\r\n});\r\n"]}
+{"version":3,"file":"response.js","sourceRoot":"/","sources":["utilities/response.ts"],"names":[],"mappings":";;;AAAO,MAAM,QAAQ,GAAG,CAAI,OAAe,EAAE,IAAQ,EAAE,EAAE,CAAC,CAAC;IAC1D,OAAO,EAAE,IAAI;IACb,OAAO;IACP,IAAI;CACJ,CAAC,CAAC;AAJU,QAAA,QAAQ,YAIlB","sourcesContent":["export const response = <T>(message: string, data?: T) => ({\n\tsuccess: true,\n\tmessage,\n\tdata,\n});\n"]}

package/dist/utilities/search.js.map

@@ -1 +1 @@
-{"version":3,"file":"search.js","sourceRoot":"/","sources":["utilities/search.ts"],"names":[],"mappings":";;AAqBA,4CAYC;AAZD,SAAgB,gBAAgB,CAAC,SAAiB,EAAE,MAAgB;IACnE,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC;IAElC,MAAM,WAAW,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAEhF,OAAO;QACN,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC9B,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBACzB,CAAC,KAAK,CAAC,EAAE,IAAI,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC;aAC9B,CAAC,CAAC;SACH,CAAC,CAAC;KACH,CAAC;AACH,CAAC","sourcesContent":["/**\r\n * Builds a MongoDB/Mongoose search query that searches across multiple fields\r\n *\r\n * @param searchKey - The search string to parse (space or comma separated terms)\r\n * @param fields - Array of field names to search against (default: ['name', 'email', 'phoneNumber'])\r\n * @returns A MongoDB query object that requires ALL terms to match in ANY of the specified fields\r\n *\r\n * @example\r\n * // Basic usage\r\n * const query = buildSearchQuery('john doe');\r\n * // Returns: {\r\n * //   $and: [\r\n * //     { $or: [{ name: /john/i }, { email: /john/i }, { phoneNumber: /john/i }] },\r\n * //     { $or: [{ name: /doe/i }, { email: /doe/i }, { phoneNumber: /doe/i }] }\r\n * //   ]\r\n * // }\r\n *\r\n * @example\r\n * // Custom fields\r\n * const query = buildSearchQuery('example', ['name', 'email']);\r\n */\r\nexport function buildSearchQuery(searchKey: string, fields: string[]): Record<string, any> {\r\n\tif (!searchKey?.trim()) return {};\r\n\r\n\tconst searchTerms = searchKey.split(/[ ,]+/).filter(term => term.trim() !== '');\r\n\r\n\treturn {\r\n\t\t$and: searchTerms.map(term => ({\r\n\t\t\t$or: fields.map(field => ({\r\n\t\t\t\t[field]: new RegExp(term, 'i'),\r\n\t\t\t})),\r\n\t\t})),\r\n\t};\r\n}\r\n"]}
+{"version":3,"file":"search.js","sourceRoot":"/","sources":["utilities/search.ts"],"names":[],"mappings":";;AAqBA,4CAYC;AAZD,SAAgB,gBAAgB,CAAC,SAAiB,EAAE,MAAgB;IACnE,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC;IAElC,MAAM,WAAW,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAEhF,OAAO;QACN,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC9B,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBACzB,CAAC,KAAK,CAAC,EAAE,IAAI,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC;aAC9B,CAAC,CAAC;SACH,CAAC,CAAC;KACH,CAAC;AACH,CAAC","sourcesContent":["/**\n * Builds a MongoDB/Mongoose search query that searches across multiple fields\n *\n * @param searchKey - The search string to parse (space or comma separated terms)\n * @param fields - Array of field names to search against (default: ['name', 'email', 'phoneNumber'])\n * @returns A MongoDB query object that requires ALL terms to match in ANY of the specified fields\n *\n * @example\n * // Basic usage\n * const query = buildSearchQuery('john doe');\n * // Returns: {\n * //   $and: [\n * //     { $or: [{ name: /john/i }, { email: /john/i }, { phoneNumber: /john/i }] },\n * //     { $or: [{ name: /doe/i }, { email: /doe/i }, { phoneNumber: /doe/i }] }\n * //   ]\n * // }\n *\n * @example\n * // Custom fields\n * const query = buildSearchQuery('example', ['name', 'email']);\n */\nexport function buildSearchQuery(searchKey: string, fields: string[]): Record<string, any> {\n\tif (!searchKey?.trim()) return {};\n\n\tconst searchTerms = searchKey.split(/[ ,]+/).filter(term => term.trim() !== '');\n\n\treturn {\n\t\t$and: searchTerms.map(term => ({\n\t\t\t$or: fields.map(field => ({\n\t\t\t\t[field]: new RegExp(term, 'i'),\n\t\t\t})),\n\t\t})),\n\t};\n}\n"]}

package/dist/utilities/sorting.js.map

@@ -1 +1 @@
-{"version":3,"file":"sorting.js","sourceRoot":"/","sources":["utilities/sorting.ts"],"names":[],"mappings":";;;AAQA,MAAa,cAAc;IAClB,KAAK,CAAqB;IAElC,YAAY,KAAyB;QACpC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACpB,CAAC;IAUM,KAAK,CAAC,kBAAkB,CAC9B,IAA2B,EAC3B,eAAsD;QAEtD,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;QAElC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC9C,IAAI,CAAC,MAAM,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACrC,CAAC;QAED,MAAM,WAAW,GAAI,MAAc,CAAC,YAAY,IAAI,CAAC,CAAC;QAEtD,IAAI,WAAW,KAAK,WAAW,EAAE,CAAC;YACjC,OAAO,oCAAoC,CAAC;QAC7C,CAAC;QAGD,MAAM,UAAU,GACf,WAAW,GAAG,WAAW;YACxB,CAAC,CAAC,EAAE,YAAY,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE;YAC3D,CAAC,CAAC,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,WAAW,EAAE,EAAE,CAAC;QAG9D,MAAM,aAAa,GAAG,eAAe,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACtD,MAAM,UAAU,GAAG,EAAE,GAAG,UAAU,EAAE,GAAG,aAAa,EAAE,CAAC;QAEvD,MAAM,SAAS,GAAG,WAAW,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAErD,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;QAE9E,MAAc,CAAC,YAAY,GAAG,WAAW,CAAC;QAC3C,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QAEpB,OAAO,6BAA6B,CAAC;IACtC,CAAC;CACD;AAnDD,wCAmDC","sourcesContent":["import { ReturnModelType } from '@typegoose/typegoose';\r\nimport { UpdateSortingOrderDTO } from './validation';\r\nimport { AnyParamConstructor } from '@typegoose/typegoose/lib/types';\r\n\r\n/**\r\n * Generic sorting order manager that updates `sortingOrder` field\r\n * in any Typegoose-based model.\r\n */\r\nexport class SortingService<T extends AnyParamConstructor<any>> {\r\n\tprivate model: ReturnModelType<T>;\r\n\r\n\tconstructor(model: ReturnModelType<T>) {\r\n\t\tthis.model = model;\r\n\t}\r\n\r\n\t/**\r\n\t * Updates sorting order of a record and adjusts others accordingly.\r\n\t * Supports an optional filter function to scope the sorting update.\r\n\t *\r\n\t * @param data - The DTO containing _id and newPosition\r\n\t * @param getQueryFilters - Optional function to generate filters for scoped updates\r\n\t * @returns Status message\r\n\t */\r\n\tpublic async updateSortingOrder(\r\n\t\tdata: UpdateSortingOrderDTO,\r\n\t\tgetQueryFilters?: (record: any) => Record<string, any>\r\n\t): Promise<string> {\r\n\t\tconst { _id, newPosition } = data;\r\n\r\n\t\tconst record = await this.model.findById(_id);\r\n\t\tif (!record) {\r\n\t\t\tthrow new Error('Record not found');\r\n\t\t}\r\n\r\n\t\tconst oldPosition = (record as any).sortingOrder ?? 0;\r\n\r\n\t\tif (newPosition === oldPosition) {\r\n\t\t\treturn 'Record already in desired position';\r\n\t\t}\r\n\r\n\t\t// Base sorting range query\r\n\t\tconst rangeQuery =\r\n\t\t\tnewPosition > oldPosition\r\n\t\t\t\t? { sortingOrder: { $gt: oldPosition, $lte: newPosition } }\r\n\t\t\t\t: { sortingOrder: { $gte: newPosition, $lt: oldPosition } };\r\n\r\n\t\t// Apply dynamic filters if provided\r\n\t\tconst customFilters = getQueryFilters?.(record) ?? {};\r\n\t\tconst finalQuery = { ...rangeQuery, ...customFilters };\r\n\r\n\t\tconst direction = newPosition > oldPosition ? -1 : 1;\r\n\r\n\t\tawait this.model.updateMany(finalQuery, { $inc: { sortingOrder: direction } });\r\n\r\n\t\t(record as any).sortingOrder = newPosition;\r\n\t\tawait record.save();\r\n\r\n\t\treturn 'Record updated successfully';\r\n\t}\r\n}\r\n"]}
+{"version":3,"file":"sorting.js","sourceRoot":"/","sources":["utilities/sorting.ts"],"names":[],"mappings":";;;AAQA,MAAa,cAAc;IAClB,KAAK,CAAqB;IAElC,YAAY,KAAyB;QACpC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACpB,CAAC;IAUM,KAAK,CAAC,kBAAkB,CAC9B,IAA2B,EAC3B,eAAsD;QAEtD,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;QAElC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC9C,IAAI,CAAC,MAAM,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACrC,CAAC;QAED,MAAM,WAAW,GAAI,MAAc,CAAC,YAAY,IAAI,CAAC,CAAC;QAEtD,IAAI,WAAW,KAAK,WAAW,EAAE,CAAC;YACjC,OAAO,oCAAoC,CAAC;QAC7C,CAAC;QAGD,MAAM,UAAU,GACf,WAAW,GAAG,WAAW;YACxB,CAAC,CAAC,EAAE,YAAY,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE;YAC3D,CAAC,CAAC,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,WAAW,EAAE,EAAE,CAAC;QAG9D,MAAM,aAAa,GAAG,eAAe,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACtD,MAAM,UAAU,GAAG,EAAE,GAAG,UAAU,EAAE,GAAG,aAAa,EAAE,CAAC;QAEvD,MAAM,SAAS,GAAG,WAAW,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAErD,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;QAE9E,MAAc,CAAC,YAAY,GAAG,WAAW,CAAC;QAC3C,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QAEpB,OAAO,6BAA6B,CAAC;IACtC,CAAC;CACD;AAnDD,wCAmDC","sourcesContent":["import { ReturnModelType } from '@typegoose/typegoose';\nimport { UpdateSortingOrderDTO } from './validation';\nimport { AnyParamConstructor } from '@typegoose/typegoose/lib/types';\n\n/**\n * Generic sorting order manager that updates `sortingOrder` field\n * in any Typegoose-based model.\n */\nexport class SortingService<T extends AnyParamConstructor<any>> {\n\tprivate model: ReturnModelType<T>;\n\n\tconstructor(model: ReturnModelType<T>) {\n\t\tthis.model = model;\n\t}\n\n\t/**\n\t * Updates sorting order of a record and adjusts others accordingly.\n\t * Supports an optional filter function to scope the sorting update.\n\t *\n\t * @param data - The DTO containing _id and newPosition\n\t * @param getQueryFilters - Optional function to generate filters for scoped updates\n\t * @returns Status message\n\t */\n\tpublic async updateSortingOrder(\n\t\tdata: UpdateSortingOrderDTO,\n\t\tgetQueryFilters?: (record: any) => Record<string, any>\n\t): Promise<string> {\n\t\tconst { _id, newPosition } = data;\n\n\t\tconst record = await this.model.findById(_id);\n\t\tif (!record) {\n\t\t\tthrow new Error('Record not found');\n\t\t}\n\n\t\tconst oldPosition = (record as any).sortingOrder ?? 0;\n\n\t\tif (newPosition === oldPosition) {\n\t\t\treturn 'Record already in desired position';\n\t\t}\n\n\t\t// Base sorting range query\n\t\tconst rangeQuery =\n\t\t\tnewPosition > oldPosition\n\t\t\t\t? { sortingOrder: { $gt: oldPosition, $lte: newPosition } }\n\t\t\t\t: { sortingOrder: { $gte: newPosition, $lt: oldPosition } };\n\n\t\t// Apply dynamic filters if provided\n\t\tconst customFilters = getQueryFilters?.(record) ?? {};\n\t\tconst finalQuery = { ...rangeQuery, ...customFilters };\n\n\t\tconst direction = newPosition > oldPosition ? -1 : 1;\n\n\t\tawait this.model.updateMany(finalQuery, { $inc: { sortingOrder: direction } });\n\n\t\t(record as any).sortingOrder = newPosition;\n\t\tawait record.save();\n\n\t\treturn 'Record updated successfully';\n\t}\n}\n"]}

package/dist/utilities/transformers.js.map

@@ -1 +1 @@
-{"version":3,"file":"transformers.js","sourceRoot":"/","sources":["utilities/transformers.ts"],"names":[],"mappings":"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","sourcesContent":["import { DocumentType } from '@typegoose/typegoose';\r\nimport Container, { Service } from 'typedi';\r\nimport { z } from 'zod';\r\n\r\n/**\r\n * Type definition for pagination metadata\r\n */\r\ntype Metadata = {\r\n\tpage: number;\r\n\tsize: number;\r\n\ttotalElements: number;\r\n\ttotalPages: number;\r\n};\r\n\r\n/**\r\n * Type definition for paginated response\r\n */\r\ntype PaginatedResponse<T> = {\r\n\tmetadata?: Metadata;\r\n\tdocuments: T[];\r\n};\r\n\r\n/**\r\n * GlobalTransformer provides a reusable way to transform Mongoose documents\r\n * into DTOs using Zod schemas for validation and type safety.\r\n *\r\n * @template ModelType - The Mongoose model type\r\n * @template DTOType - The output DTO type\r\n */\r\n@Service()\r\nexport class GlobalTransformer<ModelType, DTOType> {\r\n\t/**\r\n\t * Creates a new GlobalTransformer\r\n\t *\r\n\t * @param {z.ZodType<any>} schema - Zod schema used for validation and transformation\r\n\t */\r\n\tconstructor(private schema: z.ZodType<any>) {}\r\n\r\n\t/**\r\n\t * Transforms a single document to a DTO\r\n\t *\r\n\t * @param {DocumentType<ModelType>} record - The document to transform\r\n\t * @returns {DTOType} The transformed DTO\r\n\t * @throws {Error} When record is not found\r\n\t */\r\n\tpublic transformToBasicView(record: DocumentType<ModelType> | DTOType): DTOType {\r\n\t\tif (!record) {\r\n\t\t\tthrow new Error('Record not found');\r\n\t\t}\r\n\r\n\t\treturn this.schema.parse(record) as DTOType;\r\n\t}\r\n\r\n\t/**\r\n\t * Transforms an array of documents or a paginated response to a paginated DTO response\r\n\t *\r\n\t * @param {DocumentType<ModelType>[] | DTOType[] | PaginatedResponse<DocumentType<ModelType>> | PaginatedResponse<DTOType>} records - Records to transform\r\n\t * @returns {PaginatedResponse<DTOType>} Paginated response with transformed DTOs\r\n\t * @throws {Error} When input type is invalid\r\n\t */\r\n\tpublic transformToBasicViewArray<T extends DocumentType<ModelType> | DTOType>(\r\n\t\trecords: T[] | PaginatedResponse<T>\r\n\t): PaginatedResponse<DTOType> {\r\n\t\t// Case 1: If records is already in the paginated format\r\n\t\tif (records && typeof records === 'object' && 'metadata' in records && 'documents' in records) {\r\n\t\t\tconst paginatedRecords = records as\r\n\t\t\t\t| PaginatedResponse<DocumentType<ModelType>>\r\n\t\t\t\t| PaginatedResponse<DTOType>;\r\n\r\n\t\t\t// Process the documents array\r\n\t\t\tconst processedDocuments = Array.isArray(paginatedRecords.documents)\r\n\t\t\t\t? paginatedRecords.documents.map(doc => this.transformToBasicView(doc))\r\n\t\t\t\t: [];\r\n\r\n\t\t\t// Return the entire paginated structure\r\n\t\t\treturn {\r\n\t\t\t\tmetadata: paginatedRecords.metadata,\r\n\t\t\t\tdocuments: processedDocuments,\r\n\t\t\t};\r\n\t\t}\r\n\r\n\t\t// Case 2: If records is an array\r\n\t\tif (Array.isArray(records)) {\r\n\t\t\tif (records.length === 0) {\r\n\t\t\t\treturn {\r\n\t\t\t\t\tdocuments: [],\r\n\t\t\t\t};\r\n\t\t\t}\r\n\r\n\t\t\tconst transformedRecords = records.map(record => this.transformToBasicView(record));\r\n\r\n\t\t\t// Return in paginated format with default metadata\r\n\t\t\treturn {\r\n\t\t\t\tdocuments: transformedRecords,\r\n\t\t\t};\r\n\t\t}\r\n\r\n\t\t// Fallback for unexpected input\r\n\t\tthrow new Error('Invalid input type for transformToBasicViewArray');\r\n\t}\r\n\r\n\t/**r\r\n\t * Creates a partial view with only the specified fields\r\n\t *\r\n\t * @param {DocumentType<ModelType>} record - The document to transform\r\n\t * @param {(keyof DTOType)[]} fields - Fields to include in the output\r\n\t * @returns {Partial<DTOType>} Partial DTO with only the specified fields\r\n\t */\r\n\tpublic transformToPartialView(\r\n\t\trecord: DocumentType<ModelType>,\r\n\t\tfields: (keyof DTOType)[]\r\n\t): Partial<DTOType> {\r\n\t\tconst fullView = this.transformToBasicView(record);\r\n\t\tconst partialView: Partial<DTOType> = {};\r\n\r\n\t\tfields.forEach(field => {\r\n\t\t\tconst dto = fullView as Record<keyof DTOType, any>;\r\n\t\t\tpartialView[field] = dto[field];\r\n\t\t});\r\n\r\n\t\treturn partialView;\r\n\t}\r\n\r\n\t/**\r\n\t * Creates partial views for an array of documents\r\n\t *\r\n\t * @param {DocumentType<ModelType>[]} records - Array of documents to transform\r\n\t * @param {(keyof DTOType)[]} fields - Fields to include in the output\r\n\t * @returns {Partial<DTOType>[]} Array of partial DTOs\r\n\t */\r\n\tpublic transformToPartialViewArray(\r\n\t\trecords: DocumentType<ModelType>[] | PaginatedResponse<DocumentType<ModelType>>,\r\n\t\tfields: (keyof DTOType)[]\r\n\t): Partial<DTOType>[] | PaginatedResponse<Partial<DTOType>> {\r\n\t\t// Case 1: If records is already in the paginated format\r\n\t\tif (records && typeof records === 'object' && 'metadata' in records && 'documents' in records) {\r\n\t\t\tconst paginatedRecords = records as PaginatedResponse<DocumentType<ModelType>>;\r\n\r\n\t\t\t// Process the documents array\r\n\t\t\tconst processedDocuments = Array.isArray(paginatedRecords.documents)\r\n\t\t\t\t? paginatedRecords.documents.map(doc => this.transformToPartialView(doc, fields))\r\n\t\t\t\t: [];\r\n\r\n\t\t\t// Return the entire paginated structure\r\n\t\t\treturn {\r\n\t\t\t\tmetadata: paginatedRecords.metadata,\r\n\t\t\t\tdocuments: processedDocuments,\r\n\t\t\t};\r\n\t\t}\r\n\r\n\t\t// Case 2: If records is an array\r\n\t\tif (Array.isArray(records)) {\r\n\t\t\tif (records.length === 0) {\r\n\t\t\t\treturn [];\r\n\t\t\t}\r\n\t\t\treturn records.map(record => this.transformToPartialView(record, fields));\r\n\t\t}\r\n\r\n\t\t// Fallback for unexpected input\r\n\t\tthrow new Error('Invalid input type for transformToPartialViewArray');\r\n\t}\r\n\t/**\r\n\t * Transforms a document and adds additional computed fields\r\n\t *\r\n\t * @param {DocumentType<ModelType>} record - The document to transform\r\n\t * @param {Partial<Record<string, any>>} additionalData - Additional fields to add\r\n\t * @returns {DTOType & Record<string, any>} DTO with additional fields\r\n\t */\r\n\tpublic transformWithAdditionalData(\r\n\t\trecord: DocumentType<ModelType>,\r\n\t\tadditionalData: Partial<Record<string, any>>\r\n\t): DTOType & Record<string, any> {\r\n\t\tconst basicView = this.transformToBasicView(record);\r\n\t\treturn { ...basicView, ...additionalData };\r\n\t}\r\n\r\n\t/**\r\n\t * Transforms a document using a custom mapping function\r\n\t *\r\n\t * @template OutputType - The output type after mapping\r\n\t * @param {DocumentType<ModelType>} record - The document to transform\r\n\t * @param {(input: DTOType) => OutputType} mapFn - Mapping function for custom transformation\r\n\t * @returns {OutputType} Custom transformed output\r\n\t */\r\n\tpublic transformWithMapping<OutputType = DTOType>(\r\n\t\trecord: DocumentType<ModelType>,\r\n\t\tmapFn: (input: DTOType) => OutputType\r\n\t): OutputType {\r\n\t\tconst basicView = this.transformToBasicView(record);\r\n\t\treturn mapFn(basicView);\r\n\t}\r\n\r\n\t/**\r\n\t * Transforms a nested property of the document\r\n\t *\r\n\t * @template NestedType - The type of the nested property\r\n\t * @param {DocumentType<ModelType>} record - The document to transform\r\n\t * @param {string} path - Dot-notation path to the nested property\r\n\t * @param {z.ZodType<any>} nestedSchema - Zod schema for the nested property\r\n\t * @returns {NestedType} The transformed nested property\r\n\t * @throws {Error} When path is not found in record\r\n\t */\r\n\tpublic transformNestedProperty<NestedType>(\r\n\t\trecord: DocumentType<ModelType>,\r\n\t\tpath: string,\r\n\t\tnestedSchema: z.ZodType<any>\r\n\t): NestedType {\r\n\t\tif (!record) {\r\n\t\t\tthrow new Error('Record not found');\r\n\t\t}\r\n\r\n\t\tconst parts = path.split('.');\r\n\t\tlet current: any = record;\r\n\r\n\t\tfor (const part of parts) {\r\n\t\t\tif (current && part in current) {\r\n\t\t\t\tcurrent = current[part];\r\n\t\t\t} else {\r\n\t\t\t\tthrow new Error(`Path ${path} not found in record`);\r\n\t\t\t}\r\n\t\t}\r\n\r\n\t\treturn nestedSchema.parse(current) as NestedType;\r\n\t}\r\n\r\n\t/**\r\n\t * Transforms a document with default values for missing fields\r\n\t *\r\n\t * @param {DocumentType<ModelType>} record - The document to transform\r\n\t * @param {Partial<DTOType>} defaults - Default values for fields\r\n\t * @returns {DTOType} DTO with defaults applied\r\n\t */\r\n\tpublic transformWithDefaults(record: DocumentType<ModelType>, defaults: Partial<DTOType>): DTOType {\r\n\t\tconst transformed = this.transformToBasicView(record);\r\n\t\treturn { ...defaults, ...transformed };\r\n\t}\r\n}\r\n\r\n/**\r\n * Creates a transformer instance for the given schema.\r\n * Uses dependency injection if available, falls back to creating a new instance.\r\n *\r\n * @template ModelType - The Mongoose model type\r\n * @template DTOType - The output DTO type\r\n * @param {z.ZodType<any>} schema - Zod schema for validation and transformation\r\n * @returns {GlobalTransformer<ModelType, DTOType>} Instance of GlobalTransformer\r\n */\r\nexport function createTransformer<ModelType, DTOType>(\r\n\tschema: z.ZodType<any>\r\n): GlobalTransformer<ModelType, DTOType> {\r\n\ttry {\r\n\t\treturn Container.get(GlobalTransformer) as GlobalTransformer<ModelType, DTOType>;\r\n\t} catch (error) {\r\n\t\treturn new GlobalTransformer<ModelType, DTOType>(schema);\r\n\t}\r\n}\r\n"]}
+{"version":3,"file":"transformers.js","sourceRoot":"/","sources":["utilities/transformers.ts"],"names":[],"mappings":"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","sourcesContent":["import { DocumentType } from '@typegoose/typegoose';\nimport Container, { Service } from 'typedi';\nimport { z } from 'zod';\n\n/**\n * Type definition for pagination metadata\n */\ntype Metadata = {\n\tpage: number;\n\tsize: number;\n\ttotalElements: number;\n\ttotalPages: number;\n};\n\n/**\n * Type definition for paginated response\n */\ntype PaginatedResponse<T> = {\n\tmetadata?: Metadata;\n\tdocuments: T[];\n};\n\n/**\n * GlobalTransformer provides a reusable way to transform Mongoose documents\n * into DTOs using Zod schemas for validation and type safety.\n *\n * @template ModelType - The Mongoose model type\n * @template DTOType - The output DTO type\n */\n@Service()\nexport class GlobalTransformer<ModelType, DTOType> {\n\t/**\n\t * Creates a new GlobalTransformer\n\t *\n\t * @param {z.ZodType<any>} schema - Zod schema used for validation and transformation\n\t */\n\tconstructor(private schema: z.ZodType<any>) {}\n\n\t/**\n\t * Transforms a single document to a DTO\n\t *\n\t * @param {DocumentType<ModelType>} record - The document to transform\n\t * @returns {DTOType} The transformed DTO\n\t * @throws {Error} When record is not found\n\t */\n\tpublic transformToBasicView(record: DocumentType<ModelType> | DTOType): DTOType {\n\t\tif (!record) {\n\t\t\tthrow new Error('Record not found');\n\t\t}\n\n\t\treturn this.schema.parse(record) as DTOType;\n\t}\n\n\t/**\n\t * Transforms an array of documents or a paginated response to a paginated DTO response\n\t *\n\t * @param {DocumentType<ModelType>[] | DTOType[] | PaginatedResponse<DocumentType<ModelType>> | PaginatedResponse<DTOType>} records - Records to transform\n\t * @returns {PaginatedResponse<DTOType>} Paginated response with transformed DTOs\n\t * @throws {Error} When input type is invalid\n\t */\n\tpublic transformToBasicViewArray<T extends DocumentType<ModelType> | DTOType>(\n\t\trecords: T[] | PaginatedResponse<T>\n\t): PaginatedResponse<DTOType> {\n\t\t// Case 1: If records is already in the paginated format\n\t\tif (records && typeof records === 'object' && 'metadata' in records && 'documents' in records) {\n\t\t\tconst paginatedRecords = records as\n\t\t\t\t| PaginatedResponse<DocumentType<ModelType>>\n\t\t\t\t| PaginatedResponse<DTOType>;\n\n\t\t\t// Process the documents array\n\t\t\tconst processedDocuments = Array.isArray(paginatedRecords.documents)\n\t\t\t\t? paginatedRecords.documents.map(doc => this.transformToBasicView(doc))\n\t\t\t\t: [];\n\n\t\t\t// Return the entire paginated structure\n\t\t\treturn {\n\t\t\t\tmetadata: paginatedRecords.metadata,\n\t\t\t\tdocuments: processedDocuments,\n\t\t\t};\n\t\t}\n\n\t\t// Case 2: If records is an array\n\t\tif (Array.isArray(records)) {\n\t\t\tif (records.length === 0) {\n\t\t\t\treturn {\n\t\t\t\t\tdocuments: [],\n\t\t\t\t};\n\t\t\t}\n\n\t\t\tconst transformedRecords = records.map(record => this.transformToBasicView(record));\n\n\t\t\t// Return in paginated format with default metadata\n\t\t\treturn {\n\t\t\t\tdocuments: transformedRecords,\n\t\t\t};\n\t\t}\n\n\t\t// Fallback for unexpected input\n\t\tthrow new Error('Invalid input type for transformToBasicViewArray');\n\t}\n\n\t/**r\n\t * Creates a partial view with only the specified fields\n\t *\n\t * @param {DocumentType<ModelType>} record - The document to transform\n\t * @param {(keyof DTOType)[]} fields - Fields to include in the output\n\t * @returns {Partial<DTOType>} Partial DTO with only the specified fields\n\t */\n\tpublic transformToPartialView(\n\t\trecord: DocumentType<ModelType>,\n\t\tfields: (keyof DTOType)[]\n\t): Partial<DTOType> {\n\t\tconst fullView = this.transformToBasicView(record);\n\t\tconst partialView: Partial<DTOType> = {};\n\n\t\tfields.forEach(field => {\n\t\t\tconst dto = fullView as Record<keyof DTOType, any>;\n\t\t\tpartialView[field] = dto[field];\n\t\t});\n\n\t\treturn partialView;\n\t}\n\n\t/**\n\t * Creates partial views for an array of documents\n\t *\n\t * @param {DocumentType<ModelType>[]} records - Array of documents to transform\n\t * @param {(keyof DTOType)[]} fields - Fields to include in the output\n\t * @returns {Partial<DTOType>[]} Array of partial DTOs\n\t */\n\tpublic transformToPartialViewArray(\n\t\trecords: DocumentType<ModelType>[] | PaginatedResponse<DocumentType<ModelType>>,\n\t\tfields: (keyof DTOType)[]\n\t): Partial<DTOType>[] | PaginatedResponse<Partial<DTOType>> {\n\t\t// Case 1: If records is already in the paginated format\n\t\tif (records && typeof records === 'object' && 'metadata' in records && 'documents' in records) {\n\t\t\tconst paginatedRecords = records as PaginatedResponse<DocumentType<ModelType>>;\n\n\t\t\t// Process the documents array\n\t\t\tconst processedDocuments = Array.isArray(paginatedRecords.documents)\n\t\t\t\t? paginatedRecords.documents.map(doc => this.transformToPartialView(doc, fields))\n\t\t\t\t: [];\n\n\t\t\t// Return the entire paginated structure\n\t\t\treturn {\n\t\t\t\tmetadata: paginatedRecords.metadata,\n\t\t\t\tdocuments: processedDocuments,\n\t\t\t};\n\t\t}\n\n\t\t// Case 2: If records is an array\n\t\tif (Array.isArray(records)) {\n\t\t\tif (records.length === 0) {\n\t\t\t\treturn [];\n\t\t\t}\n\t\t\treturn records.map(record => this.transformToPartialView(record, fields));\n\t\t}\n\n\t\t// Fallback for unexpected input\n\t\tthrow new Error('Invalid input type for transformToPartialViewArray');\n\t}\n\t/**\n\t * Transforms a document and adds additional computed fields\n\t *\n\t * @param {DocumentType<ModelType>} record - The document to transform\n\t * @param {Partial<Record<string, any>>} additionalData - Additional fields to add\n\t * @returns {DTOType & Record<string, any>} DTO with additional fields\n\t */\n\tpublic transformWithAdditionalData(\n\t\trecord: DocumentType<ModelType>,\n\t\tadditionalData: Partial<Record<string, any>>\n\t): DTOType & Record<string, any> {\n\t\tconst basicView = this.transformToBasicView(record);\n\t\treturn { ...basicView, ...additionalData };\n\t}\n\n\t/**\n\t * Transforms a document using a custom mapping function\n\t *\n\t * @template OutputType - The output type after mapping\n\t * @param {DocumentType<ModelType>} record - The document to transform\n\t * @param {(input: DTOType) => OutputType} mapFn - Mapping function for custom transformation\n\t * @returns {OutputType} Custom transformed output\n\t */\n\tpublic transformWithMapping<OutputType = DTOType>(\n\t\trecord: DocumentType<ModelType>,\n\t\tmapFn: (input: DTOType) => OutputType\n\t): OutputType {\n\t\tconst basicView = this.transformToBasicView(record);\n\t\treturn mapFn(basicView);\n\t}\n\n\t/**\n\t * Transforms a nested property of the document\n\t *\n\t * @template NestedType - The type of the nested property\n\t * @param {DocumentType<ModelType>} record - The document to transform\n\t * @param {string} path - Dot-notation path to the nested property\n\t * @param {z.ZodType<any>} nestedSchema - Zod schema for the nested property\n\t * @returns {NestedType} The transformed nested property\n\t * @throws {Error} When path is not found in record\n\t */\n\tpublic transformNestedProperty<NestedType>(\n\t\trecord: DocumentType<ModelType>,\n\t\tpath: string,\n\t\tnestedSchema: z.ZodType<any>\n\t): NestedType {\n\t\tif (!record) {\n\t\t\tthrow new Error('Record not found');\n\t\t}\n\n\t\tconst parts = path.split('.');\n\t\tlet current: any = record;\n\n\t\tfor (const part of parts) {\n\t\t\tif (current && part in current) {\n\t\t\t\tcurrent = current[part];\n\t\t\t} else {\n\t\t\t\tthrow new Error(`Path ${path} not found in record`);\n\t\t\t}\n\t\t}\n\n\t\treturn nestedSchema.parse(current) as NestedType;\n\t}\n\n\t/**\n\t * Transforms a document with default values for missing fields\n\t *\n\t * @param {DocumentType<ModelType>} record - The document to transform\n\t * @param {Partial<DTOType>} defaults - Default values for fields\n\t * @returns {DTOType} DTO with defaults applied\n\t */\n\tpublic transformWithDefaults(record: DocumentType<ModelType>, defaults: Partial<DTOType>): DTOType {\n\t\tconst transformed = this.transformToBasicView(record);\n\t\treturn { ...defaults, ...transformed };\n\t}\n}\n\n/**\n * Creates a transformer instance for the given schema.\n * Uses dependency injection if available, falls back to creating a new instance.\n *\n * @template ModelType - The Mongoose model type\n * @template DTOType - The output DTO type\n * @param {z.ZodType<any>} schema - Zod schema for validation and transformation\n * @returns {GlobalTransformer<ModelType, DTOType>} Instance of GlobalTransformer\n */\nexport function createTransformer<ModelType, DTOType>(\n\tschema: z.ZodType<any>\n): GlobalTransformer<ModelType, DTOType> {\n\ttry {\n\t\treturn Container.get(GlobalTransformer) as GlobalTransformer<ModelType, DTOType>;\n\t} catch (error) {\n\t\treturn new GlobalTransformer<ModelType, DTOType>(schema);\n\t}\n}\n"]}