@unispechq/unispec-core 0.3.2 → 0.3.4

package/dist/cjs/tests/cache/cache.test.js

@@ -1,274 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const node_assert_1 = __importDefault(require("node:assert"));
-const node_test_1 = require("node:test");
-const cache_factory_1 = require("../../src/cache/cache-factory.js");
-const cache_manager_1 = require("../../src/cache/cache-manager.js");
-const hash_utils_1 = require("../../src/cache/hash-utils.js");
-const lru_cache_1 = require("../../src/cache/lru-cache.js");
-const createTestDoc = (name) => ({
-    unispecVersion: "1.0.0",
-    service: {
-        name,
-        description: `Test service ${name}`,
-        protocols: {
-            rest: {
-                routes: [
-                    {
-                        name: "test",
-                        method: "GET",
-                        path: "/test",
-                        responses: { "200": { description: "Success" } },
-                    },
-                ],
-            },
-        },
-    },
-});
-(0, node_test_1.describe)("cache module", () => {
-    (0, node_test_1.describe)("LRUCache", () => {
-        (0, node_test_1.it)("should store and retrieve values", async () => {
-            const cache = new lru_cache_1.LRUCache();
-            await cache.set("key", "value");
-            node_assert_1.default.strictEqual(await cache.get("key"), "value");
-        });
-        (0, node_test_1.it)("should handle LRU eviction", async () => {
-            const cache = new lru_cache_1.LRUCache({ maxSize: 2 });
-            await cache.set("a", "1");
-            await cache.set("b", "2");
-            await cache.set("c", "3"); // evicts a
-            node_assert_1.default.strictEqual(await cache.get("a"), undefined);
-            node_assert_1.default.strictEqual(await cache.get("b"), "2");
-            node_assert_1.default.strictEqual(await cache.get("c"), "3");
-        });
-        (0, node_test_1.it)("should track statistics", async () => {
-            const cache = new lru_cache_1.LRUCache({ enableStats: true });
-            await cache.set("key", "value");
-            await cache.get("key"); // hit
-            await cache.get("missing"); // miss
-            const stats = cache.getStats();
-            node_assert_1.default.strictEqual(stats.hits, 1);
-            node_assert_1.default.strictEqual(stats.misses, 1);
-            node_assert_1.default.strictEqual(stats.hitRate, 0.5);
-        });
-    });
-    (0, node_test_1.describe)("CacheManager", () => {
-        (0, node_test_1.it)("should handle validation caching", async () => {
-            const manager = new cache_manager_1.UniSpecCacheManager({ enableStats: true });
-            const doc = createTestDoc("test");
-            const hash = await (0, hash_utils_1.generateDocumentHash)(doc);
-            const result = { valid: true, errors: [] };
-            await manager.setValidationResult(hash, result);
-            const cached = await manager.getValidationResult(hash);
-            node_assert_1.default.deepStrictEqual(cached, result);
-            node_assert_1.default.strictEqual(manager.getStats().validation.size, 1);
-            manager.destroy();
-        });
-        (0, node_test_1.it)("should handle normalization caching", async () => {
-            const manager = new cache_manager_1.UniSpecCacheManager({ enableStats: true });
-            const doc = createTestDoc("test");
-            const hash = await (0, hash_utils_1.generateDocumentHash)(doc);
-            const normalized = { ...doc, normalized: true };
-            await manager.setNormalizationResult(hash, normalized);
-            const cached = await manager.getNormalizationResult(hash);
-            node_assert_1.default.deepStrictEqual(cached, normalized);
-            node_assert_1.default.strictEqual(manager.getStats().normalization.size, 1);
-            manager.destroy();
-        });
-        (0, node_test_1.it)("should handle diff caching", async () => {
-            const manager = new cache_manager_1.UniSpecCacheManager({ enableStats: true });
-            const doc1 = createTestDoc("test1");
-            const doc2 = createTestDoc("test2");
-            const hash = await (0, hash_utils_1.generateDiffHash)(doc1, doc2);
-            const diffResult = { changes: [] };
-            await manager.setDiffResult(hash, diffResult);
-            const cached = await manager.getDiffResult(hash);
-            node_assert_1.default.deepStrictEqual(cached, diffResult);
-            node_assert_1.default.strictEqual(manager.getStats().diff.size, 1);
-            manager.destroy();
-        });
-        (0, node_test_1.it)("should provide comprehensive statistics", async () => {
-            const manager = new cache_manager_1.UniSpecCacheManager({ enableStats: true });
-            const doc = createTestDoc("test");
-            const hash = await (0, hash_utils_1.generateDocumentHash)(doc);
-            await manager.setValidationResult(hash, { valid: true, errors: [] });
-            await manager.setNormalizationResult(hash, { normalized: true });
-            await manager.setDiffResult(hash, { changes: [] });
-            const stats = manager.getStats();
-            node_assert_1.default.strictEqual(stats.total.size, 3);
-            node_assert_1.default.strictEqual(stats.validation.size, 1);
-            node_assert_1.default.strictEqual(stats.normalization.size, 1);
-            node_assert_1.default.strictEqual(stats.diff.size, 1);
-            manager.destroy();
-        });
-        (0, node_test_1.it)("should clear all caches", async () => {
-            const manager = new cache_manager_1.UniSpecCacheManager({ enableStats: true });
-            const doc = createTestDoc("test");
-            const hash = await (0, hash_utils_1.generateDocumentHash)(doc);
-            await manager.setValidationResult(hash, { valid: true, errors: [] });
-            await manager.setNormalizationResult(hash, { normalized: true });
-            await manager.setDiffResult(hash, { changes: [] });
-            manager.clearAll();
-            const stats = manager.getStats();
-            node_assert_1.default.strictEqual(stats.total.size, 0);
-            manager.destroy();
-        });
-    });
-    (0, node_test_1.describe)("CacheFactory", () => {
-        (0, node_test_1.it)("should create isolated instances", () => {
-            const manager1 = (0, cache_factory_1.createCacheManager)();
-            const manager2 = (0, cache_factory_1.createCacheManager)();
-            node_assert_1.default.notStrictEqual(manager1, manager2);
-            manager1.destroy();
-            manager2.destroy();
-        });
-        (0, node_test_1.it)("should create named managers with cleanup", () => {
-            const manager1 = (0, cache_factory_1.createNamedCacheManager)("test");
-            const manager2 = (0, cache_factory_1.createNamedCacheManager)("test"); // replaces first
-            node_assert_1.default.notStrictEqual(manager1, manager2);
-            manager1.destroy();
-            manager2.destroy();
-        });
-        (0, node_test_1.it)("should provide statistics for multiple managers", () => {
-            const manager1 = (0, cache_factory_1.createNamedCacheManager)("stats1", { enableStats: true });
-            const manager2 = (0, cache_factory_1.createNamedCacheManager)("stats2", { enableStats: true });
-            const stats = (0, cache_factory_1.getManagersStats)([manager1, manager2]);
-            node_assert_1.default.ok(stats.stats1);
-            node_assert_1.default.ok(stats.stats2);
-            node_assert_1.default.strictEqual(Object.keys(stats).length, 2);
-            manager1.destroy();
-            manager2.destroy();
-        });
-    });
-    (0, node_test_1.describe)("HashUtils", () => {
-        (0, node_test_1.it)("should generate consistent hashes", async () => {
-            const doc = createTestDoc("test");
-            const hash1 = await (0, hash_utils_1.generateDocumentHash)(doc);
-            const hash2 = await (0, hash_utils_1.generateDocumentHash)(doc);
-            node_assert_1.default.strictEqual(hash1, hash2);
-            node_assert_1.default.strictEqual(hash1.length, 20);
-        });
-        (0, node_test_1.it)("should generate different hashes for different documents", async () => {
-            const doc1 = createTestDoc("test1");
-            const doc2 = createTestDoc("test2");
-            const hash1 = await (0, hash_utils_1.generateDocumentHash)(doc1);
-            const hash2 = await (0, hash_utils_1.generateDocumentHash)(doc2);
-            node_assert_1.default.notStrictEqual(hash1, hash2);
-        });
-        (0, node_test_1.it)("should handle deep copies consistently", async () => {
-            const doc = createTestDoc("test");
-            const copy = JSON.parse(JSON.stringify(doc));
-            const hash1 = await (0, hash_utils_1.generateDocumentHash)(doc);
-            const hash2 = await (0, hash_utils_1.generateDocumentHash)(copy);
-            node_assert_1.default.strictEqual(hash1, hash2);
-        });
-        (0, node_test_1.it)("should generate diff hashes", async () => {
-            const doc1 = createTestDoc("test1");
-            const doc2 = createTestDoc("test2");
-            const hash = await (0, hash_utils_1.generateDiffHash)(doc1, doc2);
-            node_assert_1.default.strictEqual(typeof hash, "string");
-            node_assert_1.default.strictEqual(hash.length, 22);
-        });
-        (0, node_test_1.it)("should generate different diff hashes for different pairs", async () => {
-            const doc1 = createTestDoc("test1");
-            const doc2 = createTestDoc("test2");
-            const doc3 = createTestDoc("test3");
-            const hash1 = await (0, hash_utils_1.generateDiffHash)(doc1, doc2);
-            const hash2 = await (0, hash_utils_1.generateDiffHash)(doc2, doc3);
-            node_assert_1.default.notStrictEqual(hash1, hash2);
-        });
-    });
-    (0, node_test_1.describe)("Integration", () => {
-        (0, node_test_1.it)("should handle complete workflow", async () => {
-            const manager = (0, cache_factory_1.createCacheManager)({ enableStats: true });
-            const validDoc = createTestDoc("valid");
-            const invalidDoc = { unispecVersion: "1.0.0" };
-            // Process valid document
-            const validHash = await (0, hash_utils_1.generateDocumentHash)(validDoc);
-            await manager.setValidationResult(validHash, { valid: true, errors: [] });
-            await manager.setNormalizationResult(validHash, {
-                ...validDoc,
-                normalized: true,
-            });
-            // Process invalid document
-            const invalidHash = await (0, hash_utils_1.generateDocumentHash)(invalidDoc);
-            await manager.setValidationResult(invalidHash, {
-                valid: false,
-                errors: [{ path: "/", message: "Invalid", code: "INVALID" }],
-            });
-            // Process diff
-            const diffHash = await (0, hash_utils_1.generateDiffHash)(validDoc, invalidDoc);
-            await manager.setDiffResult(diffHash, { changes: [] });
-            // Verify results
-            const validResult = await manager.getValidationResult(validHash);
-            const invalidResult = await manager.getValidationResult(invalidHash);
-            const normResult = await manager.getNormalizationResult(validHash);
-            const diffResult = await manager.getDiffResult(diffHash);
-            node_assert_1.default.strictEqual(validResult?.valid, true);
-            node_assert_1.default.strictEqual(invalidResult?.valid, false);
-            node_assert_1.default.notStrictEqual(normResult, undefined);
-            node_assert_1.default.notStrictEqual(diffResult, undefined);
-            // Verify statistics
-            const stats = manager.getStats();
-            node_assert_1.default.strictEqual(stats.total.size, 4);
-            manager.destroy();
-        });
-        (0, node_test_1.it)("should handle concurrent operations", async () => {
-            const manager = (0, cache_factory_1.createCacheManager)({ enableStats: true });
-            const promises = [];
-            // Create concurrent operations
-            for (let i = 0; i < 10; i++) {
-                const doc = createTestDoc(`test${i}`);
-                const hash = await (0, hash_utils_1.generateDocumentHash)(doc);
-                promises.push(manager.setValidationResult(hash, { valid: true, errors: [] }));
-                promises.push(manager
-                    .getValidationResult(hash)
-                    .then(() => { })
-                    .catch(() => { }));
-            }
-            await Promise.all(promises);
-            // Verify integrity
-            const stats = manager.getStats();
-            node_assert_1.default.ok(stats.validation.size >= 0);
-            manager.destroy();
-        });
-    });
-    (0, node_test_1.describe)("Error handling", () => {
-        (0, node_test_1.it)("should handle malformed documents", async () => {
-            const manager = (0, cache_factory_1.createCacheManager)();
-            const malformedDocs = [
-                { unispecVersion: "1.0.0" },
-                { service: { name: "test" } },
-            ];
-            for (const doc of malformedDocs) {
-                try {
-                    const hash = await (0, hash_utils_1.generateDocumentHash)(doc);
-                    await manager.setValidationResult(hash, { valid: false, errors: [] });
-                    const result = await manager.getValidationResult(hash);
-                    node_assert_1.default.strictEqual(result?.valid, false);
-                }
-                catch (error) {
-                    // Expected for some malformed docs
-                    node_assert_1.default.ok(error instanceof Error);
-                }
-            }
-            manager.destroy();
-        });
-        (0, node_test_1.it)("should handle cache overflow gracefully", async () => {
-            const manager = (0, cache_factory_1.createCacheManager)({ enableStats: true, maxSize: 5 });
-            // Fill beyond capacity
-            for (let i = 0; i < 10; i++) {
-                const doc = createTestDoc(`test${i}`);
-                const hash = await (0, hash_utils_1.generateDocumentHash)(doc);
-                await manager.setValidationResult(hash, { valid: true, errors: [] });
-            }
-            const stats = manager.getStats();
-            node_assert_1.default.strictEqual(stats.validation.size, 5); // Should respect max size
-            node_assert_1.default.ok(stats.validation.evictions >= 0); // May have evictions
-            manager.destroy();
-        });
-    });
-});

