@hashicorp/kits 0.1.0

package/dist/resolution/index.js

@@ -0,0 +1,412 @@
+/**
+ * Primitive resolution module.
+ *
+ * Provides functionality to resolve primitive references from kit manifests
+ * to concrete versions in the shared primitives library.
+ */
+import path from "node:path";
+import { isReferencedPrimitive, isInlinePrimitive, PRIMITIVE_TYPES } from "../core/types.js";
+import { parseReference, ReferenceParseError } from "./reference-parser.js";
+import { resolveVersion } from "./version-resolver.js";
+import { resolveRegistryPrimitivePath } from "./primitive-paths.js";
+import { pathExists, readFile } from "../adapters/file-operations.js";
+export { createPrimitiveKey } from "./types.js";
+// Re-export reference parser
+export { parseReference, formatReference, isValidPrimitiveName, isValidVersionSpec, parseVersionSpec, extractName, extractVersionSpec, ReferenceParseError, } from "./reference-parser.js";
+// Re-export primitives registry
+export { PrimitivesRegistryLoader, PrimitivesRegistryError, createPrimitivesRegistry, loadPrimitivesRegistry, } from "./primitives-registry.js";
+// Re-export version resolver
+export { resolveVersion, findHighestMatching, satisfies, filterSatisfying, describeVersionSpec, specsCouldConflict, findHighestMatchingAll, createVersionResolution, VersionResolutionError, } from "./version-resolver.js";
+// Re-export multi-kit resolver
+export { resolveMultipleKits, deduplicatePrimitives } from "./multi-kit-resolver.js";
+export { extractEnvDefsFromConfig, extractHeaderDefsFromConfig, resolveEnvVars, resolveHeaders, validateCliEnvFlags, resolveEnvVarsFromConfig, mergeEnvDefs, } from "./env-resolver.js";
+/**
+ * Resolves all primitive references in a kit manifest.
+ *
+ * This function processes both referenced primitives (with `ref` syntax)
+ * and inline primitives (with `entrypoint` syntax), resolving references
+ * to concrete versions from the primitives registry.
+ *
+ * @param kit - The kit manifest
+ * @param registry - The primitives registry loader
+ * @param kitBasePath - Base path to the kit directory
+ * @returns Resolution result with resolved primitives and any errors
+ */
+export async function resolvePrimitiveReferences(kit, registry, kitBasePath) {
+    const resolved = [];
+    const errors = [];
+    // Process each primitive type
+    for (const primitiveType of PRIMITIVE_TYPES) {
+        const primitives = kit.primitives[primitiveType];
+        if (!primitives || primitives.length === 0) {
+            continue;
+        }
+        for (const primitive of primitives) {
+            const result = await resolvePrimitive(primitiveType, primitive, registry, kitBasePath, kit.name);
+            if (result.error) {
+                errors.push(result.error);
+            }
+            else if (result.resolved) {
+                resolved.push(result.resolved);
+            }
+        }
+    }
+    return {
+        kit: kit.name,
+        primitives: resolved,
+        errors,
+    };
+}
+/**
+ * Resolves a single primitive declaration.
+ */
+async function resolvePrimitive(type, primitive, registry, kitBasePath, kitName) {
+    if (type === "hooks") {
+        const hookPrimitive = primitive;
+        if (!hookPrimitive.binding) {
+            return {
+                error: {
+                    type: "invalid-hook-binding",
+                    primitive: JSON.stringify(primitive),
+                    message: "Hook primitives must include a binding configuration",
+                },
+            };
+        }
+        const hookResult = isReferencedPrimitive(hookPrimitive)
+            ? await resolveReferencedHook(hookPrimitive.ref, hookPrimitive.binding, registry)
+            : await resolveInlineHook(hookPrimitive, kitBasePath);
+        if (hookResult.resolved) {
+            if (hookPrimitive.instanceName) {
+                hookResult.resolved.instanceName = hookPrimitive.instanceName;
+            }
+            hookResult.resolved.kitName = kitName;
+        }
+        return hookResult;
+    }
+    if (isReferencedPrimitive(primitive)) {
+        const result = await resolveReferencedPrimitive(type, primitive.ref, registry);
+        if (result.resolved && primitive.instanceName) {
+            result.resolved.instanceName = primitive.instanceName;
+        }
+        if (result.resolved) {
+            result.resolved.kitName = kitName;
+        }
+        return result;
+    }
+    if (isInlinePrimitive(primitive)) {
+        const result = await resolveInlinePrimitive(type, primitive, kitBasePath);
+        if (result.resolved && primitive.instanceName) {
+            result.resolved.instanceName = primitive.instanceName;
+        }
+        if (result.resolved) {
+            result.resolved.kitName = kitName;
+        }
+        return result;
+    }
+    // Unknown primitive format
+    return {
+        error: {
+            type: "invalid-reference",
+            primitive: JSON.stringify(primitive),
+            message: "Invalid primitive declaration: must have either 'ref' or 'name' + 'entrypoint'",
+        },
+    };
+}
+/**
+ * Resolves a referenced primitive from the primitives registry.
+ */
+async function resolveReferencedPrimitive(type, ref, registry) {
+    // Parse the reference
+    let parsedRef;
+    try {
+        parsedRef = parseReference(ref);
+    }
+    catch (error) {
+        if (error instanceof ReferenceParseError) {
+            return {
+                error: {
+                    type: "invalid-reference",
+                    primitive: ref,
+                    message: error.message,
+                },
+            };
+        }
+        throw error;
+    }
+    // Look up the primitive in the registry
+    const entry = await registry.getPrimitive(type, parsedRef.name);
+    if (!entry) {
+        return {
+            error: {
+                type: "not-found",
+                primitive: ref,
+                message: `Primitive "${parsedRef.name}" of type "${type}" not found in registry`,
+            },
+        };
+    }
+    // Resolve the version
+    const resolvedEntry = resolveVersion(entry.versions, parsedRef.versionSpec);
+    if (!resolvedEntry) {
+        const availableVersions = entry.versions.map((v) => v.version);
+        return {
+            error: {
+                type: "no-matching-version",
+                primitive: ref,
+                message: `No version matching "${parsedRef.versionSpec}" found for "${parsedRef.name}". Available: ${availableVersions.join(", ")}`,
+                available: availableVersions,
+            },
+        };
+    }
+    // Build the resolved primitive
+    const basePath = path.join(registry.getBasePath(), entry.path, resolvedEntry.path);
+    const sourcePath = await resolveRegistryPrimitivePath(type, parsedRef.name, basePath);
+    return {
+        resolved: {
+            name: parsedRef.name,
+            type,
+            ref,
+            resolvedVersion: resolvedEntry.version,
+            sourcePath,
+            isInline: false,
+            metadata: {
+                description: entry.description,
+                released: resolvedEntry.released,
+                changelog: resolvedEntry.changelog,
+            },
+        },
+    };
+}
+/**
+ * Resolves an inline primitive from the kit directory.
+ */
+async function resolveInlinePrimitive(type, primitive, kitBasePath) {
+    // Resolve the entrypoint path relative to the kit directory
+    const sourcePath = path.resolve(kitBasePath, primitive.entrypoint);
+    // Build metadata object, only including description if defined
+    const metadata = {};
+    if (primitive.description !== undefined) {
+        metadata.description = primitive.description;
+    }
+    return {
+        resolved: {
+            name: primitive.name,
+            type,
+            sourcePath,
+            isInline: true,
+            metadata,
+        },
+    };
+}
+async function resolveReferencedHook(ref, binding, registry) {
+    let parsedRef;
+    try {
+        parsedRef = parseReference(ref);
+    }
+    catch (error) {
+        if (error instanceof ReferenceParseError) {
+            return {
+                error: {
+                    type: "invalid-reference",
+                    primitive: ref,
+                    message: error.message,
+                },
+            };
+        }
+        throw error;
+    }
+    const entry = await registry.getPrimitive("hooks", parsedRef.name);
+    if (!entry) {
+        return {
+            error: {
+                type: "not-found",
+                primitive: ref,
+                message: `Primitive "${parsedRef.name}" of type "hooks" not found in registry`,
+            },
+        };
+    }
+    const resolvedEntry = resolveVersion(entry.versions, parsedRef.versionSpec);
+    if (!resolvedEntry) {
+        const availableVersions = entry.versions.map((v) => v.version);
+        return {
+            error: {
+                type: "no-matching-version",
+                primitive: ref,
+                message: `No version matching "${parsedRef.versionSpec}" found for "${parsedRef.name}". Available: ${availableVersions.join(", ")}`,
+                available: availableVersions,
+            },
+        };
+    }
+    const programDir = path.join(registry.getBasePath(), entry.path, resolvedEntry.path);
+    const configPath = path.join(programDir, "config.json");
+    if (!pathExists(configPath)) {
+        return {
+            error: {
+                type: "invalid-hook-program",
+                primitive: ref,
+                message: `Hook program config.json not found at ${configPath}`,
+            },
+        };
+    }
+    const hookProgram = await loadHookProgramConfig(configPath);
+    if (!hookProgram) {
+        return {
+            error: {
+                type: "invalid-hook-program",
+                primitive: ref,
+                message: `Invalid hook program config at ${configPath}`,
+            },
+        };
+    }
+    const entryPath = path.join(programDir, hookProgram.runtime.entrypoint);
+    if (!pathExists(entryPath)) {
+        return {
+            error: {
+                type: "invalid-hook-program",
+                primitive: ref,
+                message: `Hook program entrypoint not found at ${entryPath}`,
+            },
+        };
+    }
+    return {
+        resolved: {
+            name: parsedRef.name,
+            type: "hooks",
+            ref,
+            resolvedVersion: resolvedEntry.version,
+            sourcePath: configPath,
+            isInline: false,
+            metadata: {
+                description: entry.description,
+                released: resolvedEntry.released,
+                changelog: resolvedEntry.changelog,
+            },
+            hookBinding: binding,
+            hookProgram,
+            hookProgramDir: programDir,
+            hookEntryPath: entryPath,
+        },
+    };
+}
+async function resolveInlineHook(primitive, kitBasePath) {
+    const configPath = path.resolve(kitBasePath, primitive.entrypoint);
+    if (!pathExists(configPath)) {
+        return {
+            error: {
+                type: "invalid-hook-program",
+                primitive: primitive.name,
+                message: `Hook program config.json not found at ${configPath}`,
+            },
+        };
+    }
+    const hookProgram = await loadHookProgramConfig(configPath);
+    if (!hookProgram) {
+        return {
+            error: {
+                type: "invalid-hook-program",
+                primitive: primitive.name,
+                message: `Invalid hook program config at ${configPath}`,
+            },
+        };
+    }
+    const programDir = path.dirname(configPath);
+    const entryPath = path.join(programDir, hookProgram.runtime.entrypoint);
+    if (!pathExists(entryPath)) {
+        return {
+            error: {
+                type: "invalid-hook-program",
+                primitive: primitive.name,
+                message: `Hook program entrypoint not found at ${entryPath}`,
+            },
+        };
+    }
+    const metadata = {};
+    if (hookProgram.description) {
+        metadata.description = hookProgram.description;
+    }
+    return {
+        resolved: {
+            name: primitive.name,
+            type: "hooks",
+            sourcePath: configPath,
+            isInline: true,
+            metadata,
+            hookBinding: primitive.binding,
+            hookProgram,
+            hookProgramDir: programDir,
+            hookEntryPath: entryPath,
+        },
+    };
+}
+async function loadHookProgramConfig(configPath) {
+    try {
+        const content = await readFile(configPath);
+        const parsed = JSON.parse(content);
+        if (!parsed || !parsed.runtime || !parsed.runtime.entrypoint) {
+            return null;
+        }
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Checks if a kit has any referenced primitives (requiring resolution).
+ *
+ * @param kit - The kit manifest
+ * @returns True if the kit has referenced primitives
+ */
+export function hasReferencedPrimitives(kit) {
+    for (const type of PRIMITIVE_TYPES) {
+        const primitives = kit.primitives[type];
+        if (primitives && primitives.some(isReferencedPrimitive)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Counts primitives by resolution type.
+ *
+ * @param kit - The kit manifest
+ * @returns Object with referenced and inline counts
+ */
+export function countPrimitivesByType(kit) {
+    let referenced = 0;
+    let inline = 0;
+    for (const type of PRIMITIVE_TYPES) {
+        const primitives = kit.primitives[type];
+        if (!primitives)
+            continue;
+        for (const p of primitives) {
+            if (isReferencedPrimitive(p)) {
+                referenced++;
+            }
+            else if (isInlinePrimitive(p)) {
+                inline++;
+            }
+        }
+    }
+    return { referenced, inline };
+}
+/**
+ * Extracts all primitive references from a kit.
+ *
+ * @param kit - The kit manifest
+ * @returns Array of reference strings
+ */
+export function extractReferences(kit) {
+    const refs = [];
+    for (const type of PRIMITIVE_TYPES) {
+        const primitives = kit.primitives[type];
+        if (!primitives)
+            continue;
+        for (const p of primitives) {
+            if (isReferencedPrimitive(p)) {
+                refs.push(p.ref);
+            }
+        }
+    }
+    return refs;
+}
+//# sourceMappingURL=index.js.map

package/dist/resolution/index.js.map

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

package/dist/resolution/multi-kit-resolver.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Multi-kit resolver for deduplicating shared primitives.
+ *
+ * When installing multiple kits that reference the same primitives,
+ * this module ensures each shared primitive is resolved once with
+ * the highest compatible version.
+ */
+import type { KitManifest, ResolvedPrimitive, PrimitiveType } from "../core/types.js";
+import type { MultiKitResolutionResult } from "./types.js";
+import { PrimitivesRegistryLoader } from "./primitives-registry.js";
+/**
+ * Resolves primitives across multiple kits, deduplicating shared primitives.
+ *
+ * When multiple kits reference the same primitive:
+ * 1. Collects all version specs for that primitive
+ * 2. Finds the highest version satisfying all specs
+ * 3. Uses that single resolved version for all kits
+ *
+ * @param kits - Array of kit manifests
+ * @param registry - The primitives registry loader
+ * @param kitBasePaths - Map of kit names to their base paths
+ * @returns Multi-kit resolution result with deduplication
+ */
+export declare function resolveMultipleKits(kits: KitManifest[], registry: PrimitivesRegistryLoader, kitBasePaths: Map<string, string>): Promise<MultiKitResolutionResult>;
+/**
+ * Deduplicates primitives by merging identical versions.
+ *
+ * @param primitives - Array of resolved primitives from multiple kits
+ * @returns Deduplicated array with shared primitives merged
+ */
+export declare function deduplicatePrimitives(primitives: ResolvedPrimitive[]): Map<string, ResolvedPrimitive>;
+/**
+ * Analyzes primitive sharing across kits.
+ *
+ * @param kits - Array of kit manifests
+ * @returns Analysis of shared primitives
+ */
+export declare function analyzeSharedPrimitives(kits: KitManifest[]): Map<string, {
+    type: PrimitiveType;
+    name: string;
+    kits: string[];
+}>;
+//# sourceMappingURL=multi-kit-resolver.d.ts.map

package/dist/resolution/multi-kit-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-kit-resolver.d.ts","sourceRoot":"","sources":["../../src/resolution/multi-kit-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtF,OAAO,KAAK,EAAE,wBAAwB,EAAmB,MAAM,YAAY,CAAC;AAG5E,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAapE;;;;;;;;;;;;GAYG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,WAAW,EAAE,EACnB,QAAQ,EAAE,wBAAwB,EAClC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,OAAO,CAAC,wBAAwB,CAAC,CAiEnC;AAiKD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,iBAAiB,EAAE,GAC9B,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAgChC;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,WAAW,EAAE,GAClB,GAAG,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAepE"}