@cyanheads/git-mcp-server 2.2.4 → 2.3.2

package/dist/mcp-server/transports/http/mcpTransportMiddleware.js

@@ -34,30 +34,33 @@ async function handleStatelessRequest(createServerInstanceFn, headers, body, con
     const statelessManager = new StatelessTransportManager(createServerInstanceFn);
     return statelessManager.handleRequest(toIncomingHttpHeaders(headers), body, context);
 }
-export const mcpTransportMiddleware = (transportManager, createServerInstanceFn) => createMiddleware(async (c, next) => {
-    const sessionId = c.req.header("mcp-session-id");
-    const context = requestContextService.createRequestContext({
-        operation: "mcpTransportMiddleware",
-        sessionId,
-    });
-    const body = await c.req.json();
-    let response;
-    if (isInitializeRequest(body)) {
-        if (config.mcpSessionMode === "stateless") {
-            response = await handleStatelessRequest(createServerInstanceFn, c.req.raw.headers, body, context);
+export const mcpTransportMiddleware = (transportManager, createServerInstanceFn) => {
+    return createMiddleware(async (c, next) => {
+        const sessionId = c.req.header("mcp-session-id");
+        const context = requestContextService.createRequestContext({
+            operation: "mcpTransportMiddleware",
+            sessionId,
+        });
+        const body = await c.req.json();
+        let response;
+        if (isInitializeRequest(body)) {
+            if (config.mcpSessionMode === "stateless") {
+                response = await handleStatelessRequest(createServerInstanceFn, c.req.raw.headers, body, context);
+            }
+            else {
+                response = await transportManager.initializeAndHandle(toIncomingHttpHeaders(c.req.raw.headers), body, context);
+            }
         }
         else {
-            response = await transportManager.initializeAndHandle(toIncomingHttpHeaders(c.req.raw.headers), body, context);
-        }
-    }
-    else {
-        if (sessionId) {
-            response = await transportManager.handleRequest(toIncomingHttpHeaders(c.req.raw.headers), body, context, sessionId);
+            if (sessionId) {
+                response = await transportManager.handleRequest(toIncomingHttpHeaders(c.req.raw.headers), body, context, sessionId);
+            }
+            else {
+                response = await handleStatelessRequest(createServerInstanceFn, c.req.raw.headers, body, context);
+            }
         }
-        else {
-            response = await handleStatelessRequest(createServerInstanceFn, c.req.raw.headers, body, context);
-        }
-    }
-    c.set("mcpResponse", response);
-    await next();
-});
+        c.set("mcpResponse", response);
+        await next();
+    });
+};
+//# sourceMappingURL=mcpTransportMiddleware.js.map

package/dist/mcp-server/transports/http/mcpTransportMiddleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpTransportMiddleware.js","sourceRoot":"","sources":["../../../../src/mcp-server/transports/http/mcpTransportMiddleware.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAEzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAkB,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhF,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAIjF;;;;GAIG;AACH,SAAS,qBAAqB,CAAC,OAAgB;IAC7C,MAAM,MAAM,GAAwB,EAAE,CAAC;IACvC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QAC7B,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACtB,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;GAOG;AACH,KAAK,UAAU,sBAAsB,CACnC,sBAAgD,EAChD,OAAgB,EAChB,IAAa,EACb,OAAuB;IAEvB,MAAM,gBAAgB,GAAG,IAAI,yBAAyB,CACpD,sBAAsB,CACvB,CAAC;IACF,OAAO,gBAAgB,CAAC,aAAa,CACnC,qBAAqB,CAAC,OAAO,CAAC,EAC9B,IAAI,EACJ,OAAO,CACR,CAAC;AACJ,CAAC;AAeD,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,gBAAkC,EAClC,sBAAgD,EACsB,EAAE;IACxE,OAAO,gBAAgB,CACrB,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE;QAChB,MAAM,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;QACjD,MAAM,OAAO,GAAG,qBAAqB,CAAC,oBAAoB,CAAC;YACzD,SAAS,EAAE,wBAAwB;YACnC,SAAS;SACV,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAChC,IAAI,QAA2B,CAAC;QAEhC,IAAI,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,IAAI,MAAM,CAAC,cAAc,KAAK,WAAW,EAAE,CAAC;gBAC1C,QAAQ,GAAG,MAAM,sBAAsB,CACrC,sBAAsB,EACtB,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,EACjB,IAAI,EACJ,OAAO,CACR,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,QAAQ,GAAG,MACT,gBACD,CAAC,mBAAmB,CACnB,qBAAqB,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,EACxC,IAAI,EACJ,OAAO,CACR,CAAC;YACJ,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,SAAS,EAAE,CAAC;gBACd,QAAQ,GAAG,MAAM,gBAAgB,CAAC,aAAa,CAC7C,qBAAqB,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,EACxC,IAAI,EACJ,OAAO,EACP,SAAS,CACV,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,QAAQ,GAAG,MAAM,sBAAsB,CACrC,sBAAsB,EACtB,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,EACjB,IAAI,EACJ,OAAO,CACR,CAAC;YACJ,CAAC;QACH,CAAC;QAED,CAAC,CAAC,GAAG,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;QAC/B,MAAM,IAAI,EAAE,CAAC;IACf,CAAC,CACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/mcp-server/transports/stdio/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Barrel file for the Stdio transport module.
+ * @module src/mcp-server/transports/stdio/index
+ */
+export { startStdioTransport } from "./stdioTransport.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp-server/transports/stdio/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/transports/stdio/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/mcp-server/transports/stdio/index.js

@@ -3,3 +3,4 @@
  * @module src/mcp-server/transports/stdio/index
  */
 export { startStdioTransport } from "./stdioTransport.js";
+//# sourceMappingURL=index.js.map

package/dist/mcp-server/transports/stdio/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mcp-server/transports/stdio/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/mcp-server/transports/stdio/stdioTransport.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @fileoverview Handles the setup and connection for the Stdio MCP transport.
+ * Implements the MCP Specification 2025-03-26 for stdio transport.
+ * This transport communicates directly over standard input (stdin) and
+ * standard output (stdout), typically used when the MCP server is launched
+ * as a child process by a host application.
+ *
+ * Specification Reference:
+ * https://github.com/modelcontextprotocol/modelcontextprotocol/blob/main/docs/specification/2025-03-26/basic/transports.mdx#stdio
+ *
+ * --- Authentication Note ---
+ * As per the MCP Authorization Specification (2025-03-26, Section 1.2),
+ * STDIO transports SHOULD NOT implement HTTP-based authentication flows.
+ * Authorization is typically handled implicitly by the host application
+ * controlling the server process. This implementation follows that guideline.
+ *
+ * @see {@link https://github.com/modelcontextprotocol/modelcontextprotocol/blob/main/docs/specification/2025-03-26/basic/authorization.mdx | MCP Authorization Specification}
+ * @module src/mcp-server/transports/stdioTransport
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { RequestContext } from "../../../utils/index.js";
+/**
+ * Connects a given `McpServer` instance to the Stdio transport.
+ * This function initializes the SDK's `StdioServerTransport`, which manages
+ * communication over `process.stdin` and `process.stdout` according to the
+ * MCP stdio transport specification.
+ *
+ * MCP Spec Points Covered by SDK's `StdioServerTransport`:
+ * - Reads JSON-RPC messages (requests, notifications, responses, batches) from stdin.
+ * - Writes JSON-RPC messages to stdout.
+ * - Handles newline delimiters and ensures no embedded newlines in output messages.
+ * - Ensures only valid MCP messages are written to stdout.
+ *
+ * Logging via the `logger` utility MAY result in output to stderr, which is
+ * permitted by the spec for logging purposes.
+ *
+ * @param server - The `McpServer` instance.
+ * @param parentContext - The logging and tracing context from the calling function.
+ * @returns A promise that resolves when the Stdio transport is successfully connected.
+ * @throws {Error} If the connection fails during setup.
+ */
+export declare function startStdioTransport(server: McpServer, parentContext: RequestContext): Promise<void>;
+//# sourceMappingURL=stdioTransport.d.ts.map

package/dist/mcp-server/transports/stdio/stdioTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdioTransport.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/transports/stdio/stdioTransport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAwB,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,SAAS,EACjB,aAAa,EAAE,cAAc,GAC5B,OAAO,CAAC,IAAI,CAAC,CAoCf"}

package/dist/mcp-server/transports/stdio/stdioTransport.js

@@ -66,3 +66,4 @@ export async function startStdioTransport(server, parentContext) {
         });
     }
 }
