ucm-mcp-server 4.2.2 → 4.3.0

package/dist/clients/UcmApiClient.d.ts

@@ -1,11 +1,16 @@
-import https from 'https';
 import { ArtifactData, AuthorData } from '../types/UcmApiTypes.js';
 export declare class UcmLocalApiClient {
     private baseUrl;
     private authToken?;
     private authorId?;
+    private organizationId?;
     private client;
-    constructor(baseUrl: string, authToken?: string | undefined, timeout?: number, authorId?: string | undefined, httpsAgent?: https.Agent);
+    constructor(baseUrl: string, authToken?: string | undefined, timeout?: number, authorId?: string | undefined, organizationId?: string | undefined);
+    /**
+     * Get organizationId from constructor or throw error
+     * For local MCP server, organizationId should be provided during initialization
+     */
+    getOrganizationId(): Promise<string>;
     private setupInterceptors;
     private ensureClient;
     getAuthors(): Promise<AuthorData[]>;
@@ -76,13 +81,11 @@ export declare class UcmLocalApiClient {
         repositoryName: string;
         displayName?: string;
         description?: string;
-        isPublic?: boolean;
     }): Promise<any>;
     getRepository(author: string, repository: string): Promise<any>;
     updateRepository(author: string, repository: string, data: {
         displayName?: string;
         description?: string;
-        isPublic?: boolean;
     }): Promise<any>;
     deleteRepository(author: string, repository: string): Promise<any>;
     listRepositories(author: string, offset?: number, limit?: number): Promise<{
@@ -108,5 +111,47 @@ export declare class UcmLocalApiClient {
         updateTechnology?: string;
         updateTags?: string;
     }): Promise<any>;
+    /**
+     * Generate markdown for SharePoint connections (safe, non-sensitive data only)
+     */
+    sharePointGenerateConnectionsMarkdown(organizationId: string, params: {
+        limit?: number;
+        offset?: number;
+    }): Promise<any>;
+    /**
+     * List SharePoint connections for an organization (includes sensitive data - use with caution)
+     */
+    sharePointListConnections(organizationId: string, params: {
+        limit?: number;
+        offset?: number;
+    }): Promise<any>;
+    /**
+     * Search SharePoint documents using Microsoft Search API
+     */
+    sharePointSearch(organizationId: string, connectionId: string, params: {
+        query: string;
+        limit?: number;
+        offset?: number;
+        fileType?: string;
+    }): Promise<any>;
+    /**
+     * List folders and files in SharePoint with pagination
+     */
+    sharePointListFolders(organizationId: string, connectionId: string, params: {
+        folderPath?: string;
+        includeFiles?: boolean;
+        recursive?: boolean;
+        limit?: number;
+        offset?: number;
+    }): Promise<any>;
+    /**
+     * Read SharePoint file content with support for both fileUrl and legacy fileId
+     */
+    sharePointReadFile(organizationId: string, connectionId: string, params: {
+        fileUrl?: string;
+        fileId?: string;
+        fileName?: string;
+        extractMetadata?: boolean;
+    }): Promise<any>;
 }
 //# sourceMappingURL=UcmApiClient.d.ts.map

package/dist/clients/UcmApiClient.js

