@unispechq/unispec-core 0.3.2 → 0.3.4

package/dist/cjs/tests/validator/unispec-validator.test.js

@@ -1,103 +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 validator_1 = require("../../src/validator/index.js");
-const utils_1 = require("./utils.js");
-(0, node_test_1.describe)("validateUniSpec", () => {
-    (0, node_test_1.describe)("valid examples", () => {
-        (0, node_test_1.it)("should validate simple REST spec", async () => {
-            const doc = (0, utils_1.loadValidSpecExample)("rest-simple");
-            const result = await (0, validator_1.validateUniSpec)(doc);
-            node_assert_1.default.strictEqual(result.valid, true, "Valid REST spec should pass validation");
-            node_assert_1.default.deepStrictEqual(result.errors, [], "Should have no errors");
-        });
-        (0, node_test_1.it)("should validate simple GraphQL spec", async () => {
-            const doc = (0, utils_1.loadValidSpecExample)("graphql-simple");
-            const result = await (0, validator_1.validateUniSpec)(doc);
-            node_assert_1.default.strictEqual(result.valid, true, "Valid GraphQL spec should pass validation");
-            node_assert_1.default.deepStrictEqual(result.errors, [], "Should have no errors");
-        });
-        (0, node_test_1.it)("should validate simple WebSocket spec", async () => {
-            const doc = (0, utils_1.loadValidSpecExample)("websocket-simple");
-            const result = await (0, validator_1.validateUniSpec)(doc);
-            node_assert_1.default.strictEqual(result.valid, true, "Valid WebSocket spec should pass validation");
-            node_assert_1.default.deepStrictEqual(result.errors, [], "Should have no errors");
-        });
-        (0, node_test_1.it)("should validate mixed complete spec", async () => {
-            const doc = (0, utils_1.loadValidSpecExample)("mixed-complete");
-            const result = await (0, validator_1.validateUniSpec)(doc);
-            node_assert_1.default.strictEqual(result.valid, true, "Valid mixed spec should pass validation");
-            node_assert_1.default.deepStrictEqual(result.errors, [], "Should have no errors");
-        });
-    });
-    (0, node_test_1.describe)("invalid examples", () => {
-        (0, node_test_1.it)("should reject spec missing service name", async () => {
-            const doc = (0, utils_1.loadInvalidSpecExample)("missing-service-name");
-            const result = await (0, validator_1.validateUniSpec)(doc);
-            node_assert_1.default.strictEqual(result.valid, false, "Spec without service name should fail validation");
-            node_assert_1.default.ok(result.errors.length > 0, "Should have validation errors");
-            // Check that error mentions missing required property
-            const hasServiceNameError = result.errors.some((error) => error.message?.includes("required property") &&
-                error.message.includes("name"));
-            node_assert_1.default.ok(hasServiceNameError, "Should have error about missing service name");
-        });
-        (0, node_test_1.it)("should reject spec missing unispec version", async () => {
-            const doc = (0, utils_1.loadInvalidSpecExample)("missing-unispec-version");
-            const result = await (0, validator_1.validateUniSpec)(doc);
-            node_assert_1.default.strictEqual(result.valid, false, "Spec without version should fail validation");
-            node_assert_1.default.ok(result.errors.length > 0, "Should have validation errors");
-        });
-        (0, node_test_1.it)("should reject spec with invalid identifier", async () => {
-            const doc = (0, utils_1.loadInvalidSpecExample)("invalid-identifier");
-            const result = await (0, validator_1.validateUniSpec)(doc);
-            node_assert_1.default.strictEqual(result.valid, false, "Spec with invalid identifier should fail validation");
-            node_assert_1.default.ok(result.errors.length > 0, "Should have validation errors");
-        });
-        (0, node_test_1.it)("should reject GraphQL spec missing argument type", async () => {
-            const doc = (0, utils_1.loadInvalidSpecExample)("graphql-missing-arg-type");
-            const result = await (0, validator_1.validateUniSpec)(doc);
-            node_assert_1.default.strictEqual(result.valid, false, "GraphQL spec without arg type should fail validation");
-            node_assert_1.default.ok(result.errors.length > 0, "Should have validation errors");
-        });
-        (0, node_test_1.it)("should reject GraphQL spec missing name", async () => {
-            const doc = (0, utils_1.loadInvalidSpecExample)("graphql-missing-name");
-            const result = await (0, validator_1.validateUniSpec)(doc);
-            node_assert_1.default.strictEqual(result.valid, false, "GraphQL spec without name should fail validation");
-            node_assert_1.default.ok(result.errors.length > 0, "Should have validation errors");
-        });
-        (0, node_test_1.it)("should reject spec with invalid REST method", async () => {
-            const doc = (0, utils_1.loadInvalidSpecExample)("invalid-rest-method");
-            const result = await (0, validator_1.validateUniSpec)(doc);
-            node_assert_1.default.strictEqual(result.valid, false, "Spec with invalid REST method should fail validation");
-            node_assert_1.default.ok(result.errors.length > 0, "Should have validation errors");
-        });
-    });
-    (0, node_test_1.describe)("extended validation", () => {
-        (0, node_test_1.it)("should perform semantic validation when enabled", async () => {
-            const doc = (0, utils_1.loadValidSpecExample)("rest-simple");
-            const result = await (0, validator_1.validateUniSpec)(doc, {
-                enableExtendedValidation: true,
-                semanticValidation: {},
-            });
-            node_assert_1.default.strictEqual(result.valid, true, "Valid spec should pass semantic validation");
-            node_assert_1.default.ok("semantic" in result, "Should have semantic validation result");
-            const extendedResult = result;
-            node_assert_1.default.strictEqual(extendedResult.semantic?.valid, true, "Semantic validation should pass");
-        });
-        (0, node_test_1.it)("should perform reference validation when enabled", async () => {
-            const doc = (0, utils_1.loadValidSpecExample)("mixed-complete");
-            const result = await (0, validator_1.validateUniSpec)(doc, {
-                enableExtendedValidation: true,
-                referenceValidation: {},
-            });
-            node_assert_1.default.strictEqual(result.valid, true, "Valid spec should pass reference validation");
-            node_assert_1.default.ok("references" in result, "Should have reference validation result");
-            const extendedResult = result;
-            node_assert_1.default.strictEqual(extendedResult.references?.valid, true, "Reference validation should pass");
-        });
-    });
-});

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