+//# sourceMappingURL=stdioTransport.js.map

package/dist/mcp-server/transports/stdio/stdioTransport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdioTransport.js","sourceRoot":"","sources":["../../../../src/mcp-server/transports/stdio/stdioTransport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,EAAkB,MAAM,yBAAyB,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAiB,EACjB,aAA6B;IAE7B,MAAM,gBAAgB,GAAG;QACvB,GAAG,aAAa;QAChB,SAAS,EAAE,uBAAuB;QAClC,aAAa,EAAE,OAAO;KACvB,CAAC;IACF,MAAM,CAAC,IAAI,CAAC,0CAA0C,EAAE,gBAAgB,CAAC,CAAC;IAE1E,IAAI,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,2CAA2C,EAAE,gBAAgB,CAAC,CAAC;QAC5E,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAE7C,MAAM,CAAC,KAAK,CACV,0DAA0D,EAC1D,gBAAgB,CACjB,CAAC;QACF,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAEhC,MAAM,CAAC,IAAI,CACT,yDAAyD,EACzD,gBAAgB,CACjB,CAAC;QACF,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CACT,qFAAqF,CACtF,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,qEAAqE;QACrE,MAAM,YAAY,CAAC,WAAW,CAAC,GAAG,EAAE;YAClC,SAAS,EAAE,uBAAuB;YAClC,OAAO,EAAE,gBAAgB;YACzB,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/types-global/errors.d.ts

