memi-board 0.4.0 → 0.4.4

package/dist/index.js

@@ -1,43 +1,48 @@
 import { computed as e, reactive as t, ref as n, watch as r } from "vue";
 import { useCollection as i, useCurrentUser as a, useDocument as o, useFirebaseApp as s, useFirebaseAuth as c, useFirestore as l } from "vuefire";
-import { collection as u, deleteDoc as d, doc as f, getDoc as p, getDocs as m, increment as h, limit as g, orderBy as _, query as v, serverTimestamp as y, setDoc as b, startAfter as x, updateDoc as S, writeBatch as C } from "firebase/firestore";
-import { GoogleAuthProvider as w, OAuthProvider as T, createUserWithEmailAndPassword as E, signInWithEmailAndPassword as D, signInWithPopup as O, signOut as k, updateProfile as ee } from "firebase/auth";
-import { deleteObject as A, getDownloadURL as j, getStorage as M, listAll as N, ref as P, uploadBytesResumable as F } from "firebase/storage";
-import { GoogleAIBackend as I, Schema as L, getAI as R, getGenerativeModel as z } from "firebase/ai";
+import { collection as u, deleteDoc as d, deleteField as f, doc as p, getDoc as m, getDocs as h, increment as g, limit as _, orderBy as v, query as y, serverTimestamp as b, setDoc as x, startAfter as S, updateDoc as C, where as w, writeBatch as T } from "firebase/firestore";
+import { GoogleAuthProvider as E, OAuthProvider as D, createUserWithEmailAndPassword as O, signInWithEmailAndPassword as k, signInWithPopup as A, signOut as j, updateProfile as ee } from "firebase/auth";
+import { deleteObject as M, getDownloadURL as N, getStorage as P, listAll as te, ref as F, uploadBytesResumable as ne } from "firebase/storage";
+import { GoogleAIBackend as I, Schema as L, getAI as R, getGenerativeModel as re } from "firebase/ai";
 //#region src/config.ts
