Skip to content

Testing Utilities

The @zakardo/testing package provides comprehensive testing utilities for Zakardo applications.

Terminal window
pnpm add -D @zakardo/testing

Create a fully wired runtime for integration tests:

import { createTestRuntime } from '@zakardo/testing';
const runtime = await createTestRuntime({
capabilities: [myCapability],
implementations: { 'my_cap': myCapFn },
policies: [myPolicy],
});
// Use runtime for tests...
await runtime.shutdown();
import { testCapability, testPlan, testPolicy } from '@zakardo/testing';
// Test a capability
const result = await testCapability(myCapFn, { name: 'Alice' });
expect(result.output.id).toBeDefined();
expect(result.error).toBeUndefined();
// Test plan validation
const planResult = testPlan(myPlan, runtime);
expect(planResult.valid).toBe(true);
// Test policy evaluation
const policyResult = testPolicy(runtime, 'my_capability');
expect(policyResult.allowed).toBe(true);
import { expect } from 'vitest';
import { zakardoMatchers } from '@zakardo/testing';
expect.extend(zakardoMatchers);
// Plan matchers
expect(plan).toContainCapability('contacts_create');
expect(plan).toHaveStepCount(3);
// Training matchers
expect(result).toHaveVerdict('PASS');
expect(run).toHavePassRate(0.9);
// Output matchers
expect(output).toMatchSubset({ name: 'Alice' });
import {
createTestCapability,
createTestPlanIR,
createTestTrainingDataset,
createMockCapabilityImpl,
} from '@zakardo/testing';
const cap = createTestCapability({ name: 'my_cap' });
const plan = createTestPlanIR({ steps: [...] });
const dataset = createTestTrainingDataset({ cases: [...] });
const mock = createMockCapabilityImpl({ defaultOutput: { id: '123' } });