mcp-server-framework 1.0.0

package/build/errors/core/constants.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Constants Module
+ *
+ * Constants related to validation and data sanitization:
+ * - Display limits for error messages
+ * - Sensitive field patterns for redaction
+ *
+ * @module errors/core/constants
+ */
+/**
+ * Validation limits for error handling.
+ *
+ * Used to truncate values displayed in error messages
+ * to prevent overly long outputs and potential data leaks.
+ */
+export declare const VALIDATION_LIMITS: {
+    /** Maximum string length to display in error messages */
+    readonly MAX_STRING_DISPLAY_LENGTH: 100;
+    /** Maximum array items to display in error messages */
+    readonly MAX_ARRAY_DISPLAY_ITEMS: 5;
+    /** Maximum object keys to display in error messages */
+    readonly MAX_OBJECT_DISPLAY_KEYS: 5;
+};
+/**
+ * Redaction placeholder for sensitive values in error serialization.
+ *
+ * Named distinctly from the logger's `REDACTED_VALUE` ('**********')
+ * to avoid confusion: errors use bracket-style placeholders,
+ * the logger uses mask-style replacement.
+ */
+export declare const REDACTED_PLACEHOLDER: "[REDACTED]";
+/**
+ * Redact a value if the field name is sensitive.
+ *
+ * @param fieldName - The field name
+ * @param value - The value to potentially redact
+ * @returns The original value or '[REDACTED]'
+ */
+export declare function redactIfSensitive(fieldName: string, value: unknown): unknown;
+//# sourceMappingURL=constants.d.ts.map

package/build/errors/core/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/errors/core/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;IAC5B,yDAAyD;;IAEzD,uDAAuD;;IAEvD,uDAAuD;;CAE/C,CAAC;AAQX;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,EAAG,YAAqB,CAAC;AAE1D;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAE5E"}

package/build/errors/core/constants.js

@@ -0,0 +1,49 @@
+/**
+ * Constants Module
+ *
+ * Constants related to validation and data sanitization:
+ * - Display limits for error messages
+ * - Sensitive field patterns for redaction
+ *
+ * @module errors/core/constants
+ */
+// ============================================================================
+// Validation Display Limits
+// ============================================================================
+/**
+ * Validation limits for error handling.
+ *
+ * Used to truncate values displayed in error messages
+ * to prevent overly long outputs and potential data leaks.
+ */
+export const VALIDATION_LIMITS = {
+    /** Maximum string length to display in error messages */
+    MAX_STRING_DISPLAY_LENGTH: 100,
+    /** Maximum array items to display in error messages */
+    MAX_ARRAY_DISPLAY_ITEMS: 5,
+    /** Maximum object keys to display in error messages */
+    MAX_OBJECT_DISPLAY_KEYS: 5,
+};
+// ============================================================================
+// Sensitive Field Patterns
+// ============================================================================
+import { isSensitiveKey } from "../../utils/sensitive-keys.js";
+/**
+ * Redaction placeholder for sensitive values in error serialization.
+ *
+ * Named distinctly from the logger's `REDACTED_VALUE` ('**********')
+ * to avoid confusion: errors use bracket-style placeholders,
+ * the logger uses mask-style replacement.
+ */
+export const REDACTED_PLACEHOLDER = "[REDACTED]";
+/**
+ * Redact a value if the field name is sensitive.
+ *
+ * @param fieldName - The field name
+ * @param value - The value to potentially redact
+ * @returns The original value or '[REDACTED]'
+ */
+export function redactIfSensitive(fieldName, value) {
+    return isSensitiveKey(fieldName) ? REDACTED_PLACEHOLDER : value;
+}
+//# sourceMappingURL=constants.js.map

package/build/errors/core/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/errors/core/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,+EAA+E;AAC/E,4BAA4B;AAC5B,+EAA+E;AAE/E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,yDAAyD;IACzD,yBAAyB,EAAE,GAAG;IAC9B,uDAAuD;IACvD,uBAAuB,EAAE,CAAC;IAC1B,uDAAuD;IACvD,uBAAuB,EAAE,CAAC;CAClB,CAAC;AAEX,+EAA+E;AAC/E,2BAA2B;AAC3B,+EAA+E;AAE/E,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,YAAqB,CAAC;AAE1D;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAiB,EAAE,KAAc;IACjE,OAAO,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,KAAK,CAAC;AAClE,CAAC"}

