kadi-deploy 0.19.0

package/tests/types.test.ts

@@ -0,0 +1,198 @@
+/**
+ * Type Compatibility Tests
+ *
+ * Verifies that kadi-deploy's types and interfaces are compatible
+ * with deploy-ability v0.0.8's autonomous deployment API.
+ *
+ * These are compile-time tests — if this file compiles, types are compatible.
+ */
+
+import { describe, it, expect } from 'vitest';
+import type {
+  DeployOptions,
+  ResolvedDeployOptions,
+  AgentConfig,
+  DeploymentContext,
+} from '../src/types.js';
+import type {
+  AutonomousDeploymentConfig,
+  BidFilterCriteria,
+  SecretsProvider,
+  BidStrategy,
+} from '@kadi.build/deploy-ability/akash';
+
+// ─────────────────────────────────────────────────────────
+// Compile-time type compatibility checks
+// ─────────────────────────────────────────────────────────
+
+describe('type compatibility with deploy-ability v0.0.8', () => {
+  it('DeployOptions supports all autonomous fields', () => {
+    const opts: DeployOptions = {
+      autonomous: true,
+      bidStrategy: 'balanced',
+      bidMaxPrice: 500,
+      requireAudited: true,
+      secretsVault: 'my-vault',
+      autoApproveSecrets: true,
+      secretTimeout: 120000,
+    };
+
+    expect(opts.autonomous).toBe(true);
+    expect(opts.bidStrategy).toBe('balanced');
+    expect(opts.bidMaxPrice).toBe(500);
+    expect(opts.requireAudited).toBe(true);
+    expect(opts.secretsVault).toBe('my-vault');
+  });
+
+  it('ResolvedDeployOptions supports all autonomous fields', () => {
+    const resolved: ResolvedDeployOptions = {
+      target: 'akash',
+      network: 'mainnet',
+      engine: 'docker',
+      useRemoteRegistry: false,
+      registryDuration: 600000,
+      tunnelService: 'kadi',
+      interactive: false,
+      dryRun: false,
+      verbose: false,
+      yes: true,
+      showCommands: false,
+      project: '/tmp/test',
+      autonomous: true,
+      bidStrategy: 'most-reliable',
+      bidMaxPrice: 1000,
+      requireAudited: true,
+      secretsVault: 'global',
+    };
+
+    expect(resolved.autonomous).toBe(true);
+    expect(resolved.bidStrategy).toBe('most-reliable');
+  });
+
+  it('BidStrategy values match DeployOptions bidStrategy type', () => {
+    // All valid BidStrategy values should be assignable to DeployOptions.bidStrategy
+    const strategies: BidStrategy[] = ['cheapest', 'most-reliable', 'balanced'];
+    strategies.forEach((s) => {
+      const opts: DeployOptions = { bidStrategy: s };
+      expect(opts.bidStrategy).toBe(s);
+    });
+  });
+
+  it('BidFilterCriteria can be constructed from CLI flags', () => {
+    const filter: BidFilterCriteria = {
+      maxPricePerBlock: 500,
+      requireAudited: true,
+    };
+
+    expect(filter.maxPricePerBlock).toBe(500);
+    expect(filter.requireAudited).toBe(true);
+  });
+
+  it('BidFilterCriteria supports all optional fields', () => {
+    const filter: BidFilterCriteria = {
+      maxPricePerBlock: 1000,
+      minUptime: { value: 0.95, period: '7d' },
+      requireAudited: true,
+      preferredRegions: ['us-east', 'eu-west'],
+      requireOnline: true,
+    };
+
+    expect(filter.minUptime?.value).toBe(0.95);
+    expect(filter.preferredRegions).toHaveLength(2);
+  });
+
+  it('SecretsProvider interface is implementable', () => {
+    // Verifies the CLI shim shape matches SecretsProvider
+    const provider: SecretsProvider = {
+      async getMnemonic(): Promise<string> {
+        return 'test mnemonic phrase';
+      },
+      async getCertificate() {
+        return null;
+      },
+      async storeCertificate(_cert) {
+        // no-op
+      },
+    };
+
+    expect(provider.getMnemonic).toBeDefined();
+    expect(provider.getCertificate).toBeDefined();
+    expect(provider.storeCertificate).toBeDefined();
+  });
+
+  it('AutonomousDeploymentConfig can be constructed from CLI flags', () => {
+    const secretsProvider: SecretsProvider = {
+      async getMnemonic() { return 'test mnemonic'; },
+    };
+
+    const config: AutonomousDeploymentConfig = {
+      secrets: secretsProvider,
+      bidStrategy: 'balanced',
+      bidFilter: {
+        maxPricePerBlock: 500,
+        requireAudited: true,
+      },
+    };
+
+    expect(config.secrets).toBe(secretsProvider);
+    expect(config.bidStrategy).toBe('balanced');
+    expect(config.bidFilter?.maxPricePerBlock).toBe(500);
+  });
+
+  it('AutonomousDeploymentConfig works with minimal fields', () => {
+    const secretsProvider: SecretsProvider = {
+      async getMnemonic() { return 'test'; },
+    };
+
+    // Only secrets is required
+    const config: AutonomousDeploymentConfig = {
+      secrets: secretsProvider,
+    };
+
+    expect(config.secrets).toBeDefined();
+    expect(config.bidStrategy).toBeUndefined();
+    expect(config.bidFilter).toBeUndefined();
+  });
+
+  it('AgentConfig supports brokers for secrets handshake', () => {
+    const config: AgentConfig = {
+      name: 'test-agent',
+      version: '1.0.0',
+      deploy: {
+        production: {
+          target: 'akash',
+          secrets: {
+            vault: 'global',
+            required: ['API_KEY'],
+          },
+        },
+      },
+      brokers: {
+        default: 'wss://broker.kadi.build/kadi',
+      },
+    };
+
+    expect(config.brokers?.default).toBe('wss://broker.kadi.build/kadi');
+  });
+});
+
+// ─────────────────────────────────────────────────────────
+// Tunnel service type tests
+// ─────────────────────────────────────────────────────────
+
+describe('tunnel service types', () => {
+  it('kadi is a valid tunnel service', () => {
+    const opts: DeployOptions = { tunnelService: 'kadi' };
+    expect(opts.tunnelService).toBe('kadi');
+  });
+
+  it('localtunnel is a valid tunnel service', () => {
+    const opts: DeployOptions = { tunnelService: 'localtunnel' };
+    expect(opts.tunnelService).toBe('localtunnel');
+  });
+
+  it('ngrok and serveo are valid tunnel services', () => {
+    expect({ tunnelService: 'ngrok' } as DeployOptions).toBeDefined();
+    expect({ tunnelService: 'serveo' } as DeployOptions).toBeDefined();
+  });
+});

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "Node16",
+    "moduleResolution": "node16",
+    "allowSyntheticDefaultImports": true,
+    "esModuleInterop": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "noImplicitAny": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "**/*.test.ts"]
+}

package/vitest.config.ts

@@ -0,0 +1,9 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    globals: true,
+    include: ['tests/**/*.test.ts'],
+    testTimeout: 10000,
+  },
+});