77 lines
3.2 KiB
TypeScript
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();
|
|
});
|
|
});
|