@unispechq/unispec-core 0.3.2 → 0.3.4

package/dist/src/diff/risk-calculator.js

@@ -1,55 +0,0 @@
-/**
- * Calculator for determining risk levels based on change impact.
- */
-export const RiskLevelCalculator = {
-    /**
-     * Calculate risk level based on impact.
-     */
-    calculate(impact) {
-        // Critical: Breaking changes with high client impact
-        if (impact.backwardCompatibility === "incompatible" &&
-            impact.clientImpact === "high") {
-            return "critical";
-        }
-        // High: Any breaking change
-        if (impact.backwardCompatibility === "incompatible") {
-            return "high";
-        }
-        // Medium: Medium impact on client or server
-        if (impact.clientImpact === "medium" || impact.serverImpact === "medium") {
-            return "medium";
-        }
-        // Low: Everything else
-        return "low";
-    },
-    /**
-     * Get risk level weight for sorting.
-     */
-    getWeight(riskLevel) {
-        const weights = {
-            critical: 4,
-            high: 3,
-            medium: 2,
-            low: 1,
-        };
-        return weights[riskLevel];
-    },
-    /**
-     * Check if risk level requires immediate attention.
-     */
-    requiresImmediateAttention(riskLevel) {
-        return riskLevel === "critical" || riskLevel === "high";
-    },
-    /**
-     * Get risk level description.
-     */
-    getDescription(riskLevel) {
-        const descriptions = {
-            critical: "Critical breaking change requiring immediate action",
-            high: "Breaking change that requires attention",
-            medium: "Moderate change with some impact",
-            low: "Minor change with minimal impact",
-        };
-        return descriptions[riskLevel];
-    },
-};

package/dist/src/diff/suggestion-generator.d.ts

@@ -1,18 +0,0 @@
-import type { ChangeImpact } from "./enhanced-diff.js";
-import type { UniSpecChange } from "./index.js";
-/**
- * Service for generating migration suggestions based on change impact.
- */
-export declare class SuggestionGeneratorService {
-    /**
-     * Generate migration suggestions based on change impact.
-     */
-    generateSuggestions(change: UniSpecChange, impact: ChangeImpact): string[];
-    private addBreakingChangeSuggestions;
-    private addRestBreakingSuggestions;
-    private addGraphQLBreakingSuggestions;
-    private addWebSocketBreakingSuggestions;
-    private addClientImpactSuggestions;
-    private addServerImpactSuggestions;
-    private addMigrationComplexitySuggestions;
-}

package/dist/src/diff/suggestion-generator.js

@@ -1,74 +0,0 @@
-/**
- * Service for generating migration suggestions based on change impact.
- */
-export class SuggestionGeneratorService {
-    /**
-     * Generate migration suggestions based on change impact.
-     */
-    generateSuggestions(change, impact) {
-        const suggestions = [];
-        this.addBreakingChangeSuggestions(suggestions, change, impact);
-        this.addClientImpactSuggestions(suggestions, impact);
-        this.addServerImpactSuggestions(suggestions, impact);
-        this.addMigrationComplexitySuggestions(suggestions, impact);
-        return suggestions;
-    }
-    addBreakingChangeSuggestions(suggestions, change, impact) {
-        if (impact.backwardCompatibility !== "incompatible")
-            return;
-        suggestions.push("This is a breaking change that requires client updates");
-        if (change.protocol === "rest") {
-            this.addRestBreakingSuggestions(suggestions, change);
-        }
-        else if (change.protocol === "graphql") {
-            this.addGraphQLBreakingSuggestions(suggestions, change);
-        }
-        else if (change.protocol === "websocket") {
-            this.addWebSocketBreakingSuggestions(suggestions, change);
-        }
-    }
-    addRestBreakingSuggestions(suggestions, change) {
-        if (change.kind?.includes("route.removed")) {
-            suggestions.push("Consider deprecating the route before removal");
-            suggestions.push("Provide alternative endpoint if functionality is still needed");
-        }
-        if (change.path.includes("/path")) {
-            suggestions.push("Maintain backward compatibility by supporting old path");
-            suggestions.push("Document migration path for clients");
-        }
-    }
-    addGraphQLBreakingSuggestions(suggestions, change) {
-        if (change.kind?.includes("operation.removed")) {
-            suggestions.push("Mark operation as @deprecated before removal");
-            suggestions.push("Provide alternative query/mutation if possible");
-        }
-        if (change.path.includes("/returnType")) {
-            suggestions.push("Consider adding new field instead of changing return type");
-            suggestions.push("Use union types for multiple possible return types");
-        }
-    }
-    addWebSocketBreakingSuggestions(suggestions, change) {
-        if (change.kind?.includes("channel.removed")) {
-            suggestions.push("Notify clients before closing channel");
-            suggestions.push("Provide grace period for migration");
-        }
-    }
-    addClientImpactSuggestions(suggestions, impact) {
-        if (impact.clientImpact === "high") {
-            suggestions.push("Client code changes are required");
-            suggestions.push("Update client documentation");
-        }
-    }
-    addServerImpactSuggestions(suggestions, impact) {
-        if (impact.serverImpact === "medium" || impact.serverImpact === "high") {
-            suggestions.push("Server implementation changes required");
-            suggestions.push("Update server-side documentation");
-        }
-    }
-    addMigrationComplexitySuggestions(suggestions, impact) {
-        if (impact.migrationComplexity === "complex") {
-            suggestions.push("Plan migration in phases");
-            suggestions.push("Consider feature flags for gradual rollout");
-        }
-    }
-}

