@voltro/plugin-flags 0.54.0 → 0.56.0

package/dist/index.js

@@ -1,25 +1,25 @@
-import { evaluateDescriptor as e, evaluateVariantsDescriptor as t, flagsRpcClientImports as n } from "./rpc.js";
-import { i as r, n as i, r as a, t as o } from "./define-D9Eet7wA.js";
-import { FlagDisabled as s } from "./errors.js";
-import { Effect as c } from "effect";
-import { definePlugin as l, pluginInstanceName as u } from "@voltro/protocol";
-import { boolean as d, derivedRowId as f, id as p, integer as m, json as h, queryFor as g, registerRetention as _, retentionTtlMsFromEnv as v, table as y, text as b, timestamp as x } from "@voltro/database";
+import { BASE_NAME as e, evaluateDescriptor as t, evaluateVariantsDescriptor as n, flagsRpcClientImports as r } from "./rpc.js";
+import { i, n as a, r as o, t as s } from "./define-D9Eet7wA.js";
+import { FlagDisabled as c } from "./errors.js";
+import { Effect as l } from "effect";
+import { definePlugin as u, pluginInstanceName as d } from "@voltro/protocol";
+import { boolean as f, derivedRowId as p, id as m, integer as h, json as g, queryFor as _, registerRetention as v, retentionTtlMsFromEnv as y, table as b, text as x, timestamp as S } from "@voltro/database";
 //#region src/evaluate.ts
