everything-dev 0.3.2 → 1.3.2

package/dist/dev-logs.mjs

@@ -0,0 +1,51 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { appendFile, mkdir, readFile, writeFile } from "node:fs/promises";
+
+//#region src/dev-logs.ts
+function getBosDir(configDir) {
+	return join(configDir, ".bos");
+}
+function getLogsDir(configDir) {
+	return join(getBosDir(configDir), "logs");
+}
+function formatLogLine(entry) {
+	const ts = new Date(entry.timestamp).toISOString();
+	const prefix = entry.isError ? "ERR" : "OUT";
+	return `[${ts}] [${entry.source}] [${prefix}] ${entry.line}`;
+}
+async function createDevLogger(configDir, description) {
+	const dir = getLogsDir(configDir);
+	if (!existsSync(dir)) await mkdir(dir, { recursive: true });
+	const now = /* @__PURE__ */ new Date();
+	const logFile = join(dir, `dev-${now.toISOString().replace(/[:.]/g, "-").slice(0, 19)}.log`);
+	const latestFile = join(dir, "dev-latest.log");
+	const header = `# everything-dev dev session: ${description}\n# Started: ${now.toISOString()}\n\n`;
+	await writeFile(logFile, header, "utf8");
+	await writeFile(latestFile, header, "utf8");
+	let chain = Promise.resolve();
+	const enqueue = (fn) => {
+		chain = chain.then(fn, fn);
+		return chain;
+	};
+	return {
+		logFile,
+		latestFile,
+		write: (entry) => enqueue(async () => {
+			const line = `${formatLogLine(entry)}\n`;
+			await appendFile(logFile, line);
+			await appendFile(latestFile, line);
+		}),
+		readLatest: async (opts) => {
+			const text = await readFile(latestFile, "utf8").catch(() => "");
+			const tail = opts?.tail;
+			if (!tail || tail <= 0) return text;
+			const lines = text.split("\n");
+			return lines.slice(Math.max(0, lines.length - tail)).join("\n");
+		}
+	};
+}
+
+//#endregion
+export { createDevLogger, getBosDir };
+//# sourceMappingURL=dev-logs.mjs.map

package/dist/dev-logs.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-logs.mjs","names":[],"sources":["../src/dev-logs.ts"],"sourcesContent":["import { existsSync } from \"node:fs\";\nimport { appendFile, mkdir, readFile, writeFile } from \"node:fs/promises\";\nimport { join } from \"node:path\";\n\nexport interface LogEntry {\n  timestamp: number;\n  source: string;\n  line: string;\n  isError?: boolean;\n}\n\nexport interface DevLogger {\n  logFile: string;\n  latestFile: string;\n  write: (entry: LogEntry) => Promise<void>;\n  readLatest: (opts?: { tail?: number }) => Promise<string>;\n}\n\nexport function getBosDir(configDir: string): string {\n  return join(configDir, \".bos\");\n}\n\nexport function getLogsDir(configDir: string): string {\n  return join(getBosDir(configDir), \"logs\");\n}\n\nfunction formatLogLine(entry: LogEntry): string {\n  const ts = new Date(entry.timestamp).toISOString();\n  const prefix = entry.isError ? \"ERR\" : \"OUT\";\n  return `[${ts}] [${entry.source}] [${prefix}] ${entry.line}`;\n}\n\nexport async function createDevLogger(configDir: string, description: string): Promise<DevLogger> {\n  const dir = getLogsDir(configDir);\n  if (!existsSync(dir)) {\n    await mkdir(dir, { recursive: true });\n  }\n\n  const now = new Date();\n  const ts = now.toISOString().replace(/[:.]/g, \"-\").slice(0, 19);\n  const logFile = join(dir, `dev-${ts}.log`);\n  const latestFile = join(dir, \"dev-latest.log\");\n\n  const header =\n    `# everything-dev dev session: ${description}\\n` + `# Started: ${now.toISOString()}\\n\\n`;\n  // Overwrite each run so dev-latest.log is always actionable.\n  await writeFile(logFile, header, \"utf8\");\n  await writeFile(latestFile, header, \"utf8\");\n\n  let chain = Promise.resolve();\n  const enqueue = (fn: () => Promise<void>) => {\n    chain = chain.then(fn, fn);\n    return chain;\n  };\n\n  return {\n    logFile,\n    latestFile,\n    write: (entry) =>\n      enqueue(async () => {\n        const line = `${formatLogLine(entry)}\\n`;\n        await appendFile(logFile, line);\n        await appendFile(latestFile, line);\n      }),\n    readLatest: async (opts) => {\n      const text = await readFile(latestFile, \"utf8\").catch(() => \"\");\n      const tail = opts?.tail;\n      if (!tail || tail <= 0) return text;\n      const lines = text.split(\"\\n\");\n      return lines.slice(Math.max(0, lines.length - tail)).join(\"\\n\");\n    },\n  };\n}\n\nexport async function readDevLatestLog(\n  configDir: string,\n  opts?: { tail?: number },\n): Promise<string> {\n  const latestFile = join(getLogsDir(configDir), \"dev-latest.log\");\n  const text = await readFile(latestFile, \"utf8\").catch(() => \"\");\n  const tail = opts?.tail;\n  if (!tail || tail <= 0) return text;\n  const lines = text.split(\"\\n\");\n  return lines.slice(Math.max(0, lines.length - tail)).join(\"\\n\");\n}\n"],"mappings":";;;;;AAkBA,SAAgB,UAAU,WAA2B;AACnD,QAAO,KAAK,WAAW,OAAO;;AAGhC,SAAgB,WAAW,WAA2B;AACpD,QAAO,KAAK,UAAU,UAAU,EAAE,OAAO;;AAG3C,SAAS,cAAc,OAAyB;CAC9C,MAAM,KAAK,IAAI,KAAK,MAAM,UAAU,CAAC,aAAa;CAClD,MAAM,SAAS,MAAM,UAAU,QAAQ;AACvC,QAAO,IAAI,GAAG,KAAK,MAAM,OAAO,KAAK,OAAO,IAAI,MAAM;;AAGxD,eAAsB,gBAAgB,WAAmB,aAAyC;CAChG,MAAM,MAAM,WAAW,UAAU;AACjC,KAAI,CAAC,WAAW,IAAI,CAClB,OAAM,MAAM,KAAK,EAAE,WAAW,MAAM,CAAC;CAGvC,MAAM,sBAAM,IAAI,MAAM;CAEtB,MAAM,UAAU,KAAK,KAAK,OADf,IAAI,aAAa,CAAC,QAAQ,SAAS,IAAI,CAAC,MAAM,GAAG,GAAG,CAC3B,MAAM;CAC1C,MAAM,aAAa,KAAK,KAAK,iBAAiB;CAE9C,MAAM,SACJ,iCAAiC,YAAY,eAAoB,IAAI,aAAa,CAAC;AAErF,OAAM,UAAU,SAAS,QAAQ,OAAO;AACxC,OAAM,UAAU,YAAY,QAAQ,OAAO;CAE3C,IAAI,QAAQ,QAAQ,SAAS;CAC7B,MAAM,WAAW,OAA4B;AAC3C,UAAQ,MAAM,KAAK,IAAI,GAAG;AAC1B,SAAO;;AAGT,QAAO;EACL;EACA;EACA,QAAQ,UACN,QAAQ,YAAY;GAClB,MAAM,OAAO,GAAG,cAAc,MAAM,CAAC;AACrC,SAAM,WAAW,SAAS,KAAK;AAC/B,SAAM,WAAW,YAAY,KAAK;IAClC;EACJ,YAAY,OAAO,SAAS;GAC1B,MAAM,OAAO,MAAM,SAAS,YAAY,OAAO,CAAC,YAAY,GAAG;GAC/D,MAAM,OAAO,MAAM;AACnB,OAAI,CAAC,QAAQ,QAAQ,EAAG,QAAO;GAC/B,MAAM,QAAQ,KAAK,MAAM,KAAK;AAC9B,UAAO,MAAM,MAAM,KAAK,IAAI,GAAG,MAAM,SAAS,KAAK,CAAC,CAAC,KAAK,KAAK;;EAElE"}

