kadi-deploy 0.19.0

package/tests/agent-loader.test.ts

@@ -0,0 +1,239 @@
+/**
+ * Agent Configuration Loader Tests
+ *
+ * Tests for loading, parsing, and querying agent.json configuration.
+ */
+
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import path from 'node:path';
+import os from 'node:os';
+import fs from 'node:fs/promises';
+
+// Use dynamic import to avoid ESM issues with mocking
+let loadAgentConfig: typeof import('../src/config/agent-loader.js').loadAgentConfig;
+let getDeployProfiles: typeof import('../src/config/agent-loader.js').getDeployProfiles;
+let hasProfile: typeof import('../src/config/agent-loader.js').hasProfile;
+let getProfile: typeof import('../src/config/agent-loader.js').getProfile;
+let getFirstProfile: typeof import('../src/config/agent-loader.js').getFirstProfile;
+let AgentConfigError: typeof import('../src/config/agent-loader.js').AgentConfigError;
+
+beforeEach(async () => {
+  const mod = await import('../src/config/agent-loader.js');
+  loadAgentConfig = mod.loadAgentConfig;
+  getDeployProfiles = mod.getDeployProfiles;
+  hasProfile = mod.hasProfile;
+  getProfile = mod.getProfile;
+  getFirstProfile = mod.getFirstProfile;
+  AgentConfigError = mod.AgentConfigError;
+});
+
+// ─────────────────────────────────────────────────────────
+// Fixtures
+// ─────────────────────────────────────────────────────────
+
+const MINIMAL_AGENT = {
+  name: 'test-agent',
+  version: '1.0.0',
+};
+
+const AGENT_WITH_PROFILES = {
+  name: 'test-agent',
+  version: '1.0.0',
+  deploy: {
+    local: {
+      target: 'local',
+      engine: 'docker',
+      services: {
+        app: {
+          image: 'nginx:alpine',
+          expose: [{ port: 80, as: 80 }],
+        },
+      },
+    },
+    production: {
+      target: 'akash',
+      network: 'mainnet',
+      services: {
+        web: {
+          image: 'nginx:alpine',
+          expose: [{ port: 80, as: 80, to: [{ global: true }] }],
+          resources: { cpu: 0.5, memory: '512Mi', storage: '1Gi' },
+        },
+      },
+    },
+  },
+};
+
+const AGENT_WITH_AUTONOMOUS = {
+  name: 'auto-agent',
+  version: '2.0.0',
+  deploy: {
+    production: {
+      target: 'akash',
+      network: 'testnet',
+      services: {
+        api: {
+          image: 'my-api:latest',
+          expose: [{ port: 3000, as: 80, to: [{ global: true }] }],
+          resources: { cpu: 1, memory: '1Gi', storage: '2Gi' },
+        },
+      },
+      secrets: {
+        vault: 'global',
+        required: ['API_KEY'],
+        optional: ['DEBUG_TOKEN'],
+      },
+    },
+  },
+  brokers: {
+    default: 'wss://broker.kadi.build/kadi',
+  },
+};
+
+// ─────────────────────────────────────────────────────────
+// Tests: loadAgentConfig
+// ─────────────────────────────────────────────────────────
+
+describe('loadAgentConfig', () => {
+  let tmpDir: string;
+
+  beforeEach(async () => {
+    tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'kadi-test-'));
+  });
+
+  afterEach(async () => {
+    await fs.rm(tmpDir, { recursive: true, force: true });
+  });
+
+  it('loads a valid agent.json', async () => {
+    await fs.writeFile(
+      path.join(tmpDir, 'agent.json'),
+      JSON.stringify(MINIMAL_AGENT)
+    );
+
+    const config = await loadAgentConfig(tmpDir);
+    expect(config.name).toBe('test-agent');
+    expect(config.version).toBe('1.0.0');
+  });
+
+  it('loads agent.json with deploy profiles', async () => {
+    await fs.writeFile(
+      path.join(tmpDir, 'agent.json'),
+      JSON.stringify(AGENT_WITH_PROFILES)
+    );
+
+    const config = await loadAgentConfig(tmpDir);
+    expect(config.deploy).toBeDefined();
+    expect(Object.keys(config.deploy!)).toContain('local');
+    expect(Object.keys(config.deploy!)).toContain('production');
+  });
+
+  it('throws AgentConfigError for missing agent.json', async () => {
+    await expect(loadAgentConfig(tmpDir)).rejects.toThrow(AgentConfigError);
+    await expect(loadAgentConfig(tmpDir)).rejects.toThrow('agent.json not found');
+  });
+
+  it('throws AgentConfigError for invalid JSON', async () => {
+    await fs.writeFile(path.join(tmpDir, 'agent.json'), '{ invalid json');
+    await expect(loadAgentConfig(tmpDir)).rejects.toThrow(AgentConfigError);
+    await expect(loadAgentConfig(tmpDir)).rejects.toThrow('invalid JSON');
+  });
+
+  it('throws AgentConfigError for missing name field', async () => {
+    await fs.writeFile(
+      path.join(tmpDir, 'agent.json'),
+      JSON.stringify({ version: '1.0.0' })
+    );
+    await expect(loadAgentConfig(tmpDir)).rejects.toThrow(AgentConfigError);
+    await expect(loadAgentConfig(tmpDir)).rejects.toThrow('missing required field');
+  });
+});
+
+// ─────────────────────────────────────────────────────────
+// Tests: getDeployProfiles
+// ─────────────────────────────────────────────────────────
+
+describe('getDeployProfiles', () => {
+  it('returns empty array when no deploy profiles', () => {
+    expect(getDeployProfiles(MINIMAL_AGENT)).toEqual([]);
+  });
+
+  it('returns profile names from deploy config', () => {
+    const profiles = getDeployProfiles(AGENT_WITH_PROFILES);
+    expect(profiles).toContain('local');
+    expect(profiles).toContain('production');
+    expect(profiles).toHaveLength(2);
+  });
+
+  it('filters out services and networks keys', () => {
+    const config = {
+      name: 'test',
+      version: '1.0.0',
+      deploy: {
+        production: { target: 'akash' },
+        services: { web: {} },
+        networks: { default: {} },
+      },
+    };
+    const profiles = getDeployProfiles(config);
+    expect(profiles).toEqual(['production']);
+  });
+});
+
+// ─────────────────────────────────────────────────────────
+// Tests: hasProfile
+// ─────────────────────────────────────────────────────────
+
+describe('hasProfile', () => {
+  it('returns true for existing profile', () => {
+    expect(hasProfile(AGENT_WITH_PROFILES, 'local')).toBe(true);
+    expect(hasProfile(AGENT_WITH_PROFILES, 'production')).toBe(true);
+  });
+
+  it('returns false for non-existent profile', () => {
+    expect(hasProfile(AGENT_WITH_PROFILES, 'staging')).toBe(false);
+    expect(hasProfile(MINIMAL_AGENT, 'local')).toBe(false);
+  });
+});
+
+// ─────────────────────────────────────────────────────────
+// Tests: getFirstProfile
+// ─────────────────────────────────────────────────────────
+
+describe('getFirstProfile', () => {
+  it('returns first profile name', () => {
+    const first = getFirstProfile(AGENT_WITH_PROFILES);
+    expect(first).toBeDefined();
+    expect(['local', 'production']).toContain(first);
+  });
+
+  it('returns undefined when no profiles', () => {
+    expect(getFirstProfile(MINIMAL_AGENT)).toBeUndefined();
+  });
+});
+
+// ─────────────────────────────────────────────────────────
+// Tests: getProfile with autonomous config
+// ─────────────────────────────────────────────────────────
+
+describe('getProfile', () => {
+  it('returns undefined for non-existent profile', () => {
+    expect(getProfile(AGENT_WITH_PROFILES, 'nonexistent')).toBeUndefined();
+  });
+
+  it('returns validated profile for existing profile', () => {
+    const profile = getProfile(AGENT_WITH_PROFILES, 'production');
+    expect(profile).toBeDefined();
+    expect(profile!.target).toBe('akash');
+  });
+
+  it('loads profile with secrets config (for autonomous deployment)', () => {
+    const profile = getProfile(AGENT_WITH_AUTONOMOUS, 'production');
+    expect(profile).toBeDefined();
+    expect(profile!.target).toBe('akash');
+    expect((profile as any).secrets).toBeDefined();
+    expect((profile as any).secrets.vault).toBe('global');
+    expect((profile as any).secrets.required).toContain('API_KEY');
+    expect((profile as any).secrets.optional).toContain('DEBUG_TOKEN');
+  });
+});

