@solidstarters/solid-core 1.2.163 → 1.2.166

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solidstarters/solid-core",
-  "version": "1.2.163",
+  "version": "1.2.166",
   "description": "This module is a NestJS module containing all the required core providers required by a Solid application",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/controllers/test-queue.controller.ts

@@ -18,14 +18,15 @@ export class TestQueueController {
     ) { }
 
     @Public()
-    @Get(':messageBroker')
-    async getHello(@Param('messageBroker') messageBroker: string) {
+    @Get(':messageBroker/:timeoutSeconds')
+    async getHello(@Param('messageBroker') messageBroker: string, @Param('timeoutSeconds') timeoutSeconds: number) {
         const pubsubMessage = 'A hopping-good time!';
         const m = {
             payload: {
                 firstName: 'Harish',
                 lastName: 'Patel',
-                age: 40
+                age: 40,
+                timeoutSeconds: timeoutSeconds
             },
             parentEntity: 'feeType',
             parentEntityId: 23,

package/src/decorators/error-codes-provider.decorator.ts

@@ -0,0 +1,9 @@
+import 'reflect-metadata';
+
+export const IS_ERROR_CODE_PROVIDER = 'IS_ERROR_CODE_PROVIDER';
+
+export const ErrorCodeProvider = () => {
+    return (target: Function) => {
+        Reflect.defineMetadata(IS_ERROR_CODE_PROVIDER, true, target);
+    };
+};

package/src/entities/security-rule.entity.ts

@@ -8,7 +8,7 @@ export class SecurityRule extends CommonEntity {
     @Index({ unique: true })
     @Column({ type: "varchar" })
     name: string;
-    @Index({ unique: true })
+    // @Index({ unique: true })
     @Column({ type: "varchar" })
     description: string;
     @Index()

package/src/filters/http-exception.filter.ts

@@ -1,39 +1,64 @@
-import { ExceptionFilter, Catch, ArgumentsHost, Logger, Injectable } from '@nestjs/common';
-import { Response } from 'express';
+// src/common/filters/http-exception.filter.ts
+import {
+    ExceptionFilter,
+    Catch,
+    ArgumentsHost,
+    Logger,
+    Injectable,
+    HttpException,
+} from '@nestjs/common';
+import { Response, Request } from 'express';
 import { HttpStatusCodeMessages } from '../interceptors/logging.interceptor';
+import { ErrorMapperService } from 'src/helpers/error-mapper.service';
+import { ErrorCode } from 'src/interfaces';
+
 
 @Catch()
 @Injectable()
 export class HttpExceptionFilter implements ExceptionFilter {
     private readonly logger = new Logger(HttpExceptionFilter.name);
 
-    constructor() {
+    constructor(private readonly errorMapper: ErrorMapperService) {
         this.logger.debug('HttpExceptionFilter initialized');
-    } 
+    }
 
     catch(exception: any, host: ArgumentsHost) {
         const ctx = host.switchToHttp();
         const response = ctx.getResponse<Response>();
-        const request = ctx.getRequest();
-        const status = exception.status || 500;
-        const message = exception.message || 'Internal server error';
-        const { method, url } = request;
-
-        // Log the error here
-        this.logger.error(`[${status || 500} ${HttpStatusCodeMessages[status] || 'Internal Server Error'}] ${method} ${url} - ${message}`);
-        this.logger.error(exception.stack || 'No stack trace available');
-
-        // Send the response to the client
-        const errorJson = this.getErrorJson(status, message, exception.response);
-        response.status(status).json(errorJson);
-    }
+        const request = ctx.getRequest<Request>();
 
-    private getErrorJson(status: number|string, message: string, additionalErrorData: unknown = {}): any {
-        return {
-            statusCode: status,
-            message: [message],
-            error: HttpStatusCodeMessages[status] || 'Internal Server Error',
-            data: additionalErrorData
+        const isHttp = exception instanceof HttpException;
+        const explicitStatus = isHttp ? exception.getStatus() : undefined;
+
+        // Canonical code + static message
+        const code: ErrorCode = this.errorMapper.mapException(exception);
+        const defaultStatus = this.errorMapper.getHttpStatus(code);
+        const message = this.errorMapper.getMessage(code);
+
+        const status = explicitStatus ?? defaultStatus ?? 500;
+
+        // Logging
+        this.logger.error(
+            `[${status} ${HttpStatusCodeMessages[status] || 'Internal Server Error'}] ${request?.method} ${request?.url} - ${exception?.message || message} [code=${code}]`,
+        );
+        if (exception?.stack) {
+            this.logger.error(exception.stack);
         }
+
+        // Preserve any extra data the exception carried (optional)
+        const extra =
+            (isHttp && (exception.getResponse?.() as any)) ??
+            exception?.response ??
+            {};
+
+        // Keep your legacy shape; add canonical code
+        response.status(status).json({
+            statusCode: status,
+            statusCodeMessage: HttpStatusCodeMessages[status] || 'Internal Server Error',
+            // message: [message],
+            errorCode: code,
+            error: message,
+            data: extra,
+        });
     }
 }

package/src/helpers/error-mapper.service.ts

@@ -1,214 +1,155 @@
-// src/common/errors/error-mapper.service.ts
-import { Injectable } from '@nestjs/common';
-
-export const ERROR_CODES = [
-    'bedrock-throttling-error',
-    'bedrock-access-denied',
-    'bedrock-input-too-long',
-    'bedrock-validation-error',
-    'bedrock-model-not-found',
-    'db-duplicate-key',
-    'db-foreign-key-error',
-    'metadata-extraction-date-parsing-failed',
-    'metadata-extraction-missing-s3-file',
-    'solidx-mcp-server-unavailable',
-    'unknown-error',
-] as const;
-
-export type ErrorCode = typeof ERROR_CODES[number];
+import { Injectable, Logger } from '@nestjs/common';
+import { SolidRegistry } from 'src/helpers/solid-registry';
+import { ErrorCode, ErrorMeta, ErrorRule, IErrorCodeProvider } from 'src/interfaces';
+
+// export const ERROR_CODES = [
+//     'db-duplicate-key',
+//     'db-foreign-key-error',
+//     'solidx-mcp-server-unavailable',
+//     'unknown-error',
+// ] as const;
+
+// export type ErrorCode = typeof ERROR_CODES[number];
+
+// type ErrorMeta = {
+//     message: string;
+//     httpStatus?: number;
+// };
+
+// const ERROR_MESSAGES: Record<ErrorCode, ErrorMeta> = {
+//     'db-duplicate-key': {
+//         message: 'Duplicate key violation. A record with these values already exists.',
+//         httpStatus: 409,
+//     },
+//     'db-foreign-key-error': {
+//         message: 'Foreign key constraint prevents this operation due to related records.',
+//         httpStatus: 409,
+//     },
+//     'solidx-mcp-server-unavailable': {
+//         message: 'SolidX MCP server is unreachable. Please verify the MCP endpoint.',
+//         httpStatus: 503,
+//     },
+//     'unknown-error': {
+//         message: 'An unexpected error occurred.',
+//         httpStatus: 500,
+//     },
+// };
 
 @Injectable()
 export class ErrorMapperService {
-    /**
-     * Given an error/exception, return a mapped error code string.
-     * Default: "unknown-error"
-     */
-    mapException(exc: unknown): ErrorCode {
-        const combined = this.combineErrorText(exc);
+    private readonly logger = new Logger(ErrorMapperService.name);
 
-        // AiInteraction - mcp server down. 
-        // {
-        //     "success": false,
-        //     "errors": [
-        //         "unhandled errors in a TaskGroup (1 sub-exception)"
-        //     ],
-        //     "error_trace": [
-        //         "Traceback (most recent call last):",
-        //         "File \"/Users/harishpatel/.pyenv/versions/3.12.7/envs/solid_mcp_client/lib/python3.12/site-packages/mcp/client/sse.py\", line 47, in sse_client\n    async with aconnect_sse(\n               ^^^^^^^^^^^^^",
-        //         "File \"/Users/harishpatel/.pyenv/versions/3.12.7/lib/python3.12/contextlib.py\", line 210, in __aenter__\n    return await anext(self.gen)\n           ^^^^^^^^^^^^^^^^^^^^^",
-        //         "File \"/Users/harishpatel/.pyenv/versions/3.12.7/envs/solid_mcp_client/lib/python3.12/site-packages/httpx_sse/_api.py\", line 69, in aconnect_sse\n    async with client.stream(method, url, headers=headers, **kwargs) as response:\n               ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^",
-        //         "File \"/Users/harishpatel/.pyenv/versions/3.12.7/lib/python3.12/contextlib.py\", line 210, in __aenter__\n    return await anext(self.gen)\n           ^^^^^^^^^^^^^^^^^^^^^",
-        //         "File \"/Users/harishpatel/.pyenv/versions/3.12.7/envs/solid_mcp_client/lib/python3.12/site-packages/httpx/_client.py\", line 1583, in stream\n    response = await self.send(\n               ^^^^^^^^^^^^^^^^",
-        //         "File \"/Users/harishpatel/.pyenv/versions/3.12.7/envs/solid_mcp_client/lib/python3.12/site-packages/httpx/_client.py\", line 1629, in send\n    response = await self._send_handling_auth(\n               ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^",
-        //         "File \"/Users/harishpatel/.pyenv/versions/3.12.7/envs/solid_mcp_client/lib/python3.12/site-packages/httpx/_client.py\", line 1657, in _send_handling_auth\n    response = await self._send_handling_redirects(\n               ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^",
-        //         "File \"/Users/harishpatel/.pyenv/versions/3.12.7/envs/solid_mcp_client/lib/python3.12/site-packages/httpx/_client.py\", line 1694, in _send_handling_redirects\n    response = await self._send_single_request(request)\n               ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^",
-        //         "File \"/Users/harishpatel/.pyenv/versions/3.12.7/envs/solid_mcp_client/lib/python3.12/site-packages/httpx/_client.py\", line 1730, in _send_single_request\n    response = await transport.handle_async_request(request)\n               ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^",
-        //         "File \"/Users/harishpatel/.pyenv/versions/3.12.7/envs/solid_mcp_client/lib/python3.12/site-packages/httpx/_transports/default.py\", line 393, in handle_async_request\n    with map_httpcore_exceptions():\n         ^^^^^^^^^^^^^^^^^^^^^^^^^",
-        //         "File \"/Users/harishpatel/.pyenv/versions/3.12.7/lib/python3.12/contextlib.py\", line 158, in __exit__\n    self.gen.throw(value)",
-        //         "File \"/Users/harishpatel/.pyenv/versions/3.12.7/envs/solid_mcp_client/lib/python3.12/site-packages/httpx/_transports/default.py\", line 118, in map_httpcore_exceptions\n    raise mapped_exc(message) from exc",
-        //         "httpx.ConnectError: All connection attempts failed",
-        //         "During handling of the above exception, another exception occurred:",
-        //         "+ Exception Group Traceback (most recent call last):",
-        //         "|   File \"/Users/harishpatel/mcp/clients/solidx_mcp_client/client_sse_nochat.py\", line 239, in main\n  |     await client.connect_to_sse_server()",
-        //         "|   File \"/Users/harishpatel/mcp/clients/solidx_mcp_client/client_sse_nochat.py\", line 49, in connect_to_sse_server\n  |     streams = await self._streams_context.__aenter__()\n  |               ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^",
-        //         "|   File \"/Users/harishpatel/.pyenv/versions/3.12.7/lib/python3.12/contextlib.py\", line 210, in __aenter__\n  |     return await anext(self.gen)\n  |            ^^^^^^^^^^^^^^^^^^^^^",
-        //         "|   File \"/Users/harishpatel/.pyenv/versions/3.12.7/envs/solid_mcp_client/lib/python3.12/site-packages/mcp/client/sse.py\", line 43, in sse_client\n  |     async with anyio.create_task_group() as tg:\n  |                ^^^^^^^^^^^^^^^^^^^^^^^^^",
-        //         "|   File \"/Users/harishpatel/.pyenv/versions/3.12.7/envs/solid_mcp_client/lib/python3.12/site-packages/anyio/_backends/_asyncio.py\", line 767, in __aexit__\n  |     raise BaseExceptionGroup(",
-        //         "| ExceptionGroup: unhandled errors in a TaskGroup (1 sub-exception)",
-        //         "+-+---------------- 1 ----------------",
-        //         "| Traceback (most recent call last):",
-        //         "|   File \"/Users/harishpatel/.pyenv/versions/3.12.7/envs/solid_mcp_client/lib/python3.12/site-packages/httpx/_transports/default.py\", line 101, in map_httpcore_exceptions\n    |     yield",
-        //         "|   File \"/Users/harishpatel/.pyenv/versions/3.12.7/envs/solid_mcp_client/lib/python3.12/site-packages/httpx/_transports/default.py\", line 394, in handle_async_request\n    |     resp = await self._pool.handle_async_request(req)\n    |            ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^",
-        //         "|   File \"/Users/harishpatel/.pyenv/versions/3.12.7/envs/solid_mcp_client/lib/python3.12/site-packages/httpcore/_async/connection_pool.py\", line 256, in handle_async_request\n    |     raise exc from None",
-        //         "|   File \"/Users/harishpatel/.pyenv/versions/3.12.7/envs/solid_mcp_client/lib/python3.12/site-packages/httpcore/_async/connection_pool.py\", line 236, in handle_async_request\n    |     response = await connection.handle_async_request(\n    |                ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^",
-        //         "|   File \"/Users/harishpatel/.pyenv/versions/3.12.7/envs/solid_mcp_client/lib/python3.12/site-packages/httpcore/_async/connection.py\", line 101, in handle_async_request\n    |     raise exc",
-        //         "|   File \"/Users/harishpatel/.pyenv/versions/3.12.7/envs/solid_mcp_client/lib/python3.12/site-packages/httpcore/_async/connection.py\", line 78, in handle_async_request\n    |     stream = await self._connect(request)\n    |              ^^^^^^^^^^^^^^^^^^^^^^^^^^^^",
-        //         "|   File \"/Users/harishpatel/.pyenv/versions/3.12.7/envs/solid_mcp_client/lib/python3.12/site-packages/httpcore/_async/connection.py\", line 124, in _connect\n    |     stream = await self._network_backend.connect_tcp(**kwargs)\n    |              ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^",
-        //         "|   File \"/Users/harishpatel/.pyenv/versions/3.12.7/envs/solid_mcp_client/lib/python3.12/site-packages/httpcore/_backends/auto.py\", line 31, in connect_tcp\n    |     return await self._backend.connect_tcp(\n    |            ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^",
-        //         "|   File \"/Users/harishpatel/.pyenv/versions/3.12.7/envs/solid_mcp_client/lib/python3.12/site-packages/httpcore/_backends/anyio.py\", line 113, in connect_tcp\n    |     with map_exceptions(exc_map):\n    |          ^^^^^^^^^^^^^^^^^^^^^^^",
-        //         "|   File \"/Users/harishpatel/.pyenv/versions/3.12.7/lib/python3.12/contextlib.py\", line 158, in __exit__\n    |     self.gen.throw(value)",
-        //         "|   File \"/Users/harishpatel/.pyenv/versions/3.12.7/envs/solid_mcp_client/lib/python3.12/site-packages/httpcore/_exceptions.py\", line 14, in map_exceptions\n    |     raise to_exc(exc) from exc",
-        //         "| httpcore.ConnectError: All connection attempts failed",
-        //         "| \n    | The above exception was the direct cause of the following exception:\n    |",
-        //         "| Traceback (most recent call last):",
-        //         "|   File \"/Users/harishpatel/.pyenv/versions/3.12.7/envs/solid_mcp_client/lib/python3.12/site-packages/mcp/client/sse.py\", line 47, in sse_client\n    |     async with aconnect_sse(\n    |                ^^^^^^^^^^^^^",
-        //         "|   File \"/Users/harishpatel/.pyenv/versions/3.12.7/lib/python3.12/contextlib.py\", line 210, in __aenter__\n    |     return await anext(self.gen)\n    |            ^^^^^^^^^^^^^^^^^^^^^",
-        //         "|   File \"/Users/harishpatel/.pyenv/versions/3.12.7/envs/solid_mcp_client/lib/python3.12/site-packages/httpx_sse/_api.py\", line 69, in aconnect_sse\n    |     async with client.stream(method, url, headers=headers, **kwargs) as response:\n    |                ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^",
-        //         "|   File \"/Users/harishpatel/.pyenv/versions/3.12.7/lib/python3.12/contextlib.py\", line 210, in __aenter__\n    |     return await anext(self.gen)\n    |            ^^^^^^^^^^^^^^^^^^^^^",
-        //         "|   File \"/Users/harishpatel/.pyenv/versions/3.12.7/envs/solid_mcp_client/lib/python3.12/site-packages/httpx/_client.py\", line 1583, in stream\n    |     response = await self.send(\n    |                ^^^^^^^^^^^^^^^^",
-        //         "|   File \"/Users/harishpatel/.pyenv/versions/3.12.7/envs/solid_mcp_client/lib/python3.12/site-packages/httpx/_client.py\", line 1629, in send\n    |     response = await self._send_handling_auth(\n    |                ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^",
-        //         "|   File \"/Users/harishpatel/.pyenv/versions/3.12.7/envs/solid_mcp_client/lib/python3.12/site-packages/httpx/_client.py\", line 1657, in _send_handling_auth\n    |     response = await self._send_handling_redirects(\n    |                ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^",
-        //         "|   File \"/Users/harishpatel/.pyenv/versions/3.12.7/envs/solid_mcp_client/lib/python3.12/site-packages/httpx/_client.py\", line 1694, in _send_handling_redirects\n    |     response = await self._send_single_request(request)\n    |                ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^",
-        //         "|   File \"/Users/harishpatel/.pyenv/versions/3.12.7/envs/solid_mcp_client/lib/python3.12/site-packages/httpx/_client.py\", line 1730, in _send_single_request\n    |     response = await transport.handle_async_request(request)\n    |                ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^",
-        //         "|   File \"/Users/harishpatel/.pyenv/versions/3.12.7/envs/solid_mcp_client/lib/python3.12/site-packages/httpx/_transports/default.py\", line 393, in handle_async_request\n    |     with map_httpcore_exceptions():\n    |          ^^^^^^^^^^^^^^^^^^^^^^^^^",
-        //         "|   File \"/Users/harishpatel/.pyenv/versions/3.12.7/lib/python3.12/contextlib.py\", line 158, in __exit__\n    |     self.gen.throw(value)",
-        //         "|   File \"/Users/harishpatel/.pyenv/versions/3.12.7/envs/solid_mcp_client/lib/python3.12/site-packages/httpx/_transports/default.py\", line 118, in map_httpcore_exceptions\n    |     raise mapped_exc(message) from exc",
-        //         "| httpx.ConnectError: All connection attempts failed",
-        //         "+------------------------------------"
-        //     ],
-        //     "request": "\"Can you do 1 + 1\""
-        // }
-        if (combined.includes("all connection attempts failed") && combined.includes("unhandled errors in a taskgroup (1 sub-exception)")) {
-            return 'solidx-mcp-server-unavailable';
-        }
-
-        // --- Bedrock errors ---
-        // Throttling: "ThrottlingException" or "Too many tokens"
-        if (
-            combined.includes('throttlingexception') ||
-            combined.includes('too many tokens')
-        ) {
-            return 'bedrock-throttling-error';
-        }
+    constructor(private readonly solidRegistry: SolidRegistry) { }
 
-        if (combined.includes('accessdeniedexception')) {
-            return 'bedrock-access-denied';
-        }
-
-        if (
-            combined.includes('validationexception') &&
-            combined.includes('input is too long')
-        ) {
-            return 'bedrock-input-too-long';
-        }
+    /** Map an exception object (or string) to a canonical ErrorCode */
+    mapException(exc: unknown): ErrorCode {
+        const combined = this.combineErrorText(exc);
+        return this.matchCode(combined);
+    }
 
-        if (combined.includes('validationexception')) {
-            return 'bedrock-validation-error';
-        }
+    /** Map plain message/trace to ErrorCode */
+    mapMessage(message: string, trace?: string): ErrorCode {
+        const combined = `${message ?? ''}\n${trace ?? ''}`.toLowerCase();
+        return this.matchCode(combined);
+    }
 
-        if (combined.includes('modelnotfoundexception')) {
-            return 'bedrock-model-not-found';
-        }
+    /** Get static message for a given code */
+    getMessage(code: ErrorCode): string {
+        const meta = this.lookupMeta(code);
+        return (meta ?? { message: 'An unexpected error occurred.' }).message;
+    }
 
-        // --- DB errors ---
-        if (
-            combined.includes('unique constraint') ||
-            combined.includes('duplicate key')
-        ) {
-            return 'db-duplicate-key';
-        }
+    /** Get default HTTP status for a code (falls back to 500) */
+    getHttpStatus(code: ErrorCode): number {
+        const meta = this.lookupMeta(code);
+        return meta?.httpStatus ?? 500;
+    }
 
-        if (combined.includes('foreign key')) {
-            return 'db-foreign-key-error';
+    // ---- internal helpers ----
+    private matchCode(combined: string): ErrorCode {
+        const rules = this.getAllRulesSorted();
+        for (const rule of rules) {
+            try {
+                if (rule.match(combined)) return rule.code;
+            } catch (e) {
+                // Defensive: bad provider shouldn't crash mapping
+                this.logger.warn(`Error rule threw in match(): code=${rule.code} provider? — ${e}`);
+            }
         }
+        return 'unknown-error';
+    }
 
-        // --- OpenSearch errors ---
-        // mapper_parsing_exception on specific fields
-        if (
-            combined.includes('mapper_parsing_exception') &&
-            (combined.includes('failed to parse field [metadata.properties.dates]') ||
-                combined.includes(
-                    'failed to parse field [metadata.properties.date_authored]',
-                ))
-        ) {
-            return 'metadata-extraction-date-parsing-failed';
+    private lookupMeta(code: ErrorCode): ErrorMeta | undefined {
+        // Prefer the first rule with that code
+        const rules = this.getAllRulesSorted();
+        const rule = rules.find((r) => r.code === code);
+        if (rule?.meta) return rule.meta;
+
+        // Optional: ask providers directly if they implement resolve()
+        const providers = this.getProviders();
+        for (const p of providers) {
+            if (p.resolve) {
+                const meta = p.resolve(code);
+                if (meta) return meta;
+            }
         }
+        return undefined;
+    }
 
-        // --- S3 errors ---
-        // NoSuchKey during GetObject
-        if (combined.includes('nosuchkey') && combined.includes('getobject')) {
-            return 'metadata-extraction-missing-s3-file';
+    private getAllRulesSorted(): ReadonlyArray<ErrorRule> {
+        const providers = this.getProviders();
+        const all: ErrorRule[] = [];
+        for (const p of providers) {
+            try {
+                const rules = p.rules() ?? [];
+                // Optional: namespace collision check can be added here if desired
+                all.push(...rules);
+            } catch (e) {
+                this.logger.warn(`ErrorCodeProvider.rules() failed for ${p.name?.()}: ${e}`);
+            }
         }
-
-        // --- Catch-all ---
-        return 'unknown-error';
+        // Sort by priority desc; default 0
+        return all.sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0));
     }
 
-    /**
-     * Same mapping, but takes raw strings instead of an Exception object.
-     */
-    mapMessage(message: string, trace?: string): ErrorCode {
-        const combined = `${message ?? ''}\n${trace ?? ''}`.toLowerCase();
-        return this.mapException(combined);
+    private getProviders(): IErrorCodeProvider[] {
+        // convert InstanceWrapper → instance
+        return this.solidRegistry
+            .getErrorCodeProviders()
+            .map((w) => w.instance)
+            .filter(Boolean) as IErrorCodeProvider[];
     }
 
-    // ---- helpers ----
-
     private combineErrorText(exc: unknown): string {
-        // If caller passed us a pre-lowered string (e.g. from mapMessage), use it
-        if (typeof exc === 'string') {
-            return exc.toLowerCase();
-        }
+        if (typeof exc === 'string') return exc.toLowerCase();
 
-        // Standard Error
         if (exc instanceof Error) {
             const message = exc.message ?? '';
-            // Many libs set .stack to "Error: message\n<stack>"
-            // We still include it in case upstream mutated it.
             const stack = exc.stack ?? '';
             return `${message}\n${stack}`.toLowerCase();
         }
 
-        // Some SDKs throw objects (e.g., { name, message, code, $metadata, ... })
         if (exc && typeof exc === 'object') {
             try {
-                const maybeAny = exc as Record<string, unknown>;
-                const msg =
-                    String(maybeAny.message ?? '') ||
-                    String(maybeAny['Message'] ?? '') ||
-                    '';
-                const name =
-                    String(maybeAny.name ?? '') ||
-                    String(maybeAny['__type'] ?? '') ||
-                    '';
-                const stack = String((maybeAny as any).stack ?? '');
-                // Also fold in a JSON snapshot as a last resort
-                const json = safeJsonStringify(maybeAny);
+                const obj = exc as Record<string, unknown>;
+                const msg = String(obj.message ?? (obj as any)['Message'] ?? '');
+                const name = String(obj.name ?? (obj as any)['__type'] ?? '');
+                const stack = String((obj as any).stack ?? '');
+                const json = this.safeJsonStringify(obj);
                 return `${name}\n${msg}\n${stack}\n${json}`.toLowerCase();
             } catch {
-                // fall through
+                // ignore
             }
         }
 
-        // Fallback
         return String(exc ?? '').toLowerCase();
     }
-}
 
-function safeJsonStringify(obj: unknown): string {
-    try {
-        return JSON.stringify(obj);
-    } catch {
-        return '';
+    private safeJsonStringify(obj: unknown): string {
+        try {
+            return JSON.stringify(obj);
+        } catch {
+            return '';
+        }
     }
 }

package/src/helpers/solid-core-error-codes-provider.service.ts

@@ -0,0 +1,63 @@
+// src/common/errors/providers/solidcore-error-code.provider.ts
+import { Injectable } from '@nestjs/common';
+import { ErrorCodeProvider } from 'src/decorators/error-codes-provider.decorator';
+import { ErrorMeta, ErrorRule, IErrorCodeProvider } from 'src/interfaces';
+
+
+@ErrorCodeProvider()
+@Injectable()
+export class SolidCoreErrorCodesProvider implements IErrorCodeProvider {
+    name(): string {
+        return 'SolidCoreErrorCodeProvider';
+    }
+
+    rules(): ReadonlyArray<ErrorRule> {
+        return [
+            {
+                code: 'solidx-mcp-server-unavailable',
+                priority: 100, // run early
+                match: (txt) =>
+                    txt.includes('all connection attempts failed') &&
+                    txt.includes('unhandled errors in a taskgroup (1 sub-exception)'),
+                meta: {
+                    message: 'SolidX MCP server is unreachable. Please verify the MCP endpoint.',
+                    httpStatus: 503,
+                },
+            },
+            {
+                code: 'db-duplicate-key',
+                priority: 90,
+                match: (txt) => txt.includes('unique constraint') || txt.includes('duplicate key'),
+                meta: {
+                    message: 'Duplicate key violation. A record with these values already exists.',
+                    httpStatus: 409,
+                },
+            },
+            {
+                code: 'db-foreign-key-error',
+                priority: 90,
+                match: (txt) => txt.includes('violates foreign key'),
+                meta: {
+                    message:
+                        'Foreign key constraint prevents this operation due to related records.',
+                    httpStatus: 409,
+                },
+            },
+            {
+                code: 'unknown-error',
+                priority: -1, // last resort
+                match: (_txt) => true, // fallback catch-all
+                meta: {
+                    message: 'An unexpected error occurred.',
+                    httpStatus: 500,
+                },
+            },
+        ];
+    }
+
+    // Optional explicit meta resolution (if you want)
+    resolve(code: string): ErrorMeta | undefined {
+        const rule = this.rules().find((r) => r.code === code);
+        return rule?.meta;
+    }
+}

package/src/helpers/solid-registry.ts

@@ -5,7 +5,7 @@ import { CommonEntity } from 'src/entities/common.entity';
 import { Locale } from 'src/entities/locale.entity';
 import { SecurityRule } from 'src/entities/security-rule.entity';
 import { IScheduledJob } from 'src/services/scheduled-jobs/scheduled-job.interface';
-import { IDashboardQuestionDataProvider, IDashboardVariableSelectionProvider, ISelectionProvider, ISelectionProviderContext } from "../interfaces";
+import { IDashboardQuestionDataProvider, IDashboardVariableSelectionProvider, IErrorCodeProvider, ISelectionProvider, ISelectionProviderContext } from "../interfaces";
 
 type ControllerMetadata = {
   name: string;
@@ -67,6 +67,12 @@ export class SolidRegistry {
   private dashboardQuestionDataProviders: Set<InstanceWrapper> = new Set();
   private mailProviders: Set<InstanceWrapper> = new Set();
   private whatsappProviders: Set<InstanceWrapper> = new Set();
+  private errorCodeProviders: Set<InstanceWrapper> = new Set();
+
+
+  registerErrorCodeProvider(errorCodeProvider: InstanceWrapper): void {
+    this.errorCodeProviders.add(errorCodeProvider);
+  }
 
   registerWhatsappProvider(whatsappProvider: InstanceWrapper): void {
     this.whatsappProviders.add(whatsappProvider);
@@ -162,6 +168,19 @@ export class SolidRegistry {
     }
   }
 
+  getErrorCodeProviders(): Array<InstanceWrapper> {
+    return Array.from(this.errorCodeProviders);
+  }
+
+  getErrorCodeProviderInstance(name: string): IErrorCodeProvider | undefined {
+    const providers = this.getErrorCodeProviders();
+    for (let i = 0; i < providers.length; i++) {
+      const p = providers[i];
+      if (p.instance?.name?.() === name) return p.instance as IErrorCodeProvider;
+    }
+    return undefined;
+  }
+
   getDashboardQuestionDataProviders(): Array<InstanceWrapper> {
     return Array.from(this.dashboardQuestionDataProviders)
   }

package/src/index.ts

@@ -19,6 +19,7 @@ export * from './decorators/protocol.decorator'
 export * from './decorators/public.decorator'
 export * from './decorators/roles.decorator'
 export * from './decorators/selection-provider.decorator'
+export * from './decorators/error-codes-provider.decorator'
 export * from './decorators/solid-database-module.decorator'
 export * from './decorators/solid-service.decorator'
 export * from './decorators/mail-provider.decorator'

package/src/interfaces.ts

@@ -238,3 +238,39 @@ export interface QueuesModuleOptions {
 export type MediaWithFullUrl = Media & {
   _full_url: string;
 };
+
+
+export type ErrorCode = string;
+
+export type ErrorMeta = {
+  message: string;
+  httpStatus?: number;
+};
+
+export type ErrorRule = {
+  /** Canonical error code. Keep them kebab-case for consistency. */
+  code: ErrorCode;
+  /** Higher runs earlier. Defaults to 0 if not provided. */
+  priority?: number;
+  /** Return true if this rule matches the combined error text. */
+  match: (combinedErrorText: string) => boolean;
+  /** Display + HTTP mapping for this code. */
+  meta: ErrorMeta;
+};
+
+export interface IErrorCodeProvider {
+  /** Used for registry identity & logs */
+  name(): string;
+
+  /**
+   * Return all rules this provider contributes.
+   * These will be merged with other providers’ rules, then sorted by priority.
+   */
+  rules(): ReadonlyArray<ErrorRule>;
+
+  /**
+   * Optional fallback meta for codes this provider owns (when called by getMessage/getHttpStatus).
+   * If omitted, the ErrorMapperService will rely on the rule.meta of the first matching rule.
+   */
+  resolve?(code: ErrorCode): ErrorMeta | undefined;
+}

package/src/jobs/chatter-queue-options.ts

@@ -0,0 +1,9 @@
+import { BrokerType } from "../interfaces";
+
+const QUEUE_NAME = 'chatter_queue';
+
+export default {
+    name: 'queueChatter',
+    type: BrokerType.RabbitMQ,
+    queueName: QUEUE_NAME,
+};