-var S = (e) => typeof e == "boolean" ? { enabled: e } : e, C = (e, t) => {
+var C = (e) => typeof e == "boolean" ? { enabled: e } : e, w = (e, t) => {
 	let n = 2166136261, r = `${e}:${t}`;
 	for (let e = 0; e < r.length; e++) n ^= r.charCodeAt(e), n = Math.imul(n, 16777619);
 	return n >>> 0;
-}, ee = (e, t) => C(e, t) % 100, w = (e, t) => C(`${e}:variant`, t) % 1e4, T = (e, t) => {
+}, T = (e, t) => w(e, t) % 100, ee = (e, t) => w(`${e}:variant`, t) % 1e4, E = (e, t) => {
 	if (e.subjectIds && !(t.id != null && e.subjectIds.includes(t.id)) || e.tenantIds && !(t.tenantId != null && e.tenantIds.includes(t.tenantId)) || e.subjectTypes && !(t.type != null && e.subjectTypes.includes(t.type))) return !1;
 	if (e.metadata) {
 		let n = t.metadata ?? {};
 		for (let [t, r] of Object.entries(e.metadata)) if (String(n[t]) !== r) return !1;
 	}
 	return !0;
-}, E = (e) => typeof e == "number" ? e : Date.parse(e), D = (e, t) => (e.rolloutBy === "tenant" ? t.tenantId : t.id) ?? "anon", O = (e, t) => {
-	if (e.activateAt != null && t < E(e.activateAt) || e.deactivateAt != null && t >= E(e.deactivateAt)) return { active: !1 };
+}, D = (e) => typeof e == "number" ? e : Date.parse(e), O = (e, t) => (e.rolloutBy === "tenant" ? t.tenantId : t.id) ?? "anon", k = (e, t) => {
+	if (e.activateAt != null && t < D(e.activateAt) || e.deactivateAt != null && t >= D(e.deactivateAt)) return { active: !1 };
 	if (e.ramp) {
-		let { from: n, to: r, startAt: i, endAt: a } = e.ramp, o = E(i), s = E(a);
+		let { from: n, to: r, startAt: i, endAt: a } = e.ramp, o = D(i), s = D(a);
 		if (t <= o) return {
 			active: !0,
 			rollout: n
@@ -35,71 +35,71 @@ var S = (e) => typeof e == "boolean" ? { enabled: e } : e, C = (e, t) => {
 		};
 	}
 	return { active: !0 };
-}, k = (e, t, n, r = Date.now()) => {
-	let i = S(t);
+}, A = (e, t, n, r = Date.now()) => {
+	let i = C(t);
 	if (i.enabled === !1) return !1;
 	let a;
 	if (i.schedule) {
-		let e = O(i.schedule, r);
+		let e = k(i.schedule, r);
 		if (!e.active) return !1;
 		a = e.rollout;
 	}
-	if (i.targeting && i.targeting.length > 0 && !i.targeting.some((e) => T(e, n))) return !1;
+	if (i.targeting && i.targeting.length > 0 && !i.targeting.some((e) => E(e, n))) return !1;
 	let o = a ?? i.rollout ?? 100;
 	if (o < 100 && o > 0) {
-		if (!(ee(e, D(i, n)) < o)) return !1;
+		if (!(T(e, O(i, n)) < o)) return !1;
 	} else if (o <= 0) return !1;
-	return i.variants && i.variants.length > 0 && i.offVariant != null ? A(e, i, n).name !== i.offVariant : !0;
-}, te = (e) => {
+	return i.variants && i.variants.length > 0 && i.offVariant != null ? M(e, i, n).name !== i.offVariant : !0;
+}, j = (e) => {
 	let t = e.reduce((e, t) => e + (t.weight ?? 1), 0) || e.length, n = 0;
 	return e.map((r, i) => (n += r.weight ?? 1, i === e.length - 1 ? 1e4 : Math.round(n / t * 1e4)));
-}, A = (e, t, n) => {
+}, M = (e, t, n) => {
 	let r = t.variants ?? [];
 	if (r.length === 0) throw Error(`flag "${e}" has no variants`);
-	let i = w(e, D(t, n)), a = te(r);
+	let i = ee(e, O(t, n)), a = j(r);
 	for (let e = 0; e < r.length; e++) if (i < a[e]) return r[e];
 	return r[r.length - 1];
-}, j = (e, t, n, r = Date.now()) => {
-	let i = S(t), a = k(e, t, n, r);
+}, N = (e, t, n, r = Date.now()) => {
+	let i = C(t), a = A(e, t, n, r);
 	if (!i.variants || i.variants.length === 0) return {
 		name: a ? "on" : "off",
 		value: a,
 		enabled: a
 	};
-	let o = A(e, i, n);
+	let o = M(e, i, n);
 	return {
 		name: o.name,
 		value: o.value,
 		enabled: a
 	};
-}, ne = (e, t, n = Date.now()) => {
+}, te = (e, t, n = Date.now()) => {
 	let r = {};
-	for (let [i, a] of Object.entries(e)) r[i] = k(i, a, t, n);
+	for (let [i, a] of Object.entries(e)) r[i] = A(i, a, t, n);
 	return r;
-}, re = (e, t, n = Date.now()) => {
+}, ne = (e, t, n = Date.now()) => {
 	let r = {};
-	for (let [i, a] of Object.entries(e)) r[i] = j(i, a, t, n);
+	for (let [i, a] of Object.entries(e)) r[i] = N(i, a, t, n);
 	return r;
-}, M = "_voltro_feature_flag_audit", N = "_voltro_feature_flags", P = y(N, {
-	id: p({ prefix: "flag" }),
-	key: b().unique(),
-	enabled: d().default(!0),
-	rollout: m().nullable(),
-	rolloutBy: b().nullable(),
-	targeting: h().nullable(),
-	variants: h().nullable(),
-	offVariant: b().nullable(),
-	schedule: h().nullable(),
-	description: b().nullable(),
-	updatedAt: x().default("now").onUpdate("now")
-}), F = y(M, {
-	id: p({ prefix: "flagaud" }),
-	flag: b(),
-	enabled: d(),
-	previousEnabled: d().nullable(),
-	actorId: b().nullable(),
-	at: x().default("now")
-}).index("byFlagAuditFlag", ["flag"]).index("byFlagAuditAt", ["at"]), I = (e, t) => {
+}, P = "_voltro_feature_flag_audit", F = "_voltro_feature_flags", I = b(F, {
+	id: m({ prefix: "flag" }),
+	key: x().unique(),
+	enabled: f().default(!0),
+	rollout: h().nullable(),
+	rolloutBy: x().nullable(),
+	targeting: g().nullable(),
+	variants: g().nullable(),
+	offVariant: x().nullable(),
+	schedule: g().nullable(),
+	description: x().nullable(),
+	updatedAt: S().default("now").onUpdate("now")
+}), L = b(P, {
+	id: m({ prefix: "flagaud" }),
+	flag: x(),
+	enabled: f(),
+	previousEnabled: f().nullable(),
+	actorId: x().nullable(),
+	at: S().default("now")
+}).index("byFlagAuditFlag", ["flag"]).index("byFlagAuditAt", ["at"]), re = (e, t) => {
 	let n = { ...e };
 	for (let e of t) {
 		let t = {
@@ -115,7 +115,7 @@ var S = (e) => typeof e == "boolean" ? { enabled: e } : e, C = (e, t) => {
 		n[e.key] = t;
 	}
 	return n;
-}, L = new class {
+}, R = new class {
 	flags = {};
 	set(e) {
 		this.flags = e;
@@ -126,19 +126,19 @@ var S = (e) => typeof e == "boolean" ? { enabled: e } : e, C = (e, t) => {
 	get(e) {
 		return this.flags[e];
 	}
-}(), R = (e, t) => z(e, t) !== null, z = (e, t) => {
-	let n = L.get(e);
+}(), z = (e, t) => B(e, t) !== null, B = (e, t) => {
+	let n = R.get(e);
 	if (n === void 0) return null;
-	let r = S(n), i = r.enabled !== !1;
-	return L.set({
-		...L.all(),
+	let r = C(n), i = r.enabled !== !1;
+	return R.set({
+		...R.all(),
 		[e]: {
 			...r,
 			enabled: t
 		}
 	}), i;
-}, B = (e) => Object.entries(e).map(([e, t]) => {
-	let n = S(t);
+}, V = (e) => Object.entries(e).map(([e, t]) => {
+	let n = C(t);
 	return {
 		key: e,
 		enabled: n.enabled !== !1,
@@ -148,7 +148,7 @@ var S = (e) => typeof e == "boolean" ? { enabled: e } : e, C = (e, t) => {
 		description: n.description
 	};
 }), ie = (e, t) => {
-	let n = S(t);
+	let n = C(t);
 	return {
 		key: e,
 		enabled: n.enabled !== !1,
@@ -161,7 +161,7 @@ var S = (e) => typeof e == "boolean" ? { enabled: e } : e, C = (e, t) => {
 		description: n.description ?? null
 	};
 }, ae = (e) => ({
-	loadOverrides: async () => (await e.query(g(P).descriptor)).map((e) => ({
+	loadOverrides: async () => (await e.query(_(I).descriptor)).map((e) => ({
 		key: String(e.key),
 		enabled: e.enabled === !0 || e.enabled === 1,
 		rollout: e.rollout == null ? null : Number(e.rollout),
@@ -174,7 +174,7 @@ var S = (e) => typeof e == "boolean" ? { enabled: e } : e, C = (e, t) => {
 	})),
 	upsertOverride: async (t) => {
 		let n = {
-			id: f("flag", t.key),
+			id: p("flag", t.key),
 			key: t.key,
 			enabled: t.enabled,
 			rollout: t.rollout,
@@ -186,7 +186,7 @@ var S = (e) => typeof e == "boolean" ? { enabled: e } : e, C = (e, t) => {
 			description: t.description,
 			updatedAt: /* @__PURE__ */ new Date()
 		};
-		await e.upsert(N, n, { conflictColumns: ["key"] });
+		await e.upsert(F, n, { conflictColumns: ["key"] });
 	}
 }), oe = (e) => ({
 	flag: String(e.flag),
@@ -196,7 +196,7 @@ var S = (e) => typeof e == "boolean" ? { enabled: e } : e, C = (e, t) => {
 	at: e.at instanceof Date ? e.at : new Date(String(e.at))
 }), se = (e) => ({
 	record: async (t) => {
-		await e.insert(M, {
+		await e.insert(P, {
 			id: `flagaud_${t.at.getTime()}_${Math.random().toString(36).slice(2, 10)}`,
 			flag: t.flag,
 			enabled: t.enabled,
@@ -206,12 +206,12 @@ var S = (e) => typeof e == "boolean" ? { enabled: e } : e, C = (e, t) => {
 		});
 	},
 	list: async (t) => {
-		let n = g(F).orderBy("at", "desc");
+		let n = _(L).orderBy("at", "desc");
 		t?.limit != null && (n = n.limit(t.limit));
 		let r = (await e.query(n.descriptor)).map(oe);
 		return t?.flag == null ? r : r.filter((e) => e.flag === t.flag);
 	}
-}), V = (e, t) => {
+}), H = (e, t) => {
 	let n = new Map(t.map((e) => [e.name, e])), r = [];
 	for (let t of e) {
 		let e = t.experiment;
@@ -250,24 +250,24 @@ var S = (e) => typeof e == "boolean" ? { enabled: e } : e, C = (e, t) => {
 		}
 	}
 	return r;
-}, H = (e, t) => {
-	let n = V(e, t);
+}, U = (e, t) => {
+	let n = H(e, t);
 	if (n.length === 0) return;
 	let r = n.map((e) => `  · flag "${e.flag}" → experiment "${e.experiment}": ${e.problem}`);
 	throw Error(`@voltro/plugin-flags: ${n.length} flag→experiment link problem(s):\n${r.join("\n")}`);
-}, U = 864e5, W = (e) => typeof e == "number" ? e : Date.parse(e), G = (e, t) => {
-	let n = S(e);
+}, W = 864e5, G = (e) => typeof e == "number" ? e : Date.parse(e), K = (e, t) => {
+	let n = C(e);
 	if (n.enabled === !1) return {
 		shape: "constantOff",
 		reason: "enabled: false — resolves false for every caller"
 	};
 	if (n.schedule) {
 		let { activateAt: e, deactivateAt: r } = n.schedule;
-		if (r != null && t >= W(r)) return {
+		if (r != null && t >= G(r)) return {
 			shape: "expired",
 			reason: `schedule.deactivateAt (${String(r)}) has passed — the flag can never be on again`
 		};
-		if (e != null && t < W(e)) return {
+		if (e != null && t < G(e)) return {
 			shape: "notYetActive",
 			reason: `schedule.activateAt (${String(e)}) is in the future — pending, not dead`
 		};
@@ -277,7 +277,7 @@ var S = (e) => typeof e == "boolean" ? { enabled: e } : e, C = (e, t) => {
 		shape: "constantOff",
 		reason: `rollout: ${r} — nobody is in the rollout`
 	};
-	let i = (n.targeting?.length ?? 0) > 0, a = (n.variants?.length ?? 0) > 1, o = n.schedule !== void 0 && (n.schedule.ramp !== void 0 || n.schedule.deactivateAt != null && t < W(n.schedule.deactivateAt));
+	let i = (n.targeting?.length ?? 0) > 0, a = (n.variants?.length ?? 0) > 1, o = n.schedule !== void 0 && (n.schedule.ramp !== void 0 || n.schedule.deactivateAt != null && t < G(n.schedule.deactivateAt));
 	return r >= 100 && !i && !a && !o ? {
 		shape: "constantOn",
 		reason: "rollout 100 with no targeting, no variants and no live schedule — resolves true for every caller"
@@ -290,14 +290,14 @@ var S = (e) => typeof e == "boolean" ? { enabled: e } : e, C = (e, t) => {
 			o ? "a live schedule" : void 0
 		].filter((e) => e !== void 0).join(", ")})`
 	};
-}, K = [
+}, ce = [
 	"Reachability is not decided. \"Not evaluated since <date>\" is a measurement; \"this code path is dead\" is not decidable in general. A seasonal flag, a flag behind a route nobody visited this month, and a flag whose last call site was deleted are indistinguishable from here.",
 	"Only SERVER-side reads are counted as use: isFlagEnabled / requireFlag / flagValue and a gatedBy interception. A flag consulted only in the browser via useFlag() / useFlagValue() reads from the bulk set the server already sent, so it never reaches this report as a named read.",
 	"A \"bulk\" observation means the flag was INCLUDED in a flags.evaluate / flags.variants response. It does not mean any client read that key — one useFlags() poll evaluates the whole registry.",
 	"The window is bounded by retention (see coverage.retentionDays). Nothing older is evidence: a flag last read BEFORE the window has no observation at all and reads \"neverObserved\", which is exactly what a flag declared this morning reads.",
 	"\"neverObserved\" is not a removal candidate. A flag declared yesterday and a flag abandoned last year produce the identical row; only a flag that WAS observed and then stopped (\"stale\") is proven unused."
-], ce = (e) => {
-	let t = e.now ?? Date.now(), n = e.staleAfterDays, r = t - n * U, i = /* @__PURE__ */ new Map(), a = /* @__PURE__ */ new Map(), o;
+], le = (e) => {
+	let t = e.now ?? Date.now(), n = e.staleAfterDays, r = t - n * W, i = /* @__PURE__ */ new Map(), a = /* @__PURE__ */ new Map(), o;
 	for (let t of e.usage) {
 		let e = t.lastAt.getTime();
 		if (!Number.isFinite(e)) continue;
@@ -305,7 +305,7 @@ var S = (e) => typeof e == "boolean" ? { enabled: e } : e, C = (e, t) => {
 		let n = t.source === "bulk" ? a : i, r = n.get(t.flag);
 		(r === void 0 || e > r) && n.set(t.flag, e);
 	}
-	let s = o === void 0 ? 0 : Math.floor((t - o) / U);
+	let s = o === void 0 ? 0 : Math.floor((t - o) / W);
 	return {
 		coverage: {
 			tracking: e.tracking,
@@ -315,7 +315,7 @@ var S = (e) => typeof e == "boolean" ? { enabled: e } : e, C = (e, t) => {
 			staleAfterDays: n
 		},
 		findings: Object.entries(e.flags).map(([o, c]) => {
-			let { shape: l, reason: u } = G(c, t), d = i.get(o), f = a.get(o), p = [u], m;
+			let { shape: l, reason: u } = K(c, t), d = i.get(o), f = a.get(o), p = [u], m;
 			e.tracking ? d !== void 0 && d >= r ? (m = "evaluated", p.push(`last server-side read ${new Date(d).toISOString()}`)) : d === void 0 ? (m = "neverObserved", p.push(s > 0 ? `no server-side read in the ${s}-day observation window` : "no server-side read observed yet (the observation window is empty)"), f !== void 0 && p.push("the flag WAS delivered to a client in a bulk flags.evaluate response — which does not prove it was read")) : (m = "stale", p.push(`last server-side read ${new Date(d).toISOString()}, more than ${n} day(s) ago, over an observation window of ${s} day(s)`)) : (m = "untracked", p.push("evaluation tracking is off — no usage evidence exists for this deployment"));
 			let h = l === "constantOn" || l === "constantOff" || l === "expired";
 			return h && p.push("the definition alone makes this flag a constant — it selects nothing"), {
@@ -330,23 +330,23 @@ var S = (e) => typeof e == "boolean" ? { enabled: e } : e, C = (e, t) => {
 				why: p
 			};
 		}),
-		limits: K
+		limits: ce
 	};
-}, q = "_voltro_feature_flag_usage", J = y(q, {
-	id: p({ prefix: "flagusg" }),
-	flag: b(),
-	day: b(),
-	source: b(),
-	lastAt: x()
+}, q = "_voltro_feature_flag_usage", J = b(q, {
+	id: m({ prefix: "flagusg" }),
+	flag: x(),
+	day: x(),
+	source: x(),
+	lastAt: S()
 }).unique([
 	"flag",
 	"day",
 	"source"
-]).index("byFlagUsageLastAt", ["lastAt"]).index("byFlagUsageFlag", ["flag"]), le = (e) => e.toISOString().slice(0, 10), ue = (e) => {
+]).index("byFlagUsageLastAt", ["lastAt"]).index("byFlagUsageFlag", ["flag"]), ue = (e) => e.toISOString().slice(0, 10), de = (e) => {
 	let t = 2166136261;
 	for (let n = 0; n < e.length; n++) t ^= e.charCodeAt(n), t = Math.imul(t, 16777619);
 	return (t >>> 0).toString(16).padStart(8, "0");
-}, de = (e, t, n) => `flagusg_${t.replace(/-/g, "")}_${n === "targeted" ? "t" : "b"}_${ue(e)}`, Y = new class {
+}, fe = (e, t, n) => `flagusg_${t.replace(/-/g, "")}_${n === "targeted" ? "t" : "b"}_${de(e)}`, Y = new class {
 	on = !1;
 	pending = /* @__PURE__ */ new Map();
 	liveCounts = /* @__PURE__ */ new Map();
@@ -384,12 +384,12 @@ var S = (e) => typeof e == "boolean" ? { enabled: e } : e, C = (e, t) => {
 	reset() {
 		this.on = !1, this.pending.clear(), this.liveCounts.clear();
 	}
-}(), X = (e, t, n) => Y.record(e, t, n), fe = (e) => e === "bulk" ? "bulk" : "targeted", pe = (e) => ({
+}(), X = (e, t, n) => Y.record(e, t, n), pe = (e) => e === "bulk" ? "bulk" : "targeted", me = (e) => ({
 	upsertMany: async (t) => {
 		for (let n of t) {
-			let t = le(n.lastAt);
+			let t = ue(n.lastAt);
 			await e.upsert(q, {
-				id: de(n.flag, t, n.source),
+				id: fe(n.flag, t, n.source),
 				flag: n.flag,
 				day: t,
 				source: n.source,
@@ -401,13 +401,13 @@ var S = (e) => typeof e == "boolean" ? { enabled: e } : e, C = (e, t) => {
 			] });
 		}
 	},
-	load: async () => (await e.query(g(J).descriptor)).map((e) => ({
+	load: async () => (await e.query(_(J).descriptor)).map((e) => ({
 		flag: String(e.flag),
 		day: String(e.day),
-		source: fe(e.source),
+		source: pe(e.source),
 		lastAt: e.lastAt instanceof Date ? e.lastAt : new Date(String(e.lastAt))
 	}))
-}), me = 3e5, he = (e) => {
+}), he = 3e5, ge = (e) => {
 	let t = e.intervalMs ?? 3e5, n = !1, r = async () => {
 		let t = Y.drain();
 		if (t.length !== 0) try {
@@ -431,9 +431,9 @@ var S = (e) => typeof e == "boolean" ? { enabled: e } : e, C = (e, t) => {
 			n || (n = !0, clearInterval(i), await r());
 		}
 	};
-}, ge = (e = process.env, t = 90) => {
-	let n = v(e.VOLTRO_FLAG_USAGE_TTL_HOURS, 24 * t);
-	return _({
+}, _e = (e = process.env, t = 90) => {
+	let n = y(e.VOLTRO_FLAG_USAGE_TTL_HOURS, 24 * t);
+	return v({
 		table: q,
 		timeColumn: "lastAt",
 		source: "plugin",
@@ -441,88 +441,88 @@ var S = (e) => typeof e == "boolean" ? { enabled: e } : e, C = (e, t) => {
 		envVar: "VOLTRO_FLAG_USAGE_TTL_HOURS"
 	}), n;
 }, Z = (e) => "request" in e && e.request?.subject || "subject" in e && e.subject || {}, Q = (e, t) => {
-	let n = L.get(t);
-	return X(t, "targeted"), n !== void 0 && k(t, n, Z(e));
-}, _e = (e, t) => Q(e, t) ? c.void : c.fail(new s({ flag: t })), ve = (e, t) => {
-	let n = L.get(t.key);
-	return X(t.key, "targeted"), n === void 0 ? t.defaultValue : r(t, j(t.key, n, Z(e)));
-}, ye = (e, t) => {
-	let n = L.get(t.key);
-	return X(t.key, "targeted"), n === void 0 ? null : j(t.key, n, Z(e)).name;
-}, be = (e, t) => e === t || e.startsWith("/") && e.endsWith("/") && new RegExp(e.slice(1, -1)).test(t), $ = "@voltro/plugin-flags", xe = (r = {}) => {
-	let a = r.gatedBy ?? {}, o = u({
+	let n = R.get(t);
+	return X(t, "targeted"), n !== void 0 && A(t, n, Z(e));
+}, ve = (e, t) => Q(e, t) ? l.void : l.fail(new c({ flag: t })), ye = (e, t) => {
+	let n = R.get(t.key);
+	return X(t.key, "targeted"), n === void 0 ? t.defaultValue : i(t, N(t.key, n, Z(e)));
+}, be = (e, t) => {
+	let n = R.get(t.key);
+	return X(t.key, "targeted"), n === void 0 ? null : N(t.key, n, Z(e)).name;
+}, xe = (e, t) => e === t || e.startsWith("/") && e.endsWith("/") && new RegExp(e.slice(1, -1)).test(t), $ = e, Se = (e = {}) => {
+	let i = e.gatedBy ?? {}, o = d({
 		base: $,
-		alias: r.alias,
-		instance: r.name
-	}), d = r.typedFlags ?? [], f = /* @__PURE__ */ new Map();
-	for (let e of d) {
-		if (f.has(e.key)) throw Error(`${$}: two typedFlags declare the key ${JSON.stringify(e.key)}`);
-		if (r.flags?.[e.key] !== void 0) throw Error(`${$}: ${JSON.stringify(e.key)} is declared BOTH in \`flags\` and in \`typedFlags\`. One key, one declaration — the typed one would otherwise be silently overwritten by the untyped baseline.`);
-		f.set(e.key, e);
+		alias: e.alias,
+		instance: e.name
+	}), s = e.typedFlags ?? [], f = /* @__PURE__ */ new Map();
+	for (let t of s) {
+		if (f.has(t.key)) throw Error(`${$}: two typedFlags declare the key ${JSON.stringify(t.key)}`);
+		if (e.flags?.[t.key] !== void 0) throw Error(`${$}: ${JSON.stringify(t.key)} is declared BOTH in \`flags\` and in \`typedFlags\`. One key, one declaration — the typed one would otherwise be silently overwritten by the untyped baseline.`);
+		f.set(t.key, t);
 	}
-	d.some((e) => e.experiment !== void 0) && H(d, r.experiments ?? []);
-	let p = { ...r.flags ?? {} };
-	for (let e of d) p[e.key] = e.definition;
-	let m = r.store === "postgres", h, g, _, v, y = [], b = r.usage ?? {}, x = b.track ?? m;
+	s.some((e) => e.experiment !== void 0) && U(s, e.experiments ?? []);
+	let p = { ...e.flags ?? {} };
+	for (let e of s) p[e.key] = e.definition;
+	let m = e.store === "postgres", h, g, _, v, y = [], b = e.usage ?? {}, x = b.track ?? m;
 	if (x && !m) throw Error(`${$}: usage.track requires store: 'postgres' — there is nowhere to record an evaluation on the memory tier, and a dead-flag report that silently observed nothing is exactly the defect it exists to find.`);
 	let S = b.staleAfterDays ?? 30, C = b.retentionDays ?? 90;
 	if (S > C) throw Error(`${$}: usage.staleAfterDays (${S}) exceeds usage.retentionDays (${C}), so the observation window can never be long enough to prove a flag stale and every verdict would be withheld.`);
-	let ee = (e) => {
-		let t = I(p, e), n = [];
+	let w = (e) => {
+		let t = re(p, e), n = [];
 		for (let [e, r] of f) {
-			let a = t[e];
-			if (a === void 0) continue;
-			let o = i(r, typeof a == "boolean" ? { enabled: a } : a);
+			let i = t[e];
+			if (i === void 0) continue;
+			let o = a(r, typeof i == "boolean" ? { enabled: i } : i);
 			o.ok || (n.push(o.refusal), t[e] = r.definition);
 		}
-		y = n, L.set(t);
-	}, w = async () => {
-		h && ee(await h.loadOverrides());
-	}, T = (e) => {
-		if (a[e] !== void 0) return a[e];
-		for (let [t, n] of Object.entries(a)) if (t !== e && be(t, e)) return n;
+		y = n, R.set(t);
+	}, T = async () => {
+		h && w(await h.loadOverrides());
+	}, ee = (e) => {
+		if (i[e] !== void 0) return i[e];
+		for (let [t, n] of Object.entries(i)) if (t !== e && xe(t, e)) return n;
 	}, E = (e, t) => {
-		let n = T(t.tag);
-		return n === void 0 || Q({ subject: t.subject }, n) ? e : c.fail(new s({ flag: n }));
-	}, D = Object.keys(a).length > 0, O = (e) => {
+		let n = ee(t.tag);
+		return n === void 0 || Q({ subject: t.subject }, n) ? e : l.fail(new c({ flag: n }));
+	}, D = Object.keys(i).length > 0, O = (e) => {
 		for (let t of e) X(t, "bulk");
 	}, k = {
-		...e,
+		...t,
 		description: "Resolve every feature flag for the calling subject.",
-		execute: (e, t) => c.sync(() => {
-			let e = L.all();
-			return O(Object.keys(e)), ne(e, t.request.subject ?? {});
+		execute: (e, t) => l.sync(() => {
+			let e = R.all();
+			return O(Object.keys(e)), te(e, t.request.subject ?? {});
 		})
-	}, te = {
-		...t,
+	}, A = {
+		...n,
 		description: "Resolve every feature flag to its served variant for the calling subject.",
-		execute: (e, t) => c.sync(() => {
-			let e = L.all();
-			return O(Object.keys(e)), re(e, t.request.subject ?? {});
+		execute: (e, t) => l.sync(() => {
+			let e = R.all();
+			return O(Object.keys(e)), ne(e, t.request.subject ?? {});
 		})
-	}, A = (e) => ({
+	}, j = (e) => ({
 		kind: "json",
 		data: e
-	}), j = (e, t) => ({
+	}), M = (e, t) => ({
 		kind: "json",
 		status: e,
 		data: { error: t }
-	}), M = async () => {
+	}), N = async () => {
 		let e = [];
 		if (x && _) try {
 			e = await _.load();
 		} catch {
 			e = [];
 		}
-		return ce({
-			flags: L.all(),
+		return le({
+			flags: R.all(),
 			usage: e,
 			tracking: x,
 			liveCounts: Y.liveTargetedCounts(),
 			staleAfterDays: S,
 			retentionDays: C
 		});
-	}, N = () => {
+	}, P = () => {
 		let e = {};
 		for (let [t, n] of f) e[t] = {
 			valueType: n.valueType,
@@ -530,17 +530,17 @@ var S = (e) => typeof e == "boolean" ? { enabled: e } : e, C = (e, t) => {
 			experiment: n.experiment ?? null
 		};
 		return e;
-	}, R = [
+	}, F = [
 		{
 			method: "GET",
 			path: "/list",
 			description: "Every resolved flag (key, enabled, rollout, description) plus the dead-flag lifecycle report: per-flag shape + usage verdict, the observation coverage window, and the limits of what the report can prove.",
-			handler: () => c.promise(async () => {
-				let e = await M();
-				return A({
-					flags: B(L.all()),
+			handler: () => l.promise(async () => {
+				let e = await N();
+				return j({
+					flags: V(R.all()),
 					lifecycle: e,
-					typed: N(),
+					typed: P(),
 					overrideRefusals: y
 				});
 			})
@@ -549,26 +549,26 @@ var S = (e) => typeof e == "boolean" ? { enabled: e } : e, C = (e, t) => {
 			method: "POST",
 			path: "/toggle",
 			description: "Flip a flag's kill-switch on/off (live registry; durable on the postgres tier). Logs an audit row.",
-			handler: (e) => c.gen(function* () {
+			handler: (e) => l.gen(function* () {
 				let t;
 				try {
 					t = JSON.parse(e.body || "{}");
 				} catch {
-					return j(400, "invalid JSON body");
+					return M(400, "invalid JSON body");
 				}
-				if (!t.key || typeof t.enabled != "boolean") return j(400, "key (string) + enabled (boolean) required");
-				let n = z(t.key, t.enabled);
-				if (n === null) return j(404, `unknown flag "${t.key}"`);
-				let r = h ? L.get(t.key) : void 0;
-				return h && r !== void 0 && (yield* c.promise(() => h.upsertOverride(ie(t.key, r)))), g && (yield* c.promise(() => g.record({
+				if (!t.key || typeof t.enabled != "boolean") return M(400, "key (string) + enabled (boolean) required");
+				let n = B(t.key, t.enabled);
+				if (n === null) return M(404, `unknown flag "${t.key}"`);
+				let r = h ? R.get(t.key) : void 0;
+				return h && r !== void 0 && (yield* l.promise(() => h.upsertOverride(ie(t.key, r)))), g && (yield* l.promise(() => g.record({
 					flag: t.key,
 					enabled: t.enabled,
 					previousEnabled: n,
 					actorId: typeof t.actor == "string" ? t.actor : null,
 					at: /* @__PURE__ */ new Date()
-				}))), A({
+				}))), j({
 					ok: !0,
-					flags: B(L.all())
+					flags: V(R.all())
 				});
 			})
 		},
@@ -576,16 +576,16 @@ var S = (e) => typeof e == "boolean" ? { enabled: e } : e, C = (e, t) => {
 			method: "GET",
 			path: "/audit",
 			description: "The kill-switch flip audit trail, newest-first. `?flag=<key>` filters; `?limit=<n>` caps (postgres tier only).",
-			handler: (e) => c.gen(function* () {
-				if (!g) return A({
+			handler: (e) => l.gen(function* () {
+				if (!g) return j({
 					audit: [],
 					note: "audit trail requires store: \"postgres\""
 				});
-				let t = new URL(e.url, "http://local"), n = t.searchParams.get("flag"), r = t.searchParams.get("limit"), i = r != null && Number.isFinite(Number(r)) ? Number(r) : 100, a = yield* c.promise(() => g.list({
+				let t = new URL(e.url, "http://local"), n = t.searchParams.get("flag"), r = t.searchParams.get("limit"), i = r != null && Number.isFinite(Number(r)) ? Number(r) : 100, a = yield* l.promise(() => g.list({
 					...n == null ? {} : { flag: n },
 					limit: i
 				}));
-				return A({ audit: a.map((e) => ({
+				return j({ audit: a.map((e) => ({
 					flag: e.flag,
 					enabled: e.enabled,
 					previousEnabled: e.previousEnabled,
@@ -594,7 +594,7 @@ var S = (e) => typeof e == "boolean" ? { enabled: e } : e, C = (e, t) => {
 				})) });
 			})
 		}
-	], oe = [
+	], z = [
 		...D ? [
 			"rpc:intercept:mutation",
 			"rpc:intercept:query",
@@ -604,16 +604,16 @@ var S = (e) => typeof e == "boolean" ? { enabled: e } : e, C = (e, t) => {
 		"inspect:read",
 		"inspect:write"
 	];
-	return l({
+	return u({
 		name: o,
 		baseName: $,
 		description: "Feature flags — targeting, % rollout, kill-switch, declarative gating + client evaluation.",
-		permissions: oe,
-		routes: [k, te],
-		rpcClientDescriptors: n,
-		inspectEndpoints: R,
+		permissions: z,
+		routes: [k, A],
+		rpcClientDescriptors: r,
+		inspectEndpoints: F,
 		errorSchemas: [{
-			schema: s,
+			schema: c,
 			import: {
 				module: "@voltro/plugin-flags/errors",
 				name: "FlagDisabled"
@@ -625,38 +625,38 @@ var S = (e) => typeof e == "boolean" ? { enabled: e } : e, C = (e, t) => {
 			interceptAction: E
 		} : {},
 		...m ? { extendSchema: { tables: x ? [
-			P,
-			F,
+			I,
+			L,
 			J
-		] : [P, F] } } : {},
+		] : [I, L] } } : {},
 		...m ? { bindDataStore: (e) => {
-			h = ae(e), g = se(e), x && (_ = pe(e));
+			h = ae(e), g = se(e), x && (_ = me(e));
 		} } : {},
-		...m ? { onChangeEvent: (e) => e.table === "_voltro_feature_flags" ? c.tryPromise(() => w()) : c.void } : {},
-		onActivate: (e) => c.gen(function* () {
-			L.set(p), m && h && (yield* c.promise(w));
-			let t;
-			x && _ && (t = ge(process.env, C), Y.enable(), v = he({
+		...m ? { onChangeEvent: (e) => e.table === "_voltro_feature_flags" ? l.tryPromise(() => T()) : l.void } : {},
+		onActivate: (t) => l.gen(function* () {
+			R.set(p), m && h && (yield* l.promise(T));
+			let n;
+			x && _ && (n = _e(process.env, C), Y.enable(), v = ge({
 				store: _,
 				intervalMs: b.flushIntervalMs ?? 3e5,
-				log: { warn: (t, n) => e.logger.warn(t, n) }
+				log: { warn: (e, n) => t.logger.warn(e, n) }
 			}));
-			for (let t of y) e.logger.warn("feature flag override REFUSED — the code-declared definition stands", {
-				flag: t.key,
-				reason: t.reason
+			for (let e of y) t.logger.warn("feature flag override REFUSED — the code-declared definition stands", {
+				flag: e.key,
+				reason: e.reason
 			});
-			e.logger.info("feature flags active", {
+			t.logger.info("feature flags active", {
 				count: Object.keys(p).length,
 				typed: f.size,
-				gated: Object.keys(a).length,
-				store: r.store ?? "memory",
-				usage: x ? `tracking (stale after ${S}d, observations kept ${Math.round((t ?? 0) / 864e5)}d)` : "off — no dead-flag evidence is collected"
+				gated: Object.keys(i).length,
+				store: e.store ?? "memory",
+				usage: x ? `tracking (stale after ${S}d, observations kept ${Math.round((n ?? 0) / 864e5)}d)` : "off — no dead-flag evidence is collected"
 			});
 		}),
-		onDeactivate: () => c.promise(async () => {
-			await v?.stop(), v = void 0, Y.disable(), L.set({});
+		onDeactivate: () => l.promise(async () => {
+			await v?.stop(), v = void 0, Y.disable(), R.set({});
 		})
 	});
 };
 //#endregion
-export { me as DEFAULT_FLAG_USAGE_FLUSH_MS, K as FLAG_LIFECYCLE_LIMITS, q as FLAG_USAGE_TABLE, s as FlagDisabled, H as assertFlagExperimentLinks, V as checkFlagExperimentLinks, G as classifyShape, pe as dataStoreFlagUsageStore, o as defineFlag, B as describeFlags, ne as evaluateAll, re as evaluateAllVariants, k as evaluateFlag, O as evaluateSchedule, j as evaluateVariant, P as featureFlagsTable, F as flagAuditTable, ce as flagLifecycleReport, L as flagRegistry, Y as flagUsageBuffer, de as flagUsageRowId, J as flagUsageTable, ve as flagValue, ye as flagVariant, xe as flagsPlugin, z as flipFlagEnabled, i as gateOverride, Q as isFlagEnabled, a as isTypedFlag, I as mergeOverrides, X as recordFlagEvaluation, ge as registerFlagUsageRetention, _e as requireFlag, A as resolveVariant, R as setFlagEnabled, he as startFlagUsageFlush, S as toDefinition, r as typedValueOf, le as utcDay };
+export { he as DEFAULT_FLAG_USAGE_FLUSH_MS, ce as FLAG_LIFECYCLE_LIMITS, q as FLAG_USAGE_TABLE, c as FlagDisabled, U as assertFlagExperimentLinks, H as checkFlagExperimentLinks, K as classifyShape, me as dataStoreFlagUsageStore, s as defineFlag, V as describeFlags, te as evaluateAll, ne as evaluateAllVariants, A as evaluateFlag, k as evaluateSchedule, N as evaluateVariant, I as featureFlagsTable, L as flagAuditTable, le as flagLifecycleReport, R as flagRegistry, Y as flagUsageBuffer, fe as flagUsageRowId, J as flagUsageTable, ye as flagValue, be as flagVariant, Se as flagsPlugin, B as flipFlagEnabled, a as gateOverride, Q as isFlagEnabled, o as isTypedFlag, re as mergeOverrides, X as recordFlagEvaluation, _e as registerFlagUsageRetention, ve as requireFlag, M as resolveVariant, z as setFlagEnabled, ge as startFlagUsageFlush, C as toDefinition, i as typedValueOf, ue as utcDay };