package/dist/dev-session.cjs

@@ -0,0 +1,195 @@
+const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
+const require_config = require('./config.cjs');
+const require_orchestrator = require('./orchestrator.cjs');
+const require_dev_view = require('./components/dev-view.cjs');
+const require_streaming_view = require('./components/streaming-view.cjs');
+const require_dev_logs = require('./dev-logs.cjs');
+const require_process_registry = require('./process-registry.cjs');
+let effect = require("effect");
+
+//#region src/dev-session.ts
+const LOG_NOISE_PATTERNS = [
+	/\[ Federation Runtime \] Version .* from (host|ui) of shared singleton module/,
+	/Executing an Effect versioned \d+\.\d+\.\d+ with a Runtime of version/,
+	/you may want to dedupe the effect dependencies/
+];
+const SSR_LOG_ALLOWLIST = [
+	/\bready\s+built in\b/i,
+	/\bcompiled\b.*successfully/i,
+	/\berror\b/i,
+	/\bfailed\b/i,
+	/\bexception\b/i
+];
+const shouldDisplayLog = (source, line, isError) => {
+	if (process.env.DEBUG === "true" || process.env.DEBUG === "1") return true;
+	if (source === "ui-ssr") {
+		if (isError) return true;
+		return SSR_LOG_ALLOWLIST.some((pattern) => pattern.test(line));
+	}
+	return !LOG_NOISE_PATTERNS.some((pattern) => pattern.test(line));
+};
+const isInteractiveSupported = () => {
+	return process.stdin.isTTY === true && process.stdout.isTTY === true;
+};
+const STARTUP_ORDER = [
+	"ui-ssr",
+	"ui",
+	"api",
+	"plugin",
+	"host-build",
+	"host"
+];
+const sortByOrder = (packages) => {
+	return [...packages].sort((a, b) => {
+		const aIdx = a.startsWith("plugin:") ? STARTUP_ORDER.indexOf("plugin") : STARTUP_ORDER.indexOf(a);
+		const bIdx = b.startsWith("plugin:") ? STARTUP_ORDER.indexOf("plugin") : STARTUP_ORDER.indexOf(b);
+		if (aIdx === -1 && bIdx === -1) return 0;
+		if (aIdx === -1) return 1;
+		if (bIdx === -1) return -1;
+		return aIdx - bIdx;
+	});
+};
+function formatLogLine(entry) {
+	const ts = new Date(entry.timestamp).toISOString();
+	const prefix = entry.isError ? "ERR" : "OUT";
+	return `[${ts}] [${entry.source}] [${prefix}] ${entry.line}`;
+}
+const runDevSession = (orchestrator, onCleanupReady) => effect.Effect.gen(function* () {
+	const configDir = require_config.getProjectRoot();
+	const orderedPackages = sortByOrder(orchestrator.packages);
+	const initialProcesses = orderedPackages.map((pkg) => {
+		const config = require_orchestrator.getProcessConfig(pkg, void 0, pkg === "host" ? orchestrator.port : void 0, orchestrator.bosConfig, orchestrator.runtimeConfig);
+		const source = pkg === "host" ? orchestrator.appConfig.host : pkg === "ui" ? orchestrator.appConfig.ui : pkg === "api" ? orchestrator.appConfig.api : void 0;
+		return {
+			name: pkg,
+			status: "pending",
+			port: config?.port ?? 0,
+			source
+		};
+	});
+	const registry = yield* require_process_registry.makeProcessRegistry(configDir);
+	yield* registry.killAll().pipe(effect.Effect.ignore);
+	const logger = yield* effect.Effect.promise(() => require_dev_logs.createDevLogger(configDir, orchestrator.description));
+	const handles = [];
+	const allLogs = [];
+	let view = null;
+	let shuttingDown = false;
+	const killAll = async () => {
+		const reversed = [...handles].reverse();
+		for (const handle of reversed) try {
+			await handle.kill();
+		} catch {}
+		await effect.Effect.runPromise(registry.killAll(true)).catch(() => {});
+	};
+	const exportLogs = async () => {
+		console.log("\n");
+		console.log("═".repeat(70));
+		console.log(`  SESSION LOGS: ${orchestrator.description}`);
+		console.log(`  Started: ${new Date(allLogs[0]?.timestamp || Date.now()).toISOString()}`);
+		console.log(`  Total entries: ${allLogs.length}`);
+		console.log("═".repeat(70));
+		console.log("");
+		for (const entry of allLogs) console.log(formatLogLine(entry));
+		console.log("");
+		console.log("═".repeat(70));
+		console.log(`  Full logs saved to: ${logger.logFile}`);
+		console.log("═".repeat(70));
+		console.log("");
+	};
+	const cleanup = async (showLogs = false) => {
+		if (shuttingDown) return;
+		shuttingDown = true;
+		view?.unmount();
+		await killAll();
+		if (showLogs) await exportLogs();
+	};
+	onCleanupReady?.(cleanup);
+	view = orchestrator.interactive ?? isInteractiveSupported() ? require_dev_view.renderDevView(initialProcesses, orchestrator.description, orchestrator.env, () => cleanup(false), () => cleanup(true)) : require_streaming_view.renderStreamingView(initialProcesses, orchestrator.description, orchestrator.env, () => cleanup(false));
+	const callbacks = {
+		onStatus: (name, status, message) => {
+			view?.updateProcess(name, status, message);
+		},
+		onLog: (name, line, isError) => {
+			const entry = {
+				id: `${Date.now()}-${allLogs.length + 1}`,
+				source: name,
+				line,
+				timestamp: Date.now(),
+				isError
+			};
+			allLogs.push(entry);
+			if (shouldDisplayLog(name, line, isError)) view?.addLog(name, line, isError);
+			if (!orchestrator.noLogs) logger.write(entry);
+		}
+	};
+	const startProcess = (pkg) => {
+		const portOverride = pkg === "host" ? orchestrator.port : void 0;
+		return require_orchestrator.makeDevProcess(pkg, orchestrator.env, callbacks, portOverride, orchestrator.bosConfig, orchestrator.runtimeConfig, registry);
+	};
+	const startGroup = (packages) => effect.Effect.forEach(packages, startProcess, { concurrency: "unbounded" });
+	const awaitReady = (pkg, handle) => effect.Effect.race(handle.waitForReady, effect.Effect.sleep("30 seconds").pipe(effect.Effect.andThen(effect.Effect.sync(() => {
+		callbacks.onLog(pkg, "Timeout waiting for ready, continuing...", true);
+	}))));
+	const nonHostPackages = orderedPackages.filter((pkg) => pkg !== "host");
+	const hostPackages = orderedPackages.filter((pkg) => pkg === "host");
+	const nonHostHandles = yield* startGroup(nonHostPackages);
+	handles.push(...nonHostHandles);
+	yield* effect.Effect.forEach(nonHostHandles.map((handle, index) => ({
+		handle,
+		pkg: nonHostPackages[index] ?? handle.name
+	})), ({ handle, pkg }) => awaitReady(pkg, handle), { concurrency: "unbounded" });
+	const hostHandles = yield* startGroup(hostPackages);
+	handles.push(...hostHandles);
+	yield* effect.Effect.forEach(hostHandles.map((handle, index) => ({
+		handle,
+		pkg: hostPackages[index] ?? handle.name
+	})), ({ handle, pkg }) => awaitReady(pkg, handle), { concurrency: "unbounded" });
+	yield* effect.Effect.addFinalizer(() => effect.Effect.promise(() => cleanup(false)));
+	yield* effect.Effect.never;
+});
+const startApp = (orchestrator) => {
+	let activeCleanup = null;
+	const program = effect.Effect.scoped(runDevSession(orchestrator, (cleanup) => {
+		activeCleanup = cleanup;
+	})).pipe(effect.Effect.catchAll((e) => effect.Effect.sync(() => {
+		if (e instanceof Error) {
+			console.error("App server error:", e.message);
+			if (e.stack) console.error(e.stack);
+		} else console.error("App server error:", e);
+	})));
+	const handleSignal = async () => {
+		if (activeCleanup) await activeCleanup();
+	};
+	const forceExit = () => {
+		console.log("\n[Dev] Force exit");
+		process.exit(0);
+	};
+	let signalCount = 0;
+	process.on("SIGINT", () => {
+		signalCount++;
+		if (signalCount > 1) {
+			forceExit();
+			return;
+		}
+		const timeout = setTimeout(forceExit, 5e3);
+		handleSignal().finally(() => {
+			clearTimeout(timeout);
+		});
+	});
+	process.on("SIGTERM", () => {
+		signalCount++;
+		if (signalCount > 1) {
+			forceExit();
+			return;
+		}
+		const timeout = setTimeout(forceExit, 5e3);
+		handleSignal().finally(() => {
+			clearTimeout(timeout);
+		});
+	});
+	effect.Effect.runPromise(program);
+};
+
+//#endregion
+exports.startApp = startApp;
+//# sourceMappingURL=dev-session.cjs.map

