@lucent-lang/lucent 0.0.4 → 0.1.0

package/dist/sdk-usage-ljX5bTuZ.js

@@ -0,0 +1,95 @@
+import { $ as sdkSchemaEntry, H as displayName, U as symbolKey, X as sdkAvailable, Z as sdkModuleArtifacts, s as sdkModule, z as compareArtifacts } from "./src-DlICbK91.js";
+import fs from "node:fs";
+import path from "node:path";
+//#region src/cli/sdk-usage.ts
+const PLATFORMS = ["ios", "android"];
+function sdkUnavailable(platform, sdk) {
+	if (sdkAvailable(platform, sdk)) return void 0;
+	const why = sdkModule(platform, platform === "ios" ? "Foundation" : "android.os", sdk);
+	return "missing" in why ? why.missing : `no ${platform} SDK`;
+}
+const LOCK_FILE = "lucent-sdk.lock.json";
+const USAGE_FILE = ".lucent/sdk-usage.json";
+function usedModule(platform, module, sdk) {
+	const artifacts = sdkModuleArtifacts(platform, module, sdk);
+	if (!artifacts.length) return void 0;
+	const schema = sdkSchemaEntry(platform, module, sdk);
+	return {
+		artifacts: artifacts.map((a) => `${a.id}#${a.contentHash}`).sort(),
+		...schema ? { schema } : {}
+	};
+}
+function usedModules(modules, sdk) {
+	const out = {};
+	for (const key of [...new Set(modules)].sort()) {
+		const [platform, module] = key.split("/");
+		const used = usedModule(platform, module, sdk);
+		if (used) out[key] = used;
+	}
+	return out;
+}
+function sdkUsage(symbols, targets, imports, sdk) {
+	return {
+		format: 1,
+		targets: [...targets].sort(),
+		modules: usedModules([...imports, ...symbols.map((s) => `${s.platform}/${s.module}`)], sdk),
+		symbols
+	};
+}
+function readUsage(file) {
+	if (!fs.existsSync(file)) return void 0;
+	let value;
+	try {
+		value = JSON.parse(fs.readFileSync(file, "utf8"));
+	} catch (e) {
+		throw new Error(`${path.basename(file)} is not valid JSON: ${e.message}`, { cause: e });
+	}
+	if (value.format !== 1) throw new Error(`${path.basename(file)} has format ${value.format ?? "none"}; this Lucent reads format 1: run lucent sdk lock again`);
+	if (!Array.isArray(value.targets) || !value.modules || !Array.isArray(value.symbols)) throw new Error(`${path.basename(file)} is incomplete: run lucent sdk lock again`);
+	const unknown = [
+		...value.targets,
+		...Object.keys(value.modules).map((k) => k.split("/")[0]),
+		...value.symbols.map((s) => s.platform)
+	].filter((p) => !PLATFORMS.includes(p));
+	if (unknown.length) throw new Error(`${path.basename(file)}: unknown target ${[...new Set(unknown)].join(", ")}`);
+	return value;
+}
+function usageReadable(file) {
+	try {
+		return readUsage(file) !== void 0;
+	} catch {
+		return false;
+	}
+}
+function writeUsage(file, usage) {
+	const tmp = `${file}.${process.pid}.tmp`;
+	fs.mkdirSync(path.dirname(file), { recursive: true });
+	fs.writeFileSync(tmp, `${JSON.stringify(usage, null, 2)}\n`);
+	fs.renameSync(tmp, file);
+}
+function artifactText(c) {
+	if (!c.locked) return "not in the lock";
+	const gone = c.locked.filter((a) => !c.found.includes(a));
+	const added = c.found.filter((a) => !c.locked.includes(a));
+	return `${gone.join(", ") || "-"} → ${added.join(", ") || "-"}`;
+}
+function lockProblems(lock, found, symbols = []) {
+	const problems = compareArtifacts(lock.modules, found).map((c) => `lucent:${c.module}: ${artifactText(c)}`);
+	const locked = new Set(lock.symbols.map(symbolKey));
+	const unlocked = symbols.filter((s) => !locked.has(symbolKey(s)));
+	if (unlocked.length) {
+		const names = unlocked.slice(0, 3).map(displayName).join(", ");
+		const more = unlocked.length > 3 ? ` and ${unlocked.length - 3} more` : "";
+		problems.push(`${unlocked.length} SDK symbol${unlocked.length === 1 ? " the code uses is" : "s the code uses are"} not in ${LOCK_FILE}: ${names}${more}`);
+	}
+	return problems;
+}
+function frozenFailure(problems) {
+	return [
+		`the SDKs or SDK symbols differ from ${LOCK_FILE}:`,
+		...problems.map((p) => `  ${p}`),
+		"lucent sdk diff shows what the installed SDKs change for the app; lucent sdk lock records them"
+	].join("\n");
+}
+//#endregion
+export { lockProblems as a, sdkUsage as c, writeUsage as d, frozenFailure as i, usageReadable as l, USAGE_FILE as n, readUsage as o, artifactText as r, sdkUnavailable as s, LOCK_FILE as t, usedModules as u };