Files
triggerdotdev--trigger.dev/apps/webapp/test/apiBatchResultsPresenter.readthrough.test.ts
2026-07-13 13:32:57 +08:00

414 lines
14 KiB
TypeScript

// Read-through proof for ApiBatchResultsPresenter.
//
// The batch row + its item rows resolve new-run-ops-first then off the LEGACY run-ops READ
// REPLICA ONLY; each member run is hydrated independently via the per-run read-through primitive,
// so a batch whose members span migrated (NEW) + abandoned (LEGACY) runs returns the
// complete reachable set. Single-DB collapses to one passthrough read. We NEVER mock the DB — the
// only injected fakes are the pure boundaries (splitEnabled / isPastRetention).
//
// The BatchTaskRunItem -> TaskRun FK is per-DB; a batch straddling the seam references member ids
// that live on the other DB, so we drop that one FK on the batch's DB at seed time (the cross-seam
// reality where the item row survives while the member's authoritative row lives on the other DB).
import { PostgresRunStore } from "@internal/run-store";
import { heteroPostgresTest, postgresTest } from "@internal/testcontainers";
import type { PrismaClient } from "@trigger.dev/database";
import { describe, expect, vi } from "vitest";
import type { PrismaReplicaClient } from "~/db.server";
import type { AuthenticatedEnvironment } from "~/services/apiAuth.server";
import { ApiBatchResultsPresenter } from "~/presenters/v3/ApiBatchResultsPresenter.server";
vi.setConfig({ testTimeout: 60_000 });
// 26-char v1 body (version "1" at index 25) → NEW residency. 25-char body → LEGACY residency (cuid analog).
function newRunId(c: string) {
return c.repeat(24) + "01";
}
function legacyRunId(c: string) {
return c.repeat(25);
}
// A prisma handle that throws on any access — proves the split path never reads it.
const throwingPrisma = new Proxy(
{},
{
get(_t, prop) {
throw new Error(
`passthrough handle must not be touched on the split path (got .${String(prop)})`
);
},
}
) as unknown as PrismaReplicaClient;
let seedCounter = 0;
async function seedEnv(prisma: PrismaClient, slug: string) {
const n = seedCounter++;
const organization = await prisma.organization.create({
data: { title: `Org ${slug}`, slug: `org-${slug}-${n}` },
});
const project = await prisma.project.create({
data: {
name: `Proj ${slug}`,
slug: `proj-${slug}-${n}`,
organizationId: organization.id,
externalRef: `ext-${slug}-${n}`,
},
});
const environment = await prisma.runtimeEnvironment.create({
data: {
slug: `env-${slug}-${n}`,
type: "PRODUCTION",
projectId: project.id,
organizationId: organization.id,
apiKey: `api-${slug}-${n}`,
pkApiKey: `pk-${slug}-${n}`,
shortcode: `sc-${slug}-${n}`,
},
});
return { organization, project, environment };
}
type SeedCtx = Awaited<ReturnType<typeof seedEnv>>;
// Mirror the same org/project/env ids onto a second DB so member TaskRun FKs resolve there.
async function mirrorEnv(prisma: PrismaClient, ctx: SeedCtx, slug: string) {
const n = seedCounter++;
await prisma.organization.create({
data: { id: ctx.organization.id, title: `Org ${slug}`, slug: `org-${slug}-m-${n}` },
});
await prisma.project.create({
data: {
id: ctx.project.id,
name: `Proj ${slug}`,
slug: `proj-${slug}-m-${n}`,
organizationId: ctx.organization.id,
externalRef: `ext-${slug}-m-${n}`,
},
});
await prisma.runtimeEnvironment.create({
data: {
id: ctx.environment.id,
slug: `env-${slug}-m-${n}`,
type: "PRODUCTION",
projectId: ctx.project.id,
organizationId: ctx.organization.id,
apiKey: `api-${slug}-m-${n}`,
pkApiKey: `pk-${slug}-m-${n}`,
shortcode: `sc-${slug}-m-${n}`,
},
});
}
type MemberSeed = {
id: string;
friendlyId: string;
status: "COMPLETED_SUCCESSFULLY" | "COMPLETED_WITH_ERRORS";
output?: string;
error?: unknown;
};
async function seedMember(prisma: PrismaClient, ctx: SeedCtx, m: MemberSeed) {
const run = await prisma.taskRun.create({
data: {
id: m.id,
friendlyId: m.friendlyId,
taskIdentifier: "my-task",
status: m.status,
payload: JSON.stringify({}),
payloadType: "application/json",
traceId: m.id,
spanId: m.id,
queue: "main",
runtimeEnvironmentId: ctx.environment.id,
projectId: ctx.project.id,
organizationId: ctx.organization.id,
environmentType: "PRODUCTION",
engine: "V2",
},
});
await prisma.taskRunAttempt.create({
data: {
friendlyId: `attempt_${m.id}`,
number: 1,
taskRunId: run.id,
backgroundWorkerId: "bw",
backgroundWorkerTaskId: "bwt",
runtimeEnvironmentId: ctx.environment.id,
queueId: "q",
status: m.status === "COMPLETED_SUCCESSFULLY" ? "COMPLETED" : "FAILED",
output: m.output,
outputType: "application/json",
error: m.error as any,
},
});
return run;
}
// Drop the per-DB BatchTaskRunItem -> TaskRun FK so items on this DB can reference member ids whose
// authoritative TaskRun lives on the other DB (the cross-seam batch). Also drop the TaskRunAttempt
// worker/queue FKs so we can seed attempts (their output/error is what's under test) without
// standing up BackgroundWorker/TaskQueue parents — those rows are incidental to this read path.
async function relaxFks(prisma: PrismaClient) {
for (const sql of [
`ALTER TABLE "BatchTaskRunItem" DROP CONSTRAINT IF EXISTS "BatchTaskRunItem_taskRunId_fkey"`,
`ALTER TABLE "TaskRunAttempt" DROP CONSTRAINT IF EXISTS "TaskRunAttempt_backgroundWorkerId_fkey"`,
`ALTER TABLE "TaskRunAttempt" DROP CONSTRAINT IF EXISTS "TaskRunAttempt_backgroundWorkerTaskId_fkey"`,
`ALTER TABLE "TaskRunAttempt" DROP CONSTRAINT IF EXISTS "TaskRunAttempt_queueId_fkey"`,
]) {
await prisma.$executeRawUnsafe(sql);
}
}
async function seedBatch(
prisma: PrismaClient,
ctx: SeedCtx,
friendlyId: string,
memberIds: string[]
) {
const batch = await prisma.batchTaskRun.create({
data: {
friendlyId,
runtimeEnvironmentId: ctx.environment.id,
runCount: memberIds.length,
runIds: [],
batchVersion: "runengine:v2",
},
});
// Items in a deterministic order so the result `items` order is assertable.
for (const taskRunId of memberIds) {
await prisma.batchTaskRunItem.create({
data: { batchTaskRunId: batch.id, taskRunId, status: "COMPLETED" },
});
}
return batch;
}
const env = (ctx: SeedCtx) =>
({
id: ctx.environment.id,
type: ctx.environment.type,
slug: ctx.environment.slug,
organizationId: ctx.organization.id,
organization: { slug: ctx.organization.slug, title: ctx.organization.title },
projectId: ctx.project.id,
project: { name: ctx.project.name },
}) as unknown as AuthenticatedEnvironment;
describe("ApiBatchResultsPresenter read-through (legacy + new DB)", () => {
// A batch with members on BOTH DBs returns the complete set, byte-identical.
heteroPostgresTest(
"members spanning NEW + legacy hydrate to the complete union, in item order",
async ({ prisma14, prisma17 }) => {
const newDb = prisma17 as unknown as PrismaClient;
const legacyDb = prisma14 as unknown as PrismaClient;
const ctx = await seedEnv(newDb, "span-new");
await mirrorEnv(legacyDb, ctx, "span-legacy");
await relaxFks(newDb);
await relaxFks(legacyDb);
const newMemberId = newRunId("a");
const legacyMemberId = legacyRunId("b");
// NEW member lives only on the new DB, legacy member only on the legacy DB.
await seedMember(newDb, ctx, {
id: newMemberId,
friendlyId: "run_new_a",
status: "COMPLETED_SUCCESSFULLY",
output: JSON.stringify({ from: "new" }),
});
await seedMember(legacyDb, ctx, {
id: legacyMemberId,
friendlyId: "run_legacy_b",
status: "COMPLETED_WITH_ERRORS",
error: { type: "BUILT_IN_ERROR", name: "Err", message: "boom", stackTrace: "" },
});
// The batch row + items live on the NEW DB; items reference both members.
await seedBatch(newDb, ctx, "batch_span", [newMemberId, legacyMemberId]);
const presenter = new ApiBatchResultsPresenter(throwingPrisma, throwingPrisma, {
splitEnabled: true,
newClient: prisma17 as unknown as PrismaReplicaClient,
legacyReplica: prisma14 as unknown as PrismaReplicaClient,
});
const result = await presenter.call("batch_span", env(ctx));
expect(result).toBeDefined();
expect(result!.id).toBe("batch_span");
expect(result!.items).toHaveLength(2);
// Order follows item order: NEW member first, legacy member second.
const [first, second] = result!.items;
expect(first).toEqual({
ok: true,
id: "run_new_a",
taskIdentifier: "my-task",
output: JSON.stringify({ from: "new" }),
outputType: "application/json",
});
expect(second).toMatchObject({
ok: false,
id: "run_legacy_b",
taskIdentifier: "my-task",
});
}
);
// Batch row resident only on the legacy replica resolves via new-first-miss → legacy.
heteroPostgresTest(
"a legacy-resident batch row resolves off the legacy replica (new probe misses)",
async ({ prisma14, prisma17 }) => {
const newDb = prisma17 as unknown as PrismaClient;
const legacyDb = prisma14 as unknown as PrismaClient;
const ctx = await seedEnv(legacyDb, "lb-legacy");
await mirrorEnv(newDb, ctx, "lb-new");
await relaxFks(legacyDb);
const legacyMemberId = legacyRunId("c");
await seedMember(legacyDb, ctx, {
id: legacyMemberId,
friendlyId: "run_legacy_c",
status: "COMPLETED_SUCCESSFULLY",
output: JSON.stringify({ ok: 1 }),
});
// Batch row + items only on the legacy replica; absent from NEW.
await seedBatch(legacyDb, ctx, "batch_legacy", [legacyMemberId]);
const presenter = new ApiBatchResultsPresenter(throwingPrisma, throwingPrisma, {
splitEnabled: true,
newClient: prisma17 as unknown as PrismaReplicaClient,
legacyReplica: prisma14 as unknown as PrismaReplicaClient,
});
const result = await presenter.call("batch_legacy", env(ctx));
expect(result).toBeDefined();
expect(result!.id).toBe("batch_legacy");
expect(result!.items).toHaveLength(1);
expect(result!.items[0]).toMatchObject({ ok: true, id: "run_legacy_c" });
}
);
// Past-retention / missing member is omitted (dangling-ref gate adjacent), not errored.
heteroPostgresTest(
"a member present on neither DB is omitted; the reachable members still return",
async ({ prisma14, prisma17 }) => {
const newDb = prisma17 as unknown as PrismaClient;
const legacyDb = prisma14 as unknown as PrismaClient;
const ctx = await seedEnv(newDb, "dangle-new");
await mirrorEnv(legacyDb, ctx, "dangle-legacy");
await relaxFks(newDb);
await relaxFks(legacyDb);
const presentId = newRunId("e");
const missingId = legacyRunId("f"); // referenced by an item but seeded on NO DB
await seedMember(newDb, ctx, {
id: presentId,
friendlyId: "run_present_e",
status: "COMPLETED_SUCCESSFULLY",
output: JSON.stringify({ present: true }),
});
await seedBatch(newDb, ctx, "batch_dangle", [presentId, missingId]);
const presenter = new ApiBatchResultsPresenter(throwingPrisma, throwingPrisma, {
splitEnabled: true,
newClient: prisma17 as unknown as PrismaReplicaClient,
legacyReplica: prisma14 as unknown as PrismaReplicaClient,
});
const result = await presenter.call("batch_dangle", env(ctx));
expect(result).toBeDefined();
// The dangling member is dropped; the reachable member still returns. The dangling-reference
// termination gate (separate unit) governs whether such omission is permitted pre-termination.
expect(result!.items).toHaveLength(1);
expect(result!.items[0]).toMatchObject({ ok: true, id: "run_present_e" });
}
);
heteroPostgresTest(
"an absent batch friendlyId returns undefined (split on)",
async ({ prisma14, prisma17 }) => {
const ctx = await seedEnv(prisma17 as unknown as PrismaClient, "nf-new");
await mirrorEnv(prisma14 as unknown as PrismaClient, ctx, "nf-legacy");
const presenter = new ApiBatchResultsPresenter(throwingPrisma, throwingPrisma, {
splitEnabled: true,
newClient: prisma17 as unknown as PrismaReplicaClient,
legacyReplica: prisma14 as unknown as PrismaReplicaClient,
});
const result = await presenter.call("batch_does_not_exist", env(ctx));
expect(result).toBeUndefined();
}
);
});
describe("ApiBatchResultsPresenter passthrough (single-DB collapse)", () => {
// Single-DB: one batch read + one store id-set hydrate; legacy boundaries never touched.
postgresTest(
"single-DB hydrates the full set and never reaches the read-through boundaries",
async ({ prisma }) => {
const ctx = await seedEnv(prisma, "pt");
await relaxFks(prisma);
const memberId = legacyRunId("g");
await seedMember(prisma, ctx, {
id: memberId,
friendlyId: "run_pt_g",
status: "COMPLETED_SUCCESSFULLY",
output: JSON.stringify({ value: 42 }),
});
await seedBatch(prisma, ctx, "batch_pt", [memberId]);
const runStore = new PostgresRunStore({ prisma, readOnlyPrisma: prisma });
// Throwing legacy replica: if the split path is entered, it blows up.
const presenter = new ApiBatchResultsPresenter(
prisma,
prisma,
{
splitEnabled: false,
legacyReplica: throwingPrisma,
},
runStore
);
const result = await presenter.call("batch_pt", env(ctx));
expect(result).toBeDefined();
expect(result!.id).toBe("batch_pt");
expect(result!.items).toHaveLength(1);
expect(result!.items[0]).toEqual({
ok: true,
id: "run_pt_g",
taskIdentifier: "my-task",
output: JSON.stringify({ value: 42 }),
outputType: "application/json",
});
}
);
postgresTest("single-DB absent batch friendlyId returns undefined", async ({ prisma }) => {
const ctx = await seedEnv(prisma, "pt-nf");
const runStore = new PostgresRunStore({ prisma, readOnlyPrisma: prisma });
const presenter = new ApiBatchResultsPresenter(
prisma,
prisma,
{ splitEnabled: false },
runStore
);
const result = await presenter.call("batch_missing", env(ctx));
expect(result).toBeUndefined();
});
});