package/dist/dev-session.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-session.cjs","names":["Effect","getProjectRoot","getProcessConfig","makeProcessRegistry","createDevLogger","renderDevView","renderStreamingView","makeDevProcess"],"sources":["../src/dev-session.ts"],"sourcesContent":["import { Effect } from \"effect\";\nimport {\n  type DevViewHandle,\n  type LogEntry,\n  type ProcessState,\n  renderDevView,\n} from \"./components/dev-view\";\nimport { renderStreamingView } from \"./components/streaming-view\";\nimport { getProjectRoot } from \"./config\";\nimport { createDevLogger } from \"./dev-logs\";\nimport {\n  getProcessConfig,\n  makeDevProcess,\n  type ProcessCallbacks,\n  type ProcessHandle,\n} from \"./orchestrator\";\nimport { makeProcessRegistry } from \"./process-registry\";\nimport type { BosConfig, RuntimeConfig, SourceMode } from \"./types\";\n\nexport interface AppConfig {\n  host: SourceMode;\n  ui: SourceMode;\n  api: SourceMode;\n  proxy?: boolean;\n  ssr?: boolean;\n}\n\nexport interface AppOrchestrator {\n  packages: string[];\n  env: Record<string, string>;\n  description: string;\n  appConfig: AppConfig;\n  bosConfig: BosConfig;\n  runtimeConfig: RuntimeConfig;\n  port?: number;\n  interactive?: boolean;\n  noLogs?: boolean;\n}\n\nconst LOG_NOISE_PATTERNS = [\n  /\\[ Federation Runtime \\] Version .* from (host|ui) of shared singleton module/,\n  /Executing an Effect versioned \\d+\\.\\d+\\.\\d+ with a Runtime of version/,\n  /you may want to dedupe the effect dependencies/,\n];\n\nconst SSR_LOG_ALLOWLIST = [\n  /\\bready\\s+built in\\b/i,\n  /\\bcompiled\\b.*successfully/i,\n  /\\berror\\b/i,\n  /\\bfailed\\b/i,\n  /\\bexception\\b/i,\n];\n\nconst shouldDisplayLog = (source: string, line: string, isError?: boolean): boolean => {\n  if (process.env.DEBUG === \"true\" || process.env.DEBUG === \"1\") return true;\n  if (source === \"ui-ssr\") {\n    if (isError) return true;\n    return SSR_LOG_ALLOWLIST.some((pattern) => pattern.test(line));\n  }\n  return !LOG_NOISE_PATTERNS.some((pattern) => pattern.test(line));\n};\n\nconst isInteractiveSupported = (): boolean => {\n  return process.stdin.isTTY === true && process.stdout.isTTY === true;\n};\n\nconst STARTUP_ORDER = [\"ui-ssr\", \"ui\", \"api\", \"plugin\", \"host-build\", \"host\"];\n\nconst sortByOrder = (packages: string[]): string[] => {\n  return [...packages].sort((a, b) => {\n    const aIdx = a.startsWith(\"plugin:\")\n      ? STARTUP_ORDER.indexOf(\"plugin\")\n      : STARTUP_ORDER.indexOf(a);\n    const bIdx = b.startsWith(\"plugin:\")\n      ? STARTUP_ORDER.indexOf(\"plugin\")\n      : STARTUP_ORDER.indexOf(b);\n    if (aIdx === -1 && bIdx === -1) return 0;\n    if (aIdx === -1) return 1;\n    if (bIdx === -1) return -1;\n    return aIdx - bIdx;\n  });\n};\n\nfunction formatLogLine(entry: LogEntry): string {\n  const ts = new Date(entry.timestamp).toISOString();\n  const prefix = entry.isError ? \"ERR\" : \"OUT\";\n  return `[${ts}] [${entry.source}] [${prefix}] ${entry.line}`;\n}\n\nexport const runDevSession = (\n  orchestrator: AppOrchestrator,\n  onCleanupReady?: (cleanup: () => Promise<void>) => void,\n) =>\n  Effect.gen(function* () {\n    const configDir = getProjectRoot();\n    const orderedPackages = sortByOrder(orchestrator.packages);\n    const initialProcesses: ProcessState[] = orderedPackages.map((pkg) => {\n      const portOverride = pkg === \"host\" ? orchestrator.port : undefined;\n      const config = getProcessConfig(\n        pkg,\n        undefined,\n        portOverride,\n        orchestrator.bosConfig,\n        orchestrator.runtimeConfig,\n      );\n      const source =\n        pkg === \"host\"\n          ? orchestrator.appConfig.host\n          : pkg === \"ui\"\n            ? orchestrator.appConfig.ui\n            : pkg === \"api\"\n              ? orchestrator.appConfig.api\n              : undefined;\n      return {\n        name: pkg,\n        status: \"pending\" as const,\n        port: config?.port ?? 0,\n        source,\n      };\n    });\n\n    const registry = yield* makeProcessRegistry(configDir);\n    yield* registry.killAll().pipe(Effect.ignore);\n\n    const logger = yield* Effect.promise(() =>\n      createDevLogger(configDir, orchestrator.description),\n    );\n    const handles: ProcessHandle[] = [];\n    const allLogs: LogEntry[] = [];\n    let view: DevViewHandle | null = null;\n    let shuttingDown = false;\n\n    const killAll = async () => {\n      const reversed = [...handles].reverse();\n      for (const handle of reversed) {\n        try {\n          await handle.kill();\n        } catch {}\n      }\n      await Effect.runPromise(registry.killAll(true)).catch(() => {});\n    };\n\n    const exportLogs = async () => {\n      console.log(\"\\n\");\n      console.log(\"═\".repeat(70));\n      console.log(`  SESSION LOGS: ${orchestrator.description}`);\n      console.log(`  Started: ${new Date(allLogs[0]?.timestamp || Date.now()).toISOString()}`);\n      console.log(`  Total entries: ${allLogs.length}`);\n      console.log(\"═\".repeat(70));\n      console.log(\"\");\n      for (const entry of allLogs) {\n        console.log(formatLogLine(entry));\n      }\n      console.log(\"\");\n      console.log(\"═\".repeat(70));\n      console.log(`  Full logs saved to: ${logger.logFile}`);\n      console.log(\"═\".repeat(70));\n      console.log(\"\");\n    };\n\n    const cleanup = async (showLogs = false) => {\n      if (shuttingDown) return;\n      shuttingDown = true;\n      view?.unmount();\n      await killAll();\n      if (showLogs) {\n        await exportLogs();\n      }\n    };\n\n    onCleanupReady?.(cleanup);\n\n    const useInteractive = orchestrator.interactive ?? isInteractiveSupported();\n    view = useInteractive\n      ? renderDevView(\n          initialProcesses,\n          orchestrator.description,\n          orchestrator.env,\n          () => cleanup(false),\n          () => cleanup(true),\n        )\n      : renderStreamingView(initialProcesses, orchestrator.description, orchestrator.env, () =>\n          cleanup(false),\n        );\n\n    const callbacks: ProcessCallbacks = {\n      onStatus: (name, status, message) => {\n        view?.updateProcess(name, status, message);\n      },\n      onLog: (name, line, isError) => {\n        const entry: LogEntry = {\n          id: `${Date.now()}-${allLogs.length + 1}`,\n          source: name,\n          line,\n          timestamp: Date.now(),\n          isError,\n        };\n        allLogs.push(entry);\n        if (shouldDisplayLog(name, line, isError)) {\n          view?.addLog(name, line, isError);\n        }\n        if (!orchestrator.noLogs) {\n          void logger.write(entry);\n        }\n      },\n    };\n\n    const startProcess = (pkg: string) => {\n      const portOverride = pkg === \"host\" ? orchestrator.port : undefined;\n      return makeDevProcess(\n        pkg,\n        orchestrator.env,\n        callbacks,\n        portOverride,\n        orchestrator.bosConfig,\n        orchestrator.runtimeConfig,\n        registry,\n      );\n    };\n\n    const startGroup = (packages: string[]) =>\n      Effect.forEach(packages, startProcess, { concurrency: \"unbounded\" });\n\n    const awaitReady = (pkg: string, handle: ProcessHandle) =>\n      Effect.race(\n        handle.waitForReady,\n        Effect.sleep(\"30 seconds\").pipe(\n          Effect.andThen(\n            Effect.sync(() => {\n              callbacks.onLog(pkg, \"Timeout waiting for ready, continuing...\", true);\n            }),\n          ),\n        ),\n      );\n\n    const nonHostPackages = orderedPackages.filter((pkg) => pkg !== \"host\");\n    const hostPackages = orderedPackages.filter((pkg) => pkg === \"host\");\n\n    const nonHostHandles = yield* startGroup(nonHostPackages);\n    handles.push(...nonHostHandles);\n\n    yield* Effect.forEach(\n      nonHostHandles.map((handle, index) => ({\n        handle,\n        pkg: nonHostPackages[index] ?? handle.name,\n      })),\n      ({ handle, pkg }) => awaitReady(pkg, handle),\n      { concurrency: \"unbounded\" },\n    );\n\n    const hostHandles = yield* startGroup(hostPackages);\n    handles.push(...hostHandles);\n\n    yield* Effect.forEach(\n      hostHandles.map((handle, index) => ({ handle, pkg: hostPackages[index] ?? handle.name })),\n      ({ handle, pkg }) => awaitReady(pkg, handle),\n      { concurrency: \"unbounded\" },\n    );\n\n    yield* Effect.addFinalizer(() => Effect.promise(() => cleanup(false)));\n    yield* Effect.never;\n  });\n\nexport const startApp = (orchestrator: AppOrchestrator) => {\n  let activeCleanup: (() => Promise<void>) | null = null;\n\n  const program = Effect.scoped(\n    runDevSession(orchestrator, (cleanup) => {\n      activeCleanup = cleanup;\n    }),\n  ).pipe(\n    Effect.catchAll((e) =>\n      Effect.sync(() => {\n        if (e instanceof Error) {\n          console.error(\"App server error:\", e.message);\n          if (e.stack) console.error(e.stack);\n        } else {\n          console.error(\"App server error:\", e);\n        }\n      }),\n    ),\n  );\n\n  const handleSignal = async () => {\n    if (activeCleanup) await activeCleanup();\n  };\n\n  const forceExit = () => {\n    console.log(\"\\n[Dev] Force exit\");\n    process.exit(0);\n  };\n\n  let signalCount = 0;\n  process.on(\"SIGINT\", () => {\n    signalCount++;\n    if (signalCount > 1) {\n      forceExit();\n      return;\n    }\n    const timeout = setTimeout(forceExit, 5000);\n    void handleSignal().finally(() => {\n      clearTimeout(timeout);\n    });\n  });\n  process.on(\"SIGTERM\", () => {\n    signalCount++;\n    if (signalCount > 1) {\n      forceExit();\n      return;\n    }\n    const timeout = setTimeout(forceExit, 5000);\n    void handleSignal().finally(() => {\n      clearTimeout(timeout);\n    });\n  });\n\n  void Effect.runPromise(program);\n};\n"],"mappings":"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"}

