@happyvertical/smrt-config 0.53.3 → 0.53.5

package/dist/index.js

@@ -1,5 +1,262 @@
 import { cosmiconfig } from "cosmiconfig";
 import { createJiti } from "jiti";
+//#region src/ai.ts
+var AI_PROVIDER_KEY_ENV = Object.freeze({
+	openai: "OPENAI_API_KEY",
+	anthropic: "ANTHROPIC_API_KEY",
+	gemini: "GEMINI_API_KEY"
+});
+var AUTO_DETECT_ORDER = [
+	"openai",
+	"anthropic",
+	"gemini"
+];
+var DEFAULT_AI_ENV_PREFIXES = Object.freeze(["SMRT_AI", "HAVE_AI"]);
+function getDefaultAIKeyEnvName(provider) {
+	const normalized = nonEmpty(provider)?.toLowerCase();
+	return normalized && Object.hasOwn(AI_PROVIDER_KEY_ENV, normalized) ? AI_PROVIDER_KEY_ENV[normalized] : void 0;
+}
+var AIProviderNotConfiguredError = class extends Error {
+	code = "SMRT_AI_NOT_CONFIGURED";
+	constructor(message) {
+		super(message);
+		this.name = "AIProviderNotConfiguredError";
+	}
+};
+function nonEmpty(value) {
+	return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
+}
+function redactBaseUrl(value) {
+	if (!value) return void 0;
+	try {
+		const url = new URL(value);
+		return `${url.protocol}//${url.host}`;
+	} catch {
+		return "[unparseable-url]";
+	}
+}
+function tryResolveAIProviderConfig(options = {}) {
+	const env = options.env ?? process.env;
+	const read = (name) => nonEmpty(env[name]);
+	const prefixes = options.prefixes ?? DEFAULT_AI_ENV_PREFIXES;
+	const explicit = options.explicit ?? {};
+	const block = options.config ?? {};
+	const fromEnv = (suffix) => prefixes.map((prefix) => ({
+		source: `env:${prefix}_${suffix}`,
+		value: read(`${prefix}_${suffix}`)
+	}));
+	const explicitCand = (value) => ({
+		source: "explicit",
+		value: nonEmpty(value)
+	});
+	const configCand = (value) => ({
+		source: "config",
+		value: nonEmpty(value)
+	});
+	const layered = (exp, cfg, envs) => options.envOverridesConfig ? [
+		...exp,
+		...envs,
+		...cfg
+	] : [
+		...exp,
+		...cfg,
+		...envs
+	];
+	const first = (candidates) => {
+		for (const c of candidates) if (c.value) return {
+			value: c.value,
+			source: c.source
+		};
+	};
+	const sources = {};
+	const result = {};
+	const set = (field, hit) => {
+		if (hit) {
+			result[field] = hit.value;
+			sources[field] = hit.source;
+		}
+	};
+	set("provider", first(layered([explicitCand(nonEmpty(explicit.provider) ?? nonEmpty(explicit.type))], [configCand(block.provider)], fromEnv("PROVIDER"))));
+	set("model", first(layered([explicitCand(nonEmpty(explicit.model) ?? nonEmpty(explicit.defaultModel))], [configCand(block.model)], fromEnv("MODEL"))));
+	const autoDetected = result.provider || options.autoDetect === false ? void 0 : AUTO_DETECT_ORDER.find((p) => read(AI_PROVIDER_KEY_ENV[p]));
+	if (autoDetected) {
+		result.provider = autoDetected;
+		sources.provider = "auto-detect";
+	}
+	const selected = result.provider?.toLowerCase();
+	const configKeyEnv = nonEmpty(block.apiKeyEnv);
+	const explicitGroup = {
+		source: "explicit",
+		provider: nonEmpty(explicit.provider) ?? nonEmpty(explicit.type),
+		apiKey: nonEmpty(explicit.apiKey),
+		baseUrl: nonEmpty(explicit.baseUrl)
+	};
+	const configGroup = {
+		source: "config",
+		provider: nonEmpty(block.provider),
+		apiKey: nonEmpty(block.apiKey) ?? (configKeyEnv ? read(configKeyEnv) : void 0),
+		baseUrl: nonEmpty(block.baseUrl)
+	};
+	const envGroups = prefixes.map((prefix) => ({
+		source: `env:${prefix}`,
+		provider: read(`${prefix}_PROVIDER`),
+		apiKey: read(`${prefix}_API_KEY`),
+		baseUrl: read(`${prefix}_BASE_URL`)
+	}));
+	const groups = options.envOverridesConfig ? [
+		explicitGroup,
+		...envGroups,
+		configGroup
+	] : [
+		explicitGroup,
+		configGroup,
+		...envGroups
+	];
+	const usable = (g) => !g.provider || g.provider.toLowerCase() === selected;
+	const sourceName = (g, suffix) => g.source.startsWith("env:") ? `${g.source}_${suffix}` : g.source;
+	for (const g of groups) {
+		if (!usable(g)) continue;
+		if (g.baseUrl && !result.baseUrl) {
+			result.baseUrl = g.baseUrl;
+			sources.baseUrl = sourceName(g, "BASE_URL");
+		}
+		if (g.apiKey && !result.apiKey) {
+			result.apiKey = g.apiKey;
+			sources.apiKey = sourceName(g, "API_KEY");
+		}
+	}
+	const providerKeyEnv = getDefaultAIKeyEnvName(result.provider);
+	if (!result.apiKey && providerKeyEnv && options.providerKeyEnvFallback !== false && read(providerKeyEnv)) {
+		result.apiKey = read(providerKeyEnv);
+		sources.apiKey = "provider-key-env";
+	}
+	if (!result.provider && (options.requireProvider ?? true)) return;
+	if (!result.provider && !result.apiKey) return;
+	const resolved = {
+		...result,
+		sources,
+		toJSON: () => describeAIProviderConfig(resolved)
+	};
+	Object.defineProperty(resolved, "toJSON", { enumerable: false });
+	return resolved;
+}
+function resolveAIProviderConfig(options = {}) {
+	const resolved = tryResolveAIProviderConfig(options);
+	if (resolved) return resolved;
+	const envNames = (options.prefixes ?? DEFAULT_AI_ENV_PREFIXES).map((p) => `${p}_PROVIDER`).join(", ");
+	const keyNames = Object.values(AI_PROVIDER_KEY_ENV).join(", ");
+	throw new AIProviderNotConfiguredError(`No AI provider is configured. Set the \`ai\` block in smrt.config.ts (provider, model, apiKeyEnv), or set ${envNames}` + (options.autoDetect === false ? "." : `, or one of ${keyNames} to auto-detect the provider.`));
+}
+function describeAIProviderConfig(resolved) {
+	return {
+		provider: resolved.provider,
+		model: resolved.model,
+		baseUrl: redactBaseUrl(resolved.baseUrl),
+		apiKey: resolved.apiKey ? "[redacted]" : void 0,
+		sources: { ...resolved.sources }
+	};
+}
+function toAIClientOptions(resolved) {
+	const out = {};
+	if (resolved.provider) {
+		out.type = resolved.provider;
+		out.provider = resolved.provider;
+	}
+	if (resolved.apiKey) out.apiKey = resolved.apiKey;
+	if (resolved.baseUrl) out.baseUrl = resolved.baseUrl;
+	if (resolved.model) out.defaultModel = resolved.model;
+	return out;
+}
+var OWNED_AI_FIELDS = [
+	"apiKey",
+	"apiKeyEnv",
+	"baseUrl",
+	"model"
+];
+function canonicalizeAIConfig(input) {
+	if (!input || typeof input !== "object") return {};
+	const out = {};
+	for (const [key, value] of Object.entries(input)) {
+		if (key === "__proto__" || key === "constructor" || key === "prototype") continue;
+		if (typeof value === "string" && value.trim().length === 0) continue;
+		out[key] = value;
+	}
+	const provider = nonEmpty(out.provider) ?? nonEmpty(out.type);
+	const model = nonEmpty(out.model) ?? nonEmpty(out.defaultModel);
+	delete out.type;
+	delete out.defaultModel;
+	if (provider) out.provider = provider;
+	else delete out.provider;
+	if (model) out.model = model;
+	else delete out.model;
+	return out;
+}
+function mergeAIConfigObjects(lower, higher) {
+	const low = canonicalizeAIConfig(lower);
+	const high = canonicalizeAIConfig(higher);
+	const lowName = nonEmpty(low.provider)?.toLowerCase();
+	const highName = nonEmpty(high.provider)?.toLowerCase();
+	if (lowName && highName && lowName !== highName) {
+		delete low.provider;
+		for (const f of OWNED_AI_FIELDS) delete low[f];
+	}
+	return {
+		...low,
+		...high
+	};
+}
+function withAIAliases(config) {
+	const out = { ...config };
+	const provider = nonEmpty(out.provider) ?? nonEmpty(out.type);
+	const model = nonEmpty(out.model) ?? nonEmpty(out.defaultModel);
+	for (const k of ["provider", "type"]) if (provider) out[k] = provider;
+	else delete out[k];
+	for (const k of ["model", "defaultModel"]) if (model) out[k] = model;
+	else delete out[k];
+	return out;
+}
+//#endregion
+//#region src/database-environment.ts
+var POSTGRES_URL = /^postgres(?:ql)?:\/\//i;
+function environmentType(value) {
+	const normalized = value?.trim().toLowerCase();
+	if (!normalized) return null;
+	if (normalized === "sqlite") return "sqlite";
+	if (normalized === "postgres" || normalized === "postgresql") return "postgres";
+	throw new TypeError("DATABASE_TYPE must be sqlite or postgres.");
+}
+function resolveCliDatabase(declared, env) {
+	if (typeof declared?.url === "string" && declared.url !== "") return {
+		source: "config",
+		database: typeof declared.type === "string" ? {
+			type: declared.type,
+			url: declared.url
+		} : { url: declared.url }
+	};
+	const url = env.DATABASE_URL?.trim();
+	if (!url) return {
+		source: "none",
+		database: null
+	};
+	let type;
+	try {
+		type = declared?.type === "sqlite" || declared?.type === "postgres" ? declared.type : environmentType(env.DATABASE_TYPE) ?? (POSTGRES_URL.test(url) ? "postgres" : "sqlite");
+	} catch (error) {
+		return {
+			source: "invalid-environment",
+			database: null,
+			error: error.message
+		};
+	}
+	return {
+		source: "environment",
+		database: {
+			type,
+			url
+		}
+	};
+}
+//#endregion
 //#region src/loader.ts
 var MODULE_NAME = "smrt";
 var jitiInstance;
