Challenges in headless gamification

curl -X POST https://api.bricqs.com/api/v1/public/challenges/ch_uuid_123/enrol \
  -H "Authorization: Bearer bq_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "participant_id": "user_42",
    "participant_attributes": {
      "signup_source": "homepage"
    }
  }'

# Response (200 OK)
{
  "participation_id": "part_uuid_789",
  "status": "enrolled",
  "enrolled_at": "2026-06-01T10:00:00Z"
}

curl 'https://api.bricqs.com/api/v1/public/challenges/ch_uuid_123/progress?participant_id=user_42' \
  -H "Authorization: Bearer bq_live_xxxxx"

# Response (200 OK), see the data-model section above for the full shape

curl 'https://api.bricqs.com/api/v1/public/challenges/ch_uuid_123/leaderboard?participant_id=user_42&limit=10' \
  -H "Authorization: Bearer bq_live_xxxxx"

# Response (200 OK)
{
  "entries": [
    { "rank": 1, "participant_id": "user_99", "display_name": "Alex",  "score": 200 },
    { "rank": 2, "participant_id": "user_42", "display_name": "Jordan", "score": 175 }
  ],
  "my_rank": { "rank": 2, "score": 175, "total_participants": 248 }
}

export async function onUserCreated(user: User) {
  // existing post-signup logic...

  // Enrol them in the rolling onboarding challenge
  await fetch(
    `https://api.bricqs.com/api/v1/public/challenges/${ONBOARDING_CHALLENGE_ID}/enrol`,
    {
      method: "POST",
      headers: {
        "Authorization": `Bearer ${process.env.BRICQS_API_KEY}`,
        "Content-Type": "application/json",
      },
      body: JSON.stringify({
        participant_id: user.id,
        participant_attributes: {
          signup_source: user.signup_source,
        },
      }),
    }
  );
}

{
  "code": "first_purchase",
  "name": "Make your first purchase",
  "objective_type": "activity_count",
  "criteria": { "activity_code": "purchase_completed" },
  "target_value": 1,
  "prerequisite_objective_ids": ["complete_profile"],
  "points_on_completion": 100,
  "display_order": 3
}

{
  "milestones": [
    {
      "name": "Halfway",
      "milestone_type": "percentage",
      "at_percentage": 50,
      "rewards": {
        "points": 100,
        "badges": ["halfway"]
      }
    },
    {
      "name": "Complete",
      "milestone_type": "percentage",
      "at_percentage": 100,
      "rewards": {
        "points": 200,
        "badges": ["finisher"],
        "unlock_tier": "silver"
      }
    }
  ]
}

// Daily job: find participants who just completed and sync to CRM
const lastSync = await store.lastSyncedAt("challenge_completions");
const participants = await listEnrolledParticipants(CHALLENGE_ID);

for (const pid of participants) {
  const res = await fetch(
    `https://api.bricqs.com/api/v1/public/challenges/${CHALLENGE_ID}/progress?participant_id=${pid}`,
    { headers: { Authorization: `Bearer ${process.env.BRICQS_API_KEY}` } }
  );
  const progress = await res.json();

  if (
    progress.status === "completed" &&
    progress.completed_at > lastSync
  ) {
    await crm.recordChallengeCompletion(pid, progress);
  }
}

await store.setLastSyncedAt("challenge_completions", new Date());