@hashicorp/kits 0.1.0

package/dist/manifest/upgrade-check.js

@@ -0,0 +1,215 @@
+/**
+ * Upgrade checking functionality for installed primitives.
+ *
+ * Compares installed primitive versions against the primitives registry
+ * to identify available updates.
+ */
+import * as semver from "semver";
+import { readManifest } from "./read.js";
+/**
+ * Check for available upgrades for a specific installation scope.
+ *
+ * Convenience function that reads the manifest for the given scope
+ * and checks for available upgrades.
+ *
+ * @param scope - Installation scope (global or project)
+ * @param registry - The primitives registry loader
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ * @returns Array of available upgrade information, empty if no manifest exists
+ */
+export async function checkForUpgradesInScope(scope, registry, projectRoot) {
+    const manifest = await readManifest(scope, projectRoot);
+    if (!manifest) {
+        return [];
+    }
+    return checkForUpgrades(manifest, registry);
+}
+/**
+ * Check for available upgrades across all installed primitives.
+ *
+ * @param manifest - The installation manifest
+ * @param registry - The primitives registry loader
+ * @returns Array of available upgrade information
+ */
+export async function checkForUpgrades(manifest, registry) {
+    const upgrades = [];
+    // Load the registry if not already loaded
+    await registry.load();
+    // Iterate through all harnesses and kits
+    for (const [harnessName, harnessEntry] of Object.entries(manifest.harnesses)) {
+        if (!harnessEntry)
+            continue;
+        for (const [kitName, kit] of Object.entries(harnessEntry.kits)) {
+            // Check each primitive for upgrades
+            for (const primitive of kit.primitives) {
+                // Skip inline primitives - they don't come from the registry
+                if (primitive.isInline)
+                    continue;
+                // Skip primitives without version tracking
+                if (!primitive.versionSpec || !primitive.version)
+                    continue;
+                // Check for available upgrade
+                const upgrade = await checkPrimitiveUpgrade(registry, harnessName, kitName, primitive.name, primitive.type, primitive.version, primitive.versionSpec);
+                if (upgrade) {
+                    upgrades.push(upgrade);
+                }
+            }
+        }
+    }
+    return upgrades;
+}
+/**
+ * Check if a specific primitive has an available upgrade.
+ *
+ * @returns Upgrade info if available, null otherwise
+ */
+async function checkPrimitiveUpgrade(registry, harness, kit, primitiveName, primitiveType, currentVersion, versionSpec) {
+    // Get available versions from registry
+    const versions = await registry.getVersions(primitiveType, primitiveName);
+    if (versions.length === 0) {
+        return null;
+    }
+    // Find the highest version that satisfies the spec
+    const latestMatching = findHighestMatchingVersion(versions.map((v) => v.version), versionSpec);
+    if (!latestMatching) {
+        return null;
+    }
+    // Check if the latest matching version is higher than current
+    if (!semver.valid(currentVersion) || !semver.valid(latestMatching)) {
+        return null;
+    }
+    if (!semver.gt(latestMatching, currentVersion)) {
+        return null;
+    }
+    // Determine if this is a breaking change (major version bump)
+    const currentMajor = semver.major(currentVersion);
+    const newMajor = semver.major(latestMatching);
+    const breaking = newMajor > currentMajor;
+    return {
+        kit,
+        harness,
+        primitive: primitiveName,
+        type: primitiveType,
+        currentVersion,
+        availableVersion: latestMatching,
+        versionSpec,
+        breaking,
+    };
+}
+/**
+ * Find the highest version that satisfies a version spec.
+ */
+function findHighestMatchingVersion(versions, spec) {
+    // Handle "latest" keyword
+    if (spec.toLowerCase() === "latest") {
+        const validVersions = versions.filter((v) => semver.valid(v));
+        if (validVersions.length === 0)
+            return null;
+        return semver.maxSatisfying(validVersions, "*");
+    }
+    // Use semver to find highest matching
+    const validVersions = versions.filter((v) => semver.valid(v));
+    return semver.maxSatisfying(validVersions, spec);
+}
+/**
+ * Create an upgrade summary from upgrade checks.
+ *
+ * @param upgrades - Array of upgrade checks
+ * @returns Summary of available upgrades
+ */
+export function createUpgradeSummary(upgrades) {
+    // Count unique kits
+    const kits = new Set(upgrades.map((u) => u.kit));
+    // Count unique harnesses
+    const harnesses = new Set(upgrades.map((u) => u.harness));
+    // Count breaking changes
+    const breakingChanges = upgrades.filter((u) => u.breaking).length;
+    return {
+        upgrades,
+        totalUpgrades: upgrades.length,
+        breakingChanges,
+        affectedKits: kits.size,
+        affectedHarnesses: harnesses.size,
+    };
+}
+/**
+ * Group upgrades by kit for display purposes.
+ *
+ * @param upgrades - Array of upgrade checks
+ * @returns Map of kit name to upgrades for that kit
+ */
+export function groupUpgradesByKit(upgrades) {
+    const grouped = new Map();
+    for (const upgrade of upgrades) {
+        const key = `${upgrade.kit}:${upgrade.harness}`;
+        const existing = grouped.get(key) || [];
+        existing.push(upgrade);
+        grouped.set(key, existing);
+    }
+    return grouped;
+}
+/**
+ * Group upgrades by harness for display purposes.
+ *
+ * @param upgrades - Array of upgrade checks
+ * @returns Map of harness name to upgrades for that harness
+ */
+export function groupUpgradesByHarness(upgrades) {
+    const grouped = new Map();
+    for (const upgrade of upgrades) {
+        const existing = grouped.get(upgrade.harness) || [];
+        existing.push(upgrade);
+        grouped.set(upgrade.harness, existing);
+    }
+    return grouped;
+}
+/**
+ * Filter upgrades to only include non-breaking changes.
+ *
+ * @param upgrades - Array of upgrade checks
+ * @returns Array of non-breaking upgrades
+ */
+export function filterNonBreaking(upgrades) {
+    return upgrades.filter((u) => !u.breaking);
+}
+/**
+ * Filter upgrades to only include breaking changes.
+ *
+ * @param upgrades - Array of upgrade checks
+ * @returns Array of breaking upgrades
+ */
+export function filterBreaking(upgrades) {
+    return upgrades.filter((u) => u.breaking);
+}
+/**
+ * Format an upgrade for display.
+ *
+ * @param upgrade - The upgrade check
+ * @returns Formatted string describing the upgrade
+ */
+export function formatUpgrade(upgrade) {
+    const changeType = upgrade.breaking ? "major" : getChangeType(upgrade);
+    return `${upgrade.primitive}: ${upgrade.currentVersion} → ${upgrade.availableVersion} (${changeType})`;
+}
+/**
+ * Determine the type of version change (patch, minor, major).
+ */
+function getChangeType(upgrade) {
+    const current = upgrade.currentVersion;
+    const available = upgrade.availableVersion;
+    if (!semver.valid(current) || !semver.valid(available)) {
+        return "unknown";
+    }
+    const currentMajor = semver.major(current);
+    const currentMinor = semver.minor(current);
+    const availableMajor = semver.major(available);
+    const availableMinor = semver.minor(available);
+    if (availableMajor > currentMajor) {
+        return "major";
+    }
+    if (availableMinor > currentMinor) {
+        return "minor";
+    }
+    return "patch";
+}
+//# sourceMappingURL=upgrade-check.js.map