@@ -1,25 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadValidSpecExample = loadValidSpecExample;
-exports.loadInvalidSpecExample = loadInvalidSpecExample;
-exports.loadValidConfigExample = loadValidConfigExample;
-exports.loadInvalidConfigExample = loadInvalidConfigExample;
-const node_path_1 = require("node:path");
-const utils_1 = require("../../tests/utils.js");
-// Validator-specific utilities
-function loadValidSpecExample(name) {
-    const path = (0, node_path_1.join)(utils_1.examplesDir, "valid/spec", `${name}.json`);
-    return (0, utils_1.loadExample)(path);
-}
-function loadInvalidSpecExample(name) {
-    const path = (0, node_path_1.join)(utils_1.examplesDir, "invalid/spec", `${name}.json`);
-    return (0, utils_1.loadExample)(path);
-}
-function loadValidConfigExample(name) {
-    const path = (0, node_path_1.join)(utils_1.examplesDir, "valid/config", `${name}.json`);
-    return (0, utils_1.loadExample)(path);
-}
-function loadInvalidConfigExample(name) {
-    const path = (0, node_path_1.join)(utils_1.examplesDir, "invalid/config", `${name}.json`);
-    return (0, utils_1.loadInvalidExample)(path);
-}

package/dist/src/cache/cache-factory.d.ts

@@ -1,31 +0,0 @@
-import { UniSpecCacheManager } from "./cache-manager.js";
-import type { CacheOptions } from "./types.js";
-/**
- * Create a new isolated cache manager instance.
- * @param options - Cache configuration options
- * @returns New cache manager instance
- */
-export declare function createCacheManager(options?: CacheOptions): UniSpecCacheManager;
-/**
- * Create a named cache manager instance with simple registry.
- * @param name - Instance name for identification
- * @param options - Cache configuration options
- * @returns Cache manager instance
- */
-export declare function createNamedCacheManager(name?: string, options?: CacheOptions): UniSpecCacheManager;
-/**
- * Get cache manager statistics for multiple instances.
- * @param managers - Array of cache manager instances
- * @returns Statistics for all provided managers
- */
-export declare function getManagersStats(managers: UniSpecCacheManager[]): Record<string, ReturnType<UniSpecCacheManager["getStats"]>>;
-/**
- * Destroy multiple cache manager instances.
- * @param managers - Array of cache manager instances to destroy
- */
-export declare function destroyManagers(managers: UniSpecCacheManager[]): void;
-/**
- * Clear test registry (for testing only).
- * @internal
- */
-export declare function clearTestRegistry(): void;