package/build/errors/core/error-codes.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Application Error Codes Module
+ *
+ * Defines application-specific error codes and categories.
+ * These are semantic error identifiers used throughout the application
+ * for programmatic error handling.
+ *
+ * @module errors/core/error-codes
+ */
+/**
+ * Application-specific error codes.
+ *
+ * Organized by category:
+ * - Framework errors (generic MCP framework)
+ * - Generic App errors
+ */
+export declare const ErrorCodes: {
+    /** Input validation failed */
+    readonly VALIDATION_ERROR: "VALIDATION_ERROR";
+    /** Configuration is invalid or missing */
+    readonly CONFIGURATION_ERROR: "CONFIGURATION_ERROR";
+    /** Requested resource not found */
+    readonly NOT_FOUND: "NOT_FOUND";
+    /** Authentication failed */
+    readonly UNAUTHORIZED: "UNAUTHORIZED";
+    /** Access denied */
+    readonly FORBIDDEN: "FORBIDDEN";
+    /** Invalid request format */
+    readonly INVALID_REQUEST: "INVALID_REQUEST";
+    /** API communication error */
+    readonly API_ERROR: "API_ERROR";
+    /** Network connection failed */
+    readonly CONNECTION_ERROR: "CONNECTION_ERROR";
+    /** Request timeout */
+    readonly TIMEOUT_ERROR: "TIMEOUT_ERROR";
+    /** Internal server error */
+    readonly INTERNAL_ERROR: "INTERNAL_ERROR";
+    /** Service unavailable */
+    readonly SERVICE_UNAVAILABLE: "SERVICE_UNAVAILABLE";
+    /** Registry error (tool/resource/prompt) */
+    readonly REGISTRY_ERROR: "REGISTRY_ERROR";
+    /** Operation was cancelled */
+    readonly OPERATION_CANCELLED: "OPERATION_CANCELLED";
+    /** Operation failed */
+    readonly OPERATION_ERROR: "OPERATION_ERROR";
+    /** Client not configured */
+    readonly API_CLIENT_NOT_CONFIGURED: "API_CLIENT_NOT_CONFIGURED";
+    /** Authentication error */
+    readonly API_AUTHENTICATION_ERROR: "API_AUTHENTICATION_ERROR";
+};
+export type ErrorCodeType = (typeof ErrorCodes)[keyof typeof ErrorCodes];
+/**
+ * Error categories for grouping and handling.
+ */
+export declare const ErrorCategory: {
+    /** API communication errors */
+    readonly API: "api";
+    /** MCP protocol errors */
+    readonly MCP: "mcp";
+    /** Input validation errors */
+    readonly VALIDATION: "validation";
+    /** Configuration errors */
+    readonly CONFIGURATION: "configuration";
+    /** Connection/network errors */
+    readonly CONNECTION: "connection";
+    /** Operation lifecycle errors */
+    readonly OPERATION: "operation";
+    /** Internal system errors */
+    readonly SYSTEM: "system";
+};
+export type ErrorCategoryType = (typeof ErrorCategory)[keyof typeof ErrorCategory];
+//# sourceMappingURL=error-codes.d.ts.map

package/build/errors/core/error-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-codes.d.ts","sourceRoot":"","sources":["../../../src/errors/core/error-codes.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;;;;;GAMG;AACH,eAAO,MAAM,UAAU;IAIrB,8BAA8B;;IAE9B,0CAA0C;;IAE1C,mCAAmC;;IAEnC,4BAA4B;;IAE5B,oBAAoB;;IAEpB,6BAA6B;;IAM7B,8BAA8B;;IAE9B,gCAAgC;;IAEhC,sBAAsB;;IAEtB,4BAA4B;;IAE5B,0BAA0B;;IAE1B,4CAA4C;;IAM5C,8BAA8B;;IAE9B,uBAAuB;;IAMvB,4BAA4B;;IAE5B,2BAA2B;;CAEnB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAMzE;;GAEG;AACH,eAAO,MAAM,aAAa;IACxB,+BAA+B;;IAE/B,0BAA0B;;IAE1B,8BAA8B;;IAE9B,2BAA2B;;IAE3B,gCAAgC;;IAEhC,iCAAiC;;IAEjC,6BAA6B;;CAErB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC"}

package/build/errors/core/error-codes.js

