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

package/dist/config/env.d.ts

@@ -0,0 +1,297 @@
+/**
+ * SAP MCP Server - Configuration Module
+ *
+ * Enterprise-grade configuration management with:
+ * - Environment variable validation via Zod
+ * - Config file support (JSON/YAML)
+ * - User-specific paths (~/.config/mcp-sap/)
+ * - Multi-environment support (dev, staging, prod)
+ * - Secure defaults with explicit overrides
+ */
+import { z } from 'zod';
+/**
+ * Zod schema for environment-driven configuration.
+ */
+export declare const envSchema: z.ZodObject<{
+    SAP_MCP_PROFILE: z.ZodOptional<z.ZodString>;
+    SAP_MCP_CONFIG_PATH: z.ZodOptional<z.ZodString>;
+    SAP_MCP_ALLOW_ENV_CONFIG_OVERRIDE: z.ZodDefault<z.ZodBoolean>;
+    SAP_MCP_MODE: z.ZodDefault<z.ZodEnum<["readonly", "local-dev-keypair", "external-signer", "delegated-session", "hosted-api"]>>;
+    SAP_MCP_RPC_URL: z.ZodOptional<z.ZodString>;
+    SAP_RPC_URL: z.ZodDefault<z.ZodString>;
+    SAP_RPC_URL_DEVNET: z.ZodOptional<z.ZodString>;
+    SAP_RPC_URL_TESTNET: z.ZodOptional<z.ZodString>;
+    SAP_PROGRAM_ID: z.ZodDefault<z.ZodString>;
+    SAP_COMMITMENT: z.ZodDefault<z.ZodEnum<["processed", "confirmed", "finalized"]>>;
+    SAP_MAX_RETRIES: z.ZodDefault<z.ZodNumber>;
+    SAP_RETRY_DELAY_MS: z.ZodDefault<z.ZodNumber>;
+    SAP_WALLET_PATH: z.ZodOptional<z.ZodString>;
+    SAP_WALLET_ENCRYPTED: z.ZodDefault<z.ZodBoolean>;
+    SAP_WALLET_PASSPHRASE_ENV: z.ZodOptional<z.ZodString>;
+    SAP_EXTERNAL_SIGNER_URL: z.ZodOptional<z.ZodString>;
+    SAP_EXTERNAL_SIGNER_TIMEOUT_MS: z.ZodDefault<z.ZodNumber>;
+    SAP_ENABLE_HTTP: z.ZodDefault<z.ZodBoolean>;
+    SAP_HTTP_PORT: z.ZodDefault<z.ZodNumber>;
+    SAP_HTTP_HOST: z.ZodDefault<z.ZodString>;
+    SAP_HTTP_CORS_ORIGINS: z.ZodOptional<z.ZodString>;
+    SAP_MAX_TX_VALUE_SOL: z.ZodDefault<z.ZodNumber>;
+    SAP_REQUIRE_APPROVAL_ABOVE_SOL: z.ZodDefault<z.ZodNumber>;
+    SAP_DAILY_LIMIT_SOL: z.ZodDefault<z.ZodNumber>;
+    SAP_ALLOWED_TOOLS: z.ZodOptional<z.ZodString>;
+    SAP_LOG_LEVEL: z.ZodDefault<z.ZodEnum<["debug", "info", "warn", "error"]>>;
+    SAP_LOG_FORMAT: z.ZodDefault<z.ZodEnum<["json", "pretty"]>>;
+    SAP_LOG_FILE: z.ZodOptional<z.ZodString>;
+    SAP_ENABLE_METRICS: z.ZodDefault<z.ZodBoolean>;
+    SAP_METRICS_PORT: z.ZodDefault<z.ZodNumber>;
+    SAP_ENABLE_CACHE: z.ZodDefault<z.ZodBoolean>;
+    SAP_CACHE_TTL_SECONDS: z.ZodDefault<z.ZodNumber>;
+    SAP_ENABLE_RATE_LIMIT: z.ZodDefault<z.ZodBoolean>;
+    SAP_RATE_LIMIT_PER_MINUTE: z.ZodDefault<z.ZodNumber>;
+    SAP_MCP_MONETIZATION_ENABLED: z.ZodDefault<z.ZodBoolean>;
+    SAP_MCP_MONETIZATION_PROVIDER: z.ZodDefault<z.ZodEnum<["x402", "pay-sh"]>>;
+    SAP_MCP_MONETIZATION_PAY_TO: z.ZodOptional<z.ZodString>;
+    SAP_MCP_MONETIZATION_NETWORK: z.ZodOptional<z.ZodString>;
+    SAP_MCP_X402_FACILITATOR_URL: z.ZodOptional<z.ZodString>;
+    SAP_MCP_X402_FACILITATOR_AUTH_TOKEN: z.ZodOptional<z.ZodString>;
+    SAP_MCP_X402_MAX_TIMEOUT_SECONDS: z.ZodDefault<z.ZodNumber>;
+    SAP_MCP_PAY_SH_CHECKOUT_URL: z.ZodOptional<z.ZodString>;
+    SAP_MCP_PRICE_READ_PREMIUM_USD: z.ZodDefault<z.ZodNumber>;
+    SAP_MCP_PRICE_BUILDER_USD: z.ZodDefault<z.ZodNumber>;
+    SAP_MCP_PRICE_VALUE_FIXED_USD: z.ZodDefault<z.ZodNumber>;
+    SAP_MCP_PRICE_VALUE_BPS: z.ZodDefault<z.ZodNumber>;
+    SAP_MCP_PRICE_MIN_USD: z.ZodDefault<z.ZodNumber>;
+    SAP_MCP_PRICE_MAX_USD: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    SAP_MCP_ALLOW_ENV_CONFIG_OVERRIDE: boolean;
+    SAP_MCP_MODE: "readonly" | "local-dev-keypair" | "external-signer" | "delegated-session" | "hosted-api";
+    SAP_RPC_URL: string;
+    SAP_PROGRAM_ID: string;
+    SAP_COMMITMENT: "processed" | "confirmed" | "finalized";
+    SAP_MAX_RETRIES: number;
+    SAP_RETRY_DELAY_MS: number;
+    SAP_WALLET_ENCRYPTED: boolean;
+    SAP_EXTERNAL_SIGNER_TIMEOUT_MS: number;
+    SAP_ENABLE_HTTP: boolean;
+    SAP_HTTP_PORT: number;
+    SAP_HTTP_HOST: string;
+    SAP_MAX_TX_VALUE_SOL: number;
+    SAP_REQUIRE_APPROVAL_ABOVE_SOL: number;
+    SAP_DAILY_LIMIT_SOL: number;
+    SAP_LOG_LEVEL: "debug" | "info" | "warn" | "error";
+    SAP_LOG_FORMAT: "json" | "pretty";
+    SAP_ENABLE_METRICS: boolean;
+    SAP_METRICS_PORT: number;
+    SAP_ENABLE_CACHE: boolean;
+    SAP_CACHE_TTL_SECONDS: number;
+    SAP_ENABLE_RATE_LIMIT: boolean;
+    SAP_RATE_LIMIT_PER_MINUTE: number;
+    SAP_MCP_MONETIZATION_ENABLED: boolean;
+    SAP_MCP_MONETIZATION_PROVIDER: "x402" | "pay-sh";
+    SAP_MCP_X402_MAX_TIMEOUT_SECONDS: number;
+    SAP_MCP_PRICE_READ_PREMIUM_USD: number;
+    SAP_MCP_PRICE_BUILDER_USD: number;
+    SAP_MCP_PRICE_VALUE_FIXED_USD: number;
+    SAP_MCP_PRICE_VALUE_BPS: number;
+    SAP_MCP_PRICE_MIN_USD: number;
+    SAP_MCP_PRICE_MAX_USD: number;
+    SAP_MCP_PROFILE?: string | undefined;
+    SAP_MCP_CONFIG_PATH?: string | undefined;
+    SAP_MCP_RPC_URL?: string | undefined;
+    SAP_RPC_URL_DEVNET?: string | undefined;
+    SAP_RPC_URL_TESTNET?: string | undefined;
+    SAP_WALLET_PATH?: string | undefined;
+    SAP_WALLET_PASSPHRASE_ENV?: string | undefined;
+    SAP_EXTERNAL_SIGNER_URL?: string | undefined;
+    SAP_HTTP_CORS_ORIGINS?: string | undefined;
+    SAP_ALLOWED_TOOLS?: string | undefined;
+    SAP_LOG_FILE?: string | undefined;
+    SAP_MCP_MONETIZATION_PAY_TO?: string | undefined;
+    SAP_MCP_MONETIZATION_NETWORK?: string | undefined;
+    SAP_MCP_X402_FACILITATOR_URL?: string | undefined;
+    SAP_MCP_X402_FACILITATOR_AUTH_TOKEN?: string | undefined;
+    SAP_MCP_PAY_SH_CHECKOUT_URL?: string | undefined;
+}, {
+    SAP_MCP_PROFILE?: string | undefined;
+    SAP_MCP_CONFIG_PATH?: string | undefined;
+    SAP_MCP_ALLOW_ENV_CONFIG_OVERRIDE?: boolean | undefined;
+    SAP_MCP_MODE?: "readonly" | "local-dev-keypair" | "external-signer" | "delegated-session" | "hosted-api" | undefined;
+    SAP_MCP_RPC_URL?: string | undefined;
+    SAP_RPC_URL?: string | undefined;
+    SAP_RPC_URL_DEVNET?: string | undefined;
+    SAP_RPC_URL_TESTNET?: string | undefined;
+    SAP_PROGRAM_ID?: string | undefined;
+    SAP_COMMITMENT?: "processed" | "confirmed" | "finalized" | undefined;
+    SAP_MAX_RETRIES?: number | undefined;
+    SAP_RETRY_DELAY_MS?: number | undefined;
+    SAP_WALLET_PATH?: string | undefined;
+    SAP_WALLET_ENCRYPTED?: boolean | undefined;
+    SAP_WALLET_PASSPHRASE_ENV?: string | undefined;
+    SAP_EXTERNAL_SIGNER_URL?: string | undefined;
+    SAP_EXTERNAL_SIGNER_TIMEOUT_MS?: number | undefined;
+    SAP_ENABLE_HTTP?: boolean | undefined;
+    SAP_HTTP_PORT?: number | undefined;
+    SAP_HTTP_HOST?: string | undefined;
+    SAP_HTTP_CORS_ORIGINS?: string | undefined;
+    SAP_MAX_TX_VALUE_SOL?: number | undefined;
+    SAP_REQUIRE_APPROVAL_ABOVE_SOL?: number | undefined;
+    SAP_DAILY_LIMIT_SOL?: number | undefined;
+    SAP_ALLOWED_TOOLS?: string | undefined;
+    SAP_LOG_LEVEL?: "debug" | "info" | "warn" | "error" | undefined;
+    SAP_LOG_FORMAT?: "json" | "pretty" | undefined;
+    SAP_LOG_FILE?: string | undefined;
+    SAP_ENABLE_METRICS?: boolean | undefined;
+    SAP_METRICS_PORT?: number | undefined;
+    SAP_ENABLE_CACHE?: boolean | undefined;
+    SAP_CACHE_TTL_SECONDS?: number | undefined;
+    SAP_ENABLE_RATE_LIMIT?: boolean | undefined;
+    SAP_RATE_LIMIT_PER_MINUTE?: number | undefined;
+    SAP_MCP_MONETIZATION_ENABLED?: boolean | undefined;
+    SAP_MCP_MONETIZATION_PROVIDER?: "x402" | "pay-sh" | undefined;
+    SAP_MCP_MONETIZATION_PAY_TO?: string | undefined;
+    SAP_MCP_MONETIZATION_NETWORK?: string | undefined;
+    SAP_MCP_X402_FACILITATOR_URL?: string | undefined;
+    SAP_MCP_X402_FACILITATOR_AUTH_TOKEN?: string | undefined;
+    SAP_MCP_X402_MAX_TIMEOUT_SECONDS?: number | undefined;
+    SAP_MCP_PAY_SH_CHECKOUT_URL?: string | undefined;
+    SAP_MCP_PRICE_READ_PREMIUM_USD?: number | undefined;
+    SAP_MCP_PRICE_BUILDER_USD?: number | undefined;
+    SAP_MCP_PRICE_VALUE_FIXED_USD?: number | undefined;
+    SAP_MCP_PRICE_VALUE_BPS?: number | undefined;
+    SAP_MCP_PRICE_MIN_USD?: number | undefined;
+    SAP_MCP_PRICE_MAX_USD?: number | undefined;
+}>;
+/**
+ * Parsed environment configuration before conversion to runtime config.
+ */
+export type SapEnvConfig = z.infer<typeof envSchema>;
+/**
+ * Fully resolved runtime configuration consumed by server, policy, signer, and transport modules.
+ */
+export interface SapMcpConfig {
+    mode: SapMcpMode;
+    rpcUrl: string;
+    rpcUrlDevnet?: string;
+    rpcUrlTestnet?: string;
+    commitment: 'processed' | 'confirmed' | 'finalized';
+    programId: string;
+    agentPubkey?: string;
+    maxRetries: number;
+    retryDelayMs: number;
+    walletPath?: string;
+    walletEncrypted: boolean;
+    walletPassphraseEnv?: string;
+    externalSignerUrl?: string;
+    externalSignerTimeoutMs: number;
+    enableHttp: boolean;
+    httpPort: number;
+    httpHost: string;
+    httpCorsOrigins?: string[];
+    maxTxValueSol: number;
+    requireApprovalAboveSol: number;
+    dailyLimitSol: number;
+    allowedTools: string[] | 'all';
+    logLevel: 'debug' | 'info' | 'warn' | 'error';
+    logFormat: 'json' | 'pretty';
+    logFile?: string;
+    enableMetrics: boolean;
+    metricsPort: number;
+    enableCache: boolean;
+    cacheTtlSeconds: number;
+    enableRateLimit: boolean;
+    rateLimitPerMinute: number;
+    bento?: {
+        enabled: boolean;
+        apiKey?: string;
+        agentId?: string;
+        endpoint?: string;
+    };
+    policy?: {
+        mode: 'local-only' | 'bento-only' | 'hybrid';
+        failOpen: boolean;
+        logging: boolean;
+    };
+    monetization: SapMcpMonetizationConfig;
+}
+/**
+ * Supported operating modes for local, delegated, external-signer, and hosted workflows.
+ */
+export type SapMcpMode = 'readonly' | 'local-dev-keypair' | 'external-signer' | 'delegated-session' | 'hosted-api';
+/**
+ * @name SapMcpMonetizationProvider
+ * @description Supported payment rails for hosted remote MCP monetization.
+ */
+export type SapMcpMonetizationProvider = 'x402' | 'pay-sh';
+/**
+ * @name SapMcpMonetizationConfig
+ * @description Runtime configuration for x402/pay.sh gated remote MCP tool execution.
+ */
+export interface SapMcpMonetizationConfig {
+    enabled: boolean;
+    provider: SapMcpMonetizationProvider;
+    payTo?: string;
+    network?: string;
+    facilitatorUrl?: string;
+    facilitatorAuthToken?: string;
+    maxTimeoutSeconds: number;
+    payShCheckoutUrl?: string;
+    prices: {
+        readPremiumUsd: number;
+        builderUsd: number;
+        valueFixedUsd: number;
+        valueBps: number;
+        minUsd: number;
+        maxUsd: number;
+    };
+}
+/**
+ * Get user-specific configuration directory
+ *
+ * Follows XDG Base Directory Specification:
+ * - Linux/macOS: ~/.config/mcp-sap/ or $XDG_CONFIG_HOME/mcp-sap/
+ * - Windows: %APPDATA%/mcp-sap/
+ */
+export declare function getConfigDir(): string;
+/**
+ * Get data directory for cache, logs, etc.
+ *
+ * - Linux/macOS: ~/.local/share/mcp-sap/ or $XDG_DATA_HOME/mcp-sap/
+ * - Windows: %LOCALAPPDATA%/mcp-sap/
+ */
+export declare function getDataDir(): string;
+/**
+ * Get log directory
+ */
+export declare function getLogDir(): string;
+/**
+ * Get cache directory
+ */
+export declare function getCacheDir(): string;
+/**
+ * Load configuration from multiple sources (priority order):
+ *
+ * 1. Environment variables (highest priority)
+ * 2. Config file (~/.config/mcp-sap/config.json or config.yaml)
+ * 3. .env file in project directory
+ * 4. Default values (lowest priority)
+ */
+export declare function loadConfig(configPath?: string): SapMcpConfig;
+/**
+ * Ensure all required directories exist
+ */
+export declare function ensureDirectories(): void;
+/**
+ * Get config file path for writing
+ */
+export declare function getConfigFilePath(): string;
+/**
+ * Save configuration to file
+ */
+export declare function saveConfig(config: Partial<SapEnvConfig>): void;
+/**
+ * Validate configuration for specific mode
+ */
+export declare function validateConfigForMode(config: SapMcpConfig): {
+    valid: boolean;
+    errors: string[];
+};
+//# sourceMappingURL=env.d.ts.map

package/dist/config/env.d.ts.map

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