@@ -569,6 +826,7 @@ function deepMerge(target, source) {
 }
 function setConfig$1(config) {
 	const incomingRuntime = Object.hasOwn(config, "runtime") ? config.runtime : void 0;
+	if (incomingRuntime !== void 0 && (incomingRuntime === null || typeof incomingRuntime !== "object" || Array.isArray(incomingRuntime))) throw new RuntimeProfileValidationError([...validateApplicationRuntimeConfigShape(incomingRuntime)]);
 	if (incomingRuntime !== null && (typeof incomingRuntime === "object" || typeof incomingRuntime === "function") && Object.hasOwn(incomingRuntime, "profile")) {
 		const profileIssues = validateApplicationRuntimeConfigShape(incomingRuntime).filter((issue) => issue.path === "runtime" || issue.path === "profile");
 		if (profileIssues.length > 0) throw new RuntimeProfileValidationError([...profileIssues]);
@@ -581,7 +839,12 @@ function setConfig$1(config) {
 		const resetRuntime = current.runtime;
 		delete resetRuntime.providers;
 	}
-	globalThis.__smrtRuntimeConfig = deepMerge(current, config);
+	const merged = deepMerge(current, config);
+	const aiOf = (c) => isPlainObject(c) && isPlainObject(c.ai) ? c.ai : void 0;
+	const pkgAiOf = (c) => isPlainObject(c) && isPlainObject(c.packages) && isPlainObject(c.packages.ai) ? c.packages.ai : void 0;
+	if (aiOf(config)) merged.ai = mergeAIConfigObjects(aiOf(current) ?? {}, aiOf(config));
+	if (pkgAiOf(config)) merged.packages.ai = mergeAIConfigObjects(pkgAiOf(current) ?? {}, pkgAiOf(config));
+	globalThis.__smrtRuntimeConfig = merged;
 }
 function getRuntimeConfig() {
 	return globalThis.__smrtRuntimeConfig || {};
@@ -714,7 +977,8 @@ function mergeExportedConfig(baseConfig, exportedConfig) {
 	const result = { ...baseConfig };
 	for (const [key, value] of Object.entries(exportedConfig)) {
 		if (key === "__proto__" || key === "constructor" || key === "prototype") continue;
-		if (value !== null && typeof value === "object" && !Array.isArray(value) && result[key] !== null && typeof result[key] === "object" && !Array.isArray(result[key])) result[key] = mergeExportedConfig(result[key], value);
+		if (key === "ai" && value !== null && typeof value === "object" && !Array.isArray(value) && result[key] !== null && typeof result[key] === "object" && !Array.isArray(result[key])) result[key] = mergeAIConfigObjects(result[key], value);
+		else if (value !== null && typeof value === "object" && !Array.isArray(value) && result[key] !== null && typeof result[key] === "object" && !Array.isArray(result[key])) result[key] = mergeExportedConfig(result[key], value);
 		else result[key] = value;
 	}
 	return result;
@@ -737,7 +1001,16 @@ function getConfig() {
 	return getLoadedConfig();
 }
 function resolveConfiguredApplicationRuntime() {
-	const loadedConfig = getLoadedConfig();
+	return resolveRuntimeLayers(getLoadedConfig());
+}
+function resolveEffectiveApplicationRuntime(config) {
+	if (!declaresRuntime(config ?? null) && !declaresRuntime(getRuntimeConfig())) return resolveApplicationRuntime({ profile: "local" });
+	return resolveRuntimeLayers(config ?? null);
+}
+function declaresRuntime(layer) {
+	return layer !== null && Object.hasOwn(layer, "runtime") && layer.runtime !== void 0;
+}
+function resolveRuntimeLayers(loadedConfig) {
 	const runtimeConfig = getRuntimeConfig();
 	const fileRuntime = loadedConfig && Object.hasOwn(loadedConfig, "runtime") ? loadedConfig.runtime : void 0;
 	const runtimeOverride = Object.hasOwn(runtimeConfig, "runtime") ? runtimeConfig.runtime : void 0;
@@ -764,6 +1037,10 @@ function getModuleConfig(moduleName, defaults) {
 	const runtimeModuleConfig = runtime.modules?.[moduleName] || {};
 	return mergeConfigs(mergeConfigs(mergeConfigs(defaults || {}, globalConfig, {}), moduleConfig, {}), runtimeModuleConfig, {});
 }
+function resolveCliDatabaseConfig(env = process.env) {
+	const declared = getPackageConfig("cli").database;
+	return resolveCliDatabase(declared, env);
+}
 function getPackageConfig(packageName, defaults) {
 	const fileConfig = getLoadedConfig() || {};
 	const runtime = getRuntimeConfig();
@@ -783,7 +1060,65 @@ function clearCache() {
 function defineConfig(config) {
 	return config;
 }
+function getAIConfigBlock() {
+	const file = getLoadedConfig();
+	const runtime = getRuntimeConfig();
+	return mergeAIConfigLayers([
+		file?.packages?.ai,
+		file?.ai,
+		runtime.packages?.ai,
+		runtime.ai
+	]);
+}
+function mergeAIConfigLayers(layers) {
+	const FIELDS = [
+		"model",
+		"baseUrl",
+		"apiKeyEnv",
+		"apiKey"
+	];
+	let provider;
+	const values = {};
+	const owners = {};
+	const text = (v) => typeof v === "string" && v.trim() ? v.trim() : void 0;
+	for (const layer of layers) {
+		if (!layer || typeof layer !== "object") continue;
+		const rec = layer;
+		const named = text(rec.provider) ?? text(rec.type);
+		if (named && provider && named.toLowerCase() !== provider.toLowerCase()) for (const f of FIELDS) {
+			const owner = owners[f];
+			if (owner && owner.toLowerCase() !== named.toLowerCase()) {
+				delete values[f];
+				delete owners[f];
+			}
+		}
+		if (named) provider = named;
+		for (const f of FIELDS) {
+			const v = f === "model" ? text(rec.model) ?? text(rec.defaultModel) : text(rec[f]);
+			if (v) {
+				values[f] = v;
+				owners[f] = provider;
+			}
+		}
+	}
+	if (!provider && FIELDS.every((f) => !values[f])) return null;
+	const merged = { ...values };
+	if (provider) merged.provider = provider;
+	return merged;
+}
+function resolveConfiguredAIProvider(options = {}) {
+	return resolveAIProviderConfig({
+		...options,
+		config: options.config === void 0 ? getAIConfigBlock() : options.config
+	});
+}
+function tryResolveConfiguredAIProvider(options = {}) {
+	return tryResolveAIProviderConfig({
+		...options,
+		config: options.config === void 0 ? getAIConfigBlock() : options.config
+	});
+}
 //#endregion
-export { RuntimeProfileValidationError, clearCache, clearRuntimeConfig, defineConfig, exportConfig, getApplicationRuntimePreset, getConfig, getModuleConfig, getPackageConfig, getRuntimeConfig, getSiteConfig, loadConfig, mergeConfigs, mergeExportedConfig, parseExportedConfig, resolveApplicationRuntime, resolveConfiguredApplicationRuntime, sanitizeConfig, setConfig };
+export { AIProviderNotConfiguredError, AI_PROVIDER_KEY_ENV, DEFAULT_AI_ENV_PREFIXES, RuntimeProfileValidationError, canonicalizeAIConfig, clearCache, clearRuntimeConfig, defineConfig, describeAIProviderConfig, exportConfig, getAIConfigBlock, getApplicationRuntimePreset, getConfig, getDefaultAIKeyEnvName, getModuleConfig, getPackageConfig, getRuntimeConfig, getSiteConfig, loadConfig, mergeAIConfigLayers, mergeAIConfigObjects, mergeConfigs, mergeExportedConfig, parseExportedConfig, redactBaseUrl, resolveAIProviderConfig, resolveApplicationRuntime, resolveCliDatabaseConfig, resolveConfiguredAIProvider, resolveConfiguredApplicationRuntime, resolveEffectiveApplicationRuntime, sanitizeConfig, setConfig, toAIClientOptions, tryResolveAIProviderConfig, tryResolveConfiguredAIProvider, withAIAliases };
 
 //# sourceMappingURL=index.js.map