test/shared/boot-checks.test.ts

Rama main · réplica de lectura del repositorio original.

import { expect } from "@std/expect";
import { it as test } from "@std/testing/bdd";
import {
  BOOT_CHECKS,
  validateBootChecks,
  validateOptionalMainInstanceKey,
} from "#shared/boot-checks.ts";
import { describeWithEnv } from "#test-utils/db.ts";
import { clearTestEncryptionKey, withEnv } from "#test-utils/env.ts";

describeWithEnv("boot checks", { encryptionKey: true }, () => {
  test("lists the global checks run before serving requests", () => {
    expect(BOOT_CHECKS.map((check) => check.name)).toEqual([
      "DB_ENCRYPTION_KEY",
      "MAIN_INSTANCE_KEY",
      "SCHEDULED_TASK_KEY",
      "UPTIME_KUMA",
    ]);
  });

  test("allows MAIN_INSTANCE_KEY to be absent", () => {
    using _env = withEnv({ MAIN_INSTANCE_KEY: undefined });
    expect(() => validateOptionalMainInstanceKey()).not.toThrow();
  });

  test("allows a high-entropy MAIN_INSTANCE_KEY", () => {
    using _env = withEnv({
      MAIN_INSTANCE_KEY: "instance-key-0123456789abcdef0123456789abcdef",
    });
    expect(() => validateOptionalMainInstanceKey()).not.toThrow();
  });

  test("allows a 32-byte Unicode MAIN_INSTANCE_KEY", () => {
    using _env = withEnv({ MAIN_INSTANCE_KEY: "é".repeat(16) });
    expect(() => validateOptionalMainInstanceKey()).not.toThrow();
  });

  test("rejects a 31-byte Unicode MAIN_INSTANCE_KEY", () => {
    using _env = withEnv({ MAIN_INSTANCE_KEY: `${"é".repeat(15)}a` });
    expect(() => validateOptionalMainInstanceKey()).toThrow(
      "MAIN_INSTANCE_KEY must be at least 32 bytes when set, got 31 bytes",
    );
  });

  test("fails fast when MAIN_INSTANCE_KEY is blank", () => {
    using _env = withEnv({ MAIN_INSTANCE_KEY: "   " });
    expect(() => validateOptionalMainInstanceKey()).toThrow(
      "MAIN_INSTANCE_KEY must be blank/unset or at least 32 bytes",
    );
  });

  test("fails fast when MAIN_INSTANCE_KEY is too short", () => {
    using _env = withEnv({ MAIN_INSTANCE_KEY: "short-key" });
    expect(() => validateOptionalMainInstanceKey()).toThrow(
      "MAIN_INSTANCE_KEY must be at least 32 bytes when set, got 9 bytes",
    );
  });

  test("runs DB_ENCRYPTION_KEY validation during boot checks", () => {
    clearTestEncryptionKey();
    expect(() => validateBootChecks()).toThrow(
      "DB_ENCRYPTION_KEY environment variable is required",
    );
  });

  test("runs MAIN_INSTANCE_KEY validation during boot checks", () => {
    using _env = withEnv({ MAIN_INSTANCE_KEY: "short-key" });
    expect(() => validateBootChecks()).toThrow(
      "MAIN_INSTANCE_KEY must be at least 32 bytes when set, got 9 bytes",
    );
  });

  test("runs scheduled key validation during boot checks", () => {
    using _env = withEnv({ SCHEDULED_TASK_KEY: "invalid" });
    expect(() => validateBootChecks()).toThrow(
      "SCHEDULED_TASK_KEY must be canonical unpadded base64url for exactly 32 bytes",
    );
  });

  test("runs Uptime Kuma validation during boot checks", () => {
    using _env = withEnv({ UPTIME_KUMA_URL: "https://kuma.example.test" });
    expect(() => validateBootChecks()).toThrow(
      "UPTIME_KUMA_URL, UPTIME_KUMA_USERNAME and UPTIME_KUMA_PASSWORD must all be set",
    );
  });
});