@rerouter/helper 0.0.0-stage → 0.1.1

package/src/lib/env.js

@@ -0,0 +1,32 @@
+/**
+ * Helper configuration source. SECURITY RULE: the API key is only read from
+ * env REROUTER_API_KEY — never accepted as an argument, printed, or written
+ * to any file.
+ */
+
+export const DEFAULT_BASE_URL = "https://api.rerouter.id";
+
+export function baseUrl() {
+  return (process.env.REROUTER_BASE_URL?.trim() || DEFAULT_BASE_URL).replace(/\/+$/, "");
+}
+
+export function apiKey() {
+  return process.env.REROUTER_API_KEY?.trim() || null;
+}
+
+export class MissingKeyError extends Error {
+  constructor() {
+    super(
+      "REROUTER_API_KEY is not set.\n" +
+        "  POSIX:      export REROUTER_API_KEY=sk-rr-...\n" +
+        "  PowerShell: $env:REROUTER_API_KEY = \"sk-rr-...\"\n" +
+        "Create a key in Rerouter dashboard → API Keys.",
+    );
+  }
+}
+
+export function requireApiKey() {
+  const key = apiKey();
+  if (!key) throw new MissingKeyError();
+  return key;
+}

package/src/lib/files.js

@@ -0,0 +1,85 @@
+import { promises as fs } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+
+/** Expand `~` to the user home directory. */
+export function expandHome(p) {
+  if (p === "~") return os.homedir();
+  if (p.startsWith("~/") || p.startsWith("~\\")) return path.join(os.homedir(), p.slice(2));
+  return p;
+}
+
+export async function readTextIfExists(file) {
+  try {
+    return await fs.readFile(file, "utf8");
+  } catch (err) {
+    if (err?.code === "ENOENT") return null;
+    throw err;
+  }
+}
+
+function stamp() {
+  return new Date().toISOString().replace(/[-:T]/g, "").slice(0, 14);
+}
+
+/** Copy file to `${file}.rerouter-backup-<timestamp>`; no-op if missing. */
+export async function backupFile(file) {
+  const existing = await readTextIfExists(file);
+  if (existing === null) return null;
+  const backupPath = `${file}.rerouter-backup-${stamp()}`;
+  await fs.writeFile(backupPath, existing, "utf8");
+  return backupPath;
+}
+
+export async function writeFileEnsured(file, content) {
+  await fs.mkdir(path.dirname(file), { recursive: true });
+  await fs.writeFile(file, content, "utf8");
+}
+
+/**
+ * Parse loose JSONC (line and block comments outside strings + trailing comma).
+ * Throws Error if ambiguous/broken — the caller asks for a manual merge and
+ * leaves the file intact.
+ */
+export function parseJsonc(text) {
+  let out = "";
+  let i = 0;
+  let inString = false;
+  let quote = "";
+  while (i < text.length) {
+    const ch = text[i];
+    const next = text[i + 1];
+    if (inString) {
+      out += ch;
+      if (ch === "\\") {
+        out += next ?? "";
+        i += 2;
+        continue;
+      }
+      if (ch === quote) inString = false;
+      i++;
+      continue;
+    }
+    if (ch === '"' || ch === "'") {
+      inString = true;
+      quote = ch;
+      out += ch;
+      i++;
+      continue;
+    }
+    if (ch === "/" && next === "/") {
+      while (i < text.length && text[i] !== "\n") i++;
+      continue;
+    }
+    if (ch === "/" && next === "*") {
+      i += 2;
+      while (i < text.length && !(text[i] === "*" && text[i + 1] === "/")) i++;
+      i += 2;
+      continue;
+    }
+    out += ch;
+    i++;
+  }
+  const stripped = out.replace(/,\s*([}\]])/g, "$1");
+  return JSON.parse(stripped);
+}