@codingfactory/socialkit-vue 0.5.3 → 0.7.0

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/content-api.ts

@@ -0,0 +1,24 @@
+/**
+ * Content API type definitions.
+ */
+
+import type { FeedEntry, Post } from './content.js'
+
+export interface FeedResponse {
+  data: {
+    entries: FeedEntry[]
+    meta?: {
+      next_cursor?: string | null
+      has_more?: boolean
+      current_page?: number
+      total?: number
+    }
+    next_cursor?: string | null
+  }
+  page_entries?: FeedEntry[]
+  next_cursor?: string | null
+  entries?: FeedEntry[]
+  posts?: Post[]
+  hasMore?: boolean
+  nextCursor?: string | null
+}

package/src/types/content.ts

@@ -0,0 +1,381 @@
+/**
+ * Content-domain types and store contracts shared across SocialKit frontends.
+ */
+
+import type { ApiService } from '../services/api.js'
+import type { LocalMediaItem } from './media.js'
+
+export interface BaseEntity {
+  id: string
+  created_at: string
+  updated_at?: string
+}
+
+export type VideoRenderStatus = 'pending' | 'processing' | 'ready' | 'failed'
+
+export interface PostMedia {
+  id?: string
+  uuid?: string
+  mime_type?: string
+  url?: string
+  thumb_url?: string
+  preview_url?: string
+  playback_url?: string
+  thumbnail_url?: string
+  urls?: {
+    original?: string
+    thumb?: string
+    thumbnail?: string
+    preview?: string
+  }
+  type?: 'image' | 'video'
+  alt_text?: string
+  width?: number
+  height?: number
+  responsive?: {
+    preview?: {
+      srcset?: string
+    }
+    original?: {
+      srcset?: string
+    }
+  }
+  processing_status?: VideoRenderStatus
+  video_render_status?: VideoRenderStatus
+  video_render_progress?: number
+  video_render_error?: string | null
+  video_render_job_id?: string | null
+  source_media_id?: string
+  output_media_id?: string
+  provider?: string
+  provider_asset_id?: string
+  provider_library_id?: string
+  duration?: number
+  aspect_ratio?: string
+}
+
+export interface PostAuthor {
+  id: string
+  name: string
+  avatar?: string | null
+  username?: string | null
+  handle?: string | null
+}
+
+export type PostFeelingType = 'mood' | 'activity'
+export type PostFeelingValue =
+  | 'inspired'
+  | 'creative'
+  | 'focused'
+  | 'relaxed'
+  | 'excited'
+  | 'grateful'
+  | 'proud'
+  | 'experimental'
+  | 'in_the_studio'
+  | 'teaching_a_class'
+  | 'at_a_show'
+  | 'experimenting'
+  | 'collaborating'
+  | 'learning_a_technique'
+
+export interface PostFeeling {
+  type: PostFeelingType
+  value: PostFeelingValue
+}
+
+export interface PostMeta {
+  live_viewers?: number | null
+  feeling?: PostFeeling | null
+  [key: string]: unknown
+}
+
+export type PostShareType = 'original' | 'repost' | 'quote'
+
+export interface QuotedPostPreview {
+  id: string
+  body: string
+  author?: PostAuthor | null
+  author_id?: string
+  created_at?: string
+}
+
+export interface Post extends BaseEntity {
+  body: string
+  share_type?: PostShareType
+  quoted_post_id?: string | null
+  quoted_post?: QuotedPostPreview | null
+  content_warning?: string | null
+  sensitive?: boolean
+  author: PostAuthor
+  author_id: string
+  reactions_count: number
+  comments_count: number
+  user_has_reacted: boolean
+  user_has_reposted?: boolean
+  user_repost_id?: string | null
+  visibility?: 'public' | 'private' | 'friends'
+  media?: PostMedia[]
+  meta?: PostMeta
+  live_viewers?: number | null
+  is_quarantined?: boolean
+  published_site_names?: string[] | null
+}
+
+export interface PostWithPendingState extends Post {
+  _isPending?: boolean
+  _tempId?: string
+}
+
+export interface Comment extends BaseEntity {
+  body: string
+  post_id: string
+  author: PostAuthor
+  media?: PostMedia[]
+  parent_id?: string
+  thread_id?: string
+  depth?: number
+  reactions_count?: number
+  replies_count?: number
+  user_has_reacted?: boolean
+  user_reaction_type?: string
+  reactions?: Record<string, number>
+  replies?: Comment[]
+  is_hidden?: boolean
+}
+
+export interface Reaction {
+  id: string
+  user_id: string
+  target_id: string
+  target_type: 'post' | 'comment'
+  kind: string
+  created_at: string
+}
+
+export interface ThreadSummary {
+  id: string
+  space_id: string
+  slug: string
+  title: string
+  body?: string | null
+  reply_count: number
+  author_id: string
+  author?: {
+    id: string
+    name: string
+    handle?: string
+    avatar_url?: string | null
+    avatar?: unknown
+  } | null
+  created_at: string
+  tags?: Array<{
+    id: string
+    slug: string
+    label: string
+  }>
+}
+
+export interface AlbumSummary {
+  id: string
+  name: string
+  description?: string | null
+  media_count: number
+  owner: {
+    id: string
+    type: string
+    name?: string
+    avatar_url?: string | null
+  }
+  cover_media?: {
+    uuid: string
+    urls: {
+      thumb?: string
+      preview?: string
+      original?: string
+    }
+  } | null
+  created_at?: string | null
+}
+
+export interface FeedEntry {
+  id?: string
+  entity_id: string
+  entity_type: string
+  created_at?: string
+  activity_type?: string
+  actor_id?: string
+  owner_user_id?: string
+  visibility?: string
+  is_hidden?: boolean
+  post?: PostWithPendingState | null
+  thread?: ThreadSummary | null
+  album?: AlbumSummary | null
+  [key: string]: unknown
+}
+
+export interface ScheduledPostEntry {
+  id: string
+  status: string
+  publish_at: string
+  post_id: string | null
+  payload: Record<string, unknown> | string | null
+}
+
+export interface ScheduledPostsPage {
+  data: ScheduledPostEntry[]
+  meta: {
+    next_cursor: string | null
+  }
+}
+
+export type PendingPostStatus = 'pending' | 'uploading' | 'failed'
+
+export interface PendingVideoRender {
+  sourceMediaUuid: string
+  renderJobId: string | null
+}
+
+export interface PendingPost {
+  tempId: string
+  body: string
+  share_type?: PostShareType | undefined
+  quoted_post_id?: string | undefined
+  visibility: string
+  content_warning?: string | undefined
+  meta?: PostMeta | undefined
+  media_ids?: string[] | undefined
+  mediaItems?: LocalMediaItem[] | undefined
+  hadUnuploadedMedia?: boolean | undefined
+  container_type?: string | undefined
+  container_id?: string | undefined
+  pendingVideoRenders?: PendingVideoRender[] | undefined
+  status: PendingPostStatus
+  createdAt: string
+  retryCount: number
+  error?: string | undefined
+}
+
+export interface RecoverablePendingDraft {
+  tempId: string
+  body: string
+  visibility: string
+  contentWarning?: string
+}
+
+export type ProcessPendingPostResult =
+  | {
+      ok: true
+      postId: string
+      isQuarantined?: boolean
+    }
+  | {
+      ok: false
+      error: string
+      retryable: boolean
+    }
+
+export function isPost(obj: unknown): obj is Post {
+  return (
+    obj !== null
+    && typeof obj === 'object'
+    && 'id' in obj
+    && 'body' in obj
+    && 'author' in obj
+    && 'reactions_count' in obj
+    && 'comments_count' in obj
+  )
+}
+
+export function isComment(obj: unknown): obj is Comment {
+  return (
+    obj !== null
+    && typeof obj === 'object'
+    && 'id' in obj
+    && 'body' in obj
+    && 'post_id' in obj
+    && 'author' in obj
+  )
+}
+
+export type PostUpdate = Partial<Omit<Post, 'id' | 'created_at' | 'author' | 'author_id'>>
+export type CommentUpdate = Partial<Omit<Comment, 'id' | 'created_at' | 'author' | 'post_id'>>
+
+export interface PostResponse {
+  data: Post
+  meta?: Record<string, unknown>
+}
+
+export interface PostListResponse {
+  data: Post[]
+  meta?: {
+    total: number
+    per_page: number
+    current_page: number
+    next_cursor?: string
+  }
+}
+
+export interface CommentListResponse {
+  data: Comment[]
+  meta?: {
+    total: number
+    next_cursor?: string
+  }
+}
+
+export enum PostVisibility {
+  PUBLIC = 'public',
+  PRIVATE = 'private',
+  FRIENDS = 'friends'
+}
+
+export enum ReactionKind {
+  LIKE = 'like',
+  LOVE = 'love',
+  HAHA = 'haha',
+  WOW = 'wow',
+  SAD = 'sad',
+  ANGRY = 'angry'
+}
+
+export interface ContentActiveRecipeMeta {
+  id: string
+  name: string
+  icon: string | null
+  is_preset: boolean
+}
+
+export interface ContentCurrentUser {
+  id: string
+  name: string
+  handle?: string | null
+  avatar?: string | null
+}
+
+export interface ContentStoreStorage {
+  getItem(key: string): string | null
+  setItem(key: string, value: string): void
+  removeItem(key: string): void
+}
+
+export interface ContentMediaUploadService {
+  uploadLocalMediaItems(items: LocalMediaItem[]): Promise<string[]>
+}
+
+export interface ContentStoreLogger {
+  error: (...args: unknown[]) => void
+  warn: (...args: unknown[]) => void
+  info: (...args: unknown[]) => void
+}
+
+export interface ContentStoreConfig {
+  client: ApiService
+  mediaUploadService: ContentMediaUploadService
+  getCurrentUser: () => ContentCurrentUser | null
+  syncActiveRecipe?: (meta: ContentActiveRecipeMeta | null) => void
+  storage?: ContentStoreStorage | null
+  pageSize?: number
+  logger?: ContentStoreLogger
+  storeId?: string
+}

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
+}