engrm 0.1.0

package/src/config.ts

@@ -0,0 +1,238 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir, hostname } from "node:os";
+import { join } from "node:path";
+import { randomBytes } from "node:crypto";
+
+// --- Types ---
+
+export interface SyncConfig {
+  enabled: boolean;
+  interval_seconds: number;
+  batch_size: number;
+}
+
+export interface SearchConfig {
+  default_limit: number;
+  local_boost: number;
+  scope: "personal" | "team" | "all";
+}
+
+export interface ScrubbingConfig {
+  enabled: boolean;
+  custom_patterns: string[];
+  default_sensitivity: "shared" | "personal" | "secret";
+}
+
+export interface TeamMembership {
+  id: string;
+  name: string;
+  namespace: string;
+}
+
+export interface Config {
+  candengo_url: string;
+  candengo_api_key: string;
+  site_id: string;
+  namespace: string;
+  user_id: string;
+  user_email: string;
+  device_id: string;
+  teams: TeamMembership[];
+  sync: SyncConfig;
+  search: SearchConfig;
+  scrubbing: ScrubbingConfig;
+}
+
+// --- Paths ---
+
+const CONFIG_DIR = join(homedir(), ".engrm");
+const SETTINGS_PATH = join(CONFIG_DIR, "settings.json");
+const DB_PATH = join(CONFIG_DIR, "engrm.db");
+
+export function getConfigDir(): string {
+  return CONFIG_DIR;
+}
+
+export function getSettingsPath(): string {
+  return SETTINGS_PATH;
+}
+
+export function getDbPath(): string {
+  return DB_PATH;
+}
+
+// --- Device ID ---
+
+function generateDeviceId(): string {
+  const host = hostname().toLowerCase().replace(/[^a-z0-9-]/g, "");
+  const suffix = randomBytes(4).toString("hex");
+  return `${host}-${suffix}`;
+}
+
+// --- Defaults ---
+
+function createDefaultConfig(): Config {
+  return {
+    candengo_url: "",
+    candengo_api_key: "",
+    site_id: "",
+    namespace: "",
+    user_id: "",
+    user_email: "",
+    device_id: generateDeviceId(),
+    teams: [],
+    sync: {
+      enabled: true,
+      interval_seconds: 30,
+      batch_size: 50,
+    },
+    search: {
+      default_limit: 10,
+      local_boost: 1.2,
+      scope: "all",
+    },
+    scrubbing: {
+      enabled: true,
+      custom_patterns: [],
+      default_sensitivity: "shared",
+    },
+  };
+}
+
+// --- Load / Save ---
+
+export function loadConfig(): Config {
+  if (!existsSync(SETTINGS_PATH)) {
+    throw new Error(
+      `Config not found at ${SETTINGS_PATH}. Run 'engrm init --manual' to configure.`
+    );
+  }
+
+  const raw = readFileSync(SETTINGS_PATH, "utf-8");
+  let parsed: unknown;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    throw new Error(`Invalid JSON in ${SETTINGS_PATH}`);
+  }
+
+  if (typeof parsed !== "object" || parsed === null) {
+    throw new Error(`Config at ${SETTINGS_PATH} is not a JSON object`);
+  }
+
+  const config = parsed as Record<string, unknown>;
+
+  // Merge with defaults to fill any missing fields
+  const defaults = createDefaultConfig();
+  return {
+    candengo_url: asString(config["candengo_url"], defaults.candengo_url),
+    candengo_api_key: asString(config["candengo_api_key"], defaults.candengo_api_key),
+    site_id: asString(config["site_id"], defaults.site_id),
+    namespace: asString(config["namespace"], defaults.namespace),
+    user_id: asString(config["user_id"], defaults.user_id),
+    user_email: asString(config["user_email"], defaults.user_email),
+    device_id: asString(config["device_id"], defaults.device_id),
+    teams: asTeams(config["teams"], defaults.teams),
+    sync: {
+      enabled: asBool(
+        (config["sync"] as Record<string, unknown> | undefined)?.["enabled"],
+        defaults.sync.enabled
+      ),
+      interval_seconds: asNumber(
+        (config["sync"] as Record<string, unknown> | undefined)?.["interval_seconds"],
+        defaults.sync.interval_seconds
+      ),
+      batch_size: asNumber(
+        (config["sync"] as Record<string, unknown> | undefined)?.["batch_size"],
+        defaults.sync.batch_size
+      ),
+    },
+    search: {
+      default_limit: asNumber(
+        (config["search"] as Record<string, unknown> | undefined)?.["default_limit"],
+        defaults.search.default_limit
+      ),
+      local_boost: asNumber(
+        (config["search"] as Record<string, unknown> | undefined)?.["local_boost"],
+        defaults.search.local_boost
+      ),
+      scope: asScope(
+        (config["search"] as Record<string, unknown> | undefined)?.["scope"],
+        defaults.search.scope
+      ),
+    },
+    scrubbing: {
+      enabled: asBool(
+        (config["scrubbing"] as Record<string, unknown> | undefined)?.["enabled"],
+        defaults.scrubbing.enabled
+      ),
+      custom_patterns: asStringArray(
+        (config["scrubbing"] as Record<string, unknown> | undefined)?.["custom_patterns"],
+        defaults.scrubbing.custom_patterns
+      ),
+      default_sensitivity: asSensitivity(
+        (config["scrubbing"] as Record<string, unknown> | undefined)?.["default_sensitivity"],
+        defaults.scrubbing.default_sensitivity
+      ),
+    },
+  };
+}
+
+export function saveConfig(config: Config): void {
+  if (!existsSync(CONFIG_DIR)) {
+    mkdirSync(CONFIG_DIR, { recursive: true });
+  }
+  writeFileSync(SETTINGS_PATH, JSON.stringify(config, null, 2) + "\n", "utf-8");
+}
+
+export function configExists(): boolean {
+  return existsSync(SETTINGS_PATH);
+}
+
+// --- Type helpers ---
+
+function asString(value: unknown, fallback: string): string {
+  return typeof value === "string" ? value : fallback;
+}
+
+function asNumber(value: unknown, fallback: number): number {
+  return typeof value === "number" && !Number.isNaN(value) ? value : fallback;
+}
+
+function asBool(value: unknown, fallback: boolean): boolean {
+  return typeof value === "boolean" ? value : fallback;
+}
+
+function asStringArray(value: unknown, fallback: string[]): string[] {
+  return Array.isArray(value) && value.every((v) => typeof v === "string")
+    ? (value as string[])
+    : fallback;
+}
+
+function asScope(
+  value: unknown,
+  fallback: "personal" | "team" | "all"
+): "personal" | "team" | "all" {
+  if (value === "personal" || value === "team" || value === "all") return value;
+  return fallback;
+}
+
+function asSensitivity(
+  value: unknown,
+  fallback: "shared" | "personal" | "secret"
+): "shared" | "personal" | "secret" {
+  if (value === "shared" || value === "personal" || value === "secret") return value;
+  return fallback;
+}
+
+function asTeams(value: unknown, fallback: TeamMembership[]): TeamMembership[] {
+  if (!Array.isArray(value)) return fallback;
+  return value.filter(
+    (t): t is TeamMembership =>
+      typeof t === "object" &&
+      t !== null &&
+      typeof t.id === "string" &&
+      typeof t.name === "string" &&
+      typeof t.namespace === "string"
+  );
+}