package/dist/cjs/tests/cache/utils.js

@@ -1,32 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getExamplePath = exports.loadExample = void 0;
-exports.getValidExamplePaths = getValidExamplePaths;
-exports.getInvalidExamplePaths = getInvalidExamplePaths;
-const node_path_1 = __importDefault(require("node:path"));
-const utils_1 = require("../../tests/utils.js");
-Object.defineProperty(exports, "getExamplePath", { enumerable: true, get: function () { return utils_1.getExamplePath; } });
-Object.defineProperty(exports, "loadExample", { enumerable: true, get: function () { return utils_1.loadExample; } });
-// Cache-specific utilities
-function getValidExamplePaths() {
-    const validSpecDir = node_path_1.default.join(utils_1.examplesDir, "valid", "spec");
-    return [
-        node_path_1.default.join(validSpecDir, "rest-simple.json"),
-        node_path_1.default.join(validSpecDir, "graphql-simple.json"),
-        node_path_1.default.join(validSpecDir, "websocket-simple.json"),
-        node_path_1.default.join(validSpecDir, "mixed-complete.json"),
-    ];
-}
-function getInvalidExamplePaths() {
-    const invalidSpecDir = node_path_1.default.join(utils_1.examplesDir, "invalid", "spec");
-    return [
-        node_path_1.default.join(invalidSpecDir, "missing-unispec-version.json"),
-        node_path_1.default.join(invalidSpecDir, "missing-service-name.json"),
-        node_path_1.default.join(invalidSpecDir, "invalid-rest-method.json"),
-        node_path_1.default.join(invalidSpecDir, "graphql-missing-name.json"),
-        node_path_1.default.join(invalidSpecDir, "invalid-identifier.json"),
-    ];
-}