@@ -0,0 +1,88 @@
+/**
+ * Application Error Codes Module
+ *
+ * Defines application-specific error codes and categories.
+ * These are semantic error identifiers used throughout the application
+ * for programmatic error handling.
+ *
+ * @module errors/core/error-codes
+ */
+// ============================================================================
+// Error Codes
+// ============================================================================
+/**
+ * Application-specific error codes.
+ *
+ * Organized by category:
+ * - Framework errors (generic MCP framework)
+ * - Generic App errors
+ */
+export const ErrorCodes = {
+    // ─────────────────────────────────────────────────────────────────────────
+    // Framework - Client Errors (4xx conceptually)
+    // ─────────────────────────────────────────────────────────────────────────
+    /** Input validation failed */
+    VALIDATION_ERROR: "VALIDATION_ERROR",
+    /** Configuration is invalid or missing */
+    CONFIGURATION_ERROR: "CONFIGURATION_ERROR",
+    /** Requested resource not found */
+    NOT_FOUND: "NOT_FOUND",
+    /** Authentication failed */
+    UNAUTHORIZED: "UNAUTHORIZED",
+    /** Access denied */
+    FORBIDDEN: "FORBIDDEN",
+    /** Invalid request format */
+    INVALID_REQUEST: "INVALID_REQUEST",
+    // ─────────────────────────────────────────────────────────────────────────
+    // Framework - Server/API Errors (5xx conceptually)
+    // ─────────────────────────────────────────────────────────────────────────
+    /** API communication error */
+    API_ERROR: "API_ERROR",
+    /** Network connection failed */
+    CONNECTION_ERROR: "CONNECTION_ERROR",
+    /** Request timeout */
+    TIMEOUT_ERROR: "TIMEOUT_ERROR",
+    /** Internal server error */
+    INTERNAL_ERROR: "INTERNAL_ERROR",
+    /** Service unavailable */
+    SERVICE_UNAVAILABLE: "SERVICE_UNAVAILABLE",
+    /** Registry error (tool/resource/prompt) */
+    REGISTRY_ERROR: "REGISTRY_ERROR",
+    // ─────────────────────────────────────────────────────────────────────────
+    // Framework - Operation Errors
+    // ─────────────────────────────────────────────────────────────────────────
+    /** Operation was cancelled */
+    OPERATION_CANCELLED: "OPERATION_CANCELLED",
+    /** Operation failed */
+    OPERATION_ERROR: "OPERATION_ERROR",
+    // ─────────────────────────────────────────────────────────────────────────
+    // Additional App-specific Errors
+    // ─────────────────────────────────────────────────────────────────────────
+    /** Client not configured */
+    API_CLIENT_NOT_CONFIGURED: "API_CLIENT_NOT_CONFIGURED",
+    /** Authentication error */
+    API_AUTHENTICATION_ERROR: "API_AUTHENTICATION_ERROR",
+};
+// ============================================================================
+// Error Categories
+// ============================================================================
+/**
+ * Error categories for grouping and handling.
+ */
+export const ErrorCategory = {
+    /** API communication errors */
+    API: "api",
+    /** MCP protocol errors */
+    MCP: "mcp",
+    /** Input validation errors */
+    VALIDATION: "validation",
+    /** Configuration errors */
+    CONFIGURATION: "configuration",
+    /** Connection/network errors */
+    CONNECTION: "connection",
+    /** Operation lifecycle errors */
+    OPERATION: "operation",
+    /** Internal system errors */
+    SYSTEM: "system",
+};
+//# sourceMappingURL=error-codes.js.map

package/build/errors/core/error-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-codes.js","sourceRoot":"","sources":["../../../src/errors/core/error-codes.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,4EAA4E;IAC5E,+CAA+C;IAC/C,4EAA4E;IAC5E,8BAA8B;IAC9B,gBAAgB,EAAE,kBAAkB;IACpC,0CAA0C;IAC1C,mBAAmB,EAAE,qBAAqB;IAC1C,mCAAmC;IACnC,SAAS,EAAE,WAAW;IACtB,4BAA4B;IAC5B,YAAY,EAAE,cAAc;IAC5B,oBAAoB;IACpB,SAAS,EAAE,WAAW;IACtB,6BAA6B;IAC7B,eAAe,EAAE,iBAAiB;IAElC,4EAA4E;IAC5E,mDAAmD;IACnD,4EAA4E;IAC5E,8BAA8B;IAC9B,SAAS,EAAE,WAAW;IACtB,gCAAgC;IAChC,gBAAgB,EAAE,kBAAkB;IACpC,sBAAsB;IACtB,aAAa,EAAE,eAAe;IAC9B,4BAA4B;IAC5B,cAAc,EAAE,gBAAgB;IAChC,0BAA0B;IAC1B,mBAAmB,EAAE,qBAAqB;IAC1C,4CAA4C;IAC5C,cAAc,EAAE,gBAAgB;IAEhC,4EAA4E;IAC5E,+BAA+B;IAC/B,4EAA4E;IAC5E,8BAA8B;IAC9B,mBAAmB,EAAE,qBAAqB;IAC1C,uBAAuB;IACvB,eAAe,EAAE,iBAAiB;IAElC,4EAA4E;IAC5E,iCAAiC;IACjC,4EAA4E;IAC5E,4BAA4B;IAC5B,yBAAyB,EAAE,2BAA2B;IACtD,2BAA2B;IAC3B,wBAAwB,EAAE,0BAA0B;CAC5C,CAAC;AAIX,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,+BAA+B;IAC/B,GAAG,EAAE,KAAK;IACV,0BAA0B;IAC1B,GAAG,EAAE,KAAK;IACV,8BAA8B;IAC9B,UAAU,EAAE,YAAY;IACxB,2BAA2B;IAC3B,aAAa,EAAE,eAAe;IAC9B,gCAAgC;IAChC,UAAU,EAAE,YAAY;IACxB,iCAAiC;IACjC,SAAS,EAAE,WAAW;IACtB,6BAA6B;IAC7B,MAAM,EAAE,QAAQ;CACR,CAAC"}