package/dist/dev-session.mjs

@@ -0,0 +1,194 @@
+import { getProjectRoot } from "./config.mjs";
+import { getProcessConfig, makeDevProcess } from "./orchestrator.mjs";
+import { renderDevView } from "./components/dev-view.mjs";
+import { renderStreamingView } from "./components/streaming-view.mjs";
+import { createDevLogger } from "./dev-logs.mjs";
+import { makeProcessRegistry } from "./process-registry.mjs";
+import { Effect } from "effect";
+
+//#region src/dev-session.ts
+const LOG_NOISE_PATTERNS = [
+	/\[ Federation Runtime \] Version .* from (host|ui) of shared singleton module/,
+	/Executing an Effect versioned \d+\.\d+\.\d+ with a Runtime of version/,
+	/you may want to dedupe the effect dependencies/
+];
+const SSR_LOG_ALLOWLIST = [
+	/\bready\s+built in\b/i,
+	/\bcompiled\b.*successfully/i,
+	/\berror\b/i,
+	/\bfailed\b/i,
+	/\bexception\b/i
+];
+const shouldDisplayLog = (source, line, isError) => {
+	if (process.env.DEBUG === "true" || process.env.DEBUG === "1") return true;
+	if (source === "ui-ssr") {
+		if (isError) return true;
+		return SSR_LOG_ALLOWLIST.some((pattern) => pattern.test(line));
+	}
+	return !LOG_NOISE_PATTERNS.some((pattern) => pattern.test(line));
+};
+const isInteractiveSupported = () => {
+	return process.stdin.isTTY === true && process.stdout.isTTY === true;
+};
+const STARTUP_ORDER = [
+	"ui-ssr",
+	"ui",
+	"api",
+	"plugin",
+	"host-build",
+	"host"
+];
+const sortByOrder = (packages) => {
+	return [...packages].sort((a, b) => {
+		const aIdx = a.startsWith("plugin:") ? STARTUP_ORDER.indexOf("plugin") : STARTUP_ORDER.indexOf(a);
+		const bIdx = b.startsWith("plugin:") ? STARTUP_ORDER.indexOf("plugin") : STARTUP_ORDER.indexOf(b);
+		if (aIdx === -1 && bIdx === -1) return 0;
+		if (aIdx === -1) return 1;
+		if (bIdx === -1) return -1;
+		return aIdx - bIdx;
+	});
+};
+function formatLogLine(entry) {
+	const ts = new Date(entry.timestamp).toISOString();
+	const prefix = entry.isError ? "ERR" : "OUT";
+	return `[${ts}] [${entry.source}] [${prefix}] ${entry.line}`;
+}
+const runDevSession = (orchestrator, onCleanupReady) => Effect.gen(function* () {
+	const configDir = getProjectRoot();
+	const orderedPackages = sortByOrder(orchestrator.packages);
+	const initialProcesses = orderedPackages.map((pkg) => {
+		const config = getProcessConfig(pkg, void 0, pkg === "host" ? orchestrator.port : void 0, orchestrator.bosConfig, orchestrator.runtimeConfig);
+		const source = pkg === "host" ? orchestrator.appConfig.host : pkg === "ui" ? orchestrator.appConfig.ui : pkg === "api" ? orchestrator.appConfig.api : void 0;
+		return {
+			name: pkg,
+			status: "pending",
+			port: config?.port ?? 0,
+			source
+		};
+	});
+	const registry = yield* makeProcessRegistry(configDir);
+	yield* registry.killAll().pipe(Effect.ignore);
+	const logger = yield* Effect.promise(() => createDevLogger(configDir, orchestrator.description));
+	const handles = [];
+	const allLogs = [];
+	let view = null;
+	let shuttingDown = false;
+	const killAll = async () => {
+		const reversed = [...handles].reverse();
+		for (const handle of reversed) try {
+			await handle.kill();
+		} catch {}
+		await Effect.runPromise(registry.killAll(true)).catch(() => {});
+	};
+	const exportLogs = async () => {
+		console.log("\n");
+		console.log("═".repeat(70));
+		console.log(`  SESSION LOGS: ${orchestrator.description}`);
+		console.log(`  Started: ${new Date(allLogs[0]?.timestamp || Date.now()).toISOString()}`);
+		console.log(`  Total entries: ${allLogs.length}`);
+		console.log("═".repeat(70));
+		console.log("");
+		for (const entry of allLogs) console.log(formatLogLine(entry));
+		console.log("");
+		console.log("═".repeat(70));
+		console.log(`  Full logs saved to: ${logger.logFile}`);
+		console.log("═".repeat(70));
+		console.log("");
+	};
+	const cleanup = async (showLogs = false) => {
+		if (shuttingDown) return;
+		shuttingDown = true;
+		view?.unmount();
+		await killAll();
+		if (showLogs) await exportLogs();
+	};
+	onCleanupReady?.(cleanup);
+	view = orchestrator.interactive ?? isInteractiveSupported() ? renderDevView(initialProcesses, orchestrator.description, orchestrator.env, () => cleanup(false), () => cleanup(true)) : renderStreamingView(initialProcesses, orchestrator.description, orchestrator.env, () => cleanup(false));
+	const callbacks = {
+		onStatus: (name, status, message) => {
+			view?.updateProcess(name, status, message);
+		},
+		onLog: (name, line, isError) => {
+			const entry = {
+				id: `${Date.now()}-${allLogs.length + 1}`,
+				source: name,
+				line,
+				timestamp: Date.now(),
+				isError
+			};
+			allLogs.push(entry);
+			if (shouldDisplayLog(name, line, isError)) view?.addLog(name, line, isError);
+			if (!orchestrator.noLogs) logger.write(entry);
+		}
+	};
+	const startProcess = (pkg) => {
+		const portOverride = pkg === "host" ? orchestrator.port : void 0;
+		return makeDevProcess(pkg, orchestrator.env, callbacks, portOverride, orchestrator.bosConfig, orchestrator.runtimeConfig, registry);
+	};
+	const startGroup = (packages) => Effect.forEach(packages, startProcess, { concurrency: "unbounded" });
+	const awaitReady = (pkg, handle) => Effect.race(handle.waitForReady, Effect.sleep("30 seconds").pipe(Effect.andThen(Effect.sync(() => {
+		callbacks.onLog(pkg, "Timeout waiting for ready, continuing...", true);
+	}))));
+	const nonHostPackages = orderedPackages.filter((pkg) => pkg !== "host");
+	const hostPackages = orderedPackages.filter((pkg) => pkg === "host");
+	const nonHostHandles = yield* startGroup(nonHostPackages);
+	handles.push(...nonHostHandles);
+	yield* Effect.forEach(nonHostHandles.map((handle, index) => ({
+		handle,
+		pkg: nonHostPackages[index] ?? handle.name
+	})), ({ handle, pkg }) => awaitReady(pkg, handle), { concurrency: "unbounded" });
+	const hostHandles = yield* startGroup(hostPackages);
+	handles.push(...hostHandles);
+	yield* Effect.forEach(hostHandles.map((handle, index) => ({
+		handle,
+		pkg: hostPackages[index] ?? handle.name
+	})), ({ handle, pkg }) => awaitReady(pkg, handle), { concurrency: "unbounded" });
+	yield* Effect.addFinalizer(() => Effect.promise(() => cleanup(false)));
+	yield* Effect.never;
+});
+const startApp = (orchestrator) => {
+	let activeCleanup = null;
+	const program = Effect.scoped(runDevSession(orchestrator, (cleanup) => {
+		activeCleanup = cleanup;
+	})).pipe(Effect.catchAll((e) => Effect.sync(() => {
+		if (e instanceof Error) {
+			console.error("App server error:", e.message);
+			if (e.stack) console.error(e.stack);
+		} else console.error("App server error:", e);
+	})));
+	const handleSignal = async () => {
+		if (activeCleanup) await activeCleanup();
+	};
+	const forceExit = () => {
+		console.log("\n[Dev] Force exit");
+		process.exit(0);
+	};
+	let signalCount = 0;
+	process.on("SIGINT", () => {
+		signalCount++;
+		if (signalCount > 1) {
+			forceExit();
+			return;
+		}
+		const timeout = setTimeout(forceExit, 5e3);
+		handleSignal().finally(() => {
+			clearTimeout(timeout);
+		});
+	});
+	process.on("SIGTERM", () => {
+		signalCount++;
+		if (signalCount > 1) {
+			forceExit();
+			return;
+		}
+		const timeout = setTimeout(forceExit, 5e3);
+		handleSignal().finally(() => {
+			clearTimeout(timeout);
+		});
+	});
+	Effect.runPromise(program);
+};
+
+//#endregion
+export { startApp };
+//# sourceMappingURL=dev-session.mjs.map

