@juspay/yama 1.0.0

package/dist/types/index.d.ts

@@ -0,0 +1,419 @@
+/**
+ * Core TypeScript types for Yama
+ * Consolidates all interfaces and types used across the application
+ */
+export interface AIProviderConfig {
+    provider?: "auto" | "google-ai" | "openai" | "anthropic" | "azure" | "bedrock";
+    model?: string;
+    enableFallback?: boolean;
+    enableAnalytics?: boolean;
+    enableEvaluation?: boolean;
+    timeout?: string | number;
+    temperature?: number;
+    maxTokens?: number;
+    retryAttempts?: number;
+}
+export interface AIResponse {
+    content: string;
+    provider: string;
+    model?: string;
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+        totalTokens: number;
+    };
+    responseTime?: number;
+    analytics?: AnalyticsData;
+    evaluation?: EvaluationData;
+}
+export interface AnalyticsData {
+    requestId: string;
+    timestamp: string;
+    provider: string;
+    model: string;
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+    responseTime: number;
+    cost?: number;
+}
+export interface EvaluationData {
+    overallScore: number;
+    qualityMetrics: {
+        relevance: number;
+        accuracy: number;
+        completeness: number;
+        clarity: number;
+    };
+    confidence: number;
+}
+export type GitPlatform = "bitbucket" | "github" | "gitlab" | "azure-devops";
+export interface GitCredentials {
+    username: string;
+    token: string;
+    baseUrl?: string;
+}
+export interface GitProviderConfig {
+    platform: GitPlatform;
+    credentials: GitCredentials;
+    defaultWorkspace?: string;
+}
+export interface PRIdentifier {
+    workspace: string;
+    repository: string;
+    branch?: string;
+    pullRequestId?: number | string;
+}
+export interface PRInfo {
+    id: number | string;
+    title: string;
+    description: string;
+    author: string;
+    state: "OPEN" | "MERGED" | "DECLINED" | "CLOSED";
+    sourceRef: string;
+    targetRef: string;
+    createdDate: string;
+    updatedDate: string;
+    reviewers?: PRReviewer[];
+    comments?: PRComment[];
+    fileChanges?: string[];
+}
+export interface PRReviewer {
+    user: {
+        name: string;
+        emailAddress: string;
+        displayName: string;
+    };
+    approved: boolean;
+    status: "APPROVED" | "UNAPPROVED" | "NEEDS_WORK";
+}
+export interface PRComment {
+    id: number;
+    text: string;
+    author: {
+        name: string;
+        displayName: string;
+    };
+    createdDate: string;
+    updatedDate: string;
+    anchor?: {
+        filePath: string;
+        lineFrom: number;
+        lineTo: number;
+        lineType: "ADDED" | "REMOVED" | "CONTEXT";
+    };
+}
+export interface PRDiff {
+    diff: string;
+    fileChanges: FileChange[];
+    totalAdditions: number;
+    totalDeletions: number;
+}
+export interface FileChange {
+    path: string;
+    changeType: "ADDED" | "MODIFIED" | "DELETED" | "RENAMED";
+    additions: number;
+    deletions: number;
+    hunks: DiffHunk[];
+}
+export interface DiffHunk {
+    oldStart: number;
+    oldLines: number;
+    newStart: number;
+    newLines: number;
+    lines: DiffLine[];
+}
+export interface DiffLine {
+    type: "added" | "removed" | "context";
+    content: string;
+    oldLineNumber?: number;
+    newLineNumber?: number;
+}
+export type ViolationSeverity = "CRITICAL" | "MAJOR" | "MINOR" | "SUGGESTION";
+export type ViolationType = "inline" | "general";
+export type ViolationCategory = "security" | "performance" | "maintainability" | "functionality" | "error_handling" | "testing" | "general";
+export interface Violation {
+    type: ViolationType;
+    file?: string;
+    code_snippet?: string;
+    search_context?: {
+        before: string[];
+        after: string[];
+    };
+    line_type?: "ADDED" | "REMOVED" | "CONTEXT";
+    severity: ViolationSeverity;
+    category: ViolationCategory;
+    issue: string;
+    message: string;
+    impact: string;
+    suggestion?: string;
+}
+export interface ReviewResult {
+    violations: Violation[];
+    summary: string;
+    improvementsSinceLast?: string;
+    positiveObservations: string[];
+    statistics: ReviewStatistics;
+}
+export interface ReviewStatistics {
+    filesReviewed: number;
+    totalIssues: number;
+    criticalCount: number;
+    majorCount: number;
+    minorCount: number;
+    suggestionCount: number;
+}
+export interface ReviewOptions {
+    workspace: string;
+    repository: string;
+    branch?: string;
+    pullRequestId?: number | string;
+    dryRun?: boolean;
+    verbose?: boolean;
+    excludePatterns?: string[];
+    customRules?: string;
+    contextLines?: number;
+}
+export interface RequiredSection {
+    key: string;
+    name: string;
+    required: boolean;
+    present?: boolean;
+    content?: string;
+}
+export interface PreservableContent {
+    media: string[];
+    files: string[];
+    links: string[];
+    originalText: string;
+}
+export interface SectionAnalysis {
+    requiredSections: RequiredSection[];
+    missingCount: number;
+    preservedContent: PreservableContent;
+    gaps: string[];
+}
+export interface EnhancementOptions {
+    workspace: string;
+    repository: string;
+    branch?: string;
+    pullRequestId?: number | string;
+    dryRun?: boolean;
+    verbose?: boolean;
+    preserveContent?: boolean;
+    ensureRequiredSections?: boolean;
+    customSections?: RequiredSection[];
+}
+export interface EnhancementResult {
+    originalDescription: string;
+    enhancedDescription: string;
+    sectionsAdded: string[];
+    sectionsEnhanced: string[];
+    preservedItems: {
+        media: number;
+        files: number;
+        links: number;
+    };
+    statistics: {
+        originalLength: number;
+        enhancedLength: number;
+        completedSections: number;
+        totalSections: number;
+    };
+}
+export interface GuardianConfig {
+    providers: {
+        ai: AIProviderConfig;
+        git: GitProviderConfig;
+    };
+    features: {
+        codeReview: CodeReviewConfig;
+        descriptionEnhancement: DescriptionEnhancementConfig;
+        diffStrategy?: DiffStrategyConfig;
+        securityScan?: SecurityScanConfig;
+        analytics?: AnalyticsConfig;
+    };
+    cache?: CacheConfig;
+    performance?: PerformanceConfig;
+    rules?: CustomRulesConfig;
+    reporting?: ReportingConfig;
+    monitoring?: MonitoringConfig;
+}
+export interface CodeReviewConfig {
+    enabled: boolean;
+    severityLevels: ViolationSeverity[];
+    categories: ViolationCategory[];
+    excludePatterns: string[];
+    contextLines: number;
+    customRules?: string;
+    systemPrompt?: string;
+    analysisTemplate?: string;
+    focusAreas?: string[];
+}
+export interface DescriptionEnhancementConfig {
+    enabled: boolean;
+    preserveContent: boolean;
+    requiredSections: RequiredSection[];
+    autoFormat: boolean;
+    systemPrompt?: string;
+    outputTemplate?: string;
+    enhancementInstructions?: string;
+}
+export interface DiffStrategyConfig {
+    enabled: boolean;
+    thresholds: {
+        wholeDiffMaxFiles: number;
+        fileByFileMinFiles: number;
+    };
+    forceStrategy?: "whole" | "file-by-file" | "auto";
+}
+export interface SecurityScanConfig {
+    enabled: boolean;
+    level: "strict" | "moderate" | "basic";
+    scanTypes: string[];
+}
+export interface AnalyticsConfig {
+    enabled: boolean;
+    trackMetrics: boolean;
+    exportFormat: "json" | "csv" | "yaml";
+}
+export interface CacheConfig {
+    enabled: boolean;
+    ttl: string;
+    maxSize: string;
+    storage: "memory" | "redis" | "file";
+}
+export interface PerformanceConfig {
+    batch: {
+        enabled: boolean;
+        maxConcurrent: number;
+        delayBetween: string;
+    };
+    optimization: {
+        reuseConnections: boolean;
+        compressRequests: boolean;
+        enableHttp2: boolean;
+    };
+}
+export interface CustomRulesConfig {
+    [category: string]: CustomRule[];
+}
+export interface CustomRule {
+    name: string;
+    pattern: string;
+    severity: ViolationSeverity;
+    message?: string;
+    suggestion?: string;
+}
+export interface ReportingConfig {
+    formats: string[];
+    includeAnalytics: boolean;
+    includeMetrics: boolean;
+    customTemplates?: string;
+}
+export interface MonitoringConfig {
+    enabled: boolean;
+    metrics: string[];
+    exportFormat?: "json" | "prometheus" | "csv";
+    endpoint?: string;
+    interval?: string;
+}
+export type OperationType = "review" | "enhance-description" | "security-scan" | "analytics" | "all";
+export interface OperationOptions {
+    workspace: string;
+    repository: string;
+    branch?: string;
+    pullRequestId?: number | string;
+    operations: OperationType[];
+    dryRun?: boolean;
+    verbose?: boolean;
+    config?: Partial<GuardianConfig>;
+}
+export interface OperationResult {
+    operation: OperationType;
+    status: "success" | "error" | "skipped";
+    data?: any;
+    error?: string;
+    duration: number;
+    timestamp: string;
+}
+export interface ProcessResult {
+    pullRequest: PRInfo;
+    operations: OperationResult[];
+    summary: {
+        totalOperations: number;
+        successCount: number;
+        errorCount: number;
+        skippedCount: number;
+        totalDuration: number;
+    };
+}
+export interface StreamUpdate {
+    operation: OperationType;
+    status: "started" | "progress" | "completed" | "error";
+    progress?: number;
+    message?: string;
+    data?: any;
+    timestamp: string;
+}
+export interface StreamOptions {
+    onUpdate?: (update: StreamUpdate) => void;
+    onError?: (error: Error) => void;
+    onComplete?: (result: ProcessResult) => void;
+}
+export type LogLevel = "debug" | "info" | "warn" | "error";
+export interface LoggerOptions {
+    level: LogLevel;
+    verbose: boolean;
+    format: "simple" | "json" | "detailed";
+    colors: boolean;
+}
+export interface Logger {
+    debug(message: string, ...args: any[]): void;
+    info(message: string, ...args: any[]): void;
+    warn(message: string, ...args: any[]): void;
+    error(message: string, ...args: any[]): void;
+    badge(): void;
+    phase(message: string): void;
+    success(message: string): void;
+}
+export interface CacheEntry<T = any> {
+    key: string;
+    value: T;
+    ttl: number;
+    createdAt: number;
+}
+export interface CacheOptions {
+    ttl?: number;
+    maxSize?: number;
+    checkPeriod?: number;
+}
+export interface Cache {
+    get<T>(key: string): T | undefined;
+    set<T>(key: string, value: T, ttl?: number): boolean;
+    del(key: string): number;
+    has(key: string): boolean;
+    clear(): void;
+    keys(): string[];
+    stats(): {
+        hits: number;
+        misses: number;
+        keys: number;
+        size: number;
+    };
+}
+export declare class GuardianError extends Error {
+    code: string;
+    context?: any | undefined;
+    constructor(code: string, message: string, context?: any | undefined);
+}
+export declare class ConfigurationError extends GuardianError {
+    constructor(message: string, context?: any);
+}
+export declare class ProviderError extends GuardianError {
+    constructor(message: string, context?: any);
+}
+export declare class ValidationError extends GuardianError {
+    constructor(message: string, context?: any);
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.js

@@ -0,0 +1,44 @@
+"use strict";
+/**
+ * Core TypeScript types for Yama
+ * Consolidates all interfaces and types used across the application
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValidationError = exports.ProviderError = exports.ConfigurationError = exports.GuardianError = void 0;
+// ============================================================================
+// Error Types
+// ============================================================================
+class GuardianError extends Error {
+    constructor(code, message, context) {
+        super(message);
+        this.code = code;
+        this.context = context;
+        this.name = "GuardianError";
+    }
+}
+exports.GuardianError = GuardianError;
+class ConfigurationError extends GuardianError {
+    constructor(message, context) {
+        super("CONFIGURATION_ERROR", message, context);
+        this.name = "ConfigurationError";
+    }
+}
+exports.ConfigurationError = ConfigurationError;
+class ProviderError extends GuardianError {
+    constructor(message, context) {
+        super("PROVIDER_ERROR", message, context);
+        this.name = "ProviderError";
+    }
+}
+exports.ProviderError = ProviderError;
+class ValidationError extends GuardianError {
+    constructor(message, context) {
+        super("VALIDATION_ERROR", message, context);
+        this.name = "ValidationError";
+    }
+}
+exports.ValidationError = ValidationError;
+// ============================================================================
+// Export all types - Main file, no re-exports needed
+// ============================================================================
+//# sourceMappingURL=index.js.map

package/dist/utils/Cache.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Enhanced Cache utility for Yama
+ * Provides intelligent caching for PR data, file contents, and AI responses
+ */
+import { Cache as ICache, CacheOptions } from "../types";
+export declare class Cache implements ICache {
+    private cache;
+    private statsData;
+    constructor(options?: CacheOptions);
+    /**
+     * Get value from cache
+     */
+    get<T>(key: string): T | undefined;
+    /**
+     * Set value in cache with optional TTL
+     */
+    set<T>(key: string, value: T, ttl?: number): boolean;
+    /**
+     * Delete key from cache
+     */
+    del(key: string): number;
+    /**
+     * Check if key exists in cache
+     */
+    has(key: string): boolean;
+    /**
+     * Clear all cache entries
+     */
+    clear(): void;
+    /**
+     * Get all cache keys
+     */
+    keys(): string[];
+    /**
+     * Get cache statistics
+     */
+    stats(): {
+        hits: number;
+        misses: number;
+        keys: number;
+        size: number;
+    };
+    /**
+     * Get detailed cache statistics from node-cache
+     */
+    getDetailedStats(): any;
+    /**
+     * Get or set pattern - common caching pattern
+     */
+    getOrSet<T>(key: string, fetchFn: () => Promise<T>, ttl?: number): Promise<T>;
+    /**
+     * Cache with tags for group invalidation
+     */
+    private tags;
+    setWithTags<T>(key: string, value: T, tags: string[], ttl?: number): boolean;
+    /**
+     * Invalidate all keys with a specific tag
+     */
+    invalidateTag(tag: string): number;
+    /**
+     * Cache key generators for common patterns
+     */
+    static keys: {
+        prInfo: (workspace: string, repository: string, prId: string | number) => string;
+        prDiff: (workspace: string, repository: string, prId: string | number) => string;
+        fileContent: (workspace: string, repository: string, filePath: string, branch: string) => string;
+        directoryContent: (workspace: string, repository: string, path: string, branch: string) => string;
+        branchInfo: (workspace: string, repository: string, branch: string) => string;
+        aiResponse: (prompt: string, provider: string, model: string) => string;
+        projectContext: (workspace: string, repository: string, branch: string) => string;
+        reviewResult: (workspace: string, repository: string, prId: string | number, configHash: string) => string;
+    };
+    /**
+     * Smart cache warming for common patterns
+     */
+    warmPRCache(workspace: string, repository: string, prId: string | number): Promise<void>;
+    /**
+     * Cleanup expired entries and optimize memory
+     */
+    cleanup(): void;
+    /**
+     * Get cache hit ratio
+     */
+    getHitRatio(): number;
+    /**
+     * Export cache state for debugging
+     */
+    debug(): any;
+}
+export declare const cache: Cache;
+export declare function createCache(options?: CacheOptions): Cache;
+//# sourceMappingURL=Cache.d.ts.map