memi-board 0.10.1 → 0.18.0

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 {
@@ -20,6 +21,19 @@ export interface UpdatePostInput {
     category?: string;
     attachments?: Attachment[];
 }
+/** getPostBySlug 결과 — not-found 와 permission-denied 를 UI 에서 구분한다. */
+export type GetPostBySlugResult = {
+    status: 'ok';
+    post: PostDetail;
+} | {
+    status: 'not-found';
+} | {
+    status: 'permission-denied';
+} | {
+    status: 'error';
+    message: string;
+};
+export declare function isFirestorePermissionDenied(error: unknown): boolean;
 /** 목록 조회는 posts/{id} 메타만 읽고, 본문(body/main)은 상세 조회 시에만 읽는다. */
 export declare function useMemiBoardPosts(): {
     createPostId: () => string;
@@ -28,13 +42,15 @@ export declare function useMemiBoardPosts(): {
         cursor?: QueryDocumentSnapshot<DocumentData>;
         /** 지정 시 해당 카테고리 글만 (boardSettings 의 category id) */
         category?: string;
+        /** true 면 listed==true 만 (비권한 목록). staff 전체 보기는 false */
+        publicOnly?: boolean;
     }) => Promise<{
         posts: PostModel[];
         cursor: QueryDocumentSnapshot<DocumentData> | undefined;
         hasMore: boolean;
     }>;
     getPost: (id: string) => Promise<PostDetail | null>;
-    getPostBySlug: (category: string, slug: string) => Promise<PostDetail | null>;
+    getPostBySlug: (category: string, slug: string) => Promise<GetPostBySlugResult>;
     getAdjacentPosts: (current: PostModel) => Promise<{
         previous: PostModel | null;
         next: PostModel | null;
@@ -43,3 +59,32 @@ 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; /** staff 등 숨김 글 포함 시 false. 기본 true */
+    publicOnly?: boolean | Ref<boolean>;
+}): {
+    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/useMemiBoardSettings.d.ts

@@ -1,10 +1,14 @@
-import { BoardCategory } from '../types';
+import { BoardCategory, BoardVisibility } from '../types';
 /** 필요할 때 호스트가 명시적으로 사용할 수 있는 예시 카테고리. 자동 적용하지 않는다. */
 export declare const DEFAULT_CATEGORIES: BoardCategory[];
 /** 게시판 카테고리 — `{prefix}Settings/config/categories/{categoryId}` 개별 문서. */
 export declare function useMemiBoardSettings(): {
     categories: import('vue').ComputedRef<BoardCategory[]>;
+    publicCategories: import('vue').ComputedRef<BoardCategory[]>;
     categoryLabel: (id: string | undefined) => string | undefined;
+    categoryDescription: (id: string | undefined) => string | undefined;
+    categoryVisibility: (id: string | undefined) => BoardVisibility;
+    isCategoryHidden: (id: string | undefined) => boolean;
     settingsPending: import('vue').Ref<boolean, boolean>;
     ensureSettings: () => Promise<void>;
     addCategory: (label: string) => Promise<string>;

package/dist/composables/useMemiBoardUsers.d.ts

@@ -1,10 +1,18 @@
+import { MaybeRefOrGetter } from 'vue';
 import { BoardUserModel, BoardUserRole } from '../types';
 export declare const BOARD_USER_ROLES: Array<{
     value: BoardUserRole;
     label: string;
     description: string;
 }>;
-export declare function useMemiBoardUsers(): {
+/**
+ * 전체 사용자 목록은 관리자만 읽을 수 있다(rules). enabled가 false인 동안은
+ * 쿼리 자체를 시작하지 않는다 — 그냥 호출만 하면 권한 확인 전에 구독이 걸려서
+ * 관리자가 아니거나 아직 role을 확인 중일 때 permission-denied로 화면이 죽는다.
+ */
+export declare function useMemiBoardUsers(options?: {
+    enabled?: MaybeRefOrGetter<boolean>;
+}): {
     users: import('vuefire')._RefFirestore<import('vuefire').VueFirestoreQueryData<BoardUserModel>>;
     usersPending: import('vue').Ref<boolean, boolean>;
     updateUserRole: (uid: string, role: BoardUserRole) => Promise<void>;

package/dist/composables/useMemiBoardViews.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 게시글 조회수.
+ *
+ * - 로그인 불필요: rules 가 viewCount +1 만 허용하면 익명도 증가 가능.
+ * - 신뢰 수준은 likeCount/commentCount 와 같은 클라이언트 편의 카운터.
+ * - 같은 브라우저·세션에서 같은 글을 반복 열어 폭증하지 않도록 sessionStorage 로 1회만 기록.
+ */
+export declare function useMemiBoardViews(): {
+    recordView: (postId: string) => Promise<void>;
+    hasRecordedView: (postId: string) => boolean;
+};

package/dist/index.d.ts

@@ -2,10 +2,13 @@
 export { configureMemiBoard, useMemiBoardConfig } from './config';
 export type { MemiBoardConfig, MemiBoardAuthOptions, MemiBoardModerationOptions } from './config';
 export { useMemiBoardAuth } from './composables/useMemiBoardAuth';
-export { useMemiBoardPosts } from './composables/useMemiBoardPosts';
-export type { CreatePostInput, UpdatePostInput } from './composables/useMemiBoardPosts';
+export { useMemiBoardPosts, useMemiBoardPostList, useMemiBoardPost } from './composables/useMemiBoardPosts';
+export type { CreatePostInput, UpdatePostInput, GetPostBySlugResult } from './composables/useMemiBoardPosts';
+export { isFirestorePermissionDenied } from './composables/useMemiBoardPosts';
 export { COMMENT_BODY_MAX_LENGTH, useMemiBoardComments, useMemiBoardReplies } from './composables/useMemiBoardComments';
 export type { AddCommentInput, AddReplyInput } from './composables/useMemiBoardComments';
+export { useMemiBoardLikes } from './composables/useMemiBoardLikes';
+export { useMemiBoardViews } from './composables/useMemiBoardViews';
 export { useMemiBoardModeration } from './composables/useMemiBoardModeration';
 export { useMemiBoardStorage } from './composables/useMemiBoardStorage';
 export { useMemiBoardSettings, DEFAULT_CATEGORIES } from './composables/useMemiBoardSettings';
@@ -15,9 +18,10 @@ export type { VersionHistoryEntry } from './data/versionHistory';
 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';
+export type { Attachment, EditorImageEntry, ModerationStatus, PostModel, PostDetail, CommentModel, BoardUserRole, BoardUserModel, BoardCategory, BoardListView, BoardWriteRole, BoardVisibility, BoardSettingsModel, ModerationResult, } from './types';
 export { compressImage } from './utils/compressImage';
 export { extractEditorImageUrls } from './utils/extractEditorImageUrls';
 export { renderMarkdownToHtml } from './utils/renderMarkdown';
+export { buildPostPreview, youtubeId, videoListCoverUrl } from './utils/postPreview';
 export { storagePathFromDownloadUrl, postNamespaceFromStoragePath } from './utils/storagePath';
 export { EDITOR_IMAGE_MAX_BYTES, EDITOR_IMAGE_SOURCE_MAX_BYTES } from './composables/useMemiBoardStorage';