fix(api): harden reminder and webhook delivery

This commit is contained in:
2026-03-31 22:36:53 +02:00
parent 0b192efdb1
commit 6d4de85660
4 changed files with 396 additions and 53 deletions
@@ -0,0 +1,179 @@
import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
import { emitNotificationCreated, emitReminderDue } from "../sse/event-bus.js";
import { logger } from "../lib/logger.js";
import { startReminderScheduler, stopReminderScheduler } from "../lib/reminder-scheduler.js";
const { findMany, create, update } = vi.hoisted(() => ({
findMany: vi.fn(),
create: vi.fn(),
update: vi.fn(),
}));
vi.mock("@capakraken/db", () => ({
prisma: {
notification: {
findMany,
create,
update,
},
},
}));
vi.mock("../sse/event-bus.js", () => ({
emitReminderDue: vi.fn(),
emitNotificationCreated: vi.fn(),
}));
vi.mock("../lib/logger.js", () => ({
logger: {
error: vi.fn(),
warn: vi.fn(),
info: vi.fn(),
debug: vi.fn(),
},
}));
describe("reminder scheduler logging", () => {
beforeEach(() => {
vi.clearAllMocks();
vi.useRealTimers();
findMany.mockResolvedValue([]);
create.mockResolvedValue({ id: "notification_1" });
update.mockResolvedValue({});
});
afterEach(() => {
stopReminderScheduler();
});
it("logs scheduler lifecycle with structured metadata", async () => {
startReminderScheduler();
await vi.waitFor(() => {
expect(findMany).toHaveBeenCalled();
});
expect(logger.info).toHaveBeenCalledWith(
{ pollIntervalMs: 60_000 },
"Starting reminder scheduler",
);
stopReminderScheduler();
expect(logger.info).toHaveBeenCalledWith("Stopped reminder scheduler");
});
it("logs reminder processing failures with reminder context", async () => {
findMany.mockResolvedValueOnce([
{
id: "reminder_1",
userId: "user_1",
recurrence: null,
priority: "HIGH",
title: "Follow up",
body: "Body",
entityId: null,
entityType: null,
link: null,
nextRemindAt: new Date("2026-03-30T08:00:00.000Z"),
},
]);
update.mockRejectedValueOnce(new Error("db write failed"));
startReminderScheduler();
await vi.waitFor(() => {
expect(logger.error).toHaveBeenCalledWith(
{
err: expect.any(Error),
reminderId: "reminder_1",
userId: "user_1",
},
"Failed to process reminder",
);
});
expect(emitReminderDue).not.toHaveBeenCalled();
expect(emitNotificationCreated).not.toHaveBeenCalled();
});
it("does not start a second reminder poll while the previous batch is still running", async () => {
vi.useFakeTimers();
let releaseFindMany: ((value: unknown[]) => void) | null = null;
findMany.mockImplementationOnce(
() =>
new Promise((resolve) => {
releaseFindMany = resolve;
}),
);
startReminderScheduler();
expect(findMany).toHaveBeenCalledTimes(1);
await vi.advanceTimersByTimeAsync(60_000);
expect(findMany).toHaveBeenCalledTimes(1);
expect(logger.warn).toHaveBeenCalledWith(
"Skipping reminder scheduler tick while previous run is still processing",
);
releaseFindMany?.([]);
await Promise.resolve();
await vi.advanceTimersByTimeAsync(60_000);
expect(findMany).toHaveBeenCalledTimes(2);
});
it("advances overdue recurring reminders to the first occurrence after now", async () => {
const now = new Date();
const staleNextRemindAt = new Date(now);
staleNextRemindAt.setDate(staleNextRemindAt.getDate() - 3);
staleNextRemindAt.setHours(8, 0, 0, 0);
const expectedNextRemindAt = new Date(staleNextRemindAt);
while (expectedNextRemindAt.getTime() <= now.getTime()) {
expectedNextRemindAt.setDate(expectedNextRemindAt.getDate() + 1);
}
const overdueReminder = {
id: "reminder_recurring_1",
userId: "user_1",
recurrence: "daily",
priority: "MEDIUM",
title: "Daily standup prep",
body: "Body",
entityId: null,
entityType: null,
link: null,
nextRemindAt: staleNextRemindAt,
};
findMany.mockResolvedValueOnce([overdueReminder]);
startReminderScheduler();
await vi.waitFor(() => {
expect(create).toHaveBeenCalledWith(
expect.objectContaining({
data: expect.objectContaining({
userId: "user_1",
sourceId: "reminder_recurring_1",
type: "REMINDER_DUE",
}),
}),
);
});
expect(update).toHaveBeenCalledWith({
where: { id: "reminder_recurring_1" },
data: {
nextRemindAt: expectedNextRemindAt,
},
});
expect(emitNotificationCreated).toHaveBeenCalledWith("user_1", "notification_1");
expect(emitReminderDue).toHaveBeenCalledWith("user_1", "notification_1");
});
});
@@ -0,0 +1,122 @@
import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
import { logger } from "../lib/logger.js";
import { dispatchWebhooks } from "../lib/webhook-dispatcher.js";
const { sendSlackNotification } = vi.hoisted(() => ({
sendSlackNotification: vi.fn(),
}));
vi.mock("../lib/slack-notify.js", () => ({
sendSlackNotification,
}));
vi.mock("../lib/logger.js", () => ({
logger: {
error: vi.fn(),
warn: vi.fn(),
info: vi.fn(),
debug: vi.fn(),
},
}));
describe("webhook dispatcher logging", () => {
beforeEach(() => {
vi.clearAllMocks();
});
afterEach(() => {
vi.unstubAllGlobals();
});
it("logs dispatcher-level failures with event context", async () => {
const db = {
webhook: {
findMany: vi.fn().mockRejectedValue(new Error("database unavailable")),
},
};
dispatchWebhooks(db, "estimate.submitted", { id: "estimate_1" });
await vi.waitFor(() => {
expect(logger.error).toHaveBeenCalledWith(
{
err: expect.any(Error),
event: "estimate.submitted",
},
"Failed to dispatch webhooks",
);
});
});
it("logs webhook delivery failures with webhook metadata", async () => {
sendSlackNotification.mockRejectedValueOnce(new Error("slack down"));
const db = {
webhook: {
findMany: vi.fn().mockResolvedValue([
{
id: "wh_1",
name: "Ops Slack",
url: "https://hooks.slack.com/services/test",
secret: null,
events: ["project.created"],
},
]),
},
};
dispatchWebhooks(db, "project.created", { id: "project_1", name: "Project One" });
await vi.waitFor(() => {
expect(logger.warn).toHaveBeenCalledWith(
{
err: expect.any(Error),
event: "project.created",
webhookId: "wh_1",
webhookName: "Ops Slack",
webhookUrl: "https://hooks.slack.com/services/test",
},
"Webhook delivery failed",
);
});
});
it("treats non-2xx HTTP webhook responses as delivery failures", async () => {
const fetchMock = vi.fn().mockResolvedValue({
ok: false,
status: 500,
});
vi.stubGlobal("fetch", fetchMock);
const db = {
webhook: {
findMany: vi.fn().mockResolvedValue([
{
id: "wh_http_1",
name: "Project Webhook",
url: "https://example.com/webhooks/project",
secret: "secret",
events: ["project.created"],
},
]),
},
};
dispatchWebhooks(db, "project.created", { id: "project_1", name: "Project One" });
await vi.waitFor(() => {
expect(logger.warn).toHaveBeenCalledWith(
{
err: expect.any(Error),
event: "project.created",
webhookId: "wh_http_1",
webhookName: "Project Webhook",
webhookUrl: "https://example.com/webhooks/project",
},
"Webhook delivery failed",
);
});
expect(fetchMock).toHaveBeenCalledTimes(1);
});
});