@@ -0,0 +1,122 @@
+/**
+ * @fileoverview Defines standardized error codes, a custom error class, and related schemas
+ * for handling errors within the Model Context Protocol (MCP) server and its components.
+ * This module provides a structured way to represent and communicate errors, ensuring
+ * consistency and clarity for both server-side operations and client-side error handling.
+ * @module src/types-global/errors
+ */
+import { z } from "zod";
+/**
+ * Defines a comprehensive set of standardized error codes for common issues encountered
+ * within MCP servers, tools, or related operations. These codes are designed to help
+ * clients and developers programmatically understand the nature of an error, facilitating
+ * more precise error handling and debugging.
+ */
+export declare enum BaseErrorCode {
+    /** Access denied due to invalid credentials or lack of authentication. */
+    UNAUTHORIZED = "UNAUTHORIZED",
+    /** Access denied despite valid authentication, due to insufficient permissions. */
+    FORBIDDEN = "FORBIDDEN",
+    /** The requested resource or entity could not be found. */
+    NOT_FOUND = "NOT_FOUND",
+    /** The request could not be completed due to a conflict with the current state of the resource. */
+    CONFLICT = "CONFLICT",
+    /** The request failed due to invalid input parameters or data. */
+    VALIDATION_ERROR = "VALIDATION_ERROR",
+    /** The provided input is invalid for the operation. */
+    INVALID_INPUT = "INVALID_INPUT",
+    /** An error occurred while parsing input data (e.g., date string, JSON). */
+    PARSING_ERROR = "PARSING_ERROR",
+    /** The request was rejected because the client has exceeded rate limits. */
+    RATE_LIMITED = "RATE_LIMITED",
+    /** The request timed out before a response could be generated. */
+    TIMEOUT = "TIMEOUT",
+    /** The service is temporarily unavailable, possibly due to maintenance or overload. */
+    SERVICE_UNAVAILABLE = "SERVICE_UNAVAILABLE",
+    /** An unexpected error occurred on the server side. */
+    INTERNAL_ERROR = "INTERNAL_ERROR",
+    /** An error occurred, but the specific cause is unknown or cannot be categorized. */
+    UNKNOWN_ERROR = "UNKNOWN_ERROR",
+    /** An error occurred during the loading or validation of configuration data. */
+    CONFIGURATION_ERROR = "CONFIGURATION_ERROR",
+    /** An error occurred during the initialization phase of a service or module. */
+    INITIALIZATION_FAILED = "INITIALIZATION_FAILED",
+    /** A service was used before it was properly initialized. */
+    SERVICE_NOT_INITIALIZED = "SERVICE_NOT_INITIALIZED",
+    /** A generic error occurred during a database operation. */
+    DATABASE_ERROR = "DATABASE_ERROR",
+    /** An error occurred while loading or interacting with an extension. */
+    EXTENSION_ERROR = "EXTENSION_ERROR",
+    /** An error occurred during the shutdown phase of a service or module. */
+    SHUTDOWN_ERROR = "SHUTDOWN_ERROR",
+    /** A generic error occurred during the execution of an agent's task. */
+    AGENT_EXECUTION_ERROR = "AGENT_EXECUTION_ERROR"
+}
+/**
+ * Custom error class for MCP-specific errors, extending the built-in `Error` class.
+ * It standardizes error reporting by encapsulating a `BaseErrorCode`, a descriptive
+ * human-readable message, and optional structured details for more context.
+ *
+ * This class is central to error handling within the MCP framework, allowing for
+ * consistent error creation and propagation.
+ */
+export declare class McpError extends Error {
+    /**
+     * The standardized error code from {@link BaseErrorCode}.
+     */
+    readonly code: BaseErrorCode;
+    /**
+     * Optional additional details or context about the error.
+     * This can be any structured data that helps in understanding or debugging the error.
+     */
+    readonly details?: Record<string, unknown>;
+    /**
+     * Creates an instance of McpError.
+     *
+     * @param code - The standardized error code that categorizes the error.
+     * @param message - A human-readable description of the error.
+     * @param details - Optional. A record containing additional structured details about the error.
+     */
+    constructor(code: BaseErrorCode, message: string, details?: Record<string, unknown>);
+}
+/**
+ * Zod schema for validating error objects. This schema can be used for:
+ * - Validating error structures when parsing error responses from external services.
+ * - Ensuring consistency when creating or handling error objects internally.
+ * - Generating TypeScript types for error objects.
+ *
+ * The schema enforces the presence of a `code` (from {@link BaseErrorCode}) and a `message`,
+ * and allows for optional `details`.
+ */
+export declare const ErrorSchema: z.ZodObject<{
+    /**
+     * The error code, corresponding to one of the {@link BaseErrorCode} enum values.
+     * This field is required and helps in programmatically identifying the error type.
+     */
+    code: z.ZodNativeEnum<typeof BaseErrorCode>;
+    /**
+     * A human-readable, descriptive message explaining the error.
+     * This field is required and provides context to developers or users.
+     */
+    message: z.ZodString;
+    /**
+     * Optional. A record containing additional structured details or context about the error.
+     * This can include things like invalid field names, specific values that caused issues, or other relevant data.
+     */
+    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    code: BaseErrorCode;
+    message: string;
+    details?: Record<string, unknown> | undefined;
+}, {
+    code: BaseErrorCode;
+    message: string;
+    details?: Record<string, unknown> | undefined;
+}>;
+/**
+ * TypeScript type inferred from the {@link ErrorSchema}.
+ * This type represents the structure of a validated error object, commonly used
+ * for error responses or when passing error information within the application.
+ */
+export type ErrorResponse = z.infer<typeof ErrorSchema>;
+//# sourceMappingURL=errors.d.ts.map

