@oobe-protocol-labs/sap-mcp-server 0.1.0

package/dist/payments/http-adapter.js

@@ -0,0 +1,126 @@
+/**
+ * @name NativeHttpX402Adapter
+ * @description Native Node.js HTTP adapter and request utilities for x402-gated MCP traffic.
+ */
+import { PassThrough } from 'stream';
+const DEFAULT_MAX_BODY_BYTES = 2 * 1024 * 1024;
+/**
+ * @name NativeHttpAdapter
+ * @description Implements x402's HTTPAdapter over Node's native IncomingMessage.
+ */
+export class NativeHttpAdapter {
+    request;
+    path;
+    body;
+    constructor(options) {
+        this.request = options.request;
+        this.path = options.path;
+        this.body = options.body;
+    }
+    /**
+     * @name getHeader
+     * @description Returns a case-insensitive HTTP header value.
+     */
+    getHeader(name) {
+        const normalizedName = name.toLowerCase();
+        const header = this.request.headers[normalizedName] ?? (normalizedName === 'payment-signature'
+            ? this.request.headers['x-payment']
+            : undefined);
+        if (Array.isArray(header)) {
+            return header[0];
+        }
+        return header;
+    }
+    /**
+     * @name getMethod
+     * @description Returns the HTTP method.
+     */
+    getMethod() {
+        return this.request.method ?? 'GET';
+    }
+    /**
+     * @name getPath
+     * @description Returns the x402 virtual path used for payment route matching.
+     */
+    getPath() {
+        return this.path;
+    }
+    /**
+     * @name getUrl
+     * @description Returns an absolute URL for the x402 protected virtual resource.
+     */
+    getUrl() {
+        const host = this.request.headers.host ?? 'localhost';
+        const protoHeader = this.request.headers['x-forwarded-proto'];
+        const proto = Array.isArray(protoHeader) ? protoHeader[0] : protoHeader ?? 'http';
+        return `${proto}://${host}${this.path}`;
+    }
+    /**
+     * @name getAcceptHeader
+     * @description Returns the request Accept header.
+     */
+    getAcceptHeader() {
+        return this.getHeader('accept') ?? '';
+    }
+    /**
+     * @name getUserAgent
+     * @description Returns the request User-Agent header.
+     */
+    getUserAgent() {
+        return this.getHeader('user-agent') ?? '';
+    }
+    /**
+     * @name getBody
+     * @description Returns the parsed JSON-RPC body for dynamic x402 pricing.
+     */
+    getBody() {
+        return this.body;
+    }
+}
+/**
+ * @name readRequestBody
+ * @description Reads and bounds a Node HTTP request body before replaying it to MCP.
+ */
+export async function readRequestBody(request, maxBytes = DEFAULT_MAX_BODY_BYTES) {
+    const chunks = [];
+    let totalBytes = 0;
+    for await (const chunk of request) {
+        const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+        totalBytes += buffer.byteLength;
+        if (totalBytes > maxBytes) {
+            throw new Error(`Request body exceeds ${maxBytes} bytes`);
+        }
+        chunks.push(buffer);
+    }
+    return Buffer.concat(chunks);
+}
+/**
+ * @name replayRequest
+ * @description Recreates a readable request stream after the monetization gate has consumed the original body.
+ */
+export function replayRequest(original, body) {
+    const replay = new PassThrough();
+    replay.headers = original.headers;
+    replay.rawHeaders = original.rawHeaders;
+    replay.method = original.method;
+    replay.url = original.url;
+    replay.httpVersion = original.httpVersion;
+    replay.httpVersionMajor = original.httpVersionMajor;
+    replay.httpVersionMinor = original.httpVersionMinor;
+    replay.socket = original.socket;
+    replay.complete = true;
+    replay.push(body);
+    replay.push(null);
+    return replay;
+}
+/**
+ * @name parseJsonBody
+ * @description Parses a JSON request body and returns undefined for empty bodies.
+ */
+export function parseJsonBody(body) {
+    if (body.byteLength === 0) {
+        return undefined;
+    }
+    return JSON.parse(body.toString('utf-8'));
+}
+//# sourceMappingURL=http-adapter.js.map

package/dist/payments/http-adapter.js.map

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

package/dist/payments/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @name PaymentsModule
+ * @description Public exports for SAP MCP hosted monetization primitives.
+ */
+export { buildPaidVirtualPath, McpMonetizationGate, resolvePaymentNetwork } from './monetization-gate.js';
+export { generatePayShProviderYaml, resolvePayShNetwork, resolvePayShOptions } from './pay-sh-spec.js';
+export type { PayShSpecOptions } from './pay-sh-spec.js';
+export { classifyTool, formatUsdPrice, priceToolCall, resolvePaymentDecision } from './pricing.js';
+export type { PaymentDecision, PaymentTier, ToolPricing } from './pricing.js';
+export { UsageLedger, hashRequestBody } from './usage-ledger.js';
+export type { PaymentLedgerEvent, PaymentLedgerEventType, PaymentRequestMetadata } from './usage-ledger.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/payments/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC1G,OAAO,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvG,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACnG,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACjE,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/payments/index.js

