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

package/dist/core/logger.js

@@ -0,0 +1,159 @@
+/**
+ * Logger utility for SAP MCP Server
+ *
+ * Provides structured logging with:
+ * - Configurable log levels
+ * - JSON or pretty format
+ * - File output support
+ * - Timestamp and context
+ */
+import { appendFileSync, existsSync, mkdirSync } from 'fs';
+import { join } from 'path';
+let currentLevel = 'info';
+let currentFormat = 'pretty';
+let logFile;
+/**
+ * Initialize logger with options
+ */
+export function initLogger(options = {}) {
+    if (options.level)
+        currentLevel = options.level;
+    if (options.format)
+        currentFormat = options.format;
+    if (options.file) {
+        logFile = options.file;
+        ensureLogFile(logFile);
+    }
+}
+/**
+ * Ensure log file directory exists
+ */
+function ensureLogFile(filePath) {
+    const dir = join(filePath, '..');
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+}
+/**
+ * Format log entry based on format setting
+ */
+function formatLog(entry) {
+    if (currentFormat === 'json') {
+        return JSON.stringify(entry);
+    }
+    // Pretty format
+    const timestamp = new Date(entry.timestamp).toISOString();
+    const dataStr = entry.data ? ` ${JSON.stringify(entry.data)}` : '';
+    return `[${timestamp}] [${entry.level.toUpperCase()}] ${entry.message}${dataStr}`;
+}
+/**
+ * Write log to console and/or file
+ */
+function writeLog(entry) {
+    const formatted = formatLog(entry);
+    // Always write to stderr (for MCP stdio compatibility)
+    console.error(formatted);
+    // Write to file if configured
+    if (logFile) {
+        appendFileSync(logFile, formatted + '\n');
+    }
+}
+/**
+ * Create log entry with context
+ */
+function createLogEntry(level, message, data) {
+    return {
+        timestamp: new Date().toISOString(),
+        level,
+        message,
+        data,
+        context: {
+            pid: process.pid,
+            mode: process.env.SAP_MCP_MODE,
+        },
+    };
+}
+/**
+ * Check if message should be logged based on level
+ */
+function shouldLog(level) {
+    const levels = ['debug', 'info', 'warn', 'error'];
+    const currentLevelIndex = levels.indexOf(currentLevel);
+    const messageLevelIndex = levels.indexOf(level);
+    return messageLevelIndex >= currentLevelIndex;
+}
+/**
+ * Logger instance
+ */
+export const logger = {
+    debug(message, data) {
+        if (shouldLog('debug')) {
+            writeLog(createLogEntry('debug', message, data));
+        }
+    },
+    info(message, data) {
+        if (shouldLog('info')) {
+            writeLog(createLogEntry('info', message, data));
+        }
+    },
+    warn(message, data) {
+        if (shouldLog('warn')) {
+            writeLog(createLogEntry('warn', message, data));
+        }
+    },
+    error(message, data) {
+        if (shouldLog('error')) {
+            writeLog(createLogEntry('error', message, data));
+        }
+    },
+    /**
+     * Log startup banner
+     */
+    startup(config) {
+        const banner = `
+╔══════════════════════════════════════════════════════════╗
+║             SAP MCP Server                               ║
+║             Enterprise Edition                           ║
+╚══════════════════════════════════════════════════════════╝
+    `.trim();
+        console.error(banner);
+        console.error(`Version: ${config.version || '0.1.0'}`);
+        console.error(`Mode: ${config.mode}`);
+        console.error(`RPC: ${config.rpcUrl}`);
+        console.error(`Program: ${config.programId}`);
+        console.error(`PID: ${process.pid}`);
+        console.error('────────────────────────────────────────────────────────');
+    },
+};
+/**
+ * Set log level dynamically
+ */
+export function setLogLevel(level) {
+    currentLevel = level;
+}
+/**
+ * Set log format dynamically
+ */
+export function setLogFormat(format) {
+    currentFormat = format;
+}
+/**
+ * Set log file dynamically
+ */
+export function setLogFile(file) {
+    logFile = file;
+    if (file) {
+        ensureLogFile(file);
+    }
+}
+/**
+ * Get current logger configuration
+ */
+export function getLoggerConfig() {
+    return {
+        level: currentLevel,
+        format: currentFormat,
+        file: logFile,
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/core/logger.js.map

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

package/dist/core/result.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Result type utilities for consistent error handling
+ */
+export type Result<T, E = Error> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: E;
+};
+/**
+ * Executes the ok operation.
+ */
+export declare function ok<T>(data: T): Result<T, never>;
+/**
+ * Executes the err operation.
+ */
+export declare function err<E>(error: E): Result<never, E>;
+/**
+ * Executes the is ok operation.
+ */
+export declare function isOk<T, E>(result: Result<T, E>): result is {
+    success: true;
+    data: T;
+};
+/**
+ * Executes the is err operation.
+ */
+export declare function isErr<T, E>(result: Result<T, E>): result is {
+    success: false;
+    error: E;
+};
+/**
+ * Executes the unwrap operation.
+ */
+export declare function unwrap<T, E>(result: Result<T, E>): T;
+/**
+ * Executes the unwrap or operation.
+ */
+export declare function unwrapOr<T, E>(result: Result<T, E>, defaultValue: T): T;
+/**
+ * Executes the map result operation.
+ */
+export declare function mapResult<T, U, E>(result: Result<T, E>, fn: (data: T) => U): Result<U, E>;
+/**
+ * Executes the map error operation.
+ */
+export declare function mapError<T, E, F>(result: Result<T, E>, fn: (error: E) => F): Result<T, F>;
+//# sourceMappingURL=result.d.ts.map

package/dist/core/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/core/result.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,IAC3B;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAC1B;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC;AAEjC;;GAEG;AACH,wBAAgB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAE/C;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAEjD;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,IAAI;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,CAErF;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,IAAI;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAExF;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAKpD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,CAEvE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAC/B,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EACpB,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GACjB,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAKd;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAC9B,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EACpB,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAClB,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAKd"}

package/dist/core/result.js

@@ -0,0 +1,61 @@
+/**
+ * Result type utilities for consistent error handling
+ */
+/**
+ * Executes the ok operation.
+ */
+export function ok(data) {
+    return { success: true, data };
+}
+/**
+ * Executes the err operation.
+ */
+export function err(error) {
+    return { success: false, error };
+}
+/**
+ * Executes the is ok operation.
+ */
+export function isOk(result) {
+    return result.success;
+}
+/**
+ * Executes the is err operation.
+ */
+export function isErr(result) {
+    return !result.success;
+}
+/**
+ * Executes the unwrap operation.
+ */
+export function unwrap(result) {
+    if (result.success) {
+        return result.data;
+    }
+    throw result.error;
+}
+/**
+ * Executes the unwrap or operation.
+ */
+export function unwrapOr(result, defaultValue) {
+    return result.success ? result.data : defaultValue;
+}
+/**
+ * Executes the map result operation.
+ */
+export function mapResult(result, fn) {
+    if (result.success) {
+        return { success: true, data: fn(result.data) };
+    }
+    return result;
+}
+/**
+ * Executes the map error operation.
+ */
+export function mapError(result, fn) {
+    if (result.success) {
+        return result;
+    }
+    return { success: false, error: fn(result.error) };
+}
+//# sourceMappingURL=result.js.map

package/dist/core/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/core/result.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH;;GAEG;AACH,MAAM,UAAU,EAAE,CAAI,IAAO;IAC3B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,GAAG,CAAI,KAAQ;IAC7B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,IAAI,CAAO,MAAoB;IAC7C,OAAO,MAAM,CAAC,OAAO,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,KAAK,CAAO,MAAoB;IAC9C,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM,CAAO,MAAoB;IAC/C,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IACD,MAAO,MAAuC,CAAC,KAAK,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAO,MAAoB,EAAE,YAAe;IAClE,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CACvB,MAAoB,EACpB,EAAkB;IAElB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;IAClD,CAAC;IACD,OAAO,MAAsB,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CACtB,MAAoB,EACpB,EAAmB;IAEnB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAE,MAAuC,CAAC,KAAK,CAAC,EAAE,CAAC;AACvF,CAAC"}

package/dist/core/types.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Core Type Definitions for SAP MCP Server
+ *
+ * These types define the shared context, configuration, and data structures
+ * used throughout the MCP server.
+ */
+import { Connection } from '@solana/web3.js';
+import type { PublicKey, Transaction, VersionedTransaction } from '@solana/web3.js';
+import { SapClient } from '@oobe-protocol-labs/synapse-sap-sdk';
+import type { SapMcpConfig as RuntimeSapMcpConfig } from '../config/env.js';
+import type { PolicyEngine } from '../policy/policy-engine.js';
+import type { logger } from '../core/logger.js';
+/**
+ * SAP MCP Server operating modes
+ */
+export type SapMcpMode = 'readonly' | 'local-dev-keypair' | 'external-signer' | 'delegated-session' | 'hosted-api';
+/**
+ * Signer mode - derived from MCP mode
+ */
+export type SapSignerMode = 'none' | 'local-keypair' | 'external' | 'delegated';
+/**
+ * SAP MCP Server configuration resolved by the config pipeline.
+ */
+export type SapMcpConfig = RuntimeSapMcpConfig;
+/**
+ * Agent session with permissions and limits
+ */
+export interface SapAgentSession {
+    sessionId: string;
+    agentId: string;
+    permissions: SapPermission[];
+    spendingLimits: SapSpendingLimits;
+    expiresAt: number;
+    createdAt: number;
+}
+/**
+ * Permission types for agent sessions
+ */
+export type SapPermission = 'config:read' | 'config:write' | 'registry:read' | 'registry:write' | 'identity:read' | 'identity:write' | 'reputation:read' | 'reputation:write' | 'payments:read' | 'payments:write' | 'settlement:read' | 'settlement:write' | 'memory:read' | 'memory:write' | 'transaction:submit';
+/**
+ * Spending limits for a session
+ */
+export interface SapSpendingLimits {
+    maxPerTransactionSol: number;
+    maxPerDaySol: number;
+    maxPerSessionSol: number;
+    remainingSessionSol: number;
+}
+/**
+ * Policy definition
+ */
+export interface SapPolicy {
+    id: string;
+    name: string;
+    description: string;
+    rules: SapPolicyRule[];
+    enabled: boolean;
+}
+/**
+ * Policy rule
+ */
+export interface SapPolicyRule {
+    condition: string;
+    action: 'allow' | 'deny' | 'require_approval';
+    tools?: string[];
+    maxAmountSol?: number;
+}
+/**
+ * Risk level for transactions
+ */
+export type SapRiskLevel = 'safe' | 'low' | 'medium' | 'high' | 'critical';
+/**
+ * Transaction preview before signing
+ */
+export interface SapTransactionPreview {
+    transactionType: string;
+    description: string;
+    riskLevel: SapRiskLevel;
+    estimatedFeeSol: number;
+    estimatedValueSol: number;
+    accountsInvolved: string[];
+    instructions: TransactionInstructionPreview[];
+    requiresApproval: boolean;
+    approvalReason?: string;
+}
+/**
+ * Individual instruction preview
+ */
+export interface TransactionInstructionPreview {
+    programId: string;
+    programName: string;
+    instructionName: string;
+    accounts: AccountPreview[];
+    dataPreview: string;
+}
+/**
+ * Account preview
+ */
+export interface AccountPreview {
+    pubkey: string;
+    role: string;
+    isSigner: boolean;
+    isWritable: boolean;
+}
+/**
+ * Standard SAP tool result
+ */
+export interface SapToolResult<T = unknown> {
+    success: boolean;
+    data?: T;
+    error?: SapToolError;
+    metadata?: {
+        durationMs: number;
+        rpcSlot?: number;
+        transactionSignature?: string;
+    };
+}
+/**
+ * Tool error
+ */
+export interface SapToolError {
+    code: string;
+    message: string;
+    details?: unknown;
+}
+/**
+ * Shared context passed to all MCP handlers
+ */
+export interface SapMcpContext {
+    config: SapMcpConfig;
+    connection: Connection;
+    sapClient: SapClient;
+    signer?: SapSigner;
+    policyEngine: PolicyEngine;
+    session?: SapAgentSession;
+    logger: typeof logger;
+}
+/**
+ * Signer interface
+ */
+export interface SapSigner {
+    publicKey: PublicKey;
+    signTransaction: <T extends Transaction | VersionedTransaction>(tx: T) => Promise<T>;
+    signAllTransactions: <T extends Transaction | VersionedTransaction>(txs: T[]) => Promise<T[]>;
+}
+export type { SapEnvConfig } from '../config/env.js';
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

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

package/dist/core/types.js

@@ -0,0 +1,8 @@
+/**
+ * Core Type Definitions for SAP MCP Server
+ *
+ * These types define the shared context, configuration, and data structures
+ * used throughout the MCP server.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * SAP MCP Server - Main Entry Point
+ *
+ * Programmatic API for embedding SAP MCP server in other applications.
+ * For CLI usage, see cli.ts
+ */
+export { createSapMcpServer } from './server/create-server.js';
+export { SapMcpContext } from './core/types.js';
+export type { SapMcpMode, SapMcpConfig, SapAgentSession, SapPermission, SapPolicy, SapTransactionPreview, SapToolResult, SapSignerMode, SapRiskLevel, } from './core/types.js';
+export { loadConfig } from './config/env.js';
+export type { SapEnvConfig } from './config/env.js';
+export { SapClientManager, getSapClient, isSapClientInitialized } from './sap/sap-client-manager.js';
+export { resolveSigner } from './signer/signer-resolver.js';
+export { PolicyEngine } from './policy/policy-engine.js';
+export { registerTools } from './tools/register-tools.js';
+export { registerResources } from './resources/register-resources.js';
+export { registerPrompts } from './prompts/register-prompts.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;;;;;GAKG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EACV,UAAU,EACV,YAAY,EACZ,eAAe,EACf,aAAa,EACb,SAAS,EACT,qBAAqB,EACrB,aAAa,EACb,aAAa,EACb,YAAY,GACb,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAErG,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+/**
+ * SAP MCP Server - Main Entry Point
+ *
+ * Programmatic API for embedding SAP MCP server in other applications.
+ * For CLI usage, see cli.ts
+ */
+export { createSapMcpServer } from './server/create-server.js';
+export { loadConfig } from './config/env.js';
+export { SapClientManager, getSapClient, isSapClientInitialized } from './sap/sap-client-manager.js';
+export { resolveSigner } from './signer/signer-resolver.js';
+export { PolicyEngine } from './policy/policy-engine.js';
+export { registerTools } from './tools/register-tools.js';
+export { registerResources } from './resources/register-resources.js';
+export { registerPrompts } from './prompts/register-prompts.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;;;;;GAKG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAc/D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAErG,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/payments/http-adapter.d.ts

@@ -0,0 +1,76 @@
+/**
+ * @name NativeHttpX402Adapter
+ * @description Native Node.js HTTP adapter and request utilities for x402-gated MCP traffic.
+ */
+import * as http from 'http';
+import type { HTTPAdapter } from '@x402/core/server';
+/**
+ * @name NativeHttpAdapterOptions
+ * @description Adapter inputs required by x402's framework-agnostic HTTP server.
+ */
+export interface NativeHttpAdapterOptions {
+    request: http.IncomingMessage;
+    path: string;
+    body: unknown;
+}
+/**
+ * @name NativeHttpAdapter
+ * @description Implements x402's HTTPAdapter over Node's native IncomingMessage.
+ */
+export declare class NativeHttpAdapter implements HTTPAdapter {
+    private readonly request;
+    private readonly path;
+    private readonly body;
+    constructor(options: NativeHttpAdapterOptions);
+    /**
+     * @name getHeader
+     * @description Returns a case-insensitive HTTP header value.
+     */
+    getHeader(name: string): string | undefined;
+    /**
+     * @name getMethod
+     * @description Returns the HTTP method.
+     */
+    getMethod(): string;
+    /**
+     * @name getPath
+     * @description Returns the x402 virtual path used for payment route matching.
+     */
+    getPath(): string;
+    /**
+     * @name getUrl
+     * @description Returns an absolute URL for the x402 protected virtual resource.
+     */
+    getUrl(): string;
+    /**
+     * @name getAcceptHeader
+     * @description Returns the request Accept header.
+     */
+    getAcceptHeader(): string;
+    /**
+     * @name getUserAgent
+     * @description Returns the request User-Agent header.
+     */
+    getUserAgent(): string;
+    /**
+     * @name getBody
+     * @description Returns the parsed JSON-RPC body for dynamic x402 pricing.
+     */
+    getBody(): unknown;
+}
+/**
+ * @name readRequestBody
+ * @description Reads and bounds a Node HTTP request body before replaying it to MCP.
+ */
+export declare function readRequestBody(request: http.IncomingMessage, maxBytes?: number): Promise<Buffer>;
+/**
+ * @name replayRequest
+ * @description Recreates a readable request stream after the monetization gate has consumed the original body.
+ */
+export declare function replayRequest(original: http.IncomingMessage, body: Buffer): http.IncomingMessage;
+/**
+ * @name parseJsonBody
+ * @description Parses a JSON request body and returns undefined for empty bodies.
+ */
+export declare function parseJsonBody(body: Buffer): unknown;
+//# sourceMappingURL=http-adapter.d.ts.map

package/dist/payments/http-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-adapter.d.ts","sourceRoot":"","sources":["../../src/payments/http-adapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,IAAI,CAAC,eAAe,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;GAGG;AACH,qBAAa,iBAAkB,YAAW,WAAW;IACnD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAC/C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAU;gBAEZ,OAAO,EAAE,wBAAwB;IAMpD;;;OAGG;IACI,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAalD;;;OAGG;IACI,SAAS,IAAI,MAAM;IAI1B;;;OAGG;IACI,OAAO,IAAI,MAAM;IAIxB;;;OAGG;IACI,MAAM,IAAI,MAAM;IAOvB;;;OAGG;IACI,eAAe,IAAI,MAAM;IAIhC;;;OAGG;IACI,YAAY,IAAI,MAAM;IAI7B;;;OAGG;IACI,OAAO,IAAI,OAAO;CAG1B;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,IAAI,CAAC,eAAe,EAC7B,QAAQ,SAAyB,GAChC,OAAO,CAAC,MAAM,CAAC,CAcjB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC,eAAe,CAchG;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKnD"}