memi-board 0.19.3 → 0.21.0

package/README.md

@@ -10,7 +10,7 @@ Nuxt 4 + Nuxt UI + Firebase 프로젝트에 게시판을 붙이는 npm 패키지
 **서버 / Firebase Admin 불필요** (권한은 Rules, 검열은 브라우저 — 우회 가능, 아래 한계 참고).  
 공개 목록·글 상세만 SSR로 OG를 채우고, 쓰기·설정은 CSR로 두면 된다.
 
-같은 스택(Nuxt 4 · `@nuxt/ui` · `nuxt-vuefire` · Firebase)이면 **다른 호스트 앱에도 그대로 재사용** 가능하다. Firebase 프로젝트는 호스트마다 달라도 되고, 같은 프로젝트를 공유해도 `collectionPrefix`로 컬렉션만 나누면 된다.
+같은 스택(Nuxt 4 · `@nuxt/ui` · `nuxt-vuefire` · Firebase)이면 **다른 호스트 앱에도 그대로 재사용** 가능하다. Firebase 프로젝트는 호스트마다 달라도 되고, 같은 프로젝트에서는 `boardId`로 게시판 인스턴스를 나눈다 (`memiBoards/{boardId}/…`).
 
 ## 플랫폼 요구사항
 
@@ -71,8 +71,9 @@ export default defineNuxtConfig({
   ],
 
   memiBoard: {
-    // Firestore: {prefix}Posts, {prefix}Users, {prefix}Settings
-    collectionPrefix: 'board',
+    // Firestore: memiBoards/{boardId}/posts|settings|users
+    boardsCollection: 'memiBoards', // 기본값
+    boardId: 'main',                // 게시판 인스턴스 ID (필수에 가깝다)
     auth: { providers: ['google', 'apple'] }, // + 'emailPassword'
     moderation: {
       enabled: true,
@@ -134,7 +135,8 @@ export default defineNuxtConfig({
 
 | 키 | 기본 | 설명 |
 |----|------|------|
-| `collectionPrefix` | `'memiBoard'` | Firestore/Storage 접두 (`board` → `boardPosts` …) |
+| `boardsCollection` | `'memiBoards'` | 루트 컬렉션 이름 |
+| `boardId` | `'default'` | `memiBoards/{boardId}/…` 게시판 문서 ID |
 | `auth.providers` | `['google','apple']` | 로그인 공급자 |
 | `moderation.*` | (아래 AI 절) | 로컬·Gemini 검열 |
 | `seo.enabled` | `true` | `false`면 SEO composable no-op |
@@ -211,7 +213,7 @@ const { post: postSeo } = await useMemiBoardPostSeo({
 ### 3. 부모 설정 체크리스트
 
 - [ ] `modules`에 `@nuxt/ui`, `nuxt-vuefire`, `memi-board`
-- [ ] `memiBoard.collectionPrefix` · `auth` · `moderation` · **`seo`**
+- [ ] `memiBoard.boardId` · `auth` · `moderation` · **`seo`**
 - [ ] `seo.siteUrl` / `seo.siteName` / `seo.defaultOgImage` / `seo.basePath`
 - [ ] 공개 board 경로 **SSR on**, 쓰기·설정만 `ssr: false`
 - [ ] 목록·상세 페이지에 `await useMemiBoard*Seo(…)` 한 줄
@@ -234,7 +236,7 @@ const { post: postSeo } = await useMemiBoardPostSeo({
 ### 5. Security Rules + 인덱스 배포
 
 1. [docs/firestore.rules.example](docs/firestore.rules.example) → 호스트 `firestore.rules`에 병합  
-   (`memiBoard*` 이름을 쓰는 `collectionPrefix`에 맞게 치환)
+   (`memiBoards/{boardId}/…` 경로 — boardId 는 호스트 설정과 동일)
 2. [docs/storage.rules.example](docs/storage.rules.example) → `storage.rules` 병합
 3. 카테고리 필터 목록을 쓰면 복합 인덱스 필요 (아래)
 4. 배포:
@@ -252,7 +254,7 @@ const { post: postSeo } = await useMemiBoardPostSeo({
 {
   "indexes": [
     {
-      "collectionGroup": "boardPosts",
+      "collectionGroup": "posts",
       "queryScope": "COLLECTION",
       "fields": [
         { "fieldPath": "category", "order": "ASCENDING" },
@@ -270,9 +272,9 @@ const { post: postSeo } = await useMemiBoardPostSeo({
 Rules는 일반 사용자가 스스로 관리자가 되는 것을 막는다. 따라서 최초 한 번은 다음 순서가 필요하다.
 
 1. 아래 게시판 페이지를 만든 뒤 Google 또는 Apple로 로그인한다.
-2. Firebase Console → Firestore에서 `{prefix}Users/{uid}` 문서를 찾는다.
+2. Firebase Console → Firestore에서 `memiBoards/{boardId}/users/{uid}` 문서를 찾는다.
 3. 해당 문서의 `role`을 문자열 `admin`으로 변경한다.
-   - `collectionPrefix: 'board'`라면 `boardUsers/{uid}`
+   - 예: `boardId: 'main'` → `memiBoards/main/users/{uid}`
    - UID는 Firebase Console → Authentication → Users에서도 확인할 수 있다.
 4. `/board-settings`에서 첫 카테고리를 만든다. 카테고리가 없으면 글을 작성할 수 없다.
 5. 이후 역할 변경은 `/board-users`의 `MemiBoardUsers`에서 처리한다.
@@ -358,7 +360,7 @@ const router = useRouter()
 
 ### 관리 페이지
 
-기본 Rules는 게시판의 `{prefix}Users/{uid}.role == 'admin'`을 검사한다. 컴포넌트도 같은 role을 확인하므로 기본 설치에서는 `authorized`를 전달하지 않는다.
+기본 Rules는 게시판의 `memiBoards/{boardId}/users/{uid}.role == 'admin'`을 검사한다. 컴포넌트도 같은 role을 확인하므로 기본 설치에서는 `authorized`를 전달하지 않는다.
 
 ```vue
 <!-- app/pages/board-settings.vue -->
@@ -387,7 +389,7 @@ const router = useRouter()
 본문은 Nuxt UI **`UEditor`**(TipTap, `content-type="html"`). 호스트 `@nuxt/ui` 4.x 에 Editor 포함 필요.
 
 **에디터 이미지:** 툴바 / 붙여넣기 / 드롭 → Firebase Storage  
-`{prefix}/posts/{postId}/images/*` + `.../images/thumbnails/*` (최적화 이미지+썸네일).
+`memiBoards/{boardId}/posts/{postId}/images/*` + `.../images/thumbnails/*` (최적화 이미지+썸네일).
 
 본문 이미지는 휴대폰 원본 기준 최대 25MB까지 선택할 수 있다. 5MB를 넘으면 브라우저에서 최대 2560px·JPEG 85%로 최적화하고, 결과가 여전히 5MB를 넘으면 2048px·75%로 한 번 더 줄인 뒤 업로드한다. 5MB 이하 이미지는 원본을 유지한다.
 본문 HTML에는 원본 URL. 수정 중 버려진 파일은 호스트 스케줄러로 정리 (`extractEditorImageUrls` 로 본문 참조 비교).
@@ -403,7 +405,7 @@ const router = useRouter()
 
 ### 카테고리
 
-- 문서: `{prefix}Settings/config/categories/{categoryId}` → `{ label, listView, writeRole, order, updatedAt }`
+- 문서: `memiBoards/{boardId}/settings/config/categories/{categoryId}` → `{ label, listView, writeRole, order, updatedAt }`
 - 설정이 없으면 빈 목록이며 기본 카테고리를 자동 생성하지 않음
 - `MemiBoardSettings`에서 관리자가 카테고리별 저장·삭제·순서·리스트뷰·글쓰기 최소 역할 관리
 - `categoryId`는 문서 ID이자 게시글의 `category` 참조값이므로 생성 후 변경하지 않는 것을 권장
@@ -430,7 +432,7 @@ const router = useRouter()
 | 글/댓글 읽기 | 공개 |
 | 글 작성 | 로그인 + 카테고리 `writeRole` 충족 + `moderationStatus == 'approved'` |
 | 댓글 작성 | 로그인 + `moderationStatus == 'approved'` (클라가 항상 approved 로 씀 — 검열 통과 후에만 write) |
-| 글 수정·삭제 | 작성자 또는 `{prefix}Users/{uid}.role in ['admin', 'staff']` |
+| 글 수정·삭제 | 작성자 또는 `memiBoards/{boardId}/users/{uid}.role in ['admin', 'staff']` |
 | 댓글 삭제 | 댓글 작성자 · 글 작성자 · admin · staff |
 | 역할 관리 | `MemiBoardUsers`에서 admin이 `admin`·`staff`·`user` 변경 |
 
@@ -450,7 +452,7 @@ const router = useRouter()
 | `blockBanThreshold` | `3` | 콘텐츠 차단(local/ai) 누적 이상이면 글·댓글 제한. `0` = off |
 | `blockBanDecayMs` | `86400000` | 경고 1회 차감 간격(기본 24h) |
 
-콘텐츠 차단이 누적되면 `{prefix}Users/{uid}` 에 `moderationBlockCount` / `moderationBlockAt` 이 기록된다.  
+콘텐츠 차단이 누적되면 `memiBoards/{boardId}/users/{uid}` 에 `moderationBlockCount` / `moderationBlockAt` 이 기록된다.  
 3회면 약 하루 동안 작성 불가(24h마다 1 차감). Rules 예시에서 본인은 **+1만** 가능하고 감소·리셋은 admin.
 
 콘솔에서 **AI Logic(Gemini Developer API)** 활성화. 신규 프로젝트는 구형 `gemini-2.5-flash` 가 404 날 수 있음 → 3.x Flash / Flash-Lite 사용.
@@ -488,7 +490,7 @@ export default defineNuxtPlugin(() => {
 - [ ] 동일 스택: Nuxt 4 + `@nuxt/ui` 4 + `nuxt-vuefire` + Firebase
 - [ ] `pnpm add memi-board @nuxt/ui nuxt-vuefire vuefire firebase dayjs`
 - [ ] `modules`에 `@nuxt/ui`, `nuxt-vuefire`, `memi-board`
-- [ ] `memiBoard` (`collectionPrefix` · `auth` · `moderation` · **`seo`**)
+- [ ] `memiBoard` (`boardId` · `auth` · `moderation` · **`seo`**)
 - [ ] 공개 목록·상세 **SSR on**, 쓰기·설정만 `ssr: false` (전 경로 CSR 금지)
 - [ ] 목록·상세 페이지에 `await useMemiBoardListSeo` / `useMemiBoardPostSeo`
 - [ ] 호스트 SEO API 없음
@@ -496,12 +498,12 @@ export default defineNuxtPlugin(() => {
 - [ ] Rules 예시 병합 + **deploy**
 - [ ] 카테고리·listed 쿼리 사용 시 indexes deploy
 - [ ] 페이지·미들웨어 직접 작성 (또는 playground 복사)
-- [ ] 최초 로그인 후 Firebase Console에서 `{prefix}Users/{uid}.role = 'admin'`
+- [ ] 최초 로그인 후 Firebase Console에서 `memiBoards/{boardId}/users/{uid}.role = 'admin'`
 - [ ] 설정 페이지에서 첫 카테고리 생성
 - [ ] (검열) AI Logic 활성화 + 권장 모델 + App Check
 - [ ] `pnpm why vuefire` 로 이중 인스턴스 없는지 확인
 
-같은 Firebase 프로젝트에 호스트 앱 유저 컬렉션이 있어도 무방 — 게시판 역할은 **`{prefix}Users` 전용**이다.
+같은 Firebase 프로젝트에 호스트 앱 유저 컬렉션이 있어도 무방 — 게시판 역할은 **`memiBoards/{boardId}/users` 전용**이다.
 
 ## 문제 해결
 

package/dist/composables/fetchPublicSeo.d.ts

@@ -1,12 +1,12 @@
 import { Firestore } from 'firebase/firestore';
+import { BoardPathConfig } from '../utils/boardPaths';
 import { BoardListSeoPayload, BoardPostSeoPayload } from '../utils/boardSeo';
 export type PublicSeoDb = {
     db: Firestore;
-    prefix: string;
+    paths: BoardPathConfig;
 };
-/** setup 동기 구간에서만 호출 — useFirestore + config 캡처 */
 export declare function resolvePublicSeoDb(): PublicSeoDb;
-/** 공개 글 1건 (category + slug). 없거나 숨김이면 null. */
-export declare function fetchPublicPostForSeo(category: string, slug: string, ctx?: PublicSeoDb): Promise<BoardPostSeoPayload | null>;
-/** 전체 또는 카테고리 공개 목록 SEO 페이로드. */
-export declare function fetchPublicListForSeo(category?: string | null, ctx?: PublicSeoDb): Promise<BoardListSeoPayload>;
+/** 공개 글 1건 (boardId + slug) */
+export declare function fetchPublicPostForSeo(boardId: string, slug: string, ctx?: PublicSeoDb): Promise<BoardPostSeoPayload | null>;
+/** 전체 보드 목록 또는 단일 보드 SEO */
+export declare function fetchPublicListForSeo(boardId?: string | null, ctx?: PublicSeoDb): Promise<BoardListSeoPayload>;

package/dist/composables/useMemiBoardComments.d.ts

@@ -1,4 +1,4 @@
-import { Ref } from 'vue';
+import { MaybeRefOrGetter, Ref } from 'vue';
 import { CommentModel } from '../types';
 export interface AddCommentInput {
     body: string;
@@ -11,7 +11,7 @@ export interface AddReplyInput extends AddCommentInput {
 }
 export declare const COMMENT_BODY_MAX_LENGTH = 1000;
 /** 10개씩 순차 조회한 뒤 마지막 페이지에서만 최신 1개를 실시간 구독한다. */
-export declare function useMemiBoardComments(postId: string | Ref<string>, options?: {
+export declare function useMemiBoardComments(boardId: MaybeRefOrGetter<string>, postId: MaybeRefOrGetter<string>, options?: {
     subscribe?: boolean;
 }): {
     comments: import('vue').ComputedRef<CommentModel[]>;
@@ -26,7 +26,7 @@ export declare function useMemiBoardComments(postId: string | Ref<string>, optio
     deleteComment: (comment: CommentModel) => Promise<void>;
 };
 /** 펼친 스레드의 답글을 5개씩 일회성 조회한다. */
-export declare function useMemiBoardReplies(postId: string, rootId: string): {
+export declare function useMemiBoardReplies(boardId: string, postId: string, rootId: string): {
     replies: Ref<{
         id?: string | undefined;
         postId: string;

package/dist/composables/useMemiBoardLikes.d.ts

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

package/dist/composables/useMemiBoardModeration.d.ts

@@ -2,7 +2,7 @@ import { ModerationResult } from '../types';
 /**
  * 글쓰기 전 블로킹 검열.
  * 이용 제한 확인 → 로컬 비속어 → Firebase AI Logic(Gemini).
- * 콘텐츠 차단(local/ai) 시 boardUsers 경고 누적.
+ * 콘텐츠 차단(local/ai) 시 board users 경고 누적.
  */
 export declare function useMemiBoardModeration(): {
     checkText: (text: string) => Promise<ModerationResult>;

package/dist/composables/useMemiBoardPosts.d.ts

@@ -1,13 +1,11 @@
-import { Ref } from 'vue';
+import { MaybeRefOrGetter, Ref } from 'vue';
 import { DocumentData, QueryDocumentSnapshot } from 'firebase/firestore';
 import { Attachment, PostDetail, PostModel } from '../types';
 export interface CreatePostInput {
-    /** 작성 화면 진입 시 미리 만든 Firestore 자동 ID. Storage namespace와 동일하게 사용한다. */
     postId?: string;
     title: string;
     content: string;
     tags?: string[];
-    category?: string;
     attachments?: Attachment[];
     authorUid: string;
     authorName: string | null;
@@ -18,10 +16,8 @@ export interface UpdatePostInput {
     title: string;
     content: string;
     tags?: string[];
-    category?: string;
     attachments?: Attachment[];
 }
-/** getPostBySlug 결과 — not-found 와 permission-denied 를 UI 에서 구분한다. */
 export type GetPostBySlugResult = {
     status: 'ok';
     post: PostDetail;
@@ -34,15 +30,12 @@ export type GetPostBySlugResult = {
     message: string;
 };
 export declare function isFirestorePermissionDenied(error: unknown): boolean;
-/** 목록 조회는 posts/{id} 메타만 읽고, 본문(body/main)은 상세 조회 시에만 읽는다. */
-export declare function useMemiBoardPosts(): {
+/** 목록은 posts 메타만, 본문(body/main)은 상세에서만. */
+export declare function useMemiBoardPosts(boardId: MaybeRefOrGetter<string>): {
     createPostId: () => string;
     getPosts: (opts?: {
         pageSize?: number;
         cursor?: QueryDocumentSnapshot<DocumentData>;
-        /** 지정 시 해당 카테고리 글만 (boardSettings 의 category id) */
-        category?: string;
-        /** true 면 listed==true 만 (비권한 목록). staff 전체 보기는 false */
         publicOnly?: boolean;
     }) => Promise<{
         posts: PostModel[];
@@ -50,7 +43,7 @@ export declare function useMemiBoardPosts(): {
         hasMore: boolean;
     }>;
     getPost: (id: string) => Promise<PostDetail | null>;
-    getPostBySlug: (category: string, slug: string) => Promise<GetPostBySlugResult>;
+    getPostBySlug: (slug: string) => Promise<GetPostBySlugResult>;
     getAdjacentPosts: (current: PostModel) => Promise<{
         previous: PostModel | null;
         next: PostModel | null;
@@ -59,17 +52,8 @@ 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 */
+export declare function useMemiBoardPostList(boardId: MaybeRefOrGetter<string>, options?: {
+    pageSize?: number;
     publicOnly?: boolean | Ref<boolean>;
 }): {
     posts: import('vue').ComputedRef<PostModel[]>;
@@ -79,12 +63,7 @@ export declare function useMemiBoardPostList(category?: string | Ref<string | un
     loadError: Ref<string, string>;
     loadMore: () => Promise<void>;
 };
-/**
- * 게시글 상세를 VueFire useDocument로 실시간 구독한다 (메타 + 본문).
- * 좋아요·댓글 수 등 다른 사람의 변경이 화면에 바로 반영된다 — 좋아요 토글도
- * 별도 로컬 낙관적 갱신 없이 이 구독이 그대로 반영해 준다.
- */
-export declare function useMemiBoardPost(postId: string | Ref<string>): {
+export declare function useMemiBoardPost(boardId: MaybeRefOrGetter<string>, postId: string | Ref<string>): {
     post: import('vue').ComputedRef<PostDetail | null>;
     pending: import('vue').ComputedRef<boolean>;
 };

package/dist/composables/useMemiBoardSettings.d.ts

@@ -1,19 +1,37 @@
-import { BoardCategory, BoardVisibility } from '../types';
-/** 필요할 때 호스트가 명시적으로 사용할 수 있는 예시 카테고리. 자동 적용하지 않는다. */
-export declare const DEFAULT_CATEGORIES: BoardCategory[];
-/** 게시판 카테고리 — `{prefix}Settings/config/categories/{categoryId}` 개별 문서. */
+import { BoardModel, BoardVisibility } from '../types';
+/** 필요할 때 호스트가 명시적으로 시드할 수 있는 예시 보드. 자동 적용하지 않는다. */
+export declare const DEFAULT_BOARDS: BoardModel[];
+/** @deprecated DEFAULT_BOARDS */
+export declare const DEFAULT_CATEGORIES: BoardModel[];
+/**
+ * 보드 목록·설정.
+ * - 목록: memiBoards 컬렉션 (부모 문서에 메타 복제)
+ * - 설정 원본: memiBoards/{boardId}/settings/config
+ */
 export declare function useMemiBoardSettings(): {
-    categories: import('vue').ComputedRef<BoardCategory[]>;
-    publicCategories: import('vue').ComputedRef<BoardCategory[]>;
+    boards: import('vue').ComputedRef<BoardModel[]>;
+    publicBoards: import('vue').ComputedRef<BoardModel[]>;
+    boardLabel: (id: string | undefined) => string | undefined;
+    boardDescription: (id: string | undefined) => string | undefined;
+    boardVisibility: (id: string | undefined) => BoardVisibility;
+    isBoardHidden: (id: string | undefined) => boolean;
+    getBoard: (id: string | undefined) => BoardModel | undefined;
+    categories: import('vue').ComputedRef<BoardModel[]>;
+    publicCategories: import('vue').ComputedRef<BoardModel[]>;
     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>;
+    addBoard: (label: string) => Promise<string>;
     addCategory: (label: string) => Promise<string>;
-    saveCategory: (category: BoardCategory, order?: number) => Promise<void>;
-    saveCategories: (next: BoardCategory[]) => Promise<void>;
+    saveBoard: (board: BoardModel, order?: number) => Promise<void>;
+    saveCategory: (board: BoardModel, order?: number) => Promise<void>;
+    saveBoards: (next: BoardModel[]) => Promise<void>;
+    saveCategories: (next: BoardModel[]) => Promise<void>;
+    deleteBoard: (id: string) => Promise<void>;
     deleteCategory: (id: string) => Promise<void>;
-    DEFAULT_CATEGORIES: BoardCategory[];
+    DEFAULT_BOARDS: BoardModel[];
+    DEFAULT_CATEGORIES: BoardModel[];
 };

package/dist/composables/useMemiBoardStorage.d.ts

@@ -4,11 +4,11 @@ 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) => {
+    uploadAttachment: (file: File, boardId: string, postId: string, onProgress?: (ratio: number) => void) => {
         promise: Promise<Attachment>;
         cancel: () => void;
     };
     deleteAttachment: (attachment: Pick<Attachment, "path">) => Promise<void>;
-    uploadEditorImage: (file: File, postId: string) => Promise<EditorImageEntry>;
+    uploadEditorImage: (file: File, boardId: string, postId: string) => Promise<EditorImageEntry>;
     deleteEditorImage: (entry: Pick<EditorImageEntry, "originalPath" | "thumbnailPath">) => Promise<void>;
 };

package/dist/composables/useMemiBoardUsers.d.ts

@@ -9,6 +9,8 @@ export declare const BOARD_USER_ROLES: Array<{
  * 전체 사용자 목록은 관리자만 읽을 수 있다(rules). enabled가 false인 동안은
  * 쿼리 자체를 시작하지 않는다 — 그냥 호출만 하면 권한 확인 전에 구독이 걸려서
  * 관리자가 아니거나 아직 role을 확인 중일 때 permission-denied로 화면이 죽는다.
+ *
+ * 경로: memiBoards/{boardId}/users/{uid}
  */
 export declare function useMemiBoardUsers(options?: {
     enabled?: MaybeRefOrGetter<boolean>;

package/dist/composables/useMemiBoardViews.d.ts

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

package/dist/config.d.ts

@@ -1,3 +1,4 @@
+import { BoardPathConfig } from './utils/boardPaths';
 export interface MemiBoardAuthOptions {
     providers?: Array<'google' | 'apple' | 'emailPassword'>;
 }
@@ -7,47 +8,30 @@ export interface MemiBoardModerationOptions {
     localBlocklist?: string[];
     onError?: 'allow' | 'block';
     moderateImages?: boolean;
-    /** AI Logic App Check limited-use 토큰 (재생 보호). 기본 true */
     useLimitedUseAppCheckTokens?: boolean;
-    /**
-     * 콘텐츠 검열 차단(로컬/AI flagged) 누적 횟수 이상이 되면 글·댓글 작성 제한.
-     * 기본 3. 0 이하면 제한 기능 off.
-     */
     blockBanThreshold?: number;
-    /** 경고 1회 차감 간격(ms). 기본 24시간 */
     blockBanDecayMs?: number;
 }
-/**
- * 게시판 SEO (호스트 API 없이 Firestore 직조회 + useSeoMeta).
- * 호스트는 siteUrl/siteName 과 공개 board 경로 SSR on 만 맞추면 된다.
- */
 export interface MemiBoardSeoOptions {
-    /** false 면 useMemiBoard*Seo 가 no-op. 기본 true */
     enabled?: boolean;
-    /** og:site_name · title 접미사. 예: Loop Waiting */
     siteName?: string;
-    /**
-     * 절대 URL용 origin. 예: https://loopwait.com
-     * 비우면 useRequestURL / NUXT_PUBLIC_SITE_URL 순으로 추론.
-     */
     siteUrl?: string;
-    /** 글에 previewImage 없을 때. 상대경로 또는 https */
     defaultOgImage?: string;
     /**
      * 호스트 게시판 base path (trailing slash 없음). 기본 '/board'
-     * canonical: {base}, {base}/{category}, {base}/{category}/{slug}
+     * canonical: {base}, {base}/{boardId}, {base}/{boardId}/{slug}
      */
     basePath?: string;
 }
 export interface MemiBoardConfig {
-    collectionPrefix: string;
+    /** 루트 컬렉션. 기본 `memiBoards` */
+    boardsCollection: string;
+    /** 역할 문서 컬렉션. 기본 `memiBoardUsers` */
+    usersCollection: string;
     auth: MemiBoardAuthOptions;
     moderation: MemiBoardModerationOptions;
     seo: MemiBoardSeoOptions;
 }
-/**
- * 앱 부팅 시(플러그인 등에서) 한 번 호출한다. 모든 요청/세션이 같은 값을 보므로
- * 서버 렌더링에서도 안전하다 — 사용자별/요청별로 달라지는 값이 아니다.
- */
 export declare function configureMemiBoard(options: Partial<MemiBoardConfig>): void;
 export declare function useMemiBoardConfig(): MemiBoardConfig;
+export declare function useBoardPathConfig(): BoardPathConfig;