-var B = t({
-	collectionPrefix: "memiBoard",
-	auth: { providers: ["google", "apple"] },
-	moderation: {
-		enabled: !0,
-		model: "gemini-2.5-flash",
-		onError: "allow",
-		moderateImages: !1,
-		localBlocklist: []
-	}
-});
-function V(e) {
-	e.collectionPrefix && (B.collectionPrefix = e.collectionPrefix), e.auth && Object.assign(B.auth, e.auth), e.moderation && Object.assign(B.moderation, e.moderation);
+var z = "__MEMI_BOARD_CONFIG__";
+function B() {
+	let e = globalThis;
+	return e[z] || (e[z] = t({
+		collectionPrefix: "memiBoard",
+		auth: { providers: ["google", "apple"] },
+		moderation: {
+			enabled: !0,
+			model: "gemini-2.5-flash",
+			onError: "allow",
+			moderateImages: !1,
+			localBlocklist: []
+		}
+	})), e[z];
 }
-function H() {
-	return B;
+function ie(e) {
+	let t = B();
+	e.collectionPrefix && (t.collectionPrefix = e.collectionPrefix), e.auth && Object.assign(t.auth, e.auth), e.moderation && Object.assign(t.moderation, e.moderation);
+}
+function V() {
+	return B();
 }
 //#endregion
 //#region src/composables/useMemiBoardAuth.ts
-function U() {
-	let t = H(), i = l(), o = c(), s = a(), u = n("user"), d = n(!0);
-	function m(e) {
-		return f(i, `${t.collectionPrefix}Users`, e);
+function H() {
+	let t = V(), i = l(), o = c(), s = a(), u = n("user"), d = n(!0);
+	function f(e) {
+		return p(i, `${t.collectionPrefix}Users`, e);
 	}
 	async function h(e) {
-		let t = m(e.uid), n = await p(t);
-		return n.exists() ? (await S(t, {
+		let t = f(e.uid), n = await m(t);
+		return n.exists() ? (await C(t, {
 			displayName: e.displayName,
-			updatedAt: y()
-		}), n.data().role ?? "user") : (await b(t, {
+			updatedAt: b()
+		}), n.data().role ?? "user") : (await x(t, {
 			role: "user",
 			displayName: e.displayName,
-			updatedAt: y()
+			updatedAt: b()
 		}), "user");
 	}
 	r(s, async (e) => {
@@ -58,22 +63,22 @@ function U() {
 		if (!o) throw Error("[memi-board] Firebase Auth가 초기화되지 않았습니다.");
 		return o;
 	}
-	async function x() {
-		return O(v(), new w());
+	async function y() {
+		return A(v(), new E());
 	}
-	async function C() {
-		let e = new T("apple.com");
-		return e.addScope("email"), e.addScope("name"), O(v(), e);
+	async function S() {
+		let e = new D("apple.com");
+		return e.addScope("email"), e.addScope("name"), A(v(), e);
 	}
-	async function A(e, t) {
-		return D(v(), e, t);
+	async function w(e, t) {
+		return k(v(), e, t);
 	}
-	async function j(e, t, n) {
-		let r = await E(v(), e, t);
+	async function T(e, t, n) {
+		let r = await O(v(), e, t);
 		return n && await ee(r.user, { displayName: n }), r;
 	}
 	async function M() {
-		await k(v());
+		await j(v());
 	}
 	function N(e) {
 		return g.value && (s.value?.uid === e.authorUid || _.value);
@@ -86,10 +91,10 @@ function U() {
 		isSignedIn: g,
 		isAdmin: _,
 		rolePending: d,
-		signInWithGoogle: x,
-		signInWithApple: C,
-		signInWithEmail: A,
-		signUpWithEmail: j,
+		signInWithGoogle: y,
+		signInWithApple: S,
+		signInWithEmail: w,
+		signUpWithEmail: T,
 		signOut: M,
 		canEdit: N,
 		canDelete: N,
@@ -98,29 +103,27 @@ function U() {
 }
 //#endregion
 //#region src/utils/slugify.ts
-function W(e) {
+function U(e) {
 	return e.trim().replace(/\s+/g, "-").replace(/[^a-zA-Z0-9가-힣ㄱ-ㅎㅏ-ㅣ-]/g, "").replace(/-+/g, "-").replace(/^-+|-+$/g, "");
 }
-function G(e, t = 60) {
+function W(e, t = 60) {
 	return e.replace(/[^a-zA-Z0-9가-힣ㄱ-ㅎ._-]/g, "-").slice(0, t);
 }
 //#endregion
 //#region src/composables/useMemiBoardPosts.ts
-async function K(e) {
-	let t = await N(e).catch(() => ({
+async function G(e) {
+	let t = await te(e).catch(() => ({
 		items: [],
 		prefixes: []
 	}));
-	await Promise.all([...t.items.map((e) => A(e)), ...t.prefixes.map((e) => K(e))]);
+	await Promise.all([...t.items.map((e) => M(e)), ...t.prefixes.map((e) => G(e))]);
 }
-function q() {
-	let e = H(), t = l(), n = s(), r = e.collectionPrefix, i = () => u(t, `${r}Posts`), a = (e) => f(t, `${r}Posts`, e), o = (e) => f(t, `${r}Posts`, e, "body", "main"), c = (e) => u(t, `${r}Posts`, e, "comments");
-	async function h(e = {}) {
-		let t = e.pageSize ?? 20, n = e.cursor ? [
-			_("createdAt", "desc"),
-			x(e.cursor),
-			g(t + 1)
-		] : [_("createdAt", "desc"), g(t + 1)], r = await m(v(i(), ...n)), a = r.docs.slice(0, t);
+function K() {
+	let e = V(), t = l(), n = s(), r = () => e.collectionPrefix, i = () => u(t, `${r()}Posts`), a = (e) => p(t, `${r()}Posts`, e), o = (e) => p(t, `${r()}Posts`, e, "body", "main"), c = (e) => u(t, `${r()}Posts`, e, "comments");
+	async function g(e = {}) {
+		let t = e.pageSize ?? 20, n = [];
+		e.category && n.push(w("category", "==", e.category)), n.push(v("createdAt", "desc")), e.cursor && n.push(S(e.cursor)), n.push(_(t + 1));
+		let r = await h(y(i(), ...n)), a = r.docs.slice(0, t);
 		return {
 			posts: a.map((e) => ({
 				id: e.id,
@@ -130,18 +133,18 @@ function q() {
 			hasMore: r.docs.length > t
 		};
 	}
-	async function w(e) {
-		let [t, n] = await Promise.all([p(a(e)), p(o(e))]);
+	async function E(e) {
+		let [t, n] = await Promise.all([m(a(e)), m(o(e))]);
 		return t.exists() ? {
 			id: t.id,
 			...t.data(),
 			content: n.exists() ? n.data().content ?? "" : ""
 		} : null;
 	}
-	async function T(e) {
-		let t = W(e.title) || "post", n = t, r = 1;
-		for (; (await p(a(n))).exists();) r++, n = `${t}-${r}`;
-		return await Promise.all([b(a(n), {
+	async function D(e) {
+		let t = U(e.title) || "post", n = t, r = 1;
+		for (; (await m(a(n))).exists();) r++, n = `${t}-${r}`;
+		return await Promise.all([x(a(n), {
 			title: e.title,
 			tags: e.tags ?? [],
 			...e.category ? { category: e.category } : {},
@@ -152,65 +155,65 @@ function q() {
 			authorPhoto: e.authorPhoto,
 			moderationStatus: "approved",
 			moderationModel: e.moderationModel ?? null,
-			createdAt: y(),
-			updatedAt: y()
-		}), b(o(n), { content: e.content })]), n;
+			createdAt: b(),
+			updatedAt: b()
+		}), x(o(n), { content: e.content })]), n;
 	}
-	async function E(e, t) {
-		await Promise.all([S(a(e), {
+	async function O(e, t) {
+		await Promise.all([C(a(e), {
 			title: t.title,
 			tags: t.tags ?? [],
-			...t.category ? { category: t.category } : {},
+			category: t.category ? t.category : f(),
 			attachments: t.attachments ?? [],
-			updatedAt: y()
-		}), b(o(e), { content: t.content })]);
+			updatedAt: b()
+		}), x(o(e), { content: t.content }, { merge: !0 })]);
 	}
-	async function D(e) {
-		let i = await m(c(e));
+	async function k(e) {
+		let i = await h(c(e));
 		for (let e = 0; e < i.docs.length; e += 450) {
-			let n = C(t);
+			let n = T(t);
 			i.docs.slice(e, e + 450).forEach((e) => n.delete(e.ref)), await n.commit();
 		}
-		let s = M(n);
-		await d(o(e)), await K(P(s, `${r}/posts/${e}`)), await d(a(e));
+		let s = P(n);
+		await d(o(e)), await G(F(s, `${r()}/posts/${e}`)), await d(a(e));
 	}
 	return {
-		getPosts: h,
-		getPost: w,
-		createPost: T,
-		updatePost: E,
-		deletePost: D
+		getPosts: g,
+		getPost: E,
+		createPost: D,
+		updatePost: O,
+		deletePost: k
 	};
 }
 //#endregion
 //#region src/composables/useMemiBoardComments.ts
-function J(t) {
-	let n = H(), r = l(), a = n.collectionPrefix, o = e(() => typeof t == "string" ? t : t.value), s = e(() => v(u(r, `${a}Posts`, o.value, "comments"), _("createdAt", "asc"))), c = i(s);
+function q(t) {
+	let n = V(), r = l(), a = () => n.collectionPrefix, o = e(() => typeof t == "string" ? t : t.value), s = e(() => y(u(r, `${a()}Posts`, o.value, "comments"), v("createdAt", "asc"))), c = i(s);
 	async function d(e) {
-		let t = C(r), n = f(u(r, `${a}Posts`, o.value, "comments"));
-		t.set(n, {
+		let t = T(r), n = a(), i = p(u(r, `${n}Posts`, o.value, "comments"));
+		t.set(i, {
 			postId: o.value,
 			body: e.body,
 			authorUid: e.authorUid,
 			authorName: e.authorName,
 			authorPhoto: e.authorPhoto,
 			moderationStatus: "approved",
-			createdAt: y()
-		}), t.update(f(r, `${a}Posts`, o.value), { commentCount: h(1) }), await t.commit();
+			createdAt: b()
+		}), t.update(p(r, `${n}Posts`, o.value), { commentCount: g(1) }), await t.commit();
 	}
-	async function p(e) {
-		let t = C(r);
-		t.delete(f(r, `${a}Posts`, o.value, "comments", e)), t.update(f(r, `${a}Posts`, o.value), { commentCount: h(-1) }), await t.commit();
+	async function f(e) {
+		let t = T(r), n = a();
+		t.delete(p(r, `${n}Posts`, o.value, "comments", e)), t.update(p(r, `${n}Posts`, o.value), { commentCount: g(-1) }), await t.commit();
 	}
 	return {
 		comments: c,
 		addComment: d,
-		deleteComment: p
+		deleteComment: f
 	};
 }
 //#endregion
 //#region src/utils/moderation-prompt.ts
-var Y = "당신은 게시판 콘텐츠를 심사하는 엄격한 모더레이터입니다.\n아래 텍스트에 욕설·비속어·성희롱·혐오·위협·스팸·도배성 광고가 있으면 반드시 거부(flagged=true)합니다.\n\nflagged=true 예:\n- 욕설/비속어: 씨발, 시발, 병신, 지랄, 좆, 개새끼, 존나, fuck, shit, bitch 등\n- 성적 모욕, 혐오 발언, 협박\n- 게시판 주제와 무관한 도배성 광고/스팸\n\nflagged=false:\n- 게시판 주제에 맞는 정상적인 글/댓글 (강한 의견이나 정당한 비판은 허용)\n\nJSON만 출력:\n{\"flagged\":boolean,\"category\":\"none\"|\"abuse\"|\"spam\"|\"adult\"|\"violence\"|\"other\",\"reason\":string}\n- flagged=true면 category는 상황에 맞게 고르고, reason은 한국어 1문장 (예: \"욕설이 포함되어 있어 게시할 수 없습니다.\")\n- flagged=false면 category는 \"none\", reason은 \"\"", X = [
+var J = "당신은 게시판 콘텐츠를 심사하는 엄격한 모더레이터입니다.\n아래 텍스트에 욕설·비속어·성희롱·혐오·위협·스팸·도배성 광고가 있으면 반드시 거부(flagged=true)합니다.\n\nflagged=true 예:\n- 욕설/비속어: 씨발, 시발, 병신, 지랄, 좆, 개새끼, 존나, fuck, shit, bitch 등\n- 성적 모욕, 혐오 발언, 협박\n- 게시판 주제와 무관한 도배성 광고/스팸\n\nflagged=false:\n- 게시판 주제에 맞는 정상적인 글/댓글 (강한 의견이나 정당한 비판은 허용)\n\nJSON만 출력:\n{\"flagged\":boolean,\"category\":\"none\"|\"abuse\"|\"spam\"|\"adult\"|\"violence\"|\"other\",\"reason\":string}\n- flagged=true면 category는 상황에 맞게 고르고, reason은 한국어 1문장 (예: \"욕설이 포함되어 있어 게시할 수 없습니다.\")\n- flagged=false면 category는 \"none\", reason은 \"\"", ae = [
 	"씨발",
 	"시발",
 	"씨팔",
@@ -234,10 +237,10 @@ var Y = "당신은 게시판 콘텐츠를 심사하는 엄격한 모더레이터
 	"bitch",
 	"asshole"
 ];
-function te(e) {
+function oe(e) {
 	return new RegExp(e.join("|"), "i");
 }
-var ne = /* @__PURE__ */ new Set([
+var se = /* @__PURE__ */ new Set([
 	"none",
 	"abuse",
 	"spam",
@@ -245,7 +248,7 @@ var ne = /* @__PURE__ */ new Set([
 	"violence",
 	"other"
 ]);
-function Z(e) {
+function Y(e) {
 	let t = e.trim();
 	if (!t) return null;
 	let n;
@@ -263,7 +266,7 @@ function Z(e) {
 	if (typeof n != "object" || !n) return null;
 	let r = n;
 	if (typeof r.flagged != "boolean") return null;
-	let i = typeof r.category == "string" && ne.has(r.category) ? r.category : r.flagged ? "other" : "none", a = typeof r.reason == "string" ? r.reason : "";
+	let i = typeof r.category == "string" && se.has(r.category) ? r.category : r.flagged ? "other" : "none", a = typeof r.reason == "string" ? r.reason : "";
 	return {
 		flagged: r.flagged,
 		category: i,
@@ -272,85 +275,159 @@ function Z(e) {
 }
 //#endregion
 //#region src/composables/useMemiBoardModeration.ts
-var Q = {
+var X = {
 	flagged: !1,
 	category: "none",
-	reason: ""
+	reason: "",
+	via: "empty"
 };
-function re() {
-	let e = H().moderation ?? {}, t = s(), n = te([...X, ...e.localBlocklist ?? []]);
+function Z(e, t) {
+	console.info(`[memi-board:moderation] ${e}`, t);
+}
+function Q() {
+	let e = V().moderation ?? {}, t = s(), n = oe([...ae, ...e.localBlocklist ?? []]);
 	function r(e) {
-		return n.test(e) ? {
+		return e.match(n) ? {
 			flagged: !0,
 			category: "abuse",
-			reason: "욕설·비속어가 포함되어 게시할 수 없습니다. 표현을 바꿔 주세요."
+			reason: "욕설·비속어가 포함되어 게시할 수 없습니다. 표현을 바꿔 주세요.",
+			via: "local"
 		} : null;
 	}
 	function i() {
-		let n = R(t, {
+		let n = e.model ?? "gemini-2.5-flash", r = R(t, {
 			backend: new I(),
 			useLimitedUseAppCheckTokens: !0
 		});
-		return z(n, {
-			model: e.model ?? "gemini-2.5-flash",
-			systemInstruction: Y,
-			generationConfig: {
-				temperature: 0,
-				maxOutputTokens: 256,
-				responseMimeType: "application/json",
-				responseSchema: L.object({ properties: {
-					flagged: L.boolean(),
-					category: L.string(),
-					reason: L.string()
-				} })
-			}
-		});
+		return {
+			modelName: n,
+			model: re(r, {
+				model: n,
+				systemInstruction: J,
+				generationConfig: {
+					temperature: 0,
+					maxOutputTokens: 256,
+					responseMimeType: "application/json",
+					responseSchema: L.object({ properties: {
+						flagged: L.boolean(),
+						category: L.string(),
+						reason: L.string()
+					} })
+				}
+			})
+		};
 	}
 	function a() {
 		return e.onError === "block" ? {
 			flagged: !0,
 			category: "other",
 			reason: "검열 서비스에 일시적으로 연결할 수 없어 제출이 보류되었습니다. 잠시 후 다시 시도해 주세요.",
-			error: !0
+			error: !0,
+			via: "ai-error-block"
 		} : {
-			...Q,
-			error: !0
+			flagged: !1,
+			category: "none",
+			reason: "",
+			error: !0,
+			via: "ai-error-allow"
 		};
 	}
 	async function o(t) {
-		let n = t.trim();
-		if (!n) return Q;
-		let o = r(n);
-		if (o) return o;
-		if (e.enabled === !1) return Q;
+		let o = t.trim();
+		if (Z("start", {
+			preview: o.slice(0, 80),
+			length: o.length,
+			enabled: e.enabled !== !1,
+			model: e.model ?? "gemini-2.5-flash",
+			onError: e.onError ?? "allow"
+		}), !o) {
+			let e = {
+				...X,
+				via: "empty"
+			};
+			return Z("result", e), e;
+		}
+		let s = r(o);
+		if (s) {
+			let e = o.match(n)?.[0];
+			return Z("local-block", {
+				hit: e,
+				...s
+			}), Z("result", s), s;
+		}
+		if (Z("local-pass", { message: "로컬 금칙어 미매칭 → AI Logic 호출" }), e.enabled === !1) {
+			let e = {
+				...X,
+				via: "disabled"
+			};
+			return Z("result", e), e;
+		}
 		try {
-			let e = Z((await i().generateContent(`심사할 텍스트:\n"""${n.slice(0, 4e3)}"""`)).response.text());
-			return e ? {
-				flagged: e.flagged,
-				category: e.category,
-				reason: e.reason
-			} : (console.warn("[memi-board] 검열 응답 파싱 실패 → onError 정책 적용"), a());
+			let { model: e, modelName: t } = i();
+			Z("ai-call", {
+				modelName: t,
+				useLimitedUseAppCheckTokens: !0
+			});
+			let n = performance.now(), r = await e.generateContent(`심사할 텍스트:\n"""${o.slice(0, 4e3)}"""`), s = Math.round(performance.now() - n), c = r.response.text();
+			Z("ai-raw", {
+				ms: s,
+				raw: c.slice(0, 500)
+			});
+			let l = Y(c);
+			if (!l) {
+				Z("ai-parse-fail", { raw: c.slice(0, 300) });
+				let e = a();
+				return Z("result", e), e;
+			}
+			let u = {
+				flagged: l.flagged,
+				category: l.category,
+				reason: l.reason,
+				via: "ai"
+			};
+			return Z("result", {
+				...u,
+				ms: s
+			}), u;
 		} catch (e) {
-			return console.warn("[memi-board] AI 검열 호출 실패 → onError 정책 적용", e), a();
+			Z("ai-error", {
+				message: e instanceof Error ? e.message : String(e),
+				name: e instanceof Error ? e.name : void 0,
+				code: e?.code
+			});
+			let t = a();
+			return Z("result", t), t;
 		}
 	}
 	async function c(t) {
-		if (e.enabled === !1 || !e.moderateImages) return Q;
+		if (e.enabled === !1 || !e.moderateImages) return {
+			...X,
+			via: "disabled"
+		};
 		try {
 			let e = await new Promise((e, n) => {
 				let r = new FileReader();
 				r.onload = () => e(r.result.split(",")[1] ?? ""), r.onerror = n, r.readAsDataURL(t);
-			}), n = Z((await i().generateContent([{ inlineData: {
+			}), { model: n, modelName: r } = i();
+			Z("ai-image-call", {
+				modelName: r,
+				type: t.type,
+				size: t.size
+			});
+			let o = (await n.generateContent([{ inlineData: {
 				mimeType: t.type || "image/jpeg",
 				data: e
-			} }, "이 이미지를 심사해 주세요."])).response.text());
-			return n ? {
-				flagged: n.flagged,
-				category: n.category,
-				reason: n.reason
-			} : a();
+			} }, "이 이미지를 심사해 주세요."])).response.text(), s = Y(o);
+			if (!s) return Z("ai-image-parse-fail", { raw: o.slice(0, 300) }), a();
+			let c = {
+				flagged: s.flagged,
+				category: s.category,
+				reason: s.reason,
+				via: "ai"
+			};
+			return Z("ai-image-result", c), c;
 		} catch (e) {
-			return console.warn("[memi-board] 이미지 검열 호출 실패 → onError 정책 적용", e), a();
+			return Z("ai-image-error", { message: e instanceof Error ? e.message : String(e) }), a();
 		}
 	}
 	return {
@@ -360,10 +437,10 @@ function re() {
 }
 //#endregion
 //#region src/composables/useMemiBoardStorage.ts
-function ie() {
-	let e = H(), t = s(), n = e.collectionPrefix;
+function ce() {
+	let e = V(), t = s(), n = () => e.collectionPrefix;
 	function r(e, r, i) {
-		let a = M(t), o = `${n}/posts/${r}/attachments/${Date.now()}-${G(e.name)}`, s = P(a, o), c = F(s, e, {
+		let a = P(t), o = `${n()}/posts/${r}/attachments/${Date.now()}-${W(e.name)}`, s = F(a, o), c = ne(s, e, {
 			contentType: e.type || "application/octet-stream",
 			contentDisposition: `attachment; filename*=UTF-8''${encodeURIComponent(e.name)}`
 		});
@@ -372,7 +449,7 @@ function ie() {
 				c.on("state_changed", (e) => {
 					i && e.totalBytes > 0 && i(e.bytesTransferred / e.totalBytes);
 				}, n, async () => {
-					let n = await j(s);
+					let n = await N(s);
 					t({
 						name: e.name,
 						url: n,
@@ -386,8 +463,8 @@ function ie() {
 		};
 	}
 	async function i(e) {
-		let n = M(t);
-		await A(P(n, e.path)).catch(() => {});
+		let n = P(t);
+		await M(F(n, e.path)).catch(() => {});
 	}
 	return {
 		uploadAttachment: r,
@@ -410,30 +487,65 @@ var $ = [
 		label: "질문"
 	}
 ];
-function ae() {
-	let t = H(), n = l(), { isAdmin: i } = U(), a = t.collectionPrefix, s = f(n, `${a}Settings`, "config"), { data: c, pending: u } = o(s), d = e(() => {
+function le() {
+	let t = V(), n = l(), { isSignedIn: i, isAdmin: a } = H(), s = e(() => p(n, `${t.collectionPrefix}Settings`, "config")), { data: c, pending: u } = o(s), d = e(() => {
 		let e = c.value?.categories;
 		return e && e.length > 0 ? e : $;
 	});
-	function m(e) {
+	function f(e) {
 		if (e) return d.value.find((t) => t.id === e)?.label ?? e;
 	}
-	return r([i, u], async ([e, t]) => {
-		if (!e || t || c.value) return;
-		let n = await p(s).catch(() => null);
-		!n || n.exists() || await b(s, {
+	async function h() {
+		if (!i.value) return;
+		let e = s.value, t = await m(e).catch(() => null);
+		!t || t.exists() || await x(e, {
 			categories: $,
-			updatedAt: y()
-		}).catch(() => {});
+			updatedAt: b()
+		});
+	}
+	async function g(e) {
+		let t = e.trim();
+		if (!t) throw Error("카테고리 이름을 입력해 주세요.");
+		if (!i.value) throw Error("로그인이 필요합니다.");
+		await h();
+		let n = d.value.find((e) => e.label === t || e.id === U(t));
+		if (n) return n.id;
+		let r = U(t) || `cat-${Date.now()}`, a = new Set(d.value.map((e) => e.id));
+		if (a.has(r)) {
+			let e = 2;
+			for (; a.has(`${r}-${e}`);) e++;
+			r = `${r}-${e}`;
+		}
+		let o = [...d.value, {
+			id: r,
+			label: t
+		}], c = s.value;
+		return (await m(c)).exists() ? await C(c, {
+			categories: o,
+			updatedAt: b()
+		}) : await x(c, {
+			categories: o,
+			updatedAt: b()
+		}), r;
+	}
+	return r([
+		a,
+		i,
+		u
+	], async ([e, t, n]) => {
+		n || c.value || !e && !t || await h().catch(() => {});
 	}, { immediate: !0 }), {
 		categories: d,
-		categoryLabel: m,
-		settingsPending: u
+		categoryLabel: f,
+		settingsPending: u,
+		ensureSettings: h,
+		addCategory: g,
+		DEFAULT_CATEGORIES: $
 	};
 }
 //#endregion
 //#region src/data/versionHistory.ts
-var oe = [
+var ue = [
 	{
 		version: "0.2.2",
 		date: "2026-07-31",
@@ -460,10 +572,10 @@ var oe = [
 ];
 //#endregion
 //#region src/utils/formatDate.ts
-function se(e) {
+function de(e) {
 	return e?.toDate ? e.toDate().toLocaleDateString("ko-KR") : "";
 }
 //#endregion
-export { V as configureMemiBoard, se as formatDate, U as useMemiBoardAuth, J as useMemiBoardComments, H as useMemiBoardConfig, re as useMemiBoardModeration, q as useMemiBoardPosts, ae as useMemiBoardSettings, ie as useMemiBoardStorage, oe as versionHistory };
+export { $ as DEFAULT_CATEGORIES, ie as configureMemiBoard, de as formatDate, H as useMemiBoardAuth, q as useMemiBoardComments, V as useMemiBoardConfig, Q as useMemiBoardModeration, K as useMemiBoardPosts, le as useMemiBoardSettings, ce as useMemiBoardStorage, ue as versionHistory };
 
 //# sourceMappingURL=index.js.map