@radzor/user-segmentation

Segment users based on attributes and behavioral rules. Define segments with filter expressions, evaluate users against them, and list matching segments. In-memory rule engine, zero dependencies.

Analyticsv0.1.0typescriptpythonServersegmentationuserstargetingcohortfilteranalyticsby Radzor

Install

View source on GitHub →

$npx radzor@latest add user-segmentation

⚠ Constraints: Rules are evaluated synchronously in-memory. The cache stores the last evaluation per user — calling evaluate() overwrites the previous result. Supported operators: eq, neq, gt, gte, lt, lte, in, notIn, contains, startsWith, endsWith, exists, regex.

Inputs

Name	Type	Default	Description
segments	SegmentDefinition[]	—	Pre-defined segment definitions with filter rules.

segmentsSegmentDefinition[]

Pre-defined segment definitions with filter rules.

Outputs

Name	Type	Description
segmentResult	SegmentResult	Result of evaluating a user against segments. .userIdstring .matchedSegmentsstring[] .evaluatedAtnumber

{ "llm": { "constraints": "Rules are evaluated synchronously in-memory. The cache stores the last evaluation per user — calling evaluate() overwrites the previous result. Supported operators: eq, neq, gt, gte, lt, lte, in, notIn, contains, startsWith, endsWith, exists, regex.", "usageExamples": "llm/examples.md", "integrationPrompt": "llm/integration.md" }, "name": "@radzor/user-segmentation", "tags": [ "segmentation", "users", "targeting", "cohort", "filter", "analytics" ], "events": [], "inputs": [ { "name": "segments", "type": "SegmentDefinition[]", "required": false, "description": "Pre-defined segment definitions with filter rules." } ], "radzor": "1.0.0", "actions": [ { "name": "evaluate", "params": [ { "name": "userId", "type": "string", "description": "User to evaluate." }, { "name": "attributes", "type": "Record<string, unknown>", "description": "User attributes to evaluate against segment rules." } ], "returns": "SegmentResult", "description": "Evaluate which segments a user belongs to based on their attributes." }, { "name": "defineSegment", "params": [ { "name": "segmentId", "type": "string", "description": "Unique segment identifier." }, { "name": "name", "type": "string", "description": "Human-readable segment name." }, { "name": "rules", "type": "SegmentRule[]", "description": "Array of filter rules (ANDed together)." } ], "returns": "void", "description": "Define a new segment with filter rules." }, { "name": "listSegments", "params": [], "returns": "SegmentDefinition[]", "description": "List all defined segments." }, { "name": "getUserSegments", "params": [ { "name": "userId", "type": "string", "description": "User to look up cached segments for." } ], "returns": "string[]", "description": "Get the cached list of segment IDs for a previously evaluated user." } ], "outputs": [ { "name": "segmentResult", "type": "SegmentResult", "fields": [ { "name": "userId", "type": "string", "description": "The evaluated user ID." }, { "name": "matchedSegments", "type": "string[]", "description": "IDs of segments the user belongs to." }, { "name": "evaluatedAt", "type": "number", "description": "Timestamp of evaluation." } ], "description": "Result of evaluating a user against segments." } ], "runtime": "server", "version": "0.1.0", "category": "analytics", "languages": [ "typescript", "python" ], "description": "Segment users based on attributes and behavioral rules. Define segments with filter expressions, evaluate users against them, and list matching segments. In-memory rule engine, zero dependencies.", "dependencies": { "radzor": [], "packages": {} }, "composability": { "connectsTo": [ { "output": "segmentResult", "mapField": "userId", "compatibleWith": [ "@radzor/ab-test.action.getVariant.userId", "@radzor/feature-flag.action.isEnabled.userId", "@radzor/notification-hub.action.send.recipient" ] } ] } }

@radzor/user-segmentation

Install

Inputs

Outputs

Actions

Composability

radzor.manifest.json