@@ -0,0 +1,9 @@
+/**
+ * @name PaymentsModule
+ * @description Public exports for SAP MCP hosted monetization primitives.
+ */
+export { buildPaidVirtualPath, McpMonetizationGate, resolvePaymentNetwork } from './monetization-gate.js';
+export { generatePayShProviderYaml, resolvePayShNetwork, resolvePayShOptions } from './pay-sh-spec.js';
+export { classifyTool, formatUsdPrice, priceToolCall, resolvePaymentDecision } from './pricing.js';
+export { UsageLedger, hashRequestBody } from './usage-ledger.js';
+//# sourceMappingURL=index.js.map

package/dist/payments/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/payments/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC1G,OAAO,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvG,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAEnG,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/payments/json-rpc.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @name JsonRpcPaymentIntrospection
+ * @description Small JSON-RPC helpers used by the remote monetization gate without coupling payment logic to MCP tools.
+ */
+/**
+ * @name JsonRpcId
+ * @description JSON-RPC request identifier shape accepted by MCP clients.
+ */
+export type JsonRpcId = string | number | null;
+/**
+ * @name JsonRpcRequest
+ * @description Minimal JSON-RPC request shape needed to inspect MCP method and tool names.
+ */
+export interface JsonRpcRequest {
+    jsonrpc?: '2.0';
+    id?: JsonRpcId;
+    method: string;
+    params?: unknown;
+}
+/**
+ * @name McpToolCall
+ * @description Tool invocation extracted from a JSON-RPC `tools/call` request.
+ */
+export interface McpToolCall {
+    id?: JsonRpcId;
+    toolName: string;
+    arguments?: unknown;
+}
+/**
+ * @name ParsedMcpRequest
+ * @description Parsed MCP request metadata relevant to payment decisions.
+ */
+export interface ParsedMcpRequest {
+    requests: JsonRpcRequest[];
+    toolCalls: McpToolCall[];
+    methods: string[];
+    isBatch: boolean;
+}
+/**
+ * @name isRecord
+ * @description Checks whether a value can be treated as a plain object for protocol introspection.
+ */
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+/**
+ * @name parseJsonRpcBody
+ * @description Parses a JSON-RPC request or batch and extracts MCP tool-call metadata.
+ */
+export declare function parseJsonRpcBody(body: unknown): ParsedMcpRequest;
+//# sourceMappingURL=json-rpc.d.ts.map

package/dist/payments/json-rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-rpc.d.ts","sourceRoot":"","sources":["../../src/payments/json-rpc.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;AAE/C;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,KAAK,CAAC;IAChB,EAAE,CAAC,EAAE,SAAS,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,CAAC,EAAE,SAAS,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CA0ChE"}

package/dist/payments/json-rpc.js

@@ -0,0 +1,53 @@
+/**
+ * @name JsonRpcPaymentIntrospection
+ * @description Small JSON-RPC helpers used by the remote monetization gate without coupling payment logic to MCP tools.
+ */
+/**
+ * @name isRecord
+ * @description Checks whether a value can be treated as a plain object for protocol introspection.
+ */
+export function isRecord(value) {
+    return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}
+/**
+ * @name parseJsonRpcBody
+ * @description Parses a JSON-RPC request or batch and extracts MCP tool-call metadata.
+ */
+export function parseJsonRpcBody(body) {
+    const rawRequests = Array.isArray(body) ? body : [body];
+    const requests = [];
+    const toolCalls = [];
+    for (const rawRequest of rawRequests) {
+        if (!isRecord(rawRequest) || typeof rawRequest.method !== 'string') {
+            continue;
+        }
+        const request = {
+            jsonrpc: rawRequest.jsonrpc === '2.0' ? '2.0' : undefined,
+            id: typeof rawRequest.id === 'string' || typeof rawRequest.id === 'number' || rawRequest.id === null
+                ? rawRequest.id
+                : undefined,
+            method: rawRequest.method,
+            params: rawRequest.params,
+        };
+        requests.push(request);
+        if (request.method !== 'tools/call' || !isRecord(request.params)) {
+            continue;
+        }
+        const toolName = request.params.name;
+        if (typeof toolName !== 'string' || toolName.length === 0) {
+            continue;
+        }
+        toolCalls.push({
+            id: request.id,
+            toolName,
+            arguments: request.params.arguments,
+        });
+    }
+    return {
+        requests,
+        toolCalls,
+        methods: requests.map(request => request.method),
+        isBatch: Array.isArray(body),
+    };
+}
+//# sourceMappingURL=json-rpc.js.map