@@ -3,22 +3,33 @@ export class UcmLocalApiClient {
     baseUrl;
     authToken;
     authorId;
+    organizationId;
     client;
-    constructor(baseUrl, authToken, timeout = 600000, authorId, httpsAgent) {
+    constructor(baseUrl, authToken, timeout = 600000, authorId, organizationId) {
         this.baseUrl = baseUrl;
         this.authToken = authToken;
         this.authorId = authorId;
+        this.organizationId = organizationId;
         this.client = axios.create({
             baseURL: this.baseUrl,
             timeout,
             headers: {
                 'Content-Type': 'application/json',
                 ...(authToken && { 'Authorization': `Bearer ${authToken}` })
-            },
-            ...(httpsAgent && { httpsAgent })
+            }
         });
         this.setupInterceptors();
     }
+    /**
+     * Get organizationId from constructor or throw error
+     * For local MCP server, organizationId should be provided during initialization
+     */
+    async getOrganizationId() {
+        if (!this.organizationId) {
+            throw new Error('Organization ID not configured. Please provide organizationId when initializing the MCP client.');
+        }
+        return this.organizationId;
+    }
     setupInterceptors() {
         this.client.interceptors.response.use((response) => response, (error) => {
             // Extract error details from API response if available
@@ -369,7 +380,63 @@ export class UcmLocalApiClient {
     async editArtifactMetadata(author, repository, category, subcategory, filename, data) {
         const client = this.ensureClient();
         const url = this.buildApiPath('authors', author, repository, category, subcategory, filename) + '/edit';
-        const response = await client.post(url, data);
+        // Transform updateTags from comma-separated string to array for API
+        const requestData = { ...data };
+        if (data.updateTags && typeof data.updateTags === 'string') {
+            // Parse comma-separated tags into array, trim whitespace, filter empty strings
+            requestData.updateTags = data.updateTags
+                .split(',')
+                .map(tag => tag.trim())
+                .filter(tag => tag.length > 0);
+        }
+        const response = await client.post(url, requestData);
+        return response.data;
+    }
+    // SharePoint API methods
+    /**
+     * Generate markdown for SharePoint connections (safe, non-sensitive data only)
+     */
+    async sharePointGenerateConnectionsMarkdown(organizationId, params) {
+        const client = this.ensureClient();
+        const response = await client.post(`/api/org/${organizationId}/sharepoint/connections/markdown`, params);
+        return response.data;
+    }
+    /**
+     * List SharePoint connections for an organization (includes sensitive data - use with caution)
+     */
+    async sharePointListConnections(organizationId, params) {
+        const client = this.ensureClient();
+        const queryParams = new URLSearchParams();
+        if (params.limit)
+            queryParams.set('limit', params.limit.toString());
+        if (params.offset)
+            queryParams.set('offset', params.offset.toString());
+        const url = `/api/org/${organizationId}/sharepoint/connections${queryParams.toString() ? '?' + queryParams.toString() : ''}`;
+        const response = await client.get(url);
+        return response.data;
+    }
+    /**
+     * Search SharePoint documents using Microsoft Search API
+     */
+    async sharePointSearch(organizationId, connectionId, params) {
+        const client = this.ensureClient();
+        const response = await client.post(`/api/org/${organizationId}/sharepoint/connections/${connectionId}/search`, params);
+        return response.data;
+    }
+    /**
+     * List folders and files in SharePoint with pagination
+     */
+    async sharePointListFolders(organizationId, connectionId, params) {
+        const client = this.ensureClient();
+        const response = await client.post(`/api/org/${organizationId}/sharepoint/connections/${connectionId}/folders`, params);
+        return response.data;
+    }
+    /**
+     * Read SharePoint file content with support for both fileUrl and legacy fileId
+     */
+    async sharePointReadFile(organizationId, connectionId, params) {
+        const client = this.ensureClient();
+        const response = await client.post(`/api/org/${organizationId}/sharepoint/connections/${connectionId}/read`, params);
         return response.data;
     }
 }

package/dist/clients/UcmLocalApiClient.d.ts

@@ -0,0 +1,165 @@
+import { ArtifactData, AuthorData } from '../types/UcmApiTypes.js';
+export declare class UcmLocalApiClient {
+    private baseUrl;
+    private authToken?;
+    private authorId?;
+    private organizationId?;
+    private client;
+    constructor(baseUrl: string, authToken?: string | undefined, timeout?: number, authorId?: string | undefined, organizationId?: string | undefined);
+    private setupInterceptors;
+    private ensureClient;
+    getAuthors(): Promise<AuthorData[]>;
+    getAuthor(authorId: string): Promise<AuthorData | null>;
+    private buildApiPath;
+    getArtifact(author?: string, repository?: string, category?: string, subcategory?: string, filename?: string, version?: string): Promise<ArtifactData>;
+    getLatestArtifact(author?: string, repository?: string, category?: string, subcategory?: string, filename?: string): Promise<ArtifactData>;
+    listArtifacts(author?: string, repository?: string, category?: string, subcategory?: string, offset?: number, limit?: number): Promise<{
+        data: any[];
+        pagination: {
+            offset: number;
+            limit: number;
+            total: number;
+        };
+        _links?: any;
+    }>;
+    searchArtifacts(filters?: {
+        repository?: string;
+        category?: string;
+        technology?: string;
+        subcategory?: string;
+        offset?: number;
+        limit?: number;
+    }): Promise<ArtifactData[]>;
+    searchArtifactsByText(searchParams: {
+        searchText?: string;
+        namespace?: string;
+        author?: string;
+        repository?: string;
+        category?: string;
+        subcategory?: string;
+        filename?: string;
+        tags?: string;
+        offset?: number;
+        limit?: number;
+    }): Promise<{
+        data: any[];
+        pagination: {
+            offset: number;
+            limit: number;
+            total: number;
+            hasMore: boolean;
+        };
+        _links?: any;
+    }>;
+    publishArtifact(author: string, repository: string, category: string, subcategory: string, data: any): Promise<ArtifactData>;
+    updateArtifact(author: string, repository: string, category: string, subcategory: string, filename: string, version: string, data: any): Promise<ArtifactData>;
+    deleteArtifact(author: string, repository: string, category: string, subcategory: string, filename: string, version?: string): Promise<any>;
+    getArtifactVersions(author: string, repository: string, category: string, subcategory: string, filename: string): Promise<any>;
+    getCategories(): Promise<string[]>;
+    healthCheck(): Promise<{
+        status: string;
+        timestamp: string;
+    }>;
+    getQuickstart(): Promise<string>;
+    getAuthorIndex(author: string, repository?: string): Promise<string>;
+    getAuthorRecents(author: string): Promise<string>;
+    /**
+     * Cleanup method to properly dispose of HTTP client resources
+     * This helps prevent memory leaks from accumulated AbortSignal listeners
+     */
+    cleanup(): void;
+    /**
+     * Check if the client is still available for use
+     */
+    isAvailable(): boolean;
+    createRepository(author: string, data: {
+        repositoryName: string;
+        displayName?: string;
+        description?: string;
+    }): Promise<any>;
+    getRepository(author: string, repository: string): Promise<any>;
+    updateRepository(author: string, repository: string, data: {
+        displayName?: string;
+        description?: string;
+    }): Promise<any>;
+    deleteRepository(author: string, repository: string): Promise<any>;
+    listRepositories(author: string, offset?: number, limit?: number): Promise<{
+        data: any[];
+        pagination: {
+            offset: number;
+            limit: number;
+            total: number;
+        };
+        _links?: any;
+    }>;
+    submitFeedback(data: {
+        title: string;
+        body: string;
+        reportType: 'issue' | 'feedback';
+        tags?: string;
+    }): Promise<any>;
+    editArtifactMetadata(author: string, repository: string, category: string, subcategory: string, filename: string, data: {
+        updateDescription?: string;
+        updateNamespace?: string;
+        updateFilename?: string;
+        updateMimeType?: string;
+        updateTechnology?: string;
+        updateTags?: string;
+    }): Promise<any>;
+    /**
+     * List External Connections including SharePoint
+     * Returns markdown with a table of connections available
+     */
+    listExternalConnections(params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<string>;
+    /**
+     * Search SharePoint documents using Microsoft Search API
+     * Uses V1 API - organizationId is auto-detected from auth token
+     */
+    sharePointSearch(connectionId: string, params: {
+        query: string;
+        limit?: number;
+        offset?: number;
+        fileType?: string;
+    }): Promise<any>;
+    /**
+     * List folders and files in SharePoint with pagination
+     * Uses V1 API - organizationId is auto-detected from auth token
+     */
+    sharePointListFolders(connectionId: string, params: {
+        folderPath?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<any>;
+    /**
+     * Read SharePoint file content with support for both fileUrl and legacy fileId
+     * Uses V1 API - organizationId is auto-detected from auth token
+     */
+    sharePointReadFile(connectionId: string, params: {
+        fileUrl: string;
+        extractMetadata?: boolean;
+        offset?: number;
+        limit?: number;
+    }): Promise<any>;
+    /**
+     * Read SharePoint related file (image/embedded file extracted from document)
+     * Uses V1 API - organizationId is auto-detected from auth token
+     * Accepts full URI from markdown (with or without protocol prefix)
+     * Returns complete file content (no pagination support)
+     */
+    sharePointReadRelatedFile(uri: string): Promise<any>;
+    /**
+     * Extract fileName from SharePoint related file URI
+     * Helper method for metadata purposes
+     */
+    private extractFileNameFromUri;
+    /**
+     * Revoke SharePoint OnBehalfOf authorization for a connection
+     * Deletes user's access tokens from Key Vault and database
+     * Uses V1 API - organizationId is auto-detected from auth token
+     */
+    sharePointSignOut(connectionId: string): Promise<any>;
+}
+//# sourceMappingURL=UcmLocalApiClient.d.ts.map