@specverse/engines 4.1.0

package/dist/realize/library/library.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Instance Factory Library
+ *
+ * Manages a collection of instance factories and provides
+ * lookup, filtering, and version resolution.
+ */
+import { type LoadResult } from './loader.js';
+import { type CompatibilityResult } from './validator.js';
+import type { InstanceFactory, LibrarySource, LibraryConfig } from '../types/index.js';
+/**
+ * Query options for finding instance factories
+ */
+export interface QueryOptions {
+    /** Filter by type category */
+    category?: InstanceFactory['category'];
+    /** Filter by capability (supports wildcards) */
+    capability?: string;
+    /** Filter by technology stack */
+    technology?: {
+        runtime?: string;
+        language?: string;
+        framework?: string;
+        orm?: string;
+        validation?: string;
+    };
+    /** Filter by version range */
+    version?: string;
+    /** Filter by tags */
+    tags?: string[];
+}
+/**
+ * Library for managing instance factories
+ */
+export declare class InstanceFactoryLibrary {
+    private types;
+    private validator;
+    private sources;
+    constructor();
+    /**
+     * Load instance factories from a directory
+     */
+    load(baseDir: string, options?: {
+        pattern?: string;
+        validate?: boolean;
+    }): Promise<void>;
+    /**
+     * Load from multiple sources with priority ordering
+     */
+    loadFromSources(sources: LibrarySource[]): Promise<void>;
+    /**
+     * Load from configuration
+     */
+    loadFromConfig(config: LibraryConfig): Promise<void>;
+    /**
+     * Get an instance factory by name and optional version
+     */
+    get(name: string, versionRange?: string): InstanceFactory | undefined;
+    /**
+     * Get all versions of an instance factory
+     */
+    getVersions(name: string): InstanceFactory[];
+    /**
+     * Check if an instance factory exists
+     */
+    has(name: string, versionRange?: string): boolean;
+    /**
+     * Find instance factories matching query
+     */
+    find(query: QueryOptions): InstanceFactory[];
+    /**
+     * Find instance factories by capability
+     */
+    findByCapability(capability: string): InstanceFactory[];
+    /**
+     * Find instance factories by category
+     */
+    findByCategory(category: InstanceFactory['category']): InstanceFactory[];
+    /**
+     * Get all instance factory names
+     */
+    getNames(): string[];
+    /**
+     * Get total number of instance factories (all versions)
+     */
+    size(): number;
+    /**
+     * Get number of unique instance factories
+     */
+    uniqueCount(): number;
+    /**
+     * Validate an instance factory
+     */
+    validate(factory: InstanceFactory, options?: {
+        specverseVersion?: string;
+        nodeVersion?: string;
+        availableCapabilities?: string[];
+    }): CompatibilityResult;
+    /**
+     * Resolve an instance factory reference
+     *
+     * Supports formats:
+     * - "FastifyPrismaAPI" (latest version)
+     * - "FastifyPrismaAPI@1.0.0" (specific version)
+     * - "FastifyPrismaAPI@^1.0.0" (version range)
+     * - "backend/FastifyPrismaAPI" (with path prefix)
+     * - "@org/impl-types/FastifyPrismaAPI" (npm package style)
+     */
+    resolve(ref: string): InstanceFactory | undefined;
+    /**
+     * Resolve an implementation type by reference and return metadata
+     * Returns the LoadResult which includes filePath for template resolution
+     */
+    resolveWithMetadata(ref: string): LoadResult | undefined;
+    /**
+     * Clear all loaded implementation types
+     */
+    clear(): void;
+    /**
+     * Get statistics about the library
+     */
+    getStats(): {
+        uniqueTypes: number;
+        totalVersions: number;
+        byType: Record<string, number>;
+        byCapability: Record<string, number>;
+    };
+}
+/**
+ * Create a library with default configuration
+ */
+export declare function createDefaultLibrary(projectRoot?: string): Promise<InstanceFactoryLibrary>;
+//# sourceMappingURL=library.d.ts.map

package/dist/realize/library/library.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"library.d.ts","sourceRoot":"","sources":["../../../src/realize/library/library.ts"],"names":[],"mappings":"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"}

package/dist/realize/library/library.js