package/dist/cjs/tests/concurrency-normalizer-optimizer.test.js

@@ -1 +0,0 @@
-"use strict";

package/dist/cjs/tests/diff/diff-annotators.test.js

@@ -1,280 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const node_assert_1 = __importDefault(require("node:assert"));
-const node_test_1 = require("node:test");
-const utils_1 = require("../../tests/utils.js");
-const annotators_1 = require("../../src/diff/annotators.js");
-(0, node_test_1.describe)("diff annotators", () => {
-    (0, node_test_1.describe)("annotateRestChange", () => {
-        (0, node_test_1.it)("should annotate REST route additions as non-breaking", () => {
-            const change = (0, utils_1.createTestChange)({
-                path: "/service/protocols/rest/routes/newRoute",
-                description: "Item added",
-            });
-            const result = (0, annotators_1.annotateRestChange)(change);
-            node_assert_1.default.strictEqual(result.protocol, "rest");
-            node_assert_1.default.strictEqual(result.kind, "rest.route.added");
-            node_assert_1.default.strictEqual(result.severity, "non-breaking");
-        });
-        (0, node_test_1.it)("should annotate REST route removals as breaking", () => {
-            const change = (0, utils_1.createTestChange)({
-                path: "/service/protocols/rest/routes/removedRoute",
-                description: "Item removed",
-            });
-            const result = (0, annotators_1.annotateRestChange)(change);
-            node_assert_1.default.strictEqual(result.protocol, "rest");
-            node_assert_1.default.strictEqual(result.kind, "rest.route.removed");
-            node_assert_1.default.strictEqual(result.severity, "breaking");
-        });
-        (0, node_test_1.it)("should annotate required field changes as breaking", () => {
-            const change = (0, utils_1.createTestChange)({
-                path: "/service/protocols/rest/routes/myRoute/requestBody/required",
-                description: "Value changed",
-            });
-            const result = (0, annotators_1.annotateRestChange)(change);
-            node_assert_1.default.strictEqual(result.protocol, "rest");
-            node_assert_1.default.strictEqual(result.kind, "rest.parameter.required_changed");
-            node_assert_1.default.strictEqual(result.severity, "breaking");
-        });
-        (0, node_test_1.it)("should not annotate non-REST changes", () => {
-            const change = (0, utils_1.createTestChange)({
-                path: "/service/protocols/graphql/queries/myQuery",
-                description: "Item added",
-            });
-            const result = (0, annotators_1.annotateRestChange)(change);
-            node_assert_1.default.strictEqual(result.protocol, undefined);
-            node_assert_1.default.strictEqual(result.kind, undefined);
-            node_assert_1.default.strictEqual(result.severity, "unknown");
-        });
-        (0, node_test_1.it)("should handle malformed REST paths gracefully", () => {
-            const change = (0, utils_1.createTestChange)({
-                path: "/service/protocols/rest", // Missing routes segment
-                description: "Item added",
-            });
-            const result = (0, annotators_1.annotateRestChange)(change);
-            node_assert_1.default.strictEqual(result.protocol, undefined);
-            node_assert_1.default.strictEqual(result.kind, undefined);
-            node_assert_1.default.strictEqual(result.severity, "unknown");
-        });
-    });
-    (0, node_test_1.describe)("annotateGraphQLChange", () => {
-        (0, node_test_1.it)("should annotate GraphQL query additions as non-breaking", () => {
-            const change = (0, utils_1.createTestChange)({
-                path: "/service/protocols/graphql/queries/newQuery",
-                description: "Item added",
-            });
-            const result = (0, annotators_1.annotateGraphQLChange)(change);
-            node_assert_1.default.strictEqual(result.protocol, "graphql");
-            node_assert_1.default.strictEqual(result.kind, "graphql.query.added");
-            node_assert_1.default.strictEqual(result.severity, "non-breaking");
-        });
-        (0, node_test_1.it)("should annotate GraphQL query removals as breaking", () => {
-            const change = (0, utils_1.createTestChange)({
-                path: "/service/protocols/graphql/queries/removedQuery",
-                description: "Item removed",
-            });
-            const result = (0, annotators_1.annotateGraphQLChange)(change);
-            node_assert_1.default.strictEqual(result.protocol, "graphql");
-            node_assert_1.default.strictEqual(result.kind, "graphql.query.removed");
-            node_assert_1.default.strictEqual(result.severity, "breaking");
-        });
-        (0, node_test_1.it)("should annotate GraphQL mutation additions as non-breaking", () => {
-            const change = (0, utils_1.createTestChange)({
-                path: "/service/protocols/graphql/mutations/newMutation",
-                description: "Item added",
-            });
-            const result = (0, annotators_1.annotateGraphQLChange)(change);
-            node_assert_1.default.strictEqual(result.protocol, "graphql");
-            node_assert_1.default.strictEqual(result.kind, "graphql.mutation.added");
-            node_assert_1.default.strictEqual(result.severity, "non-breaking");
-        });
-        (0, node_test_1.it)("should annotate GraphQL mutation removals as breaking", () => {
-            const change = (0, utils_1.createTestChange)({
-                path: "/service/protocols/graphql/mutations/removedMutation",
-                description: "Item removed",
-            });
-            const result = (0, annotators_1.annotateGraphQLChange)(change);
-            node_assert_1.default.strictEqual(result.protocol, "graphql");
-            node_assert_1.default.strictEqual(result.kind, "graphql.mutation.removed");
-            node_assert_1.default.strictEqual(result.severity, "breaking");
-        });
-        (0, node_test_1.it)("should annotate GraphQL subscription additions as non-breaking", () => {
-            const change = (0, utils_1.createTestChange)({
-                path: "/service/protocols/graphql/subscriptions/newSubscription",
-                description: "Item added",
-            });
-            const result = (0, annotators_1.annotateGraphQLChange)(change);
-            node_assert_1.default.strictEqual(result.protocol, "graphql");
-            node_assert_1.default.strictEqual(result.kind, "graphql.subscription.added");
-            node_assert_1.default.strictEqual(result.severity, "non-breaking");
-        });
-        (0, node_test_1.it)("should annotate GraphQL subscription removals as breaking", () => {
-            const change = (0, utils_1.createTestChange)({
-                path: "/service/protocols/graphql/subscriptions/removedSubscription",
-                description: "Item removed",
-            });
-            const result = (0, annotators_1.annotateGraphQLChange)(change);
-            node_assert_1.default.strictEqual(result.protocol, "graphql");
-            node_assert_1.default.strictEqual(result.kind, "graphql.subscription.removed");
-            node_assert_1.default.strictEqual(result.severity, "breaking");
-        });
-        (0, node_test_1.it)("should not annotate non-GraphQL changes", () => {
-            const change = (0, utils_1.createTestChange)({
-                path: "/service/protocols/rest/routes/myRoute",
-                description: "Item added",
-            });
-            const result = (0, annotators_1.annotateGraphQLChange)(change);
-            node_assert_1.default.strictEqual(result.protocol, undefined);
-            node_assert_1.default.strictEqual(result.kind, undefined);
-            node_assert_1.default.strictEqual(result.severity, "unknown");
-        });
-        (0, node_test_1.it)("should annotate GraphQL argument additions as non-breaking", () => {
-            const change = (0, utils_1.createTestChange)({
-                path: "/service/protocols/graphql/queries/myQuery/args/newArg",
-                description: "Item added",
-            });
-            const result = (0, annotators_1.annotateGraphQLChange)(change);
-            node_assert_1.default.strictEqual(result.protocol, "graphql");
-            node_assert_1.default.strictEqual(result.kind, "graphql.query.argument_added");
-            node_assert_1.default.strictEqual(result.severity, "non-breaking");
-        });
-        (0, node_test_1.it)("should annotate GraphQL argument removals as breaking", () => {
-            const change = (0, utils_1.createTestChange)({
-                path: "/service/protocols/graphql/mutations/myMutation/args/oldArg",
-                description: "Item removed",
-            });
-            const result = (0, annotators_1.annotateGraphQLChange)(change);
-            node_assert_1.default.strictEqual(result.protocol, "graphql");
-            node_assert_1.default.strictEqual(result.kind, "graphql.mutation.argument_removed");
-            node_assert_1.default.strictEqual(result.severity, "breaking");
-        });
-        (0, node_test_1.it)("should annotate GraphQL return type changes as breaking", () => {
-            const change = (0, utils_1.createTestChange)({
-                path: "/service/protocols/graphql/subscriptions/mySubscription/returnType",
-                description: "Value changed",
-            });
-            const result = (0, annotators_1.annotateGraphQLChange)(change);
-            node_assert_1.default.strictEqual(result.protocol, "graphql");
-            node_assert_1.default.strictEqual(result.kind, "graphql.subscription.return_type_changed");
-            node_assert_1.default.strictEqual(result.severity, "breaking");
-        });
-    });
-    (0, node_test_1.describe)("annotateWebSocketChange", () => {
-        (0, node_test_1.it)("should annotate WebSocket channel additions as non-breaking", () => {
-            const change = (0, utils_1.createTestChange)({
-                path: "/service/protocols/websocket/channels/newChannel",
-                description: "Item added",
-            });
-            const result = (0, annotators_1.annotateWebSocketChange)(change);
-            node_assert_1.default.strictEqual(result.protocol, "websocket");
-            node_assert_1.default.strictEqual(result.kind, "websocket.channel.added");
-            node_assert_1.default.strictEqual(result.severity, "non-breaking");
-        });
-        (0, node_test_1.it)("should annotate WebSocket channel removals as breaking", () => {
-            const change = (0, utils_1.createTestChange)({
-                path: "/service/protocols/websocket/channels/removedChannel",
-                description: "Item removed",
-            });
-            const result = (0, annotators_1.annotateWebSocketChange)(change);
-            node_assert_1.default.strictEqual(result.protocol, "websocket");
-            node_assert_1.default.strictEqual(result.kind, "websocket.channel.removed");
-            node_assert_1.default.strictEqual(result.severity, "breaking");
-        });
-        (0, node_test_1.it)("should annotate WebSocket message additions as non-breaking", () => {
-            const change = (0, utils_1.createTestChange)({
-                path: "/service/protocols/websocket/channels/myChannel/messages/newMessage",
-                description: "Item added",
-            });
-            const result = (0, annotators_1.annotateWebSocketChange)(change);
-            node_assert_1.default.strictEqual(result.protocol, "websocket");
-            node_assert_1.default.strictEqual(result.kind, "websocket.message.added");
-            node_assert_1.default.strictEqual(result.severity, "non-breaking");
-        });
-        (0, node_test_1.it)("should annotate WebSocket message removals as breaking", () => {
-            const change = (0, utils_1.createTestChange)({
-                path: "/service/protocols/websocket/channels/myChannel/messages/removedMessage",
-                description: "Item removed",
-            });
-            const result = (0, annotators_1.annotateWebSocketChange)(change);
-            node_assert_1.default.strictEqual(result.protocol, "websocket");
-            node_assert_1.default.strictEqual(result.kind, "websocket.message.removed");
-            node_assert_1.default.strictEqual(result.severity, "breaking");
-        });
-        (0, node_test_1.it)("should not annotate non-WebSocket changes", () => {
-            const change = (0, utils_1.createTestChange)({
-                path: "/service/protocols/rest/routes/myRoute",
-                description: "Item added",
-            });
-            const result = (0, annotators_1.annotateWebSocketChange)(change);
-            node_assert_1.default.strictEqual(result.protocol, undefined);
-            node_assert_1.default.strictEqual(result.kind, undefined);
-            node_assert_1.default.strictEqual(result.severity, "unknown");
-        });
-    });
-    (0, node_test_1.describe)("annotation chaining", () => {
-        (0, node_test_1.it)("should handle multiple annotations correctly", () => {
-            // This simulates what happens in diffUniSpec where changes are chained through all annotators
-            const restChange = (0, utils_1.createTestChange)({
-                path: "/service/protocols/rest/routes/myRoute",
-                description: "Item added",
-            });
-            const result = (0, annotators_1.annotateWebSocketChange)((0, annotators_1.annotateGraphQLChange)((0, annotators_1.annotateRestChange)(restChange)));
-            // Should only have REST annotations since it's a REST path
-            node_assert_1.default.strictEqual(result.protocol, "rest");
-            node_assert_1.default.strictEqual(result.kind, "rest.route.added");
-            node_assert_1.default.strictEqual(result.severity, "non-breaking");
-        });
-    });
-    (0, node_test_1.describe)("edge cases", () => {
-        (0, node_test_1.it)("should handle empty paths", () => {
-            const change = (0, utils_1.createTestChange)({
-                path: "",
-                description: "Item added",
-            });
-            const restResult = (0, annotators_1.annotateRestChange)(change);
-            const graphqlResult = (0, annotators_1.annotateGraphQLChange)(change);
-            const wsResult = (0, annotators_1.annotateWebSocketChange)(change);
-            // None should annotate empty path
-            node_assert_1.default.strictEqual(restResult.protocol, undefined);
-            node_assert_1.default.strictEqual(graphqlResult.protocol, undefined);
-            node_assert_1.default.strictEqual(wsResult.protocol, undefined);
-        });
-        (0, node_test_1.it)("should handle undefined paths gracefully", () => {
-            const changeWithUndefined = (0, utils_1.createTestChange)({
-                path: undefined,
-                description: "Item added",
-            });
-            const restResultUndef = (0, annotators_1.annotateRestChange)(changeWithUndefined);
-            const graphqlResultUndef = (0, annotators_1.annotateGraphQLChange)(changeWithUndefined);
-            const wsResultUndef = (0, annotators_1.annotateWebSocketChange)(changeWithUndefined);
-            node_assert_1.default.strictEqual(restResultUndef.protocol, undefined);
-            node_assert_1.default.strictEqual(graphqlResultUndef.protocol, undefined);
-            node_assert_1.default.strictEqual(wsResultUndef.protocol, undefined);
-        });
-        (0, node_test_1.it)("should handle malformed paths gracefully", () => {
-            const malformedPaths = [
-                "/service/protocols", // Incomplete
-                "/service/protocols/rest/routes", // Missing route name
-                "/service/protocols/graphql", // Missing operation type
-                "invalid/path/format",
-                "service/protocols/rest/routes/route", // Missing leading slash
-            ];
-            for (const path of malformedPaths) {
-                const change = (0, utils_1.createTestChange)({
-                    path,
-                    description: "Item added",
-                });
-                const restResult = (0, annotators_1.annotateRestChange)(change);
-                const graphqlResult = (0, annotators_1.annotateGraphQLChange)(change);
-                const wsResult = (0, annotators_1.annotateWebSocketChange)(change);
-                // Should not crash and should not annotate malformed paths
-                node_assert_1.default.strictEqual(restResult.protocol, undefined);
-                node_assert_1.default.strictEqual(graphqlResult.protocol, undefined);
-                node_assert_1.default.strictEqual(wsResult.protocol, undefined);
-            }
-        });
-    });
-});