package/dist/types-global/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/types-global/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AACH,oBAAY,aAAa;IACvB,0EAA0E;IAC1E,YAAY,iBAAiB;IAC7B,mFAAmF;IACnF,SAAS,cAAc;IACvB,2DAA2D;IAC3D,SAAS,cAAc;IACvB,mGAAmG;IACnG,QAAQ,aAAa;IACrB,kEAAkE;IAClE,gBAAgB,qBAAqB;IACrC,uDAAuD;IACvD,aAAa,kBAAkB;IAC/B,4EAA4E;IAC5E,aAAa,kBAAkB;IAC/B,4EAA4E;IAC5E,YAAY,iBAAiB;IAC7B,kEAAkE;IAClE,OAAO,YAAY;IACnB,uFAAuF;IACvF,mBAAmB,wBAAwB;IAC3C,uDAAuD;IACvD,cAAc,mBAAmB;IACjC,qFAAqF;IACrF,aAAa,kBAAkB;IAC/B,gFAAgF;IAChF,mBAAmB,wBAAwB;IAC3C,gFAAgF;IAChF,qBAAqB,0BAA0B;IAC/C,6DAA6D;IAC7D,uBAAuB,4BAA4B;IACnD,4DAA4D;IAC5D,cAAc,mBAAmB;IACjC,wEAAwE;IACxE,eAAe,oBAAoB;IACnC,0EAA0E;IAC1E,cAAc,mBAAmB;IACjC,wEAAwE;IACxE,qBAAqB,0BAA0B;CAChD;AAED;;;;;;;GAOG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC;;OAEG;IACH,SAAgB,IAAI,EAAE,aAAa,CAAC;IAEpC;;;OAGG;IACH,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAElD;;;;;;OAMG;gBAED,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAgBpC;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW;IAEpB;;;OAGG;;IAIH;;;OAGG;;IAKH;;;OAGG;;;;;;;;;;EAUJ,CAAC;AAEJ;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC"}

package/dist/types-global/errors.js