package/dist/src/diff/types.d.ts

@@ -1,24 +0,0 @@
-export type ChangeSeverity = "breaking" | "non-breaking" | "unknown";
-export interface UniSpecChange {
-    path: string;
-    description: string;
-    severity: ChangeSeverity;
-    protocol?: "rest" | "graphql" | "websocket";
-    kind?: string;
-}
-export interface DiffResult {
-    changes: UniSpecChange[];
-}
-export interface DiffOptions {
-    /**
-     * Custom paths for named collections that should be compared by name instead of index.
-     * Defaults to standard UniSpec paths if not provided.
-     */
-    namedCollectionPaths?: string[];
-    /**
-     * Whether to enable deep comparison of nested objects.
-     * @default true
-     */
-    deepComparison?: boolean;
-}
-export declare const DEFAULT_NAMED_COLLECTION_PATHS: readonly ["/service/protocols/rest/routes", "/service/protocols/websocket/channels", "/service/protocols/graphql/queries", "/service/protocols/graphql/mutations", "/service/protocols/graphql/subscriptions"];

package/dist/src/diff/types.js

@@ -1,8 +0,0 @@
-// Default named collection paths for UniSpec
-export const DEFAULT_NAMED_COLLECTION_PATHS = [
-    "/service/protocols/rest/routes",
-    "/service/protocols/websocket/channels",
-    "/service/protocols/graphql/queries",
-    "/service/protocols/graphql/mutations",
-    "/service/protocols/graphql/subscriptions",
-];

package/dist/src/errors/base-error.d.ts

@@ -1,20 +0,0 @@
-/**
- * Base validation error class for UniSpec validation.
- * Provides better error context and handling.
- */
-export declare class UniSpecValidationError extends Error {
-    readonly code: string;
-    readonly path: string;
-    readonly severity: "error" | "warning" | "info";
-    readonly details?: Record<string, unknown>;
-    constructor(message: string, code: string, path?: string, severity?: "error" | "warning" | "info", details?: Record<string, unknown>);
-    toJSON(): {
-        name: string;
-        message: string;
-        code: string;
-        path: string;
-        severity: "info" | "error" | "warning";
-        details: Record<string, unknown> | undefined;
-        stack: string | undefined;
-    };
-}

package/dist/src/errors/base-error.js

@@ -1,29 +0,0 @@
-/**
- * Base validation error class for UniSpec validation.
- * Provides better error context and handling.
- */
-export class UniSpecValidationError extends Error {
-    constructor(message, code, path = "", severity = "error", details) {
-        super(message);
-        this.name = "UniSpecValidationError";
-        this.code = code;
-        this.path = path;
-        this.severity = severity;
-        this.details = details;
-        // Maintains proper stack trace for where our error was thrown (only available on V8)
-        if (Error.captureStackTrace) {
-            Error.captureStackTrace(this, UniSpecValidationError);
-        }
-    }
-    toJSON() {
-        return {
-            name: this.name,
-            message: this.message,
-            code: this.code,
-            path: this.path,
-            severity: this.severity,
-            details: this.details,
-            stack: this.stack,
-        };
-    }
-}

