@blokjs/runner 0.2.0

package/dist/marketplace/RuntimeCatalog.d.ts

@@ -0,0 +1,174 @@
+/**
+ * RuntimeCatalog - Central Registry for Runtime Packages
+ *
+ * Manages runtime package metadata, search, versioning, and statistics
+ * for the Blok marketplace. Supports publishing, discovery, and filtering
+ * of runtime packages across all supported language runtimes.
+ */
+import type { RuntimeKind } from "../adapters/RuntimeAdapter";
+export interface RuntimeNodeInfo {
+    name: string;
+    description: string;
+    inputs: Record<string, string>;
+    outputs: Record<string, string>;
+}
+export interface RuntimePackageManifest {
+    name: string;
+    version: string;
+    runtime: RuntimeKind;
+    description: string;
+    author: string;
+    license: string;
+    repository?: string;
+    tags: string[];
+    protocols: ("http" | "grpc" | "both")[];
+    dockerImage?: string;
+    minBlokVersion?: string;
+    nodeCount: number;
+    nodes: RuntimeNodeInfo[];
+    createdAt: number;
+    updatedAt: number;
+    downloads: number;
+    rating: number;
+    verified: boolean;
+}
+export interface CatalogSearchOptions {
+    query?: string;
+    runtime?: RuntimeKind;
+    tags?: string[];
+    verified?: boolean;
+    sortBy?: "name" | "downloads" | "rating" | "updated";
+    sortOrder?: "asc" | "desc";
+    limit?: number;
+    offset?: number;
+}
+export interface CatalogSearchResult {
+    packages: RuntimePackageManifest[];
+    total: number;
+    page: number;
+    pageSize: number;
+}
+export interface CatalogStats {
+    totalPackages: number;
+    totalVersions: number;
+    packagesByRuntime: Record<string, number>;
+    totalDownloads: number;
+    verifiedCount: number;
+    averageRating: number;
+}
+export declare class RuntimeCatalog {
+    private packages;
+    constructor();
+    /**
+     * Publish a runtime package to the catalog.
+     *
+     * @param manifest - The package manifest to publish
+     * @throws Error if required fields are missing or invalid
+     */
+    publish(manifest: RuntimePackageManifest): void;
+    /**
+     * Remove a specific version of a package from the catalog.
+     *
+     * @param name - The package name
+     * @param version - The version to remove
+     * @returns true if the version was removed, false if not found
+     */
+    unpublish(name: string, version: string): boolean;
+    /**
+     * Get a package manifest by name and optional version.
+     * Returns the latest version if no version is specified.
+     *
+     * @param name - The package name
+     * @param version - Optional specific version
+     * @returns The manifest if found, undefined otherwise
+     */
+    get(name: string, version?: string): RuntimePackageManifest | undefined;
+    /**
+     * Get all available versions of a package, sorted by semver descending.
+     *
+     * @param name - The package name
+     * @returns Array of version strings sorted by semver (newest first)
+     */
+    getVersions(name: string): string[];
+    /**
+     * Get the latest version of a package by semver ordering.
+     *
+     * @param name - The package name
+     * @returns The latest version string, or undefined if package not found
+     */
+    getLatestVersion(name: string): string | undefined;
+    /**
+     * Search the catalog with filtering, sorting, and pagination.
+     *
+     * @param options - Search and filter options
+     * @returns Paginated search results
+     */
+    search(options: CatalogSearchOptions): CatalogSearchResult;
+    /**
+     * List all latest-version packages for a specific runtime.
+     *
+     * @param runtime - The runtime kind to filter by
+     * @returns Array of matching package manifests
+     */
+    listByRuntime(runtime: RuntimeKind): RuntimePackageManifest[];
+    /**
+     * Get the most popular packages sorted by download count.
+     *
+     * @param limit - Maximum number of results (default 10)
+     * @returns Array of package manifests sorted by downloads descending
+     */
+    getPopular(limit?: number): RuntimePackageManifest[];
+    /**
+     * Get all verified packages.
+     *
+     * @returns Array of verified package manifests
+     */
+    getVerified(): RuntimePackageManifest[];
+    /**
+     * Increment the download counter for a specific package version.
+     *
+     * @param name - The package name
+     * @param version - The package version
+     */
+    incrementDownloads(name: string, version: string): void;
+    /**
+     * Set the rating for a specific package version.
+     *
+     * @param name - The package name
+     * @param version - The package version
+     * @param rating - The rating value (0-5)
+     * @throws Error if rating is out of range
+     */
+    setRating(name: string, version: string, rating: number): void;
+    /**
+     * Get overall catalog statistics.
+     *
+     * @returns Aggregated catalog statistics
+     */
+    getStats(): CatalogStats;
+    /**
+     * Serialize the catalog to a JSON string for persistence.
+     *
+     * @returns JSON string representation of the catalog
+     */
+    toJSON(): string;
+    /**
+     * Deserialize a catalog from a JSON string.
+     *
+     * @param json - The JSON string to parse
+     * @returns A new RuntimeCatalog instance populated with the data
+     */
+    static fromJSON(json: string): RuntimeCatalog;
+    /**
+     * Get the latest version manifest for every package in the catalog.
+     */
+    private getAllLatestPackages;
+    /**
+     * Validate that a manifest has all required fields.
+     */
+    private validateManifest;
+    /**
+     * Compare two semver strings. Returns negative if a < b, 0 if equal, positive if a > b.
+     */
+    private compareSemver;
+}

