@codingfactory/socialkit-vue 0.6.0 → 0.7.2

package/src/types/api.ts

@@ -51,6 +51,7 @@ export interface RequestConfig {
   headers?: Record<string, string>
   params?: Record<string, string | number | boolean>
   timeout?: number
+  responseType?: 'arraybuffer' | 'blob' | 'document' | 'json' | 'text'
   onUploadProgress?: (progressEvent: UploadProgressEvent) => void
   signal?: AbortSignal
 }

package/src/types/gamification.ts

@@ -0,0 +1,286 @@
+/**
+ * Gamification-domain types shared across SocialKit frontends.
+ */
+
+export interface UserStats {
+  id: string
+  user_id: string
+  total_points: number
+  coin_balance: number
+  lifetime_points: number
+  current_level: number
+  level: ReputationLevel
+  next_level: ReputationLevel | null
+  level_progress: number
+  points_to_next_level: number
+  points_this_week: number
+  points_this_month: number
+  points_this_year?: number
+  rank?: number
+  percentile?: number
+  badges?: Badge[]
+  streaks?: {
+    current: number
+    longest: number
+  }
+  streak?: {
+    current_count: number
+    longest_streak: number
+    last_activity_at?: string
+    frozen: boolean
+    freeze_available: number
+  }
+  daily_limits?: {
+    points_awarded: number
+    max_points: number
+    points_remaining: number
+    is_reached: boolean
+    resets_at: string
+  }
+  privileges: UserPrivilege[]
+  stats: Record<string, unknown>
+}
+
+export type UserReputation = UserStats
+
+export interface ReputationLevel {
+  level_number: number
+  name: string
+  badge_color: string
+  badge_icon: string
+  benefits: string[]
+  min_points?: number
+}
+
+export interface UserPrivilege {
+  id: string
+  slug: string
+  name: string
+  description: string
+  unlocked_at: string
+  expires_at?: string
+  category?: string
+  is_active?: boolean
+  privilege_id?: string
+}
+
+export interface Achievement {
+  id: string
+  name: string
+  description: string
+  icon: string
+  rarity?: 'common' | 'uncommon' | 'rare' | 'epic' | 'legendary'
+  condition_type?: 'count' | 'streak' | 'points' | 'social'
+  condition_data?: {
+    action?: string
+    target: number
+    current?: number
+  }
+  reward_points?: number
+  points_awarded?: number
+  reward_data?: {
+    badge_color?: string
+    badge_text?: string
+    special_privileges?: string[]
+    unlocks_feature?: string
+  }
+  is_active?: boolean
+  is_visible?: boolean
+  is_unlocked?: boolean
+  is_claimed?: boolean
+  can_claim?: boolean
+  unlocked_at?: string | null
+  claimed_at?: string | null
+  progress_percentage?: number
+  progress_current?: number
+  progress_target?: number
+  share_card?: AchievementShareCard
+  progress?: number | AchievementProgress
+  sort_order?: number
+  requirements?: AchievementRequirement[]
+  category?: string
+}
+
+export interface AchievementShareCard {
+  title: string
+  badge_label: string
+  description: string
+  image_url: string
+  share_url: string
+  share_text: string
+}
+
+export interface AchievementProgress {
+  current_value: number
+  target_value: number
+  percentage: number
+  unit: string
+}
+
+export interface AchievementRequirement {
+  id: string
+  type: string
+  target_value: number
+  current_value: number
+  description: string
+}
+
+export interface AchievementUnlockNotification {
+  achievementId: string
+  title: string
+  description: string
+  icon: string
+  unlockedAt: string
+  points?: number
+}
+
+export interface Quest {
+  id: string
+  name?: string
+  title?: string
+  description: string
+  type: 'daily' | 'weekly' | 'monthly' | 'special' | 'challenge'
+  objectives: QuestObjective[]
+  rewards?: QuestReward[]
+  reward_points: number
+  status?: 'available' | 'in_progress' | 'completed' | 'expired'
+  is_active?: boolean
+  starts_at?: string
+  expires_at: string | null
+  completed_at: string | null
+  accepted_at?: string | null
+  progress?: {
+    current: number
+    total: number
+    percentage: number
+  }
+  progress_percentage?: number
+  category?: string
+}
+
+export interface QuestObjective {
+  id: string
+  quest_id?: string
+  description: string
+  type: string
+  target: number
+  target_value?: number
+  current: number
+  current_value?: number
+  is_completed?: boolean
+  completed?: boolean
+  bonus_points?: number
+  unit?: string
+}
+
+export interface QuestReward {
+  type: 'points' | 'badge' | 'privilege' | 'item'
+  value: number | string
+  description: string
+}
+
+export interface LeaderboardEntry {
+  rank: number
+  user_id: string
+  handle: string
+  name: string
+  avatar_url?: string | null
+  points: number
+  period_points?: number
+  total_points: number
+  level: number
+  current_level?: number
+  level_details?: ReputationLevel
+  achievements_count?: number
+  change: number
+  trend?: number | 'up' | 'down' | 'same' | null
+  is_current_user: boolean
+  space_id?: string | null
+}
+
+export type LeaderboardPeriod = 'daily' | 'weekly' | 'monthly' | 'all-time'
+export type QuestFilter = 'active' | 'daily' | 'weekly' | 'completed'
+
+export interface Reward {
+  id: string
+  name: string
+  description: string
+  cost_points: number
+  reward_type?: 'badge' | 'title' | 'cosmetic' | 'boost' | 'feature'
+  type?: 'cosmetic' | 'privilege' | 'boost' | 'item'
+  category?: 'badge' | 'privilege' | 'cosmetic' | 'bonus'
+  icon?: string
+  preview_image?: string
+  reward_data?: Record<string, unknown>
+  can_redeem?: boolean
+  user_points?: number
+  points_needed?: number
+  stock_quantity?: number | null
+  stock_remaining?: number | null
+  max_per_user?: number
+  user_redemptions?: number
+  availability_status?: 'available' | 'insufficient_points' | 'out_of_stock' | 'limit_reached' | 'inactive' | string
+  data?: {
+    duration?: number
+    value?: unknown
+    icon?: string
+    color?: string
+  }
+  stock?: number
+  limited_quantity?: number | null
+  remaining_quantity?: number | null
+  redemption_limit?: number
+  is_available?: boolean
+  is_claimed?: boolean
+  redeemed_count?: number
+  redeemed_at?: string
+}
+
+export interface ClaimedReward {
+  id: string
+  reward_id: string
+  reward: Reward
+  claimed_at: string
+  status: 'active' | 'expired'
+  expires_at?: string
+}
+
+export interface RewardTransaction {
+  id: string
+  reward_id: string
+  reward: Reward
+  points_spent: number
+  transaction_type: 'redemption' | 'refund'
+  created_at: string
+  metadata: Record<string, unknown>
+}
+
+export interface Badge {
+  id: string
+  name: string
+  description: string
+  icon: string
+  color: string
+  rarity: 'common' | 'uncommon' | 'rare' | 'epic' | 'legendary'
+  earned_at: string
+}
+
+export interface GamificationNotification {
+  type: 'points_earned' | 'level_up' | 'achievement_unlocked' | 'quest_completed' | 'leaderboard_change' | 'reward_available'
+  data: unknown
+  timestamp: string
+}
+
+export interface PointTransaction {
+  id: string
+  user_id: string
+  points: number
+  type: string
+  source_type?: string
+  source_id?: string
+  description: string
+  created_at: string
+  is_reversed?: boolean
+  reversed_at?: string
+  reversal_reason?: string
+}