@@ -127,3 +127,4 @@ export const ErrorSchema = z
         .describe("Optional structured details providing more context about the error"),
 })
     .describe("Schema for validating structured error objects, ensuring consistency in error reporting.");
+//# sourceMappingURL=errors.js.map

package/dist/types-global/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/types-global/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AACH,MAAM,CAAN,IAAY,aAuCX;AAvCD,WAAY,aAAa;IACvB,0EAA0E;IAC1E,8CAA6B,CAAA;IAC7B,mFAAmF;IACnF,wCAAuB,CAAA;IACvB,2DAA2D;IAC3D,wCAAuB,CAAA;IACvB,mGAAmG;IACnG,sCAAqB,CAAA;IACrB,kEAAkE;IAClE,sDAAqC,CAAA;IACrC,uDAAuD;IACvD,gDAA+B,CAAA;IAC/B,4EAA4E;IAC5E,gDAA+B,CAAA;IAC/B,4EAA4E;IAC5E,8CAA6B,CAAA;IAC7B,kEAAkE;IAClE,oCAAmB,CAAA;IACnB,uFAAuF;IACvF,4DAA2C,CAAA;IAC3C,uDAAuD;IACvD,kDAAiC,CAAA;IACjC,qFAAqF;IACrF,gDAA+B,CAAA;IAC/B,gFAAgF;IAChF,4DAA2C,CAAA;IAC3C,gFAAgF;IAChF,gEAA+C,CAAA;IAC/C,6DAA6D;IAC7D,oEAAmD,CAAA;IACnD,4DAA4D;IAC5D,kDAAiC,CAAA;IACjC,wEAAwE;IACxE,oDAAmC,CAAA;IACnC,0EAA0E;IAC1E,kDAAiC,CAAA;IACjC,wEAAwE;IACxE,gEAA+C,CAAA;AACjD,CAAC,EAvCW,aAAa,KAAb,aAAa,QAuCxB;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC;;OAEG;IACa,IAAI,CAAgB;IAEpC;;;OAGG;IACa,OAAO,CAA2B;IAElD;;;;;;OAMG;IACH,YACE,IAAmB,EACnB,OAAe,EACf,OAAiC;QAEjC,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QAEvB,qCAAqC;QACrC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;QAEhD,iFAAiF;QACjF,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC;KACzB,MAAM,CAAC;IACN;;;OAGG;IACH,IAAI,EAAE,CAAC;SACJ,UAAU,CAAC,aAAa,CAAC;SACzB,QAAQ,CAAC,iDAAiD,CAAC;IAC9D;;;OAGG;IACH,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,gCAAgC,CAAC;SACxC,QAAQ,CAAC,uCAAuC,CAAC;IACpD;;;OAGG;IACH,OAAO,EAAE,CAAC;SACP,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SACnB,QAAQ,EAAE;SACV,QAAQ,CACP,oEAAoE,CACrE;CACJ,CAAC;KACD,QAAQ,CACP,0FAA0F,CAC3F,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./internal/index.js";
+export * from "./parsing/index.js";
+export * from "./security/index.js";
+export * from "./metrics/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AACA,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC"}

package/dist/utils/index.js

@@ -10,3 +10,4 @@ export * from "./metrics/index.js";
 // export * from './internal/errorHandler.js';
 // export * from './internal/logger.js';
 // ... etc.
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AAEnC,iEAAiE;AACjE,8CAA8C;AAC9C,mDAAmD;AACnD,qEAAqE;AACrE,8CAA8C;AAC9C,wCAAwC;AACxC,WAAW"}

package/dist/utils/internal/errorHandler.d.ts