package/build/errors/core/http.d.ts

@@ -0,0 +1,69 @@
+/**
+ * HTTP Constants Module
+ *
+ * HTTP-specific constants and mappings:
+ * - HTTP status codes enum
+ * - Error code to HTTP status mapping
+ *
+ * @module errors/core/http
+ */
+import { type ErrorCodeType } from "./index.js";
+/**
+ * HTTP Status Codes used in the transport layer.
+ *
+ * Following RFC 9110 and common conventions.
+ */
+export declare const HttpStatus: {
+    /** Request succeeded */
+    readonly OK: 200;
+    /** Request accepted for processing */
+    readonly ACCEPTED: 202;
+    /** Request succeeded with no content to return */
+    readonly NO_CONTENT: 204;
+    /** Malformed request syntax */
+    readonly BAD_REQUEST: 400;
+    /** Authentication required */
+    readonly UNAUTHORIZED: 401;
+    /** Access denied */
+    readonly FORBIDDEN: 403;
+    /** Resource not found */
+    readonly NOT_FOUND: 404;
+    /** HTTP method not allowed */
+    readonly METHOD_NOT_ALLOWED: 405;
+    /** Media type not supported */
+    readonly UNSUPPORTED_MEDIA_TYPE: 415;
+    /** Request could not be completed due to a conflict (RFC 9110) */
+    readonly CONFLICT: 409;
+    /** Precondition Required (RFC 6585) */
+    readonly PRECONDITION_REQUIRED: 428;
+    /** Too Many Requests (Rate Limiting - RFC 6585) */
+    readonly TOO_MANY_REQUESTS: 429;
+    /** Client Closed Request (nginx convention) */
+    readonly CLIENT_CLOSED_REQUEST: 499;
+    /** Internal server error */
+    readonly INTERNAL_SERVER_ERROR: 500;
+    /** Feature not implemented */
+    readonly NOT_IMPLEMENTED: 501;
+    /** Invalid response from upstream server */
+    readonly BAD_GATEWAY: 502;
+    /** Service temporarily unavailable */
+    readonly SERVICE_UNAVAILABLE: 503;
+    /** Upstream server timeout */
+    readonly GATEWAY_TIMEOUT: 504;
+};
+export type HttpStatusType = (typeof HttpStatus)[keyof typeof HttpStatus];
+/**
+ * Maps application error codes to HTTP status codes.
+ *
+ * This mapping is used by the base error class to automatically
+ * derive HTTP status codes from error codes when not explicitly specified.
+ */
+export declare const ErrorCodeToHttpStatus: Partial<Record<ErrorCodeType, HttpStatusType>> & Record<string, HttpStatusType>;
+/**
+ * Get HTTP status code for an error code.
+ *
+ * @param code - The application error code
+ * @returns HTTP status code (defaults to 500 if not mapped)
+ */
+export declare function getHttpStatusForErrorCode(code: ErrorCodeType): HttpStatusType;
+//# sourceMappingURL=http.d.ts.map

package/build/errors/core/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/errors/core/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAc,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAM5D;;;;GAIG;AACH,eAAO,MAAM,UAAU;IAIrB,wBAAwB;;IAExB,sCAAsC;;IAEtC,kDAAkD;;IAMlD,+BAA+B;;IAE/B,8BAA8B;;IAE9B,oBAAoB;;IAEpB,yBAAyB;;IAEzB,8BAA8B;;IAE9B,+BAA+B;;IAE/B,kEAAkE;;IAElE,uCAAuC;;IAEvC,mDAAmD;;IAEnD,+CAA+C;;IAM/C,4BAA4B;;IAE5B,8BAA8B;;IAE9B,4CAA4C;;IAE5C,sCAAsC;;IAEtC,8BAA8B;;CAEtB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAM1E;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAwBjH,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,aAAa,GAAG,cAAc,CAE7E"}

