mcp-http-webhook 1.0.0

package/dist/stores/RedisStore.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisStore = void 0;
+exports.createRedisStore = createRedisStore;
+/**
+ * Redis store implementation
+ * Requires ioredis package
+ */
+class RedisStore {
+    constructor(redis) {
+        this.redis = redis;
+    } // ioredis instance
+    async get(key) {
+        return await this.redis.get(key);
+    }
+    async set(key, value, ttl) {
+        if (ttl) {
+            await this.redis.setex(key, ttl, value);
+        }
+        else {
+            await this.redis.set(key, value);
+        }
+    }
+    async delete(key) {
+        await this.redis.del(key);
+    }
+    async scan(pattern) {
+        const keys = [];
+        let cursor = '0';
+        do {
+            const [newCursor, matches] = await this.redis.scan(cursor, 'MATCH', pattern, 'COUNT', 100);
+            cursor = newCursor;
+            keys.push(...matches);
+        } while (cursor !== '0');
+        return keys;
+    }
+}
+exports.RedisStore = RedisStore;
+/**
+ * Create Redis store from connection URL
+ */
+function createRedisStore(redis) {
+    return new RedisStore(redis);
+}
+//# sourceMappingURL=RedisStore.js.map

package/dist/stores/RedisStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RedisStore.js","sourceRoot":"","sources":["../../src/stores/RedisStore.ts"],"names":[],"mappings":";;;AAgDA,4CAEC;AAhDD;;;GAGG;AACH,MAAa,UAAU;IACrB,YAAoB,KAAU;QAAV,UAAK,GAAL,KAAK,CAAK;IAAG,CAAC,CAAC,mBAAmB;IAEtD,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAa,EAAE,GAAY;QAChD,IAAI,GAAG,EAAE,CAAC;YACR,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;QAC1C,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAAe;QACxB,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,IAAI,MAAM,GAAG,GAAG,CAAC;QAEjB,GAAG,CAAC;YACF,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAChD,MAAM,EACN,OAAO,EACP,OAAO,EACP,OAAO,EACP,GAAG,CACJ,CAAC;YACF,MAAM,GAAG,SAAS,CAAC;YACnB,IAAI,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC;QACxB,CAAC,QAAQ,MAAM,KAAK,GAAG,EAAE;QAEzB,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AArCD,gCAqCC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,KAAU;IACzC,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC"}

package/dist/stores/index.d.ts

@@ -0,0 +1,3 @@
+export { InMemoryStore } from './InMemoryStore';
+export { RedisStore, createRedisStore } from './RedisStore';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/stores/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/dist/stores/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRedisStore = exports.RedisStore = exports.InMemoryStore = void 0;
+var InMemoryStore_1 = require("./InMemoryStore");
+Object.defineProperty(exports, "InMemoryStore", { enumerable: true, get: function () { return InMemoryStore_1.InMemoryStore; } });
+var RedisStore_1 = require("./RedisStore");
+Object.defineProperty(exports, "RedisStore", { enumerable: true, get: function () { return RedisStore_1.RedisStore; } });
+Object.defineProperty(exports, "createRedisStore", { enumerable: true, get: function () { return RedisStore_1.createRedisStore; } });
+//# sourceMappingURL=index.js.map

package/dist/stores/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/stores/index.ts"],"names":[],"mappings":";;;AAAA,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AACtB,2CAA4D;AAAnD,wGAAA,UAAU,OAAA;AAAE,8GAAA,gBAAgB,OAAA"}

package/dist/subscriptions/SubscriptionManager.d.ts