@@ -0,0 +1,343 @@
+/**
+ * Instance Factory Library
+ *
+ * Manages a collection of instance factories and provides
+ * lookup, filtering, and version resolution.
+ */
+import path from 'path';
+import semver from 'semver';
+import { fileURLToPath } from 'url';
+import { loadInstanceFactories, loadFromMultipleSources } from './loader.js';
+import { InstanceFactoryValidator } from './validator.js';
+/**
+ * Library for managing instance factories
+ */
+export class InstanceFactoryLibrary {
+    types = new Map();
+    validator;
+    sources = [];
+    constructor() {
+        this.validator = new InstanceFactoryValidator();
+    }
+    /**
+     * Load instance factories from a directory
+     */
+    async load(baseDir, options) {
+        const result = await loadInstanceFactories({
+            baseDir,
+            pattern: options?.pattern,
+            validate: options?.validate ?? true,
+            ignoreInvalid: false
+        });
+        // Add to library
+        for (const loadResult of result.types) {
+            const name = loadResult.type.name;
+            const existing = this.types.get(name) || [];
+            existing.push(loadResult);
+            this.types.set(name, existing);
+        }
+        // Sort versions (newest first)
+        for (const [name, versions] of this.types.entries()) {
+            versions.sort((a, b) => semver.rcompare(a.type.version, b.type.version));
+        }
+    }
+    /**
+     * Load from multiple sources with priority ordering
+     */
+    async loadFromSources(sources) {
+        // Sort by priority (highest first)
+        const sortedSources = [...sources].sort((a, b) => (b.priority || 0) - (a.priority || 0));
+        const result = await loadFromMultipleSources(sortedSources.map(s => ({ path: s.path })), { validate: true, ignoreInvalid: false });
+        // Add to library
+        for (const loadResult of result.types) {
+            const name = loadResult.type.name;
+            const existing = this.types.get(name) || [];
+            existing.push(loadResult);
+            this.types.set(name, existing);
+        }
+        // Sort versions (newest first)
+        for (const [name, versions] of this.types.entries()) {
+            versions.sort((a, b) => semver.rcompare(a.type.version, b.type.version));
+        }
+        this.sources = sortedSources;
+    }
+    /**
+     * Load from configuration
+     */
+    async loadFromConfig(config) {
+        await this.loadFromSources(config.sources);
+    }
+    /**
+     * Get an instance factory by name and optional version
+     */
+    get(name, versionRange) {
+        const versions = this.types.get(name);
+        if (!versions || versions.length === 0) {
+            return undefined;
+        }
+        // If no version range specified, return latest
+        if (!versionRange) {
+            return versions[0].type;
+        }
+        // Find first version that satisfies range
+        for (const result of versions) {
+            if (semver.satisfies(result.type.version, versionRange)) {
+                return result.type;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Get all versions of an instance factory
+     */
+    getVersions(name) {
+        const versions = this.types.get(name);
+        return versions ? versions.map(v => v.type) : [];
+    }
+    /**
+     * Check if an instance factory exists
+     */
+    has(name, versionRange) {
+        return this.get(name, versionRange) !== undefined;
+    }
+    /**
+     * Find instance factories matching query
+     */
+    find(query) {
+        const results = [];
+        for (const versions of this.types.values()) {
+            for (const result of versions) {
+                const factory = result.type;
+                // Filter by category
+                if (query.category && factory.category !== query.category) {
+                    continue;
+                }
+                // Filter by version range
+                if (query.version && !semver.satisfies(factory.version, query.version)) {
+                    continue;
+                }
+                // Filter by capability
+                if (query.capability) {
+                    const hasCapability = factory.capabilities.provides.some(cap => {
+                        if (query.capability.includes('*')) {
+                            const pattern = query.capability.replace(/\*/g, '.*');
+                            return new RegExp(`^${pattern}$`).test(cap);
+                        }
+                        return cap === query.capability;
+                    });
+                    if (!hasCapability) {
+                        continue;
+                    }
+                }
+                // Filter by technology stack
+                if (query.technology) {
+                    let matches = true;
+                    if (query.technology.runtime && factory.technology.runtime !== query.technology.runtime) {
+                        matches = false;
+                    }
+                    if (query.technology.language && factory.technology.language !== query.technology.language) {
+                        matches = false;
+                    }
+                    if (query.technology.framework && factory.technology.framework !== query.technology.framework) {
+                        matches = false;
+                    }
+                    if (query.technology.orm && factory.technology.orm !== query.technology.orm) {
+                        matches = false;
+                    }
+                    if (query.technology.validation && factory.technology.validation !== query.technology.validation) {
+                        matches = false;
+                    }
+                    if (!matches) {
+                        continue;
+                    }
+                }
+                // Filter by tags
+                if (query.tags && query.tags.length > 0) {
+                    const factoryTags = factory.metadata?.tags || [];
+                    const hasAllTags = query.tags.every(tag => factoryTags.includes(tag));
+                    if (!hasAllTags) {
+                        continue;
+                    }
+                }
+                results.push(factory);
+            }
+        }
+        return results;
+    }
+    /**
+     * Find instance factories by capability
+     */
+    findByCapability(capability) {
+        return this.find({ capability });
+    }
+    /**
+     * Find instance factories by category
+     */
+    findByCategory(category) {
+        return this.find({ category });
+    }
+    /**
+     * Get all instance factory names
+     */
+    getNames() {
+        return Array.from(this.types.keys());
+    }
+    /**
+     * Get total number of instance factories (all versions)
+     */
+    size() {
+        let count = 0;
+        for (const versions of this.types.values()) {
+            count += versions.length;
+        }
+        return count;
+    }
+    /**
+     * Get number of unique instance factories
+     */
+    uniqueCount() {
+        return this.types.size;
+    }
+    /**
+     * Validate an instance factory
+     */
+    validate(factory, options) {
+        return this.validator.validateComplete(factory, options);
+    }
+    /**
+     * Resolve an instance factory reference
+     *
+     * Supports formats:
+     * - "FastifyPrismaAPI" (latest version)
+     * - "FastifyPrismaAPI@1.0.0" (specific version)
+     * - "FastifyPrismaAPI@^1.0.0" (version range)
+     * - "backend/FastifyPrismaAPI" (with path prefix)
+     * - "@org/impl-types/FastifyPrismaAPI" (npm package style)
+     */
+    resolve(ref) {
+        // Parse reference
+        let name = ref;
+        let versionRange;
+        // Handle @version syntax
+        const atIndex = ref.lastIndexOf('@');
+        if (atIndex > 0) {
+            name = ref.substring(0, atIndex);
+            versionRange = ref.substring(atIndex + 1);
+        }
+        // Handle path prefix (extract last component)
+        if (name.includes('/')) {
+            const parts = name.split('/');
+            name = parts[parts.length - 1];
+        }
+        return this.get(name, versionRange);
+    }
+    /**
+     * Resolve an implementation type by reference and return metadata
+     * Returns the LoadResult which includes filePath for template resolution
+     */
+    resolveWithMetadata(ref) {
+        // Parse reference
+        let name = ref;
+        let versionRange;
+        // Handle @version syntax
+        const atIndex = ref.lastIndexOf('@');
+        if (atIndex > 0) {
+            name = ref.substring(0, atIndex);
+            versionRange = ref.substring(atIndex + 1);
+        }
+        // Handle path prefix (extract last component)
+        if (name.includes('/')) {
+            const parts = name.split('/');
+            name = parts[parts.length - 1];
+        }
+        // Get all versions for this name
+        const versions = this.types.get(name);
+        if (!versions || versions.length === 0) {
+            return undefined;
+        }
+        // If no version specified, return latest
+        if (!versionRange) {
+            return versions[0];
+        }
+        // Find matching version
+        for (const result of versions) {
+            if (semver.satisfies(result.type.version, versionRange)) {
+                return result;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Clear all loaded implementation types
+     */
+    clear() {
+        this.types.clear();
+        this.sources = [];
+    }
+    /**
+     * Get statistics about the library
+     */
+    getStats() {
+        const byType = {};
+        const byCapability = {};
+        for (const versions of this.types.values()) {
+            for (const result of versions) {
+                const factory = result.type;
+                // Count by category
+                byType[factory.category] = (byType[factory.category] || 0) + 1;
+                // Count by capability
+                for (const capability of factory.capabilities.provides) {
+                    byCapability[capability] = (byCapability[capability] || 0) + 1;
+                }
+            }
+        }
+        return {
+            uniqueTypes: this.uniqueCount(),
+            totalVersions: this.size(),
+            byType,
+            byCapability
+        };
+    }
+}
+/**
+ * Create a library with default configuration
+ */
+export async function createDefaultLibrary(projectRoot) {
+    const library = new InstanceFactoryLibrary();
+    // Load from default locations
+    const sources = [];
+    // Project-local library (highest priority)
+    if (projectRoot) {
+        sources.push({
+            type: 'local',
+            path: path.join(projectRoot, 'libs/instance-factories'),
+            priority: 100
+        });
+    }
+    // Global SpecVerse library (lower priority)
+    // Try to find the @specverse/lang package installation
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = path.dirname(__filename);
+    // From dist/realize/library/library.js, go up to the package root (engines/)
+    const packageRoot = path.resolve(__dirname, '../../..');
+    const globalLibPath = path.join(packageRoot, 'libs/instance-factories');
+    sources.push({
+        type: 'local',
+        path: globalLibPath,
+        priority: 50
+    });
+    // Load from sources
+    if (sources.length > 0) {
+        try {
+            await library.loadFromSources(sources);
+        }
+        catch (error) {
+            // Ignore if directories don't exist yet
+            if (error instanceof Error && !error.message.includes('ENOENT')) {
+                throw error;
+            }
+        }
+    }
+    return library;
+}
+//# sourceMappingURL=library.js.map

package/dist/realize/library/library.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"library.js","sourceRoot":"","sources":["../../../src/realize/library/library.ts"],"names":[],"mappings":"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"}

package/dist/realize/library/loader.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Instance Factory Loader
+ *
+ * Loads instance factory definitions from YAML files
+ * and validates them against the JSON Schema.
+ */
+import type { InstanceFactory } from '../types/index.js';
+/**
+ * Load options for instance factories
+ */
+export interface LoadOptions {
+    /** Base directory to search from */
+    baseDir: string;
+    /** Glob pattern to match instance factory files (default: **\/*.yaml) */
+    pattern?: string;
+    /** Whether to validate against schema (default: true) */
+    validate?: boolean;
+    /** Whether to ignore invalid files (default: false) */
+    ignoreInvalid?: boolean;
+}
+/**
+ * Load result for a single instance factory
+ */
+export interface LoadResult {
+    /** The loaded instance factory */
+    type: InstanceFactory;
+    /** Source file path */
+    filePath: string;
+    /** Any warnings during load */
+    warnings?: string[];
+}
+/**
+ * Validation error for an implementation type
+ */
+export interface ValidationError {
+    /** File that failed validation */
+    filePath: string;
+    /** Validation errors */
+    errors: string[];
+}
+/**
+ * Result of loading multiple implementation types
+ */
+export interface LoadManyResult {
+    /** Successfully loaded types */
+    types: LoadResult[];
+    /** Files that failed validation */
+    errors: ValidationError[];
+}
+/**
+ * Load a single instance factory from a YAML file
+ */
+export declare function loadInstanceFactory(filePath: string, options?: {
+    validate?: boolean;
+}): Promise<LoadResult>;
+/**
+ * Load all instance factories from a directory
+ */
+export declare function loadInstanceFactories(options: LoadOptions): Promise<LoadManyResult>;
+/**
+ * Load instance factories from multiple directories
+ *
+ * Directories are searched in order, with earlier directories
+ * taking precedence for duplicate type names.
+ */
+export declare function loadFromMultipleSources(sources: Array<{
+    path: string;
+    pattern?: string;
+}>, options?: {
+    validate?: boolean;
+    ignoreInvalid?: boolean;
+}): Promise<LoadManyResult>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/realize/library/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/realize/library/loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAmCzD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAEhB,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,uDAAuD;IACvD,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,kCAAkC;IAClC,IAAI,EAAE,eAAe,CAAC;IAEtB,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;IAEjB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IAEjB,wBAAwB;IACxB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,KAAK,EAAE,UAAU,EAAE,CAAC;IAEpB,mCAAmC;IACnC,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GACnC,OAAO,CAAC,UAAU,CAAC,CA8CrB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,cAAc,CAAC,CAsCzB;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EAClD,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CAAO,GAC5D,OAAO,CAAC,cAAc,CAAC,CAsCzB"}