package/dist/src/cache/cache-factory.js

@@ -1,65 +0,0 @@
-import { UniSpecCacheManager } from "./cache-manager.js";
-/**
- * Simple registry for test cleanup (minimal, not persistent global state)
- */
-const testRegistry = new Map();
-/**
- * Create a new isolated cache manager instance.
- * @param options - Cache configuration options
- * @returns New cache manager instance
- */
-export function createCacheManager(options) {
-    return new UniSpecCacheManager(options);
-}
-/**
- * Create a named cache manager instance with simple registry.
- * @param name - Instance name for identification
- * @param options - Cache configuration options
- * @returns Cache manager instance
- */
-export function createNamedCacheManager(name = "default", options) {
-    // For testing, keep simple registry to enable cleanup
-    if (testRegistry.has(name)) {
-        const existing = testRegistry.get(name);
-        if (existing) {
-            existing.destroy(); // Cleanup existing instance
-        }
-    }
-    const manager = new UniSpecCacheManager(options);
-    manager._name = name; // Store name for debugging
-    testRegistry.set(name, manager); // Add to registry for cleanup
-    return manager;
-}
-/**
- * Get cache manager statistics for multiple instances.
- * @param managers - Array of cache manager instances
- * @returns Statistics for all provided managers
- */
-export function getManagersStats(managers) {
-    const stats = {};
-    for (const [index, manager] of managers.entries()) {
-        const name = manager._name ||
-            `manager_${index}`;
-        stats[name] = manager.getStats();
-    }
-    return stats;
-}
-/**
- * Destroy multiple cache manager instances.
- * @param managers - Array of cache manager instances to destroy
- */
-export function destroyManagers(managers) {
-    for (const manager of managers) {
-        manager.destroy();
-    }
-}
-/**
- * Clear test registry (for testing only).
- * @internal
- */
-export function clearTestRegistry() {
-    for (const manager of testRegistry.values()) {
-        manager.destroy();
-    }
-    testRegistry.clear();
-}

package/dist/src/cache/cache-manager.d.ts

@@ -1,62 +0,0 @@
-import type { ValidationResult } from "../types/index.js";
-import type { CacheOptions, CacheStats } from "./types.js";
-/**
- * Cache manager for UniSpec operations.
- */
-export declare class UniSpecCacheManager {
-    private validationCache;
-    private normalizationCache;
-    private diffCache;
-    private cleanupInterval;
-    constructor(options?: CacheOptions);
-    /**
-     * Get cached validation result asynchronously.
-     */
-    getValidationResult(documentHash: string): Promise<ValidationResult | undefined>;
-    /**
-     * Cache validation result asynchronously.
-     */
-    setValidationResult(documentHash: string, result: ValidationResult): Promise<void>;
-    /**
-     * Get cached normalization result asynchronously.
-     */
-    getNormalizationResult(documentHash: string): Promise<unknown>;
-    /**
-     * Cache normalization result asynchronously.
-     */
-    setNormalizationResult(documentHash: string, result: unknown): Promise<void>;
-    /**
-     * Get cached diff result asynchronously.
-     */
-    getDiffResult(docsHash: string): Promise<unknown>;
-    /**
-     * Cache diff result asynchronously.
-     */
-    setDiffResult(docsHash: string, result: unknown): Promise<void>;
-    /**
-     * Get comprehensive cache statistics.
-     */
-    getStats(): {
-        validation: CacheStats;
-        normalization: CacheStats;
-        diff: CacheStats;
-        total: {
-            size: number;
-            hits: number;
-            misses: number;
-            hitRate: number;
-        };
-    };
-    /**
-     * Clear all caches.
-     */
-    clearAll(): void;
-    /**
-     * Start automatic cleanup interval.
-     */
-    private startCleanup;
-    /**
-     * Stop automatic cleanup.
-     */
-    destroy(): void;
-}

package/dist/src/cache/cache-manager.js