package/build/errors/core/http.js

@@ -0,0 +1,106 @@
+/**
+ * HTTP Constants Module
+ *
+ * HTTP-specific constants and mappings:
+ * - HTTP status codes enum
+ * - Error code to HTTP status mapping
+ *
+ * @module errors/core/http
+ */
+import { ErrorCodes } from "./index.js";
+// ============================================================================
+// HTTP Status Codes
+// ============================================================================
+/**
+ * HTTP Status Codes used in the transport layer.
+ *
+ * Following RFC 9110 and common conventions.
+ */
+export const HttpStatus = {
+    // ─────────────────────────────────────────────────────────────────────────
+    // Success (2xx)
+    // ─────────────────────────────────────────────────────────────────────────
+    /** Request succeeded */
+    OK: 200,
+    /** Request accepted for processing */
+    ACCEPTED: 202,
+    /** Request succeeded with no content to return */
+    NO_CONTENT: 204,
+    // ─────────────────────────────────────────────────────────────────────────
+    // Client Errors (4xx)
+    // ─────────────────────────────────────────────────────────────────────────
+    /** Malformed request syntax */
+    BAD_REQUEST: 400,
+    /** Authentication required */
+    UNAUTHORIZED: 401,
+    /** Access denied */
+    FORBIDDEN: 403,
+    /** Resource not found */
+    NOT_FOUND: 404,
+    /** HTTP method not allowed */
+    METHOD_NOT_ALLOWED: 405,
+    /** Media type not supported */
+    UNSUPPORTED_MEDIA_TYPE: 415,
+    /** Request could not be completed due to a conflict (RFC 9110) */
+    CONFLICT: 409,
+    /** Precondition Required (RFC 6585) */
+    PRECONDITION_REQUIRED: 428,
+    /** Too Many Requests (Rate Limiting - RFC 6585) */
+    TOO_MANY_REQUESTS: 429,
+    /** Client Closed Request (nginx convention) */
+    CLIENT_CLOSED_REQUEST: 499,
+    // ─────────────────────────────────────────────────────────────────────────
+    // Server Errors (5xx)
+    // ─────────────────────────────────────────────────────────────────────────
+    /** Internal server error */
+    INTERNAL_SERVER_ERROR: 500,
+    /** Feature not implemented */
+    NOT_IMPLEMENTED: 501,
+    /** Invalid response from upstream server */
+    BAD_GATEWAY: 502,
+    /** Service temporarily unavailable */
+    SERVICE_UNAVAILABLE: 503,
+    /** Upstream server timeout */
+    GATEWAY_TIMEOUT: 504,
+};
+// ============================================================================
+// Error Code to HTTP Status Mapping
+// ============================================================================
+/**
+ * Maps application error codes to HTTP status codes.
+ *
+ * This mapping is used by the base error class to automatically
+ * derive HTTP status codes from error codes when not explicitly specified.
+ */
+export const ErrorCodeToHttpStatus = {
+    // Client errors (4xx)
+    [ErrorCodes.VALIDATION_ERROR]: HttpStatus.BAD_REQUEST,
+    [ErrorCodes.INVALID_REQUEST]: HttpStatus.BAD_REQUEST,
+    [ErrorCodes.UNAUTHORIZED]: HttpStatus.UNAUTHORIZED,
+    [ErrorCodes.FORBIDDEN]: HttpStatus.FORBIDDEN,
+    [ErrorCodes.NOT_FOUND]: HttpStatus.NOT_FOUND,
+    // Server errors (5xx)
+    [ErrorCodes.CONFIGURATION_ERROR]: HttpStatus.INTERNAL_SERVER_ERROR,
+    [ErrorCodes.INTERNAL_ERROR]: HttpStatus.INTERNAL_SERVER_ERROR,
+    [ErrorCodes.API_ERROR]: HttpStatus.BAD_GATEWAY,
+    [ErrorCodes.CONNECTION_ERROR]: HttpStatus.SERVICE_UNAVAILABLE,
+    [ErrorCodes.SERVICE_UNAVAILABLE]: HttpStatus.SERVICE_UNAVAILABLE,
+    [ErrorCodes.TIMEOUT_ERROR]: HttpStatus.GATEWAY_TIMEOUT,
+    [ErrorCodes.REGISTRY_ERROR]: HttpStatus.NOT_FOUND,
+    // Operation errors
+    [ErrorCodes.OPERATION_CANCELLED]: HttpStatus.CLIENT_CLOSED_REQUEST,
+    [ErrorCodes.OPERATION_ERROR]: HttpStatus.INTERNAL_SERVER_ERROR,
+    // App-specific
+    [ErrorCodes.API_CLIENT_NOT_CONFIGURED]: HttpStatus.PRECONDITION_REQUIRED,
+    [ErrorCodes.API_AUTHENTICATION_ERROR]: HttpStatus.UNAUTHORIZED,
+};
+/**
+ * Get HTTP status code for an error code.
+ *
+ * @param code - The application error code
+ * @returns HTTP status code (defaults to 500 if not mapped)
+ */
+export function getHttpStatusForErrorCode(code) {
+    return ErrorCodeToHttpStatus[code] ?? HttpStatus.INTERNAL_SERVER_ERROR;
+}
+//# sourceMappingURL=http.js.map