@@ -0,0 +1,91 @@
+import { BaseErrorCode } from "../../types-global/errors.js";
+/**
+ * Generic error context interface
+ */
+export interface ErrorContext {
+    /** Unique request or operation identifier */
+    requestId?: string;
+    /** Any additional context information */
+    [key: string]: unknown;
+}
+/**
+ * Error handler options
+ */
+export interface ErrorHandlerOptions {
+    /** The context of the operation that caused the error */
+    context?: ErrorContext;
+    /** The name of the operation being performed */
+    operation: string;
+    /** The input that caused the error */
+    input?: unknown;
+    /** Whether to rethrow the error after handling */
+    rethrow?: boolean;
+    /** Custom error code to use when creating an McpError */
+    errorCode?: BaseErrorCode;
+    /** Custom error mapper function */
+    errorMapper?: (error: unknown) => Error;
+    /** Whether to include stack traces in logs */
+    includeStack?: boolean;
+    /** Whether this is a critical error that should abort operations */
+    critical?: boolean;
+}
+/**
+ * Base error mapping rule
+ */
+export interface BaseErrorMapping {
+    /** Pattern to match in the error message */
+    pattern: string | RegExp;
+    /** Error code for mapped errors */
+    errorCode: BaseErrorCode;
+    /** Custom error message template */
+    messageTemplate?: string;
+}
+/**
+ * Error mapping configuration
+ */
+export interface ErrorMapping<T extends Error = Error> extends BaseErrorMapping {
+    /** Factory function to create the mapped error */
+    factory: (error: unknown, context?: Record<string, unknown>) => T;
+    /** Additional context to merge with error context */
+    additionalContext?: Record<string, unknown>;
+}
+/**
+ * Error handler utility class with various error handling methods
+ */
+export declare class ErrorHandler {
+    /**
+     * Determine the appropriate error code for an error based on patterns and type
+     * @param error The error to classify
+     * @returns The appropriate error code
+     */
+    static determineErrorCode(error: unknown): BaseErrorCode;
+    /**
+     * Handle operation errors with consistent logging and transformation
+     * @param error The error that occurred
+     * @param options Error handling options
+     * @returns The transformed error
+     */
+    static handleError(error: unknown, options: ErrorHandlerOptions): Error;
+    /**
+     * Map an error to a specific error type based on error message patterns
+     * @param error The error to map
+     * @param mappings Array of pattern and factory mappings
+     * @param defaultFactory Default factory function if no pattern matches
+     * @returns The mapped error
+     */
+    static mapError<T extends Error>(error: unknown, mappings: ErrorMapping<T>[], defaultFactory?: (error: unknown, context?: Record<string, unknown>) => T): T | Error;
+    /**
+     * Format an error for consistent response structure
+     * @param error The error to format
+     * @returns Formatted error object
+     */
+    static formatError(error: unknown): Record<string, unknown>;
+    /**
+     * Safely execute a function and handle any errors
+     * @param fn Function to execute
+     * @param options Error handling options
+     * @returns The result of the function or error
+     */
+    static tryCatch<T>(fn: () => Promise<T> | T, options: ErrorHandlerOptions): Promise<T>;
+}
+//# sourceMappingURL=errorHandler.d.ts.map

package/dist/utils/internal/errorHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorHandler.d.ts","sourceRoot":"","sources":["../../../src/utils/internal/errorHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAY,MAAM,8BAA8B,CAAC;AAIvE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,yDAAyD;IACzD,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kDAAkD;IAClD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yDAAyD;IACzD,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,mCAAmC;IACnC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,CAAC;IACxC,8CAA8C;IAC9C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,4CAA4C;IAC5C,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,mCAAmC;IACnC,SAAS,EAAE,aAAa,CAAC;IACzB,oCAAoC;IACpC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK,CACnD,SAAQ,gBAAgB;IACxB,kDAAkD;IAClD,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAClE,qDAAqD;IACrD,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAuGD;;GAEG;AACH,qBAAa,YAAY;IACvB;;;;OAIG;WACW,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa;IAgC/D;;;;;OAKG;WACW,WAAW,CACvB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,mBAAmB,GAC3B,KAAK;IAoFR;;;;;;OAMG;WACW,QAAQ,CAAC,CAAC,SAAS,KAAK,EACpC,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,EAC3B,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,GACxE,CAAC,GAAG,KAAK;IAiCZ;;;;OAIG;WACW,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IA4BlE;;;;;OAKG;WACiB,QAAQ,CAAC,CAAC,EAC5B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,CAAC,CAAC;CAOd"}

package/dist/utils/internal/errorHandler.js

