@alfe.ai/config 0.0.1

package/README.md

@@ -0,0 +1,34 @@
+# packages/config (`@alfe.ai/config`)
+
+**Config** — read/write `~/.alfe/config.toml` for Alfe CLI and gateway.
+
+## What It Does
+
+Shared config management for the Alfe user-side tools (CLI, gateway daemon, plugins). Reads and writes the user's local config file at `~/.alfe/config.toml`.
+
+- **`readConfig()`** — read and parse `~/.alfe/config.toml`
+- **`writeConfig(config)`** — write config to `~/.alfe/config.toml`
+- **`configExists()`** — check if config file exists
+- **`getApiEndpoint()`** — resolve API URL from config or token prefix
+- **`getEndpointFromToken(token)`** — derive API endpoint from token prefix (`alfe_dev_`, `alfe_test_`, `alfe_live_`)
+
+## Config Format
+
+```toml
+# ~/.alfe/config.toml
+api_key = "alfe_live_xxxx..."
+gateway = "https://api.alfe.ai"  # optional override
+```
+
+The API endpoint is derived automatically from the token prefix unless `gateway` is explicitly set.
+
+## Development
+
+```bash
+pnpm install
+pnpm --filter @alfe.ai/config build
+```
+
+## Dependencies
+
+- **smol-toml** — TOML parsing and serialization

package/dist/index.d.ts

@@ -0,0 +1,47 @@
+//#region src/index.d.ts
+/**
+ * @alfe.ai/config — read/write ~/.alfe/config.toml
+ *
+ * Shared across CLI, gateway, and other services so all can
+ * resolve the user's API key without circular dependencies.
+ */
+interface AlfeConfig {
+  api_key: string;
+  gateway?: string;
+  gateway_url?: string;
+}
+/**
+ * Derive the API endpoint URL from a token's prefix.
+ * Throws if the token doesn't match any known prefix.
+ */
+declare function getEndpointFromToken(token: string): string;
+/**
+ * Derive the ai-proxy URL from a token's prefix.
+ * Used by the local ai-proxy to know where to forward requests.
+ */
+declare function getAiProxyUrlFromToken(token: string): string;
+/**
+ * Check if ~/.alfe/config.toml exists.
+ */
+declare function configExists(): boolean;
+/**
+ * Read the Alfe config from ~/.alfe/config.toml.
+ * Throws if the file doesn't exist or is malformed.
+ */
+declare function readConfig(): Promise<AlfeConfig>;
+/**
+ * Write the Alfe config to ~/.alfe/config.toml.
+ * Creates the ~/.alfe directory if it doesn't exist.
+ */
+declare function writeConfig(config: AlfeConfig): Promise<void>;
+/**
+ * Add or update a [runtimes.<name>] section in ~/.alfe/config.toml.
+ * Preserves existing config values and only merges the runtime section.
+ */
+declare function writeRuntimeConfig(name: string, runtimeConfig: {
+  workspace: string;
+}): Promise<void>;
+//# sourceMappingURL=index.d.ts.map
+//#endregion
+export { AlfeConfig, configExists, getAiProxyUrlFromToken, getEndpointFromToken, readConfig, writeConfig, writeRuntimeConfig };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";;AAaA;AA2BA;AAaA;AAYA;AAQA;AAAgC,UA5Df,UAAA,CA4De;SAAY,EAAA,MAAA;SAAR,CAAA,EAAA,MAAA;EAAO,WAAA,CAAA,EAAA,MAAA;AA2B3C;;;;;AAmBsB,iBA/EN,oBAAA,CAkFN,KAAA,EAAA,MAAA,CAAA,EAAA,MAAA;;;;;iBArEM,sBAAA;;;;iBAYA,YAAA,CAAA;;;;;iBAQM,UAAA,CAAA,GAAc,QAAQ;;;;;iBA2BtB,WAAA,SAAoB,aAAa;;;;;iBAmBjC,kBAAA;;IAGnB"}

package/dist/index.js

