@jondotsoy/envs 0.0.1 → 0.0.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jonathan Delgado <hi@jon.soy> (https://jon.soy)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/envs.js

@@ -0,0 +1,204 @@
+#!/usr/bin/env bun
+// @bun
+
+// src/envs.ts
+import { mkdir } from "fs/promises";
+import { basename, dirname, join } from "path";
+var {$ } = globalThis.Bun;
+var HELP = `Usage: envs <command>
+
+Commands:
+  init    Create the .envs/ directory (.gitignore, values.yml)
+  pull    Read each worktree's .env and write it into .envs/values.yml
+  push    Write defaults and .envs/values.yml into the .env of each worktree
+  edit    Pull, open .envs/values.yml in VS Code (code -w), then push
+  help    Show this help message
+`;
+var defaultContext = () => ({
+  cwd: process.cwd(),
+  log: (message) => console.log(message),
+  error: (message) => console.error(message),
+  openEditor: async (path) => {
+    const proc = Bun.spawn(["code", "-w", path], {
+      env: { ...process.env },
+      stdio: ["inherit", "inherit", "inherit"]
+    });
+    return await proc.exited;
+  }
+});
+async function findRoot(cwd) {
+  const result = await $`git rev-parse --path-format=absolute --git-common-dir`.cwd(cwd).nothrow().quiet();
+  if (result.exitCode !== 0)
+    return cwd;
+  return dirname(result.stdout.toString().trim());
+}
+async function listWorktrees(cwd) {
+  const out = await $`git worktree list --porcelain`.cwd(cwd).text();
+  return out.trim().split(`
+
+`).map((block) => {
+    const lines = block.split(`
+`);
+    const path = lines.find((l) => l.startsWith("worktree ")).slice(9);
+    const branch = lines.find((l) => l.startsWith("branch "));
+    return {
+      path,
+      name: branch ? branch.slice("branch refs/heads/".length) : basename(path)
+    };
+  });
+}
+function parseDotenv(text) {
+  const result = {};
+  for (const raw of text.split(/\r?\n/)) {
+    const line = raw.trim();
+    if (!line || line.startsWith("#"))
+      continue;
+    const match = line.match(/^(?:export\s+)?([\w.-]+)\s*=\s*(.*)$/);
+    if (!match)
+      continue;
+    let value = match[2].trim();
+    const quote = value[0];
+    if ((quote === '"' || quote === "'") && value.lastIndexOf(quote) > 0) {
+      value = value.slice(1, value.lastIndexOf(quote));
+    } else {
+      value = value.replace(/\s+#.*$/, "");
+    }
+    result[match[1]] = value;
+  }
+  return result;
+}
+function formatDotenvValue(value) {
+  if (value !== "" && !/[\s#"'\\$]/.test(value))
+    return value;
+  return value.includes('"') ? `'${value}'` : `"${value}"`;
+}
+function updateDotenv(text, entries) {
+  const pending = new Map(Object.entries(entries));
+  const lines = text === "" ? [] : text.replace(/\n$/, "").split(`
+`);
+  const updated = lines.map((line) => {
+    const key = line.trim().match(/^(?:export\s+)?([\w.-]+)\s*=/)?.[1];
+    if (key === undefined || !pending.has(key))
+      return line;
+    const value = pending.get(key);
+    pending.delete(key);
+    return `${key}=${formatDotenvValue(value)}`;
+  });
+  for (const [key, value] of pending) {
+    updated.push(`${key}=${formatDotenvValue(value)}`);
+  }
+  return updated.join(`
+`) + `
+`;
+}
+async function readValues(ctx) {
+  const path = join(await findRoot(ctx.cwd), ".envs/values.yml");
+  if (!await Bun.file(path).exists()) {
+    ctx.error(`${path} not found. Run \`envs init\` first.`);
+    return;
+  }
+  const values = Bun.YAML.parse(await Bun.file(path).text()) ?? {};
+  return { path, values };
+}
+async function init(ctx) {
+  const root = await findRoot(ctx.cwd);
+  const files = { ".envs/.gitignore": `*
+`, ".envs/values.yml": "" };
+  await mkdir(join(root, ".envs"), { recursive: true });
+  for (const [name, content] of Object.entries(files)) {
+    const path = join(root, name);
+    if (await Bun.file(path).exists()) {
+      ctx.log(`${path} already exists`);
+    } else {
+      await Bun.write(path, content);
+      ctx.log(`Created ${path}`);
+    }
+  }
+  return 0;
+}
+async function push(ctx) {
+  const read = await readValues(ctx);
+  if (!read)
+    return 1;
+  const { values } = read;
+  for (const { name, path } of await listWorktrees(ctx.cwd)) {
+    const entries = {};
+    for (const [key, value] of Object.entries(values.defaults ?? {})) {
+      entries[key] = String(value);
+    }
+    for (const [key, byWorktree] of Object.entries(values.envs ?? {})) {
+      if (name in byWorktree)
+        entries[key] = String(byWorktree[name]);
+    }
+    if (Object.keys(entries).length === 0)
+      continue;
+    const dotenv = Bun.file(join(path, ".env"));
+    const current = await dotenv.exists() ? await dotenv.text() : "";
+    await Bun.write(dotenv, updateDotenv(current, entries));
+    ctx.log(`Pushed ${name}`);
+  }
+  return 0;
+}
+async function pull(ctx) {
+  const read = await readValues(ctx);
+  if (!read)
+    return 1;
+  const { path: valuesPath, values } = read;
+  const envs = values.envs ??= {};
+  for (const { name, path } of await listWorktrees(ctx.cwd)) {
+    const dotenv = Bun.file(join(path, ".env"));
+    if (!await dotenv.exists())
+      continue;
+    const parsed = parseDotenv(await dotenv.text());
+    for (const [key, byWorktree] of Object.entries(envs)) {
+      if (!(key in parsed))
+        delete byWorktree[name];
+    }
+    for (const [key, value] of Object.entries(parsed)) {
+      (envs[key] ??= {})[name] = value;
+    }
+    ctx.log(`Pulled ${name}`);
+  }
+  for (const [key, byWorktree] of Object.entries(envs)) {
+    if (Object.keys(byWorktree).length === 0)
+      delete envs[key];
+  }
+  await Bun.write(valuesPath, Bun.YAML.stringify(values, null, 2));
+  return 0;
+}
+async function edit(ctx) {
+  const pulled = await pull(ctx);
+  if (pulled !== 0)
+    return pulled;
+  const valuesPath = join(await findRoot(ctx.cwd), ".envs/values.yml");
+  const code = await ctx.openEditor(valuesPath);
+  if (code !== 0)
+    return code;
+  return await push(ctx);
+}
+async function run(args, ctx = defaultContext()) {
+  const [command = "help"] = args;
+  switch (command) {
+    case "help":
+    case "--help":
+    case "-h":
+      ctx.log(HELP);
+      return 0;
+    case "init":
+      return await init(ctx);
+    case "push":
+      return await push(ctx);
+    case "pull":
+      return await pull(ctx);
+    case "edit":
+      return await edit(ctx);
+    default:
+      ctx.error(`Unknown command: ${command}
+
+${HELP}`);
+      return 1;
+  }
+}
+
+// src/bin/envs.ts
+process.exit(await run(Bun.argv.slice(2)));

package/package.json

@@ -1,22 +1,22 @@
 {
   "name": "@jondotsoy/envs",
-  "version": "0.0.1",
-  "module": "index.ts",
-  "type": "module",
-  "bin": {
-    "envs": "src/bin/envs.ts"
+  "version": "0.0.3",
+  "license": "MIT",
+  "author": {
+    "name": "Jonathan Delgado",
+    "email": "hi@jon.soy",
+    "url": "https://jon.soy"
   },
-  "devDependencies": {
-    "@types/bun": "latest",
-    "ajv": "^8.20.0"
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/JonDotsoy/envs.git"
   },
-  "peerDependencies": {
-    "typescript": "^7"
+  "bugs": {
+    "url": "https://github.com/JonDotsoy/envs/issues"
   },
-  "files": [
-    "src"
-  ],
-  "scripts": {
-    "build": "bun scripts/build.ts"
+  "module": "envs.js",
+  "type": "module",
+  "bin": {
+    "envs": "envs.js"
   }
 }

package/README.md

@@ -1,15 +0,0 @@
-# init
-
-To install dependencies:
-
-```bash
-bun install
-```
-
-To run:
-
-```bash
-bun run index.ts
-```
-
-This project was created using `bun init` in bun v1.4.2. [Bun](https://bun.com) is a fast all-in-one JavaScript runtime.

package/src/bin/envs.ts

@@ -1,4 +0,0 @@
-#!/usr/bin/env bun
-import { run } from "../envs";
-
-process.exit(await run(Bun.argv.slice(2)));

package/src/envs.ts

@@ -1,230 +0,0 @@
-import { mkdir } from "node:fs/promises";
-import { basename, dirname, join } from "node:path";
-import { $ } from "bun";
-
-export const HELP = `Usage: envs <command>
-
-Commands:
-  init    Create the .envs/ directory (.gitignore, values.yml)
-  pull    Read each worktree's .env and write it into .envs/values.yml
-  push    Write defaults and .envs/values.yml into the .env of each worktree
-  edit    Pull, open .envs/values.yml in VS Code (code -w), then push
-  help    Show this help message
-`;
-
-export interface Context {
-  /** Directory the command runs from. */
-  cwd: string;
-  log(message: string): void;
-  error(message: string): void;
-  /** Opens a file in the editor and resolves with its exit code once closed. */
-  openEditor(path: string): Promise<number>;
-}
-
-export const defaultContext = (): Context => ({
-  cwd: process.cwd(),
-  log: (message) => console.log(message),
-  error: (message) => console.error(message),
-  openEditor: async (path) => {
-    const proc = Bun.spawn(["code", "-w", path], {
-      env: { ...process.env },
-      stdio: ["inherit", "inherit", "inherit"],
-    });
-    return await proc.exited;
-  },
-});
-
-interface Values {
-  defaults?: Record<string, string>;
-  envs?: Record<string, Record<string, string>>;
-}
-
-export interface Worktree {
-  name: string;
-  path: string;
-}
-
-/** Root of the main git workspace; inside a worktree this is the parent repo. Falls back to cwd outside git. */
-export async function findRoot(cwd: string): Promise<string> {
-  const result = await $`git rev-parse --path-format=absolute --git-common-dir`
-    .cwd(cwd)
-    .nothrow()
-    .quiet();
-  if (result.exitCode !== 0) return cwd;
-  return dirname(result.stdout.toString().trim());
-}
-
-/** Lists the main workspace and its worktrees; `name` is the branch (or dir name when detached). */
-export async function listWorktrees(cwd: string): Promise<Worktree[]> {
-  const out = await $`git worktree list --porcelain`.cwd(cwd).text();
-  return out
-    .trim()
-    .split("\n\n")
-    .map((block) => {
-      const lines = block.split("\n");
-      const path = lines.find((l) => l.startsWith("worktree "))!.slice(9);
-      const branch = lines.find((l) => l.startsWith("branch "));
-      return {
-        path,
-        name: branch
-          ? branch.slice("branch refs/heads/".length)
-          : basename(path),
-      };
-    });
-}
-
-/** Minimal .env parser: KEY=VALUE lines, `#` comments, optional quotes and `export`. */
-export function parseDotenv(text: string): Record<string, string> {
-  const result: Record<string, string> = {};
-  for (const raw of text.split(/\r?\n/)) {
-    const line = raw.trim();
-    if (!line || line.startsWith("#")) continue;
-    const match = line.match(/^(?:export\s+)?([\w.-]+)\s*=\s*(.*)$/);
-    if (!match) continue;
-    let value = match[2]!.trim();
-    const quote = value[0];
-    if ((quote === '"' || quote === "'") && value.lastIndexOf(quote) > 0) {
-      value = value.slice(1, value.lastIndexOf(quote));
-    } else {
-      value = value.replace(/\s+#.*$/, "");
-    }
-    result[match[1]!] = value;
-  }
-  return result;
-}
-
-export function formatDotenvValue(value: string): string {
-  if (value !== "" && !/[\s#"'\\$]/.test(value)) return value;
-  return value.includes('"') ? `'${value}'` : `"${value}"`;
-}
-
-/** Sets KEY=VALUE for each entry, updating existing lines in place and appending new ones. */
-export function updateDotenv(
-  text: string,
-  entries: Record<string, string>,
-): string {
-  const pending = new Map(Object.entries(entries));
-  const lines = text === "" ? [] : text.replace(/\n$/, "").split("\n");
-  const updated = lines.map((line) => {
-    const key = line.trim().match(/^(?:export\s+)?([\w.-]+)\s*=/)?.[1];
-    if (key === undefined || !pending.has(key)) return line;
-    const value = pending.get(key)!;
-    pending.delete(key);
-    return `${key}=${formatDotenvValue(value)}`;
-  });
-  for (const [key, value] of pending) {
-    updated.push(`${key}=${formatDotenvValue(value)}`);
-  }
-  return updated.join("\n") + "\n";
-}
-
-/** Reads values.yml; returns undefined (after reporting) when `envs init` was not run. */
-async function readValues(
-  ctx: Context,
-): Promise<{ path: string; values: Values } | undefined> {
-  const path = join(await findRoot(ctx.cwd), ".envs/values.yml");
-  if (!(await Bun.file(path).exists())) {
-    ctx.error(`${path} not found. Run \`envs init\` first.`);
-    return undefined;
-  }
-  const values = (Bun.YAML.parse(await Bun.file(path).text()) ?? {}) as Values;
-  return { path, values };
-}
-
-export async function init(ctx: Context): Promise<number> {
-  const root = await findRoot(ctx.cwd);
-  const files = { ".envs/.gitignore": "*\n", ".envs/values.yml": "" };
-  await mkdir(join(root, ".envs"), { recursive: true });
-  for (const [name, content] of Object.entries(files)) {
-    const path = join(root, name);
-    if (await Bun.file(path).exists()) {
-      ctx.log(`${path} already exists`);
-    } else {
-      await Bun.write(path, content);
-      ctx.log(`Created ${path}`);
-    }
-  }
-  return 0;
-}
-
-export async function push(ctx: Context): Promise<number> {
-  const read = await readValues(ctx);
-  if (!read) return 1;
-  const { values } = read;
-  for (const { name, path } of await listWorktrees(ctx.cwd)) {
-    // Defaults apply to every worktree; per-worktree values override them.
-    const entries: Record<string, string> = {};
-    for (const [key, value] of Object.entries(values.defaults ?? {})) {
-      entries[key] = String(value);
-    }
-    for (const [key, byWorktree] of Object.entries(values.envs ?? {})) {
-      if (name in byWorktree) entries[key] = String(byWorktree[name]);
-    }
-    if (Object.keys(entries).length === 0) continue;
-    const dotenv = Bun.file(join(path, ".env"));
-    const current = (await dotenv.exists()) ? await dotenv.text() : "";
-    await Bun.write(dotenv, updateDotenv(current, entries));
-    ctx.log(`Pushed ${name}`);
-  }
-  return 0;
-}
-
-export async function pull(ctx: Context): Promise<number> {
-  const read = await readValues(ctx);
-  if (!read) return 1;
-  const { path: valuesPath, values } = read;
-  const envs = (values.envs ??= {});
-  for (const { name, path } of await listWorktrees(ctx.cwd)) {
-    const dotenv = Bun.file(join(path, ".env"));
-    if (!(await dotenv.exists())) continue;
-    const parsed = parseDotenv(await dotenv.text());
-    // Drop keys that are no longer in this worktree's .env.
-    for (const [key, byWorktree] of Object.entries(envs)) {
-      if (!(key in parsed)) delete byWorktree[name];
-    }
-    for (const [key, value] of Object.entries(parsed)) {
-      (envs[key] ??= {})[name] = value;
-    }
-    ctx.log(`Pulled ${name}`);
-  }
-  for (const [key, byWorktree] of Object.entries(envs)) {
-    if (Object.keys(byWorktree).length === 0) delete envs[key];
-  }
-  await Bun.write(valuesPath, Bun.YAML.stringify(values, null, 2));
-  return 0;
-}
-
-export async function edit(ctx: Context): Promise<number> {
-  const pulled = await pull(ctx);
-  if (pulled !== 0) return pulled;
-  const valuesPath = join(await findRoot(ctx.cwd), ".envs/values.yml");
-  const code = await ctx.openEditor(valuesPath);
-  if (code !== 0) return code;
-  return await push(ctx);
-}
-
-/** Runs a command; resolves with the process exit code. */
-export async function run(
-  args: string[],
-  ctx: Context = defaultContext(),
-): Promise<number> {
-  const [command = "help"] = args;
-  switch (command) {
-    case "help":
-    case "--help":
-    case "-h":
-      ctx.log(HELP);
-      return 0;
-    case "init":
-      return await init(ctx);
-    case "push":
-      return await push(ctx);
-    case "pull":
-      return await pull(ctx);
-    case "edit":
-      return await edit(ctx);
-    default:
-      ctx.error(`Unknown command: ${command}\n\n${HELP}`);
-      return 1;
-  }
-}