@@ -108,8 +108,9 @@ export class ErrorHandler {
         const errorName = getErrorName(error);
         const errorMessage = getErrorMessage(error);
         // Check if the error type has a direct mapping
-        if (errorName in ERROR_TYPE_MAPPINGS) {
-            return ERROR_TYPE_MAPPINGS[errorName];
+        const mappedError = ERROR_TYPE_MAPPINGS[errorName];
+        if (mappedError) {
+            return mappedError;
         }
         // Check for common error patterns
         for (const pattern of COMMON_ERROR_PATTERNS) {
@@ -140,7 +141,7 @@ export class ErrorHandler {
             // Create a new error to avoid mutating a readonly property
             const updatedError = new McpError(error.code, error.message, newDetails);
             // Log the error with sanitized input
-            logger.error(`Error ${operation}: ${updatedError.message}`, {
+            logger.error(`Error in ${operation}: ${updatedError.message}`, {
                 errorCode: updatedError.code,
                 requestId: context?.requestId,
                 input: input ? sanitizeInputForLogging(input) : undefined,
@@ -157,7 +158,7 @@ export class ErrorHandler {
         // Sanitize input for logging
         const sanitizedInput = input ? sanitizeInputForLogging(input) : undefined;
         // Log the error with consistent format
-        logger.error(`Error ${operation}`, {
+        logger.error(`Error in ${operation}: ${getErrorMessage(error)}`, {
             error: getErrorMessage(error), // Use helper function
             errorType: getErrorName(error),
             input: sanitizedInput,
@@ -176,7 +177,7 @@ export class ErrorHandler {
             transformedError = options.errorMapper(error);
         }
         else {
-            transformedError = new McpError(errorCode, `Error ${operation}: ${getErrorMessage(error)}`, // Use helper function
+            transformedError = new McpError(errorCode, `Error in ${operation}: ${getErrorMessage(error)}`, // Use helper function
             {
                 originalError: getErrorName(error),
                 ...context,
@@ -247,7 +248,7 @@ export class ErrorHandler {
         return {
             code: BaseErrorCode.UNKNOWN_ERROR,
             message: String(error),
-            details: { errorType: typeof error },
+            details: { errorType: "string" },
         };
     }
     /**
@@ -265,3 +266,4 @@ export class ErrorHandler {
         }
     }
 }
+//# sourceMappingURL=errorHandler.js.map

package/dist/utils/internal/errorHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorHandler.js","sourceRoot":"","sources":["../../../src/utils/internal/errorHandler.ts"],"names":[],"mappings":"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"}

package/dist/utils/internal/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./errorHandler.js";
+export * from "./logger.js";
+export * from "./requestContext.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/internal/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/internal/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC"}

package/dist/utils/internal/index.js

@@ -1,3 +1,4 @@
 export * from "./errorHandler.js";
 export * from "./logger.js";
 export * from "./requestContext.js";
+//# sourceMappingURL=index.js.map

package/dist/utils/internal/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/internal/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC"}

package/dist/utils/internal/logger.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Supported logging levels based on RFC 5424 Syslog severity levels used by MCP.
+ * emerg: 0, alert: 1, crit: 2, error: 3, warning: 4, notice: 5, info: 6, debug: 7
+ */
+export type McpLogLevel = "debug" | "info" | "notice" | "warning" | "error" | "crit" | "alert" | "emerg";
+export type McpNotificationSender = (level: McpLogLevel, data: Record<string, unknown>, loggerName?: string) => void;
+/**
+ * Singleton Logger wrapping Winston, adapted for MCP.
+ * Logs to files and optionally sends MCP notifications/message.
+ */
+export declare class Logger {
+    private static instance;
+    private winstonLogger?;
+    private initialized;
+    private mcpNotificationSender?;
+    private currentMcpLevel;
+    private currentWinstonLevel;
+    private constructor();
+    /**
+     * Initialize Winston logger for file transport. Must be called once at app start.
+     * Console transport is added conditionally.
+     * @param level Initial minimum level to log ('info' default).
+     */
+    initialize(level?: McpLogLevel): Promise<void>;
+    /**
+     * Sets the function used to send MCP 'notifications/message'.
+     */
+    setMcpNotificationSender(sender: McpNotificationSender | undefined): void;
+    /**
+     * Dynamically sets the minimum logging level.
+     */
+    setLevel(newLevel: McpLogLevel): void;
+    /** Get singleton instance. */
+    static getInstance(): Logger;
+    /**
+     * Resets the singleton instance for testing purposes.
+     * This should only be used in test environments.
+     */
+    static resetForTesting(): void;
+    /** Ensures the logger has been initialized. */
+    private ensureInitialized;
+    /** Centralized log processing */
+    private log;
+    debug(msg: string, context?: Record<string, unknown>): void;
+    info(msg: string, context?: Record<string, unknown>): void;
+    notice(msg: string, context?: Record<string, unknown>): void;
+    warning(msg: string, context?: Record<string, unknown>): void;
+    error(msg: string, err?: Error | Record<string, unknown>, context?: Record<string, unknown>): void;
+    crit(msg: string, err?: Error | Record<string, unknown>, context?: Record<string, unknown>): void;
+    alert(msg: string, err?: Error | Record<string, unknown>, context?: Record<string, unknown>): void;
+    emerg(msg: string, err?: Error | Record<string, unknown>, context?: Record<string, unknown>): void;
+    fatal(msg: string, err?: Error | Record<string, unknown>, context?: Record<string, unknown>): void;
+}
+export declare const logger: Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/internal/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/utils/internal/logger.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,MAAM,MAAM,WAAW,GACnB,OAAO,GACP,MAAM,GACN,QAAQ,GACR,SAAS,GACT,OAAO,GACP,MAAM,GACN,OAAO,GACP,OAAO,CAAC;AA8BZ,MAAM,MAAM,qBAAqB,GAAG,CAClC,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,UAAU,CAAC,EAAE,MAAM,KAChB,IAAI,CAAC;AAgEV;;;GAGG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAS;IAChC,OAAO,CAAC,aAAa,CAAC,CAAiB;IACvC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,qBAAqB,CAAC,CAAwB;IACtD,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,mBAAmB,CAA+C;IAE1E,OAAO;IAEP;;;;OAIG;IACU,UAAU,CAAC,KAAK,GAAE,WAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAwHnE;;OAEG;IACI,wBAAwB,CAC7B,MAAM,EAAE,qBAAqB,GAAG,SAAS,GACxC,IAAI;IAMP;;OAEG;IACI,QAAQ,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI;IAkD5C,8BAA8B;WAChB,WAAW,IAAI,MAAM;IAOnC;;;OAGG;WACW,eAAe,IAAI,IAAI;IAKrC,+CAA+C;IAC/C,OAAO,CAAC,iBAAiB;IAWzB,iCAAiC;IACjC,OAAO,CAAC,GAAG;IA+CJ,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAG3D,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAG1D,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAG5D,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAG7D,KAAK,CACV,GAAG,EAAE,MAAM,EACX,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI;IAMA,IAAI,CACT,GAAG,EAAE,MAAM,EACX,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI;IAMA,KAAK,CACV,GAAG,EAAE,MAAM,EACX,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI;IAMA,KAAK,CACV,GAAG,EAAE,MAAM,EACX,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI;IAMA,KAAK,CACV,GAAG,EAAE,MAAM,EACX,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI;CAMR;AAGD,eAAO,MAAM,MAAM,QAAuB,CAAC"}

package/dist/utils/internal/logger.js

@@ -81,7 +81,7 @@ function createWinstonConsoleFormat() {
  * Singleton Logger wrapping Winston, adapted for MCP.
  * Logs to files and optionally sends MCP notifications/message.
  */
-class Logger {
+export class Logger {
     static instance;
     winstonLogger;
     initialized = false;
@@ -242,6 +242,14 @@ class Logger {
         }
         return Logger.instance;
     }
+    /**
+     * Resets the singleton instance for testing purposes.
+     * This should only be used in test environments.
+     */
+    static resetForTesting() {
+        // This allows tests to get a fresh instance for each run.
+        Logger.instance = new Logger();
+    }
     /** Ensures the logger has been initialized. */
     ensureInitialized() {
         if (!this.initialized || !this.winstonLogger) {
@@ -273,10 +281,13 @@ class Logger {
             if (context)
                 mcpDataPayload.context = context;
             if (error) {
-                mcpDataPayload.error = { message: error.message };
+                const errorPayload = {
+                    message: error.message,
+                };
                 if (this.currentMcpLevel === "debug" && error.stack) {
-                    mcpDataPayload.error.stack = error.stack.substring(0, 500);
+                    errorPayload.stack = error.stack.substring(0, 500);
                 }
+                mcpDataPayload.error = errorPayload;
             }
             try {
                 this.mcpNotificationSender(level, mcpDataPayload, config.mcpServerName);
@@ -324,9 +335,12 @@ class Logger {
         const combinedContext = err instanceof Error ? context : { ...(err || {}), ...(context || {}) };
         this.log("emerg", msg, combinedContext, errorObj);
     }
-    fatal(msg, context, error) {
-        this.log("emerg", msg, context, error);
+    fatal(msg, err, context) {
+        const errorObj = err instanceof Error ? err : undefined;
+        const combinedContext = err instanceof Error ? context : { ...(err || {}), ...(context || {}) };
+        this.log("emerg", msg, combinedContext, errorObj);
     }
 }
 // Export singleton instance
 export const logger = Logger.getInstance();
+//# sourceMappingURL=logger.js.map