@codingfactory/socialkit-vue 0.5.2 → 0.6.0

package/src/stores/discussion.ts

@@ -68,6 +68,25 @@ interface LocalReactionEchoMarker {
   expiresAt: number
 }
 
+interface DiscussionCreateThreadResponse {
+  data?: Thread
+}
+
+interface DiscussionCreateReplyResponse {
+  data?: Reply
+}
+
+interface DiscussionDraftPayload {
+  title?: string | null
+  content?: string
+  metadata?: Record<string, unknown>
+  [key: string]: unknown
+}
+
+interface DiscussionSaveDraftResponse {
+  data?: DiscussionDraftPayload
+}
+
 type UnknownRecord = Record<string, unknown>
 
 function isRecord(value: unknown): value is UnknownRecord {
@@ -979,13 +998,16 @@ export function createDiscussionStoreDefinition(config: DiscussionStoreConfig) {
       }
     }
 
-    async function createThread(spaceSlug: string, input: CreateThreadInput): Promise<unknown> {
+    async function createThread(
+      spaceSlug: string,
+      input: CreateThreadInput
+    ): Promise<DiscussionCreateThreadResponse> {
       cleanupRealtimeChannels()
       loading.value = true
       error.value = null
 
       try {
-        const response = await client.post<unknown>(`/v1/discussion/spaces/${spaceSlug}/threads`, {
+        const response = await client.post<DiscussionCreateThreadResponse>(`/v1/discussion/spaces/${spaceSlug}/threads`, {
           title: input.title,
           body: input.body,
           audience: input.audience || 'public',
@@ -1107,11 +1129,14 @@ export function createDiscussionStoreDefinition(config: DiscussionStoreConfig) {
       return err.message === 'Network Error' && !err.response
     }
 
-    async function createReply(threadId: string, input: CreateReplyInput): Promise<unknown> {
+    async function createReply(
+      threadId: string,
+      input: CreateReplyInput
+    ): Promise<DiscussionCreateReplyResponse> {
       pendingReplyCreations.set(threadId, (pendingReplyCreations.get(threadId) ?? 0) + 1)
 
       try {
-        const response = await client.post<unknown>(`/v1/discussion/threads/${threadId}/replies`, {
+        const response = await client.post<DiscussionCreateReplyResponse>(`/v1/discussion/threads/${threadId}/replies`, {
           body: input.body,
           parent_reply_id: input.parent_id,
           ...(input.quoted_reply_id ? { quoted_reply_id: input.quoted_reply_id } : {}),
@@ -2093,9 +2118,9 @@ export function createDiscussionStoreDefinition(config: DiscussionStoreConfig) {
       id: string,
       content: string,
       options?: SaveDraftOptions
-    ): Promise<unknown> {
+    ): Promise<DiscussionSaveDraftResponse> {
       try {
-        const response = await client.post<unknown>('/v1/editor/drafts/save', {
+        const response = await client.post<DiscussionSaveDraftResponse>('/v1/editor/drafts/save', {
           type,
           id,
           title: options?.title,
@@ -2110,13 +2135,14 @@ export function createDiscussionStoreDefinition(config: DiscussionStoreConfig) {
       }
     }
 
-    async function getDraft(type: string, id: string): Promise<unknown> {
+    async function getDraft(type: string, id: string): Promise<DiscussionDraftPayload | null> {
       try {
         const response = await client.get<unknown>('/v1/editor/drafts/check', {
           params: { type, id },
         })
         const responseData = toRecord(response.data)
-        return responseData?.data ?? null
+        const draftData = toRecord(responseData?.data)
+        return draftData as DiscussionDraftPayload | null
       } catch (draftError) {
         if (isAxiosError(draftError) && draftError.response?.status === 404) {
           return null

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/media.ts

@@ -0,0 +1,81 @@
+/**
+ * Core type definitions for media.
+ */
+
+export interface MediaItem {
+  id: string
+  type: 'image' | 'video' | 'document'
+  url: string
+  thumbnail_url?: string
+  alt_text?: string
+  width?: number
+  height?: number
+  size?: number
+  mime_type?: string
+  created_at?: string
+  updated_at?: string
+}
+
+export function isMediaItem(obj: unknown): obj is MediaItem {
+  return (
+    obj !== null
+    && typeof obj === 'object'
+    && 'id' in obj
+    && 'type' in obj
+    && 'url' in obj
+    && typeof (obj as MediaItem).type === 'string'
+    && ['image', 'video', 'document'].includes((obj as MediaItem).type)
+  )
+}
+
+export interface UploadedMedia {
+  id: string
+  url: string
+  thumb_url?: string | null
+  preview_url?: string | null
+  mime_type: string
+  size: number
+  urls?: {
+    original?: string
+    thumbnail?: string
+    preview?: string
+  }
+  original_url?: string
+}
+
+export interface LocalMediaItem {
+  id?: string
+  previewUrl: string
+  file?: File
+  mimeType: string
+  name: string
+  size: number
+  status: 'pending' | 'uploading' | 'uploaded' | 'failed'
+  error?: string
+}
+
+export interface FilterConfig {
+  name: string
+  type: string
+  value: number | string
+  timestamp?: number
+}
+
+export type ImageEditorContext = 'profile' | 'editor' | 'gallery'
+export type ImageFormat = 'jpeg' | 'png' | 'webp'
+
+export interface ImageEditorSaveData {
+  imageData: Blob
+  filters: FilterConfig[]
+  metadata: ImageEditorMetadata
+}
+
+export interface ImageEditorMetadata {
+  originalUrl: string
+  context: string
+  appliedFilters: FilterConfig[]
+  processingTime: number
+}
+
+export type MediaType = MediaItem['type']
+export type MediaUpdate = Partial<Omit<MediaItem, 'id' | 'created_at'>>