package/tests/autonomous.test.ts

@@ -0,0 +1,244 @@
+/**
+ * Autonomous Deployment Integration Tests
+ *
+ * Tests the autonomous deployment flow, CLI flag handling,
+ * SecretsProvider shim, and bid filter construction.
+ */
+
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import type {
+  AutonomousDeploymentConfig,
+  BidFilterCriteria,
+  SecretsProvider,
+} from '@kadi.build/deploy-ability/akash';
+
+// ─────────────────────────────────────────────────────────
+// SecretsProvider shim (mirrors createCliSecretsProvider logic)
+// ─────────────────────────────────────────────────────────
+
+/**
+ * Recreation of the CLI secrets provider for isolated testing
+ * (The real one shells out to `kadi secret get`)
+ */
+function createMockSecretsProvider(secrets: Record<string, string>): SecretsProvider {
+  return {
+    async getMnemonic(): Promise<string> {
+      const mnemonic = secrets['AKASH_WALLET'];
+      if (!mnemonic) {
+        throw new Error('Wallet mnemonic not found');
+      }
+      return mnemonic;
+    },
+    async getCertificate() {
+      const certJson = secrets['akash-tls-certificate'];
+      if (!certJson) return null;
+      try {
+        return JSON.parse(certJson);
+      } catch {
+        return null;
+      }
+    },
+    async storeCertificate(_cert) {
+      // no-op in mock
+    },
+  };
+}
+
+describe('SecretsProvider shim', () => {
+  it('returns mnemonic from vault', async () => {
+    const provider = createMockSecretsProvider({
+      AKASH_WALLET: 'abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about',
+    });
+
+    const mnemonic = await provider.getMnemonic();
+    expect(mnemonic).toContain('abandon');
+    expect(mnemonic.split(' ')).toHaveLength(12);
+  });
+
+  it('throws when mnemonic is missing', async () => {
+    const provider = createMockSecretsProvider({});
+    await expect(provider.getMnemonic()).rejects.toThrow('not found');
+  });
+
+  it('returns null for missing certificate', async () => {
+    const provider = createMockSecretsProvider({ AKASH_WALLET: 'test' });
+    const cert = await provider.getCertificate!();
+    expect(cert).toBeNull();
+  });
+
+  it('parses stored certificate JSON', async () => {
+    const certData = {
+      privateKey: 'pk',
+      publicKey: 'pub',
+      cert: 'cert-pem',
+    };
+
+    const provider = createMockSecretsProvider({
+      AKASH_WALLET: 'test',
+      'akash-tls-certificate': JSON.stringify(certData),
+    });
+
+    const cert = await provider.getCertificate!();
+    expect(cert).toEqual(certData);
+  });
+
+  it('returns null for malformed certificate JSON', async () => {
+    const provider = createMockSecretsProvider({
+      AKASH_WALLET: 'test',
+      'akash-tls-certificate': 'not-json',
+    });
+
+    const cert = await provider.getCertificate!();
+    expect(cert).toBeNull();
+  });
+});
+
+// ─────────────────────────────────────────────────────────
+// AutonomousDeploymentConfig construction
+// ─────────────────────────────────────────────────────────
+
+describe('AutonomousDeploymentConfig construction from CLI flags', () => {
+  it('builds config with cheapest strategy (default)', () => {
+    const provider = createMockSecretsProvider({ AKASH_WALLET: 'test' });
+
+    const config: AutonomousDeploymentConfig = {
+      secrets: provider,
+      bidStrategy: 'cheapest',
+    };
+
+    expect(config.bidStrategy).toBe('cheapest');
+    expect(config.bidFilter).toBeUndefined();
+  });
+
+  it('builds config with bid price filter', () => {
+    const provider = createMockSecretsProvider({ AKASH_WALLET: 'test' });
+
+    const bidFilter: BidFilterCriteria = {
+      maxPricePerBlock: 500,
+    };
+
+    const config: AutonomousDeploymentConfig = {
+      secrets: provider,
+      bidStrategy: 'balanced',
+      bidFilter,
+    };
+
+    expect(config.bidFilter?.maxPricePerBlock).toBe(500);
+  });
+
+  it('builds config with audited provider requirement', () => {
+    const provider = createMockSecretsProvider({ AKASH_WALLET: 'test' });
+
+    const config: AutonomousDeploymentConfig = {
+      secrets: provider,
+      bidStrategy: 'most-reliable',
+      bidFilter: {
+        requireAudited: true,
+      },
+    };
+
+    expect(config.bidFilter?.requireAudited).toBe(true);
+    expect(config.bidStrategy).toBe('most-reliable');
+  });
+
+  it('builds config with all filter options', () => {
+    const provider = createMockSecretsProvider({ AKASH_WALLET: 'test' });
+
+    const config: AutonomousDeploymentConfig = {
+      secrets: provider,
+      bidStrategy: 'balanced',
+      bidFilter: {
+        maxPricePerBlock: 1000,
+        requireAudited: true,
+        minUptime: { value: 0.95, period: '7d' },
+        preferredRegions: ['us-east'],
+        requireOnline: true,
+      },
+    };
+
+    expect(config.bidFilter?.maxPricePerBlock).toBe(1000);
+    expect(config.bidFilter?.minUptime?.value).toBe(0.95);
+    expect(config.bidFilter?.preferredRegions).toContain('us-east');
+  });
+});
+
+// ─────────────────────────────────────────────────────────
+// Bid filter construction (mirrors deploy.ts logic)
+// ─────────────────────────────────────────────────────────
+
+describe('bid filter construction from CLI flags', () => {
+  interface MockFlags {
+    bidMaxPrice?: number;
+    requireAudited?: boolean;
+  }
+
+  function buildBidFilter(flags: MockFlags): BidFilterCriteria | undefined {
+    const bidFilter: Record<string, unknown> = {};
+    if (flags.bidMaxPrice) {
+      bidFilter.maxPricePerBlock = flags.bidMaxPrice;
+    }
+    if (flags.requireAudited) {
+      bidFilter.requireAudited = true;
+    }
+    return Object.keys(bidFilter).length > 0
+      ? (bidFilter as BidFilterCriteria)
+      : undefined;
+  }
+
+  it('returns undefined when no filter flags set', () => {
+    expect(buildBidFilter({})).toBeUndefined();
+  });
+
+  it('builds filter with maxPricePerBlock', () => {
+    const filter = buildBidFilter({ bidMaxPrice: 500 });
+    expect(filter?.maxPricePerBlock).toBe(500);
+  });
+
+  it('builds filter with requireAudited', () => {
+    const filter = buildBidFilter({ requireAudited: true });
+    expect(filter?.requireAudited).toBe(true);
+  });
+
+  it('builds filter with both flags', () => {
+    const filter = buildBidFilter({ bidMaxPrice: 1000, requireAudited: true });
+    expect(filter?.maxPricePerBlock).toBe(1000);
+    expect(filter?.requireAudited).toBe(true);
+  });
+});
+
+// ─────────────────────────────────────────────────────────
+// Tunnel service validation (mirrors deploy.ts logic)
+// ─────────────────────────────────────────────────────────
+
+describe('tunnel service validation', () => {
+  const validTunnelServices = ['kadi', 'ngrok', 'serveo', 'localtunnel'] as const;
+
+  function validateTunnelService(service: string): boolean {
+    return validTunnelServices.includes(service as any);
+  }
+
+  it('accepts kadi (default)', () => {
+    expect(validateTunnelService('kadi')).toBe(true);
+  });
+
+  it('accepts ngrok', () => {
+    expect(validateTunnelService('ngrok')).toBe(true);
+  });
+
+  it('accepts serveo', () => {
+    expect(validateTunnelService('serveo')).toBe(true);
+  });
+
+  it('accepts localtunnel', () => {
+    expect(validateTunnelService('localtunnel')).toBe(true);
+  });
+
+  it('rejects bore (removed)', () => {
+    expect(validateTunnelService('bore')).toBe(false);
+  });
+
+  it('rejects invalid services', () => {
+    expect(validateTunnelService('cloudflare')).toBe(false);
+    expect(validateTunnelService('')).toBe(false);
+  });
+});