@ttpears/gitlab-mcp-server 1.7.0

package/dist/config.d.ts

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+export declare const ConfigSchema: z.ZodObject<{
+    gitlabUrl: z.ZodDefault<z.ZodString>;
+    sharedAccessToken: z.ZodOptional<z.ZodString>;
+    maxPageSize: z.ZodDefault<z.ZodNumber>;
+    defaultTimeout: z.ZodDefault<z.ZodNumber>;
+    authMode: z.ZodDefault<z.ZodEnum<["shared", "per-user", "hybrid"]>>;
+}, "strip", z.ZodTypeAny, {
+    gitlabUrl: string;
+    maxPageSize: number;
+    defaultTimeout: number;
+    authMode: "shared" | "per-user" | "hybrid";
+    sharedAccessToken?: string | undefined;
+}, {
+    gitlabUrl?: string | undefined;
+    sharedAccessToken?: string | undefined;
+    maxPageSize?: number | undefined;
+    defaultTimeout?: number | undefined;
+    authMode?: "shared" | "per-user" | "hybrid" | undefined;
+}>;
+export type Config = z.infer<typeof ConfigSchema>;
+export declare const UserConfigSchema: z.ZodObject<{
+    accessToken: z.ZodString;
+    gitlabUrl: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    accessToken: string;
+    gitlabUrl?: string | undefined;
+}, {
+    accessToken: string;
+    gitlabUrl?: string | undefined;
+}>;
+export type UserConfig = z.infer<typeof UserConfigSchema>;
+export declare function loadConfig(): Config;
+export declare function validateUserConfig(userCredentials: any): UserConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;EAQvB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAGlD,eAAO,MAAM,gBAAgB;;;;;;;;;EAG3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,wBAAgB,UAAU,IAAI,MAAM,CAUnC;AAED,wBAAgB,kBAAkB,CAAC,eAAe,EAAE,GAAG,GAAG,UAAU,CAEnE"}