@@ -1,124 +0,0 @@
-import { CACHE_CONSTANTS, CACHE_MESSAGES } from "./constants.js";
-import { LRUCache } from "./lru-cache.js";
-/**
- * Cache manager for UniSpec operations.
- */
-export class UniSpecCacheManager {
-    constructor(options = {}) {
-        this.cleanupInterval = null;
-        this.validationCache = new LRUCache({
-            ...options,
-            maxSize: options.maxSize || CACHE_CONSTANTS.VALIDATION_MAX_SIZE,
-        });
-        this.normalizationCache = new LRUCache({
-            ...options,
-            maxSize: options.maxSize || CACHE_CONSTANTS.NORMALIZATION_MAX_SIZE,
-        });
-        this.diffCache = new LRUCache({
-            ...options,
-            maxSize: options.maxSize || CACHE_CONSTANTS.DIFF_MAX_SIZE,
-        });
-        // Only start cleanup if not in test environment
-        if (process.env.NODE_ENV !== "test") {
-            this.startCleanup();
-        }
-    }
-    /**
-     * Get cached validation result asynchronously.
-     */
-    async getValidationResult(documentHash) {
-        return await this.validationCache.get(documentHash);
-    }
-    /**
-     * Cache validation result asynchronously.
-     */
-    async setValidationResult(documentHash, result) {
-        await this.validationCache.set(documentHash, result);
-    }
-    /**
-     * Get cached normalization result asynchronously.
-     */
-    async getNormalizationResult(documentHash) {
-        return await this.normalizationCache.get(documentHash);
-    }
-    /**
-     * Cache normalization result asynchronously.
-     */
-    async setNormalizationResult(documentHash, result) {
-        await this.normalizationCache.set(documentHash, result);
-    }
-    /**
-     * Get cached diff result asynchronously.
-     */
-    async getDiffResult(docsHash) {
-        return await this.diffCache.get(docsHash);
-    }
-    /**
-     * Cache diff result asynchronously.
-     */
-    async setDiffResult(docsHash, result) {
-        await this.diffCache.set(docsHash, result);
-    }
-    /**
-     * Get comprehensive cache statistics.
-     */
-    getStats() {
-        const validationStats = this.validationCache.getStats();
-        const normalizationStats = this.normalizationCache.getStats();
-        const diffStats = this.diffCache.getStats();
-        const total = {
-            size: validationStats.size + normalizationStats.size + diffStats.size,
-            hits: validationStats.hits + normalizationStats.hits + diffStats.hits,
-            misses: validationStats.misses + normalizationStats.misses + diffStats.misses,
-            hitRate: 0,
-        };
-        const totalRequests = total.hits + total.misses;
-        total.hitRate = totalRequests > 0 ? total.hits / totalRequests : 0;
-        return {
-            validation: validationStats,
-            normalization: normalizationStats,
-            diff: diffStats,
-            total,
-        };
-    }
-    /**
-     * Clear all caches.
-     */
-    clearAll() {
-        this.validationCache.clear();
-        this.normalizationCache.clear();
-        this.diffCache.clear();
-    }
-    /**
-     * Start automatic cleanup interval.
-     */
-    startCleanup() {
-        try {
-            this.cleanupInterval = setInterval(() => {
-                try {
-                    this.validationCache.cleanup();
-                    this.normalizationCache.cleanup();
-                    this.diffCache.cleanup();
-                }
-                catch (error) {
-                    console.error(CACHE_MESSAGES.CLEANUP_ERROR, error);
-                    // Continue running cleanup even if one cache fails
-                }
-            }, CACHE_CONSTANTS.CLEANUP_INTERVAL);
-        }
-        catch (error) {
-            console.error(CACHE_MESSAGES.CLEANUP_START_ERROR, error);
-            // Cache will still work without automatic cleanup
-        }
-    }
-    /**
-     * Stop automatic cleanup.
-     */
-    destroy() {
-        if (this.cleanupInterval) {
-            clearInterval(this.cleanupInterval);
-            this.cleanupInterval = null;
-        }
-        this.clearAll();
-    }
-}

package/dist/src/cache/constants.d.ts

