@leanmcp/core 0.3.13 → 0.3.15

package/README.md

@@ -1,6 +1,6 @@
 <p align="center">
   <img
-    src="https://raw.githubusercontent.com/LeanMCP/leanmcp-sdk/refs/heads/main/assets/logo.svg"
+    src="https://raw.githubusercontent.com/LeanMCP/leanmcp-sdk/refs/heads/main/assets/logo.png"
     alt="LeanMCP Logo"
     width="400"
   />

package/dist/index.d.mts

@@ -1,5 +1,133 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 
+/**
+ * Simple configurable logger for LeanMCP SDK
+ */
+declare enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3,
+    NONE = 4
+}
+interface LoggerOptions {
+    level?: LogLevel;
+    prefix?: string;
+    timestamps?: boolean;
+    /**
+     * Enable or disable ANSI colors. Defaults to true.
+     */
+    colorize?: boolean;
+    /**
+     * Provide additional metadata context (e.g. module name)
+     */
+    context?: string;
+    /**
+     * Optional third-party handlers (PostHog, Sentry, etc.)
+     * They receive the structured payload for easy integration.
+     */
+    handlers?: LoggerHandler[];
+}
+interface LogPayload {
+    level: LogLevel;
+    levelLabel: string;
+    message: string;
+    args: any[];
+    prefix?: string;
+    context?: string;
+    timestamp: string;
+}
+type LoggerHandler = (payload: LogPayload) => void;
+declare class Logger {
+    private level;
+    private prefix;
+    private timestamps;
+    private colorize;
+    private context?;
+    private handlers;
+    constructor(options?: LoggerOptions);
+    private format;
+    private shouldLog;
+    private emit;
+    debug(message: string, ...args: any[]): void;
+    info(message: string, ...args: any[]): void;
+    warn(message: string, ...args: any[]): void;
+    error(message: string, ...args: any[]): void;
+    setLevel(level: LogLevel): void;
+    getLevel(): LogLevel;
+}
+declare const defaultLogger: Logger;
+
+interface HTTPServerOptions {
+    port?: number;
+    cors?: boolean | {
+        origin?: string | string[];
+        credentials?: boolean;
+    };
+    logging?: boolean;
+    logger?: Logger;
+    sessionTimeout?: number;
+    stateless?: boolean;
+    dashboard?: boolean;
+    /** OAuth/Auth configuration (MCP authorization spec) */
+    auth?: HTTPServerAuthOptions;
+}
+/**
+ * OAuth/Auth configuration for MCP server
+ *
+ * Enables MCP authorization spec compliance by exposing
+ * `/.well-known/oauth-protected-resource` (RFC 9728)
+ */
+interface HTTPServerAuthOptions {
+    /** Resource identifier (defaults to server URL) */
+    resource?: string;
+    /** Authorization servers (defaults to self) */
+    authorizationServers?: string[];
+    /** Supported OAuth scopes */
+    scopesSupported?: string[];
+    /** Documentation URL */
+    documentationUrl?: string;
+    /** Enable built-in OAuth authorization server */
+    enableOAuthServer?: boolean;
+    /** OAuth server options (when enableOAuthServer is true) */
+    oauthServerOptions?: {
+        /** Session secret for signing tokens/state */
+        sessionSecret: string;
+        /** JWT signing secret (defaults to sessionSecret if not provided) */
+        jwtSigningSecret?: string;
+        /** JWT encryption secret for encrypting upstream tokens */
+        jwtEncryptionSecret?: Buffer;
+        /** Issuer URL for JWTs */
+        issuer?: string;
+        /** Access token TTL in seconds (default: 3600) */
+        tokenTTL?: number;
+        /** Enable Dynamic Client Registration (for ChatGPT etc.) */
+        enableDCR?: boolean;
+        /** Upstream OAuth provider configuration */
+        upstreamProvider?: {
+            id: string;
+            authorizationEndpoint: string;
+            tokenEndpoint: string;
+            clientId: string;
+            clientSecret: string;
+            scopes?: string[];
+            userInfoEndpoint?: string;
+        };
+    };
+}
+interface MCPServerFactory {
+    (): Server | Promise<Server>;
+}
+type HTTPServerInput = MCPServerFactory | MCPServerConstructorOptions;
+/**
+ * Create an HTTP server for MCP with Streamable HTTP transport
+ * Returns the HTTP server instance to keep the process alive
+ *
+ * @param serverInput - Either MCPServerConstructorOptions or a factory function that returns a Server
+ * @param options - HTTP server options (only used when serverInput is a factory function)
+ */
+declare function createHTTPServer(serverInput: HTTPServerInput, options?: HTTPServerOptions): Promise<any>;
+
 /**
  * Security scheme for MCP tools (per MCP authorization spec)
  *
@@ -220,132 +348,6 @@ declare function SchemaConstraint(constraints: {
  */
 declare function classToJsonSchemaWithConstraints(classConstructor: new () => any): any;
 