@@ -0,0 +1,49 @@
+import { AuthContext, KeyValueStore, Logger, ResourceDefinition, StoredSubscription } from '../types';
+export declare class SubscriptionManager {
+    private store;
+    private resources;
+    private publicUrl;
+    private logger?;
+    constructor(store: KeyValueStore, resources: ResourceDefinition[], publicUrl: string, logger?: Logger | undefined);
+    /**
+     * Create a new subscription
+     */
+    createSubscription(params: {
+        uri: string;
+        clientCallbackUrl: string;
+        clientCallbackSecret?: string;
+        context: AuthContext;
+    }): Promise<{
+        subscriptionId: string;
+        status: string;
+    }>;
+    /**
+     * Delete a subscription
+     */
+    deleteSubscription(subscriptionId: string, context: AuthContext): Promise<void>;
+    /**
+     * Get subscription by ID
+     */
+    getSubscription(subscriptionId: string): Promise<StoredSubscription | null>;
+    /**
+     * List subscriptions for a user
+     */
+    listSubscriptions(userId: string): Promise<StoredSubscription[]>;
+    /**
+     * Store subscription data
+     */
+    private storeSubscription;
+    /**
+     * Load subscription data
+     */
+    private loadSubscription;
+    /**
+     * Remove subscription data
+     */
+    private removeSubscription;
+    /**
+     * Find resource definition for URI
+     */
+    private findResourceForUri;
+}
+//# sourceMappingURL=SubscriptionManager.d.ts.map

package/dist/subscriptions/SubscriptionManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubscriptionManager.d.ts","sourceRoot":"","sources":["../../src/subscriptions/SubscriptionManager.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EACX,aAAa,EACb,MAAM,EACN,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,UAAU,CAAC;AAGlB,qBAAa,mBAAmB;IAE5B,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,MAAM,CAAC;gBAHP,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,kBAAkB,EAAE,EAC/B,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,YAAA;IAGzB;;OAEG;IACG,kBAAkB,CAAC,MAAM,EAAE;QAC/B,GAAG,EAAE,MAAM,CAAC;QACZ,iBAAiB,EAAE,MAAM,CAAC;QAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,OAAO,EAAE,WAAW,CAAC;KACtB,GAAG,OAAO,CAAC;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IA6DvD;;OAEG;IACG,kBAAkB,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA6CrF;;OAEG;IACG,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAIjF;;OAEG;IACG,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAiBtE;;OAEG;YACW,iBAAiB;IAmB/B;;OAEG;YACW,gBAAgB;IAW9B;;OAEG;YACW,kBAAkB;IAehC;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAoB3B"}

package/dist/subscriptions/SubscriptionManager.js