package/dist/marketplace/RuntimeCatalog.js

@@ -0,0 +1,339 @@
+/**
+ * RuntimeCatalog - Central Registry for Runtime Packages
+ *
+ * Manages runtime package metadata, search, versioning, and statistics
+ * for the Blok marketplace. Supports publishing, discovery, and filtering
+ * of runtime packages across all supported language runtimes.
+ */
+export class RuntimeCatalog {
+    packages;
+    constructor() {
+        this.packages = new Map();
+    }
+    /**
+     * Publish a runtime package to the catalog.
+     *
+     * @param manifest - The package manifest to publish
+     * @throws Error if required fields are missing or invalid
+     */
+    publish(manifest) {
+        this.validateManifest(manifest);
+        let versions = this.packages.get(manifest.name);
+        if (!versions) {
+            versions = new Map();
+            this.packages.set(manifest.name, versions);
+        }
+        versions.set(manifest.version, { ...manifest });
+    }
+    /**
+     * Remove a specific version of a package from the catalog.
+     *
+     * @param name - The package name
+     * @param version - The version to remove
+     * @returns true if the version was removed, false if not found
+     */
+    unpublish(name, version) {
+        const versions = this.packages.get(name);
+        if (!versions)
+            return false;
+        const deleted = versions.delete(version);
+        if (versions.size === 0) {
+            this.packages.delete(name);
+        }
+        return deleted;
+    }
+    /**
+     * Get a package manifest by name and optional version.
+     * Returns the latest version if no version is specified.
+     *
+     * @param name - The package name
+     * @param version - Optional specific version
+     * @returns The manifest if found, undefined otherwise
+     */
+    get(name, version) {
+        const versions = this.packages.get(name);
+        if (!versions)
+            return undefined;
+        if (version) {
+            return versions.get(version);
+        }
+        const latest = this.getLatestVersion(name);
+        if (!latest)
+            return undefined;
+        return versions.get(latest);
+    }
+    /**
+     * Get all available versions of a package, sorted by semver descending.
+     *
+     * @param name - The package name
+     * @returns Array of version strings sorted by semver (newest first)
+     */
+    getVersions(name) {
+        const versions = this.packages.get(name);
+        if (!versions)
+            return [];
+        return Array.from(versions.keys()).sort((a, b) => this.compareSemver(b, a));
+    }
+    /**
+     * Get the latest version of a package by semver ordering.
+     *
+     * @param name - The package name
+     * @returns The latest version string, or undefined if package not found
+     */
+    getLatestVersion(name) {
+        const sorted = this.getVersions(name);
+        return sorted.length > 0 ? sorted[0] : undefined;
+    }
+    /**
+     * Search the catalog with filtering, sorting, and pagination.
+     *
+     * @param options - Search and filter options
+     * @returns Paginated search results
+     */
+    search(options) {
+        const { query, runtime, tags, verified, sortBy = "name", sortOrder = "asc", limit = 20, offset = 0 } = options;
+        let results = this.getAllLatestPackages();
+        // Filter by query (searches name, description, tags, author)
+        if (query) {
+            const lowerQuery = query.toLowerCase();
+            results = results.filter((pkg) => pkg.name.toLowerCase().includes(lowerQuery) ||
+                pkg.description.toLowerCase().includes(lowerQuery) ||
+                pkg.author.toLowerCase().includes(lowerQuery) ||
+                pkg.tags.some((tag) => tag.toLowerCase().includes(lowerQuery)));
+        }
+        // Filter by runtime
+        if (runtime) {
+            results = results.filter((pkg) => pkg.runtime === runtime);
+        }
+        // Filter by tags (package must have all specified tags)
+        if (tags && tags.length > 0) {
+            results = results.filter((pkg) => tags.every((tag) => pkg.tags.some((pkgTag) => pkgTag.toLowerCase() === tag.toLowerCase())));
+        }
+        // Filter by verified status
+        if (verified !== undefined) {
+            results = results.filter((pkg) => pkg.verified === verified);
+        }
+        // Sort results
+        results.sort((a, b) => {
+            let comparison = 0;
+            switch (sortBy) {
+                case "name":
+                    comparison = a.name.localeCompare(b.name);
+                    break;
+                case "downloads":
+                    comparison = a.downloads - b.downloads;
+                    break;
+                case "rating":
+                    comparison = a.rating - b.rating;
+                    break;
+                case "updated":
+                    comparison = a.updatedAt - b.updatedAt;
+                    break;
+            }
+            return sortOrder === "desc" ? -comparison : comparison;
+        });
+        const total = results.length;
+        const pageSize = limit;
+        const page = Math.floor(offset / limit) + 1;
+        const paged = results.slice(offset, offset + limit);
+        return {
+            packages: paged,
+            total,
+            page,
+            pageSize,
+        };
+    }
+    /**
+     * List all latest-version packages for a specific runtime.
+     *
+     * @param runtime - The runtime kind to filter by
+     * @returns Array of matching package manifests
+     */
+    listByRuntime(runtime) {
+        return this.getAllLatestPackages().filter((pkg) => pkg.runtime === runtime);
+    }
+    /**
+     * Get the most popular packages sorted by download count.
+     *
+     * @param limit - Maximum number of results (default 10)
+     * @returns Array of package manifests sorted by downloads descending
+     */
+    getPopular(limit = 10) {
+        return this.getAllLatestPackages()
+            .sort((a, b) => b.downloads - a.downloads)
+            .slice(0, limit);
+    }
+    /**
+     * Get all verified packages.
+     *
+     * @returns Array of verified package manifests
+     */
+    getVerified() {
+        return this.getAllLatestPackages().filter((pkg) => pkg.verified);
+    }
+    /**
+     * Increment the download counter for a specific package version.
+     *
+     * @param name - The package name
+     * @param version - The package version
+     */
+    incrementDownloads(name, version) {
+        const versions = this.packages.get(name);
+        if (!versions)
+            return;
+        const manifest = versions.get(version);
+        if (manifest) {
+            manifest.downloads++;
+        }
+    }
+    /**
+     * Set the rating for a specific package version.
+     *
+     * @param name - The package name
+     * @param version - The package version
+     * @param rating - The rating value (0-5)
+     * @throws Error if rating is out of range
+     */
+    setRating(name, version, rating) {
+        if (rating < 0 || rating > 5) {
+            throw new Error(`Rating must be between 0 and 5, got ${rating}`);
+        }
+        const versions = this.packages.get(name);
+        if (!versions)
+            return;
+        const manifest = versions.get(version);
+        if (manifest) {
+            manifest.rating = rating;
+        }
+    }
+    /**
+     * Get overall catalog statistics.
+     *
+     * @returns Aggregated catalog statistics
+     */
+    getStats() {
+        const allPackages = this.getAllLatestPackages();
+        const packagesByRuntime = {};
+        let totalDownloads = 0;
+        let verifiedCount = 0;
+        let ratingSum = 0;
+        let ratedCount = 0;
+        let totalVersions = 0;
+        for (const [, versions] of this.packages) {
+            totalVersions += versions.size;
+        }
+        for (const pkg of allPackages) {
+            const count = packagesByRuntime[pkg.runtime] || 0;
+            packagesByRuntime[pkg.runtime] = count + 1;
+            totalDownloads += pkg.downloads;
+            if (pkg.verified) {
+                verifiedCount++;
+            }
+            if (pkg.rating > 0) {
+                ratingSum += pkg.rating;
+                ratedCount++;
+            }
+        }
+        return {
+            totalPackages: allPackages.length,
+            totalVersions,
+            packagesByRuntime,
+            totalDownloads,
+            verifiedCount,
+            averageRating: ratedCount > 0 ? ratingSum / ratedCount : 0,
+        };
+    }
+    /**
+     * Serialize the catalog to a JSON string for persistence.
+     *
+     * @returns JSON string representation of the catalog
+     */
+    toJSON() {
+        const data = {};
+        for (const [name, versions] of this.packages) {
+            data[name] = {};
+            for (const [version, manifest] of versions) {
+                data[name][version] = manifest;
+            }
+        }
+        return JSON.stringify(data);
+    }
+    /**
+     * Deserialize a catalog from a JSON string.
+     *
+     * @param json - The JSON string to parse
+     * @returns A new RuntimeCatalog instance populated with the data
+     */
+    static fromJSON(json) {
+        const catalog = new RuntimeCatalog();
+        const data = JSON.parse(json);
+        for (const name of Object.keys(data)) {
+            const versionsMap = new Map();
+            for (const version of Object.keys(data[name])) {
+                versionsMap.set(version, data[name][version]);
+            }
+            catalog.packages.set(name, versionsMap);
+        }
+        return catalog;
+    }
+    /**
+     * Get the latest version manifest for every package in the catalog.
+     */
+    getAllLatestPackages() {
+        const result = [];
+        for (const [name] of this.packages) {
+            const latest = this.get(name);
+            if (latest) {
+                result.push(latest);
+            }
+        }
+        return result;
+    }
+    /**
+     * Validate that a manifest has all required fields.
+     */
+    validateManifest(manifest) {
+        if (!manifest.name || typeof manifest.name !== "string") {
+            throw new Error("Package manifest must have a valid 'name'");
+        }
+        if (!manifest.version || typeof manifest.version !== "string") {
+            throw new Error("Package manifest must have a valid 'version'");
+        }
+        if (!manifest.runtime) {
+            throw new Error("Package manifest must have a valid 'runtime'");
+        }
+        if (!manifest.description || typeof manifest.description !== "string") {
+            throw new Error("Package manifest must have a valid 'description'");
+        }
+        if (!manifest.author || typeof manifest.author !== "string") {
+            throw new Error("Package manifest must have a valid 'author'");
+        }
+        if (!manifest.license || typeof manifest.license !== "string") {
+            throw new Error("Package manifest must have a valid 'license'");
+        }
+        if (!Array.isArray(manifest.tags)) {
+            throw new Error("Package manifest must have a 'tags' array");
+        }
+        if (!Array.isArray(manifest.protocols) || manifest.protocols.length === 0) {
+            throw new Error("Package manifest must have at least one 'protocol'");
+        }
+        if (!Array.isArray(manifest.nodes)) {
+            throw new Error("Package manifest must have a 'nodes' array");
+        }
+    }
+    /**
+     * Compare two semver strings. Returns negative if a < b, 0 if equal, positive if a > b.
+     */
+    compareSemver(a, b) {
+        const partsA = a.split(".").map(Number);
+        const partsB = b.split(".").map(Number);
+        for (let i = 0; i < 3; i++) {
+            const numA = partsA[i] || 0;
+            const numB = partsB[i] || 0;
+            if (numA !== numB)
+                return numA - numB;
+        }
+        return 0;
+    }
+}
+//# sourceMappingURL=RuntimeCatalog.js.map

