@quark-fw/plugin-env 0.1.26 → 0.1.27

package/README.md

@@ -0,0 +1,31 @@
+# @quark-fw/plugin-env
+
+`.env` plugin for Quark apps: every environment variable is an atom (`quark.env.get("KEY")`), the `.env` file in the working directory is loaded on init and re-read when it changes (chokidar), and every change emits `env:changed`.
+
+## Install
+
+```sh
+npm i @quark-fw/plugin-env
+```
+
+Peer: `@quark-fw/core`.
+
+## Usage
+
+```ts
+import "@quark-fw/plugin-env"; // provides quark.env, watches ./.env
+
+quark.env.get("FEATURE_FLAG").value; // Atom<string | undefined>, initial value from process.env
+quark.env.has("REDIS_URL"); // true if seen by the plugin or present in process.env
+const unsubscribe = quark.env.subscribe("FEATURE_FLAG", (value) => {
+  /* reacts to .env edits at runtime */
+});
+quark.env.set("FEATURE_FLAG", "on"); // updates the atom and emits env:changed
+quark.ee.value.on("env:changed", (key, value) => {});
+```
+
+How it works: atoms are created lazily per key with `process.env[key]` as the initial value. On init the plugin parses `.env` at `process.cwd()` (`KEY=VALUE` lines, `#` comments; the value is everything after the first `=`, trimmed, quotes are not stripped) and calls `quark.env.set` for each line, then watches the file (`awaitWriteFinish`) and reloads it on change. `set()` writes the atom only — `process.env` is not modified, so code that reads `process.env` directly keeps the startup value. The watcher is closed in `onDestroy`.
+
+Env: no fixed names — the plugin reads `process.env[<key>]` for whatever key is requested, plus the `./.env` file.
+
+Part of the [Quark framework](https://www.npmjs.com/package/@quark-fw/core).

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@quark-fw/plugin-env",
-	"version": "0.1.26",
+	"version": "0.1.27",
 	"main": "src/index.ts",
 	"types": "src/index.ts",
 	"type": "module",
@@ -21,11 +21,11 @@
 		"access": "public"
 	},
 	"dependencies": {
-		"@quark-fw/atom": "0.1.26",
-		"@quark-fw/plugin": "0.1.26",
+		"@quark-fw/atom": "0.1.27",
+		"@quark-fw/plugin": "0.1.27",
 		"chokidar": "^5.0.0"
 	},
 	"peerDependencies": {
-		"@quark-fw/core": "0.1.26"
+		"@quark-fw/core": "0.1.27"
 	}
 }

package/src/helpers.ts

@@ -1,6 +1,9 @@
 // Хелперы env-плагина: загрузка .env и наблюдение за его изменениями.
 import chokidar, { FSWatcher } from "chokidar";
 import fs from "node:fs";
+import { log as rootLog } from "@quark-fw/core/src/log.js";
+
+const log = rootLog.child({ scope: "env" });
 
 export function loadEnvFile(quark: Quark, path: string) {
 	const content = fs.readFileSync(path, "utf8");
@@ -30,7 +33,7 @@ export function watchEnv(quark: Quark, envPath = ".env") {
 	});
 
 	watcher.on("change", () => {
-		console.log(".env file changed");
+		log.info(".env file changed");
 		loadEnvFile(quark, envPath);
 	});
 }