package/dist/manifest/upgrade-check.js.map

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

package/dist/manifest/utils.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Shared utilities for the manifest module.
+ */
+import type { InstallationScope } from "../core/types.js";
+/**
+ * Expand ~ to home directory.
+ *
+ * @param pathStr - Path string that may contain ~
+ * @returns Expanded path string
+ */
+export declare function expandPath(pathStr: string): string;
+/**
+ * Get the manifest file path for a given scope.
+ *
+ * @param scope - Installation scope (global or project)
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ * @returns Absolute path to the manifest file
+ */
+export declare function getManifestPath(scope: InstallationScope, projectRoot?: string): string;
+/**
+ * Get the manifest directory path for a given scope.
+ *
+ * @param scope - Installation scope (global or project)
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ * @returns Absolute path to the manifest directory
+ */
+export declare function getManifestDir(scope: InstallationScope, projectRoot?: string): string;
+/**
+ * Ensure the manifest directory exists for a given scope.
+ *
+ * @param scope - Installation scope (global or project)
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ */
+export declare function ensureManifestDir(scope: InstallationScope, projectRoot?: string): Promise<void>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/manifest/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/manifest/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAO1D;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,iBAAiB,EACxB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAWR;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,iBAAiB,EACxB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAER;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,iBAAiB,EACxB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAGf"}

package/dist/manifest/utils.js

