Feature Flags

# Check if a feature is enabled for a user
curl https://api.justkalm.com/v2/features/multi_image_analysis \
  -H "Authorization: Bearer jk_live_xxx" \
  -d '{"user_id": "user_123"}'

# Response
{
  "key": "multi_image_analysis",
  "enabled": true,
  "variant": "treatment",
  "reason": "rule_match"
}

# Get all feature flags for a user
curl https://api.justkalm.com/v2/features \
  -H "Authorization: Bearer jk_live_xxx" \
  -d '{"user_id": "user_123"}'

# Response
{
  "flags": {
    "multi_image_analysis": true,
    "streaming_responses": true,
    "ai_condition_grading": false,
    "batch_v2": false
  },
  "evaluated_at": "2024-01-15T10:30:00Z"
}

import { JustKalm } from '@justkalm/sdk';

const client = new JustKalm({ apiKey: process.env.JUSTKALM_API_KEY });

// Check single flag
const isEnabled = await client.features.isEnabled('multi_image_analysis', {
  userId: 'user_123',
  attributes: {
    plan: 'enterprise',
    country: 'US',
  },
});

// Get all flags for user context
const flags = await client.features.evaluate({
  userId: 'user_123',
  attributes: { plan: 'enterprise' },
});

if (flags['streaming_responses']) {
  // Use streaming endpoint
}

# Create a new feature flag
curl -X POST https://api.justkalm.com/v2/features \
  -H "Authorization: Bearer jk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "key": "new_pricing_model",
    "name": "New Pricing Model",
    "description": "Test new per-image pricing",
    "targeting": {
      "rules": [
        {
          "segment": "beta_users",
          "percentage": 50
        }
      ],
      "default_variant": false
    }
  }'