package/build/errors/core/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../../src/errors/core/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAsB,MAAM,YAAY,CAAC;AAE5D,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,4EAA4E;IAC5E,gBAAgB;IAChB,4EAA4E;IAC5E,wBAAwB;IACxB,EAAE,EAAE,GAAG;IACP,sCAAsC;IACtC,QAAQ,EAAE,GAAG;IACb,kDAAkD;IAClD,UAAU,EAAE,GAAG;IAEf,4EAA4E;IAC5E,sBAAsB;IACtB,4EAA4E;IAC5E,+BAA+B;IAC/B,WAAW,EAAE,GAAG;IAChB,8BAA8B;IAC9B,YAAY,EAAE,GAAG;IACjB,oBAAoB;IACpB,SAAS,EAAE,GAAG;IACd,yBAAyB;IACzB,SAAS,EAAE,GAAG;IACd,8BAA8B;IAC9B,kBAAkB,EAAE,GAAG;IACvB,+BAA+B;IAC/B,sBAAsB,EAAE,GAAG;IAC3B,kEAAkE;IAClE,QAAQ,EAAE,GAAG;IACb,uCAAuC;IACvC,qBAAqB,EAAE,GAAG;IAC1B,mDAAmD;IACnD,iBAAiB,EAAE,GAAG;IACtB,+CAA+C;IAC/C,qBAAqB,EAAE,GAAG;IAE1B,4EAA4E;IAC5E,sBAAsB;IACtB,4EAA4E;IAC5E,4BAA4B;IAC5B,qBAAqB,EAAE,GAAG;IAC1B,8BAA8B;IAC9B,eAAe,EAAE,GAAG;IACpB,4CAA4C;IAC5C,WAAW,EAAE,GAAG;IAChB,sCAAsC;IACtC,mBAAmB,EAAE,GAAG;IACxB,8BAA8B;IAC9B,eAAe,EAAE,GAAG;CACZ,CAAC;AAIX,+EAA+E;AAC/E,oCAAoC;AACpC,+EAA+E;AAE/E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAoF;IACpH,sBAAsB;IACtB,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,UAAU,CAAC,WAAW;IACrD,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,UAAU,CAAC,WAAW;IACpD,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,UAAU,CAAC,YAAY;IAClD,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,UAAU,CAAC,SAAS;IAC5C,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,UAAU,CAAC,SAAS;IAE5C,sBAAsB;IACtB,CAAC,UAAU,CAAC,mBAAmB,CAAC,EAAE,UAAU,CAAC,qBAAqB;IAClE,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,UAAU,CAAC,qBAAqB;IAC7D,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,UAAU,CAAC,WAAW;IAC9C,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,UAAU,CAAC,mBAAmB;IAC7D,CAAC,UAAU,CAAC,mBAAmB,CAAC,EAAE,UAAU,CAAC,mBAAmB;IAChE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,UAAU,CAAC,eAAe;IACtD,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,UAAU,CAAC,SAAS;IAEjD,mBAAmB;IACnB,CAAC,UAAU,CAAC,mBAAmB,CAAC,EAAE,UAAU,CAAC,qBAAqB;IAClE,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,UAAU,CAAC,qBAAqB;IAE9D,eAAe;IACf,CAAC,UAAU,CAAC,yBAAyB,CAAC,EAAE,UAAU,CAAC,qBAAqB;IACxE,CAAC,UAAU,CAAC,wBAAwB,CAAC,EAAE,UAAU,CAAC,YAAY;CAC/D,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,IAAmB;IAC3D,OAAO,qBAAqB,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,qBAAqB,CAAC;AACzE,CAAC"}

