@novorb/mcp-core 2.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Novorb
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,179 @@
+# NOVORB - MCP Core
+
+---
+
+[![npm](https://img.shields.io/badge/%40novorb%2Fmcp--core-2.1.0-blue)](https://www.npmjs.com/package/@novorb/mcp-core)
+[![Node](https://img.shields.io/badge/Node-22%2B-green)](https://nodejs.org/)
+[![Tests](https://img.shields.io/badge/Tests-98-purple)]()
+[![License](https://img.shields.io/badge/License-MIT-yellow)](LICENSE)
+
+Shared TypeScript utilities for building MCP (Model Context Protocol) servers — logging, HTTP clients, retry logic, pagination, and transport — so every MCP server gets a consistent, tested foundation without reimplementing common patterns.
+
+## Features
+
+- **Structured logging** — file output with rotation, stderr output, text or JSON format, secret redaction
+- **HTTP client** — axios wrapper with automatic retry on 429/5xx, request logging, pagination
+- **Retry with backoff** — exponential backoff with jitter, configurable retries and delays
+- **Pagination helpers** — normalize params, compute metadata, paginate arrays in memory
+- **Unified transport** — stdio and stateless streamable-HTTP with built-in auth and DNS-rebinding protection
+- **Server builder** — `McpServer` factory, annotation presets, and SDK re-exports from one import point
+- **ESM native** — built as ES modules with full TypeScript declarations
+
+## Documentation
+
+- **[CLAUDE.md](CLAUDE.md)** — agent/contributor context and working conventions
+- **[docs/TESTING.md](docs/TESTING.md)** — test runner commands, conventions, and guidelines
+
+## Installation
+
+```bash
+npm install @novorb/mcp-core
+```
+
+## Modules
+
+### Logger
+
+Unified logger supporting file output (with rotation) and stderr output, in text or structured JSON format. MCP servers use stdio for protocol communication, so logging to stdout/stderr directly isn't always possible — file-based logging solves this. Sensitive-keyed fields in `meta` are redacted before serialisation.
+
+```typescript
+import { initLogger, LogLevel } from '@novorb/mcp-core';
+
+// File-based (writes to logs/mcp.log with rotation)
+const logger = initLogger({
+  output: 'file',
+  logDir: './logs',
+  level: LogLevel.INFO,
+});
+
+// Stderr with structured JSON
+const logger = initLogger({
+  output: 'stderr',
+  format: 'json',
+});
+
+logger.info('Server started', 'Server');
+logger.error('Request failed', 'HttpClient', { status: 500, path: '/api/items' });
+```
+
+### HTTP Client
+
+Pre-configured axios wrapper with automatic retry on transient failures (429, 5xx, network errors) for idempotent methods, request/response logging, and pagination support via `X-Total-Count` headers.
+
+```typescript
+import { createHttpClient } from '@novorb/mcp-core';
+
+const client = createHttpClient({
+  baseURL: 'https://api.example.com',
+  headers: { 'Authorization': 'Bearer token' },
+  retries: 3,
+  logContext: 'MyApiClient',
+});
+
+const item = await client.get('/items/1');
+const { data, totalCount } = await client.getPaginated('/items', { page: 1, per_page: 50 });
+await client.post('/items', { name: 'new item' });
+```
+
+### Retry
+
+Exponential backoff with jitter for retrying failed operations. Used internally by the HTTP client, but also available standalone.
+
+```typescript
+import { retryWithBackoff, isRetryableError } from '@novorb/mcp-core';
+
+const result = await retryWithBackoff(async (ctx) => {
+  console.log(`Attempt ${ctx.attempt + 1}/${ctx.maxRetries + 1}`);
+  return await someUnreliableOperation();
+}, {
+  maxRetries: 3,
+  initialDelayMs: 1000,
+  backoffMultiplier: 2,
+});
+```
+
+### Pagination
+
+Normalize pagination parameters, compute metadata, and paginate arrays in memory.
+
+```typescript
+import { normalizePagination, createPaginationMetadata, paginateArray } from '@novorb/mcp-core';
+
+const params = normalizePagination({ page: 3, per_page: 200 });
+// { page: 3, per_page: 100 }  (capped at max)
+
+const metadata = createPaginationMetadata(500, params);
+// { totalCount: 500, page: 3, perPage: 100, totalPages: 5 }
+
+const { data, metadata } = paginateArray(allItems, { page: 2, per_page: 20 });
+```
+
+### Transport
+
+Unified transport that selects between stdio and stateless streamable HTTP based on the `MCP_TRANSPORT` environment variable. HTTP mode is fail-closed (refuses to start without auth unless explicitly disabled) and supports Bearer-token auth, body-size caps, and opt-in DNS-rebinding protection.
+
+```typescript
+import { startMcpServer } from '@novorb/mcp-core/transport';
+
+// Factory (recommended for HTTP — fresh server instance per request):
+await startMcpServer(() => createServer(services));
+
+// Server instance (fine for stdio):
+await startMcpServer(server);
+```
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `MCP_TRANSPORT` | `stdio` | Transport mode: `stdio` or `http` |
+| `PORT` | `8080` | HTTP listen port |
+| `MCP_HTTP_HOST` | `0.0.0.0` | Bind address (`127.0.0.1` for local-only) |
+| `MCP_API_KEY` | none | Bearer token for HTTP auth (required in HTTP mode unless disabled) |
+| `MCP_AUTH_DISABLED` | `false` | Set `true` to run HTTP without auth (only behind a fronting gateway) |
+| `MCP_MAX_BODY_BYTES` | 4 MiB | Max accepted POST body size |
+| `MCP_ALLOWED_HOSTS` | none | Comma-separated Host allowlist (enables DNS-rebinding protection) |
+| `MCP_ALLOWED_ORIGINS` | none | Comma-separated Origin allowlist (enables DNS-rebinding protection) |
+
+### Server
+
+Import MCP server-building primitives from here instead of the SDK directly, to centralise the MCP dependency.
+
+```typescript
+import { createMcpServer, TOOL_ANNOTATIONS, completable } from '@novorb/mcp-core/server';
+import type { McpToolAnnotations, McpCallToolResult } from '@novorb/mcp-core/server';
+
+const server = createMcpServer('my-mcp', '1.0.0');
+
+server.registerTool('lookup', {
+  description: 'Look up a value',
+  inputSchema: { key: z.string() },
+  outputSchema: { value: z.string(), found: z.boolean() },
+  annotations: TOOL_ANNOTATIONS.readOnly,
+}, async ({ key }) => ({
+  content: [{ type: 'text', text: value }],
+  structuredContent: { value, found: true },
+}));
+```
+
+**`TOOL_ANNOTATIONS` presets:** `readOnly` (lookups/searches), `idempotentWrite` (upserts), `mutableWrite` (non-idempotent writes), `destructive` (deletes/overwrites).
+
+## Testing
+
+```bash
+npm test            # 67 tests
+npm run test:watch  # watch mode
+npm run test:coverage
+```
+
+> **Windows note:** the test scripts set `NODE_OPTIONS=` inline, which is Unix shell syntax. On Windows, invoke jest directly via a bash shell. See [docs/TESTING.md](docs/TESTING.md).
+
+## Building
+
+```bash
+npm run build   # tsc → dist/
+```
+
+This is an ESM package (`"type": "module"`). `tsconfig.json` is self-contained so it builds standalone.
+
+## License
+
+[MIT](LICENSE)

package/dist/http-client.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @novorb/mcp-core — HTTP Client Factory
+ *
+ * Creates pre-configured axios instances with retry logic and logging.
+ */
+import { AxiosInstance } from 'axios';
+import { Logger } from './logger.js';
+export interface HttpClientConfig {
+    /** Base URL for all requests */
+    baseURL: string;
+    /** Request timeout in milliseconds (default: 30000) */
+    timeout?: number;
+    /** Default headers to include on every request */
+    headers?: Record<string, string>;
+    /** Number of retries on retryable failures (default: 3) */
+    retries?: number;
+    /** Logger instance (default: singleton from getLogger) */
+    logger?: Logger;
+    /** Component name for log messages (default: 'HttpClient') */
+    logContext?: string;
+}
+export interface PaginatedResponse<T> {
+    data: T[];
+    totalCount: number;
+}
+/**
+ * MCP HTTP client wrapping axios with retry, logging, and pagination support.
+ */
+export declare class McpHttpClient {
+    private client;
+    private logger;
+    private logContext;
+    constructor(config: HttpClientConfig);
+    /**
+     * Perform a GET request.
+     */
+    get<T>(path: string, params?: Record<string, unknown>): Promise<T>;
+    /**
+     * Perform a GET request with pagination.
+     * Reads total count from the X-Total-Count response header.
+     */
+    getPaginated<T>(path: string, params?: Record<string, unknown>): Promise<PaginatedResponse<T>>;
+    /**
+     * Perform a POST request.
+     */
+    post<T>(path: string, data?: unknown, params?: Record<string, unknown>): Promise<T>;
+    /**
+     * Perform a PUT request.
+     */
+    put<T>(path: string, data?: unknown, params?: Record<string, unknown>): Promise<T>;
+    /**
+     * Perform a PATCH request.
+     */
+    patch<T>(path: string, data?: unknown, params?: Record<string, unknown>): Promise<T>;
+    /**
+     * Perform a DELETE request.
+     */
+    delete<T>(path: string, params?: Record<string, unknown>): Promise<T>;
+    /**
+     * Get the underlying axios instance for advanced use cases.
+     */
+    getAxiosInstance(): AxiosInstance;
+    private normalizeError;
+}
+/**
+ * Create a configured HTTP client.
+ */
+export declare function createHttpClient(config: HttpClientConfig): McpHttpClient;
+//# sourceMappingURL=http-client.d.ts.map

package/dist/http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../src/http-client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAc,EAAE,aAAa,EAAc,MAAM,OAAO,CAAC;AAEzD,OAAO,EAAa,MAAM,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAS;gBAEf,MAAM,EAAE,gBAAgB;IAmCpC;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAsBxE;;;OAGG;IACG,YAAY,CAAC,CAAC,EAClB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAyBhC;;OAEG;IACG,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAsBzF;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAsBxF;;OAEG;IACG,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAsB1F;;OAEG;IACG,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAsB3E;;OAEG;IACH,gBAAgB,IAAI,aAAa;IAIjC,OAAO,CAAC,cAAc;CAkBvB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,aAAa,CAExE"}

package/dist/http-client.js

@@ -0,0 +1,228 @@
+/**
+ * @novorb/mcp-core — HTTP Client Factory
+ *
+ * Creates pre-configured axios instances with retry logic and logging.
+ */
+import axios from 'axios';
+import axiosRetry from 'axios-retry';
+import { getLogger } from './logger.js';
+/**
+ * MCP HTTP client wrapping axios with retry, logging, and pagination support.
+ */
+export class McpHttpClient {
+    client;
+    logger;
+    logContext;
+    constructor(config) {
+        this.logger = config.logger || getLogger();
+        this.logContext = config.logContext || 'HttpClient';
+        this.client = axios.create({
+            baseURL: config.baseURL,
+            timeout: config.timeout || 30000,
+            // Never follow redirects: the instance carries a static Authorization header, and axios re-sends
+            // request data to a 3xx Location — a malicious/compromised upstream could harvest the credential.
+            maxRedirects: 0,
+            // Cap response/request size (OOM/DoS guard).
+            maxContentLength: 25 * 1024 * 1024,
+            maxBodyLength: 25 * 1024 * 1024,
+            headers: {
+                'Content-Type': 'application/json',
+                ...config.headers,
+            },
+        });
+        axiosRetry(this.client, {
+            retries: config.retries ?? 3,
+            retryDelay: axiosRetry.exponentialDelay,
+            retryCondition: (error) => {
+                // Network/idempotent-request errors are already method-safe. Only ALSO retry 429/5xx for
+                // idempotent methods — never replay a non-idempotent POST/PATCH (duplicate side effects).
+                if (axiosRetry.isNetworkOrIdempotentRequestError(error))
+                    return true;
+                const method = (error.config?.method ?? 'get').toLowerCase();
+                const idempotent = ['get', 'head', 'options', 'put', 'delete'].includes(method);
+                const status = error.response?.status;
+                const retryableStatus = status === 429 || (status !== undefined && status >= 500);
+                return idempotent && retryableStatus;
+            },
+        });
+    }
+    /**
+     * Perform a GET request.
+     */
+    async get(path, params) {
+        const startTime = Date.now();
+        this.logger.debug(`GET ${path}`, this.logContext, { params });
+        try {
+            const response = await this.client.get(path, { params });
+            const duration = Date.now() - startTime;
+            this.logger.debug(`GET ${path} completed`, this.logContext, {
+                status: response.status,
+                duration: `${duration}ms`,
+            });
+            return response.data;
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            this.logger.error(`GET ${path} failed`, this.logContext, {
+                duration: `${duration}ms`,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw this.normalizeError(error);
+        }
+    }
+    /**
+     * Perform a GET request with pagination.
+     * Reads total count from the X-Total-Count response header.
+     */
+    async getPaginated(path, params) {
+        const startTime = Date.now();
+        this.logger.debug(`GET (paginated) ${path}`, this.logContext, { params });
+        try {
+            const response = await this.client.get(path, { params });
+            const totalCount = parseInt(response.headers['x-total-count'] || '0', 10);
+            const duration = Date.now() - startTime;
+            this.logger.debug(`GET (paginated) ${path} completed`, this.logContext, {
+                status: response.status,
+                totalCount,
+                resultCount: response.data.length,
+                duration: `${duration}ms`,
+            });
+            return { data: response.data, totalCount };
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            this.logger.error(`GET (paginated) ${path} failed`, this.logContext, {
+                duration: `${duration}ms`,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw this.normalizeError(error);
+        }
+    }
+    /**
+     * Perform a POST request.
+     */
+    async post(path, data, params) {
+        const startTime = Date.now();
+        this.logger.debug(`POST ${path}`, this.logContext);
+        try {
+            const response = await this.client.post(path, data, { params });
+            const duration = Date.now() - startTime;
+            this.logger.debug(`POST ${path} completed`, this.logContext, {
+                status: response.status,
+                duration: `${duration}ms`,
+            });
+            return response.data;
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            this.logger.error(`POST ${path} failed`, this.logContext, {
+                duration: `${duration}ms`,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw this.normalizeError(error);
+        }
+    }
+    /**
+     * Perform a PUT request.
+     */
+    async put(path, data, params) {
+        const startTime = Date.now();
+        this.logger.debug(`PUT ${path}`, this.logContext);
+        try {
+            const response = await this.client.put(path, data, { params });
+            const duration = Date.now() - startTime;
+            this.logger.debug(`PUT ${path} completed`, this.logContext, {
+                status: response.status,
+                duration: `${duration}ms`,
+            });
+            return response.data;
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            this.logger.error(`PUT ${path} failed`, this.logContext, {
+                duration: `${duration}ms`,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw this.normalizeError(error);
+        }
+    }
+    /**
+     * Perform a PATCH request.
+     */
+    async patch(path, data, params) {
+        const startTime = Date.now();
+        this.logger.debug(`PATCH ${path}`, this.logContext);
+        try {
+            const response = await this.client.patch(path, data, { params });
+            const duration = Date.now() - startTime;
+            this.logger.debug(`PATCH ${path} completed`, this.logContext, {
+                status: response.status,
+                duration: `${duration}ms`,
+            });
+            return response.data;
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            this.logger.error(`PATCH ${path} failed`, this.logContext, {
+                duration: `${duration}ms`,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw this.normalizeError(error);
+        }
+    }
+    /**
+     * Perform a DELETE request.
+     */
+    async delete(path, params) {
+        const startTime = Date.now();
+        this.logger.debug(`DELETE ${path}`, this.logContext);
+        try {
+            const response = await this.client.delete(path, { params });
+            const duration = Date.now() - startTime;
+            this.logger.debug(`DELETE ${path} completed`, this.logContext, {
+                status: response.status,
+                duration: `${duration}ms`,
+            });
+            return response.data;
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            this.logger.error(`DELETE ${path} failed`, this.logContext, {
+                duration: `${duration}ms`,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw this.normalizeError(error);
+        }
+    }
+    /**
+     * Get the underlying axios instance for advanced use cases.
+     */
+    getAxiosInstance() {
+        return this.client;
+    }
+    normalizeError(error) {
+        if (axios.isAxiosError(error)) {
+            const status = error.response?.status;
+            const statusText = error.response?.statusText;
+            const data = error.response?.data;
+            const message = typeof data === 'object' && data?.message
+                ? data.message
+                : `HTTP ${status} ${statusText}`;
+            const normalized = new Error(message);
+            // Attach only the status — NOT the raw axios `response`. Its `config` carries the request's
+            // Authorization header/token, and the upstream response headers may carry set-cookie/auth
+            // echoes; a consumer logging the thrown error would otherwise leak them.
+            normalized.status = status;
+            normalized.statusText = statusText;
+            return normalized;
+        }
+        return error instanceof Error ? error : new Error(String(error));
+    }
+}
+/**
+ * Create a configured HTTP client.
+ */
+export function createHttpClient(config) {
+    return new McpHttpClient(config);
+}
+//# sourceMappingURL=http-client.js.map

package/dist/http-client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @novorb/mcp-core
+ *
+ * Shared utilities for MCP servers.
+ */
+export { Logger, LogLevel, initLogger, getLogger, resetLogger, type LoggerConfig, } from './logger.js';
+export { retryWithBackoff, calculateRetryDelay, isRetryableError, sleep, parseRetryAfter, type RetryOptions, type RetryContext, } from './retry.js';
+export { normalizePagination, createPaginationMetadata, pageToOffset, paginateArray, type PaginationParams, type NormalizedPagination, type PaginationMetadata, } from './pagination.js';
+export { McpHttpClient, createHttpClient, type HttpClientConfig, type PaginatedResponse, } from './http-client.js';
+export { startMcpServer, type TransportMode, type TransportOptions, } from './transport.js';
+export { McpServer, completable, createMcpServer, TOOL_ANNOTATIONS, type McpToolAnnotations, type McpCallToolResult, } from './server.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,MAAM,EACN,QAAQ,EACR,UAAU,EACV,SAAS,EACT,WAAW,EACX,KAAK,YAAY,GAClB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,KAAK,EACL,eAAe,EACf,KAAK,YAAY,EACjB,KAAK,YAAY,GAClB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,YAAY,EACZ,aAAa,EACb,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,GACxB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACvB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,SAAS,EACT,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,GACvB,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+/**
+ * @novorb/mcp-core
+ *
+ * Shared utilities for MCP servers.
+ */
+// Logger
+export { Logger, LogLevel, initLogger, getLogger, resetLogger, } from './logger.js';
+// Retry
+export { retryWithBackoff, calculateRetryDelay, isRetryableError, sleep, parseRetryAfter, } from './retry.js';
+// Pagination
+export { normalizePagination, createPaginationMetadata, pageToOffset, paginateArray, } from './pagination.js';
+// HTTP Client
+export { McpHttpClient, createHttpClient, } from './http-client.js';
+// Transport
+export { startMcpServer, } from './transport.js';
+// Server builder (McpServer patterns, re-exports, annotation presets)
+export { McpServer, completable, createMcpServer, TOOL_ANNOTATIONS, } from './server.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,SAAS;AACT,OAAO,EACL,MAAM,EACN,QAAQ,EACR,UAAU,EACV,SAAS,EACT,WAAW,GAEZ,MAAM,aAAa,CAAC;AAErB,QAAQ;AACR,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,KAAK,EACL,eAAe,GAGhB,MAAM,YAAY,CAAC;AAEpB,aAAa;AACb,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,YAAY,EACZ,aAAa,GAId,MAAM,iBAAiB,CAAC;AAEzB,cAAc;AACd,OAAO,EACL,aAAa,EACb,gBAAgB,GAGjB,MAAM,kBAAkB,CAAC;AAE1B,YAAY;AACZ,OAAO,EACL,cAAc,GAGf,MAAM,gBAAgB,CAAC;AAExB,sEAAsE;AACtE,OAAO,EACL,SAAS,EACT,WAAW,EACX,eAAe,EACf,gBAAgB,GAGjB,MAAM,aAAa,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,80 @@
+/**
+ * @novorb/mcp-core — Logger
+ *
+ * Unified logger for MCP servers. Supports two output modes:
+ * - file: writes to rotating log files (for stdio-based MCP servers)
+ * - stderr: writes to stderr (for Docker / HTTP transport)
+ *
+ * Log format (text): 2026-03-22T13:27:58.513Z | INFO  | Server | Starting...
+ * Log format (json): {"level":"INFO","timestamp":"...","component":"Server","message":"Starting..."}
+ *
+ * Environment variables (read once at first logger creation):
+ * - LOG_LEVEL: DEBUG, INFO, WARN, ERROR (default: INFO)
+ * - LOG_PATH: log directory (default: ./logs)
+ * - LOG_FILE: log file name (default: mcp.log)
+ *
+ * Security: `meta` is passed through `redactSecrets()` before serialisation — sensitive-keyed fields
+ * (authorization/token/api_key/secret/password/cookie/...) are replaced with `[REDACTED]` so a
+ * consumer that logs an error object or request params never writes a credential in cleartext. In
+ * text mode the message + component are also stripped of CR/LF so a logged value can't forge log lines.
+ */
+export declare enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3
+}
+export interface LoggerConfig {
+    /** Minimum log level (default: INFO) */
+    level: LogLevel;
+    /** Output mode: 'file' writes to disk, 'stderr' writes to process.stderr */
+    output: 'file' | 'stderr';
+    /** Format: 'text' for human-readable, 'json' for structured (default: text) */
+    format: 'text' | 'json';
+    /** Directory for log files (file mode only) */
+    logDir: string;
+    /** Log file name (file mode only, default: mcp.log) */
+    logFile: string;
+    /** Max log file size in bytes before rotation (default: 10MB) */
+    maxLogSize: number;
+    /** Max number of rotated log files to keep (default: 5) */
+    maxLogFiles: number;
+}
+/** Recursively copy a value, replacing any sensitive-keyed field with `[REDACTED]`. */
+export declare function redactSecrets(value: unknown, depth?: number): unknown;
+export declare class Logger {
+    private config;
+    private logPath;
+    constructor(config?: Partial<LoggerConfig>);
+    private ensureLogDirectory;
+    private shouldLog;
+    private formatText;
+    private formatJson;
+    private format;
+    private write;
+    private writeToFile;
+    private rotateLog;
+    debug(message: string, context?: string, meta?: unknown): void;
+    info(message: string, context?: string, meta?: unknown): void;
+    warn(message: string, context?: string, meta?: unknown): void;
+    error(message: string, context?: string, meta?: unknown): void;
+    setLevel(level: LogLevel): void;
+}
+/**
+ * Initialize logger with custom config.
+ * Should be called once at application startup.
+ * Reads LOG_LEVEL, LOG_PATH, LOG_FILE from env (overrides take precedence).
+ */
+export declare function initLogger(config?: Partial<LoggerConfig>): Logger;
+/**
+ * Get the logger instance.
+ * Creates a default stderr/text instance if initLogger was not called.
+ * Reads LOG_LEVEL, LOG_PATH, LOG_FILE from env on first creation.
+ */
+export declare function getLogger(config?: Partial<LoggerConfig>): Logger;
+/**
+ * Reset the singleton (for testing).
+ */
+export declare function resetLogger(): void;
+export default getLogger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAKH,oBAAY,QAAQ;IAClB,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;CACV;AAYD,MAAM,WAAW,YAAY;IAC3B,wCAAwC;IACxC,KAAK,EAAE,QAAQ,CAAC;IAChB,4EAA4E;IAC5E,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC1B,+EAA+E;IAC/E,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;CACrB;AAiCD,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,SAAI,GAAG,OAAO,CAQhE;AAoBD,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC;IAS1C,OAAO,CAAC,kBAAkB;IAM1B,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,UAAU;IAkBlB,OAAO,CAAC,MAAM;IAMd,OAAO,CAAC,KAAK;IAYb,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,SAAS;IAqBjB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI9D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI7D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI7D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI9D,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;CAGhC;AAKD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,MAAM,CAGjE;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,MAAM,CAKhE;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC;AAED,eAAe,SAAS,CAAC"}