Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/packages/foundation/src/flags.test.ts
T
2026-07-08 16:15:37 +02:00

77 lines
3.2 KiB
TypeScript

import { describe, expect, test } from "vitest";
import { defineFlag, featureFlag, normalizeFlagScope, selectFlagRecord } from "./flags.js";
describe("defineFlag", () => {
test("defaults defaultEnabled to false when omitted", () => {
expect(defineFlag({ key: "x.flag" }).defaultEnabled).toBe(false);
});
test("preserves an explicit defaultEnabled and description", () => {
expect(defineFlag({ key: "x.flag", defaultEnabled: true, description: "demo" })).toEqual({
key: "x.flag",
defaultEnabled: true,
description: "demo",
});
});
});
describe("featureFlag", () => {
test("short-circuits on an explicit boolean override regardless of records", () => {
expect(featureFlag({ key: "x.flag", override: false, defaultEnabled: true, records: [{ enabled: true }] })).toBe(false);
expect(featureFlag({ key: "x.flag", override: true, defaultEnabled: false })).toBe(true);
});
test("falls back to false when there is no record and no default", () => {
expect(featureFlag({ key: "x.flag" })).toBe(false);
});
test("falls back to the default when there is no matching record", () => {
expect(featureFlag({ key: "x.flag", defaultEnabled: true, records: [{ key: "other.flag", enabled: false }] })).toBe(true);
});
test("matches records that identify the flag through the legacy name field", () => {
expect(featureFlag({ key: "x.flag", records: [{ name: "x.flag", scope: "global", enabled: true }] })).toBe(true);
});
});
describe("normalizeFlagScope", () => {
test("classifies user scope by explicit scope or by userId", () => {
expect(normalizeFlagScope({ scope: "user", enabled: true })).toBe("user");
expect(normalizeFlagScope({ userId: "user_1", enabled: true })).toBe("user");
});
test("classifies tenant scope by explicit scope or by tenantId", () => {
expect(normalizeFlagScope({ scope: "tenant", enabled: true })).toBe("tenant");
expect(normalizeFlagScope({ tenantId: "tenant_1", enabled: true })).toBe("tenant");
});
test("classifies records without any scope hint as global", () => {
expect(normalizeFlagScope({ enabled: true })).toBe("global");
});
test("prefers user over tenant when both ids are present", () => {
expect(normalizeFlagScope({ tenantId: "tenant_1", userId: "user_1", enabled: true })).toBe("user");
});
});
describe("selectFlagRecord", () => {
test("prefers a user-scoped record over tenant and global records", () => {
const records = [
{ scope: "global", enabled: false, key: "x.flag" },
{ tenantId: "tenant_1", enabled: false, key: "x.flag" },
{ userId: "user_1", tenantId: "tenant_1", enabled: true, key: "x.flag" },
];
expect(selectFlagRecord({ key: "x.flag", records, tenantId: "tenant_1", userId: "user_1" })?.enabled).toBe(true);
});
test("returns null when no record matches the flag key", () => {
expect(selectFlagRecord({ key: "x.flag", records: [{ key: "other.flag", enabled: true }] })).toBeNull();
});
test("ignores a user-scoped record bound to a different tenant", () => {
const records = [{ scope: "user", userId: "user_1", tenantId: "tenant_2", enabled: true, key: "x.flag" }];
expect(selectFlagRecord({ key: "x.flag", records, tenantId: "tenant_1", userId: "user_1" })).toBeNull();
});
});