@@ -0,0 +1,181 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubscriptionManager = void 0;
+const errors_1 = require("../errors");
+const utils_1 = require("../utils");
+class SubscriptionManager {
+    constructor(store, resources, publicUrl, logger) {
+        this.store = store;
+        this.resources = resources;
+        this.publicUrl = publicUrl;
+        this.logger = logger;
+    }
+    /**
+     * Create a new subscription
+     */
+    async createSubscription(params) {
+        const { uri, clientCallbackUrl, clientCallbackSecret, context } = params;
+        // Find resource definition
+        const resource = this.findResourceForUri(uri);
+        if (!resource) {
+            throw new errors_1.ValidationError(`No resource found for URI: ${uri}`);
+        }
+        if (!resource.subscription) {
+            throw new errors_1.ValidationError(`Resource ${resource.name} does not support subscriptions`);
+        }
+        // Generate subscription ID
+        const subscriptionId = (0, utils_1.generateSubscriptionId)();
+        const thirdPartyWebhookUrl = (0, utils_1.generateWebhookUrl)(this.publicUrl, subscriptionId);
+        this.logger?.info('Creating subscription', {
+            subscriptionId,
+            uri,
+            clientCallbackUrl,
+        });
+        try {
+            // Call resource's onSubscribe handler
+            const metadata = await resource.subscription.onSubscribe(uri, subscriptionId, thirdPartyWebhookUrl, context);
+            // Store subscription data
+            const subscriptionData = {
+                uri,
+                resourceType: resource.name,
+                clientCallbackUrl,
+                clientCallbackSecret,
+                userId: context.userId,
+                thirdPartyWebhookId: metadata.thirdPartyWebhookId,
+                metadata: metadata.metadata,
+                createdAt: Date.now(),
+            };
+            await this.storeSubscription(subscriptionId, subscriptionData, context.userId);
+            this.logger?.info('Subscription created', { subscriptionId });
+            return {
+                subscriptionId,
+                status: 'active',
+            };
+        }
+        catch (error) {
+            this.logger?.error('Failed to create subscription', {
+                subscriptionId,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw new errors_1.StorageError('Failed to create subscription', { cause: error });
+        }
+    }
+    /**
+     * Delete a subscription
+     */
+    async deleteSubscription(subscriptionId, context) {
+        this.logger?.info('Deleting subscription', { subscriptionId });
+        // Load subscription
+        const subscription = await this.loadSubscription(subscriptionId);
+        if (!subscription) {
+            throw new errors_1.ValidationError(`Subscription ${subscriptionId} not found`);
+        }
+        // Verify ownership
+        if (subscription.userId !== context.userId) {
+            throw new errors_1.ValidationError('Unauthorized to delete this subscription');
+        }
+        // Find resource
+        const resource = this.findResourceForUri(subscription.uri);
+        if (!resource?.subscription) {
+            throw new errors_1.StorageError('Resource subscription configuration not found');
+        }
+        try {
+            // Call resource's onUnsubscribe handler
+            await resource.subscription.onUnsubscribe(subscription.uri, subscriptionId, {
+                thirdPartyWebhookId: subscription.thirdPartyWebhookId,
+                metadata: subscription.metadata,
+            }, context);
+            // Delete from store
+            await this.removeSubscription(subscriptionId, context.userId);
+            this.logger?.info('Subscription deleted', { subscriptionId });
+        }
+        catch (error) {
+            this.logger?.error('Failed to delete subscription', {
+                subscriptionId,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw new errors_1.StorageError('Failed to delete subscription', { cause: error });
+        }
+    }
+    /**
+     * Get subscription by ID
+     */
+    async getSubscription(subscriptionId) {
+        return this.loadSubscription(subscriptionId);
+    }
+    /**
+     * List subscriptions for a user
+     */
+    async listSubscriptions(userId) {
+        const indexKey = `user:${userId}:subscriptions`;
+        const indexData = await this.store.get(indexKey);
+        if (!indexData) {
+            return [];
+        }
+        const subscriptionIds = JSON.parse(indexData);
+        const subscriptions = await Promise.all(subscriptionIds.map((id) => this.loadSubscription(id)));
+        return subscriptions.filter((s) => s !== null);
+    }
+    /**
+     * Store subscription data
+     */
+    async storeSubscription(subscriptionId, data, userId) {
+        const key = `subscription:${subscriptionId}`;
+        await this.store.set(key, JSON.stringify(data));
+        // Update user index
+        const indexKey = `user:${userId}:subscriptions`;
+        const existing = await this.store.get(indexKey);
+        const subscriptionIds = existing ? JSON.parse(existing) : [];
+        if (!subscriptionIds.includes(subscriptionId)) {
+            subscriptionIds.push(subscriptionId);
+            await this.store.set(indexKey, JSON.stringify(subscriptionIds));
+        }
+    }
+    /**
+     * Load subscription data
+     */
+    async loadSubscription(subscriptionId) {
+        const key = `subscription:${subscriptionId}`;
+        const data = await this.store.get(key);
+        if (!data) {
+            return null;
+        }
+        return JSON.parse(data);
+    }
+    /**
+     * Remove subscription data
+     */
+    async removeSubscription(subscriptionId, userId) {
+        const key = `subscription:${subscriptionId}`;
+        await this.store.delete(key);
+        // Update user index
+        const indexKey = `user:${userId}:subscriptions`;
+        const existing = await this.store.get(indexKey);
+        if (existing) {
+            const subscriptionIds = JSON.parse(existing);
+            const filtered = subscriptionIds.filter((id) => id !== subscriptionId);
+            await this.store.set(indexKey, JSON.stringify(filtered));
+        }
+    }
+    /**
+     * Find resource definition for URI
+     */
+    findResourceForUri(uri) {
+        return this.resources.find((resource) => {
+            // Convert URI template to regex pattern
+            // Step 1: Replace template variables with a placeholder
+            const withPlaceholders = resource.uri.replace(/\{[^}]+\}/g, '__PLACEHOLDER__');
+            // Step 2: Escape special regex characters (but not our placeholders)
+            const escapedPattern = withPlaceholders.replace(/[-\\^$*+?.()|[\]{}]/g, '\\$&');
+            // Step 3: Replace placeholders with capture groups
+            const patternString = escapedPattern.replace(/__PLACEHOLDER__/g, '([^/]+)');
+            // Step 4: Create regex with anchors
+            const pattern = new RegExp('^' + patternString + '$');
+            console.log('Pattern for resource', resource.name, ':', pattern);
+            console.log('Testing URI:', uri);
+            return pattern.test(uri);
+        });
+    }
+}
+exports.SubscriptionManager = SubscriptionManager;
+//# sourceMappingURL=SubscriptionManager.js.map

package/dist/subscriptions/SubscriptionManager.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,271 @@
+import { Request, Response, NextFunction } from 'express';
+/**
+ * JSON Schema definition for input validation
+ */
+export interface JSONSchema {
+    type: string;
+    properties?: Record<string, any>;
+    required?: string[];
+    [key: string]: any;
+}
+/**
+ * Authentication context passed to handlers
+ */
+export interface AuthContext {
+    userId: string;
+    [key: string]: any;
+}
+/**
+ * Authentication handler function
+ */
+export type AuthenticateFunction = (req: Request) => Promise<AuthContext>;
+/**
+ * Logger interface
+ */
+export interface Logger {
+    debug(message: string, meta?: any): void;
+    info(message: string, meta?: any): void;
+    warn(message: string, meta?: any): void;
+    error(message: string, meta?: any): void;
+}
+/**
+ * Key-value store interface for persistence
+ */
+export interface KeyValueStore {
+    /**
+     * Get value by key
+     * @returns Value as string, or null if not found
+     */
+    get(key: string): Promise<string | null>;
+    /**
+     * Set value with optional TTL
+     * @param key - Key to set
+     * @param value - Value (will be JSON stringified)
+     * @param ttl - Time to live in seconds (optional)
+     */
+    set(key: string, value: string, ttl?: number): Promise<void>;
+    /**
+     * Delete key
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Scan keys by pattern (optional, for debugging)
+     * @param pattern - Glob pattern (e.g., "subscription:*")
+     */
+    scan?(pattern: string): Promise<string[]>;
+}
+/**
+ * Tool handler function
+ */
+export type ToolHandler<TInput = any, TOutput = any> = (input: TInput, context: AuthContext) => Promise<TOutput>;
+/**
+ * Tool definition
+ */
+export interface ToolDefinition<TInput = any, TOutput = any> {
+    name: string;
+    description: string;
+    inputSchema: JSONSchema;
+    handler: ToolHandler<TInput, TOutput>;
+}
+/**
+ * Resource list item
+ */
+export interface ResourceListItem {
+    uri: string;
+    name: string;
+    description?: string;
+    mimeType?: string;
+}
+/**
+ * Resource read result
+ */
+export interface ResourceReadResult<TData = any> {
+    contents: TData;
+    metadata?: Record<string, any>;
+}
+/**
+ * Resource read options
+ */
+export interface ResourceReadOptions {
+    pagination?: {
+        page?: number;
+        limit?: number;
+    };
+}
+/**
+ * Subscription metadata returned by onSubscribe
+ */
+export interface SubscriptionMetadata {
+    thirdPartyWebhookId: string;
+    metadata?: Record<string, any>;
+}
+/**
+ * Webhook change information
+ */
+export interface WebhookChangeInfo {
+    resourceUri: string;
+    changeType: 'created' | 'updated' | 'deleted';
+    data?: any;
+}
+/**
+ * Resource subscription handlers
+ */
+export interface ResourceSubscription {
+    /**
+     * Called when a client subscribes to a resource
+     */
+    onSubscribe: (uri: string, subscriptionId: string, thirdPartyWebhookUrl: string, context: AuthContext) => Promise<SubscriptionMetadata>;
+    /**
+     * Called when a client unsubscribes
+     */
+    onUnsubscribe: (uri: string, subscriptionId: string, storedData: SubscriptionMetadata, context: AuthContext) => Promise<void>;
+    /**
+     * Called when third-party webhook is received
+     */
+    onWebhook: (subscriptionId: string, payload: any, headers: Record<string, string>) => Promise<WebhookChangeInfo | null>;
+}
+/**
+ * Resource definition
+ */
+export interface ResourceDefinition<TData = any> {
+    uri: string;
+    name: string;
+    description: string;
+    mimeType?: string;
+    read: (uri: string, context: AuthContext, options?: ResourceReadOptions) => Promise<ResourceReadResult<TData>>;
+    list?: (context: AuthContext) => Promise<ResourceListItem[]>;
+    subscription?: ResourceSubscription;
+}
+/**
+ * Prompt definition
+ */
+export interface PromptDefinition {
+    name: string;
+    description: string;
+    arguments?: Array<{
+        name: string;
+        description: string;
+        required?: boolean;
+    }>;
+    handler: (args: Record<string, any>, context: AuthContext) => Promise<{
+        messages: Array<{
+            role: 'user' | 'assistant';
+            content: string;
+        }>;
+    }>;
+}
+/**
+ * Webhook configuration
+ */
+export interface WebhookConfig {
+    incomingPath?: string;
+    incomingSecret?: string;
+    verifyIncomingSignature?: (payload: any, signature: string, secret: string) => boolean;
+    outgoing?: {
+        timeout?: number;
+        retries?: number;
+        retryDelay?: number;
+        signPayload?: (payload: any, secret: string) => string;
+        onBeforeCall?: (url: string, payload: any) => void;
+        onAfterCall?: (url: string, response: any, error?: any) => void;
+    };
+}
+/**
+ * Metrics configuration
+ */
+export interface MetricsConfig {
+    enabled: boolean;
+    registry?: any;
+}
+/**
+ * Tracing configuration
+ */
+export interface TracingConfig {
+    enabled: boolean;
+    serviceName?: string;
+}
+/**
+ * Batch configuration
+ */
+export interface BatchConfig {
+    maxBatchSize?: number;
+    batchTimeout?: number;
+}
+/**
+ * Cache configuration
+ */
+export interface CacheConfig {
+    enabled: boolean;
+    ttl?: number;
+    keyPrefix?: string;
+}
+/**
+ * Dead letter queue configuration
+ */
+export interface DeadLetterQueueConfig {
+    enabled: boolean;
+    store: KeyValueStore;
+    retention?: number;
+    maxRetries?: number;
+}
+/**
+ * Middleware function
+ */
+export type Middleware = (req: Request, res: Response, next: NextFunction) => void | Promise<void>;
+/**
+ * MCP Server configuration
+ */
+export interface MCPServerConfig {
+    name: string;
+    version: string;
+    port?: number;
+    host?: string;
+    basePath?: string;
+    publicUrl: string;
+    authenticate?: AuthenticateFunction;
+    tools: ToolDefinition[];
+    resources: ResourceDefinition[];
+    prompts?: PromptDefinition[];
+    store: KeyValueStore;
+    webhooks?: WebhookConfig;
+    batch?: BatchConfig;
+    cache?: CacheConfig;
+    metrics?: MetricsConfig;
+    tracing?: TracingConfig;
+    middleware?: Middleware[];
+    logger?: Logger;
+    logLevel?: 'debug' | 'info' | 'warn' | 'error';
+}
+/**
+ * Stored subscription data
+ */
+export interface StoredSubscription {
+    uri: string;
+    resourceType: string;
+    clientCallbackUrl: string;
+    clientCallbackSecret?: string;
+    userId: string;
+    thirdPartyWebhookId: string;
+    metadata?: any;
+    createdAt: number;
+}
+/**
+ * MCP Error codes
+ */
+export declare enum MCPErrorCode {
+    AuthenticationError = -32001,
+    ValidationError = -32002,
+    ResourceNotFoundError = -32003,
+    ToolExecutionError = -32004,
+    WebhookError = -32005,
+    StorageError = -32006
+}
+/**
+ * MCP Server instance
+ */
+export interface MCPServer {
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    getApp(): any;
+}
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/types/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCPErrorCode = void 0;
+/**
+ * MCP Error codes
+ */
+var MCPErrorCode;
+(function (MCPErrorCode) {
+    MCPErrorCode[MCPErrorCode["AuthenticationError"] = -32001] = "AuthenticationError";
+    MCPErrorCode[MCPErrorCode["ValidationError"] = -32002] = "ValidationError";
+    MCPErrorCode[MCPErrorCode["ResourceNotFoundError"] = -32003] = "ResourceNotFoundError";
+    MCPErrorCode[MCPErrorCode["ToolExecutionError"] = -32004] = "ToolExecutionError";
+    MCPErrorCode[MCPErrorCode["WebhookError"] = -32005] = "WebhookError";
+    MCPErrorCode[MCPErrorCode["StorageError"] = -32006] = "StorageError";
+})(MCPErrorCode || (exports.MCPErrorCode = MCPErrorCode = {}));
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;AAiUA;;GAEG;AACH,IAAY,YAOX;AAPD,WAAY,YAAY;IACtB,kFAA4B,CAAA;IAC5B,0EAAwB,CAAA;IACxB,sFAA8B,CAAA;IAC9B,gFAA2B,CAAA;IAC3B,oEAAqB,CAAA;IACrB,oEAAqB,CAAA;AACvB,CAAC,EAPW,YAAY,4BAAZ,YAAY,QAOvB"}

package/dist/utils/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Generate a unique subscription ID
+ */
+export declare function generateSubscriptionId(): string;
+/**
+ * Generate webhook URL for third-party services
+ */
+export declare function generateWebhookUrl(publicUrl: string, subscriptionId: string): string;
+/**
+ * Parse URI template
+ * Example: parseUriTemplate('github://repo/{owner}/{repo}', 'github://repo/octocat/hello')
+ * Returns: { owner: 'octocat', repo: 'hello' }
+ */
+export declare function parseUriTemplate(template: string, uri: string): Record<string, string>;
+/**
+ * Match URI against template
+ */
+export declare function matchUriTemplate(template: string, uri: string): boolean;
+/**
+ * Create HMAC signature
+ */
+export declare function createHmacSignature(payload: any, secret: string, algorithm?: 'sha256' | 'sha1'): string;
+/**
+ * Verify HMAC signature (timing-safe comparison)
+ */
+export declare function verifyHmacSignature(payload: any, signature: string, secret: string, algorithm?: 'sha256' | 'sha1'): boolean;
+/**
+ * Sleep utility for retry delays
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Exponential backoff calculator
+ */
+export declare function calculateBackoff(attempt: number, baseDelay: number): number;
+/**
+ * Sanitize URL for logging (remove sensitive query params)
+ */
+export declare function sanitizeUrl(url: string): string;
+/**
+ * Extract error message safely
+ */
+export declare function extractErrorMessage(error: unknown): string;
+/**
+ * Validate URL format
+ */
+export declare function isValidUrl(url: string): boolean;
+/**
+ * Validate HTTPS URL
+ */
+export declare function isHttpsUrl(url: string): boolean;
+//# sourceMappingURL=index.d.ts.map