@daghis/teamcity-mcp 0.1.2

package/dist/src/utils/async/index.d.ts

@@ -0,0 +1,90 @@
+export interface RetryOptions {
+    maxAttempts?: number;
+    delay?: number;
+    backoff?: number;
+    maxDelay?: number;
+    shouldRetry?: (error: unknown, attempt: number) => boolean;
+    onRetry?: (error: unknown, attempt: number) => void;
+}
+export interface TimeoutOptions {
+    timeout: number;
+    message?: string;
+}
+export interface CircuitBreakerOptions {
+    failureThreshold?: number;
+    resetTimeout?: number;
+    onStateChange?: (state: CircuitState, error?: unknown) => void;
+}
+export type CircuitState = 'CLOSED' | 'OPEN' | 'HALF_OPEN';
+export type AsyncResult<T, E = Error> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: E;
+};
+export declare function asyncHandler<TArgs extends unknown[], TReturn>(fn: (...args: TArgs) => Promise<TReturn>): (...args: TArgs) => Promise<TReturn>;
+export declare function safeAsyncHandler<TArgs extends unknown[], TReturn>(fn: (...args: TArgs) => Promise<TReturn>): (...args: TArgs) => Promise<AsyncResult<TReturn>>;
+export declare function retry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+export declare function withTimeout<T>(promise: Promise<T>, options: TimeoutOptions): Promise<T>;
+export declare function sleep(ms: number): Promise<void>;
+export declare function debounce<TArgs extends unknown[]>(fn: (...args: TArgs) => void, delay: number): (...args: TArgs) => void;
+export declare function asyncDebounce<TArgs extends unknown[], TReturn>(fn: (...args: TArgs) => Promise<TReturn>, delay: number): (...args: TArgs) => Promise<TReturn>;
+export declare function throttle<TArgs extends unknown[]>(fn: (...args: TArgs) => void, limit: number): (...args: TArgs) => void;
+export declare function parallelLimit<T>(items: T[], fn: (item: T, index: number) => Promise<void>, limit: number): Promise<void>;
+export declare class CircuitBreaker<TArgs extends unknown[], TReturn> {
+    private fn;
+    private options;
+    private state;
+    private failures;
+    private lastFailureTime;
+    private successCount;
+    constructor(fn: (...args: TArgs) => Promise<TReturn>, options?: CircuitBreakerOptions);
+    execute(...args: TArgs): Promise<TReturn>;
+    getState(): CircuitState;
+    getFailures(): number;
+    reset(): void;
+}
+export declare function circuitBreaker<TArgs extends unknown[], TReturn>(fn: (...args: TArgs) => Promise<TReturn>, options?: CircuitBreakerOptions): CircuitBreaker<TArgs, TReturn>;
+export declare function batchProcess<T, R>(items: T[], processor: (batch: T[]) => Promise<R[]>, batchSize: number, options?: {
+    concurrency?: number;
+    onBatchComplete?: (batch: T[], results: R[]) => void;
+    onError?: (batch: T[], error: Error) => void;
+}): Promise<R[]>;
+export declare function measureTime<T>(operation: () => Promise<T>, label?: string): Promise<{
+    result: T;
+    duration: number;
+}>;
+export declare const asyncUtils: {
+    readonly promisify: <TArgs extends unknown[], TReturn>(fn: (...args: [...TArgs, (err: Error | null, result?: TReturn) => void]) => void) => (...args: TArgs) => Promise<TReturn>;
+    readonly raceToSuccess: <T>(promises: Promise<T>[]) => Promise<T>;
+    readonly cancellable: <T>(promise: Promise<T>) => {
+        promise: Promise<T>;
+        cancel: () => void;
+    };
+};
+declare const _default: {
+    asyncHandler: typeof asyncHandler;
+    safeAsyncHandler: typeof safeAsyncHandler;
+    retry: typeof retry;
+    withTimeout: typeof withTimeout;
+    sleep: typeof sleep;
+    debounce: typeof debounce;
+    asyncDebounce: typeof asyncDebounce;
+    throttle: typeof throttle;
+    parallelLimit: typeof parallelLimit;
+    circuitBreaker: typeof circuitBreaker;
+    batchProcess: typeof batchProcess;
+    measureTime: typeof measureTime;
+    asyncUtils: {
+        readonly promisify: <TArgs extends unknown[], TReturn>(fn: (...args: [...TArgs, (err: Error | null, result?: TReturn) => void]) => void) => (...args: TArgs) => Promise<TReturn>;
+        readonly raceToSuccess: <T>(promises: Promise<T>[]) => Promise<T>;
+        readonly cancellable: <T>(promise: Promise<T>) => {
+            promise: Promise<T>;
+            cancel: () => void;
+        };
+    };
+    CircuitBreaker: typeof CircuitBreaker;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/utils/async/index.d.ts.map

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

package/dist/src/utils/error-logger.d.ts

@@ -0,0 +1,34 @@
+export interface ErrorContext {
+    requestId?: string;
+    userId?: string;
+    operation?: string;
+    component?: string;
+    metadata?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export interface LoggedError {
+    message: string;
+    stack?: string;
+    code?: string;
+    timestamp: string;
+    context?: ErrorContext;
+}
+export declare class ErrorLogger {
+    private static instance;
+    static getInstance(): ErrorLogger;
+    logError(message: string, error?: Error | unknown, context?: ErrorContext): LoggedError;
+    logWarning(message: string, context?: ErrorContext): void;
+    logInfo(message: string, context?: ErrorContext): void;
+    forComponent(componentName: string): ComponentErrorLogger;
+}
+export declare class ComponentErrorLogger {
+    private readonly componentName;
+    private readonly errorLogger;
+    constructor(componentName: string, errorLogger: ErrorLogger);
+    logError(message: string, error?: Error | unknown, context?: Omit<ErrorContext, 'component'>): LoggedError;
+    logWarning(message: string, context?: Omit<ErrorContext, 'component'>): void;
+    logInfo(message: string, context?: Omit<ErrorContext, 'component'>): void;
+}
+export declare const errorLogger: ErrorLogger;
+export declare function logStructured(level: 'error' | 'warn' | 'info', message: string, error?: Error | unknown, context?: ErrorContext): void;
+//# sourceMappingURL=error-logger.d.ts.map

package/dist/src/utils/error-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-logger.d.ts","sourceRoot":"","sources":["../../../src/utils/error-logger.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB;AAKD,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAc;WAEvB,WAAW,IAAI,WAAW;IAUxC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,WAAW;IA2BvF,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI;IAOzD,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI;IAOtD,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,oBAAoB;CAG1D;AAKD,qBAAa,oBAAoB;IAE7B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,WAAW;gBADX,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,WAAW;IAG3C,QAAQ,CACN,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO,EACvB,OAAO,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,GACxC,WAAW;IAOd,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,GAAG,IAAI;IAO5E,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,GAAG,IAAI;CAM1E;AAGD,eAAO,MAAM,WAAW,aAA4B,CAAC;AAKrD,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,EAChC,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO,EACvB,OAAO,CAAC,EAAE,YAAY,GACrB,IAAI,CAYN"}

package/dist/src/utils/index.d.ts

@@ -0,0 +1,23 @@
+import * as asyncUtils from './async';
+import * as loggerUtils from './logger';
+import * as validationUtils from './validation';
+export * from './logger';
+export { getLogger, createLogger, info, error, warn, debug, child } from './logger';
+export * from './validation';
+export { CommonSchemas, validateWithSchema, validateAndTransform, createValidationMiddleware, validateTeamCityUrl, validateBuildConfigId, validateBranchName, validateBuildParameters, sanitizeString, createSanitizedStringSchema, optional, nullable, createEnumSchema, } from './validation';
+export type { ValidationResult } from './validation';
+export * from './async';
+export { asyncHandler, safeAsyncHandler, retry, withTimeout, sleep, debounce, asyncDebounce, throttle, parallelLimit, circuitBreaker, batchProcess, measureTime, asyncUtils, CircuitBreaker, } from './async';
+export type { RetryOptions, TimeoutOptions, CircuitBreakerOptions, CircuitState, AsyncResult, } from './async';
+export * from './error-logger';
+export * from './lru-cache';
+declare const warnLegacyImport: () => void;
+export { warnLegacyImport };
+export interface IUtilities {
+    logger: typeof loggerUtils;
+    validation: typeof validationUtils;
+    asyncUtils: typeof asyncUtils;
+}
+export declare const utilities: IUtilities;
+export default utilities;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,UAAU,MAAM,SAAS,CAAC;AACtC,OAAO,KAAK,WAAW,MAAM,UAAU,CAAC;AACxC,OAAO,KAAK,eAAe,MAAM,cAAc,CAAC;AAEhD,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAGpF,cAAc,cAAc,CAAC;AAC7B,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,0BAA0B,EAC1B,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,uBAAuB,EACvB,cAAc,EACd,2BAA2B,EAC3B,QAAQ,EACR,QAAQ,EACR,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGrD,cAAc,SAAS,CAAC;AACxB,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,KAAK,EACL,WAAW,EACX,KAAK,EACL,QAAQ,EACR,aAAa,EACb,QAAQ,EACR,aAAa,EACb,cAAc,EACd,YAAY,EACZ,WAAW,EACX,UAAU,EACV,cAAc,GACf,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,YAAY,EACZ,cAAc,EACd,qBAAqB,EACrB,YAAY,EACZ,WAAW,GACZ,MAAM,SAAS,CAAC;AAGjB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAG5B,QAAA,MAAM,gBAAgB,YAErB,CAAC;AAGF,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAG5B,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,OAAO,WAAW,CAAC;IAC3B,UAAU,EAAE,OAAO,eAAe,CAAC;IACnC,UAAU,EAAE,OAAO,UAAU,CAAC;CAC/B;AAGD,eAAO,MAAM,SAAS,EAAE,UAIvB,CAAC;AAGF,eAAe,SAAS,CAAC"}

package/dist/src/utils/logger/index.d.ts

@@ -0,0 +1,73 @@
+import { type Logger } from 'winston';
+export type LogLevel = 'error' | 'warn' | 'info' | 'verbose' | 'debug' | 'silly';
+export interface LogContext {
+    toolName?: string;
+    requestId?: string;
+    sessionId?: string;
+    userId?: string;
+    duration?: number;
+    service?: string;
+    buildId?: string;
+    projectId?: string;
+    [key: string]: unknown;
+}
+export interface LoggerConfig {
+    name?: string;
+    level?: LogLevel;
+    enableConsole?: boolean;
+    enableFile?: boolean;
+    logDirectory?: string;
+    maxFileSize?: string;
+    maxFiles?: number;
+}
+export interface ILogger {
+    debug(message: string, context?: LogContext): void;
+    info(message: string, context?: LogContext): void;
+    warn(message: string, context?: LogContext): void;
+    error(message: string, error?: Error | unknown, context?: LogContext): void;
+    child(context: LogContext): ILogger;
+}
+export declare class TeamCityLogger implements ILogger {
+    private winston;
+    private config;
+    private requestCounter;
+    constructor(config?: LoggerConfig);
+    private normalizeConfig;
+    private createWinstonLogger;
+    private formatContextualLog;
+    private ensureLogDirectory;
+    private parseFileSize;
+    generateRequestId(): string;
+    debug(message: string, context?: LogContext): void;
+    info(message: string, context?: LogContext): void;
+    warn(message: string, context?: LogContext): void;
+    error(message: string, error?: Error | unknown, context?: LogContext): void;
+    child(context: LogContext): ILogger;
+    logToolExecution(toolName: string, args: Record<string, unknown>, result: {
+        success: boolean;
+        error?: string;
+    }, duration: number, context?: LogContext): void;
+    logTeamCityRequest(method: string, url: string, status?: number, duration?: number, context?: LogContext): void;
+    logLifecycle(event: string, details?: Record<string, unknown>): void;
+    setLevel(level: LogLevel): void;
+    getLevel(): LogLevel;
+    getWinstonInstance(): Logger;
+}
+export declare function getLogger(config?: LoggerConfig): TeamCityLogger;
+export declare function createLogger(config?: LoggerConfig): TeamCityLogger;
+export declare const logger: {
+    debug: (message: string, context?: LogContext) => void;
+    info: (message: string, context?: LogContext) => void;
+    warn: (message: string, context?: LogContext) => void;
+    error: (message: string, error?: Error | unknown, context?: LogContext) => void;
+    child: (context: LogContext) => ILogger;
+    logToolExecution: (toolName: string, args: Record<string, unknown>, result: {
+        success: boolean;
+        error?: string;
+    }, duration: number, context?: LogContext) => void;
+    logTeamCityRequest: (method: string, url: string, status?: number, duration?: number, context?: LogContext) => void;
+    logLifecycle: (event: string, details?: Record<string, unknown>) => void;
+};
+export declare const createTeamCityLogger: typeof createLogger;
+export declare const getTeamCityLogger: typeof getLogger;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/utils/logger/index.d.ts.map

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

package/dist/src/utils/logger.d.ts

@@ -0,0 +1,11 @@
+import type { Logger } from 'winston';
+import { TeamCityLogger } from './logger/index';
+export type { TeamCityLogger };
+export declare function createLogger(name?: string): Logger;
+export declare function getLogger(): Logger;
+export declare function info(message: string, meta?: Record<string, unknown>): void;
+export declare function error(message: string, err?: Error | unknown, meta?: Record<string, unknown>): void;
+export declare function warn(message: string, meta?: Record<string, unknown>): void;
+export declare function debug(message: string, meta?: Record<string, unknown>): void;
+export declare function child(meta: Record<string, unknown>): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/src/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEtC,OAAO,EACL,cAAc,EAIf,MAAM,gBAAgB,CAAC;AAExB,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B,wBAAgB,YAAY,CAAC,IAAI,SAAiB,GAAG,MAAM,CAI1D;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAE1E;AAED,wBAAgB,KAAK,CACnB,OAAO,EAAE,MAAM,EACf,GAAG,CAAC,EAAE,KAAK,GAAG,OAAO,EACrB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,IAAI,CAEN;AAED,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAE1E;AAED,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAE3E;AAED,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAK3D"}

package/dist/src/utils/lru-cache.d.ts

@@ -0,0 +1,20 @@
+export interface LRUCacheOptions {
+    maxSize?: number;
+    ttl?: number;
+}
+export declare class LRUCache<T> {
+    private cache;
+    private maxSize;
+    private ttl;
+    constructor(options?: LRUCacheOptions);
+    get(key: string): T | null;
+    set(key: string, value: T): void;
+    has(key: string): boolean;
+    delete(key: string): boolean;
+    clear(): void;
+    size(): number;
+    keys(): IterableIterator<string>;
+    private isExpired;
+    evictExpired(): void;
+}
+//# sourceMappingURL=lru-cache.d.ts.map

package/dist/src/utils/lru-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lru-cache.d.ts","sourceRoot":"","sources":["../../../src/utils/lru-cache.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,QAAQ,CAAC,CAAC;IACrB,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,GAAG,CAAS;gBAER,OAAO,GAAE,eAAoB;IAMzC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAoB1B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAqBhC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAczB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,MAAM;IAId,IAAI,IAAI,gBAAgB,CAAC,MAAM,CAAC;IAIhC,OAAO,CAAC,SAAS;IAKjB,YAAY,IAAI,IAAI;CAOrB"}

package/dist/src/utils/mcp.d.ts

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+export interface ToolResponse {
+    content?: Array<{
+        type: string;
+        text: string;
+    }>;
+    error?: string;
+    success?: boolean;
+    data?: unknown;
+}
+export declare function text(content: string): ToolResponse;
+export declare function json(data: unknown): ToolResponse;
+export declare function errorText(message: string): ToolResponse;
+export declare function runTool<T>(toolName: string, schema: z.ZodSchema<T> | null, handler: (args: T) => Promise<ToolResponse>, rawArgs: unknown, context?: {
+    requestId?: string;
+    userId?: string;
+}): Promise<ToolResponse>;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/src/utils/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../../src/utils/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAGD,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAElD;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,YAAY,CAEhD;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAEvD;AAGD,wBAAsB,OAAO,CAAC,CAAC,EAC7B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,EAC7B,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,YAAY,CAAC,EAC3C,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAChD,OAAO,CAAC,YAAY,CAAC,CAiDvB"}

package/dist/src/utils/validation.d.ts

@@ -0,0 +1,61 @@
+import { z } from 'zod';
+import { MCPValidationError } from '../middleware/error';
+export declare const CommonSchemas: {
+    teamCityUrl: z.ZodEffects<z.ZodString, string, string>;
+    buildConfigId: z.ZodString;
+    branchName: z.ZodEffects<z.ZodString, string, string>;
+    buildParameters: z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>;
+    pagination: z.ZodObject<{
+        limit: z.ZodDefault<z.ZodNumber>;
+        offset: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        limit: number;
+        offset: number;
+    }, {
+        limit?: number | undefined;
+        offset?: number | undefined;
+    }>;
+    dateRange: z.ZodEffects<z.ZodObject<{
+        from: z.ZodOptional<z.ZodString>;
+        to: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        from?: string | undefined;
+        to?: string | undefined;
+    }, {
+        from?: string | undefined;
+        to?: string | undefined;
+    }>, {
+        from?: string | undefined;
+        to?: string | undefined;
+    }, {
+        from?: string | undefined;
+        to?: string | undefined;
+    }>;
+};
+export interface ValidationResult<T> {
+    success: boolean;
+    data?: T;
+    error?: MCPValidationError;
+}
+export declare function validateWithSchema<T>(data: unknown, schema: z.ZodSchema<T>, context?: {
+    operation?: string;
+    field?: string;
+}): ValidationResult<T>;
+export declare function validateAndTransform<T>(data: unknown, schema: z.ZodSchema<T>, context?: {
+    operation?: string;
+    field?: string;
+}): T;
+export declare function createValidationMiddleware<T>(schema: z.ZodSchema<T>): (data: unknown, toolName: string) => T;
+export declare const validateTeamCityUrl: (url: string) => boolean;
+export declare const validateBuildConfigId: (id: string) => boolean;
+export declare const validateBranchName: (branch: string) => boolean;
+export declare const validateBuildParameters: (params: Record<string, unknown>) => {
+    valid: boolean;
+    errors: string[];
+};
+export declare const sanitizeString: (input: string, maxLength?: number) => string;
+export declare const createSanitizedStringSchema: (maxLength?: number) => z.ZodEffects<z.ZodString, string, string>;
+export declare const optional: <T>(schema: z.ZodSchema<T>) => z.ZodOptional<z.ZodType<T, z.ZodTypeDef, T>>;
+export declare const nullable: <T>(schema: z.ZodSchema<T>) => z.ZodNullable<z.ZodType<T, z.ZodTypeDef, T>>;
+export declare const createEnumSchema: <T extends string>(values: readonly T[]) => z.ZodEnum<[T, ...T[]]>;
+//# sourceMappingURL=validation.d.ts.map

package/dist/src/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/utils/validation.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAMxD,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsFzB,CAAC;AAKF,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,kBAAkB,CAAC;CAC5B;AAKD,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EACtB,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/C,gBAAgB,CAAC,CAAC,CAAC,CA+BrB;AAKD,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EACtB,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/C,CAAC,CAQH;AAKD,wBAAgB,0BAA0B,CAAC,CAAC,EAC1C,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GACrB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC,CAOxC;AAUD,eAAO,MAAM,mBAAmB,GAAI,KAAK,MAAM,KAAG,OAKjD,CAAC;AAMF,eAAO,MAAM,qBAAqB,GAAI,IAAI,MAAM,KAAG,OAKlD,CAAC;AAMF,eAAO,MAAM,kBAAkB,GAAI,QAAQ,MAAM,KAAG,OAKnD,CAAC;AAMF,eAAO,MAAM,uBAAuB,GAClC,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAYpC,CAAC;AAKF,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,EAAE,kBAAe,KAAG,MAe/D,CAAC;AAKF,eAAO,MAAM,2BAA2B,GAAI,kBAAe,8CAE1D,CAAC;AAKF,eAAO,MAAM,QAAQ,GAAI,CAAC,EAAE,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,iDAEjD,CAAC;AAKF,eAAO,MAAM,QAAQ,GAAI,CAAC,EAAE,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,iDAEjD,CAAC;AAKF,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,MAAM,EAAE,QAAQ,SAAS,CAAC,EAAE,2BAEtE,CAAC"}