package/dist/src/errors/config-error.d.ts

@@ -1,4 +0,0 @@
-import { UniSpecValidationError } from "./base-error.js";
-export declare class UniSpecConfigError extends UniSpecValidationError {
-    constructor(message: string, path?: string, details?: Record<string, unknown>);
-}

package/dist/src/errors/config-error.js

@@ -1,7 +0,0 @@
-import { UniSpecValidationError } from "./base-error.js";
-export class UniSpecConfigError extends UniSpecValidationError {
-    constructor(message, path = "", details) {
-        super(message, "config_error", path, "error", details);
-        this.name = "UniSpecConfigError";
-    }
-}

package/dist/src/errors/error-factory.d.ts

@@ -1,22 +0,0 @@
-import { UniSpecValidationError } from "./base-error.js";
-import { UniSpecConfigError } from "./config-error.js";
-import { UniSpecLoaderError } from "./loader-error.js";
-import { UniSpecReferenceError } from "./reference-error.js";
-import { UniSpecSchemaError } from "./schema-error.js";
-import { UniSpecSecurityError } from "./security-error.js";
-import { UniSpecSemanticError } from "./semantic-error.js";
-/**
- * Error factory for creating specific error types.
- */
-export declare const ErrorFactory: {
-    createSchemaError(message: string, path?: string, details?: Record<string, unknown>): UniSpecSchemaError;
-    createSemanticError(message: string, path?: string, details?: Record<string, unknown>): UniSpecSemanticError;
-    createReferenceError(message: string, path?: string, details?: Record<string, unknown>): UniSpecReferenceError;
-    createConfigError(message: string, path?: string, details?: Record<string, unknown>): UniSpecConfigError;
-    createSecurityError(message: string, path?: string, details?: Record<string, unknown>): UniSpecSecurityError;
-    createLoaderError(message: string, path?: string, details?: Record<string, unknown>): UniSpecLoaderError;
-    /**
-     * Convert generic error to UniSpecValidationError
-     */
-    fromError(error: unknown, defaultCode?: string): UniSpecValidationError;
-};

package/dist/src/errors/error-factory.js

@@ -1,45 +0,0 @@
-import { UniSpecValidationError } from "./base-error.js";
-import { UniSpecConfigError } from "./config-error.js";
-import { UniSpecLoaderError } from "./loader-error.js";
-import { UniSpecReferenceError } from "./reference-error.js";
-import { UniSpecSchemaError } from "./schema-error.js";
-import { UniSpecSecurityError } from "./security-error.js";
-import { UniSpecSemanticError } from "./semantic-error.js";
-/**
- * Error factory for creating specific error types.
- */
-export const ErrorFactory = {
-    createSchemaError(message, path, details) {
-        return new UniSpecSchemaError(message, path, details);
-    },
-    createSemanticError(message, path, details) {
-        return new UniSpecSemanticError(message, path, details);
-    },
-    createReferenceError(message, path, details) {
-        return new UniSpecReferenceError(message, path, details);
-    },
-    createConfigError(message, path, details) {
-        return new UniSpecConfigError(message, path, details);
-    },
-    createSecurityError(message, path, details) {
-        return new UniSpecSecurityError(message, path, details);
-    },
-    createLoaderError(message, path, details) {
-        return new UniSpecLoaderError(message, path, details);
-    },
-    /**
-     * Convert generic error to UniSpecValidationError
-     */
-    fromError(error, defaultCode = "validation_error") {
-        if (error instanceof UniSpecValidationError) {
-            return error;
-        }
-        if (error instanceof Error) {
-            return new UniSpecValidationError(error.message, defaultCode, "", "error", { originalError: error.name, stack: error.stack });
-        }
-        if (typeof error === "string") {
-            return new UniSpecValidationError(error, defaultCode);
-        }
-        return new UniSpecValidationError(`Unknown validation error: ${String(error)}`, defaultCode, "", "error", { originalError: error });
-    },
-};

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