@@ -0,0 +1,87 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { parse, stringify } from "smol-toml";
+//#region src/index.ts
+/**
+* @alfe.ai/config — read/write ~/.alfe/config.toml
+*
+* Shared across CLI, gateway, and other services so all can
+* resolve the user's API key without circular dependencies.
+*/
+const ALFE_DIR = join(homedir(), ".alfe");
+const CONFIG_PATH = join(ALFE_DIR, "config.toml");
+const TOKEN_PREFIX_MAP = {
+	"alfe_dev_": "https://api.dev.alfe.ai",
+	"alfe_test_": "https://api.test.alfe.ai",
+	"alfe_live_": "https://api.alfe.ai"
+};
+const AI_PROXY_PREFIX_MAP = {
+	"alfe_dev_": "https://ai.dev.alfe.ai",
+	"alfe_test_": "https://ai.test.alfe.ai",
+	"alfe_live_": "https://ai.alfe.ai"
+};
+/**
+* Derive the API endpoint URL from a token's prefix.
+* Throws if the token doesn't match any known prefix.
+*/
+function getEndpointFromToken(token) {
+	for (const [prefix, url] of Object.entries(TOKEN_PREFIX_MAP)) if (token.startsWith(prefix)) return url;
+	throw new Error(`Unknown token prefix — expected alfe_dev_, alfe_test_, or alfe_live_`);
+}
+/**
+* Derive the ai-proxy URL from a token's prefix.
+* Used by the local ai-proxy to know where to forward requests.
+*/
+function getAiProxyUrlFromToken(token) {
+	for (const [prefix, url] of Object.entries(AI_PROXY_PREFIX_MAP)) if (token.startsWith(prefix)) return url;
+	throw new Error(`Unknown token prefix — expected alfe_dev_, alfe_test_, or alfe_live_`);
+}
+/**
+* Check if ~/.alfe/config.toml exists.
+*/
+function configExists() {
+	return existsSync(CONFIG_PATH);
+}
+/**
+* Read the Alfe config from ~/.alfe/config.toml.
+* Throws if the file doesn't exist or is malformed.
+*/
+async function readConfig() {
+	if (!configExists()) throw new Error("Config not found. Run `alfe login` to set up your API key.");
+	const parsed = parse(await readFile(CONFIG_PATH, "utf-8"));
+	if (typeof parsed.api_key !== "string" || !parsed.api_key) throw new Error("Invalid config: missing api_key. Run `alfe login` to reconfigure.");
+	return {
+		api_key: parsed.api_key,
+		gateway: parsed.gateway,
+		gateway_url: parsed.gateway_url
+	};
+}
+/**
+* Write the Alfe config to ~/.alfe/config.toml.
+* Creates the ~/.alfe directory if it doesn't exist.
+*/
+async function writeConfig(config) {
+	await mkdir(ALFE_DIR, { recursive: true });
+	const data = { api_key: config.api_key };
+	if (config.gateway) data.gateway = config.gateway;
+	await writeFile(CONFIG_PATH, stringify(data) + "\n", "utf-8");
+}
+/**
+* Add or update a [runtimes.<name>] section in ~/.alfe/config.toml.
+* Preserves existing config values and only merges the runtime section.
+*/
+async function writeRuntimeConfig(name, runtimeConfig) {
+	await mkdir(ALFE_DIR, { recursive: true });
+	let existing = {};
+	if (existsSync(CONFIG_PATH)) existing = parse(await readFile(CONFIG_PATH, "utf-8"));
+	const runtimes = existing.runtimes ?? {};
+	runtimes[name] = { workspace: runtimeConfig.workspace };
+	existing.runtimes = runtimes;
+	await writeFile(CONFIG_PATH, stringify(existing) + "\n", "utf-8");
+}
+//#endregion
+export { configExists, getAiProxyUrlFromToken, getEndpointFromToken, readConfig, writeConfig, writeRuntimeConfig };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * @alfe.ai/config — read/write ~/.alfe/config.toml\n *\n * Shared across CLI, gateway, and other services so all can\n * resolve the user's API key without circular dependencies.\n */\n\nimport { readFile, writeFile, mkdir } from \"node:fs/promises\";\nimport { existsSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { homedir } from \"node:os\";\nimport { parse, stringify } from \"smol-toml\";\n\nexport interface AlfeConfig {\n  api_key: string;\n  gateway?: string;\n  gateway_url?: string;\n}\n\nconst ALFE_DIR = join(homedir(), \".alfe\");\nconst CONFIG_PATH = join(ALFE_DIR, \"config.toml\");\n\n// ── Token-based endpoint derivation ─────────────────────────\n\nconst TOKEN_PREFIX_MAP: Record<string, string> = {\n  'alfe_dev_':  'https://api.dev.alfe.ai',\n  'alfe_test_': 'https://api.test.alfe.ai',\n  'alfe_live_': 'https://api.alfe.ai',\n};\n\nconst AI_PROXY_PREFIX_MAP: Record<string, string> = {\n  'alfe_dev_':  'https://ai.dev.alfe.ai',\n  'alfe_test_': 'https://ai.test.alfe.ai',\n  'alfe_live_': 'https://ai.alfe.ai',\n};\n\n/**\n * Derive the API endpoint URL from a token's prefix.\n * Throws if the token doesn't match any known prefix.\n */\nexport function getEndpointFromToken(token: string): string {\n  for (const [prefix, url] of Object.entries(TOKEN_PREFIX_MAP)) {\n    if (token.startsWith(prefix)) return url;\n  }\n  throw new Error(\n    `Unknown token prefix — expected alfe_dev_, alfe_test_, or alfe_live_`,\n  );\n}\n\n/**\n * Derive the ai-proxy URL from a token's prefix.\n * Used by the local ai-proxy to know where to forward requests.\n */\nexport function getAiProxyUrlFromToken(token: string): string {\n  for (const [prefix, url] of Object.entries(AI_PROXY_PREFIX_MAP)) {\n    if (token.startsWith(prefix)) return url;\n  }\n  throw new Error(\n    `Unknown token prefix — expected alfe_dev_, alfe_test_, or alfe_live_`,\n  );\n}\n\n/**\n * Check if ~/.alfe/config.toml exists.\n */\nexport function configExists(): boolean {\n  return existsSync(CONFIG_PATH);\n}\n\n/**\n * Read the Alfe config from ~/.alfe/config.toml.\n * Throws if the file doesn't exist or is malformed.\n */\nexport async function readConfig(): Promise<AlfeConfig> {\n  if (!configExists()) {\n    throw new Error(\n      \"Config not found. Run `alfe login` to set up your API key.\",\n    );\n  }\n\n  const raw = await readFile(CONFIG_PATH, \"utf-8\");\n  const parsed = parse(raw);\n\n  if (typeof parsed.api_key !== \"string\" || !parsed.api_key) {\n    throw new Error(\n      \"Invalid config: missing api_key. Run `alfe login` to reconfigure.\",\n    );\n  }\n\n  return {\n    api_key: parsed.api_key,\n    gateway: parsed.gateway as string | undefined,\n    gateway_url: parsed.gateway_url as string | undefined,\n  };\n}\n\n/**\n * Write the Alfe config to ~/.alfe/config.toml.\n * Creates the ~/.alfe directory if it doesn't exist.\n */\nexport async function writeConfig(config: AlfeConfig): Promise<void> {\n  await mkdir(ALFE_DIR, { recursive: true });\n\n  const data: Record<string, string> = {\n    api_key: config.api_key,\n  };\n\n  if (config.gateway) {\n    data.gateway = config.gateway;\n  }\n\n  const toml = stringify(data);\n  await writeFile(CONFIG_PATH, toml + \"\\n\", \"utf-8\");\n}\n\n/**\n * Add or update a [runtimes.<name>] section in ~/.alfe/config.toml.\n * Preserves existing config values and only merges the runtime section.\n */\nexport async function writeRuntimeConfig(\n  name: string,\n  runtimeConfig: { workspace: string },\n): Promise<void> {\n  await mkdir(ALFE_DIR, { recursive: true });\n\n  let existing: Record<string, unknown> = {};\n  if (existsSync(CONFIG_PATH)) {\n    const raw = await readFile(CONFIG_PATH, \"utf-8\");\n    existing = parse(raw) as Record<string, unknown>;\n  }\n\n  const runtimes = (existing.runtimes ?? {}) as Record<\n    string,\n    Record<string, unknown>\n  >;\n  runtimes[name] = { workspace: runtimeConfig.workspace };\n  existing.runtimes = runtimes;\n\n  const toml = stringify(existing);\n  await writeFile(CONFIG_PATH, toml + \"\\n\", \"utf-8\");\n}\n"],"mappings":";;;;;;;;;;;;AAmBA,MAAM,WAAW,KAAK,SAAS,EAAE,QAAQ;AACzC,MAAM,cAAc,KAAK,UAAU,cAAc;AAIjD,MAAM,mBAA2C;CAC/C,aAAc;CACd,cAAc;CACd,cAAc;CACf;AAED,MAAM,sBAA8C;CAClD,aAAc;CACd,cAAc;CACd,cAAc;CACf;;;;;AAMD,SAAgB,qBAAqB,OAAuB;AAC1D,MAAK,MAAM,CAAC,QAAQ,QAAQ,OAAO,QAAQ,iBAAiB,CAC1D,KAAI,MAAM,WAAW,OAAO,CAAE,QAAO;AAEvC,OAAM,IAAI,MACR,uEACD;;;;;;AAOH,SAAgB,uBAAuB,OAAuB;AAC5D,MAAK,MAAM,CAAC,QAAQ,QAAQ,OAAO,QAAQ,oBAAoB,CAC7D,KAAI,MAAM,WAAW,OAAO,CAAE,QAAO;AAEvC,OAAM,IAAI,MACR,uEACD;;;;;AAMH,SAAgB,eAAwB;AACtC,QAAO,WAAW,YAAY;;;;;;AAOhC,eAAsB,aAAkC;AACtD,KAAI,CAAC,cAAc,CACjB,OAAM,IAAI,MACR,6DACD;CAIH,MAAM,SAAS,MADH,MAAM,SAAS,aAAa,QAAQ,CACvB;AAEzB,KAAI,OAAO,OAAO,YAAY,YAAY,CAAC,OAAO,QAChD,OAAM,IAAI,MACR,oEACD;AAGH,QAAO;EACL,SAAS,OAAO;EAChB,SAAS,OAAO;EAChB,aAAa,OAAO;EACrB;;;;;;AAOH,eAAsB,YAAY,QAAmC;AACnE,OAAM,MAAM,UAAU,EAAE,WAAW,MAAM,CAAC;CAE1C,MAAM,OAA+B,EACnC,SAAS,OAAO,SACjB;AAED,KAAI,OAAO,QACT,MAAK,UAAU,OAAO;AAIxB,OAAM,UAAU,aADH,UAAU,KAAK,GACQ,MAAM,QAAQ;;;;;;AAOpD,eAAsB,mBACpB,MACA,eACe;AACf,OAAM,MAAM,UAAU,EAAE,WAAW,MAAM,CAAC;CAE1C,IAAI,WAAoC,EAAE;AAC1C,KAAI,WAAW,YAAY,CAEzB,YAAW,MADC,MAAM,SAAS,aAAa,QAAQ,CAC3B;CAGvB,MAAM,WAAY,SAAS,YAAY,EAAE;AAIzC,UAAS,QAAQ,EAAE,WAAW,cAAc,WAAW;AACvD,UAAS,WAAW;AAGpB,OAAM,UAAU,aADH,UAAU,SAAS,GACI,MAAM,QAAQ"}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@alfe.ai/config",
+  "version": "0.0.1",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "smol-toml": "^1.3.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint ."
+  }
+}