package/build/errors/core/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Error Core Module - Barrel Export
+ *
+ * Re-exports all core error system components:
+ * - Error codes and categories
+ * - HTTP status codes and mappings
+ * - JSON-RPC error codes
+ * - Validation constants and utilities
+ * - Type definitions
+ * - Base error class
+ * - Framework messages
+ *
+ * @module errors/core
+ */
+export { ErrorCodes, ErrorCategory, type ErrorCodeType, type ErrorCategoryType } from "./error-codes.js";
+export { HttpStatus, ErrorCodeToHttpStatus, getHttpStatusForErrorCode, type HttpStatusType } from "./http.js";
+export { JsonRpcErrorCode, isSpecDefinedJsonRpcError, isServerDefinedJsonRpcError, isValidJsonRpcErrorCode, createJsonRpcError, type JsonRpcErrorCodeType, type JsonRpcErrorResponse, } from "./json-rpc.js";
+export { VALIDATION_LIMITS, REDACTED_PLACEHOLDER, redactIfSensitive } from "./constants.js";
+export { isSensitiveKey } from "../../utils/sensitive-keys.js";
+export type { SerializedError, BaseErrorOptions, ValidationErrorOptions, ValidationIssue } from "./types.js";
+export { AppError } from "./base.js";
+export { TransportErrorMessage, type TransportErrorMessageKey } from "./messages.js";
+//# sourceMappingURL=index.d.ts.map

package/build/errors/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/errors/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,KAAK,aAAa,EAAE,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAKzG,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAK9G,OAAO,EACL,gBAAgB,EAChB,yBAAyB,EACzB,2BAA2B,EAC3B,uBAAuB,EACvB,kBAAkB,EAClB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,GAC1B,MAAM,eAAe,CAAC;AAKvB,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAG5F,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAK/D,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAK7G,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAKrC,OAAO,EAAE,qBAAqB,EAAE,KAAK,wBAAwB,EAAE,MAAM,eAAe,CAAC"}

package/build/errors/core/index.js

@@ -0,0 +1,41 @@
+/**
+ * Error Core Module - Barrel Export
+ *
+ * Re-exports all core error system components:
+ * - Error codes and categories
+ * - HTTP status codes and mappings
+ * - JSON-RPC error codes
+ * - Validation constants and utilities
+ * - Type definitions
+ * - Base error class
+ * - Framework messages
+ *
+ * @module errors/core
+ */
+// ─────────────────────────────────────────────────────────────────────────
+// Error Codes & Categories
+// ─────────────────────────────────────────────────────────────────────────
+export { ErrorCodes, ErrorCategory } from "./error-codes.js";
+// ─────────────────────────────────────────────────────────────────────────
+// HTTP Constants & Mappings
+// ─────────────────────────────────────────────────────────────────────────
+export { HttpStatus, ErrorCodeToHttpStatus, getHttpStatusForErrorCode } from "./http.js";
+// ─────────────────────────────────────────────────────────────────────────
+// JSON-RPC Constants
+// ─────────────────────────────────────────────────────────────────────────
+export { JsonRpcErrorCode, isSpecDefinedJsonRpcError, isServerDefinedJsonRpcError, isValidJsonRpcErrorCode, createJsonRpcError, } from "./json-rpc.js";
+// ─────────────────────────────────────────────────────────────────────────
+// Validation Constants & Utilities
+// ─────────────────────────────────────────────────────────────────────────
+export { VALIDATION_LIMITS, REDACTED_PLACEHOLDER, redactIfSensitive } from "./constants.js";
+// Re-export shared utility — canonical source is utils/sensitive-keys.ts
+export { isSensitiveKey } from "../../utils/sensitive-keys.js";
+// ─────────────────────────────────────────────────────────────────────────
+// Base Error Class
+// ─────────────────────────────────────────────────────────────────────────
+export { AppError } from "./base.js";
+// ─────────────────────────────────────────────────────────────────────────
+// Transport Error Messages
+// ─────────────────────────────────────────────────────────────────────────
+export { TransportErrorMessage } from "./messages.js";
+//# sourceMappingURL=index.js.map

