@theda/test

Test doubles, in-memory backends, and deterministic context factories for testing Theda apps.

Install

npm install -D @theda/test

Quick start

import { describe, it, expect } from "vitest";
import { createTestContext, inMemoryDb } from "@theda/test";

describe("my command", () => {
  it("should transact data", async () => {
    const ctx = createTestContext.command();

    const result = await ctx.dbTransact.transact("main", {
      kind: "concrete",
      preconditions: [],
      actions: [
        { kind: "assert_single", entityId: "e1", attribute: "name", value: "Alice" },
      ],
    });

    expect(result.ok).toBe(true);
  });
});

What's included

• createTestContext — factory for CommandContext, RouteContext, TaskContext, and WorkflowStepContext
• inMemoryDb — full in-memory database with seeding support
• fixedClock / advancingClock — deterministic time for reproducible tests
• sequentialIds — predictable ID generation
• cannedHttp — stub HTTP responses
• captureJournal — capture and assert on journal entries
• inMemoryBlobStore — in-memory blob storage
• createTestWorkflow — step-by-step workflow execution for testing

License

Apache-2.0