package/src/types/reputation.ts

@@ -0,0 +1,78 @@
+/**
+ * Generic reputation-adjacent types shared across SocialKit frontends.
+ */
+
+import type {
+  LeaderboardEntry,
+  PointTransaction,
+  ReputationLevel,
+  UserReputation,
+  UserStats,
+  UserPrivilege,
+} from './gamification.js'
+
+export type Timestamp = string
+
+export type {
+  LeaderboardEntry,
+  PointTransaction,
+  ReputationLevel,
+  UserPrivilege,
+  UserReputation,
+  UserStats,
+}
+
+export interface ReputationPrivilege {
+  id: string
+  name: string
+  slug: string
+  category: string
+  required_points: number
+  required_level: number | null
+  description: string
+  is_active: boolean
+}
+
+export interface DailyLimitStatus {
+  points_awarded: number
+  max_points: number
+  points_remaining: number
+  is_reached: boolean
+  resets_at: string
+}
+
+export interface StreakMilestone {
+  days: number
+  days_remaining: number
+  bonus_points: number
+}
+
+export interface UserStreakStatus {
+  days: number
+  is_active_today: boolean
+  freeze_available: number
+  next_milestone: StreakMilestone | null
+}
+
+export interface PointsAwardedEvent {
+  transaction_id?: string
+  action_type: string
+  points: number
+  reason?: string
+  source_type?: string
+  source_id?: string
+  metadata?: Record<string, unknown>
+  level_progress?: number
+  lifetime_points?: number
+}
+
+export interface LevelUpEvent {
+  new_level: number
+  level_details: ReputationLevel
+  next_level_details: ReputationLevel | null
+}
+
+export interface ReputationSnapshot {
+  snapshot_date: Timestamp
+  total_points: number
+}