package/build/errors/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/errors/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,4EAA4E;AAC5E,2BAA2B;AAC3B,4EAA4E;AAC5E,OAAO,EAAE,UAAU,EAAE,aAAa,EAA8C,MAAM,kBAAkB,CAAC;AAEzG,4EAA4E;AAC5E,4BAA4B;AAC5B,4EAA4E;AAC5E,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,yBAAyB,EAAuB,MAAM,WAAW,CAAC;AAE9G,4EAA4E;AAC5E,qBAAqB;AACrB,4EAA4E;AAC5E,OAAO,EACL,gBAAgB,EAChB,yBAAyB,EACzB,2BAA2B,EAC3B,uBAAuB,EACvB,kBAAkB,GAGnB,MAAM,eAAe,CAAC;AAEvB,4EAA4E;AAC5E,mCAAmC;AACnC,4EAA4E;AAC5E,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAE5F,yEAAyE;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAO/D,4EAA4E;AAC5E,mBAAmB;AACnB,4EAA4E;AAC5E,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,4EAA4E;AAC5E,2BAA2B;AAC3B,4EAA4E;AAC5E,OAAO,EAAE,qBAAqB,EAAiC,MAAM,eAAe,CAAC"}

package/build/errors/core/json-rpc.d.ts

@@ -0,0 +1,69 @@
+/**
+ * JSON-RPC Constants Module
+ *
+ * JSON-RPC 2.0 specification compliant error codes.
+ * Used for MCP protocol communication.
+ *
+ * @see https://www.jsonrpc.org/specification#error_object
+ * @module errors/core/json-rpc
+ */
+import type { RequestId } from "@modelcontextprotocol/sdk/types.js";
+/**
+ * Standard JSON-RPC 2.0 error codes.
+ *
+ * Range -32700 to -32600: Spec-defined errors
+ * Range -32000 to -32099: Implementation-defined server errors
+ */
+export declare const JsonRpcErrorCode: {
+    /** Invalid JSON was received by the server */
+    readonly PARSE_ERROR: -32700;
+    /** The JSON sent is not a valid Request object */
+    readonly INVALID_REQUEST: -32600;
+    /** The method does not exist / is not available */
+    readonly METHOD_NOT_FOUND: -32601;
+    /** Invalid method parameter(s) */
+    readonly INVALID_PARAMS: -32602;
+    /** Internal JSON-RPC error */
+    readonly INTERNAL_ERROR: -32603;
+    /** Generic server error */
+    readonly SERVER_ERROR: -32000;
+    /** Session not found or expired */
+    readonly SESSION_NOT_FOUND: -32001;
+    /** Request was cancelled */
+    readonly REQUEST_CANCELLED: -32002;
+};
+export type JsonRpcErrorCodeType = (typeof JsonRpcErrorCode)[keyof typeof JsonRpcErrorCode];
+/**
+ * Check if an error code is a spec-defined JSON-RPC error.
+ */
+export declare function isSpecDefinedJsonRpcError(code: number): boolean;
+/**
+ * Check if an error code is an implementation-defined server error.
+ */
+export declare function isServerDefinedJsonRpcError(code: number): boolean;
+/**
+ * Check if an error code is a valid JSON-RPC error code.
+ */
+export declare function isValidJsonRpcErrorCode(code: number): boolean;
+/**
+ * JSON-RPC 2.0 error response structure.
+ * Used as return type for {@link createJsonRpcError}.
+ */
+export interface JsonRpcErrorResponse {
+    readonly jsonrpc: "2.0";
+    readonly error: {
+        readonly code: JsonRpcErrorCodeType | number;
+        readonly message: string;
+    };
+    readonly id: RequestId | null;
+}
+/**
+ * Creates a JSON-RPC 2.0 error response.
+ *
+ * @param code - JSON-RPC error code (use JsonRpcErrorCode enum)
+ * @param message - Error message
+ * @param id - Request ID (null for notifications)
+ * @returns Structured JSON-RPC 2.0 error response
+ */
+export declare function createJsonRpcError(code: JsonRpcErrorCodeType | number, message?: string, id?: RequestId | null): JsonRpcErrorResponse;
+//# sourceMappingURL=json-rpc.d.ts.map

package/build/errors/core/json-rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-rpc.d.ts","sourceRoot":"","sources":["../../../src/errors/core/json-rpc.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAMpE;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB;IAI3B,8CAA8C;;IAE9C,kDAAkD;;IAElD,mDAAmD;;IAEnD,kCAAkC;;IAElC,8BAA8B;;IAM9B,2BAA2B;;IAE3B,mCAAmC;;IAEnC,4BAA4B;;CAEpB,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAM5F;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE/D;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE7D;AAMD;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,IAAI,EAAE,oBAAoB,GAAG,MAAM,CAAC;QAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,QAAQ,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI,CAAC;CAC/B;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,oBAAoB,GAAG,MAAM,EACnC,OAAO,CAAC,EAAE,MAAM,EAChB,EAAE,GAAE,SAAS,GAAG,IAAW,GAC1B,oBAAoB,CAMtB"}