package/dist/dev-session.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-session.mjs","names":[],"sources":["../src/dev-session.ts"],"sourcesContent":["import { Effect } from \"effect\";\nimport {\n  type DevViewHandle,\n  type LogEntry,\n  type ProcessState,\n  renderDevView,\n} from \"./components/dev-view\";\nimport { renderStreamingView } from \"./components/streaming-view\";\nimport { getProjectRoot } from \"./config\";\nimport { createDevLogger } from \"./dev-logs\";\nimport {\n  getProcessConfig,\n  makeDevProcess,\n  type ProcessCallbacks,\n  type ProcessHandle,\n} from \"./orchestrator\";\nimport { makeProcessRegistry } from \"./process-registry\";\nimport type { BosConfig, RuntimeConfig, SourceMode } from \"./types\";\n\nexport interface AppConfig {\n  host: SourceMode;\n  ui: SourceMode;\n  api: SourceMode;\n  proxy?: boolean;\n  ssr?: boolean;\n}\n\nexport interface AppOrchestrator {\n  packages: string[];\n  env: Record<string, string>;\n  description: string;\n  appConfig: AppConfig;\n  bosConfig: BosConfig;\n  runtimeConfig: RuntimeConfig;\n  port?: number;\n  interactive?: boolean;\n  noLogs?: boolean;\n}\n\nconst LOG_NOISE_PATTERNS = [\n  /\\[ Federation Runtime \\] Version .* from (host|ui) of shared singleton module/,\n  /Executing an Effect versioned \\d+\\.\\d+\\.\\d+ with a Runtime of version/,\n  /you may want to dedupe the effect dependencies/,\n];\n\nconst SSR_LOG_ALLOWLIST = [\n  /\\bready\\s+built in\\b/i,\n  /\\bcompiled\\b.*successfully/i,\n  /\\berror\\b/i,\n  /\\bfailed\\b/i,\n  /\\bexception\\b/i,\n];\n\nconst shouldDisplayLog = (source: string, line: string, isError?: boolean): boolean => {\n  if (process.env.DEBUG === \"true\" || process.env.DEBUG === \"1\") return true;\n  if (source === \"ui-ssr\") {\n    if (isError) return true;\n    return SSR_LOG_ALLOWLIST.some((pattern) => pattern.test(line));\n  }\n  return !LOG_NOISE_PATTERNS.some((pattern) => pattern.test(line));\n};\n\nconst isInteractiveSupported = (): boolean => {\n  return process.stdin.isTTY === true && process.stdout.isTTY === true;\n};\n\nconst STARTUP_ORDER = [\"ui-ssr\", \"ui\", \"api\", \"plugin\", \"host-build\", \"host\"];\n\nconst sortByOrder = (packages: string[]): string[] => {\n  return [...packages].sort((a, b) => {\n    const aIdx = a.startsWith(\"plugin:\")\n      ? STARTUP_ORDER.indexOf(\"plugin\")\n      : STARTUP_ORDER.indexOf(a);\n    const bIdx = b.startsWith(\"plugin:\")\n      ? STARTUP_ORDER.indexOf(\"plugin\")\n      : STARTUP_ORDER.indexOf(b);\n    if (aIdx === -1 && bIdx === -1) return 0;\n    if (aIdx === -1) return 1;\n    if (bIdx === -1) return -1;\n    return aIdx - bIdx;\n  });\n};\n\nfunction formatLogLine(entry: LogEntry): string {\n  const ts = new Date(entry.timestamp).toISOString();\n  const prefix = entry.isError ? \"ERR\" : \"OUT\";\n  return `[${ts}] [${entry.source}] [${prefix}] ${entry.line}`;\n}\n\nexport const runDevSession = (\n  orchestrator: AppOrchestrator,\n  onCleanupReady?: (cleanup: () => Promise<void>) => void,\n) =>\n  Effect.gen(function* () {\n    const configDir = getProjectRoot();\n    const orderedPackages = sortByOrder(orchestrator.packages);\n    const initialProcesses: ProcessState[] = orderedPackages.map((pkg) => {\n      const portOverride = pkg === \"host\" ? orchestrator.port : undefined;\n      const config = getProcessConfig(\n        pkg,\n        undefined,\n        portOverride,\n        orchestrator.bosConfig,\n        orchestrator.runtimeConfig,\n      );\n      const source =\n        pkg === \"host\"\n          ? orchestrator.appConfig.host\n          : pkg === \"ui\"\n            ? orchestrator.appConfig.ui\n            : pkg === \"api\"\n              ? orchestrator.appConfig.api\n              : undefined;\n      return {\n        name: pkg,\n        status: \"pending\" as const,\n        port: config?.port ?? 0,\n        source,\n      };\n    });\n\n    const registry = yield* makeProcessRegistry(configDir);\n    yield* registry.killAll().pipe(Effect.ignore);\n\n    const logger = yield* Effect.promise(() =>\n      createDevLogger(configDir, orchestrator.description),\n    );\n    const handles: ProcessHandle[] = [];\n    const allLogs: LogEntry[] = [];\n    let view: DevViewHandle | null = null;\n    let shuttingDown = false;\n\n    const killAll = async () => {\n      const reversed = [...handles].reverse();\n      for (const handle of reversed) {\n        try {\n          await handle.kill();\n        } catch {}\n      }\n      await Effect.runPromise(registry.killAll(true)).catch(() => {});\n    };\n\n    const exportLogs = async () => {\n      console.log(\"\\n\");\n      console.log(\"═\".repeat(70));\n      console.log(`  SESSION LOGS: ${orchestrator.description}`);\n      console.log(`  Started: ${new Date(allLogs[0]?.timestamp || Date.now()).toISOString()}`);\n      console.log(`  Total entries: ${allLogs.length}`);\n      console.log(\"═\".repeat(70));\n      console.log(\"\");\n      for (const entry of allLogs) {\n        console.log(formatLogLine(entry));\n      }\n      console.log(\"\");\n      console.log(\"═\".repeat(70));\n      console.log(`  Full logs saved to: ${logger.logFile}`);\n      console.log(\"═\".repeat(70));\n      console.log(\"\");\n    };\n\n    const cleanup = async (showLogs = false) => {\n      if (shuttingDown) return;\n      shuttingDown = true;\n      view?.unmount();\n      await killAll();\n      if (showLogs) {\n        await exportLogs();\n      }\n    };\n\n    onCleanupReady?.(cleanup);\n\n    const useInteractive = orchestrator.interactive ?? isInteractiveSupported();\n    view = useInteractive\n      ? renderDevView(\n          initialProcesses,\n          orchestrator.description,\n          orchestrator.env,\n          () => cleanup(false),\n          () => cleanup(true),\n        )\n      : renderStreamingView(initialProcesses, orchestrator.description, orchestrator.env, () =>\n          cleanup(false),\n        );\n\n    const callbacks: ProcessCallbacks = {\n      onStatus: (name, status, message) => {\n        view?.updateProcess(name, status, message);\n      },\n      onLog: (name, line, isError) => {\n        const entry: LogEntry = {\n          id: `${Date.now()}-${allLogs.length + 1}`,\n          source: name,\n          line,\n          timestamp: Date.now(),\n          isError,\n        };\n        allLogs.push(entry);\n        if (shouldDisplayLog(name, line, isError)) {\n          view?.addLog(name, line, isError);\n        }\n        if (!orchestrator.noLogs) {\n          void logger.write(entry);\n        }\n      },\n    };\n\n    const startProcess = (pkg: string) => {\n      const portOverride = pkg === \"host\" ? orchestrator.port : undefined;\n      return makeDevProcess(\n        pkg,\n        orchestrator.env,\n        callbacks,\n        portOverride,\n        orchestrator.bosConfig,\n        orchestrator.runtimeConfig,\n        registry,\n      );\n    };\n\n    const startGroup = (packages: string[]) =>\n      Effect.forEach(packages, startProcess, { concurrency: \"unbounded\" });\n\n    const awaitReady = (pkg: string, handle: ProcessHandle) =>\n      Effect.race(\n        handle.waitForReady,\n        Effect.sleep(\"30 seconds\").pipe(\n          Effect.andThen(\n            Effect.sync(() => {\n              callbacks.onLog(pkg, \"Timeout waiting for ready, continuing...\", true);\n            }),\n          ),\n        ),\n      );\n\n    const nonHostPackages = orderedPackages.filter((pkg) => pkg !== \"host\");\n    const hostPackages = orderedPackages.filter((pkg) => pkg === \"host\");\n\n    const nonHostHandles = yield* startGroup(nonHostPackages);\n    handles.push(...nonHostHandles);\n\n    yield* Effect.forEach(\n      nonHostHandles.map((handle, index) => ({\n        handle,\n        pkg: nonHostPackages[index] ?? handle.name,\n      })),\n      ({ handle, pkg }) => awaitReady(pkg, handle),\n      { concurrency: \"unbounded\" },\n    );\n\n    const hostHandles = yield* startGroup(hostPackages);\n    handles.push(...hostHandles);\n\n    yield* Effect.forEach(\n      hostHandles.map((handle, index) => ({ handle, pkg: hostPackages[index] ?? handle.name })),\n      ({ handle, pkg }) => awaitReady(pkg, handle),\n      { concurrency: \"unbounded\" },\n    );\n\n    yield* Effect.addFinalizer(() => Effect.promise(() => cleanup(false)));\n    yield* Effect.never;\n  });\n\nexport const startApp = (orchestrator: AppOrchestrator) => {\n  let activeCleanup: (() => Promise<void>) | null = null;\n\n  const program = Effect.scoped(\n    runDevSession(orchestrator, (cleanup) => {\n      activeCleanup = cleanup;\n    }),\n  ).pipe(\n    Effect.catchAll((e) =>\n      Effect.sync(() => {\n        if (e instanceof Error) {\n          console.error(\"App server error:\", e.message);\n          if (e.stack) console.error(e.stack);\n        } else {\n          console.error(\"App server error:\", e);\n        }\n      }),\n    ),\n  );\n\n  const handleSignal = async () => {\n    if (activeCleanup) await activeCleanup();\n  };\n\n  const forceExit = () => {\n    console.log(\"\\n[Dev] Force exit\");\n    process.exit(0);\n  };\n\n  let signalCount = 0;\n  process.on(\"SIGINT\", () => {\n    signalCount++;\n    if (signalCount > 1) {\n      forceExit();\n      return;\n    }\n    const timeout = setTimeout(forceExit, 5000);\n    void handleSignal().finally(() => {\n      clearTimeout(timeout);\n    });\n  });\n  process.on(\"SIGTERM\", () => {\n    signalCount++;\n    if (signalCount > 1) {\n      forceExit();\n      return;\n    }\n    const timeout = setTimeout(forceExit, 5000);\n    void handleSignal().finally(() => {\n      clearTimeout(timeout);\n    });\n  });\n\n  void Effect.runPromise(program);\n};\n"],"mappings":"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"}