package/dist/payments/json-rpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-rpc.js","sourceRoot":"","sources":["../../src/payments/json-rpc.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAwCH;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAa;IAC5C,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAqB,EAAE,CAAC;IACtC,MAAM,SAAS,GAAkB,EAAE,CAAC;IAEpC,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,OAAO,UAAU,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YACnE,SAAS;QACX,CAAC;QAED,MAAM,OAAO,GAAmB;YAC9B,OAAO,EAAE,UAAU,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;YACzD,EAAE,EAAE,OAAO,UAAU,CAAC,EAAE,KAAK,QAAQ,IAAI,OAAO,UAAU,CAAC,EAAE,KAAK,QAAQ,IAAI,UAAU,CAAC,EAAE,KAAK,IAAI;gBAClG,CAAC,CAAC,UAAU,CAAC,EAAE;gBACf,CAAC,CAAC,SAAS;YACb,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC;QACF,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEvB,IAAI,OAAO,CAAC,MAAM,KAAK,YAAY,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACjE,SAAS;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;QACrC,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1D,SAAS;QACX,CAAC;QAED,SAAS,CAAC,IAAI,CAAC;YACb,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,QAAQ;YACR,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS;SACpC,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,QAAQ;QACR,SAAS;QACT,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;QAChD,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;KAC7B,CAAC;AACJ,CAAC"}

package/dist/payments/monetization-gate.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @name McpMonetizationGate
+ * @description x402/pay.sh payment gate for hosted SAP MCP Streamable HTTP requests.
+ */
+import * as http from 'http';
+import type { SapMcpConfig } from '../config/env.js';
+import type { PaymentDecision } from './pricing.js';
+/**
+ * @name McpRequestHandler
+ * @description Handler invoked after the payment gate has authorized or bypassed a request.
+ */
+export type McpRequestHandler = (request: http.IncomingMessage, response: http.ServerResponse) => Promise<void>;
+/**
+ * @name McpMonetizationGate
+ * @description Applies x402 payment verification and settlement before forwarding requests to the MCP transport.
+ */
+export declare class McpMonetizationGate {
+    private readonly appConfig;
+    private readonly monetization;
+    private readonly httpResourceServer;
+    private readonly usageLedger;
+    private constructor();
+    /**
+     * @name create
+     * @description Builds and initializes an x402 HTTP resource server for SAP MCP requests.
+     */
+    static create(appConfig: SapMcpConfig): Promise<McpMonetizationGate | undefined>;
+    /**
+     * @name handle
+     * @description Authorizes a request via x402 when required, then forwards it to MCP and settles on success.
+     */
+    handle(request: http.IncomingMessage, response: http.ServerResponse, next: McpRequestHandler): Promise<void>;
+    private buildRequestContext;
+    private forwardAndSettle;
+    private settleAndReplay;
+}
+/**
+ * @name resolvePaymentNetwork
+ * @description Resolves the x402 CAIP-2 Solana network from explicit config or the SAP RPC URL.
+ */
+export declare function resolvePaymentNetwork(config: SapMcpConfig): string;
+/**
+ * @name buildPaidVirtualPath
+ * @description Builds the paid x402 virtual resource path, bound to the exact JSON-RPC request hash.
+ */
+export declare function buildPaidVirtualPath(decision: Extract<PaymentDecision, {
+    required: true;
+}>, requestHash: string): string;
+//# sourceMappingURL=monetization-gate.d.ts.map

package/dist/payments/monetization-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monetization-gate.d.ts","sourceRoot":"","sources":["../../src/payments/monetization-gate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAU7B,OAAO,KAAK,EAAE,YAAY,EAA4B,MAAM,kBAAkB,CAAC;AAI/E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAIpD;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAC9B,OAAO,EAAE,IAAI,CAAC,eAAe,EAC7B,QAAQ,EAAE,IAAI,CAAC,cAAc,KAC1B,OAAO,CAAC,IAAI,CAAC,CAAC;AA2BnB;;;GAGG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA2B;IACxD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAyB;IAC5D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAE1C,OAAO;IAWP;;;OAGG;WACiB,MAAM,CAAC,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC;IA6C7F;;;OAGG;IACU,MAAM,CACjB,OAAO,EAAE,IAAI,CAAC,eAAe,EAC7B,QAAQ,EAAE,IAAI,CAAC,cAAc,EAC7B,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,IAAI,CAAC;IA4DhB,OAAO,CAAC,mBAAmB;YAmBb,gBAAgB;YAwDhB,eAAe;CAqC9B;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAclE;AA8ED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,CAAC,eAAe,EAAE;IAAE,QAAQ,EAAE,IAAI,CAAA;CAAE,CAAC,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAGxH"}