@unispechq/unispec-core 0.3.2 → 0.3.4

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

@@ -1,78 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SuggestionGeneratorService = void 0;
-/**
- * Service for generating migration suggestions based on change impact.
- */
-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");
-        }
-    }
-}
-exports.SuggestionGeneratorService = SuggestionGeneratorService;

package/dist/cjs/src/diff/types.js

@@ -1,11 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_NAMED_COLLECTION_PATHS = void 0;
-// Default named collection paths for UniSpec
-exports.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/cjs/src/errors/base-error.js

@@ -1,33 +0,0 @@
-"use strict";
-/**
- * Base validation error class for UniSpec validation.
- * Provides better error context and handling.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.UniSpecValidationError = void 0;
-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,
-        };
-    }
-}
-exports.UniSpecValidationError = UniSpecValidationError;

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

@@ -1,11 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.UniSpecConfigError = void 0;
-const base_error_1 = require("./base-error.js");
-class UniSpecConfigError extends base_error_1.UniSpecValidationError {
-    constructor(message, path = "", details) {
-        super(message, "config_error", path, "error", details);
-        this.name = "UniSpecConfigError";
-    }
-}
-exports.UniSpecConfigError = UniSpecConfigError;

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

@@ -1,48 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ErrorFactory = void 0;
-const base_error_1 = require("./base-error.js");
-const config_error_1 = require("./config-error.js");
-const loader_error_1 = require("./loader-error.js");
-const reference_error_1 = require("./reference-error.js");
-const schema_error_1 = require("./schema-error.js");
-const security_error_1 = require("./security-error.js");
-const semantic_error_1 = require("./semantic-error.js");
-/**
- * Error factory for creating specific error types.
- */
-exports.ErrorFactory = {
-    createSchemaError(message, path, details) {
-        return new schema_error_1.UniSpecSchemaError(message, path, details);
-    },
-    createSemanticError(message, path, details) {
-        return new semantic_error_1.UniSpecSemanticError(message, path, details);
-    },
-    createReferenceError(message, path, details) {
-        return new reference_error_1.UniSpecReferenceError(message, path, details);
-    },
-    createConfigError(message, path, details) {
-        return new config_error_1.UniSpecConfigError(message, path, details);
-    },
-    createSecurityError(message, path, details) {
-        return new security_error_1.UniSpecSecurityError(message, path, details);
-    },
-    createLoaderError(message, path, details) {
-        return new loader_error_1.UniSpecLoaderError(message, path, details);
-    },
-    /**
-     * Convert generic error to UniSpecValidationError
-     */
-    fromError(error, defaultCode = "validation_error") {
-        if (error instanceof base_error_1.UniSpecValidationError) {
-            return error;
-        }
-        if (error instanceof Error) {
-            return new base_error_1.UniSpecValidationError(error.message, defaultCode, "", "error", { originalError: error.name, stack: error.stack });
-        }
-        if (typeof error === "string") {
-            return new base_error_1.UniSpecValidationError(error, defaultCode);
-        }
-        return new base_error_1.UniSpecValidationError(`Unknown validation error: ${String(error)}`, defaultCode, "", "error", { originalError: error });
-    },
-};

package/dist/cjs/src/errors/index.js

@@ -1,19 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.UniSpecSemanticError = exports.UniSpecSecurityError = exports.UniSpecSchemaError = exports.UniSpecReferenceError = exports.UniSpecLoaderError = exports.ErrorFactory = exports.UniSpecConfigError = exports.UniSpecValidationError = void 0;
-var base_error_1 = require("./base-error.js");
-Object.defineProperty(exports, "UniSpecValidationError", { enumerable: true, get: function () { return base_error_1.UniSpecValidationError; } });
-var config_error_1 = require("./config-error.js");
-Object.defineProperty(exports, "UniSpecConfigError", { enumerable: true, get: function () { return config_error_1.UniSpecConfigError; } });
-var error_factory_1 = require("./error-factory.js");
-Object.defineProperty(exports, "ErrorFactory", { enumerable: true, get: function () { return error_factory_1.ErrorFactory; } });
-var loader_error_1 = require("./loader-error.js");
-Object.defineProperty(exports, "UniSpecLoaderError", { enumerable: true, get: function () { return loader_error_1.UniSpecLoaderError; } });
-var reference_error_1 = require("./reference-error.js");
-Object.defineProperty(exports, "UniSpecReferenceError", { enumerable: true, get: function () { return reference_error_1.UniSpecReferenceError; } });
-var schema_error_1 = require("./schema-error.js");
-Object.defineProperty(exports, "UniSpecSchemaError", { enumerable: true, get: function () { return schema_error_1.UniSpecSchemaError; } });
-var security_error_1 = require("./security-error.js");
-Object.defineProperty(exports, "UniSpecSecurityError", { enumerable: true, get: function () { return security_error_1.UniSpecSecurityError; } });
-var semantic_error_1 = require("./semantic-error.js");
-Object.defineProperty(exports, "UniSpecSemanticError", { enumerable: true, get: function () { return semantic_error_1.UniSpecSemanticError; } });

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

@@ -1,11 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.UniSpecLoaderError = void 0;
-const base_error_1 = require("./base-error.js");
-class UniSpecLoaderError extends base_error_1.UniSpecValidationError {
-    constructor(message, path = "", details) {
-        super(message, "loader_error", path, "error", details);
-        this.name = "UniSpecLoaderError";
-    }
-}
-exports.UniSpecLoaderError = UniSpecLoaderError;

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

@@ -1,11 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.UniSpecReferenceError = void 0;
-const base_error_1 = require("./base-error.js");
-class UniSpecReferenceError extends base_error_1.UniSpecValidationError {
-    constructor(message, path = "", details) {
-        super(message, "reference_error", path, "error", details);
-        this.name = "UniSpecReferenceError";
-    }
-}
-exports.UniSpecReferenceError = UniSpecReferenceError;

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

@@ -1,11 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.UniSpecSchemaError = void 0;
-const base_error_1 = require("./base-error.js");
-class UniSpecSchemaError extends base_error_1.UniSpecValidationError {
-    constructor(message, path = "", details) {
-        super(message, "schema_error", path, "error", details);
-        this.name = "UniSpecSchemaError";
-    }
-}
-exports.UniSpecSchemaError = UniSpecSchemaError;

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

@@ -1,11 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.UniSpecSecurityError = void 0;
-const base_error_1 = require("./base-error.js");
-class UniSpecSecurityError extends base_error_1.UniSpecValidationError {
-    constructor(message, path = "", details) {
-        super(message, "security_error", path, "error", details);
-        this.name = "UniSpecSecurityError";
-    }
-}
-exports.UniSpecSecurityError = UniSpecSecurityError;

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

@@ -1,11 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.UniSpecSemanticError = void 0;
-const base_error_1 = require("./base-error.js");
-class UniSpecSemanticError extends base_error_1.UniSpecValidationError {
-    constructor(message, path = "", details) {
-        super(message, "semantic_error", path, "error", details);
-        this.name = "UniSpecSemanticError";
-    }
-}
-exports.UniSpecSemanticError = UniSpecSemanticError;