@goplusvn/core 0.1.53 → 0.1.55

package/src/cron/__tests__/db-cron-manager.test.ts

@@ -0,0 +1,316 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+
+import {
+  configureCronManager,
+  DbCronJobManager,
+  getJobExecutionContext,
+} from "../db-cron-manager";
+import type { CronDb } from "../db-cron-manager";
+
+interface JobRow {
+  name: string;
+  cronTime: string;
+  enabled: boolean;
+  status?: string;
+  lastRun?: Date | null;
+  nextRun?: Date | null;
+  error?: string | null;
+}
+
+interface LogRow {
+  id: string;
+  jobName: string;
+  status: string;
+  actions?: unknown;
+  durationMs?: number | null;
+  error?: string | null;
+  summary?: string | null;
+}
+
+/** Fake Prisma tối thiểu — đủ để quan sát side-effect DB của manager. */
+function makeDb(seed: JobRow[] = []) {
+  const jobs = new Map(seed.map((j) => [j.name, { ...j }]));
+  const logs: LogRow[] = [];
+  let seq = 0;
+
+  const db = {
+    systemJob: {
+      count: vi.fn(async () => jobs.size),
+      findUnique: vi.fn(
+        async ({ where }: { where: { name: string } }) =>
+          jobs.get(where.name) ?? null,
+      ),
+      create: vi.fn(async ({ data }: { data: JobRow }) => {
+        jobs.set(data.name, { ...data });
+        return jobs.get(data.name);
+      }),
+      update: vi.fn(
+        async ({
+          where,
+          data,
+        }: {
+          where: { name: string };
+          data: Partial<JobRow>;
+        }) => {
+          const row = jobs.get(where.name);
+          if (!row) throw new Error(`no job ${where.name}`);
+          Object.assign(row, data);
+          return row;
+        },
+      ),
+    },
+    jobExecutionLog: {
+      create: vi.fn(async ({ data }: { data: Omit<LogRow, "id"> }) => {
+        const row = { id: `log${++seq}`, ...data };
+        logs.push(row);
+        return row;
+      }),
+      update: vi.fn(
+        async ({
+          where,
+          data,
+        }: {
+          where: { id: string };
+          data: Partial<LogRow>;
+        }) => {
+          const row = logs.find((l) => l.id === where.id);
+          if (!row) throw new Error(`no log ${where.id}`);
+          Object.assign(row, data);
+          return row;
+        },
+      ),
+    },
+  };
+
+  return { db: db as unknown as CronDb, jobs, logs };
+}
+
+const silentLogger = { info: vi.fn(), warn: vi.fn(), error: vi.fn() };
+
+/** Chờ các promise nền (syncJobWithDb chạy fire-and-forget trong addJob). */
+const flush = () => new Promise((r) => setTimeout(r, 0));
+
+describe("DbCronJobManager — đăng ký job", () => {
+  let manager: DbCronJobManager;
+
+  beforeEach(() => {
+    manager = new DbCronJobManager();
+  });
+  afterEach(() => manager.stopAll());
+
+  it("chưa có row DB → tạo mới và chạy theo cờ start", async () => {
+    const { db, jobs } = makeDb();
+    configureCronManager({ db, logger: silentLogger });
+
+    manager.addJob({
+      name: "sync",
+      cronTime: "5m",
+      onTick: vi.fn(),
+      start: true,
+    });
+    await flush();
+
+    expect(jobs.get("sync")).toMatchObject({ cronTime: "5m", enabled: true });
+    expect(manager.getJob("sync")?.isRunning()).toBe(true);
+  });
+
+  it("DB enabled=false THẮNG start:true — admin tắt thì deploy mới không tự bật", async () => {
+    const { db } = makeDb([{ name: "sync", cronTime: "5m", enabled: false }]);
+    configureCronManager({ db, logger: silentLogger });
+
+    manager.addJob({
+      name: "sync",
+      cronTime: "5m",
+      onTick: vi.fn(),
+      start: true,
+    });
+    await flush();
+
+    expect(manager.getJob("sync")?.isRunning()).toBe(false);
+  });
+
+  it("lịch trong CODE đổi → ghi ngược lại DB", async () => {
+    const { db, jobs } = makeDb([
+      { name: "sync", cronTime: "1h", enabled: false },
+    ]);
+    configureCronManager({ db, logger: silentLogger });
+
+    manager.addJob({ name: "sync", cronTime: "15m", onTick: vi.fn() });
+    await flush();
+
+    expect(jobs.get("sync")?.cronTime).toBe("15m");
+  });
+
+  it("app chưa sync feature (thiếu model) → memory-only, KHÔNG nổ", async () => {
+    configureCronManager({ db: {} as CronDb, logger: silentLogger });
+
+    manager.addJob({
+      name: "sync",
+      cronTime: "5m",
+      onTick: vi.fn(),
+      start: true,
+    });
+    await manager.init();
+    await flush();
+
+    expect(manager.getJob("sync")?.isRunning()).toBe(true);
+  });
+});
+
+describe("DbCronJobManager — lịch sử thực thi", () => {
+  let manager: DbCronJobManager;
+
+  beforeEach(() => {
+    manager = new DbCronJobManager();
+  });
+  afterEach(() => manager.stopAll());
+
+  it("chạy thành công: log running → success kèm actions của job", async () => {
+    const { db, jobs, logs } = makeDb([
+      { name: "sync", cronTime: "5m", enabled: true },
+    ]);
+    configureCronManager({ db, logger: silentLogger });
+
+    manager.addJob({
+      name: "sync",
+      cronTime: "5m",
+      onTick: async () => {
+        getJobExecutionContext()?.log("Đã tải giá", "12 mã");
+      },
+    });
+    await flush();
+    await manager.runJobNow("sync");
+    await flush();
+
+    expect(logs).toHaveLength(1);
+    expect(logs[0]).toMatchObject({ jobName: "sync", status: "success" });
+    expect(logs[0].actions).toEqual([
+      expect.objectContaining({ action: "Đã tải giá", details: "12 mã" }),
+    ]);
+    expect(jobs.get("sync")).toMatchObject({ status: "idle", error: null });
+  });
+
+  it("chạy lỗi: log failed + job.status failed + giữ nguyên message", async () => {
+    const { db, jobs, logs } = makeDb([
+      { name: "sync", cronTime: "5m", enabled: true },
+    ]);
+    configureCronManager({ db, logger: silentLogger });
+
+    manager.addJob({
+      name: "sync",
+      cronTime: "5m",
+      onTick: async () => {
+        throw new Error("upstream 503");
+      },
+    });
+    await flush();
+    await manager.runJobNow("sync"); // fire-and-forget: lỗi được nuốt ở đây
+    await flush();
+
+    expect(logs[0]).toMatchObject({ status: "failed" });
+    expect(String(logs[0].error)).toContain("upstream 503");
+    expect(jobs.get("sync")?.status).toBe("failed");
+    expect(String(jobs.get("sync")?.error)).toContain("upstream 503");
+  });
+
+  it("ngữ cảnh được dọn sau khi chạy — không rò sang lần sau", async () => {
+    const { db } = makeDb([{ name: "sync", cronTime: "5m", enabled: true }]);
+    configureCronManager({ db, logger: silentLogger });
+
+    manager.addJob({ name: "sync", cronTime: "5m", onTick: vi.fn() });
+    await flush();
+    await manager.runJobNow("sync");
+    await flush();
+
+    expect(getJobExecutionContext()).toBeNull();
+  });
+
+  it("đổi lịch xong VẪN ghi lịch sử (bản cũ mất log sau updateJob)", async () => {
+    const { db, jobs, logs } = makeDb([
+      { name: "sync", cronTime: "5m", enabled: true },
+    ]);
+    configureCronManager({ db, logger: silentLogger });
+
+    const onTick = vi.fn();
+    manager.addJob({ name: "sync", cronTime: "5m", onTick });
+    await flush();
+
+    expect(await manager.updateJob("sync", "30m", false)).toBe(true);
+    expect(jobs.get("sync")?.cronTime).toBe("30m");
+    expect(manager.getJob("sync")?.isRunning()).toBe(false);
+
+    await manager.runJobNow("sync");
+    await flush();
+
+    expect(onTick).toHaveBeenCalledTimes(1);
+    expect(logs).toHaveLength(1);
+    expect(logs[0].status).toBe("success");
+  });
+
+  it("updateJob job lạ → false, không đụng DB", async () => {
+    const { db } = makeDb();
+    configureCronManager({ db, logger: silentLogger });
+    expect(await manager.updateJob("khong-co", "5m")).toBe(false);
+  });
+});
+
+describe("DbCronJobManager — điều khiển", () => {
+  let manager: DbCronJobManager;
+
+  beforeEach(() => {
+    manager = new DbCronJobManager();
+  });
+  afterEach(() => manager.stopAll());
+
+  it("toggleJob ghi cờ enabled xuống DB", async () => {
+    const { db, jobs } = makeDb([
+      { name: "sync", cronTime: "5m", enabled: true },
+    ]);
+    configureCronManager({ db, logger: silentLogger });
+
+    manager.addJob({ name: "sync", cronTime: "5m", onTick: vi.fn() });
+    await flush();
+    expect(manager.getJob("sync")?.isRunning()).toBe(true);
+
+    await manager.toggleJob("sync");
+    expect(manager.getJob("sync")?.isRunning()).toBe(false);
+    expect(jobs.get("sync")?.enabled).toBe(false);
+  });
+
+  it("runJobNow/toggleJob với job chưa đăng ký → false", async () => {
+    const { db } = makeDb();
+    configureCronManager({ db, logger: silentLogger });
+    expect(await manager.runJobNow("khong-co")).toBe(false);
+    expect(await manager.toggleJob("khong-co")).toBe(false);
+  });
+
+  it("removeJob dừng timer và quên callback", async () => {
+    const { db } = makeDb([{ name: "sync", cronTime: "5m", enabled: true }]);
+    configureCronManager({ db, logger: silentLogger });
+
+    manager.addJob({ name: "sync", cronTime: "5m", onTick: vi.fn() });
+    await flush();
+    manager.removeJob("sync");
+
+    expect(manager.getJob("sync")).toBeUndefined();
+    expect(manager.getAllJobs()).toHaveLength(0);
+    expect(await manager.runJobNow("sync")).toBe(false);
+  });
+
+  it("getJobsInfo trả trạng thái runtime cho trang admin", async () => {
+    const { db } = makeDb([{ name: "sync", cronTime: "5m", enabled: true }]);
+    configureCronManager({ db, logger: silentLogger });
+
+    manager.addJob({ name: "sync", cronTime: "5m", onTick: vi.fn() });
+    await flush();
+
+    const info = manager.getJobsInfo();
+    expect(info).toHaveLength(1);
+    expect(info[0]).toMatchObject({
+      name: "sync",
+      cronTime: "5m",
+      isRunning: true,
+    });
+    expect(info[0].nextDate).toBeInstanceOf(Date);
+  });
+});