Merge OAuth 2.1 implementation with http-stream transport

- Resolved conflicts in .gitignore, package-lock.json, and sse/server.ts
- Kept OAuth provider and methods (handleProtectedResourceMetadata, handleOAuthCallback)
- Integrated PING_SSE_MESSAGE from remote
- Merged both OAuth and http-stream features

Author: QuantGeekDev

.cursor/rules/mcp-framework.mdc

@@ -0,0 +1,117 @@
+---
+description: 
+globs: 
+alwaysApply: false
+---
+We are in the mcp-framework , a typescript framework that allows construction of model context protocol (mcp) servers.
+We are implementing the new specification:
+<specification>Overview 
+MCP provides a standardized way for applications to:
+
+Share contextual information with language models
+Expose tools and capabilities to AI systems
+Build composable integrations and workflows
+The protocol uses JSON-RPC 2.0 messages to establish communication between:
+
+Hosts: LLM applications that initiate connections
+Clients: Connectors within the host application
+Servers: Services that provide context and capabilities
+MCP takes some inspiration from the Language Server Protocol, which standardizes how to add support for programming languages across a whole ecosystem of development tools. In a similar way, MCP standardizes how to integrate additional context and tools into the ecosystem of AI applications.
+
+Key Details 
+Base Protocol 
+JSON-RPC message format
+Stateful connections
+Server and client capability negotiation
+Features 
+Servers offer any of the following features to clients:
+
+Resources: Context and data, for the user or the AI model to use
+Prompts: Templated messages and workflows for users
+Tools: Functions for the AI model to execute</specification>
+
+Here is an example of how a user creats an mcp server using mcp-framework as the library: <example>## src/tools/ExampleTool.ts
+
+```ts
+import { MCPTool } from "mcp-framework";
+import { z } from "zod";
+
+interface ExampleInput {
+  message: string;
+}
+
+class ExampleTool extends MCPTool<ExampleInput> {
+  name = "example_tool";
+  description = "An example tool that processes messages";
+
+  schema = {
+    message: {
+      type: z.string(),
+      description: "Message to process",
+    },
+  };
+
+  async execute(input: ExampleInput) {
+    return `Processed: ${input.message}`;
+  }
+}
+
+export default ExampleTool;
+```
+
+## src/index.ts
+
+```ts
+import { MCPServer } from "mcp-framework";
+
+const server = new MCPServer({transport:{
+  type:"http-stream",
+  options:{
+    port:1337,
+    cors: {
+      allowOrigin:"*"
+    }
+  }
+}});
+
+server.start();
+
+```
+
+## package.json
+
+```json
+{
+  "name": "http2-hi",
+  "version": "0.0.1",
+  "description": "http2-hi MCP server",
+  "type": "module",
+  "bin": {
+    "http2-hi": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc && mcp-build",
+    "watch": "tsc --watch",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "mcp-framework": "^0.2.12-beta.4",
+    "zod": "^3.24.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.24",
+    "typescript": "^5.3.3"
+  },
+  "engines": {
+    "node": ">=18.19.0"
+  }
+}
+
+```
+</example>
+
+It's important to keep in mind that mcp-framework is used exclusively as a dependency in other repositories - just like express js would be.
+This means that we are running it from node_modules within the repo - this impacts how relative directories work

.editorconfig

@@ -0,0 +1,11 @@
+# EditorConfig is awesome: https://EditorConfig.org
+
+# top-most EditorConfig file
+root = true
+
+[*]
+indent_style = space
+indent_size = 2
+end_of_line = lf
+charset = utf-8
+insert_final_newline = true

.github/workflows/release.yml

@@ -0,0 +1,19 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  release-please:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: googleapis/release-please-action@v4
+        with:
+          config-file: '.release-please-config.json'

.gitignore

@@ -13,3 +13,5 @@ coverage/
 *.swp
 *.swo
 *~
+.yalc
+yalc.lock

.prettierrc

@@ -0,0 +1,8 @@
+{
+  "semi": true,
+  "trailingComma": "es5",
+  "singleQuote": true,
+  "printWidth": 100,
+  "tabWidth": 2,
+  "endOfLine": "auto"
+} 

.release-please-config.json

@@ -0,0 +1,11 @@
+{
+  "packages": {
+    ".": {
+      "release-type": "node",
+      "bump-minor-pre-major": true,
+      "bump-patch-for-minor-pre-major": true,
+      "changelog-path": "CHANGELOG.md",
+      "pull-request-title-pattern": "chore: release ${version}"
+    }
+  }
+}

.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.2.15"
+}

CHANGELOG.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) [2025] [Alexandr "Andru" Andrushevich]
+
+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.