@@ -0,0 +1,57 @@
+/**
+ * Shared utilities for the manifest module.
+ */
+import fs from "node:fs/promises";
+import path from "node:path";
+import { GLOBAL_MANIFEST_PATH, PROJECT_MANIFEST_DIR, PROJECT_MANIFEST_FILENAME, } from "./types.js";
+/**
+ * Expand ~ to home directory.
+ *
+ * @param pathStr - Path string that may contain ~
+ * @returns Expanded path string
+ */
+export function expandPath(pathStr) {
+    if (pathStr.startsWith("~")) {
+        const home = process.env["HOME"] || process.env["USERPROFILE"] || "";
+        return path.join(home, pathStr.slice(1));
+    }
+    return pathStr;
+}
+/**
+ * Get the manifest file path for a given scope.
+ *
+ * @param scope - Installation scope (global or project)
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ * @returns Absolute path to the manifest file
+ */
+export function getManifestPath(scope, projectRoot) {
+    if (scope === "global") {
+        return expandPath(GLOBAL_MANIFEST_PATH);
+    }
+    // Project scope
+    if (!projectRoot) {
+        throw new Error("projectRoot is required for project scope");
+    }
+    return path.join(projectRoot, PROJECT_MANIFEST_DIR, PROJECT_MANIFEST_FILENAME);
+}
+/**
+ * Get the manifest directory path for a given scope.
+ *
+ * @param scope - Installation scope (global or project)
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ * @returns Absolute path to the manifest directory
+ */
+export function getManifestDir(scope, projectRoot) {
+    return path.dirname(getManifestPath(scope, projectRoot));
+}
+/**
+ * Ensure the manifest directory exists for a given scope.
+ *
+ * @param scope - Installation scope (global or project)
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ */
+export async function ensureManifestDir(scope, projectRoot) {
+    const manifestDir = getManifestDir(scope, projectRoot);
+    await fs.mkdir(manifestDir, { recursive: true });
+}
+//# sourceMappingURL=utils.js.map

package/dist/manifest/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/manifest/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AAEpB;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;QACrE,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAwB,EACxB,WAAoB;IAEpB,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvB,OAAO,UAAU,CAAC,oBAAoB,CAAC,CAAC;IAC1C,CAAC;IAED,gBAAgB;IAChB,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,oBAAoB,EAAE,yBAAyB,CAAC,CAAC;AACjF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAwB,EACxB,WAAoB;IAEpB,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAAwB,EACxB,WAAoB;IAEpB,MAAM,WAAW,GAAG,cAAc,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IACvD,MAAM,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACnD,CAAC"}

package/dist/manifest/write.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Manifest write operations.
+ *
+ * Provides functionality to write and update the installation manifest.
+ */
+import type { InstallationScope } from "../core/types.js";
+import type { InstallationManifest } from "./types.js";
+/**
+ * Error thrown when manifest write fails.
+ */
+export declare class ManifestWriteError extends Error {
+    readonly errorCause?: unknown;
+    constructor(message: string, cause?: unknown);
+}
+/**
+ * Write the installation manifest to disk.
+ *
+ * Creates the manifest directory if it doesn't exist.
+ * Updates the lastUpdated timestamp automatically.
+ * Ensures the scope field matches the write location.
+ *
+ * @param manifest - The manifest to write
+ * @param scope - Installation scope (global or project), defaults to manifest.scope
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ * @throws ManifestWriteError if writing fails
+ */
+export declare function writeManifest(manifest: InstallationManifest, scope?: InstallationScope, projectRoot?: string): Promise<void>;
+/**
+ * Get the expanded manifest path for a given scope.
+ *
+ * @param scope - Installation scope (global or project), defaults to global
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ * @returns The absolute path to the manifest file
+ */
+export declare function getManifestPathForScope(scope?: InstallationScope, projectRoot?: string): string;
+/**
+ * Get the manifest directory path for a given scope.
+ *
+ * @param scope - Installation scope (global or project), defaults to global
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ * @returns The absolute path to the manifest directory
+ */
+export declare function getManifestDirForScope(scope?: InstallationScope, projectRoot?: string): string;
+//# sourceMappingURL=write.d.ts.map

package/dist/manifest/write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/manifest/write.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGvD;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;gBAElB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAK7C;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,oBAAoB,EAC9B,KAAK,CAAC,EAAE,iBAAiB,EACzB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CA+Bf;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,GAAE,iBAA4B,EACnC,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,GAAE,iBAA4B,EACnC,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAER"}

package/dist/manifest/write.js