package/dist/fastkv.cjs

@@ -0,0 +1,89 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+//#region src/fastkv.ts
+const FASTKV_TIMEOUT_MS = 1e4;
+function getNetworkIdForAccount(accountId) {
+	return accountId.endsWith(".testnet") ? "testnet" : "mainnet";
+}
+function getFastKvBaseUrlForNetwork(network) {
+	return network === "testnet" ? process.env.REGISTRY_FASTKV_TESTNET_URL || "https://kv.test.fastnear.com" : process.env.REGISTRY_FASTKV_MAINNET_URL || "https://kv.main.fastnear.com";
+}
+function getFastKvBaseUrlForAccount(accountId) {
+	return getNetworkIdForAccount(accountId) === "testnet" ? getFastKvBaseUrlForNetwork("testnet") : getFastKvBaseUrlForNetwork("mainnet");
+}
+function buildRegistryConfigUrl(accountId, gatewayId) {
+	const baseUrl = getFastKvBaseUrlForAccount(accountId);
+	const namespace = getRegistryNamespaceForAccount(accountId);
+	const key = encodeURIComponent(getRegistryConfigKey(accountId, gatewayId));
+	return `${baseUrl}/v0/latest/${encodeURIComponent(namespace)}/${encodeURIComponent(accountId)}/${key}`;
+}
+function buildRegistryConfigUrlForNetwork(network, accountId, gatewayId) {
+	const baseUrl = getFastKvBaseUrlForNetwork(network);
+	const namespace = getRegistryNamespaceForNetwork(network);
+	const key = encodeURIComponent(getRegistryConfigKey(accountId, gatewayId));
+	return `${baseUrl}/v0/latest/${encodeURIComponent(namespace)}/${encodeURIComponent(accountId)}/${key}`;
+}
+function getRegistryNamespaceForAccount(accountId) {
+	return accountId.endsWith(".testnet") ? process.env.REGISTRY_FASTKV_TESTNET_NAMESPACE || "dev.everything.near" : process.env.REGISTRY_FASTKV_MAINNET_NAMESPACE || accountId;
+}
+function getRegistryNamespaceForNetwork(network) {
+	return network === "testnet" ? process.env.REGISTRY_FASTKV_TESTNET_NAMESPACE || "dev.everything.near" : process.env.REGISTRY_FASTKV_MAINNET_NAMESPACE || "dev.everything.near";
+}
+function getRegistryConfigKey(accountId, gatewayId, pathSegments = []) {
+	return `apps/${accountId}/${gatewayId}${pathSegments.length > 0 ? `/${pathSegments.map((segment) => encodeURIComponent(segment)).join("/")}` : ""}/bos.config.json`;
+}
+function parseBosUrl(bosUrl) {
+	const match = bosUrl.match(/^bos:\/\/([^/]+)\/(.+)$/);
+	if (!match?.[1] || !match[2]) throw new Error(`Invalid BOS URL: ${bosUrl}`);
+	const pathSegments = match[2].split("/").filter(Boolean).map((segment) => decodeURIComponent(segment));
+	if (pathSegments.length === 0) throw new Error(`Invalid BOS URL: ${bosUrl}`);
+	const [gatewayId, ...pathSegmentsTail] = pathSegments;
+	if (!gatewayId) throw new Error(`Invalid BOS URL: ${bosUrl}`);
+	return {
+		accountId: match[1],
+		gatewayId,
+		pathSegments: pathSegmentsTail
+	};
+}
+async function fetchBosConfigFromFastKv(bosUrl) {
+	const { accountId, gatewayId, pathSegments } = parseBosUrl(bosUrl);
+	const value = (await fetchJson(`${getFastKvBaseUrlForAccount(accountId)}/v0/latest/${encodeURIComponent(getRegistryNamespaceForAccount(accountId))}/${encodeURIComponent(accountId)}`, {
+		method: "POST",
+		body: JSON.stringify({
+			key: getRegistryConfigKey(accountId, gatewayId, pathSegments),
+			limit: 1
+		})
+	}))?.entries?.find(Boolean)?.value;
+	if (!value) throw new Error(`No config found for ${bosUrl}`);
+	if (typeof value === "string") return JSON.parse(value);
+	if (typeof value !== "object") throw new Error(`Invalid config value for ${bosUrl}`);
+	return value;
+}
+async function fetchJson(url, init) {
+	const controller = new AbortController();
+	const timeout = setTimeout(() => controller.abort(), FASTKV_TIMEOUT_MS);
+	try {
+		const response = await fetch(url, {
+			...init,
+			headers: {
+				accept: "application/json",
+				"content-type": "application/json",
+				...init?.headers ?? {}
+			},
+			signal: controller.signal
+		});
+		if (!response.ok) return null;
+		return await response.json();
+	} finally {
+		clearTimeout(timeout);
+	}
+}
+
+//#endregion
+exports.buildRegistryConfigUrl = buildRegistryConfigUrl;
+exports.buildRegistryConfigUrlForNetwork = buildRegistryConfigUrlForNetwork;
+exports.fetchBosConfigFromFastKv = fetchBosConfigFromFastKv;
+exports.getFastKvBaseUrlForNetwork = getFastKvBaseUrlForNetwork;
+exports.getRegistryNamespaceForAccount = getRegistryNamespaceForAccount;
+exports.getRegistryNamespaceForNetwork = getRegistryNamespaceForNetwork;
+//# sourceMappingURL=fastkv.cjs.map