package/dist/marketplace/RuntimeCatalog.js.map

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

package/dist/marketplace/RuntimeDiscovery.d.ts

@@ -0,0 +1,86 @@
+/**
+ * RuntimeDiscovery - Package Discovery and Resolution Service
+ *
+ * Helps find, resolve, and recommend runtime packages from the catalog.
+ * Provides compatibility checking, semver range resolution, and
+ * intelligent package recommendations for the Blok marketplace.
+ */
+import type { RuntimeRegistry } from "../RuntimeRegistry";
+import type { RuntimeKind } from "../adapters/RuntimeAdapter";
+import type { RuntimePackageManifest } from "./RuntimeCatalog";
+import type { RuntimeCatalog } from "./RuntimeCatalog";
+export interface CompatibilityInfo {
+    compatible: boolean;
+    blokVersionMatch: boolean;
+    runtimeAvailable: boolean;
+    protocolSupported: boolean;
+    warnings: string[];
+}
+export interface DiscoveryResult {
+    package: RuntimePackageManifest;
+    compatibility: CompatibilityInfo;
+    alternatives: RuntimePackageManifest[];
+}
+export interface ResolveOptions {
+    name: string;
+    version?: string;
+    runtime?: RuntimeKind;
+    preferVerified?: boolean;
+}
+export declare class RuntimeDiscovery {
+    private catalog;
+    private registry;
+    constructor(catalog: RuntimeCatalog, registry: RuntimeRegistry);
+    /**
+     * Discover all packages available for a specific runtime.
+     *
+     * @param runtime - The runtime kind to discover packages for
+     * @returns Array of matching package manifests
+     */
+    discover(runtime: RuntimeKind): RuntimePackageManifest[];
+    /**
+     * Resolve a package by name with full compatibility checking.
+     *
+     * @param options - Resolution options including name, version, runtime preference
+     * @returns Discovery result with compatibility info and alternatives, or undefined
+     */
+    resolve(options: ResolveOptions): DiscoveryResult | undefined;
+    /**
+     * Find alternative packages similar to a given package.
+     * Searches by shared tags and runtime kind.
+     *
+     * @param name - The package name to find alternatives for
+     * @param runtime - Optional runtime kind to filter alternatives
+     * @returns Array of alternative package manifests
+     */
+    findAlternatives(name: string, runtime?: RuntimeKind): RuntimePackageManifest[];
+    /**
+     * Check if a package is compatible with the current environment.
+     *
+     * @param manifest - The package manifest to check
+     * @returns Compatibility information with warnings
+     */
+    checkCompatibility(manifest: RuntimePackageManifest): CompatibilityInfo;
+    /**
+     * Recommend packages for a runtime, optionally filtered by tags.
+     * Results are sorted by a composite score of rating and downloads.
+     *
+     * @param runtime - The runtime kind to recommend packages for
+     * @param tags - Optional tags to filter recommendations
+     * @returns Array of recommended package manifests
+     */
+    recommend(runtime: RuntimeKind, tags?: string[]): RuntimePackageManifest[];
+    /**
+     * Resolve a semver range to a specific version available in the catalog.
+     * Supports exact versions, ^ (caret), and ~ (tilde) ranges.
+     *
+     * @param name - The package name
+     * @param range - The semver range string (e.g., "^1.2.0", "~2.0.0", "1.5.3")
+     * @returns The resolved version string, or undefined if no match found
+     */
+    resolveVersion(name: string, range: string): string | undefined;
+    /**
+     * Check if version (major, minor, patch) is >= base version.
+     */
+    private semverGte;
+}