@@ -0,0 +1,77 @@
+/**
+ * Manifest write operations.
+ *
+ * Provides functionality to write and update the installation manifest.
+ */
+import fs from "node:fs/promises";
+import { getManifestPath, getManifestDir, ensureManifestDir } from "./utils.js";
+/**
+ * Error thrown when manifest write fails.
+ */
+export class ManifestWriteError extends Error {
+    errorCause;
+    constructor(message, cause) {
+        super(message);
+        this.name = "ManifestWriteError";
+        this.errorCause = cause;
+    }
+}
+/**
+ * Write the installation manifest to disk.
+ *
+ * Creates the manifest directory if it doesn't exist.
+ * Updates the lastUpdated timestamp automatically.
+ * Ensures the scope field matches the write location.
+ *
+ * @param manifest - The manifest to write
+ * @param scope - Installation scope (global or project), defaults to manifest.scope
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ * @throws ManifestWriteError if writing fails
+ */
+export async function writeManifest(manifest, scope, projectRoot) {
+    // Use provided scope or fall back to manifest's scope
+    const effectiveScope = scope ?? manifest.scope;
+    const manifestPath = getManifestPath(effectiveScope, projectRoot);
+    try {
+        // Ensure directory exists
+        await ensureManifestDir(effectiveScope, projectRoot);
+        // Update timestamp
+        manifest.lastUpdated = new Date().toISOString();
+        // Ensure scope field is set correctly
+        manifest.scope = effectiveScope;
+        // Set or clear projectRoot based on scope
+        if (effectiveScope === "project" && projectRoot) {
+            manifest.projectRoot = projectRoot;
+        }
+        else if (effectiveScope === "global") {
+            delete manifest.projectRoot;
+        }
+        // Write manifest with pretty formatting
+        const content = JSON.stringify(manifest, null, 2);
+        await fs.writeFile(manifestPath, content, "utf-8");
+    }
+    catch (error) {
+        throw new ManifestWriteError(`Failed to write manifest to ${manifestPath}`, error);
+    }
+}
+/**
+ * Get the expanded manifest path for a given scope.
+ *
+ * @param scope - Installation scope (global or project), defaults to global
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ * @returns The absolute path to the manifest file
+ */
+export function getManifestPathForScope(scope = "global", projectRoot) {
+    return getManifestPath(scope, projectRoot);
+}
+/**
+ * Get the manifest directory path for a given scope.
+ *
+ * @param scope - Installation scope (global or project), defaults to global
+ * @param projectRoot - Absolute path to project root (required for project scope)
+ * @returns The absolute path to the manifest directory
+ */
+export function getManifestDirForScope(scope = "global", projectRoot) {
+    return getManifestDir(scope, projectRoot);
+}
+//# sourceMappingURL=write.js.map

package/dist/manifest/write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.js","sourceRoot":"","sources":["../../src/manifest/write.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAIlC,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEhF;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,UAAU,CAAW;IAE9B,YAAY,OAAe,EAAE,KAAe;QAC1C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;IAC1B,CAAC;CACF;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAA8B,EAC9B,KAAyB,EACzB,WAAoB;IAEpB,sDAAsD;IACtD,MAAM,cAAc,GAAG,KAAK,IAAI,QAAQ,CAAC,KAAK,CAAC;IAC/C,MAAM,YAAY,GAAG,eAAe,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;IAElE,IAAI,CAAC;QACH,0BAA0B;QAC1B,MAAM,iBAAiB,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;QAErD,mBAAmB;QACnB,QAAQ,CAAC,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAEhD,sCAAsC;QACtC,QAAQ,CAAC,KAAK,GAAG,cAAc,CAAC;QAEhC,0CAA0C;QAC1C,IAAI,cAAc,KAAK,SAAS,IAAI,WAAW,EAAE,CAAC;YAChD,QAAQ,CAAC,WAAW,GAAG,WAAW,CAAC;QACrC,CAAC;aAAM,IAAI,cAAc,KAAK,QAAQ,EAAE,CAAC;YACvC,OAAO,QAAQ,CAAC,WAAW,CAAC;QAC9B,CAAC;QAED,wCAAwC;QACxC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAClD,MAAM,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,kBAAkB,CAC1B,+BAA+B,YAAY,EAAE,EAC7C,KAAK,CACN,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CACrC,QAA2B,QAAQ,EACnC,WAAoB;IAEpB,OAAO,eAAe,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CACpC,QAA2B,QAAQ,EACnC,WAAoB;IAEpB,OAAO,cAAc,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;AAC5C,CAAC"}

