@radzor/feature-flag

Simple feature flag evaluation with per-user overrides, percentage rollouts, and environment-based defaults. No external service required — flags are defined in code or config files.

Automationv0.1.0typescriptpythonServerfeature-flagrolloutab-testtoggleconfigurationdeploymentby Radzor

Install

View source on GitHub →

$npx radzor@latest add feature-flag

⚠ Constraints: Percentage rollout uses a deterministic hash of (flagName + userId) — same user always gets the same bucket. Overrides are in-memory and reset on restart. For persistent overrides and a UI, use a dedicated service like Unleash or LaunchDarkly.

Inputs

Name	Type	Default	Description
flags*	Record<string, boolean \| number \| string>	—	Default flag values. boolean=on/off, number=percentage rollout (0-100), string=variant name.
overrideEnv	boolean	true	Allow environment variables to override flag values (e.g. FF_MY_FLAG=true).
overrideHeader	string	—	HTTP header name for per-request overrides (e.g. X-Feature-Flags). Useful in testing.

flags*Record<string, boolean | number | string>

Default flag values. boolean=on/off, number=percentage rollout (0-100), string=variant name.

overrideEnvboolean

Allow environment variables to override flag values (e.g. FF_MY_FLAG=true).

default: true

{ "llm": { "constraints": "Percentage rollout uses a deterministic hash of (flagName + userId) — same user always gets the same bucket. Overrides are in-memory and reset on restart. For persistent overrides and a UI, use a dedicated service like Unleash or LaunchDarkly.", "usageExamples": "llm/examples.md", "integrationPrompt": "llm/integration.md" }, "name": "@radzor/feature-flag", "tags": [ "feature-flag", "rollout", "ab-test", "toggle", "configuration", "deployment" ], "events": [ { "name": "onFlagEnabled", "payload": { "flag": "string", "reason": "string", "userId": "string" }, "description": "Fired when a boolean flag evaluates to true." }, { "name": "onFlagDisabled", "payload": { "flag": "string", "userId": "string" }, "description": "Fired when a boolean flag evaluates to false." }, { "name": "onOverride", "payload": { "flag": "string", "value": "string", "source": "string" }, "description": "Fired when an env or header override changes the evaluated value." } ], "inputs": [ { "name": "flags", "type": "Record<string, boolean | number | string>", "required": true, "description": "Default flag values. boolean=on/off, number=percentage rollout (0-100), string=variant name." }, { "name": "overrideEnv", "type": "boolean", "default": true, "required": false, "description": "Allow environment variables to override flag values (e.g. FF_MY_FLAG=true)." }, { "name": "overrideHeader", "type": "string", "required": false, "description": "HTTP header name for per-request overrides (e.g. X-Feature-Flags). Useful in testing." } ], "radzor": "1.0.0", "actions": [ { "name": "isEnabled", "params": [ { "name": "flag", "type": "string", "description": "Flag name to evaluate." }, { "name": "userId", "type": "string", "required": false, "description": "User ID for percentage rollout bucket assignment." } ], "returns": "boolean", "description": "Evaluate a boolean flag for a user. For percentage flags, deterministically bucketed by userId." }, { "name": "getValue", "params": [ { "name": "flag", "type": "string", "description": "Flag name to read." }, { "name": "defaultValue", "type": "boolean | string | number", "required": false, "description": "Value returned if flag is not defined." } ], "returns": "boolean | string | number", "description": "Get the raw value of a flag." }, { "name": "setOverride", "params": [ { "name": "flag", "type": "string", "description": "Flag name to override." }, { "name": "value", "type": "boolean | string | number", "description": "Override value." } ], "returns": "void", "description": "Set a runtime override for a flag (in-memory, not persisted)." }, { "name": "getAll", "params": [ { "name": "userId", "type": "string", "required": false, "description": "User ID for rollout evaluation." } ], "returns": "Record<string, boolean | string | number>", "description": "Get all evaluated flag values for a given user context." } ], "outputs": [ { "name": "evaluation", "type": "{ flag: string; value: boolean | string; reason: 'default' | 'env' | 'override' | 'rollout' }", "description": "Flag evaluation result with the resolved value and reason." } ], "runtime": "server", "version": "0.1.0", "category": "automation", "languages": [ "typescript", "python" ], "description": "Simple feature flag evaluation with per-user overrides, percentage rollouts, and environment-based defaults. No external service required — flags are defined in code or config files.", "dependencies": { "packages": {} }, "composability": { "connectsTo": [ { "event": "onFlagEnabled", "description": "Track feature flag evaluations", "compatibleWith": [ "@radzor/event-tracker.action.track.eventName", "@radzor/log-aggregator.action.info.message" ] }, { "event": "onOverride", "description": "Audit feature flag overrides", "compatibleWith": [ "@radzor/log-aggregator.action.warn.message", "@radzor/event-tracker.action.track.eventName" ] } ] } }

@radzor/feature-flag

Install

Inputs

Outputs

Actions

Events

Composability

radzor.manifest.json

Version History