memi-board 0.5.0 → 0.9.0

package/README.md

@@ -222,7 +222,7 @@ const router = useRouter()
 ### 제공하는 API
 
 **컴포넌트 (auto-import):**  
-`MemiBoardList`, `MemiBoardDetail`, `MemiBoardEditor`, `MemiBoardCommentList`, `MemiBoardCommentForm`, `MemiBoardAttachments`, `MemiBoardSignIn`, `MemiBoardVersionHistory`
+`MemiBoardList`, `MemiBoardDetail`, `MemiBoardEditor`, `MemiBoardCommentList`, `MemiBoardCommentForm`, `MemiBoardAttachments`, `MemiBoardSignIn`, `MemiBoardSettings`, `MemiBoardUsers`, `MemiBoardVersionHistory`
 
 **List props:** `pageSize`, `category`, `postLinkBase`, `getPostLink(post)`, `linkBase`(deprecated)
 
@@ -234,13 +234,15 @@ const router = useRouter()
 본문 HTML에는 원본 URL. 수정 중 버려진 파일은 호스트 스케줄러로 정리 (`extractEditorImageUrls` 로 본문 참조 비교).
 
 **composables:**  
-`useMemiBoardAuth`, `useMemiBoardPosts`, `useMemiBoardComments`, `useMemiBoardStorage`, `useMemiBoardModeration`, `useMemiBoardSettings`
+`useMemiBoardAuth`, `useMemiBoardPosts`, `useMemiBoardComments`, `useMemiBoardStorage`, `useMemiBoardModeration`, `useMemiBoardSettings`, `useMemiBoardUsers`
+
+댓글은 시간순으로 10개씩 cursor 조회하며, 실제 `댓글 더보기` 버튼이 화면에 들어오면 1초 후 자동으로 다음 페이지를 읽는다. 기존 댓글을 모두 읽은 뒤에만 최신 댓글 1개를 실시간 구독한다. 대댓글은 5개씩 조회하고 모두 읽은 뒤 최신 답글 1개를 실시간 구독하며, 화면 깊이는 최대 2단계로 표시한다.
 
 ### 카테고리
 
-- 문서: `{prefix}Settings/config/categories/{categoryId}` → `{ label, listView, order, updatedAt }`
+- 문서: `{prefix}Settings/config/categories/{categoryId}` → `{ label, listView, writeRole, order, updatedAt }`
 - 설정이 없으면 빈 목록이며 기본 카테고리를 자동 생성하지 않음
-- `MemiBoardSettings`에서 관리자가 카테고리별 저장·삭제·순서·리스트뷰 관리
+- `MemiBoardSettings`에서 관리자가 카테고리별 저장·삭제·순서·리스트뷰·글쓰기 최소 역할 관리
 - `categoryId`는 문서 ID이자 게시글의 `category` 참조값이므로 생성 후 변경하지 않는 것을 권장
 
 ### 로그인 공급자
@@ -263,10 +265,11 @@ const router = useRouter()
 | 동작 | 조건 |
 |------|------|
 | 글/댓글 읽기 | 공개 |
-| 글/댓글 작성 | 로그인 + `moderationStatus == 'approved'` (클라가 항상 approved 로 씀 — 검열 통과 후에만 write) |
-| 글 수정·삭제 | 작성자 또는 `{prefix}Users/{uid}.role == 'admin'` |
-| 댓글 삭제 | 댓글 작성자 · 글 작성자 · admin |
-| 관리자 승격 | **패키지가 하지 않음** — 콘솔에서 `role: 'admin'` 수동 설정 |
+| 글 작성 | 로그인 + 카테고리 `writeRole` 충족 + `moderationStatus == 'approved'` |
+| 댓글 작성 | 로그인 + `moderationStatus == 'approved'` (클라가 항상 approved 로 씀 — 검열 통과 후에만 write) |
+| 글 수정·삭제 | 작성자 또는 `{prefix}Users/{uid}.role in ['admin', 'staff']` |
+| 댓글 삭제 | 댓글 작성자 · 글 작성자 · admin · staff |
+| 역할 관리 | `MemiBoardUsers`에서 admin이 `admin`·`staff`·`user` 변경 |
 
 **알려진 한계:** AI 검열은 클라이언트 전용. SDK로 직접 write 하면 우회 가능. 중요 서비스면 Cloud Functions 검증을 호스트가 추가(패키지 범위 밖).
 

