@voltro/plugin-flags 0.81.0 → 0.83.0

package/dist/index.js

@@ -9,7 +9,7 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (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, D = (e, t) => T(`${e}:variant`, t) % 1e4, ee = (e, t) => {
+}, E = (e, t) => T(e, t) % 100, ee = (e, t) => T(`${e}:variant`, t) % 1e4, D = (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 ?? {};
@@ -44,43 +44,43 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (e, t) => {
 		if (!e.active) return !1;
 		a = e.rollout;
 	}
-	if (i.targeting && i.targeting.length > 0 && !i.targeting.some((e) => ee(e, n))) return !1;
+	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 ? M(e, i, n).name !== i.offVariant : !0;
-}, te = (e) => {
+	return i.variants && i.variants.length > 0 && i.offVariant != null ? N(e, i, n).name !== i.offVariant : !0;
+}, M = (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)));
-}, M = (e, t, n) => {
+}, N = (e, t, n) => {
 	let r = t.variants ?? [];
 	if (r.length === 0) throw Error(`flag "${e}" has no variants`);
-	let i = D(e, k(t, n)), a = te(r);
+	let i = ee(e, k(t, n)), a = M(r);
 	for (let e = 0; e < r.length; e++) if (i < a[e]) return r[e];
 	return r[r.length - 1];
-}, N = (e, t, n, r = Date.now()) => {
+}, P = (e, t, n, r = Date.now()) => {
 	let i = w(t), a = j(e, t, n, r);
 	if (!i.variants || i.variants.length === 0) return {
 		name: a ? "on" : "off",
 		value: a,
 		enabled: a
 	};
-	let o = M(e, i, n);
+	let o = N(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] = j(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] = N(i, a, t, n);
+	for (let [i, a] of Object.entries(e)) r[i] = P(i, a, t, n);
 	return r;
-}, P = "_voltro_feature_flag_audit", F = "_voltro_feature_flags", I = x(F, {
+}, F = "_voltro_feature_flag_audit", I = "_voltro_feature_flags", L = x(I, {
 	id: h({ prefix: "flag" }),
 	key: S().unique(),
 	enabled: f().default(!0),
@@ -92,14 +92,14 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (e, t) => {
 	schedule: _().nullable(),
 	description: S().nullable(),
 	updatedAt: C().default("now").onUpdate("now")
-}), L = x(P, {
+}), 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"]), ie = (e, t) => {
+}).index("byFlagAuditFlag", ["flag"]).index("byFlagAuditAt", ["at"]), re = (e, t) => {
 	let n = { ...e };
 	for (let e of t) {
 		let t = {
@@ -115,7 +115,7 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (e, t) => {
 		n[e.key] = t;
 	}
 	return n;
-}, R = new class {
+}, z = new class {
 	flags = {};
 	set(e) {
 		this.flags = e;
@@ -126,18 +126,18 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (e, t) => {
 	get(e) {
 		return this.flags[e];
 	}
-}(), ae = (e, t) => z(e, t) !== null, z = (e, t) => {
-	let n = R.get(e);
+}(), B = (e, t) => V(e, t) !== null, V = (e, t) => {
+	let n = z.get(e);
 	if (n === void 0) return null;
 	let r = w(n), i = r.enabled !== !1;
-	return R.set({
-		...R.all(),
+	return z.set({
+		...z.all(),
 		[e]: {
 			...r,
 			enabled: t
 		}
 	}), i;
-}, B = (e) => Object.entries(e).map(([e, t]) => {
+}, H = (e) => Object.entries(e).map(([e, t]) => {
 	let n = w(t);
 	return {
 		key: e,
@@ -147,7 +147,7 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (e, t) => {
 		scheduled: n.schedule != null,
 		description: n.description
 	};
-}), V = (e, t) => {
+}), ie = (e, t) => {
 	let n = w(t);
 	return {
 		key: e,
@@ -160,8 +160,8 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (e, t) => {
 		schedule: n.schedule ?? null,
 		description: n.description ?? null
 	};
-}, oe = (e) => ({
-	loadOverrides: async () => (await e.query(v(I).descriptor)).map((e) => ({
+}, ae = (e) => ({
+	loadOverrides: async () => (await e.query(v(L).descriptor)).map((e) => ({
 		key: String(e.key),
 		enabled: e.enabled === !0 || e.enabled === 1,
 		rollout: e.rollout == null ? null : Number(e.rollout),
@@ -173,10 +173,10 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (e, t) => {
 		description: e.description ?? null
 	})),
 	upsertOverride: async (t) => {
-		let n = se(t);
-		await e.upsert(F, n, { conflictColumns: ["key"] });
+		let n = U(t);
+		await e.upsert(I, n, { conflictColumns: ["key"] });
 	}
-}), se = (e) => ({
+}), U = (e) => ({
 	id: p("flag", e.key),
 	key: e.key,
 	enabled: e.enabled,
@@ -188,15 +188,15 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (e, t) => {
 	schedule: e.schedule,
 	description: e.description,
 	updatedAt: /* @__PURE__ */ new Date()
-}), ce = (e) => ({
+}), oe = (e) => ({
 	flag: String(e.flag),
 	enabled: e.enabled === !0 || e.enabled === 1,
 	previousEnabled: e.previousEnabled == null ? null : e.previousEnabled === !0 || e.previousEnabled === 1,
 	actorId: e.actorId ?? null,
 	at: e.at instanceof Date ? e.at : new Date(String(e.at))
-}), H = (e) => ({
+}), se = (e) => ({
 	record: async (t) => {
-		await e.insert(P, {
+		await e.insert(F, {
 			id: `flagaud_${t.at.getTime()}_${Math.random().toString(36).slice(2, 10)}`,
 			flag: t.flag,
 			enabled: t.enabled,
@@ -206,21 +206,21 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (e, t) => {
 		});
 	},
 	list: async (t) => {
-		let n = v(L).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(ce);
+		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);
 	}
-}), le = async (e, t, n, r, i) => {
+}), ce = async (e, t, n, r, i) => {
 	await e.transactional(async (e) => {
-		await e.insertIgnore(F, {
-			...se(V(t, n)),
+		await e.insertIgnore(I, {
+			...U(ie(t, n)),
 			id: p("flag", crypto.randomUUID())
 		}, { conflictColumns: ["key"] });
-		let a = (await e.query(v(I).where(m("key", t)).forUpdate().descriptor))[0];
+		let a = (await e.query(v(L).where(m("key", t)).forUpdate().descriptor))[0];
 		if (!a) throw Error("flag override disappeared during toggle");
-		await e.update(F, String(a.id), {
+		await e.update(I, String(a.id), {
 			enabled: r,
 			updatedAt: /* @__PURE__ */ new Date()
-		}), await H(e).record({
+		}), await se(e).record({
 			flag: t,
 			enabled: r,
 			previousEnabled: a.enabled === !0 || a.enabled === 1,
@@ -228,7 +228,7 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (e, t) => {
 			at: /* @__PURE__ */ new Date()
 		});
 	});
-}, U = (e, t) => {
+}, W = (e, t) => {
 	let n = new Map(t.map((e) => [e.name, e])), r = [];
 	for (let t of e) {
 		let e = t.experiment;
@@ -267,12 +267,12 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (e, t) => {
 		}
 	}
 	return r;
-}, W = (e, t) => {
-	let n = U(e, t);
+}, le = (e, t) => {
+	let n = W(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")}`);
-}, G = 864e5, K = (e) => typeof e == "number" ? e : Date.parse(e), ue = (e, t) => {
+}, ue = 864e5, G = (e) => typeof e == "number" ? e : Date.parse(e), K = (e, t) => {
 	let n = w(e);
 	if (n.enabled === !1) return {
 		shape: "constantOff",
@@ -280,11 +280,11 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (e, t) => {
 	};
 	if (n.schedule) {
 		let { activateAt: e, deactivateAt: r } = n.schedule;
-		if (r != null && t >= K(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 < K(e)) return {
+		if (e != null && t < G(e)) return {
 			shape: "notYetActive",
 			reason: `schedule.activateAt (${String(e)}) is in the future — pending, not dead`
 		};
@@ -294,7 +294,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 < K(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"
@@ -314,7 +314,7 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (e, t) => {
 	"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 * G, i = /* @__PURE__ */ new Map(), a = /* @__PURE__ */ new Map(), o;
+	let t = e.now ?? Date.now(), n = e.staleAfterDays, r = t - n * ue, 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 +322,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) / G);
+	let s = o === void 0 ? 0 : Math.floor((t - o) / ue);
 	return {
 		coverage: {
 			tracking: e.tracking,
@@ -332,7 +332,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 } = ue(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"), {
@@ -458,14 +458,14 @@ 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 = R.get(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 = R.get(t.key);
-	return X(t.key, "targeted"), n === void 0 ? t.defaultValue : i(t, N(t.key, n, Z(e)));
+	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 = R.get(t.key);
-	return X(t.key, "targeted"), n === void 0 ? null : N(t.key, n, Z(e)).name;
+	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({
 		base: $,
@@ -477,71 +477,87 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (e, t) => {
 		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);
 	}
-	s.some((e) => e.experiment !== void 0) && W(s, e.experiments ?? []);
+	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 = e.usage ?? {}, S = x.track ?? m;
-	if (S && !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 C = x.staleAfterDays ?? 30, w = x.retentionDays ?? 90;
-	if (C > w) throw Error(`${$}: usage.staleAfterDays (${C}) exceeds usage.retentionDays (${w}), so the observation window can never be long enough to prove a flag stale and every verdict would be withheld.`);
-	let T = (e) => {
-		let t = ie(p, e), n = [];
+	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) {
 			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);
 		}
-		b = n, R.set(t);
-	}, E = 0, D = async () => {
+		S = n, z.set(t);
+	}, D = 0, O = async () => {
 		if (!g) return;
-		let e = ++E, t = await g.loadOverrides();
-		e === E && T(t);
-	}, ee = (e) => {
+		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,
+					log: { warn: (t, n) => e.warn(t, n) }
+				});
+			}
+			for (let e of S) b.logger.warn("feature flag override REFUSED — code-declared definition stands", {
+				flag: e.key,
+				reason: e.reason
+			});
+		}
+	}, A = (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;
-	}, O = (e, t) => {
-		let n = ee(t.tag);
+	}, j = (e, t) => {
+		let n = A(t.tag);
 		return n === void 0 || Q({ subject: t.subject }, n) ? e : l.fail(new c({ flag: n }));
-	}, k = Object.keys(i).length > 0, A = (e) => {
+	}, M = Object.keys(i).length > 0, N = (e) => {
 		for (let t of e) X(t, "bulk");
-	}, j = {
+	}, P = {
 		...t,
 		description: "Resolve every feature flag for the calling subject.",
 		execute: (e, t) => l.sync(() => {
-			let e = R.all();
-			return A(Object.keys(e)), ne(e, t.request.subject ?? {});
+			let e = z.all();
+			return N(Object.keys(e)), te(e, t.request.subject ?? {});
 		})
-	}, te = {
+	}, F = {
 		...n,
 		description: "Resolve every feature flag to its served variant for the calling subject.",
 		execute: (e, t) => l.sync(() => {
-			let e = R.all();
-			return A(Object.keys(e)), re(e, t.request.subject ?? {});
+			let e = z.all();
+			return N(Object.keys(e)), ne(e, t.request.subject ?? {});
 		})
-	}, M = (e) => ({
+	}, I = (e) => ({
 		kind: "json",
 		data: e
-	}), N = (e, t) => ({
+	}), B = (e, t) => ({
 		kind: "json",
 		status: e,
 		data: { error: t }
-	}), P = async () => {
+	}), ie = async () => {
 		let e = [];
-		if (S && v) try {
+		if (w && v) try {
 			e = await v.load();
 		} catch {
 			e = [];
 		}
 		return fe({
-			flags: R.all(),
+			flags: z.all(),
 			usage: e,
-			tracking: S,
+			tracking: w,
 			liveCounts: Y.liveTargetedCounts(),
-			staleAfterDays: C,
-			retentionDays: w
+			staleAfterDays: T,
+			retentionDays: E
 		});
-	}, F = () => {
+	}, U = () => {
 		let e = {};
 		for (let [t, n] of f) e[t] = {
 			valueType: n.valueType,
@@ -549,19 +565,20 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (e, t) => {
 			experiment: n.experiment ?? null
 		};
 		return e;
-	}, ae = [
+	}, oe = [
 		{
 			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 P();
-				return M({
-					flags: B(R.all()),
+				let e = await ie();
+				return I({
+					flags: H(z.all()),
+					writeScope: m ? "shared-store" : "process",
 					lifecycle: e,
-					typed: F(),
-					overrideRefusals: b
+					typed: U(),
+					overrideRefusals: S
 				});
 			})
 		},
@@ -574,21 +591,21 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (e, t) => {
 				try {
 					t = JSON.parse(e.body || "{}");
 				} catch {
-					return N(400, "invalid JSON body");
+					return B(400, "invalid JSON body");
 				}
-				if (!t || typeof t.key != "string" || !t.key || typeof t.enabled != "boolean") return N(400, "key (string) + enabled (boolean) required");
-				let n = t.key, r = t.enabled, i = R.get(n);
-				if (i === void 0) return N(404, `unknown flag "${n}"`);
+				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 N(503, "flag store is not ready");
+					if (!e) return B(503, "flag store is not ready");
 					if ((yield* l.tryPromise(async () => {
-						await le(e, n, i, r, typeof t.actor == "string" ? t.actor : null), await D();
-					}).pipe(l.either))._tag === "Left") return yield* l.tryPromise(D).pipe(l.ignore), N(503, "flag update could not be confirmed; reload the flag state before retrying");
-				} else z(n, r);
-				return M({
+						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({
 					ok: !0,
-					flags: B(R.all())
+					flags: H(z.all())
 				});
 			})
 		},
@@ -598,7 +615,7 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (e, t) => {
 			scope: m ? "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 M({
+				if (!_) return I({
 					audit: [],
 					note: "audit trail requires store: \"postgres\""
 				});
@@ -606,7 +623,7 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (e, t) => {
 					...n == null ? {} : { flag: n },
 					limit: i
 				}));
-				return M({ audit: a.map((e) => ({
+				return I({ audit: a.map((e) => ({
 					flag: e.flag,
 					enabled: e.enabled,
 					previousEnabled: e.previousEnabled,
@@ -615,8 +632,8 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (e, t) => {
 				})) });
 			})
 		}
-	], V = [
-		...k ? [
+	], W = [
+		...M ? [
 			"rpc:intercept:mutation",
 			"rpc:intercept:query",
 			"rpc:intercept:action",
@@ -630,10 +647,10 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (e, t) => {
 		name: o,
 		baseName: $,
 		description: "Feature flags — targeting, % rollout, kill-switch, declarative gating + client evaluation.",
-		permissions: V,
-		routes: [j, te],
+		permissions: W,
+		routes: [P, F],
 		rpcClientDescriptors: r,
-		inspectEndpoints: ae,
+		inspectEndpoints: oe,
 		errorSchemas: [{
 			schema: c,
 			import: {
@@ -641,45 +658,34 @@ var w = (e) => typeof e == "boolean" ? { enabled: e } : e, T = (e, t) => {
 				name: "FlagDisabled"
 			}
 		}],
-		...k ? {
-			interceptMutation: O,
-			interceptQuery: O,
-			interceptAction: O,
-			interceptWorkflow: O
+		...M ? {
+			interceptMutation: j,
+			interceptQuery: j,
+			interceptAction: j,
+			interceptWorkflow: j
 		} : {},
-		...m ? { extendSchema: { tables: S ? [
-			I,
+		...m ? { extendSchema: { tables: w ? [
 			L,
+			R,
 			J
-		] : [I, L] } } : {},
-		...m ? { bindDataStore: (e) => {
-			h = e, g = oe(h), _ = H(e), S && (v = _e(e));
+		] : [L, R] } } : {},
+		...m ? { bindDataStore: async (e) => {
+			h = e, g = ae(h), _ = se(e), w && (v = _e(e)), await k();
 		} } : {},
-		...m ? { onChangeEvent: (e) => e.table === "_voltro_feature_flags" ? l.tryPromise(() => D()) : l.void } : {},
+		...m ? { onChangeEvent: (e) => e.table === "_voltro_feature_flags" ? l.tryPromise(() => O()) : l.void } : {},
 		onActivate: (t) => l.gen(function* () {
-			R.set(p), m && g && (yield* l.promise(D));
-			let n;
-			S && v && (n = be(process.env, w), Y.enable(), y = ye({
-				store: v,
-				intervalMs: x.flushIntervalMs ?? 3e5,
-				log: { warn: (e, n) => t.logger.warn(e, n) }
-			}));
-			for (let e of b) t.logger.warn("feature flag override REFUSED — the code-declared definition stands", {
-				flag: e.key,
-				reason: e.reason
-			});
-			t.logger.info("feature flags active", {
+			z.set(p), b = t, g && (yield* l.promise(k)), t.logger.info("feature flags active", {
 				count: Object.keys(p).length,
 				typed: f.size,
 				gated: Object.keys(i).length,
 				store: e.store ?? "memory",
-				usage: S ? `tracking (stale after ${C}d, observations kept ${Math.round((n ?? 0) / 864e5)}d)` : "off — no dead-flag evidence is collected"
+				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"
 			});
 		}),
 		onDeactivate: () => l.promise(async () => {
-			await y?.stop(), y = void 0, Y.disable(), R.set({});
+			b = void 0, await y?.stop(), y = void 0, Y.disable(), z.set({});
 		})
 	});
 };
 //#endregion
-export { ve as DEFAULT_FLAG_USAGE_FLUSH_MS, de as FLAG_LIFECYCLE_LIMITS, q as FLAG_USAGE_TABLE, c as FlagDisabled, W as assertFlagExperimentLinks, U as checkFlagExperimentLinks, ue as classifyShape, _e as dataStoreFlagUsageStore, s as defineFlag, B as describeFlags, ne as evaluateAll, re as evaluateAllVariants, j as evaluateFlag, A as evaluateSchedule, N as evaluateVariant, I as featureFlagsTable, L as flagAuditTable, fe as flagLifecycleReport, R as flagRegistry, Y as flagUsageBuffer, he as flagUsageRowId, J as flagUsageTable, Se as flagValue, Ce as flagVariant, Te as flagsPlugin, z as flipFlagEnabled, a as gateOverride, Q as isFlagEnabled, o as isTypedFlag, ie as mergeOverrides, X as recordFlagEvaluation, be as registerFlagUsageRetention, xe as requireFlag, M as resolveVariant, ae as setFlagEnabled, ye as startFlagUsageFlush, w as toDefinition, i as typedValueOf, pe as utcDay };
+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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltro/plugin-flags",
-  "version": "0.81.0",
+  "version": "0.83.0",
   "description": "Feature flags — per-subject / per-tenant targeting, deterministic % rollouts, kill-switch. Gate mutations/queries/actions declaratively or guard in-handler; evaluate flags client-side for UI gating. Config-as-code (memory) or runtime-toggleable (postgres).",
   "keywords": [
     "voltro",
@@ -48,10 +48,10 @@
     "node": ">=24.0.0"
   },
   "dependencies": {
-    "@voltro/client": "0.81.0",
-    "@voltro/database": "0.81.0",
-    "@voltro/logger": "0.81.0",
-    "@voltro/protocol": "0.81.0"
+    "@voltro/client": "0.83.0",
+    "@voltro/database": "0.83.0",
+    "@voltro/logger": "0.83.0",
+    "@voltro/protocol": "0.83.0"
   },
   "peerDependencies": {
     "effect": "^3.22.2"