memi-board 0.10.0 → 0.11.1

package/README.md

@@ -264,7 +264,9 @@ const router = useRouter()
 본문은 Nuxt UI **`UEditor`**(TipTap, `content-type="html"`). 호스트 `@nuxt/ui` 4.x 에 Editor 포함 필요.
 
 **에디터 이미지:** 툴바 / 붙여넣기 / 드롭 → Firebase Storage  
-`{prefix}/posts/{postId}/images/*` + `.../images/thumbnails/*` (원본+썸네일).  
+`{prefix}/posts/{postId}/images/*` + `.../images/thumbnails/*` (최적화 이미지+썸네일).
+
+본문 이미지는 휴대폰 원본 기준 최대 25MB까지 선택할 수 있다. 5MB를 넘으면 브라우저에서 최대 2560px·JPEG 85%로 최적화하고, 결과가 여전히 5MB를 넘으면 2048px·75%로 한 번 더 줄인 뒤 업로드한다. 5MB 이하 이미지는 원본을 유지한다.
 본문 HTML에는 원본 URL. 수정 중 버려진 파일은 호스트 스케줄러로 정리 (`extractEditorImageUrls` 로 본문 참조 비교).
 
 **composables:**  

package/dist/composables/useMemiBoardAuth.d.ts

@@ -22,6 +22,7 @@ export interface UseMemiBoardAuthReturn {
     signOut: () => Promise<void>;
     canEdit: (post: Pick<PostModel, 'authorUid'>) => boolean;
     canDelete: (post: Pick<PostModel, 'authorUid'>) => boolean;
+    canEditComment: (comment: Pick<CommentModel, 'authorUid'>) => boolean;
     canDeleteComment: (comment: Pick<CommentModel, 'authorUid'>) => boolean;
     /** 콘텐츠 검열 차단 1회 기록 후 메시지 조각 반환 */
     recordContentModerationBlock: () => Promise<{

package/dist/composables/useMemiBoardComments.d.ts

@@ -9,6 +9,7 @@ export interface AddCommentInput {
 export interface AddReplyInput extends AddCommentInput {
     parent: CommentModel;
 }
+export declare const COMMENT_BODY_MAX_LENGTH = 1000;
 /** 10개씩 순차 조회한 뒤 마지막 페이지에서만 최신 1개를 실시간 구독한다. */
 export declare function useMemiBoardComments(postId: string | Ref<string>, options?: {
     subscribe?: boolean;
@@ -20,6 +21,8 @@ export declare function useMemiBoardComments(postId: string | Ref<string>, optio
     loadMore: () => Promise<void>;
     addComment: (input: AddCommentInput) => Promise<void>;
     addReply: (input: AddReplyInput) => Promise<void>;
+    updateComment: (commentId: string, body: string) => Promise<void>;
+    setCommentBlinded: (commentId: string, isBlinded: boolean, moderatorUid: string) => Promise<void>;
     deleteComment: (comment: CommentModel) => Promise<void>;
 };
 /** 펼친 스레드의 답글을 5개씩 일회성 조회한다. */
@@ -46,6 +49,36 @@ export declare function useMemiBoardReplies(postId: string, rootId: string): {
             };
             valueOf: () => string;
         };
+        updatedAt?: {
+            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;
+        } | undefined;
+        isBlinded?: boolean | undefined;
+        moderatedAt?: {
+            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;
+        } | undefined;
+        moderatedBy?: string | undefined;
         parentId?: string | null | undefined;
         rootId?: string | undefined;
         depth?: number | undefined;
@@ -75,6 +108,36 @@ export declare function useMemiBoardReplies(postId: string, rootId: string): {
             };
             valueOf: () => string;
         };
+        updatedAt?: {
+            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;
+        } | undefined;
+        isBlinded?: boolean | undefined;
+        moderatedAt?: {
+            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;
+        } | undefined;
+        moderatedBy?: string | undefined;
         parentId?: string | null | undefined;
         rootId?: string | undefined;
         depth?: number | undefined;

package/dist/composables/useMemiBoardLikes.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 게시글 좋아요 상태 구독 + 토글.
+ * `{prefix}Posts/{postId}/likes/{uid}` 문서 존재 여부가 "좋아요함"의 기준이고,
+ * `likeCount`는 그 문서 수를 반영하는 클라이언트 편의 카운터일 뿐이다(commentCount와 동일한 성격).
+ * 토글은 배치가 아니라 트랜잭션으로 처리한다 — "있으면 취소, 없으면 추가"라는 read-then-branch라
+ * 다중 탭 경합 시에도 likeCount가 실제 likes 문서 수와 어긋나지 않게 하기 위함이다.
+ */
+export declare function useMemiBoardLikes(postId: string): {
+    isLiked: import('vue').Ref<boolean, boolean>;
+    likePending: import('vue').Ref<boolean, boolean>;
+    toggleLike: () => Promise<boolean>;
+};

package/dist/composables/useMemiBoardPosts.d.ts

@@ -1,3 +1,4 @@
+import { Ref } from 'vue';
 import { DocumentData, QueryDocumentSnapshot } from 'firebase/firestore';
 import { Attachment, PostDetail, PostModel } from '../types';
 export interface CreatePostInput {
@@ -43,3 +44,31 @@ export declare function useMemiBoardPosts(): {
     updatePost: (id: string, input: UpdatePostInput) => Promise<void>;
     deletePost: (id: string) => Promise<void>;
 };
+/**
+ * 최신 {pageSize}건은 onSnapshot으로 실시간 구독해 목록에 보이는 동안 좋아요·댓글 수가
+ * 바로 갱신되게 하고, 그 이전 글은 "더보기" 클릭 시 1회성 getDocs로 이어서 불러온다.
+ * 두 구간이 살짝 겹쳐도 id 기준으로 합쳐 중복 없이 렌더한다.
+ *
+ * 알려진 한계: "더보기"로 이전 글을 불러온 뒤 새 글이 pageSize개 이상 연달아 올라오면
+ * 실시간 구간과 페이지 구간 사이에 짧은 공백이 생길 수 있다 — 새로고침하면 바로 채워지고,
+ * 이 정도 트래픽 폭이면 실사용에서 발생 가능성이 낮아 별도 보정 로직은 두지 않았다.
+ */
+export declare function useMemiBoardPostList(category?: string | Ref<string | undefined>, options?: {
+    pageSize?: number;
+}): {
+    posts: import('vue').ComputedRef<PostModel[]>;
+    postsPending: Ref<boolean, boolean>;
+    hasMore: Ref<boolean, boolean>;
+    loadingMore: Ref<boolean, boolean>;
+    loadError: Ref<string, string>;
+    loadMore: () => Promise<void>;
+};
+/**
+ * 게시글 상세를 VueFire useDocument로 실시간 구독한다 (메타 + 본문).
+ * 좋아요·댓글 수 등 다른 사람의 변경이 화면에 바로 반영된다 — 좋아요 토글도
+ * 별도 로컬 낙관적 갱신 없이 이 구독이 그대로 반영해 준다.
+ */
+export declare function useMemiBoardPost(postId: string | Ref<string>): {
+    post: import('vue').ComputedRef<PostDetail | null>;
+    pending: import('vue').ComputedRef<boolean>;
+};

package/dist/composables/useMemiBoardStorage.d.ts

@@ -1,6 +1,8 @@
 import { Attachment, EditorImageEntry } from '../types';
 /** 에디터 이미지 최대 크기 (바이트) */
 export declare const EDITOR_IMAGE_MAX_BYTES: number;
+/** 휴대폰 원본 이미지 선택 허용 크기. 큰 이미지는 업로드 전에 최적화한다. */
+export declare const EDITOR_IMAGE_SOURCE_MAX_BYTES: number;
 export declare function useMemiBoardStorage(): {
     uploadAttachment: (file: File, postId: string, onProgress?: (ratio: number) => void) => {
         promise: Promise<Attachment>;

package/dist/index.d.ts

@@ -2,17 +2,18 @@
 export { configureMemiBoard, useMemiBoardConfig } from './config';
 export type { MemiBoardConfig, MemiBoardAuthOptions, MemiBoardModerationOptions } from './config';
 export { useMemiBoardAuth } from './composables/useMemiBoardAuth';
-export { useMemiBoardPosts } from './composables/useMemiBoardPosts';
+export { useMemiBoardPosts, useMemiBoardPostList, useMemiBoardPost } from './composables/useMemiBoardPosts';
 export type { CreatePostInput, UpdatePostInput } from './composables/useMemiBoardPosts';
-export { useMemiBoardComments, useMemiBoardReplies } from './composables/useMemiBoardComments';
+export { COMMENT_BODY_MAX_LENGTH, useMemiBoardComments, useMemiBoardReplies } from './composables/useMemiBoardComments';
 export type { AddCommentInput, AddReplyInput } from './composables/useMemiBoardComments';
+export { useMemiBoardLikes } from './composables/useMemiBoardLikes';
 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 { formatDate, formatFullDate, formatRelativeDate, formatTimestampDetails } 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, BoardUserModel, BoardCategory, BoardListView, BoardWriteRole, BoardSettingsModel, ModerationResult, } from './types';
@@ -20,4 +21,4 @@ export { compressImage } from './utils/compressImage';
 export { extractEditorImageUrls } from './utils/extractEditorImageUrls';
 export { renderMarkdownToHtml } from './utils/renderMarkdown';
 export { storagePathFromDownloadUrl, postNamespaceFromStoragePath } from './utils/storagePath';
-export { EDITOR_IMAGE_MAX_BYTES } from './composables/useMemiBoardStorage';
+export { EDITOR_IMAGE_MAX_BYTES, EDITOR_IMAGE_SOURCE_MAX_BYTES } from './composables/useMemiBoardStorage';