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(); }); });