package/dist/fastkv.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fastkv.cjs","names":[],"sources":["../src/fastkv.ts"],"sourcesContent":["export type NetworkId = \"mainnet\" | \"testnet\";\n\ninterface FastKvEntry {\n  value: unknown;\n}\n\ninterface FastKvListResponse {\n  entries?: Array<FastKvEntry | null>;\n}\n\nconst FASTKV_TIMEOUT_MS = 10_000;\n\nfunction getNetworkIdForAccount(accountId: string): NetworkId {\n  return accountId.endsWith(\".testnet\") ? \"testnet\" : \"mainnet\";\n}\n\nexport function getFastKvBaseUrlForNetwork(network: NetworkId): string {\n  return network === \"testnet\"\n    ? process.env.REGISTRY_FASTKV_TESTNET_URL || \"https://kv.test.fastnear.com\"\n    : process.env.REGISTRY_FASTKV_MAINNET_URL || \"https://kv.main.fastnear.com\";\n}\n\nfunction getFastKvBaseUrlForAccount(accountId: string): string {\n  return getNetworkIdForAccount(accountId) === \"testnet\"\n    ? getFastKvBaseUrlForNetwork(\"testnet\")\n    : getFastKvBaseUrlForNetwork(\"mainnet\");\n}\n\nexport function buildRegistryConfigUrl(accountId: string, gatewayId: string): string {\n  const baseUrl = getFastKvBaseUrlForAccount(accountId);\n  const namespace = getRegistryNamespaceForAccount(accountId);\n  const key = encodeURIComponent(getRegistryConfigKey(accountId, gatewayId));\n  return `${baseUrl}/v0/latest/${encodeURIComponent(namespace)}/${encodeURIComponent(accountId)}/${key}`;\n}\n\nexport function buildRegistryConfigUrlForNetwork(\n  network: NetworkId,\n  accountId: string,\n  gatewayId: string,\n): string {\n  const baseUrl = getFastKvBaseUrlForNetwork(network);\n  const namespace = getRegistryNamespaceForNetwork(network);\n  const key = encodeURIComponent(getRegistryConfigKey(accountId, gatewayId));\n  return `${baseUrl}/v0/latest/${encodeURIComponent(namespace)}/${encodeURIComponent(accountId)}/${key}`;\n}\n\nexport function getRegistryNamespaceForAccount(accountId: string): string {\n  return accountId.endsWith(\".testnet\")\n    ? process.env.REGISTRY_FASTKV_TESTNET_NAMESPACE || \"dev.everything.near\"\n    : process.env.REGISTRY_FASTKV_MAINNET_NAMESPACE || accountId;\n}\n\nexport function getRegistryNamespaceForNetwork(network: NetworkId): string {\n  return network === \"testnet\"\n    ? process.env.REGISTRY_FASTKV_TESTNET_NAMESPACE || \"dev.everything.near\"\n    : process.env.REGISTRY_FASTKV_MAINNET_NAMESPACE || \"dev.everything.near\";\n}\n\nfunction getRegistryConfigKey(\n  accountId: string,\n  gatewayId: string,\n  pathSegments: string[] = [],\n): string {\n  const suffix =\n    pathSegments.length > 0\n      ? `/${pathSegments.map((segment) => encodeURIComponent(segment)).join(\"/\")}`\n      : \"\";\n  return `apps/${accountId}/${gatewayId}${suffix}/bos.config.json`;\n}\n\nfunction parseBosUrl(bosUrl: string): {\n  accountId: string;\n  gatewayId: string;\n  pathSegments: string[];\n} {\n  const match = bosUrl.match(/^bos:\\/\\/([^/]+)\\/(.+)$/);\n  if (!match?.[1] || !match[2]) {\n    throw new Error(`Invalid BOS URL: ${bosUrl}`);\n  }\n\n  const pathSegments = match[2]\n    .split(\"/\")\n    .filter(Boolean)\n    .map((segment) => decodeURIComponent(segment));\n  if (pathSegments.length === 0) {\n    throw new Error(`Invalid BOS URL: ${bosUrl}`);\n  }\n\n  const [gatewayId, ...pathSegmentsTail] = pathSegments;\n  if (!gatewayId) {\n    throw new Error(`Invalid BOS URL: ${bosUrl}`);\n  }\n\n  return {\n    accountId: match[1],\n    gatewayId,\n    pathSegments: pathSegmentsTail,\n  };\n}\n\nexport async function fetchBosConfigFromFastKv<T>(bosUrl: string): Promise<T> {\n  const { accountId, gatewayId, pathSegments } = parseBosUrl(bosUrl);\n  const payload = await fetchJson<FastKvListResponse>(\n    `${getFastKvBaseUrlForAccount(accountId)}/v0/latest/${encodeURIComponent(getRegistryNamespaceForAccount(accountId))}/${encodeURIComponent(accountId)}`,\n    {\n      method: \"POST\",\n      body: JSON.stringify({\n        key: getRegistryConfigKey(accountId, gatewayId, pathSegments),\n        limit: 1,\n      }),\n    },\n  );\n  const value = payload?.entries?.find(Boolean)?.value;\n\n  if (!value) {\n    throw new Error(`No config found for ${bosUrl}`);\n  }\n\n  if (typeof value === \"string\") {\n    return JSON.parse(value) as T;\n  }\n\n  if (typeof value !== \"object\") {\n    throw new Error(`Invalid config value for ${bosUrl}`);\n  }\n\n  return value as T;\n}\n\nasync function fetchJson<T>(url: string, init?: RequestInit): Promise<T | null> {\n  const controller = new AbortController();\n  const timeout = setTimeout(() => controller.abort(), FASTKV_TIMEOUT_MS);\n\n  try {\n    const response = await fetch(url, {\n      ...init,\n      headers: {\n        accept: \"application/json\",\n        \"content-type\": \"application/json\",\n        ...(init?.headers ?? {}),\n      },\n      signal: controller.signal,\n    });\n\n    if (!response.ok) {\n      return null;\n    }\n\n    return (await response.json()) as T;\n  } finally {\n    clearTimeout(timeout);\n  }\n}\n"],"mappings":"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"}

