@jango-blockchained/hoox-cli 0.3.4 → 0.3.6

package/src/services/db/db-service.ts

@@ -28,7 +28,7 @@ export class DbService {
   async apply(
     dbName: string,
     remote: boolean,
-    schemaPath?: string,
+    schemaPath?: string
   ): Promise<string> {
     const path = schemaPath ?? "workers/trade-worker/schema.sql";
     const args = ["d1", "execute", dbName, "--file", path];
@@ -58,20 +58,13 @@ export class DbService {
     return DbService.parseTableNames(output);
   }
 
-  async query(
-    dbName: string,
-    sql: string,
-    remote: boolean,
-  ): Promise<string> {
+  async query(dbName: string, sql: string, remote: boolean): Promise<string> {
     const args = ["d1", "execute", dbName, "--command", sql, "--json"];
     if (remote) args.push("--remote");
     return await this.runWrangler(args);
   }
 
-  async export(
-    dbName: string,
-    outputPath?: string,
-  ): Promise<string> {
+  async export(dbName: string, outputPath?: string): Promise<string> {
     const outPath =
       outputPath ?? `backup-${new Date().toISOString().slice(0, 10)}.sql`;
     const args = ["d1", "export", dbName, "--output", outPath, "--remote"];
@@ -90,9 +83,9 @@ export class DbService {
       if (Array.isArray(parsed) && parsed.length > 0) {
         const first = parsed[0];
         if (first.results && Array.isArray(first.results)) {
-          return first.results.map(
-            (r: Record<string, unknown>) => String(r.name ?? ""),
-          ).filter(Boolean);
+          return first.results
+            .map((r: Record<string, unknown>) => String(r.name ?? ""))
+            .filter(Boolean);
         }
       }
     } catch {
@@ -114,9 +107,7 @@ export class DbService {
     const exitCode = await proc.exited;
 
     if (exitCode !== 0) {
-      throw new Error(
-        stderr.trim() || `wrangler exited with code ${exitCode}`,
-      );
+      throw new Error(stderr.trim() || `wrangler exited with code ${exitCode}`);
     }
 
     return stdout.trim();
@@ -128,7 +119,7 @@ export class DbService {
       if (await file.exists()) {
         const content = await file.text();
         const match = content.match(
-          /d1\s+execute\s+\S+\s+--command=["'](.+?)["']/s,
+          /d1\s+execute\s+\S+\s+--command=["'](.+?)["']/s
         );
         if (match) return match[1];
       }

package/src/services/env/env-service.test.ts

@@ -6,7 +6,7 @@ describe("EnvService", () => {
     it("returns all known env var definitions", () => {
       const defs = EnvService.getDefinitions();
       expect(defs.length).toBe(31);
-      expect(defs.some(d => d.name === "CLOUDFLARE_API_TOKEN")).toBe(true);
+      expect(defs.some((d) => d.name === "CLOUDFLARE_API_TOKEN")).toBe(true);
     });
 
     it("each definition has required fields", () => {
@@ -35,7 +35,9 @@ describe("EnvService", () => {
     });
 
     it("includes provided values", () => {
-      const content = EnvService.generateEnvLocal({ SUBDOMAIN_PREFIX: "myapp" });
+      const content = EnvService.generateEnvLocal({
+        SUBDOMAIN_PREFIX: "myapp",
+      });
       expect(content).toContain('SUBDOMAIN_PREFIX="myapp"');
     });
 
@@ -56,7 +58,9 @@ describe("EnvService", () => {
       expect(result["workers/agent-worker"]).toBeDefined();
       expect(result["workers/agent-worker"].AGENT_OPENAI_KEY).toBe("sk-123");
       expect(result["workers/telegram-worker"]).toBeDefined();
-      expect(result["workers/telegram-worker"].TELEGRAM_BOT_TOKEN).toBe("tg-456");
+      expect(result["workers/telegram-worker"].TELEGRAM_BOT_TOKEN).toBe(
+        "tg-456"
+      );
     });
 
     it("omits workers with no matching vars", () => {
@@ -84,14 +88,22 @@ describe("EnvService", () => {
       };
       const result = EnvService.getWorkerDevVars(vars);
       expect(result["workers/hoox"]).toBeDefined();
-      expect(result["workers/hoox"].WEBHOOK_API_KEY_BINDING).toBe("webhook-key");
+      expect(result["workers/hoox"].WEBHOOK_API_KEY_BINDING).toBe(
+        "webhook-key"
+      );
       expect(result["workers/hoox"].HA_TOKEN_BINDING).toBe("ha-token");
       expect(result["workers/trade-worker"].API_SERVICE_KEY).toBe("api-key");
-      expect(result["workers/telegram-worker"].TELEGRAM_SECRET_TOKEN).toBe("tg-secret");
+      expect(result["workers/telegram-worker"].TELEGRAM_SECRET_TOKEN).toBe(
+        "tg-secret"
+      );
       expect(result["workers/web3-wallet-worker"]).toBeDefined();
-      expect(result["workers/web3-wallet-worker"].WALLET_MNEMONIC_SECRET).toBe("mnemonic");
+      expect(result["workers/web3-wallet-worker"].WALLET_MNEMONIC_SECRET).toBe(
+        "mnemonic"
+      );
       expect(result["workers/email-worker"]).toBeDefined();
-      expect(result["workers/email-worker"].EMAIL_HOST).toBe("imap.example.com");
+      expect(result["workers/email-worker"].EMAIL_HOST).toBe(
+        "imap.example.com"
+      );
     });
   });
 
@@ -103,12 +115,16 @@ describe("EnvService", () => {
     });
 
     it("flags 'your_' placeholder values as missing", () => {
-      const result = EnvService.validate({ CLOUDFLARE_API_TOKEN: "your_cloudflare_api_token" });
+      const result = EnvService.validate({
+        CLOUDFLARE_API_TOKEN: "your_cloudflare_api_token",
+      });
       expect(result.missing).toContain("CLOUDFLARE_API_TOKEN");
     });
 
     it("flags 'generate_' placeholder values as missing", () => {
-      const result = EnvService.validate({ SESSION_SECRET: "generate_a_32_character_secure_random_string" });
+      const result = EnvService.validate({
+        SESSION_SECRET: "generate_a_32_character_secure_random_string",
+      });
       expect(result.missing).toContain("SESSION_SECRET");
     });
 
@@ -147,7 +163,9 @@ describe("EnvService", () => {
         SESSION_SECRET: "short",
       };
       const result = EnvService.validate(vars);
-      expect(result.warnings).toContain("SESSION_SECRET should be at least 32 characters");
+      expect(result.warnings).toContain(
+        "SESSION_SECRET should be at least 32 characters"
+      );
     });
   });
 
@@ -166,13 +184,15 @@ describe("EnvService", () => {
 
   describe("loadDotEnvAsync", () => {
     it("returns empty object for missing file", async () => {
-      const result = await EnvService.loadDotEnvAsync("/tmp/nonexistent-file-12345.env");
+      const result = await EnvService.loadDotEnvAsync(
+        "/tmp/nonexistent-file-12345.env"
+      );
       expect(Object.keys(result).length).toBe(0);
     });
 
     it("parses simple key=value lines", async () => {
       const filePath = "/tmp/test-simple-12345.env";
-      await Bun.write(filePath, 'KEY=value\nFOO=bar\n');
+      await Bun.write(filePath, "KEY=value\nFOO=bar\n");
       const result = await EnvService.loadDotEnvAsync(filePath);
       expect(result.KEY).toBe("value");
       expect(result.FOO).toBe("bar");
@@ -181,7 +201,10 @@ describe("EnvService", () => {
 
     it("strips double quotes from values", async () => {
       const filePath = "/tmp/test-quotes-12345.env";
-      await Bun.write(filePath, 'KEY="quoted value"\nNESTED="val with \\"quote\\""\n');
+      await Bun.write(
+        filePath,
+        'KEY="quoted value"\nNESTED="val with \\"quote\\""\n'
+      );
       const result = await EnvService.loadDotEnvAsync(filePath);
       // First quote-stripped value
       expect(result.KEY).toBe("quoted value");
@@ -190,7 +213,10 @@ describe("EnvService", () => {
 
     it("skips comments and blank lines", async () => {
       const filePath = "/tmp/test-comments-12345.env";
-      await Bun.write(filePath, '# this is a comment\n\nKEY=val\n# another comment\nFOO=bar\n');
+      await Bun.write(
+        filePath,
+        "# this is a comment\n\nKEY=val\n# another comment\nFOO=bar\n"
+      );
       const result = await EnvService.loadDotEnvAsync(filePath);
       expect(result.KEY).toBe("val");
       expect(result.FOO).toBe("bar");
@@ -200,7 +226,7 @@ describe("EnvService", () => {
 
     it("handles empty values", async () => {
       const filePath = "/tmp/test-empty-12345.env";
-      await Bun.write(filePath, 'EMPTY=\nKEY=val\n');
+      await Bun.write(filePath, "EMPTY=\nKEY=val\n");
       const result = await EnvService.loadDotEnvAsync(filePath);
       expect(result.EMPTY).toBe("");
       expect(result.KEY).toBe("val");

package/src/services/env/env-service.ts

@@ -21,47 +21,238 @@ export interface EnvValidationResult {
 export class EnvService {
   static getDefinitions(): EnvVarDefinition[] {
     return [
-      { name: "CLOUDFLARE_API_TOKEN", required: true, secret: true, section: "Cloudflare Account", hint: "API token with Workers/KV/D1/R2 permissions" },
-      { name: "CLOUDFLARE_ACCOUNT_ID", required: true, secret: false, section: "Cloudflare Account", hint: "From Cloudflare dashboard URL" },
-      { name: "CLOUDFLARE_SECRET_STORE_ID", required: false, secret: false, section: "Cloudflare Account", default: "", hint: "Optional" },
-      { name: "SUBDOMAIN_PREFIX", required: true, secret: false, section: "Cloudflare Account", default: "cryptolinx", hint: "Prefix for worker URLs" },
-      { name: "D1_INTERNAL_KEY", required: true, secret: true, section: "Internal Auth", hint: "Internal key for D1 worker auth" },
-      { name: "TRADE_INTERNAL_KEY", required: true, secret: true, section: "Internal Auth", hint: "Internal key for trade worker auth" },
-      { name: "AGENT_INTERNAL_KEY", required: true, secret: true, section: "Internal Auth", hint: "Internal key for agent worker auth" },
-      { name: "WEBHOOK_API_KEY_BINDING", required: true, secret: true, section: "Internal Auth", hint: "Webhook auth key for hoox gateway" },
-      { name: "INTERNAL_KEY_BINDING", required: true, secret: true, section: "Internal Auth", hint: "Shared internal auth key for inter-worker communication" },
-      { name: "API_SERVICE_KEY", required: true, secret: true, section: "Internal Auth", hint: "API service key for trade-worker" },
-      { name: "HA_TOKEN_BINDING", required: false, secret: true, section: "Internal Auth", hint: "Home Assistant token for hoox" },
-      { name: "TELEGRAM_BOT_TOKEN", required: false, secret: true, section: "Telegram", hint: "From @BotFather" },
-      { name: "TELEGRAM_SECRET_TOKEN", required: false, secret: true, section: "Telegram", hint: "Telegram webhook secret token" },
-      { name: "AGENT_OPENAI_KEY", required: false, secret: true, section: "AI Providers", hint: "OpenAI API key" },
-      { name: "AGENT_ANTHROPIC_KEY", required: false, secret: true, section: "AI Providers", hint: "Anthropic API key" },
-      { name: "AGENT_GOOGLE_KEY", required: false, secret: true, section: "AI Providers", hint: "Google AI API key" },
-      { name: "BINANCE_API_KEY", required: false, secret: true, section: "Exchanges", hint: "Binance API key" },
-      { name: "BINANCE_API_SECRET", required: false, secret: true, section: "Exchanges", hint: "Binance API secret" },
-      { name: "MEXC_API_KEY", required: false, secret: true, section: "Exchanges", hint: "MEXC API key" },
-      { name: "MEXC_API_SECRET", required: false, secret: true, section: "Exchanges", hint: "MEXC API secret" },
-      { name: "BYBIT_API_KEY", required: false, secret: true, section: "Exchanges", hint: "Bybit API key" },
-      { name: "BYBIT_API_SECRET", required: false, secret: true, section: "Exchanges", hint: "Bybit API secret" },
+      {
+        name: "CLOUDFLARE_API_TOKEN",
+        required: true,
+        secret: true,
+        section: "Cloudflare Account",
+        hint: "API token with Workers/KV/D1/R2 permissions",
+      },
+      {
+        name: "CLOUDFLARE_ACCOUNT_ID",
+        required: true,
+        secret: false,
+        section: "Cloudflare Account",
+        hint: "From Cloudflare dashboard URL",
+      },
+      {
+        name: "CLOUDFLARE_SECRET_STORE_ID",
+        required: false,
+        secret: false,
+        section: "Cloudflare Account",
+        default: "",
+        hint: "Optional",
+      },
+      {
+        name: "SUBDOMAIN_PREFIX",
+        required: true,
+        secret: false,
+        section: "Cloudflare Account",
+        default: "cryptolinx",
+        hint: "Prefix for worker URLs",
+      },
+      {
+        name: "D1_INTERNAL_KEY",
+        required: true,
+        secret: true,
+        section: "Internal Auth",
+        hint: "Internal key for D1 worker auth",
+      },
+      {
+        name: "TRADE_INTERNAL_KEY",
+        required: true,
+        secret: true,
+        section: "Internal Auth",
+        hint: "Internal key for trade worker auth",
+      },
+      {
+        name: "AGENT_INTERNAL_KEY",
+        required: true,
+        secret: true,
+        section: "Internal Auth",
+        hint: "Internal key for agent worker auth",
+      },
+      {
+        name: "WEBHOOK_API_KEY_BINDING",
+        required: true,
+        secret: true,
+        section: "Internal Auth",
+        hint: "Webhook auth key for hoox gateway",
+      },
+      {
+        name: "INTERNAL_KEY_BINDING",
+        required: true,
+        secret: true,
+        section: "Internal Auth",
+        hint: "Shared internal auth key for inter-worker communication",
+      },
+      {
+        name: "API_SERVICE_KEY",
+        required: true,
+        secret: true,
+        section: "Internal Auth",
+        hint: "API service key for trade-worker",
+      },
+      {
+        name: "HA_TOKEN_BINDING",
+        required: false,
+        secret: true,
+        section: "Internal Auth",
+        hint: "Home Assistant token for hoox",
+      },
+      {
+        name: "TELEGRAM_BOT_TOKEN",
+        required: false,
+        secret: true,
+        section: "Telegram",
+        hint: "From @BotFather",
+      },
+      {
+        name: "TELEGRAM_SECRET_TOKEN",
+        required: false,
+        secret: true,
+        section: "Telegram",
+        hint: "Telegram webhook secret token",
+      },
+      {
+        name: "AGENT_OPENAI_KEY",
+        required: false,
+        secret: true,
+        section: "AI Providers",
+        hint: "OpenAI API key",
+      },
+      {
+        name: "AGENT_ANTHROPIC_KEY",
+        required: false,
+        secret: true,
+        section: "AI Providers",
+        hint: "Anthropic API key",
+      },
+      {
+        name: "AGENT_GOOGLE_KEY",
+        required: false,
+        secret: true,
+        section: "AI Providers",
+        hint: "Google AI API key",
+      },
+      {
+        name: "BINANCE_API_KEY",
+        required: false,
+        secret: true,
+        section: "Exchanges",
+        hint: "Binance API key",
+      },
+      {
+        name: "BINANCE_API_SECRET",
+        required: false,
+        secret: true,
+        section: "Exchanges",
+        hint: "Binance API secret",
+      },
+      {
+        name: "MEXC_API_KEY",
+        required: false,
+        secret: true,
+        section: "Exchanges",
+        hint: "MEXC API key",
+      },
+      {
+        name: "MEXC_API_SECRET",
+        required: false,
+        secret: true,
+        section: "Exchanges",
+        hint: "MEXC API secret",
+      },
+      {
+        name: "BYBIT_API_KEY",
+        required: false,
+        secret: true,
+        section: "Exchanges",
+        hint: "Bybit API key",
+      },
+      {
+        name: "BYBIT_API_SECRET",
+        required: false,
+        secret: true,
+        section: "Exchanges",
+        hint: "Bybit API secret",
+      },
       // Email
-      { name: "EMAIL_HOST", required: false, secret: true, section: "Email", hint: "Email IMAP server host" },
-      { name: "EMAIL_USER", required: false, secret: true, section: "Email", hint: "Email IMAP username" },
-      { name: "EMAIL_PASS", required: false, secret: true, section: "Email", hint: "Email IMAP password" },
-      { name: "INTERNAL_KEY", required: false, secret: true, section: "Email", hint: "Internal auth key for email-worker" },
+      {
+        name: "EMAIL_HOST",
+        required: false,
+        secret: true,
+        section: "Email",
+        hint: "Email IMAP server host",
+      },
+      {
+        name: "EMAIL_USER",
+        required: false,
+        secret: true,
+        section: "Email",
+        hint: "Email IMAP username",
+      },
+      {
+        name: "EMAIL_PASS",
+        required: false,
+        secret: true,
+        section: "Email",
+        hint: "Email IMAP password",
+      },
+      {
+        name: "INTERNAL_KEY",
+        required: false,
+        secret: true,
+        section: "Email",
+        hint: "Internal auth key for email-worker",
+      },
       // Wallet
-      { name: "WALLET_MNEMONIC_SECRET", required: false, secret: true, section: "Wallet", hint: "Wallet mnemonic phrase for web3-wallet-worker" },
-      { name: "WALLET_PK_SECRET", required: false, secret: true, section: "Wallet", hint: "Wallet private key for web3-wallet-worker" },
-      { name: "DASHBOARD_USER", required: true, secret: false, section: "Dashboard", default: "admin", hint: "Dashboard login username" },
-      { name: "DASHBOARD_PASS", required: true, secret: true, section: "Dashboard", hint: "Dashboard login password" },
-      { name: "SESSION_SECRET", required: true, secret: true, section: "Dashboard", hint: "32+ char random string for session signing" },
+      {
+        name: "WALLET_MNEMONIC_SECRET",
+        required: false,
+        secret: true,
+        section: "Wallet",
+        hint: "Wallet mnemonic phrase for web3-wallet-worker",
+      },
+      {
+        name: "WALLET_PK_SECRET",
+        required: false,
+        secret: true,
+        section: "Wallet",
+        hint: "Wallet private key for web3-wallet-worker",
+      },
+      {
+        name: "DASHBOARD_USER",
+        required: true,
+        secret: false,
+        section: "Dashboard",
+        default: "admin",
+        hint: "Dashboard login username",
+      },
+      {
+        name: "DASHBOARD_PASS",
+        required: true,
+        secret: true,
+        section: "Dashboard",
+        hint: "Dashboard login password",
+      },
+      {
+        name: "SESSION_SECRET",
+        required: true,
+        secret: true,
+        section: "Dashboard",
+        hint: "32+ char random string for session signing",
+      },
     ];
   }
 
   static getSections(): string[] {
-    return [...new Set(EnvService.getDefinitions().map(d => d.section))];
+    return [...new Set(EnvService.getDefinitions().map((d) => d.section))];
   }
 
-  static async loadDotEnvAsync(filePath: string): Promise<Record<string, string>> {
+  static async loadDotEnvAsync(
+    filePath: string
+  ): Promise<Record<string, string>> {
     const file = Bun.file(filePath);
     if (!(await file.exists())) return {};
     const text = await file.text();
@@ -73,7 +264,10 @@ export class EnvService {
       if (eqIdx < 1) continue;
       const key = trimmed.substring(0, eqIdx).trim();
       let value = trimmed.substring(eqIdx + 1).trim();
-      if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+      if (
+        (value.startsWith('"') && value.endsWith('"')) ||
+        (value.startsWith("'") && value.endsWith("'"))
+      ) {
         value = value.slice(1, -1);
       }
       vars[key] = value;
@@ -102,11 +296,15 @@ export class EnvService {
     const v = vars ?? {};
     const defs = EnvService.getDefinitions();
     const sections = EnvService.getSections();
-    let output = "# Hoox Local Environment Configuration\n# Generated by `hoox config env init`.\n# NEVER commit this file.\n\n";
+    let output =
+      "# Hoox Local Environment Configuration\n# Generated by `hoox config env init`.\n# NEVER commit this file.\n\n";
     for (const section of sections) {
       output += `# --- ${section.toUpperCase()} ---\n`;
-      for (const def of defs.filter(d => d.section === section)) {
-        const val = v[def.name] !== undefined ? v[def.name] : (def.default ?? `your_${def.name.toLowerCase()}`);
+      for (const def of defs.filter((d) => d.section === section)) {
+        const val =
+          v[def.name] !== undefined
+            ? v[def.name]
+            : (def.default ?? `your_${def.name.toLowerCase()}`);
         output += `${def.name}="${val}"\n`;
       }
       output += "\n";
@@ -114,15 +312,46 @@ export class EnvService {
     return output;
   }
 
-  static getWorkerDevVars(vars: Record<string, string>): Record<string, Record<string, string>> {
+  static getWorkerDevVars(
+    vars: Record<string, string>
+  ): Record<string, Record<string, string>> {
     const workerMap: Record<string, string[]> = {
-      "workers/hoox": ["WEBHOOK_API_KEY_BINDING", "INTERNAL_KEY_BINDING", "HA_TOKEN_BINDING"],
-      "workers/trade-worker": ["API_SERVICE_KEY", "INTERNAL_KEY_BINDING", "BINANCE_API_KEY", "BINANCE_API_SECRET", "MEXC_API_KEY", "MEXC_API_SECRET", "BYBIT_API_KEY", "BYBIT_API_SECRET"],
-      "workers/agent-worker": ["AGENT_INTERNAL_KEY", "AGENT_OPENAI_KEY", "AGENT_ANTHROPIC_KEY", "AGENT_GOOGLE_KEY"],
+      "workers/hoox": [
+        "WEBHOOK_API_KEY_BINDING",
+        "INTERNAL_KEY_BINDING",
+        "HA_TOKEN_BINDING",
+      ],
+      "workers/trade-worker": [
+        "API_SERVICE_KEY",
+        "INTERNAL_KEY_BINDING",
+        "BINANCE_API_KEY",
+        "BINANCE_API_SECRET",
+        "MEXC_API_KEY",
+        "MEXC_API_SECRET",
+        "BYBIT_API_KEY",
+        "BYBIT_API_SECRET",
+      ],
+      "workers/agent-worker": [
+        "AGENT_INTERNAL_KEY",
+        "AGENT_OPENAI_KEY",
+        "AGENT_ANTHROPIC_KEY",
+        "AGENT_GOOGLE_KEY",
+      ],
       "workers/d1-worker": ["D1_INTERNAL_KEY"],
-      "workers/telegram-worker": ["TELEGRAM_BOT_TOKEN", "TELEGRAM_SECRET_TOKEN"],
-      "workers/web3-wallet-worker": ["WALLET_MNEMONIC_SECRET", "WALLET_PK_SECRET"],
-      "workers/email-worker": ["EMAIL_HOST", "EMAIL_USER", "EMAIL_PASS", "INTERNAL_KEY"],
+      "workers/telegram-worker": [
+        "TELEGRAM_BOT_TOKEN",
+        "TELEGRAM_SECRET_TOKEN",
+      ],
+      "workers/web3-wallet-worker": [
+        "WALLET_MNEMONIC_SECRET",
+        "WALLET_PK_SECRET",
+      ],
+      "workers/email-worker": [
+        "EMAIL_HOST",
+        "EMAIL_USER",
+        "EMAIL_PASS",
+        "INTERNAL_KEY",
+      ],
       "workers/analytics-worker": ["CLOUDFLARE_API_TOKEN"],
     };
     const result: Record<string, Record<string, string>> = {};
@@ -144,9 +373,10 @@ export class EnvService {
     let output = "";
     for (const section of sections) {
       output += `\n${section}:\n`;
-      for (const def of defs.filter(d => d.section === section)) {
+      for (const def of defs.filter((d) => d.section === section)) {
         const val = vars[def.name];
-        const displayVal = def.secret && val ? "********" : (val ?? "(not set)");
+        const displayVal =
+          def.secret && val ? "********" : (val ?? "(not set)");
         const status = val ? " [set]" : " [missing]";
         output += `  ${def.name}=${displayVal}${def.secret ? " (secret)" : ""}${status}\n`;
       }