-/**
- * Simple configurable logger for LeanMCP SDK
- */
-declare enum LogLevel {
-    DEBUG = 0,
-    INFO = 1,
-    WARN = 2,
-    ERROR = 3,
-    NONE = 4
-}
-interface LoggerOptions {
-    level?: LogLevel;
-    prefix?: string;
-    timestamps?: boolean;
-    /**
-     * Enable or disable ANSI colors. Defaults to true.
-     */
-    colorize?: boolean;
-    /**
-     * Provide additional metadata context (e.g. module name)
-     */
-    context?: string;
-    /**
-     * Optional third-party handlers (PostHog, Sentry, etc.)
-     * They receive the structured payload for easy integration.
-     */
-    handlers?: LoggerHandler[];
-}
-interface LogPayload {
-    level: LogLevel;
-    levelLabel: string;
-    message: string;
-    args: any[];
-    prefix?: string;
-    context?: string;
-    timestamp: string;
-}
-type LoggerHandler = (payload: LogPayload) => void;
-declare class Logger {
-    private level;
-    private prefix;
-    private timestamps;
-    private colorize;
-    private context?;
-    private handlers;
-    constructor(options?: LoggerOptions);
-    private format;
-    private shouldLog;
-    private emit;
-    debug(message: string, ...args: any[]): void;
-    info(message: string, ...args: any[]): void;
-    warn(message: string, ...args: any[]): void;
-    error(message: string, ...args: any[]): void;
-    setLevel(level: LogLevel): void;
-    getLevel(): LogLevel;
-}
-declare const defaultLogger: Logger;
-
-interface HTTPServerOptions {
-    port?: number;
-    cors?: boolean | {
-        origin?: string | string[];
-        credentials?: boolean;
-    };
-    logging?: boolean;
-    logger?: Logger;
-    sessionTimeout?: number;
-    stateless?: boolean;
-    dashboard?: boolean;
-    /** OAuth/Auth configuration (MCP authorization spec) */
-    auth?: HTTPServerAuthOptions;
-}
-/**
- * OAuth/Auth configuration for MCP server
- *
- * Enables MCP authorization spec compliance by exposing
- * `/.well-known/oauth-protected-resource` (RFC 9728)
- */
-interface HTTPServerAuthOptions {
-    /** Resource identifier (defaults to server URL) */
-    resource?: string;
-    /** Authorization servers (defaults to self) */
-    authorizationServers?: string[];
-    /** Supported OAuth scopes */
-    scopesSupported?: string[];
-    /** Documentation URL */
-    documentationUrl?: string;
-    /** Enable built-in OAuth authorization server */
-    enableOAuthServer?: boolean;
-    /** OAuth server options (when enableOAuthServer is true) */
-    oauthServerOptions?: {
-        /** Session secret for signing tokens/state */
-        sessionSecret: string;
-        /** JWT signing secret (defaults to sessionSecret if not provided) */
-        jwtSigningSecret?: string;
-        /** JWT encryption secret for encrypting upstream tokens */
-        jwtEncryptionSecret?: Buffer;
-        /** Issuer URL for JWTs */
-        issuer?: string;
-        /** Access token TTL in seconds (default: 3600) */
-        tokenTTL?: number;
-        /** Upstream OAuth provider configuration */
-        upstreamProvider?: {
-            id: string;
-            authorizationEndpoint: string;
-            tokenEndpoint: string;
-            clientId: string;
-            clientSecret: string;
-            scopes?: string[];
-            userInfoEndpoint?: string;
-        };
-    };
-}
-interface MCPServerFactory {
-    (): Server | Promise<Server>;
-}
-type HTTPServerInput = MCPServerFactory | MCPServerConstructorOptions;
-/**
- * Create an HTTP server for MCP with Streamable HTTP transport
- * Returns the HTTP server instance to keep the process alive
- *
- * @param serverInput - Either MCPServerConstructorOptions or a factory function that returns a Server
- * @param options - HTTP server options (only used when serverInput is a factory function)
- */
-declare function createHTTPServer(serverInput: HTTPServerInput, options?: HTTPServerOptions): Promise<any>;
-
 /**
  * Input validation utilities for LeanMCP
  * Provides secure validation for common input types
@@ -549,6 +551,9 @@ interface MCPServerConstructorOptions {
     };
     sessionTimeout?: number;
     stateless?: boolean;
+    dashboard?: boolean;
+    /** OAuth/Auth configuration (MCP authorization spec) - passed to HTTPServerOptions */
+    auth?: HTTPServerAuthOptions;
 }
 interface RegisteredTool {
     name: string;

package/dist/index.d.ts

@@ -1,5 +1,133 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 
+/**
+ * Simple configurable logger for LeanMCP SDK
+ */
+declare enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3,
+    NONE = 4
+}
+interface LoggerOptions {
+    level?: LogLevel;
+    prefix?: string;
+    timestamps?: boolean;
+    /**
+     * Enable or disable ANSI colors. Defaults to true.
+     */
+    colorize?: boolean;
+    /**
+     * Provide additional metadata context (e.g. module name)
+     */
+    context?: string;
+    /**
+     * Optional third-party handlers (PostHog, Sentry, etc.)
+     * They receive the structured payload for easy integration.
+     */
+    handlers?: LoggerHandler[];
+}
+interface LogPayload {
+    level: LogLevel;
+    levelLabel: string;
+    message: string;
+    args: any[];
+    prefix?: string;
+    context?: string;
+    timestamp: string;
+}
+type LoggerHandler = (payload: LogPayload) => void;
+declare class Logger {
+    private level;
+    private prefix;
+    private timestamps;
+    private colorize;
+    private context?;
+    private handlers;
+    constructor(options?: LoggerOptions);
+    private format;
+    private shouldLog;
+    private emit;
+    debug(message: string, ...args: any[]): void;
+    info(message: string, ...args: any[]): void;
+    warn(message: string, ...args: any[]): void;
+    error(message: string, ...args: any[]): void;
+    setLevel(level: LogLevel): void;
+    getLevel(): LogLevel;
+}
+declare const defaultLogger: Logger;
+
+interface HTTPServerOptions {
+    port?: number;
+    cors?: boolean | {
+        origin?: string | string[];
+        credentials?: boolean;
+    };
+    logging?: boolean;
+    logger?: Logger;
+    sessionTimeout?: number;
+    stateless?: boolean;
+    dashboard?: boolean;
+    /** OAuth/Auth configuration (MCP authorization spec) */
+    auth?: HTTPServerAuthOptions;
+}
+/**
+ * OAuth/Auth configuration for MCP server
+ *
+ * Enables MCP authorization spec compliance by exposing
+ * `/.well-known/oauth-protected-resource` (RFC 9728)
+ */
+interface HTTPServerAuthOptions {
+    /** Resource identifier (defaults to server URL) */
+    resource?: string;
+    /** Authorization servers (defaults to self) */
+    authorizationServers?: string[];
+    /** Supported OAuth scopes */
+    scopesSupported?: string[];
+    /** Documentation URL */
+    documentationUrl?: string;
+    /** Enable built-in OAuth authorization server */
+    enableOAuthServer?: boolean;
+    /** OAuth server options (when enableOAuthServer is true) */
+    oauthServerOptions?: {
+        /** Session secret for signing tokens/state */
+        sessionSecret: string;
+        /** JWT signing secret (defaults to sessionSecret if not provided) */
+        jwtSigningSecret?: string;
+        /** JWT encryption secret for encrypting upstream tokens */
+        jwtEncryptionSecret?: Buffer;
+        /** Issuer URL for JWTs */
+        issuer?: string;
+        /** Access token TTL in seconds (default: 3600) */
+        tokenTTL?: number;
+        /** Enable Dynamic Client Registration (for ChatGPT etc.) */
+        enableDCR?: boolean;
+        /** Upstream OAuth provider configuration */
+        upstreamProvider?: {
+            id: string;
+            authorizationEndpoint: string;
+            tokenEndpoint: string;
+            clientId: string;
+            clientSecret: string;
+            scopes?: string[];
+            userInfoEndpoint?: string;
+        };
+    };
+}
+interface MCPServerFactory {
+    (): Server | Promise<Server>;
+}
+type HTTPServerInput = MCPServerFactory | MCPServerConstructorOptions;
+/**
+ * Create an HTTP server for MCP with Streamable HTTP transport
+ * Returns the HTTP server instance to keep the process alive
+ *
+ * @param serverInput - Either MCPServerConstructorOptions or a factory function that returns a Server
+ * @param options - HTTP server options (only used when serverInput is a factory function)
+ */
+declare function createHTTPServer(serverInput: HTTPServerInput, options?: HTTPServerOptions): Promise<any>;
+
 /**
  * Security scheme for MCP tools (per MCP authorization spec)
  *
@@ -220,132 +348,6 @@ declare function SchemaConstraint(constraints: {
  */
 declare function classToJsonSchemaWithConstraints(classConstructor: new () => any): any;
 
