@vibesdotdev/config 0.0.1

package/src/loader/index.server.ts

@@ -0,0 +1,389 @@
+/**
+ * Config File Loader
+ *
+ * Multi-source config loading system with priority-based merging.
+ *
+ * Loading order (lowest to highest priority):
+ * 1. Defaults (schema defaults)
+ * 2. Global: ~/.vibes/{namespace}.{ts,js,json,jsonc,yaml}
+ * 3. Local: ./.vibes/{namespace}.{ts,js,json,jsonc,yaml}
+ * 4. Project: ./vibes.{namespace}.{ts,js,json,jsonc,yaml}
+ * 5. Storage: localdb/json adapter (user edits)
+ *
+ * @example
+ * ```ts
+ * import { loadConfigFromManifest } from '../loader';
+ *
+ * const result = await loadConfigFromManifest({
+ *   manifest: autoloopManifest,
+ *   includeStorage: true,
+ *   includeDefaults: true,
+ * });
+ *
+ * console.log(result.data); // Merged config
+ * console.log(result.sources); // All sources checked
+ * console.log(result.mergedSources); // Sources that contributed
+ * ```
+ */
+
+import type { z } from 'zod/v4';
+import {
+	type ConfigFileFormat,
+	type ConfigFileScope,
+	type ConfigPriority,
+	type ConfigLoadResult,
+	type DiscoveredConfigFile,
+	type DiscoveryOptions,
+	type LoadOptions,
+	type LoadedConfigSource,
+	CONFIG_PRIORITIES
+} from './types.ts';
+import { discoverConfigFiles, detectFormat, getAllSearchPaths, getVibesDir } from './discovery.ts';
+import { loadConfigFile, loadConfigFromPath } from './file-loader.ts';
+import {
+	deepMerge,
+	mergeConfigSources,
+	mergeRecordConfigs,
+	mergeConfigSourcesWithValidation,
+	mergeRecordConfigsWithValidation,
+	createDefaultsSource,
+	createStorageSource,
+	type ValidatedMergeResult
+} from './merge.ts';
+import {
+	validateGracefully,
+	validateFieldsGracefully,
+	validateRecordsGracefully,
+	formatValidationIssues,
+	type FieldValidationIssue,
+	type FieldValidationResult,
+	type RecordValidationResult
+} from './validation.ts';
+import type { ConfigManifest, ConfigFileLocation } from '../manifest/types.ts';
+import { resolveDefaults } from '../form/core/field-resolver.ts';
+
+// Re-export types
+export type {
+	ConfigFileFormat,
+	ConfigFileScope,
+	ConfigPriority,
+	ConfigLoadResult,
+	DiscoveredConfigFile,
+	DiscoveryOptions,
+	LoadOptions,
+	LoadedConfigSource
+};
+
+// Re-export utilities
+export {
+	CONFIG_PRIORITIES,
+	discoverConfigFiles,
+	detectFormat,
+	getAllSearchPaths,
+	getVibesDir,
+	loadConfigFile,
+	loadConfigFromPath,
+	deepMerge,
+	mergeConfigSources,
+	mergeRecordConfigs,
+	mergeConfigSourcesWithValidation,
+	mergeRecordConfigsWithValidation,
+	createDefaultsSource,
+	createStorageSource,
+	// Validation utilities
+	validateGracefully,
+	validateFieldsGracefully,
+	validateRecordsGracefully,
+	formatValidationIssues
+};
+
+// Re-export validation types
+export type {
+	FieldValidationIssue,
+	FieldValidationResult,
+	RecordValidationResult,
+	ValidatedMergeResult
+};
+
+/**
+ * Get namespace from manifest
+ */
+function getNamespaceFromManifest(manifest: ConfigManifest): string {
+	// Use storage namespace or derive from manifest ID
+	if (manifest.storage?.namespace) {
+		return manifest.storage.namespace;
+	}
+	// Extract namespace from dotted manifest ID (e.g., 'foo.bar' -> 'bar')
+	const parts = manifest.id.split('.');
+	return parts[parts.length - 1];
+}
+
+/**
+ * Get config file location from manifest
+ */
+function getConfigFileLocation(manifest: ConfigManifest): ConfigFileLocation | undefined {
+	if (!manifest.configFiles) return undefined;
+
+	// Handle array of locations (use first one)
+	if (Array.isArray(manifest.configFiles)) {
+		return manifest.configFiles[0];
+	}
+
+	return manifest.configFiles;
+}
+
+/**
+ * Load config from all sources for a manifest
+ *
+ * This is the main entry point for the config loader.
+ * It discovers files, loads them, merges with storage/defaults,
+ * and returns the final config.
+ */
+export async function loadConfigFromManifest<T = unknown>(
+	options: LoadOptions<T>
+): Promise<ConfigLoadResult<T>> {
+	const {
+		manifest,
+		cwd = process.cwd(),
+		includeStorage = true,
+		includeDefaults = true,
+		defaults,
+		storageAdapter
+	} = options;
+
+	const namespace = getNamespaceFromManifest(manifest);
+	const configFileLocation = getConfigFileLocation(manifest);
+	const sources: LoadedConfigSource<T>[] = [];
+	const mergedSources: LoadedConfigSource<T>[] = [];
+
+	// 1. Add defaults (lowest priority)
+	if (includeDefaults) {
+		const defaultValues =
+			defaults ??
+			(resolveDefaults(manifest, {
+				hardware: 'consumer',
+				environment: 'development',
+				surface: 'cli',
+				isAuthenticated: false,
+				enabledFeatures: new Set(),
+				get: () => undefined,
+				custom: {}
+			}) as T);
+
+		if (defaultValues && Object.keys(defaultValues as object).length > 0) {
+			const defaultSource = createDefaultsSource<T>(defaultValues);
+			sources.push(defaultSource);
+			mergedSources.push(defaultSource);
+		}
+	}
+
+	// 2. Discover and load config files
+	const discoveryOptions: DiscoveryOptions = {
+		namespace,
+		scopes: ['global', 'local', 'project'],
+		cwd
+	};
+
+	// Add custom patterns from manifest
+	if (configFileLocation?.pattern) {
+		discoveryOptions.patterns = [configFileLocation.pattern];
+	}
+	if (configFileLocation?.fallbackPatterns) {
+		discoveryOptions.fallbackPatterns = configFileLocation.fallbackPatterns;
+	}
+
+	const discoveredFiles = await discoverConfigFiles(discoveryOptions);
+
+	// Load each discovered file
+	for (const file of discoveredFiles) {
+		const loaded = await loadConfigFile<T>(file, configFileLocation);
+		sources.push(loaded);
+		if (loaded.loaded) {
+			mergedSources.push(loaded);
+		}
+	}
+
+	// 3. Load from storage adapter (highest priority for user edits)
+	let storageData: T | null = null;
+	if (includeStorage && storageAdapter) {
+		try {
+			storageData = await storageAdapter.load();
+			const storageSource = createStorageSource<T>(storageData);
+			if (storageSource) {
+				sources.push(storageSource);
+				mergedSources.push(storageSource);
+			}
+		} catch (error) {
+			// Log but don't fail - storage errors shouldn't block config loading
+			console.warn(`[ConfigLoader] Failed to load from storage: ${error}`);
+		}
+	}
+
+	// 4. Merge all sources (with optional per-field validation)
+	let data: T;
+	let validationIssues: Map<string, { path: (string | number)[]; message: string }[]> | undefined;
+
+	if (options.validateGracefully && manifest.schema) {
+		// Use validated merging - invalid fields are discarded per-source
+		// Cast schema to match the generic type (manifest provides schema for its type T)
+		const schema = manifest.schema as z.ZodType<T & Record<string, unknown>>;
+		const result = mergeConfigSourcesWithValidation<T & Record<string, unknown>>(
+			mergedSources as LoadedConfigSource<T & Record<string, unknown>>[],
+			schema,
+			{ logIssues: false }
+		);
+		data = result.data as T;
+
+		// Report validation issues
+		if (result.hasIssues && options.onValidationIssues) {
+			for (const [source, issues] of result.issues) {
+				options.onValidationIssues(source, issues);
+			}
+		}
+		validationIssues = result.issues;
+	} else {
+		// Standard merge (no per-field validation)
+		data = mergeConfigSources<T & Record<string, unknown>>(
+			mergedSources as LoadedConfigSource<T & Record<string, unknown>>[]
+		) as T;
+	}
+
+	return {
+		data,
+		sources,
+		mergedSources,
+		hasFileSources: discoveredFiles.length > 0,
+		hasStorageData: storageData !== null,
+		validationIssues
+	};
+}
+
+/**
+ * Load config for a record-type manifest
+ *
+ * Handles merging of record arrays/objects by ID.
+ */
+export async function loadRecordConfigFromManifest<T extends { id: string }>(
+	options: LoadOptions<Record<string, T>>
+): Promise<ConfigLoadResult<Record<string, T>>> {
+	const {
+		manifest,
+		cwd = process.cwd(),
+		includeStorage = true,
+		includeDefaults = true,
+		defaults,
+		storageAdapter
+	} = options;
+
+	const namespace = getNamespaceFromManifest(manifest);
+	const configFileLocation = getConfigFileLocation(manifest);
+	const sources: LoadedConfigSource<Record<string, T> | T[]>[] = [];
+	const mergedSources: LoadedConfigSource<Record<string, T> | T[]>[] = [];
+
+	// 1. Add defaults
+	if (includeDefaults && defaults) {
+		const defaultSource = createDefaultsSource<Record<string, T>>(defaults);
+		sources.push(defaultSource);
+		mergedSources.push(defaultSource);
+	}
+
+	// 2. Discover and load config files
+	const discoveryOptions: DiscoveryOptions = {
+		namespace,
+		scopes: ['global', 'local', 'project'],
+		cwd
+	};
+
+	if (configFileLocation?.pattern) {
+		discoveryOptions.patterns = [configFileLocation.pattern];
+	}
+	if (configFileLocation?.fallbackPatterns) {
+		discoveryOptions.fallbackPatterns = configFileLocation.fallbackPatterns;
+	}
+
+	const discoveredFiles = await discoverConfigFiles(discoveryOptions);
+
+	for (const file of discoveredFiles) {
+		const loaded = await loadConfigFile<Record<string, T> | T[]>(file, configFileLocation);
+		sources.push(loaded);
+		if (loaded.loaded) {
+			mergedSources.push(loaded);
+		}
+	}
+
+	// 3. Load from storage
+	let storageData: Record<string, T> | null = null;
+	if (includeStorage && storageAdapter) {
+		try {
+			storageData = await storageAdapter.load();
+			if (storageData) {
+				const storageSource = createStorageSource<Record<string, T>>(storageData);
+				if (storageSource) {
+					sources.push(storageSource);
+					mergedSources.push(storageSource);
+				}
+			}
+		} catch (error) {
+			console.warn(`[ConfigLoader] Failed to load from storage: ${error}`);
+		}
+	}
+
+	// 4. Merge records by ID
+	const data = mergeRecordConfigs<T>(mergedSources);
+
+	return {
+		data,
+		sources: sources as LoadedConfigSource<Record<string, T>>[],
+		mergedSources: mergedSources as LoadedConfigSource<Record<string, T>>[],
+		hasFileSources: discoveredFiles.length > 0,
+		hasStorageData: storageData !== null
+	};
+}
+
+/**
+ * Quick check if any config files exist for a namespace
+ */
+export async function hasConfigFiles(
+	namespace: string,
+	cwd: string = process.cwd()
+): Promise<boolean> {
+	const files = await discoverConfigFiles({ namespace, cwd });
+	return files.length > 0;
+}
+
+/**
+ * Get debug info about config loading for a manifest
+ */
+export async function getConfigLoadDebugInfo(
+	manifest: ConfigManifest,
+	cwd: string = process.cwd()
+): Promise<{
+	namespace: string;
+	searchPaths: string[];
+	foundFiles: string[];
+	configFileLocation?: ConfigFileLocation;
+}> {
+	const namespace = getNamespaceFromManifest(manifest);
+	const configFileLocation = getConfigFileLocation(manifest);
+	const searchPaths = await getAllSearchPaths(namespace, ['global', 'local', 'project'], cwd);
+
+	const discoveryOptions: DiscoveryOptions = {
+		namespace,
+		scopes: ['global', 'local', 'project'],
+		cwd
+	};
+
+	if (configFileLocation?.pattern) {
+		discoveryOptions.patterns = [configFileLocation.pattern];
+		searchPaths.push(configFileLocation.pattern);
+	}
+
+	const discoveredFiles = await discoverConfigFiles(discoveryOptions);
+
+	return {
+		namespace,
+		searchPaths,
+		foundFiles: discoveredFiles.map((f) => f.path),
+		configFileLocation
+	};
+}

package/src/loader/index.ts

@@ -0,0 +1,18 @@
+/**
+ * Client-safe config loader exports.
+ *
+ * Server-only loader lives in ./index.server.ts.
+ */
+
+export { loadConfigFromManifest, loadRecordConfigFromManifest } from './client.ts';
+export { CONFIG_PRIORITIES } from './types.ts';
+export type {
+	ConfigFileFormat,
+	ConfigFileScope,
+	ConfigPriority,
+	ConfigLoadResult,
+	DiscoveredConfigFile,
+	DiscoveryOptions,
+	LoadOptions,
+	LoadedConfigSource
+} from './types.ts';