@voltro/plugin-flags 0.83.1 → 0.85.0

package/dist/index.js

@@ -1,25 +1,25 @@
 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 { i, n as a, r as o, t as s } from "./define-BHpLJh1F.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, eq as m, id as h, integer as g, json as _, queryFor as v, registerRetention as y, retentionTtlMsFromEnv as b, table as x, text as S, timestamp as C } from "@voltro/database";
+import { Effect as l, Result as u } from "effect";
+import { definePlugin as d, pluginInstanceName as f } from "@voltro/protocol";
+import { boolean as p, derivedRowId as m, eq as h, id as g, integer as _, json as v, queryFor as y, registerRetention as b, retentionTtlMsFromEnv as x, table as S, text as C, timestamp as w } from "@voltro/database";
 //#region src/evaluate.ts
-var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (e, t) => {
+var T = (e) => typeof e == "boolean" ? { enabled: e } : e, E = (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;
-}, E = (e, t) => T(e, t) % 100, ee = (e, t) => T(`${e}:variant`, t) % 1e4, D = (e, t) => {
+}, D = (e, t) => E(e, t) % 100, O = (e, t) => E(`${e}:variant`, t) % 1e4, k = (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;
-}, O = (e) => typeof e == "number" ? e : Date.parse(e), k = (e, t) => (e.rolloutBy === "tenant" ? t.tenantId : t.id) ?? "anon", A = (e, t) => {
-	if (e.activateAt != null && t < O(e.activateAt) || e.deactivateAt != null && t >= O(e.deactivateAt)) return { active: !1 };
+}, A = (e) => typeof e == "number" ? e : Date.parse(e), j = (e, t) => (e.rolloutBy === "tenant" ? t.tenantId : t.id) ?? "anon", M = (e, t) => {
+	if (e.activateAt != null && t < A(e.activateAt) || e.deactivateAt != null && t >= A(e.deactivateAt)) return { active: !1 };
 	if (e.ramp) {
-		let { from: n, to: r, startAt: i, endAt: a } = e.ramp, o = O(i), s = O(a);
+		let { from: n, to: r, startAt: i, endAt: a } = e.ramp, o = A(i), s = A(a);
 		if (t <= o) return {
 			active: !0,
 			rollout: n
@@ -35,71 +35,73 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (e, t) => {
 		};
 	}
 	return { active: !0 };
-}, j = (e, t, n, r = Date.now()) => {
-	let i = w(t);
-	if (i.enabled === !1) return !1;
-	let a;
-	if (i.schedule) {
-		let e = A(i.schedule, r);
+}, N = (e, t, n, r = Date.now()) => {
+	let i = T(t);
+	return P(e, i, n, r) ? !i.variants?.length || i.offVariant == null || I(e, i, n).name !== i.offVariant : !1;
+}, P = (e, t, n, r) => {
+	if (t.enabled === !1) return !1;
+	let i;
+	if (t.schedule) {
+		let e = M(t.schedule, r);
 		if (!e.active) return !1;
-		a = e.rollout;
+		i = e.rollout;
 	}
-	if (i.targeting && i.targeting.length > 0 && !i.targeting.some((e) => D(e, n))) return !1;
-	let o = a ?? i.rollout ?? 100;
-	if (o < 100 && o > 0) {
-		if (!(E(e, k(i, n)) < o)) return !1;
-	} else if (o <= 0) return !1;
-	return i.variants && i.variants.length > 0 && i.offVariant != null ? N(e, i, n).name !== i.offVariant : !0;
-}, M = (e) => {
+	if (t.targeting && t.targeting.length > 0 && !t.targeting.some((e) => k(e, n))) return !1;
+	let a = i ?? t.rollout ?? 100;
+	if (a < 100 && a > 0) {
+		if (!(D(e, j(t, n)) < a)) return !1;
+	} else if (a <= 0) return !1;
+	return !0;
+}, F = (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)));
-}, N = (e, t, n) => {
+}, I = (e, t, n) => {
 	let r = t.variants ?? [];
 	if (r.length === 0) throw Error(`flag "${e}" has no variants`);
-	let i = ee(e, k(t, n)), a = M(r);
+	let i = O(e, j(t, n)), a = F(r);
 	for (let e = 0; e < r.length; e++) if (i < a[e]) return r[e];
 	return r[r.length - 1];
-}, P = (e, t, n, r = Date.now()) => {
-	let i = w(t), a = j(e, t, n, r);
+}, L = (e, t, n, r = Date.now()) => {
+	let i = T(t), a = P(e, i, n, r);
 	if (!i.variants || i.variants.length === 0) return {
 		name: a ? "on" : "off",
 		value: a,
 		enabled: a
 	};
-	let o = N(e, i, n);
+	let o = I(e, i, n);
 	return {
 		name: o.name,
 		value: o.value,
-		enabled: a
+		enabled: a && o.name !== i.offVariant
 	};
-}, te = (e, t, n = Date.now()) => {
+}, ee = (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;
-}, ne = (e, t, n = Date.now()) => {
+}, te = (e, t, n = Date.now()) => {
 	let r = {};
-	for (let [i, a] of Object.entries(e)) r[i] = P(i, a, t, n);
+	for (let [i, a] of Object.entries(e)) r[i] = L(i, a, t, n);
 	return r;
-}, F = "_voltro_feature_flag_audit", I = "_voltro_feature_flags", L = x(I, {
-	id: h({ prefix: "flag" }),
-	key: S().unique(),
-	enabled: f().default(!0),
-	rollout: g().nullable(),
-	rolloutBy: S().nullable(),
-	targeting: _().nullable(),
-	variants: _().nullable(),
-	offVariant: S().nullable(),
-	schedule: _().nullable(),
-	description: S().nullable(),
-	updatedAt: C().default("now").onUpdate("now")
-}), R = x(F, {
-	id: h({ prefix: "flagaud" }),
-	flag: S(),
-	enabled: f(),
-	previousEnabled: f().nullable(),
-	actorId: S().nullable(),
-	at: C().default("now")
-}).index("byFlagAuditFlag", ["flag"]).index("byFlagAuditAt", ["at"]), re = (e, t) => {
+}, R = "_voltro_feature_flag_audit", z = "_voltro_feature_flags", B = S(z, {
+	id: g({ prefix: "flag" }),
+	key: C().unique(),
+	enabled: p().default(!0),
+	rollout: _().nullable(),
+	rolloutBy: C().nullable(),
+	targeting: v().nullable(),
+	variants: v().nullable(),
+	offVariant: C().nullable(),
+	schedule: v().nullable(),
+	description: C().nullable(),
+	updatedAt: w().default("now").onUpdate("now")
+}), V = S(R, {
+	id: g({ prefix: "flagaud" }),
+	flag: C(),
+	enabled: p(),
+	previousEnabled: p().nullable(),
+	actorId: C().nullable(),
+	at: w().default("now")
+}).index("byFlagAuditFlag", ["flag"]).index("byFlagAuditAt", ["at"]), ne = (e, t) => {
 	let n = { ...e };
 	for (let e of t) {
 		let t = {
@@ -115,7 +117,7 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (e, t) => {
 		n[e.key] = t;
 	}
 	return n;
-}, z = new class {
+}, H = new class {
 	flags = {};
 	set(e) {
 		this.flags = e;
@@ -126,19 +128,19 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (e, t) => {
 	get(e) {
 		return this.flags[e];
 	}
-}(), B = (e, t) => V(e, t) !== null, V = (e, t) => {
-	let n = z.get(e);
+}(), re = (e, t) => U(e, t) !== null, U = (e, t) => {
+	let n = H.get(e);
 	if (n === void 0) return null;
-	let r = w(n), i = r.enabled !== !1;
-	return z.set({
-		...z.all(),
+	let r = T(n), i = r.enabled !== !1;
+	return H.set({
+		...H.all(),
 		[e]: {
 			...r,
 			enabled: t
 		}
 	}), i;
-}, H = (e) => Object.entries(e).map(([e, t]) => {
-	let n = w(t);
+}, W = (e) => Object.entries(e).map(([e, t]) => {
+	let n = T(t);
 	return {
 		key: e,
 		enabled: n.enabled !== !1,
@@ -148,7 +150,7 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (e, t) => {
 		description: n.description
 	};
 }), ie = (e, t) => {
-	let n = w(t);
+	let n = T(t);
 	return {
 		key: e,
 		enabled: n.enabled !== !1,
@@ -161,7 +163,7 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (e, t) => {
 		description: n.description ?? null
 	};
 }, ae = (e) => ({
-	loadOverrides: async () => (await e.query(v(L).descriptor)).map((e) => ({
+	loadOverrides: async () => (await e.query(y(B).descriptor)).map((e) => ({
 		key: String(e.key),
 		enabled: e.enabled === !0 || e.enabled === 1,
 		rollout: e.rollout == null ? null : Number(e.rollout),
@@ -173,11 +175,11 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (e, t) => {
 		description: e.description ?? null
 	})),
 	upsertOverride: async (t) => {
-		let n = U(t);
-		await e.upsert(I, n, { conflictColumns: ["key"] });
+		let n = G(t);
+		await e.upsert(z, n, { conflictColumns: ["key"] });
 	}
-}), U = (e) => ({
-	id: p("flag", e.key),
+}), G = (e) => ({
+	id: m("flag", e.key),
 	key: e.key,
 	enabled: e.enabled,
 	rollout: e.rollout,
@@ -196,7 +198,7 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (e, t) => {
 	at: e.at instanceof Date ? e.at : new Date(String(e.at))
 }), se = (e) => ({
 	record: async (t) => {
-		await e.insert(F, {
+		await e.insert(R, {
 			id: `flagaud_${t.at.getTime()}_${Math.random().toString(36).slice(2, 10)}`,
 			flag: t.flag,
 			enabled: t.enabled,
@@ -206,18 +208,18 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (e, t) => {
 		});
 	},
 	list: async (t) => {
-		let n = v(R).orderBy("at", "desc");
-		return t?.flag != null && (n = n.where(m("flag", t.flag))), t?.limit != null && (n = n.limit(t.limit)), (await e.query(n.descriptor)).map(oe);
+		let n = y(V).orderBy("at", "desc");
+		return t?.flag != null && (n = n.where(h("flag", t.flag))), t?.limit != null && (n = n.limit(t.limit)), (await e.query(n.descriptor)).map(oe);
 	}
 }), ce = async (e, t, n, r, i) => {
 	await e.transactional(async (e) => {
-		await e.insertIgnore(I, {
-			...U(ie(t, n)),
-			id: p("flag", crypto.randomUUID())
+		await e.insertIgnore(z, {
+			...G(ie(t, n)),
+			id: m("flag", crypto.randomUUID())
 		}, { conflictColumns: ["key"] });
-		let a = (await e.query(v(L).where(m("key", t)).forUpdate().descriptor))[0];
+		let a = (await e.query(y(B).where(h("key", t)).forUpdate().descriptor))[0];
 		if (!a) throw Error("flag override disappeared during toggle");
-		await e.update(I, String(a.id), {
+		await e.update(z, String(a.id), {
 			enabled: r,
 			updatedAt: /* @__PURE__ */ new Date()
 		}), await se(e).record({
@@ -228,7 +230,7 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (e, t) => {
 			at: /* @__PURE__ */ new Date()
 		});
 	});
-}, W = (e, t) => {
+}, le = (e, t) => {
 	let n = new Map(t.map((e) => [e.name, e])), r = [];
 	for (let t of e) {
 		let e = t.experiment;
@@ -267,24 +269,24 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (e, t) => {
 		}
 	}
 	return r;
-}, le = (e, t) => {
-	let n = W(e, t);
+}, ue = (e, t) => {
+	let n = le(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")}`);
-}, ue = 864e5, G = (e) => typeof e == "number" ? e : Date.parse(e), K = (e, t) => {
-	let n = w(e);
+}, de = 864e5, K = (e) => typeof e == "number" ? e : Date.parse(e), fe = (e, t) => {
+	let n = T(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 >= G(r)) return {
+		if (r != null && t >= K(r)) return {
 			shape: "expired",
 			reason: `schedule.deactivateAt (${String(r)}) has passed — the flag can never be on again`
 		};
-		if (e != null && t < G(e)) return {
+		if (e != null && t < K(e)) return {
 			shape: "notYetActive",
 			reason: `schedule.activateAt (${String(e)}) is in the future — pending, not dead`
 		};
@@ -294,7 +296,7 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (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 < G(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 < K(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"
@@ -307,14 +309,14 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (e, t) => {
 			o ? "a live schedule" : void 0
 		].filter((e) => e !== void 0).join(", ")})`
 	};
-}, de = [
+}, pe = [
 	"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."
-], fe = (e) => {
-	let t = e.now ?? Date.now(), n = e.staleAfterDays, r = t - n * ue, i = /* @__PURE__ */ new Map(), a = /* @__PURE__ */ new Map(), o;
+], me = (e) => {
+	let t = e.now ?? Date.now(), n = e.staleAfterDays, r = t - n * de, 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;
@@ -322,7 +324,7 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (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) / ue);
+	let s = o === void 0 ? 0 : Math.floor((t - o) / de);
 	return {
 		coverage: {
 			tracking: e.tracking,
@@ -332,7 +334,7 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (e, t) => {
 			staleAfterDays: n
 		},
 		findings: Object.entries(e.flags).map(([o, c]) => {
-			let { shape: l, reason: u } = K(c, t), d = i.get(o), f = a.get(o), p = [u], m;
+			let { shape: l, reason: u } = fe(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"), {
@@ -347,23 +349,23 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (e, t) => {
 				why: p
 			};
 		}),
-		limits: de
+		limits: pe
 	};
-}, q = "_voltro_feature_flag_usage", J = x(q, {
-	id: h({ prefix: "flagusg" }),
-	flag: S(),
-	day: S(),
-	source: S(),
-	lastAt: C()
+}, q = "_voltro_feature_flag_usage", J = S(q, {
+	id: g({ prefix: "flagusg" }),
+	flag: C(),
+	day: C(),
+	source: C(),
+	lastAt: w()
 }).unique([
 	"flag",
 	"day",
 	"source"
-]).index("byFlagUsageLastAt", ["lastAt"]).index("byFlagUsageFlag", ["flag"]), pe = (e) => e.toISOString().slice(0, 10), me = (e) => {
+]).index("byFlagUsageLastAt", ["lastAt"]).index("byFlagUsageFlag", ["flag"]), he = (e) => e.toISOString().slice(0, 10), ge = (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");
-}, he = (e, t, n) => `flagusg_${t.replace(/-/g, "")}_${n === "targeted" ? "t" : "b"}_${me(e)}`, Y = new class {
+}, _e = (e, t, n) => `flagusg_${t.replace(/-/g, "")}_${n === "targeted" ? "t" : "b"}_${ge(e)}`, Y = new class {
 	on = !1;
 	pending = /* @__PURE__ */ new Map();
 	liveCounts = /* @__PURE__ */ new Map();
@@ -401,12 +403,12 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (e, t) => {
 	reset() {
 		this.on = !1, this.pending.clear(), this.liveCounts.clear();
 	}
-}(), X = (e, t, n) => Y.record(e, t, n), ge = (e) => e === "bulk" ? "bulk" : "targeted", _e = (e) => ({
+}(), X = (e, t, n) => Y.record(e, t, n), ve = (e) => e === "bulk" ? "bulk" : "targeted", ye = (e) => ({
 	upsertMany: async (t) => {
 		for (let n of t) {
-			let t = pe(n.lastAt);
+			let t = he(n.lastAt);
 			await e.upsert(q, {
-				id: he(n.flag, t, n.source),
+				id: _e(n.flag, t, n.source),
 				flag: n.flag,
 				day: t,
 				source: n.source,
@@ -418,13 +420,13 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (e, t) => {
 			] });
 		}
 	},
-	load: async () => (await e.query(v(J).descriptor)).map((e) => ({
+	load: async () => (await e.query(y(J).descriptor)).map((e) => ({
 		flag: String(e.flag),
 		day: String(e.day),
-		source: ge(e.source),
+		source: ve(e.source),
 		lastAt: e.lastAt instanceof Date ? e.lastAt : new Date(String(e.lastAt))
 	}))
-}), ve = 3e5, ye = (e) => {
+}), be = 3e5, xe = (e) => {
 	let t = e.intervalMs ?? 3e5, n = !1, r = async () => {
 		let t = Y.drain();
 		if (t.length !== 0) try {
@@ -448,9 +450,9 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (e, t) => {
 			n || (n = !0, clearInterval(i), await r());
 		}
 	};
-}, be = (e = process.env, t = 90) => {
-	let n = b(e.VOLTRO_FLAG_USAGE_TTL_HOURS, 24 * t);
-	return y({
+}, Se = (e = process.env, t = 90) => {
+	let n = x(e.VOLTRO_FLAG_USAGE_TTL_HOURS, 24 * t);
+	return b({
 		table: q,
 		timeColumn: "lastAt",
 		source: "plugin",
@@ -458,127 +460,127 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (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 = z.get(t);
-	return X(t, "targeted"), n !== void 0 && j(t, n, Z(e));
-}, xe = (e, t) => Q(e, t) ? l.void : l.fail(new c({ flag: t })), Se = (e, t) => {
-	let n = z.get(t.key);
-	return X(t.key, "targeted"), n === void 0 ? t.defaultValue : i(t, P(t.key, n, Z(e)));
-}, Ce = (e, t) => {
-	let n = z.get(t.key);
-	return X(t.key, "targeted"), n === void 0 ? null : P(t.key, n, Z(e)).name;
-}, we = (e, t) => e === t || e.startsWith("/") && e.endsWith("/") && new RegExp(e.slice(1, -1)).test(t), $ = e, Te = (e = {}) => {
-	let i = e.gatedBy ?? {}, o = d({
+	let n = H.get(t);
+	return X(t, "targeted"), n !== void 0 && N(t, n, Z(e));
+}, Ce = (e, t) => Q(e, t) ? l.void : l.fail(new c({ flag: t })), we = (e, t) => {
+	let n = H.get(t.key);
+	return X(t.key, "targeted"), n === void 0 ? t.defaultValue : i(t, L(t.key, n, Z(e)));
+}, Te = (e, t) => {
+	let n = H.get(t.key);
+	return X(t.key, "targeted"), n === void 0 ? null : L(t.key, n, Z(e)).name;
+}, Ee = (e, t) => e === t || e.startsWith("/") && e.endsWith("/") && new RegExp(e.slice(1, -1)).test(t), $ = e, De = (e = {}) => {
+	let i = e.gatedBy ?? {}, o = f({
 		base: $,
 		alias: e.alias,
 		instance: e.name
-	}), s = e.typedFlags ?? [], f = /* @__PURE__ */ new Map();
+	}), s = e.typedFlags ?? [], p = /* @__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 (p.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);
+		p.set(t.key, t);
 	}
-	s.some((e) => e.experiment !== void 0) && le(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, x, S = [], C = e.usage ?? {}, w = C.track ?? m;
-	if (w && !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 T = C.staleAfterDays ?? 30, E = C.retentionDays ?? 90;
-	if (T > E) throw Error(`${$}: usage.staleAfterDays (${T}) exceeds usage.retentionDays (${E}), 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 = re(p, e), n = [];
-		for (let [e, r] of f) {
+	s.some((e) => e.experiment !== void 0) && ue(s, e.experiments ?? []);
+	let m = { ...e.flags ?? {} };
+	for (let e of s) m[e.key] = e.definition;
+	let h = e.store === "postgres", g, _, v, y, b, x, S, C = [], w = e.usage ?? {}, T = w.track ?? h;
+	if (T && !h) 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 E = w.staleAfterDays ?? 30, D = w.retentionDays ?? 90;
+	if (E > D) throw Error(`${$}: usage.staleAfterDays (${E}) exceeds usage.retentionDays (${D}), so the observation window can never be long enough to prove a flag stale and every verdict would be withheld.`);
+	let O = (e) => {
+		let t = ne(m, e), n = [];
+		for (let [e, r] of p) {
 			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);
 		}
-		S = n, z.set(t);
-	}, D = 0, O = async () => {
-		if (!g) return;
-		let e = ++D, t = await g.loadOverrides();
-		e === D && ee(t);
-	}, k = async () => {
-		if (b && g) {
-			if (await O(), w && v && !y) {
-				x = be(process.env, E), Y.enable();
-				let e = b.logger;
-				y = ye({
-					store: v,
-					intervalMs: C.flushIntervalMs ?? 3e5,
+		C = n, H.set(t);
+	}, k = 0, A = async () => {
+		if (!_) return;
+		let e = ++k, t = await _.loadOverrides();
+		e === k && O(t);
+	}, j = async () => {
+		if (x && _) {
+			if (await A(), T && y && !b) {
+				S = Se(process.env, D), Y.enable();
+				let e = x.logger;
+				b = xe({
+					store: y,
+					intervalMs: w.flushIntervalMs ?? 3e5,
 					log: { warn: (t, n) => e.warn(t, n) }
 				});
 			}
-			for (let e of S) b.logger.warn("feature flag override REFUSED — code-declared definition stands", {
+			for (let e of C) x.logger.warn("feature flag override REFUSED — code-declared definition stands", {
 				flag: e.key,
 				reason: e.reason
 			});
 		}
-	}, A = (e) => {
+	}, M = (e) => {
 		if (i[e] !== void 0) return i[e];
-		for (let [t, n] of Object.entries(i)) if (t !== e && we(t, e)) return n;
-	}, j = (e, t) => {
-		let n = A(t.tag);
+		for (let [t, n] of Object.entries(i)) if (t !== e && Ee(t, e)) return n;
+	}, N = (e, t) => {
+		let n = M(t.tag);
 		return n === void 0 || Q({ subject: t.subject }, n) ? e : l.fail(new c({ flag: n }));
-	}, M = Object.keys(i).length > 0, N = (e) => {
+	}, P = Object.keys(i).length > 0, F = (e) => {
 		for (let t of e) X(t, "bulk");
-	}, P = {
+	}, I = {
 		...t,
 		description: "Resolve every feature flag for the calling subject.",
 		execute: (e, t) => l.sync(() => {
-			let e = z.all();
-			return N(Object.keys(e)), te(e, t.request.subject ?? {});
+			let e = H.all();
+			return F(Object.keys(e)), ee(e, t.request.subject ?? {});
 		})
-	}, F = {
+	}, L = {
 		...n,
 		description: "Resolve every feature flag to its served variant for the calling subject.",
 		execute: (e, t) => l.sync(() => {
-			let e = z.all();
-			return N(Object.keys(e)), ne(e, t.request.subject ?? {});
+			let e = H.all();
+			return F(Object.keys(e)), te(e, t.request.subject ?? {});
 		})
-	}, I = (e) => ({
+	}, R = (e) => ({
 		kind: "json",
 		data: e
-	}), B = (e, t) => ({
+	}), z = (e, t) => ({
 		kind: "json",
 		status: e,
 		data: { error: t }
-	}), ie = async () => {
+	}), re = async () => {
 		let e = [];
-		if (w && v) try {
-			e = await v.load();
+		if (T && y) try {
+			e = await y.load();
 		} catch {
 			e = [];
 		}
-		return fe({
-			flags: z.all(),
+		return me({
+			flags: H.all(),
 			usage: e,
-			tracking: w,
+			tracking: T,
 			liveCounts: Y.liveTargetedCounts(),
-			staleAfterDays: T,
-			retentionDays: E
+			staleAfterDays: E,
+			retentionDays: D
 		});
-	}, U = () => {
+	}, ie = () => {
 		let e = {};
-		for (let [t, n] of f) e[t] = {
+		for (let [t, n] of p) e[t] = {
 			valueType: n.valueType,
 			variants: n.variants.map((e) => e.name),
 			experiment: n.experiment ?? null
 		};
 		return e;
-	}, oe = [
+	}, G = [
 		{
 			method: "GET",
 			path: "/list",
 			scope: "process",
 			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: () => l.promise(async () => {
-				let e = await ie();
-				return I({
-					flags: H(z.all()),
-					writeScope: m ? "shared-store" : "process",
+				let e = await re();
+				return R({
+					flags: W(H.all()),
+					writeScope: h ? "shared-store" : "process",
 					lifecycle: e,
-					typed: U(),
-					overrideRefusals: S
+					typed: ie(),
+					overrideRefusals: C
 				});
 			})
 		},
@@ -591,39 +593,40 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (e, t) => {
 				try {
 					t = JSON.parse(e.body || "{}");
 				} catch {
-					return B(400, "invalid JSON body");
+					return z(400, "invalid JSON body");
 				}
-				if (!t || typeof t.key != "string" || !t.key || typeof t.enabled != "boolean") return B(400, "key (string) + enabled (boolean) required");
-				let n = t.key, r = t.enabled, i = z.get(n);
-				if (i === void 0) return B(404, `unknown flag "${n}"`);
-				if (m) {
-					let e = h;
-					if (!e) return B(503, "flag store is not ready");
-					if ((yield* l.tryPromise(async () => {
-						await ce(e, n, i, r, typeof t.actor == "string" ? t.actor : null), await O();
-					}).pipe(l.either))._tag === "Left") return yield* l.tryPromise(O).pipe(l.ignore), B(503, "flag update could not be confirmed; reload the flag state before retrying");
-				} else V(n, r);
-				return I({
+				if (!t || typeof t.key != "string" || !t.key || typeof t.enabled != "boolean") return z(400, "key (string) + enabled (boolean) required");
+				let n = t.key, r = t.enabled, i = H.get(n);
+				if (i === void 0) return z(404, `unknown flag "${n}"`);
+				if (h) {
+					let e = g;
+					if (!e) return z(503, "flag store is not ready");
+					let a = yield* l.tryPromise(async () => {
+						await ce(e, n, i, r, typeof t.actor == "string" ? t.actor : null), await A();
+					}).pipe(l.result);
+					if (u.isFailure(a)) return yield* l.tryPromise(A).pipe(l.ignore), z(503, "flag update could not be confirmed; reload the flag state before retrying");
+				} else U(n, r);
+				return R({
 					ok: !0,
-					flags: H(z.all())
+					flags: W(H.all())
 				});
 			})
 		},
 		{
 			method: "GET",
 			path: "/audit",
-			scope: m ? "shared-store" : "declaration",
+			scope: h ? "shared-store" : "declaration",
 			description: "The kill-switch flip audit trail, newest-first. `?flag=<key>` filters; `?limit=<n>` caps (postgres tier only).",
 			handler: (e) => l.gen(function* () {
-				if (!_) return I({
+				if (!v) return R({
 					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* l.promise(() => _.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(() => v.list({
 					...n == null ? {} : { flag: n },
 					limit: i
 				}));
-				return I({ audit: a.map((e) => ({
+				return R({ audit: a.map((e) => ({
 					flag: e.flag,
 					enabled: e.enabled,
 					previousEnabled: e.previousEnabled,
@@ -632,25 +635,25 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (e, t) => {
 				})) });
 			})
 		}
-	], W = [
-		...M ? [
+	], oe = [
+		...P ? [
 			"rpc:intercept:mutation",
 			"rpc:intercept:query",
 			"rpc:intercept:action",
 			"rpc:intercept:workflow"
 		] : [],
-		...m ? ["store:write", "store:changes:read"] : [],
+		...h ? ["store:write", "store:changes:read"] : [],
 		"inspect:read",
 		"inspect:write"
 	];
-	return u({
+	return d({
 		name: o,
 		baseName: $,
 		description: "Feature flags — targeting, % rollout, kill-switch, declarative gating + client evaluation.",
-		permissions: W,
-		routes: [P, F],
+		permissions: oe,
+		routes: [I, L],
 		rpcClientDescriptors: r,
-		inspectEndpoints: oe,
+		inspectEndpoints: G,
 		errorSchemas: [{
 			schema: c,
 			import: {
@@ -658,34 +661,34 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (e, t) => {
 				name: "FlagDisabled"
 			}
 		}],
-		...M ? {
-			interceptMutation: j,
-			interceptQuery: j,
-			interceptAction: j,
-			interceptWorkflow: j
+		...P ? {
+			interceptMutation: N,
+			interceptQuery: N,
+			interceptAction: N,
+			interceptWorkflow: N
 		} : {},
-		...m ? { extendSchema: { tables: w ? [
-			L,
-			R,
+		...h ? { extendSchema: { tables: T ? [
+			B,
+			V,
 			J
-		] : [L, R] } } : {},
-		...m ? { bindDataStore: async (e) => {
-			h = e, g = ae(h), _ = se(e), w && (v = _e(e)), await k();
+		] : [B, V] } } : {},
+		...h ? { bindDataStore: async (e) => {
+			g = e, _ = ae(g), v = se(e), T && (y = ye(e)), await j();
 		} } : {},
-		...m ? { onChangeEvent: (e) => e.table === "_voltro_feature_flags" ? l.tryPromise(() => O()) : l.void } : {},
+		...h ? { onChangeEvent: (e) => e.table === "_voltro_feature_flags" ? l.tryPromise(() => A()) : l.void } : {},
 		onActivate: (t) => l.gen(function* () {
-			z.set(p), b = t, g && (yield* l.promise(k)), t.logger.info("feature flags active", {
-				count: Object.keys(p).length,
-				typed: f.size,
+			H.set(m), x = t, _ && (yield* l.promise(j)), t.logger.info("feature flags active", {
+				count: Object.keys(m).length,
+				typed: p.size,
 				gated: Object.keys(i).length,
 				store: e.store ?? "memory",
-				usage: w ? y ? `tracking (stale after ${T}d, observations kept ${Math.round((x ?? 0) / 864e5)}d)` : "waiting for store binding" : "off — no dead-flag evidence is collected"
+				usage: T ? b ? `tracking (stale after ${E}d, observations kept ${Math.round((S ?? 0) / 864e5)}d)` : "waiting for store binding" : "off — no dead-flag evidence is collected"
 			});
 		}),
 		onDeactivate: () => l.promise(async () => {
-			b = void 0, await y?.stop(), y = void 0, Y.disable(), z.set({});
+			x = void 0, await b?.stop(), b = void 0, Y.disable(), H.set({});
 		})
 	});
 };
 //#endregion
-export { ve as DEFAULT_FLAG_USAGE_FLUSH_MS, de as FLAG_LIFECYCLE_LIMITS, q as FLAG_USAGE_TABLE, c as FlagDisabled, le as assertFlagExperimentLinks, W as checkFlagExperimentLinks, K as classifyShape, _e as dataStoreFlagUsageStore, s as defineFlag, H as describeFlags, te as evaluateAll, ne as evaluateAllVariants, j as evaluateFlag, A as evaluateSchedule, P as evaluateVariant, L as featureFlagsTable, R as flagAuditTable, fe as flagLifecycleReport, z as flagRegistry, Y as flagUsageBuffer, he as flagUsageRowId, J as flagUsageTable, Se as flagValue, Ce as flagVariant, Te as flagsPlugin, V as flipFlagEnabled, a as gateOverride, Q as isFlagEnabled, o as isTypedFlag, re as mergeOverrides, X as recordFlagEvaluation, be as registerFlagUsageRetention, xe as requireFlag, N as resolveVariant, B as setFlagEnabled, ye as startFlagUsageFlush, w as toDefinition, i as typedValueOf, pe as utcDay };
+export { be as DEFAULT_FLAG_USAGE_FLUSH_MS, pe as FLAG_LIFECYCLE_LIMITS, q as FLAG_USAGE_TABLE, c as FlagDisabled, ue as assertFlagExperimentLinks, le as checkFlagExperimentLinks, fe as classifyShape, ye as dataStoreFlagUsageStore, s as defineFlag, W as describeFlags, ee as evaluateAll, te as evaluateAllVariants, N as evaluateFlag, M as evaluateSchedule, L as evaluateVariant, B as featureFlagsTable, V as flagAuditTable, me as flagLifecycleReport, H as flagRegistry, Y as flagUsageBuffer, _e as flagUsageRowId, J as flagUsageTable, we as flagValue, Te as flagVariant, De as flagsPlugin, U as flipFlagEnabled, a as gateOverride, Q as isFlagEnabled, o as isTypedFlag, ne as mergeOverrides, X as recordFlagEvaluation, Se as registerFlagUsageRetention, Ce as requireFlag, I as resolveVariant, re as setFlagEnabled, xe as startFlagUsageFlush, T as toDefinition, i as typedValueOf, he as utcDay };