package/dist/composables/useMemiBoardAuth.d.ts

@@ -6,6 +6,8 @@ export interface UseMemiBoardAuthReturn {
     user: ReturnType<typeof useCurrentUser>;
     isSignedIn: ComputedRef<boolean>;
     isAdmin: ComputedRef<boolean>;
+    isStaff: ComputedRef<boolean>;
+    canManageContent: ComputedRef<boolean>;
     rolePending: Ref<boolean>;
     /** 유효 검열 차단 누적 (lazy decay 반영) */
     moderationBlockCount: ComputedRef<number>;

package/dist/composables/useMemiBoardComments.d.ts

@@ -6,9 +6,86 @@ export interface AddCommentInput {
     authorName: string | null;
     authorPhoto: string | null;
 }
-/** postId 서브컬렉션 댓글을 실시간(onSnapshot)으로 구독하고, 작성/삭제 시 부모 글의 commentCount를 같은 batch로 증감한다. */
-export declare function useMemiBoardComments(postId: string | Ref<string>): {
-    comments: import('vuefire')._RefFirestore<import('vuefire').VueFirestoreQueryData<CommentModel>>;
+export interface AddReplyInput extends AddCommentInput {
+    parent: CommentModel;
+}
+/** 10개씩 순차 조회한 뒤 마지막 페이지에서만 최신 1개를 실시간 구독한다. */
+export declare function useMemiBoardComments(postId: string | Ref<string>, options?: {
+    subscribe?: boolean;
+}): {
+    comments: import('vue').ComputedRef<CommentModel[]>;
+    commentsPending: import('vue').ComputedRef<boolean>;
+    hasMore: Ref<boolean, boolean>;
+    loadingMore: Ref<boolean, boolean>;
+    loadMore: () => Promise<void>;
     addComment: (input: AddCommentInput) => Promise<void>;
-    deleteComment: (commentId: string) => Promise<void>;
+    addReply: (input: AddReplyInput) => Promise<void>;
+    deleteComment: (comment: CommentModel) => Promise<void>;
+};
+/** 펼친 스레드의 답글을 5개씩 일회성 조회한다. */
+export declare function useMemiBoardReplies(postId: string, rootId: string): {
+    replies: Ref<{
+        id?: string | undefined;
+        postId: string;
+        body: string;
+        authorUid: string;
+        authorName: string | null;
+        authorPhoto: string | null;
+        moderationStatus: import('..').ModerationStatus;
+        createdAt: {
+            readonly seconds: number;
+            readonly nanoseconds: number;
+            toDate: () => Date;
+            toMillis: () => number;
+            isEqual: (other: import('firebase/firestore').Timestamp) => boolean;
+            toString: () => string;
+            toJSON: () => {
+                seconds: number;
+                nanoseconds: number;
+                type: string;
+            };
+            valueOf: () => string;
+        };
+        parentId?: string | null | undefined;
+        rootId?: string | undefined;
+        depth?: number | undefined;
+        replyToUid?: string | null | undefined;
+        replyToName?: string | null | undefined;
+        replyCount?: number | undefined;
+        isReply?: boolean | undefined;
+    }[], CommentModel[] | {
+        id?: string | undefined;
+        postId: string;
+        body: string;
+        authorUid: string;
+        authorName: string | null;
+        authorPhoto: string | null;
+        moderationStatus: import('..').ModerationStatus;
+        createdAt: {
+            readonly seconds: number;
+            readonly nanoseconds: number;
+            toDate: () => Date;
+            toMillis: () => number;
+            isEqual: (other: import('firebase/firestore').Timestamp) => boolean;
+            toString: () => string;
+            toJSON: () => {
+                seconds: number;
+                nanoseconds: number;
+                type: string;
+            };
+            valueOf: () => string;
+        };
+        parentId?: string | null | undefined;
+        rootId?: string | undefined;
+        depth?: number | undefined;
+        replyToUid?: string | null | undefined;
+        replyToName?: string | null | undefined;
+        replyCount?: number | undefined;
+        isReply?: boolean | undefined;
+    }[]>;
+    loading: Ref<boolean, boolean>;
+    loaded: Ref<boolean, boolean>;
+    hasMore: Ref<boolean, boolean>;
+    loadMore: () => Promise<void>;
+    refresh: () => Promise<void>;
 };

package/dist/composables/useMemiBoardUsers.d.ts

@@ -0,0 +1,11 @@
+import { BoardUserModel, BoardUserRole } from '../types';
+export declare const BOARD_USER_ROLES: Array<{
+    value: BoardUserRole;
+    label: string;
+    description: string;
+}>;
+export declare function useMemiBoardUsers(): {
+    users: import('vuefire')._RefFirestore<import('vuefire').VueFirestoreQueryData<BoardUserModel>>;
+    usersPending: import('vue').Ref<boolean, boolean>;
+    updateUserRole: (uid: string, role: BoardUserRole) => Promise<void>;
+};

package/dist/index.d.ts

@@ -4,17 +4,18 @@ export type { MemiBoardConfig, MemiBoardAuthOptions, MemiBoardModerationOptions
 export { useMemiBoardAuth } from './composables/useMemiBoardAuth';
 export { useMemiBoardPosts } from './composables/useMemiBoardPosts';
 export type { CreatePostInput, UpdatePostInput } from './composables/useMemiBoardPosts';
-export { useMemiBoardComments } from './composables/useMemiBoardComments';
-export type { AddCommentInput } from './composables/useMemiBoardComments';
+export { useMemiBoardComments, useMemiBoardReplies } from './composables/useMemiBoardComments';
+export type { AddCommentInput, AddReplyInput } from './composables/useMemiBoardComments';
 export { useMemiBoardModeration } from './composables/useMemiBoardModeration';
 export { useMemiBoardStorage } from './composables/useMemiBoardStorage';
 export { useMemiBoardSettings, DEFAULT_CATEGORIES } from './composables/useMemiBoardSettings';
+export { useMemiBoardUsers, BOARD_USER_ROLES } from './composables/useMemiBoardUsers';
 export { versionHistory } from './data/versionHistory';
 export type { VersionHistoryEntry } from './data/versionHistory';
 export { formatDate } from './utils/formatDate';
 export { slugify } from './utils/slugify';
 export { DEFAULT_BLOCK_BAN_THRESHOLD, DEFAULT_BLOCK_BAN_DECAY_MS, effectiveModerationBlockCount, isModerationWriteRestricted, moderationWriteRestrictedUntilMs, formatRestrictedUntilLabel, } from './utils/moderation-strike';
-export type { Attachment, EditorImageEntry, ModerationStatus, PostModel, PostDetail, CommentModel, BoardUserRole, BoardCategory, BoardListView, BoardSettingsModel, ModerationResult, } from './types';
+export type { Attachment, EditorImageEntry, ModerationStatus, PostModel, PostDetail, CommentModel, BoardUserRole, BoardUserModel, BoardCategory, BoardListView, BoardWriteRole, BoardSettingsModel, ModerationResult, } from './types';
 export { compressImage } from './utils/compressImage';
 export { extractEditorImageUrls } from './utils/extractEditorImageUrls';
 export { renderMarkdownToHtml } from './utils/renderMarkdown';