@mcp-consultant-tools/service-bus 1.0.0

package/build/ServiceBusService.d.ts

@@ -0,0 +1,165 @@
+/**
+ * Azure Service Bus Integration
+ *
+ * Provides read-only access to Azure Service Bus queues and dead letter queues.
+ * Supports Entra ID authentication and per-resource connection strings.
+ *
+ * CRITICAL DESIGN: Uses TWO separate client types:
+ * - ServiceBusClient: For message operations (peek)
+ * - ServiceBusAdministrationClient: For management operations (list queues, get properties)
+ *
+ * Read-only by design: Uses peekMessages() only, NEVER receiveMessages()
+ */
+import { ServiceBusReceivedMessage, QueueProperties } from '@azure/service-bus';
+/**
+ * Service Bus namespace resource configuration
+ */
+export interface ServiceBusResource {
+    id: string;
+    name: string;
+    namespace: string;
+    active: boolean;
+    connectionString?: string;
+    description?: string;
+}
+/**
+ * Service Bus service configuration
+ */
+export interface ServiceBusConfig {
+    resources: ServiceBusResource[];
+    authMethod: 'entra-id' | 'connection-string';
+    tenantId?: string;
+    clientId?: string;
+    clientSecret?: string;
+    sanitizeMessages?: boolean;
+    peekTimeout?: number;
+    retryMaxAttempts?: number;
+    retryDelay?: number;
+    maxSearchMessages?: number;
+    maxPeekMessages?: number;
+    cacheQueueListTTL?: number;
+}
+/**
+ * Queue information
+ */
+export interface QueueInfo {
+    name: string;
+    activeMessageCount: number;
+    deadLetterMessageCount: number;
+    scheduledMessageCount: number;
+    sizeInBytes: number | undefined;
+    totalMessageCount: number | undefined;
+    requiresSession: boolean;
+}
+/**
+ * Search result
+ */
+export interface SearchResult {
+    messages: ServiceBusReceivedMessage[];
+    totalPeeked: number;
+    matchCount: number;
+    limitReached: boolean;
+}
+/**
+ * Search criteria
+ */
+export interface SearchCriteria {
+    bodyContains?: string;
+    propertyKey?: string;
+    propertyValue?: any;
+    correlationId?: string;
+    messageId?: string;
+    sessionId?: string;
+}
+export declare class ServiceBusService {
+    private config;
+    private clients;
+    private adminClients;
+    private msalClient;
+    private accessToken;
+    private tokenExpirationTime;
+    private queueListCache;
+    constructor(config: ServiceBusConfig);
+    /**
+     * Get ServiceBusClient for message operations (peek)
+     * CRITICAL: This is for message operations ONLY
+     */
+    private getClient;
+    /**
+     * Get ServiceBusAdministrationClient for management operations (list queues, properties)
+     * CRITICAL: This is for management operations ONLY
+     */
+    private getAdminClient;
+    /**
+     * Test connection to Service Bus namespace
+     * Verifies both message operations and management operations permissions
+     */
+    testConnection(resourceId: string): Promise<{
+        connected: boolean;
+        namespace: string;
+        canPeekMessages: boolean;
+        canListQueues: boolean;
+        authMethod: string;
+        error?: string;
+    }>;
+    /**
+     * List all queues in a namespace (with caching)
+     */
+    listQueues(resourceId: string): Promise<QueueInfo[]>;
+    /**
+     * Peek messages from queue (non-destructive, read-only)
+     * CRITICAL: Uses peekMessages() which NEVER removes messages from queue
+     */
+    peekMessages(resourceId: string, queueName: string, maxMessages?: number, sessionId?: string): Promise<ServiceBusReceivedMessage[]>;
+    /**
+     * Peek dead letter messages
+     */
+    peekDeadLetterMessages(resourceId: string, queueName: string, maxMessages?: number, sessionId?: string): Promise<ServiceBusReceivedMessage[]>;
+    /**
+     * Get queue configuration properties (lock duration, max delivery count, etc.)
+     */
+    getQueueConfigProperties(resourceId: string, queueName: string): Promise<QueueProperties>;
+    /**
+     * Get queue information including both runtime metrics and configuration
+     */
+    getQueueProperties(resourceId: string, queueName: string): Promise<QueueInfo>;
+    /**
+     * Search messages by content/properties
+     * WARNING: Peeks messages into memory, then filters client-side
+     */
+    searchMessages(resourceId: string, queueName: string, searchCriteria: SearchCriteria, maxMessages?: number): Promise<SearchResult>;
+    /**
+     * Get namespace properties (tier, quotas)
+     * Note: v10.0 assumes Standard tier (256 KB)
+     */
+    getNamespaceProperties(resourceId: string): Promise<{
+        namespace: string;
+        tier: string;
+        maxMessageSizeKB: number;
+    }>;
+    /**
+     * Get all configured resources
+     */
+    getAllResources(): ServiceBusResource[];
+    /**
+     * Get active resources only
+     */
+    getActiveResources(): ServiceBusResource[];
+    /**
+     * Get resource by ID (with validation)
+     */
+    getResourceById(resourceId: string): ServiceBusResource;
+    /**
+     * Sanitize sensitive data from message (if enabled)
+     */
+    private sanitizeMessage;
+    /**
+     * Sanitize object recursively
+     */
+    private sanitizeObject;
+    /**
+     * Cleanup
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=ServiceBusService.d.ts.map

package/build/ServiceBusService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceBusService.d.ts","sourceRoot":"","sources":["../src/ServiceBusService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAIL,yBAAyB,EACzB,eAAe,EAEhB,MAAM,oBAAoB,CAAC;AAS5B;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,UAAU,EAAE,UAAU,GAAG,mBAAmB,CAAC;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB,EAAE,MAAM,CAAC;IAC3B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,yBAAyB,EAAE,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,GAAG,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAmB;IAGjC,OAAO,CAAC,OAAO,CAA4C;IAC3D,OAAO,CAAC,YAAY,CAA0D;IAG9E,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,mBAAmB,CAAa;IAGxC,OAAO,CAAC,cAAc,CAAkE;gBAE5E,MAAM,EAAE,gBAAgB;IAmCpC;;;OAGG;IACH,OAAO,CAAC,SAAS;IA+BjB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAmCtB;;;OAGG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QAChD,SAAS,EAAE,OAAO,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,eAAe,EAAE,OAAO,CAAC;QACzB,aAAa,EAAE,OAAO,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IA8EF;;OAEG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IA6E1D;;;OAGG;IACG,YAAY,CAChB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,WAAW,GAAE,MAAW,EACxB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,yBAAyB,EAAE,CAAC;IAqFvC;;OAEG;IACG,sBAAsB,CAC1B,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,WAAW,GAAE,MAAW,EACxB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,yBAAyB,EAAE,CAAC;IAwEvC;;OAEG;IACG,wBAAwB,CAC5B,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,eAAe,CAAC;IAK3B;;OAEG;IACG,kBAAkB,CACtB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,SAAS,CAAC;IAiDrB;;;OAGG;IACG,cAAc,CAClB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,cAAc,EAC9B,WAAW,GAAE,MAAW,GACvB,OAAO,CAAC,YAAY,CAAC;IA8FxB;;;OAGG;IACG,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QACxD,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;IAgBF;;OAEG;IACH,eAAe,IAAI,kBAAkB,EAAE;IAIvC;;OAEG;IACH,kBAAkB,IAAI,kBAAkB,EAAE;IAI1C;;OAEG;IACI,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,kBAAkB;IAqB9D;;OAEG;IACH,OAAO,CAAC,eAAe;IAUvB;;OAEG;IACH,OAAO,CAAC,cAAc;IA6CtB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAa7B"}