@voltro/plugin-flags 0.86.0 → 0.87.0

package/dist/rpc.js

@@ -1,21 +1,22 @@
-import { Schema as e } from "effect";
-import { defineQuery as t } from "@voltro/protocol";
+import { ConfigError as e } from "./errors.js";
+import { Schema as t } from "effect";
+import { defineQuery as n } from "@voltro/protocol";
 //#region src/rpc.ts
-var n = "@voltro/plugin-flags", r = t({
+var r = "@voltro/plugin-flags", i = n({
 	name: "flags.evaluate",
-	input: e.Struct({}),
-	output: e.Record(e.String, e.Boolean),
+	input: t.Struct({}),
+	output: t.Record(t.String, t.Boolean),
 	openAccess: "per-caller flag evaluation: returns only the values computed for the calling subject; every session (incl. anonymous) evaluates its own flags"
-}), i = e.Struct({
-	name: e.String,
-	value: e.Unknown,
-	enabled: e.Boolean
-}), a = t({
+}), a = t.Struct({
+	name: t.String,
+	value: t.Unknown,
+	enabled: t.Boolean
+}), o = n({
 	name: "flags.variants",
-	input: e.Struct({}),
-	output: e.Record(e.String, i),
+	input: t.Struct({}),
+	output: t.Record(t.String, a),
 	openAccess: "per-caller variant resolution: returns only the variants served to the calling subject; every session (incl. anonymous) evaluates its own flags"
-}), o = [{
+}), s = [{
 	tag: "flags.evaluate",
 	kind: "query",
 	import: {
@@ -29,6 +30,20 @@ var n = "@voltro/plugin-flags", r = t({
 		module: "@voltro/plugin-flags/rpc",
 		name: "evaluateVariantsDescriptor"
 	}
+}], c = n({
+	name: "config.mine",
+	input: t.Struct({}),
+	output: t.Record(t.String, t.Unknown),
+	error: e,
+	source: ["_voltro_feature_flags"],
+	openAccess: "Only declared public Config values computed from the actual calling subject; no subject selector or private keys."
+}), l = [{
+	tag: "config.mine",
+	kind: "query",
+	import: {
+		module: "@voltro/plugin-flags/rpc",
+		name: "configMineDescriptor"
+	}
 }];
 //#endregion
-export { n as BASE_NAME, r as evaluateDescriptor, a as evaluateVariantsDescriptor, o as flagsRpcClientImports };
+export { r as BASE_NAME, c as configMineDescriptor, l as configRpcClientImports, i as evaluateDescriptor, o as evaluateVariantsDescriptor, s as flagsRpcClientImports };

package/dist/store.js

@@ -19,6 +19,8 @@ var d = "_voltro_feature_flag_audit", f = "_voltro_feature_flags", p = c(f, {
 	enabled: t(),
 	previousEnabled: t().nullable(),
 	actorId: l().nullable(),
+	value: o().nullable(),
+	previousValue: o().nullable(),
 	at: u().default("now")
 }).index("byFlagAuditFlag", ["flag"]).index("byFlagAuditAt", ["at"]), h = (e, t) => {
 	let n = { ...e };
@@ -114,6 +116,8 @@ var d = "_voltro_feature_flag_audit", f = "_voltro_feature_flags", p = c(f, {
 	enabled: e.enabled === !0 || e.enabled === 1,
 	previousEnabled: e.previousEnabled == null ? null : e.previousEnabled === !0 || e.previousEnabled === 1,
 	actorId: e.actorId ?? null,
+	...e.value == null ? {} : { value: e.value },
+	...e.previousValue == null ? {} : { previousValue: e.previousValue },
 	at: e.at instanceof Date ? e.at : new Date(String(e.at))
 }), T = (e) => ({
 	record: async (t) => {
@@ -123,6 +127,8 @@ var d = "_voltro_feature_flag_audit", f = "_voltro_feature_flags", p = c(f, {
 			enabled: t.enabled,
 			previousEnabled: t.previousEnabled,
 			actorId: t.actorId,
+			value: t.value ?? null,
+			previousValue: t.previousValue ?? null,
 			at: t.at
 		});
 	},
@@ -131,6 +137,36 @@ var d = "_voltro_feature_flag_audit", f = "_voltro_feature_flags", p = c(f, {
 		return t?.flag != null && (n = n.where(r("flag", t.flag))), t?.limit != null && (n = n.limit(t.limit)), (await e.query(n.descriptor)).map(w);
 	}
 }), E = async (e, t, i, a, o) => {
+	await e.transactional(async (e) => {
+		await e.insertIgnore(f, {
+			...C(x(t, i)),
+			id: n("flag", crypto.randomUUID())
+		}, { conflictColumns: ["key"] });
+		let c = (await e.query(s(p).where(r("key", t)).forUpdate().descriptor))[0];
+		if (!c) throw Error("flag override disappeared during a Config change");
+		await e.update(f, String(c.id), {
+			enabled: !0,
+			rollout: 100,
+			rolloutBy: null,
+			targeting: null,
+			offVariant: null,
+			schedule: null,
+			variants: [{
+				name: "set",
+				value: a
+			}],
+			updatedAt: /* @__PURE__ */ new Date()
+		}), await T(e).record({
+			flag: t,
+			enabled: !0,
+			previousEnabled: c.enabled === !0 || c.enabled === 1,
+			actorId: o,
+			value: a,
+			previousValue: c.variants ?? null,
+			at: /* @__PURE__ */ new Date()
+		});
+	});
+}, D = async (e, t, i, a, o) => {
 	await e.transactional(async (e) => {
 		await e.insertIgnore(f, {
 			...C(x(t, i)),
@@ -151,4 +187,4 @@ var d = "_voltro_feature_flag_audit", f = "_voltro_feature_flags", p = c(f, {
 	});
 };
 //#endregion
-export { d as FLAGS_AUDIT_TABLE, f as FLAGS_TABLE, g as FlagRegistry, T as dataStoreFlagAuditStore, S as dataStoreFlagStore, b as describeFlags, p as featureFlagsTable, m as flagAuditTable, x as flagValueToRow, y as flipFlagEnabled, h as mergeOverrides, E as persistFlagToggle, _ as registry, v as setFlagEnabled };
+export { d as FLAGS_AUDIT_TABLE, f as FLAGS_TABLE, g as FlagRegistry, T as dataStoreFlagAuditStore, S as dataStoreFlagStore, b as describeFlags, p as featureFlagsTable, m as flagAuditTable, x as flagValueToRow, y as flipFlagEnabled, h as mergeOverrides, E as persistConfigValue, D as persistFlagToggle, _ as registry, v as setFlagEnabled };

package/dist/web.d.ts

@@ -1,3 +1,24 @@
+/** `TypedFlag` with the value type erased — what the plugin and the registry
+ *  hold. Sound because `TypedFlag` is covariant in `A` (see the annotation). */
+declare type AnyTypedFlag = TypedFlag<unknown>;
+
+declare interface ConfigEntry<out A> {
+    readonly key: string;
+    readonly flag: TypedFlag<A>;
+    readonly public: boolean;
+    readonly restartRequired: 'room' | 'live';
+    readonly min: number | null;
+    readonly max: number | null;
+}
+
+declare interface DefinedConfig<Values extends Readonly<Record<string, unknown>> = Readonly<Record<string, unknown>>> {
+    readonly entries: {
+        readonly [Key in keyof Values]: ConfigEntry<Values[Key]>;
+    };
+    readonly keys: readonly (keyof Values & string)[];
+    readonly typedFlags: readonly AnyTypedFlag[];
+}
+
 /** The result of decoding an UNTRUSTED value (a DB override, a dashboard edit)
  *  against a flag's Schema. Deliberately not an exception: the caller's correct
  *  response is to keep the code-declared value and say so, not to unwind. */
@@ -149,6 +170,9 @@ declare interface TypedFlagVariant<out A> {
     readonly weight?: number;
 }
 
+/** Explicit Config catalog; only public keys are delivered by config.mine. */
+export declare const useConfig: <Values extends Readonly<Record<string, unknown>>, Key extends keyof Values & string>(catalog: DefinedConfig<Values>, key: Key, apiName?: string) => Values[Key];
+
 /** `true` iff a single flag is on for the caller. */
 export declare const useFlag: (key: string, apiName?: string) => boolean;
 

package/dist/web.js

@@ -1,14 +1,20 @@
 import { BASE_NAME as e } from "./rpc.js";
 import { typedValueOf as t } from "./define.js";
-import { pluginTag as n } from "@voltro/protocol";
-import { useSubscription as r } from "@voltro/client";
+import { captureConfigValue as n } from "./config.js";
+import { pluginTag as r } from "@voltro/protocol";
+import { useSubscription as i } from "@voltro/client";
 //#region src/web.ts
-var i = (t) => n(e, t), a = (e = "app") => {
-	let { data: t } = r(e, i("evaluate"), {});
+var a = (t) => r(e, t), o = (e = "app") => {
+	let { data: t } = i(e, a("evaluate"), {});
 	return t ?? {};
-}, o = (e, t = "app") => a(t)[e] === !0, s = (e = "app") => {
-	let { data: t } = r(e, i("variants"), {});
+}, s = (e, t = "app") => o(t)[e] === !0, c = (e = "app") => {
+	let { data: t } = i(e, a("variants"), {});
 	return t ?? {};
-}, c = (e, t = "app") => s(t)[e], l = (e, n = "app") => t(e, s(n)[e.key]);
+}, l = (e, t = "app") => c(t)[e], u = (e, n = "app") => t(e, c(n)[e.key]), d = (e, t, r = "app") => {
+	let { data: a } = i(r, "config.mine", {}), o = e.entries[t];
+	if (!o.public) throw Error("useConfig requires an explicitly public Config key");
+	let s = o.flag.decode(a?.[t]);
+	return s.ok ? s.value : n(o.flag.defaultValue);
+};
 //#endregion
-export { o as useFlag, l as useFlagValue, a as useFlags, c as useVariant, s as useVariants };
+export { d as useConfig, s as useFlag, u as useFlagValue, o as useFlags, l as useVariant, c as useVariants };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltro/plugin-flags",
-  "version": "0.86.0",
+  "version": "0.87.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",
@@ -38,7 +38,27 @@
       "import": "./dist/rpc.js",
       "default": "./dist/rpc.js"
     },
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./config": {
+      "types": "./dist/config.d.ts",
+      "import": "./dist/config.js",
+      "default": "./dist/config.js"
+    },
+    "./config-port": {
+      "types": "./dist/config-port.d.ts",
+      "import": "./dist/config-port.js",
+      "default": "./dist/config-port.js"
+    },
+    "./config-inspect": {
+      "types": "./dist/config-inspect.d.ts",
+      "import": "./dist/config-inspect.js",
+      "default": "./dist/config-inspect.js"
+    },
+    "./config-testing": {
+      "types": "./dist/config-testing.d.ts",
+      "import": "./dist/config-testing.js",
+      "default": "./dist/config-testing.js"
+    }
   },
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -48,10 +68,10 @@
     "node": ">=24.0.0"
   },
   "dependencies": {
-    "@voltro/client": "0.86.0",
-    "@voltro/database": "0.86.0",
-    "@voltro/logger": "0.86.0",
-    "@voltro/protocol": "0.86.0"
+    "@voltro/client": "0.87.0",
+    "@voltro/database": "0.87.0",
+    "@voltro/logger": "0.87.0",
+    "@voltro/protocol": "0.87.0"
   },
   "peerDependencies": {
     "effect": "4.0.1"