@@ -1,8 +0,0 @@
-export { UniSpecValidationError } from "./base-error.js";
-export { UniSpecConfigError } from "./config-error.js";
-export { ErrorFactory } from "./error-factory.js";
-export { UniSpecLoaderError } from "./loader-error.js";
-export { UniSpecReferenceError } from "./reference-error.js";
-export { UniSpecSchemaError } from "./schema-error.js";
-export { UniSpecSecurityError } from "./security-error.js";
-export { UniSpecSemanticError } from "./semantic-error.js";

package/dist/src/errors/index.js

@@ -1,8 +0,0 @@
-export { UniSpecValidationError } from "./base-error.js";
-export { UniSpecConfigError } from "./config-error.js";
-export { ErrorFactory } from "./error-factory.js";
-export { UniSpecLoaderError } from "./loader-error.js";
-export { UniSpecReferenceError } from "./reference-error.js";
-export { UniSpecSchemaError } from "./schema-error.js";
-export { UniSpecSecurityError } from "./security-error.js";
-export { UniSpecSemanticError } from "./semantic-error.js";

package/dist/src/errors/loader-error.d.ts

@@ -1,4 +0,0 @@
-import { UniSpecValidationError } from "./base-error.js";
-export declare class UniSpecLoaderError extends UniSpecValidationError {
-    constructor(message: string, path?: string, details?: Record<string, unknown>);
-}

package/dist/src/errors/loader-error.js

@@ -1,7 +0,0 @@
-import { UniSpecValidationError } from "./base-error.js";
-export class UniSpecLoaderError extends UniSpecValidationError {
-    constructor(message, path = "", details) {
-        super(message, "loader_error", path, "error", details);
-        this.name = "UniSpecLoaderError";
-    }
-}

package/dist/src/errors/reference-error.d.ts

@@ -1,4 +0,0 @@
-import { UniSpecValidationError } from "./base-error.js";
-export declare class UniSpecReferenceError extends UniSpecValidationError {
-    constructor(message: string, path?: string, details?: Record<string, unknown>);
-}

package/dist/src/errors/reference-error.js

@@ -1,7 +0,0 @@
-import { UniSpecValidationError } from "./base-error.js";
-export class UniSpecReferenceError extends UniSpecValidationError {
-    constructor(message, path = "", details) {
-        super(message, "reference_error", path, "error", details);
-        this.name = "UniSpecReferenceError";
-    }
-}

package/dist/src/errors/schema-error.d.ts

@@ -1,4 +0,0 @@
-import { UniSpecValidationError } from "./base-error.js";
-export declare class UniSpecSchemaError extends UniSpecValidationError {
-    constructor(message: string, path?: string, details?: Record<string, unknown>);
-}

package/dist/src/errors/schema-error.js

@@ -1,7 +0,0 @@
-import { UniSpecValidationError } from "./base-error.js";
-export class UniSpecSchemaError extends UniSpecValidationError {
-    constructor(message, path = "", details) {
-        super(message, "schema_error", path, "error", details);
-        this.name = "UniSpecSchemaError";
-    }
-}

package/dist/src/errors/security-error.d.ts

@@ -1,4 +0,0 @@
-import { UniSpecValidationError } from "./base-error.js";
-export declare class UniSpecSecurityError extends UniSpecValidationError {
-    constructor(message: string, path?: string, details?: Record<string, unknown>);
-}

package/dist/src/errors/security-error.js

@@ -1,7 +0,0 @@
-import { UniSpecValidationError } from "./base-error.js";
-export class UniSpecSecurityError extends UniSpecValidationError {
-    constructor(message, path = "", details) {
-        super(message, "security_error", path, "error", details);
-        this.name = "UniSpecSecurityError";
-    }
-}

package/dist/src/errors/semantic-error.d.ts

@@ -1,4 +0,0 @@
-import { UniSpecValidationError } from "./base-error.js";
-export declare class UniSpecSemanticError extends UniSpecValidationError {
-    constructor(message: string, path?: string, details?: Record<string, unknown>);
-}

package/dist/src/errors/semantic-error.js

@@ -1,7 +0,0 @@
-import { UniSpecValidationError } from "./base-error.js";
-export class UniSpecSemanticError extends UniSpecValidationError {
-    constructor(message, path = "", details) {
-        super(message, "semantic_error", path, "error", details);
-        this.name = "UniSpecSemanticError";
-    }
-}