memi-board 0.11.1 → 0.18.0

package/dist/composables/useMemiBoardPosts.d.ts

@@ -21,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;
@@ -29,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;
@@ -54,7 +69,8 @@ export declare function useMemiBoardPosts(): {
  * 이 정도 트래픽 폭이면 실사용에서 발생 가능성이 낮아 별도 보정 로직은 두지 않았다.
  */
 export declare function useMemiBoardPostList(category?: string | Ref<string | undefined>, options?: {
-    pageSize?: number;
+    pageSize?: number; /** staff 등 숨김 글 포함 시 false. 기본 true */
+    publicOnly?: boolean | Ref<boolean>;
 }): {
     posts: import('vue').ComputedRef<PostModel[]>;
     postsPending: Ref<boolean, 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

@@ -3,10 +3,12 @@ export { configureMemiBoard, useMemiBoardConfig } from './config';
 export type { MemiBoardConfig, MemiBoardAuthOptions, MemiBoardModerationOptions } from './config';
 export { useMemiBoardAuth } from './composables/useMemiBoardAuth';
 export { useMemiBoardPosts, useMemiBoardPostList, useMemiBoardPost } from './composables/useMemiBoardPosts';
-export type { CreatePostInput, UpdatePostInput } 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';
@@ -16,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';