package/dist/resolution/env-resolver.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Environment variable resolution module.
+ *
+ * Resolves MCP server environment variable definitions to concrete values,
+ * handling sensitivity classification and multiple value sources.
+ *
+ * See PRD-001 FR-20, FR-21 for requirements.
+ */
+import type { McpServerConfig, McpEnvVarDefinition, McpHeaderDefinition, ResolvedHeader, EnvVarResolutionResult } from "../core/types.js";
+/**
+ * CLI --env flag values parsed from KEY=VALUE format.
+ */
+export interface CliEnvFlags {
+    [key: string]: string;
+}
+/**
+ * Extract environment variable definitions from MCP server config.
+ *
+ * @param config - The MCP server configuration
+ * @returns Record of env var names to definitions
+ */
+export declare function extractEnvDefsFromConfig(config: McpServerConfig): Record<string, McpEnvVarDefinition>;
+/**
+ * Extract header definitions from HTTP transport config.
+ *
+ * @param config - The MCP server configuration
+ * @returns Record of header names to definitions
+ */
+export declare function extractHeaderDefsFromConfig(config: McpServerConfig): Record<string, McpHeaderDefinition>;
+/**
+ * Resolve environment variable definitions to values.
+ *
+ * Resolution priority:
+ * 1. Sensitive vars: Always passthrough (never resolve value)
+ * 2. CLI --env flags: For nonsensitive vars only
+ * 3. process.env: Current environment value
+ * 4. Default value: If specified for nonsensitive var
+ * 5. Passthrough: If no value resolved
+ *
+ * @param serverName - Name of the MCP server (for result tracking)
+ * @param envDefs - Environment variable definitions from config
+ * @param cliEnvFlags - Values from CLI --env flags
+ * @returns Resolution result with resolved vars, missing required, and warnings
+ */
+export declare function resolveEnvVars(serverName: string, envDefs: Record<string, McpEnvVarDefinition>, cliEnvFlags?: CliEnvFlags): EnvVarResolutionResult;
+/**
+ * Resolve header definitions to values.
+ *
+ * @param headerDefs - Header definitions from HTTP transport config
+ * @returns Array of resolved headers
+ */
+export declare function resolveHeaders(headerDefs: Record<string, McpHeaderDefinition>): ResolvedHeader[];
+/**
+ * Validate that --env flags don't include sensitive variables.
+ *
+ * @param cliEnvFlags - Values from CLI --env flags
+ * @param envDefs - Environment variable definitions from config
+ * @returns List of invalid flag names (sensitive vars that were provided)
+ */
+export declare function validateCliEnvFlags(cliEnvFlags: CliEnvFlags, envDefs: Record<string, McpEnvVarDefinition>): string[];
+/**
+ * Resolve all environment variables for an MCP server config.
+ *
+ * This is a convenience function that combines extraction and resolution.
+ *
+ * @param serverName - Name of the MCP server
+ * @param config - The MCP server configuration
+ * @param cliEnvFlags - Values from CLI --env flags
+ * @returns Complete resolution result including env vars and headers
+ */
+export declare function resolveEnvVarsFromConfig(serverName: string, config: McpServerConfig, cliEnvFlags?: CliEnvFlags): EnvVarResolutionResult;
+/**
+ * Merge multiple env var definitions from different MCP servers.
+ *
+ * Used when validating CLI flags against all MCP servers in a kit.
+ *
+ * @param configs - Array of MCP server configurations
+ * @returns Merged record of all env var definitions
+ */
+export declare function mergeEnvDefs(configs: McpServerConfig[]): Record<string, McpEnvVarDefinition>;
+//# sourceMappingURL=env-resolver.d.ts.map

package/dist/resolution/env-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-resolver.d.ts","sourceRoot":"","sources":["../../src/resolution/env-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EAEnB,cAAc,EACd,sBAAsB,EAEvB,MAAM,kBAAkB,CAAC;AAE1B;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,eAAe,GACtB,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAErC;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,eAAe,GACtB,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAKrC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,EAC5C,WAAW,GAAE,WAAgB,GAC5B,sBAAsB,CAiFxB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,GAC9C,cAAc,EAAE,CAmClB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,GAC3C,MAAM,EAAE,CAWV;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,eAAe,EACvB,WAAW,GAAE,WAAgB,GAC5B,sBAAsB,CAQxB;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,eAAe,EAAE,GACzB,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CA8BrC"}