package/dist/fastkv.d.cts

@@ -0,0 +1,11 @@
+//#region src/fastkv.d.ts
+type NetworkId = "mainnet" | "testnet";
+declare function getFastKvBaseUrlForNetwork(network: NetworkId): string;
+declare function buildRegistryConfigUrl(accountId: string, gatewayId: string): string;
+declare function buildRegistryConfigUrlForNetwork(network: NetworkId, accountId: string, gatewayId: string): string;
+declare function getRegistryNamespaceForAccount(accountId: string): string;
+declare function getRegistryNamespaceForNetwork(network: NetworkId): string;
+declare function fetchBosConfigFromFastKv<T>(bosUrl: string): Promise<T>;
+//#endregion
+export { NetworkId, buildRegistryConfigUrl, buildRegistryConfigUrlForNetwork, fetchBosConfigFromFastKv, getFastKvBaseUrlForNetwork, getRegistryNamespaceForAccount, getRegistryNamespaceForNetwork };
+//# sourceMappingURL=fastkv.d.cts.map

package/dist/fastkv.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fastkv.d.cts","names":[],"sources":["../src/fastkv.ts"],"mappings":";KAAY,SAAA;AAAA,iBAgBI,0BAAA,CAA2B,OAAA,EAAS,SAAA;AAAA,iBAYpC,sBAAA,CAAuB,SAAA,UAAmB,SAAA;AAAA,iBAO1C,gCAAA,CACd,OAAA,EAAS,SAAA,EACT,SAAA,UACA,SAAA;AAAA,iBAQc,8BAAA,CAA+B,SAAA;AAAA,iBAM/B,8BAAA,CAA+B,OAAA,EAAS,SAAA;AAAA,iBAgDlC,wBAAA,GAAA,CAA4B,MAAA,WAAiB,OAAA,CAAQ,CAAA"}

package/dist/fastkv.d.mts

@@ -0,0 +1,11 @@
+//#region src/fastkv.d.ts
+type NetworkId = "mainnet" | "testnet";
+declare function getFastKvBaseUrlForNetwork(network: NetworkId): string;
+declare function buildRegistryConfigUrl(accountId: string, gatewayId: string): string;
+declare function buildRegistryConfigUrlForNetwork(network: NetworkId, accountId: string, gatewayId: string): string;
+declare function getRegistryNamespaceForAccount(accountId: string): string;
+declare function getRegistryNamespaceForNetwork(network: NetworkId): string;
+declare function fetchBosConfigFromFastKv<T>(bosUrl: string): Promise<T>;
+//#endregion
+export { NetworkId, buildRegistryConfigUrl, buildRegistryConfigUrlForNetwork, fetchBosConfigFromFastKv, getFastKvBaseUrlForNetwork, getRegistryNamespaceForAccount, getRegistryNamespaceForNetwork };
+//# sourceMappingURL=fastkv.d.mts.map