-/**
- * Simple configurable logger for LeanMCP SDK
- */
-declare enum LogLevel {
-    DEBUG = 0,
-    INFO = 1,
-    WARN = 2,
-    ERROR = 3,
-    NONE = 4
-}
-interface LoggerOptions {
-    level?: LogLevel;
-    prefix?: string;
-    timestamps?: boolean;
-    /**
-     * Enable or disable ANSI colors. Defaults to true.
-     */
-    colorize?: boolean;
-    /**
-     * Provide additional metadata context (e.g. module name)
-     */
-    context?: string;
-    /**
-     * Optional third-party handlers (PostHog, Sentry, etc.)
-     * They receive the structured payload for easy integration.
-     */
-    handlers?: LoggerHandler[];
-}
-interface LogPayload {
-    level: LogLevel;
-    levelLabel: string;
-    message: string;
-    args: any[];
-    prefix?: string;
-    context?: string;
-    timestamp: string;
-}
-type LoggerHandler = (payload: LogPayload) => void;
-declare class Logger {
-    private level;
-    private prefix;
-    private timestamps;
-    private colorize;
-    private context?;
-    private handlers;
-    constructor(options?: LoggerOptions);
-    private format;
-    private shouldLog;
-    private emit;
-    debug(message: string, ...args: any[]): void;
-    info(message: string, ...args: any[]): void;
-    warn(message: string, ...args: any[]): void;
-    error(message: string, ...args: any[]): void;
-    setLevel(level: LogLevel): void;
-    getLevel(): LogLevel;
-}
-declare const defaultLogger: Logger;
-
-interface HTTPServerOptions {
-    port?: number;
-    cors?: boolean | {
-        origin?: string | string[];
-        credentials?: boolean;
-    };
-    logging?: boolean;
-    logger?: Logger;
-    sessionTimeout?: number;
-    stateless?: boolean;
-    dashboard?: boolean;
-    /** OAuth/Auth configuration (MCP authorization spec) */
-    auth?: HTTPServerAuthOptions;
-}
-/**
- * OAuth/Auth configuration for MCP server
- *
- * Enables MCP authorization spec compliance by exposing
- * `/.well-known/oauth-protected-resource` (RFC 9728)
- */
-interface HTTPServerAuthOptions {
-    /** Resource identifier (defaults to server URL) */
-    resource?: string;
-    /** Authorization servers (defaults to self) */
-    authorizationServers?: string[];
-    /** Supported OAuth scopes */
-    scopesSupported?: string[];
-    /** Documentation URL */
-    documentationUrl?: string;
-    /** Enable built-in OAuth authorization server */
-    enableOAuthServer?: boolean;
-    /** OAuth server options (when enableOAuthServer is true) */
-    oauthServerOptions?: {
-        /** Session secret for signing tokens/state */
-        sessionSecret: string;
-        /** JWT signing secret (defaults to sessionSecret if not provided) */
-        jwtSigningSecret?: string;
-        /** JWT encryption secret for encrypting upstream tokens */
-        jwtEncryptionSecret?: Buffer;
-        /** Issuer URL for JWTs */
-        issuer?: string;
-        /** Access token TTL in seconds (default: 3600) */
-        tokenTTL?: number;
-        /** Upstream OAuth provider configuration */
-        upstreamProvider?: {
-            id: string;
-            authorizationEndpoint: string;
-            tokenEndpoint: string;
-            clientId: string;
-            clientSecret: string;
-            scopes?: string[];
-            userInfoEndpoint?: string;
-        };
-    };
-}
-interface MCPServerFactory {
-    (): Server | Promise<Server>;
-}
-type HTTPServerInput = MCPServerFactory | MCPServerConstructorOptions;
-/**
- * Create an HTTP server for MCP with Streamable HTTP transport
- * Returns the HTTP server instance to keep the process alive
- *
- * @param serverInput - Either MCPServerConstructorOptions or a factory function that returns a Server
- * @param options - HTTP server options (only used when serverInput is a factory function)
- */
-declare function createHTTPServer(serverInput: HTTPServerInput, options?: HTTPServerOptions): Promise<any>;
-
 /**
  * Input validation utilities for LeanMCP
  * Provides secure validation for common input types
@@ -549,6 +551,9 @@ interface MCPServerConstructorOptions {
     };
     sessionTimeout?: number;
     stateless?: boolean;
+    dashboard?: boolean;
+    /** OAuth/Auth configuration (MCP authorization spec) - passed to HTTPServerOptions */
+    auth?: HTTPServerAuthOptions;
 }
 interface RegisteredTool {
     name: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leanmcp/core",
-  "version": "0.3.13",
+  "version": "0.3.15",
   "description": "Core library implementing decorators, reflection, and MCP runtime server",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -74,4 +74,4 @@
   "publishConfig": {
     "access": "public"
   }
-}
+}