memi-board 0.32.0 → 0.37.0

package/README.md

@@ -221,6 +221,7 @@ const { post: postSeo } = await useMemiBoardPostSeo({
 - [ ] 목록·상세 페이지에 `await useMemiBoard*Seo(…)` 한 줄
 - [ ] 호스트 SEO API **만들지 않음**
 - [ ] CSS `@source` (아래)
+- [ ] (선택) 읽은 글 표시 CSS (아래)
 - [ ] Rules·indexes **deploy**
 - [ ] 최초 admin + 첫 카테고리
 
@@ -235,7 +236,20 @@ const { post: postSeo } = await useMemiBoardPostSeo({
 @source "../../../node_modules/memi-board/dist/runtime/components";
 ```
 
-### 5. Security Rules + 인덱스 배포
+### 5. 읽은 글 표시 (선택)
+
+목록·미니 컴포넌트의 글 링크는 `.memi-board-post-link` 클래스가 붙어 있고, 제목 텍스트는 `text-inherit`로 링크 색을 따른다. 패키지는 색을 강제하지 않으므로, 방문한 글을 흐리게 보이고 싶으면 호스트 CSS에 `:visited` 스타일만 추가하면 된다.
+
+```css
+/* app/assets/css/main.css */
+.memi-board-post-link:visited {
+  color: var(--ui-text-muted);
+}
+```
+
+브라우저 네이티브 `:visited` 라서 서버·DB 저장이 필요 없다. 단, SPA 클라이언트 라우팅(`NuxtLink`)으로만 이동한 경우 브라우저에 "실제 방문"으로 기록되지 않을 수 있어 완전히 신뢰할 수는 없다 — 정확한 읽음 추적이 필요하면 별도로 방문 글 ID를 저장하는 방식을 구현해야 한다.
+
+### 6. Security Rules + 인덱스 배포
 
 1. [docs/firestore.rules.example](docs/firestore.rules.example) → 호스트 `firestore.rules`에 병합  
    (`memiBoardPosts`/`memiBoardComments`/`memiBoardLikes`/`memiBoardSettings`/`memiBoardUsers` — 전부 최상위 flat 컬렉션)
@@ -257,7 +271,7 @@ const { post: postSeo } = await useMemiBoardPostSeo({
 
 > ⚠️ npm 패키지 tarball에도 `docs/` 가 포함된다(0.4.7+). 구버전이면 GitHub의 `docs/`를 보면 된다.
 
-### 6. 최초 관리자와 카테고리 만들기
+### 7. 최초 관리자와 카테고리 만들기
 
 Rules는 일반 사용자가 스스로 관리자가 되는 것을 막는다. 따라서 최초 한 번은 다음 순서가 필요하다.
 
@@ -493,6 +507,7 @@ export default defineNuxtPlugin(() => {
 - [ ] 목록·상세 페이지에 `await useMemiBoardListSeo` / `useMemiBoardPostSeo`
 - [ ] 호스트 SEO API 없음
 - [ ] CSS `@source` …/memi-board/dist/runtime/components
+- [ ] (선택) `.memi-board-post-link:visited` 읽은 글 표시 CSS
 - [ ] Rules 예시 병합 + **deploy**
 - [ ] 카테고리·listed 쿼리 사용 시 indexes deploy
 - [ ] 페이지·미들웨어 직접 작성 (또는 playground 복사)

package/dist/composables/boardLookup.d.ts

@@ -0,0 +1,8 @@
+type BoardLookup = (boardId: string) => {
+    allowedStaffUids?: string[];
+} | undefined;
+export declare function registerBoardLookup(fn: BoardLookup): void;
+export declare function resolveBoardLookup(boardId: string): {
+    allowedStaffUids?: string[];
+} | undefined;
+export {};

package/dist/composables/useMemiBoardAuth.d.ts

@@ -8,6 +8,7 @@ export interface UseMemiBoardAuthReturn {
     isAdmin: ComputedRef<boolean>;
     isStaff: ComputedRef<boolean>;
     canManageContent: ComputedRef<boolean>;
+    canManageBoard: (boardId: string | undefined | null) => boolean;
     rolePending: Ref<boolean>;
     /** 유효 검열 차단 누적 (lazy decay 반영) */
     moderationBlockCount: ComputedRef<number>;
@@ -20,10 +21,10 @@ export interface UseMemiBoardAuthReturn {
     signInWithEmail: (email: string, password: string) => ReturnType<typeof signInWithEmailAndPassword>;
     signUpWithEmail: (email: string, password: string, displayName?: string) => ReturnType<typeof createUserWithEmailAndPassword>;
     signOut: () => Promise<void>;
-    canEdit: (post: Pick<PostModel, 'authorUid'>) => boolean;
-    canDelete: (post: Pick<PostModel, 'authorUid'>) => boolean;
+    canEdit: (post: Pick<PostModel, 'authorUid' | 'boardId'>) => boolean;
+    canDelete: (post: Pick<PostModel, 'authorUid' | 'boardId'>) => boolean;
     canEditComment: (comment: Pick<CommentModel, 'authorUid'>) => boolean;
-    canDeleteComment: (comment: Pick<CommentModel, 'authorUid'>) => boolean;
+    canDeleteComment: (comment: Pick<CommentModel, 'authorUid' | 'boardId'>) => boolean;
     /** 콘텐츠 검열 차단 1회 기록 후 메시지 조각 반환 */
     recordContentModerationBlock: () => Promise<{
         effectiveCount: number;

package/dist/composables/useMemiBoardCommentFeed.d.ts

@@ -0,0 +1,18 @@
+import { MaybeRefOrGetter } from 'vue';
+import { CommentModel } from '../types';
+export type CommentFeedSort = 'latest' | 'likes';
+/**
+ * 보드를 가로질러 댓글을 모은다. 최신순은 createdAt, 좋아요순은 likeCount.
+ * likeCount 가 없는 예전 댓글은 좋아요순 쿼리에 나오지 않는다(표시 시 0).
+ */
+export declare function useMemiBoardCommentFeed(sort?: MaybeRefOrGetter<CommentFeedSort>, options?: {
+    pageSize?: MaybeRefOrGetter<number>;
+}): {
+    comments: import('vue').ComputedRef<CommentModel[]>;
+    commentsPending: import('vue').Ref<boolean, boolean>;
+    hasMore: import('vue').Ref<boolean, boolean>;
+    loadingMore: import('vue').Ref<boolean, boolean>;
+    loadError: import('vue').Ref<string, string>;
+    loadMore: () => Promise<void>;
+    sort: import('vue').ComputedRef<CommentFeedSort>;
+};

package/dist/composables/useMemiBoardComments.d.ts

@@ -90,6 +90,7 @@ export declare function useMemiBoardReplies(boardId: string, postId: string, roo
         replyToName?: string | null | undefined;
         replyCount?: number | undefined;
         isReply?: boolean | undefined;
+        likeCount?: number | undefined;
     }[], CommentModel[] | {
         id?: string | undefined;
         postId: string;
@@ -150,6 +151,7 @@ export declare function useMemiBoardReplies(boardId: string, postId: string, roo
         replyToName?: string | null | undefined;
         replyCount?: number | undefined;
         isReply?: boolean | undefined;
+        likeCount?: number | undefined;
     }[]>;
     loading: Ref<boolean, boolean>;
     loaded: Ref<boolean, boolean>;

package/dist/composables/useMemiBoardLikes.d.ts

@@ -1,5 +1,14 @@
+import { InjectionKey, MaybeRefOrGetter } from 'vue';
 export declare function useMemiBoardLikes(boardId: string, postId: string): {
     isLiked: import('vue').Ref<boolean, boolean>;
     likePending: import('vue').Ref<boolean, boolean>;
     toggleLike: () => Promise<boolean>;
 };
+export interface MemiBoardCommentLikesApi {
+    isLiked: (commentId: string | undefined) => boolean;
+    isPending: (commentId: string | undefined) => boolean;
+    toggleLike: (commentId: string) => Promise<boolean>;
+}
+export declare const memiBoardCommentLikesKey: InjectionKey<MemiBoardCommentLikesApi>;
+/** 글 하나에서 내가 누른 댓글 좋아요를 쿼리 1번으로 구독한다. 댓글마다 리스너를 달지 않는다. */
+export declare function useMemiBoardCommentLikes(boardId: MaybeRefOrGetter<string>, postId: MaybeRefOrGetter<string>): MemiBoardCommentLikesApi;

package/dist/composables/useMemiBoardMiniPosts.d.ts

@@ -0,0 +1,12 @@
+import { MaybeRefOrGetter } from 'vue';
+import { PostModel } from '../types';
+export declare function useMemiBoardMiniLatest(boardId: MaybeRefOrGetter<string | null>, count: MaybeRefOrGetter<number>): {
+    posts: import('vue').ComputedRef<import('vuefire').VueFirestoreQueryData<PostModel>>;
+    pending: import('vue').Ref<boolean, boolean>;
+    error: import('vue').Ref<import('firebase/firestore').FirestoreError | undefined, import('firebase/firestore').FirestoreError | undefined>;
+};
+export declare function useMemiBoardMiniPicked(postIds: MaybeRefOrGetter<string[]>): {
+    posts: import('vue').ComputedRef<PostModel[]>;
+    pending: import('vue').Ref<boolean, boolean>;
+    error: import('vue').Ref<import('firebase/firestore').FirestoreError | undefined, import('firebase/firestore').FirestoreError | undefined>;
+};

package/dist/composables/useMemiBoardReports.d.ts

@@ -0,0 +1,114 @@
+import { MaybeRefOrGetter } from 'vue';
+import { BoardReportModel, BoardReportReason, BoardReportStatus } from '../types';
+export declare const REPORT_DETAIL_MAX_LENGTH = 200;
+export declare const REPORT_REASONS: {
+    value: BoardReportReason;
+    label: string;
+}[];
+export declare function reportReasonLabel(reason: BoardReportReason | string | undefined): string;
+export declare function useMemiBoardReports(boardId: string, postId: string): {
+    hasReported: import('vue').Ref<boolean, boolean>;
+    pending: import('vue').Ref<boolean, boolean>;
+    submitReport: (input: {
+        reason: BoardReportReason;
+        detail?: string;
+        postTitle?: string;
+        authorUid?: string;
+        authorName?: string | null;
+    }) => Promise<void>;
+};
+export declare function useMemiBoardReportQueue(options?: {
+    pageSize?: number;
+    boardId?: MaybeRefOrGetter<string>;
+}): {
+    reports: import('vue').Ref<{
+        id?: string | undefined;
+        uid: string;
+        target: import('..').BoardReportTarget;
+        postId: string;
+        boardId: string;
+        reason: BoardReportReason;
+        detail: string;
+        status: BoardReportStatus;
+        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;
+        };
+        postTitle?: string | undefined;
+        authorUid?: string | undefined;
+        authorName?: string | null | undefined;
+        reviewedAt?: {
+            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;
+        reviewedBy?: string | undefined;
+    }[], BoardReportModel[] | {
+        id?: string | undefined;
+        uid: string;
+        target: import('..').BoardReportTarget;
+        postId: string;
+        boardId: string;
+        reason: BoardReportReason;
+        detail: string;
+        status: BoardReportStatus;
+        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;
+        };
+        postTitle?: string | undefined;
+        authorUid?: string | undefined;
+        authorName?: string | null | undefined;
+        reviewedAt?: {
+            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;
+        reviewedBy?: string | undefined;
+    }[]>;
+    pending: import('vue').Ref<boolean, boolean>;
+    loadingMore: import('vue').Ref<boolean, boolean>;
+    hasMore: import('vue').Ref<boolean, boolean>;
+    loadError: import('vue').Ref<string, string>;
+    loadMore: () => Promise<void>;
+    dismissReport: (report: BoardReportModel) => Promise<void>;
+    actionReport: (report: BoardReportModel) => Promise<void>;
+};

package/dist/composables/useMemiBoardSections.d.ts

@@ -0,0 +1,13 @@
+import { BoardSection, BoardSectionLayout } from '../types';
+export declare const DEFAULT_BOARD_SECTIONS: BoardSection[];
+export declare function normalizeBoardSection(raw: Record<string, unknown>, order: number): BoardSection;
+/** 호스트 `settings/homeLayout` 문서를 읽는다. 기존 메인 레이아웃 경로를 유지한다. */
+export declare function useMemiBoardSections(): {
+    settings: import('vue').Ref<import('vuefire').VueFirestoreDocumentData<BoardSectionLayout> | undefined, import('vuefire').VueFirestoreDocumentData<BoardSectionLayout> | undefined>;
+    pending: import('vue').Ref<boolean, boolean>;
+    sections: import('vue').ComputedRef<BoardSection[]>;
+    blocks: import('vue').ComputedRef<BoardSection[]>;
+    hasSavedLayout: import('vue').ComputedRef<boolean>;
+    saveSections: (next: BoardSection[]) => Promise<void>;
+    saveBlocks: (next: BoardSection[]) => Promise<void>;
+};

package/dist/composables/useMemiBoardSettings.d.ts

@@ -16,6 +16,8 @@ export declare function useMemiBoardSettings(): {
     boardVisibility: (id: string | undefined) => BoardVisibility;
     isBoardHidden: (id: string | undefined) => boolean;
     getBoard: (id: string | undefined) => BoardModel | undefined;
+    canManageBoard: (boardId: string | undefined | null) => boolean;
+    managedBoards: import('vue').ComputedRef<BoardModel[]>;
     categories: import('vue').ComputedRef<BoardModel[]>;
     publicCategories: import('vue').ComputedRef<BoardModel[]>;
     categoryLabel: (id: string | undefined) => string | undefined;

package/dist/config.d.ts

@@ -30,6 +30,8 @@ export interface MemiBoardConfig {
     commentsCollection: string;
     /** 좋아요 컬렉션. 기본 `memiBoardLikes` */
     likesCollection: string;
+    /** 신고 컬렉션. 기본 `memiBoardReports` */
+    reportsCollection: string;
     /** 보드 설정 컬렉션. 기본 `memiBoardSettings` */
     settingsCollection: string;
     /** 역할 문서 컬렉션. 기본 `memiBoardUsers` */

package/dist/{heic2any-BWRKffWN.js → heic2any-D2QKy06h.js}

@@ -1,4 +1,4 @@
-import { O as e } from "./slugify-B5XHr4SZ.js";
+import { M as e } from "./slugify-Cyq-Gg8X.js";
 //#region node_modules/.pnpm/heic2any@0.0.4/node_modules/heic2any/dist/heic2any.js
 var t = /* @__PURE__ */ e(((e, t) => {
 	(function(n, r, i, a) {
@@ -974,4 +974,4 @@ var t = /* @__PURE__ */ e(((e, t) => {
 //#endregion
 export default t();
 
-//# sourceMappingURL=heic2any-BWRKffWN.js.map
+//# sourceMappingURL=heic2any-D2QKy06h.js.map