@@ -1,21 +0,0 @@
-/**
- * Cache configuration constants.
- */
-export declare const CACHE_CONSTANTS: {
-    readonly DEFAULT_MAX_SIZE: 100;
-    readonly VALIDATION_MAX_SIZE: 50;
-    readonly NORMALIZATION_MAX_SIZE: 30;
-    readonly DIFF_MAX_SIZE: 20;
-    readonly DEFAULT_TTL: number;
-    readonly CLEANUP_INTERVAL: 60000;
-    readonly HASH_GOLDEN_RATIO: 2654435761;
-    readonly HASH_BASE: 31;
-    readonly HASH_MASK: 4294967295;
-};
-export declare const CACHE_MESSAGES: {
-    readonly CLEANUP_ERROR: "Cache cleanup error";
-    readonly CLEANUP_START_ERROR: "Failed to start cleanup interval";
-    readonly CACHE_WILL_CONTINUE: "Cache will still work without automatic cleanup";
-};
-export type CacheSize = typeof CACHE_CONSTANTS.DEFAULT_MAX_SIZE | typeof CACHE_CONSTANTS.VALIDATION_MAX_SIZE | typeof CACHE_CONSTANTS.NORMALIZATION_MAX_SIZE | typeof CACHE_CONSTANTS.DIFF_MAX_SIZE;
-export type TTL = typeof CACHE_CONSTANTS.DEFAULT_TTL | typeof CACHE_CONSTANTS.CLEANUP_INTERVAL;

package/dist/src/cache/constants.js

@@ -1,22 +0,0 @@
-/**
- * Cache configuration constants.
- */
-export const CACHE_CONSTANTS = {
-    // Default cache sizes
-    DEFAULT_MAX_SIZE: 100,
-    VALIDATION_MAX_SIZE: 50,
-    NORMALIZATION_MAX_SIZE: 30,
-    DIFF_MAX_SIZE: 20,
-    // TTL values (in milliseconds)
-    DEFAULT_TTL: 5 * 60 * 1000, // 5 minutes
-    CLEANUP_INTERVAL: 60000, // 1 minute
-    // Hash configuration
-    HASH_GOLDEN_RATIO: 2654435761,
-    HASH_BASE: 31,
-    HASH_MASK: 0xffffffff,
-};
-export const CACHE_MESSAGES = {
-    CLEANUP_ERROR: "Cache cleanup error",
-    CLEANUP_START_ERROR: "Failed to start cleanup interval",
-    CACHE_WILL_CONTINUE: "Cache will still work without automatic cleanup",
-};

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

@@ -1,11 +0,0 @@
-import type { UniSpecDocument } from "../types/index.js";
-/**
- * Generate a hash for a UniSpec document for caching purposes.
- * Uses optimized hashing for better performance and collision resistance.
- */
-export declare function generateDocumentHash(document: UniSpecDocument): Promise<string>;
-/**
- * Generate a hash for two documents (for diff caching).
- * Uses optimized diff hashing with better collision resistance.
- */
-export declare function generateDiffHash(oldDoc: UniSpecDocument, newDoc: UniSpecDocument): Promise<string>;

package/dist/src/cache/hash-utils.js

@@ -1,15 +0,0 @@
-import { generateOptimizedDiffHash, generateOptimizedDocumentHash, } from "./hashing.js";
-/**
- * Generate a hash for a UniSpec document for caching purposes.
- * Uses optimized hashing for better performance and collision resistance.
- */
-export async function generateDocumentHash(document) {
-    return await generateOptimizedDocumentHash(document);
-}
-/**
- * Generate a hash for two documents (for diff caching).
- * Uses optimized diff hashing with better collision resistance.
- */
-export async function generateDiffHash(oldDoc, newDoc) {
-    return await generateOptimizedDiffHash(oldDoc, newDoc);
-}

package/dist/src/cache/hashing.d.ts

@@ -1,28 +0,0 @@
-import type { UniSpecDocument } from "../types/index.js";
-/**
- * Generate a secure hash for a document using optimized sorting and Web Crypto API.
- */
-export declare function generateOptimizedDocumentHash(document: UniSpecDocument): Promise<string>;
-/**
- * Configuration for stable stringification.
- */
-interface StringifyConfig {
-    maxDepth: number;
-    maxKeys: number;
-    handleCircular: boolean;
-    handleDeepObjects: boolean;
-}
-/**
- * Optimized stable stringification that avoids recursion depth issues.
- */
-declare function stableStringify(obj: unknown, config?: Partial<StringifyConfig>, depth?: number, visited?: WeakSet<object>): string;
-/**
- * Generate a secure hash for two documents (for diff caching) with optimized collision resistance.
- */
-export declare function generateOptimizedDiffHash(oldDoc: UniSpecDocument, newDoc: UniSpecDocument): Promise<string>;
-/**
- * Simple hash for small objects (keys, strings) using built-in hash.
- * Kept for backward compatibility but consider using secureHash for new code.
- */
-export declare function simpleHash(str: string): string;
-export { stableStringify };