package/dist/config.js

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+export const ConfigSchema = z.object({
+    gitlabUrl: z.string().url().default('https://gitlab.com'),
+    // Shared read-only token (optional - for read operations when no user token provided)
+    sharedAccessToken: z.string().optional(),
+    maxPageSize: z.number().min(1).max(100).default(50),
+    defaultTimeout: z.number().min(1000).default(30000),
+    // Authentication mode
+    authMode: z.enum(['shared', 'per-user', 'hybrid']).default('hybrid'),
+});
+// User-specific configuration for per-user authentication
+export const UserConfigSchema = z.object({
+    accessToken: z.string().min(1, 'User access token is required'),
+    gitlabUrl: z.string().url().optional(), // Allow user to override GitLab URL if needed
+});
+export function loadConfig() {
+    const config = {
+        gitlabUrl: process.env.GITLAB_URL || 'https://gitlab.com',
+        sharedAccessToken: process.env.GITLAB_SHARED_ACCESS_TOKEN || undefined,
+        maxPageSize: parseInt(process.env.GITLAB_MAX_PAGE_SIZE || '50'),
+        defaultTimeout: parseInt(process.env.GITLAB_TIMEOUT || '30000'),
+        authMode: process.env.GITLAB_AUTH_MODE || 'hybrid',
+    };
+    return ConfigSchema.parse(config);
+}
+export function validateUserConfig(userCredentials) {
+    return UserConfigSchema.parse(userCredentials);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,oBAAoB,CAAC;IACzD,sFAAsF;IACtF,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACxC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACnD,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACnD,sBAAsB;IACtB,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;CACrE,CAAC,CAAC;AAIH,0DAA0D;AAC1D,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,+BAA+B,CAAC;IAC/D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE,8CAA8C;CACvF,CAAC,CAAC;AAIH,MAAM,UAAU,UAAU;IACxB,MAAM,MAAM,GAAG;QACb,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,oBAAoB;QACzD,iBAAiB,EAAE,OAAO,CAAC,GAAG,CAAC,0BAA0B,IAAI,SAAS;QACtE,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,IAAI,CAAC;QAC/D,cAAc,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,OAAO,CAAC;QAC/D,QAAQ,EAAG,OAAO,CAAC,GAAG,CAAC,gBAAqD,IAAI,QAAQ;KACzF,CAAC;IAEF,OAAO,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,eAAoB;IACrD,OAAO,gBAAgB,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;AACjD,CAAC"}

package/dist/gitlab-client.d.ts

@@ -0,0 +1,96 @@
+import type { Config, UserConfig } from './config.js';
+export interface GitLabGraphQLError {
+    message: string;
+    locations?: Array<{
+        line: number;
+        column: number;
+    }>;
+    path?: string[];
+    extensions?: {
+        code?: string;
+        spam?: boolean;
+        needsCaptchaResponse?: boolean;
+        problems?: Array<{
+            path: string[];
+            explanation: string;
+        }>;
+    };
+}
+export declare class GitLabAPIError extends Error {
+    readonly code: string;
+    readonly statusCode?: number;
+    readonly isRetryable: boolean;
+    readonly isRateLimited: boolean;
+    readonly retryAfter?: number;
+    readonly originalError?: Error;
+    constructor(message: string, options?: {
+        code?: string;
+        statusCode?: number;
+        isRetryable?: boolean;
+        isRateLimited?: boolean;
+        retryAfter?: number;
+        originalError?: Error;
+    });
+}
+export declare class GitLabGraphQLClient {
+    private baseClient;
+    private config;
+    private schema;
+    private userClients;
+    constructor(config: Config);
+    private createClient;
+    /**
+     * Parse GraphQL/HTTP errors into structured GitLabAPIError
+     */
+    private parseError;
+    /**
+     * Execute request with exponential backoff retry
+     */
+    private executeWithRetry;
+    private getUserClient;
+    private getClient;
+    introspectSchema(userConfig?: UserConfig): Promise<void>;
+    query<T = any>(query: string, variables?: any, userConfig?: UserConfig, requiresWrite?: boolean): Promise<T>;
+    getCurrentUser(userConfig?: UserConfig): Promise<any>;
+    getProject(fullPath: string, userConfig?: UserConfig): Promise<any>;
+    getProjects(first?: number, after?: string, userConfig?: UserConfig): Promise<any>;
+    getIssues(projectPath: string, first?: number, after?: string, userConfig?: UserConfig): Promise<any>;
+    getMergeRequests(projectPath: string, first?: number, after?: string, userConfig?: UserConfig): Promise<any>;
+    createIssue(projectPath: string, title: string, description?: string, userConfig?: UserConfig): Promise<any>;
+    createMergeRequest(projectPath: string, title: string, sourceBranch: string, targetBranch: string, description?: string, userConfig?: UserConfig): Promise<any>;
+    getSchema(): any;
+    getAvailableQueries(): string[];
+    getAvailableMutations(): string[];
+    getIssueId(projectPath: string, iid: string, userConfig?: UserConfig): Promise<string>;
+    getUserIdsByUsernames(usernames: string[], userConfig?: UserConfig): Promise<Record<string, string>>;
+    getLabelIds(projectPath: string, labelNames: string[], userConfig?: UserConfig): Promise<Record<string, string>>;
+    updateIssueComposite(projectPath: string, iid: string, options: {
+        title?: string;
+        description?: string;
+        assigneeUsernames?: string[];
+        labelNames?: string[];
+        dueDate?: string;
+    }, userConfig?: UserConfig): Promise<any>;
+    getMergeRequestId(projectPath: string, iid: string, userConfig?: UserConfig): Promise<string>;
+    updateMergeRequestComposite(projectPath: string, iid: string, options: {
+        title?: string;
+        description?: string;
+        assigneeUsernames?: string[];
+        reviewerUsernames?: string[];
+        labelNames?: string[];
+    }, userConfig?: UserConfig): Promise<any>;
+    getTypeFields(typeName: string): string[];
+    globalSearch(searchTerm?: string, scope?: string, userConfig?: UserConfig): Promise<any>;
+    searchProjects(searchTerm: string, first?: number, after?: string, userConfig?: UserConfig): Promise<any>;
+    private getTypeName;
+    private getEnumValues;
+    searchIssues(searchTerm?: string, projectPath?: string, state?: string, first?: number, after?: string, userConfig?: UserConfig, assigneeUsernames?: string[], authorUsername?: string, labelNames?: string[]): Promise<any>;
+    searchMergeRequests(searchTerm: string, projectPath?: string, state?: string, first?: number, after?: string, userConfig?: UserConfig): Promise<any>;
+    searchRepositoryFiles(projectPath: string, path: string, ref?: string, userConfig?: UserConfig): Promise<any>;
+    resolvePath(fullPath: string, first?: number, after?: string, userConfig?: UserConfig): Promise<any>;
+    getGroup(fullPath: string, first?: number, after?: string, searchTerm?: string, userConfig?: UserConfig): Promise<any>;
+    getFileContent(projectPath: string, filePath: string, ref?: string, userConfig?: UserConfig): Promise<any>;
+    searchUsers(searchTerm: string, first?: number, userConfig?: UserConfig): Promise<any>;
+    searchGroups(searchTerm: string, first?: number, userConfig?: UserConfig): Promise<any>;
+}
+//# sourceMappingURL=gitlab-client.d.ts.map

package/dist/gitlab-client.d.ts.map

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