@quark-fw/plugin-env 0.1.13

package/package.json

@@ -0,0 +1,31 @@
+{
+	"name": "@quark-fw/plugin-env",
+	"version": "0.1.13",
+	"main": "src/index.ts",
+	"types": "src/index.ts",
+	"type": "module",
+	"scripts": {
+		"dev": "tsx watch src/index.ts",
+		"build": "echo raw-src package, no build"
+	},
+	"files": [
+		"src"
+	],
+	"keywords": [
+		"quark"
+	],
+	"author": "",
+	"license": "ISC",
+	"description": ".env plugin for the Quark framework: every env var as an atom, live-reloaded via chokidar (published as raw TS sources; consumers run tsx)",
+	"publishConfig": {
+		"access": "public"
+	},
+	"dependencies": {
+		"@quark-fw/atom": "0.1.13",
+		"@quark-fw/plugin": "0.1.13",
+		"chokidar": "^5.0.0"
+	},
+	"peerDependencies": {
+		"@quark-fw/core": "0.1.13"
+	}
+}

package/src/global.d.ts

@@ -0,0 +1,22 @@
+import "@quark-fw/core/src/global.d.ts";
+import { Atom } from "@quark-fw/atom";
+
+export {};
+
+declare global {
+	interface Events {
+		"env:changed": [key: string, value: string | undefined];
+	}
+
+	interface Quark {
+		env: {
+			get(key: string): Atom<string | undefined>;
+			set(key: string, value: string): void;
+			has(key: string): boolean;
+			subscribe(
+				key: string,
+				fn: (value: string | undefined) => void,
+			): () => void;
+		};
+	}
+}

package/src/helpers.ts

@@ -0,0 +1,41 @@
+// Хелперы env-плагина: загрузка .env и наблюдение за его изменениями.
+import chokidar, { FSWatcher } from "chokidar";
+import fs from "node:fs";
+
+export function loadEnvFile(quark: Quark, path: string) {
+	const content = fs.readFileSync(path, "utf8");
+	for (const line of content.split("\n")) {
+		const trimmed = line.trim();
+		if (!trimmed || trimmed.startsWith("#")) continue;
+		const [key, ...rest] = trimmed.split("=");
+		const value = rest.join("=").trim();
+		quark.env.set(key, value);
+	}
+}
+
+let watcher: FSWatcher | undefined;
+
+export function watchEnv(quark: Quark, envPath = ".env") {
+	if (!fs.existsSync(envPath)) return;
+
+	// начальная загрузка
+	loadEnvFile(quark, envPath);
+
+	watcher = chokidar.watch(envPath, {
+		ignoreInitial: true,
+		awaitWriteFinish: {
+			stabilityThreshold: 200,
+			pollInterval: 50,
+		},
+	});
+
+	watcher.on("change", () => {
+		console.log(".env file changed");
+		loadEnvFile(quark, envPath);
+	});
+}
+
+export async function closeEnvWatcher() {
+	await watcher?.close();
+	watcher = undefined;
+}

package/src/index.ts

@@ -0,0 +1,45 @@
+import atom, { Atom } from "@quark-fw/atom";
+import { closeEnvWatcher, watchEnv } from "./helpers.js";
+import {} from "@quark-fw/plugin-env/src/global.js";
+
+await quark.registerPlugin({
+	name: "env",
+	extend(quark) {
+		const store = new Map<string, Atom<string | undefined>>();
+		function ensureAtom(key: string) {
+			if (!store.has(key)) {
+				const initial = process.env[key];
+				const a = atom(`env:${key}`, initial);
+				store.set(key, a);
+
+				// подписка на изменения
+				a.subscribe((v) => {
+					quark.ee.value.emit("env:changed", key, v);
+				});
+			}
+			return store.get(key)!;
+		}
+		quark.env = {
+			get(key) {
+				return ensureAtom(key);
+			},
+			set(key, value) {
+				const a = ensureAtom(key);
+				a.value = value;
+			},
+			has(key) {
+				return store.has(key) || key in process.env;
+			},
+			subscribe(key, fn) {
+				const a = ensureAtom(key);
+				return a.subscribe(fn);
+			},
+		};
+	},
+	onInit(quark) {
+		watchEnv(quark);
+	},
+	async onDestroy() {
+		await closeEnvWatcher();
+	},
+});