@velocelab/message 0.0.0-stage → 0.1.2

package/dist/frontend/message.js

@@ -0,0 +1,254 @@
+import { Bell as e, Button as t, Check as n, Fragment as r, Send as i, Sheet as a, SheetContent as o, SheetHeader as s, SheetTitle as c, Switch as l, Trash2 as u, api as d, jsx as f, jsxs as p, useEffect as m, useI18n as h, useState as g } from "/dashboard-client.js";
+//#region frontend/page.tsx
+function _() {
+	let { language: r, t: a } = h(), [o, s] = g([]), [c, _] = g([]), [v, y] = g([]), b = async () => {
+		try {
+			s((await d.get("/user/messages")).data.messages || []);
+		} catch {
+			s([]);
+		}
+	}, x = async () => {
+		let e = await d.get("/user/messages/types");
+		_(e.data.types || []), y(e.data.preferences || []);
+	};
+	m(() => {
+		b(), x();
+	}, []);
+	let S = async (e) => {
+		await d.post("/user/messages/read", { id: e }), await b();
+	}, C = async (e) => {
+		await d.post("/user/messages/delete", { id: e }), await b();
+	}, w = async () => {
+		await d.post("/user/messages/test", { language: r }), await b();
+	}, T = (e, t = "") => v.find((n) => n.plugin === e && n.type === t)?.enabled ?? !0, E = async (e, t, n) => {
+		await d.post("/user/messages/preferences", {
+			plugin: e,
+			type: t,
+			enabled: n
+		}), await x();
+	}, D = [...new Set(c.map((e) => e.plugin))], O = (e) => e === "message" ? a("message.title") : e, k = (e) => e.labelKey ? a(e.labelKey) : e.label, A = new Map(c.map((e) => [e.id, e])), j = o.reduce((e, t) => {
+		let n = A.get(t.type), r = `${n?.plugin || t.source}::${n ? k(n) : a("message.other")}`;
+		return e[r] = [...e[r] || [], t], e;
+	}, {});
+	return /* @__PURE__ */ p("div", {
+		className: "mx-auto max-w-2xl space-y-6",
+		children: [
+			/* @__PURE__ */ p("div", {
+				className: "flex flex-wrap items-start justify-between gap-4",
+				children: [/* @__PURE__ */ p("div", { children: [/* @__PURE__ */ f("h1", {
+					className: "text-3xl font-bold",
+					children: a("message.title")
+				}), /* @__PURE__ */ f("p", {
+					className: "mt-2 text-sm text-muted-foreground",
+					children: a("message.description")
+				})] }), /* @__PURE__ */ p(t, {
+					variant: "outline",
+					onClick: () => void w(),
+					children: [/* @__PURE__ */ f(i, { size: 16 }), a("message.sendTest")]
+				})]
+			}),
+			/* @__PURE__ */ p("section", {
+				className: "space-y-3",
+				children: [/* @__PURE__ */ f("h2", {
+					className: "text-lg font-semibold",
+					children: a("message.types")
+				}), D.map((e) => /* @__PURE__ */ p("div", {
+					className: "rounded-lg border p-4",
+					children: [/* @__PURE__ */ p("div", {
+						className: "flex items-center justify-between gap-3",
+						children: [/* @__PURE__ */ f("h3", {
+							className: "min-w-0 break-words font-medium",
+							children: O(e)
+						}), /* @__PURE__ */ f(l, {
+							"aria-label": a("message.enablePlugin", { plugin: O(e) }),
+							checked: T(e),
+							onCheckedChange: (t) => void E(e, "", t)
+						})]
+					}), /* @__PURE__ */ f("div", {
+						className: "mt-3 divide-y",
+						children: c.filter((t) => t.plugin === e).map((t) => /* @__PURE__ */ p("div", {
+							className: "flex items-center justify-between gap-3 py-2",
+							children: [/* @__PURE__ */ f("span", {
+								className: "min-w-0 break-words text-sm text-muted-foreground",
+								children: k(t)
+							}), /* @__PURE__ */ f(l, {
+								"aria-label": a("message.enableType", { type: k(t) }),
+								checked: T(e, t.id),
+								disabled: !T(e),
+								onCheckedChange: (n) => void E(e, t.id, n)
+							})]
+						}, t.id))
+					})]
+				}, e))]
+			}),
+			/* @__PURE__ */ f("div", {
+				className: "space-y-5",
+				children: o.length === 0 ? /* @__PURE__ */ f("div", {
+					className: "rounded-lg border py-16 text-center text-sm text-muted-foreground",
+					children: a("message.empty")
+				}) : Object.entries(j).map(([r, i]) => {
+					let [o, s] = r.split("::");
+					return /* @__PURE__ */ p("section", {
+						className: "space-y-2",
+						children: [/* @__PURE__ */ p("h2", {
+							className: "text-sm font-semibold",
+							children: [
+								O(o),
+								" ",
+								/* @__PURE__ */ p("span", {
+									className: "font-normal text-muted-foreground",
+									children: ["/ ", s]
+								})
+							]
+						}), i.map((r) => /* @__PURE__ */ p("div", {
+							className: "flex items-center gap-3 rounded-lg border p-4",
+							children: [
+								/* @__PURE__ */ f("span", {
+									className: "flex h-8 w-8 shrink-0 items-center justify-center rounded-md bg-muted",
+									children: /* @__PURE__ */ f(e, { size: 16 })
+								}),
+								/* @__PURE__ */ p("div", {
+									className: "min-w-0 flex-1",
+									children: [/* @__PURE__ */ f("p", {
+										className: "truncate font-medium",
+										children: r.title
+									}), /* @__PURE__ */ f("p", {
+										className: "mt-1 text-sm text-muted-foreground",
+										children: r.subtitle || O(r.source)
+									})]
+								}),
+								!r.read && /* @__PURE__ */ f(t, {
+									variant: "ghost",
+									size: "icon",
+									"aria-label": a("message.markRead"),
+									title: a("message.markRead"),
+									onClick: () => void S(r.id),
+									children: /* @__PURE__ */ f(n, { size: 16 })
+								}),
+								/* @__PURE__ */ f(t, {
+									variant: "ghost",
+									size: "icon",
+									"aria-label": a("message.delete"),
+									title: a("message.delete"),
+									onClick: () => void C(r.id),
+									children: /* @__PURE__ */ f(u, { size: 16 })
+								})
+							]
+						}, r.id))]
+					}, r);
+				})
+			})
+		]
+	});
+}
+//#endregion
+//#region frontend/index.tsx
+function v(e) {
+	if (!e || typeof window > "u") return !1;
+	try {
+		let t = new URL(e, window.location.origin), n = new URL(window.location.href), r = (e) => e.length > 1 ? e.replace(/\/+$/, "") : e;
+		return t.origin === n.origin && r(t.pathname) === r(n.pathname);
+	} catch {
+		return !1;
+	}
+}
+function y() {
+	let { t: n } = h(), [i, l] = g(!1), [_, y] = g([]), b = async () => {
+		try {
+			let e = (await d.get("/user/messages")).data.messages || [], t = e.filter((e) => v(e.action?.href));
+			t.length && await Promise.allSettled(t.map((e) => d.post("/user/messages/delete", { id: e.id }))), y(e.filter((e) => !v(e.action?.href)));
+		} catch {
+			y([]);
+		}
+	};
+	m(() => {
+		b();
+		let e = window.setInterval(() => void b(), 1e4);
+		return () => window.clearInterval(e);
+	}, []);
+	let x = async (e) => {
+		e.action?.href ? await d.post("/user/messages/delete", { id: e.id }) : await d.post("/user/messages/read", { id: e.id }), y((t) => t.filter((t) => t.id !== e.id)), l(!1), e.action?.href && window.location.assign(e.action.href);
+	}, S = async (e) => {
+		await d.post("/user/messages/delete", { id: e }), await b();
+	}, C = (t) => /* @__PURE__ */ f(e, { size: 16 });
+	return /* @__PURE__ */ p(r, { children: [/* @__PURE__ */ p(t, {
+		variant: "ghost",
+		size: "icon",
+		"aria-label": n("message.title"),
+		title: n("message.title"),
+		onClick: () => {
+			l(!0), b();
+		},
+		className: "relative",
+		children: [/* @__PURE__ */ f(e, { size: 18 }), _.some((e) => !e.read) && /* @__PURE__ */ f("span", { className: "absolute right-1 top-1 h-2 w-2 rounded-full bg-primary" })]
+	}), /* @__PURE__ */ f(a, {
+		open: i,
+		onOpenChange: l,
+		children: /* @__PURE__ */ p(o, {
+			side: "right",
+			className: "w-full sm:max-w-md",
+			children: [/* @__PURE__ */ f(s, { children: /* @__PURE__ */ p(c, {
+				className: "flex items-center gap-2",
+				children: [/* @__PURE__ */ f(e, { size: 18 }), n("message.title")]
+			}) }), /* @__PURE__ */ f("div", {
+				className: "mt-4 space-y-2 overflow-y-auto",
+				children: _.length === 0 ? /* @__PURE__ */ f("div", {
+					className: "py-16 text-center text-sm text-muted-foreground",
+					children: n("message.empty")
+				}) : _.map((e) => /* @__PURE__ */ p("div", {
+					className: "flex gap-3 rounded-lg border p-3",
+					children: [/* @__PURE__ */ p("button", {
+						className: "flex min-w-0 flex-1 gap-3 text-left",
+						onClick: () => void x(e),
+						children: [/* @__PURE__ */ f("span", {
+							className: "mt-0.5 flex h-8 w-8 shrink-0 items-center justify-center rounded-md bg-muted",
+							children: C(e)
+						}), /* @__PURE__ */ p("span", {
+							className: "min-w-0",
+							children: [
+								/* @__PURE__ */ f("span", {
+									className: "block truncate text-sm font-medium",
+									children: e.title
+								}),
+								/* @__PURE__ */ f("span", {
+									className: "mt-1 block text-xs text-muted-foreground",
+									children: e.subtitle
+								}),
+								/* @__PURE__ */ f("span", {
+									className: "mt-2 block text-[11px] text-muted-foreground",
+									children: n("message.from", { source: e.source === "message" ? n("message.title") : e.source })
+								})
+							]
+						})]
+					}), /* @__PURE__ */ f(t, {
+						variant: "ghost",
+						size: "icon",
+						"aria-label": n("message.delete"),
+						title: n("message.delete"),
+						onClick: () => void S(e.id),
+						children: /* @__PURE__ */ f(u, { size: 15 })
+					})]
+				}, e.id))
+			})]
+		})
+	})] });
+}
+function b(t) {
+	t.slot("topbar.actions", y, "message.button", 30), t.page({
+		frame: "settings",
+		path: "/settings/messages",
+		component: _,
+		minimumPermissionLevel: 10,
+		nav: {
+			id: "message.settings",
+			labelKey: "message.title",
+			icon: e,
+			order: 35,
+			minimumPermissionLevel: 10,
+			scope: "settings",
+			group: "general"
+		}
+	});
+}
+//#endregion
+export { y as MessageButton, b as apply, b as default };

package/dist/index.d.ts

@@ -0,0 +1,81 @@
+import { Context, Service } from "yumeri";
+import "@velocelab/dashboard";
+import "@velocelab/database-core";
+import "@velocelab/notification";
+export declare const depend: string[];
+export declare const provide: string[];
+export interface MessageAction {
+    href?: string;
+    method?: "GET" | "POST" | "PUT" | "DELETE";
+    body?: Record<string, unknown>;
+}
+export interface MessageType {
+    id: string;
+    plugin: string;
+    label: string;
+    labelKey?: string;
+}
+export interface MessageInput {
+    userId: number;
+    type: string;
+    dedupeKey: string;
+    icon?: string;
+    title: string;
+    subtitle?: string;
+    action?: MessageAction;
+}
+export interface MessageRecord extends MessageInput {
+    id: number;
+    source: string;
+    read: boolean;
+    created_at: string;
+    updated_at: string;
+}
+interface StoredMessage {
+    id?: number;
+    user_id: number;
+    type?: string;
+    dedupe_key: string;
+    icon: string;
+    title: string;
+    subtitle: string;
+    action: string;
+    source: string;
+    read: boolean;
+    created_at: string;
+    updated_at: string;
+}
+interface MessagePreference {
+    id?: number;
+    user_id: number;
+    plugin: string;
+    type: string;
+    enabled: boolean;
+}
+declare module "@yumerijs/types" {
+    interface Tables {
+        messages: StoredMessage;
+        message_preferences: MessagePreference;
+    }
+}
+declare module "yumeri" {
+    interface Components {
+        message: MessageService;
+    }
+}
+export declare class MessageService extends Service {
+    private readonly typesById;
+    private readonly db;
+    private readonly notification;
+    constructor(ctx: Context);
+    registerType(owner: Context, type: MessageType): void;
+    types(): MessageType[];
+    preferences(userId: number): Promise<Pick<MessagePreference, keyof MessagePreference>[]>;
+    setEnabled(userId: number, plugin: string, type: string, enabled: boolean): Promise<void>;
+    send(input: MessageInput): Promise<MessageRecord | undefined>;
+    remove(userId: number, id: number): Promise<void>;
+    markRead(userId: number, id: number): Promise<void>;
+    list(userId: number): Promise<MessageRecord[]>;
+}
+export declare function apply(ctx: Context): Promise<void>;
+export {};

package/dist/index.js

@@ -0,0 +1,90 @@
+import { Service } from "yumeri";
+import "@velocelab/dashboard";
+import "@velocelab/database-core";
+import "@velocelab/notification";
+import { messageTranslations } from "./translations.js";
+export const depend = ["database", "dashboard", "notification"];
+export const provide = ["message"];
+const currentUser = (session) => session.properties.user?.id;
+const registries = new WeakMap();
+const initialized = new WeakSet();
+const record = (row) => ({ id: Number(row.id), userId: row.user_id, type: row.type || `${row.source}:legacy`, dedupeKey: row.dedupe_key, icon: row.icon, title: row.title, subtitle: row.subtitle, action: row.action ? JSON.parse(row.action) : undefined, source: row.source, read: Boolean(row.read), created_at: row.created_at, updated_at: row.updated_at });
+export class MessageService extends Service {
+    typesById;
+    db;
+    notification;
+    constructor(ctx) { super(ctx); const core = ctx.getCore(); this.typesById = registries.get(core) ?? new Map(); registries.set(core, this.typesById); this.db = ctx.component.database; this.notification = ctx.component.notification; }
+    registerType(owner, type) { if (this.typesById.has(type.id))
+        throw new Error(`Message type already registered: ${type.id}`); this.typesById.set(type.id, type); owner.affect(() => { if (this.typesById.get(type.id) === type)
+        this.typesById.delete(type.id); }); }
+    types() { return [...this.typesById.values()]; }
+    async preferences(userId) { return await this.db.select("message_preferences", { user_id: userId }); }
+    async setEnabled(userId, plugin, type, enabled) { if (!this.types().some(item => item.plugin === plugin && (!type || item.id === type)))
+        throw Error("Unknown message type"); const key = { user_id: userId, plugin, type }; const existing = await this.db.selectOne("message_preferences", key); if (existing)
+        await this.db.update("message_preferences", key, { enabled });
+    else
+        await this.db.create("message_preferences", { ...key, enabled }); }
+    async send(input) { const type = this.typesById.get(input.type); if (!type)
+        throw Error(`Message type is not registered: ${input.type}`); const prefs = await this.preferences(input.userId); if (prefs.some(item => item.plugin === type.plugin && !item.enabled && (!item.type || item.type === type.id)))
+        return; const now = new Date().toISOString(); const action = input.action ? JSON.stringify(input.action) : ""; const key = { user_id: input.userId, type: type.id, dedupe_key: `${type.id}:${input.dedupeKey}` }; const data = { icon: input.icon || "bell", title: input.title, subtitle: input.subtitle || "", action, source: type.plugin, read: false, updated_at: now }; const existing = await this.db.selectOne("messages", key); let result; if (existing) {
+        await this.db.update("messages", { id: existing.id }, data);
+        result = record({ ...existing, ...data, type: type.id });
+    }
+    else
+        result = record(await this.db.create("messages", { ...key, ...data, created_at: now })); await this.notification.send({ userId: input.userId, title: input.title, body: input.subtitle, tag: `message-${type.id}-${input.dedupeKey}`, url: input.action?.href }); return result; }
+    async remove(userId, id) { await this.db.remove("messages", { id, user_id: userId }); }
+    async markRead(userId, id) { await this.db.update("messages", { id, user_id: userId }, { read: true, updated_at: new Date().toISOString() }); }
+    async list(userId) { return (await this.db.select("messages", { user_id: userId })).sort((a, b) => String(b.updated_at).localeCompare(String(a.updated_at))).map(record); }
+}
+export async function apply(ctx) {
+    const core = ctx.getCore();
+    if (initialized.has(core))
+        return;
+    for (const [key, translations] of Object.entries(messageTranslations))
+        ctx.i18n(key, translations);
+    const db = ctx.component.database;
+    await db.extend("messages", { id: { type: "integer", autoIncrement: true }, user_id: { type: "integer", nullable: false }, type: "string", dedupe_key: { type: "string", nullable: false }, icon: { type: "string", initial: "bell" }, title: { type: "string", nullable: false }, subtitle: "string", action: "json", source: { type: "string", nullable: false }, read: { type: "boolean", initial: false }, created_at: "timestamp", updated_at: "timestamp" }, { unique: [["user_id", "dedupe_key"]] });
+    await db.extend("message_preferences", { id: { type: "integer", autoIncrement: true }, user_id: { type: "integer", nullable: false }, plugin: { type: "string", nullable: false }, type: { type: "string", nullable: false }, enabled: { type: "boolean", initial: true } }, { unique: [["user_id", "plugin", "type"]] });
+    if (!ctx.getCore().services.message)
+        ctx.registerService("message", MessageService);
+    const service = ctx.component.message ?? new MessageService(ctx);
+    service.registerType(ctx, { id: "message:test", plugin: "message", label: "测试消息", labelKey: "message.testTitle" });
+    ctx.component.dashboard.addEntry({ dev: new URL("../frontend/index.tsx", import.meta.url).pathname, prod: new URL("./frontend/message.js", import.meta.url).pathname, plugin: "message" });
+    ctx.route("/api/user/messages").methods("GET").action(async (session) => { const id = currentUser(session); if (id)
+        session.respond({ messages: await service.list(id) }, "json"); });
+    ctx.route("/api/user/messages/types").methods("GET").action(async (session) => { const id = currentUser(session); if (id)
+        session.respond({ types: service.types(), preferences: await service.preferences(id) }, "json"); });
+    ctx.route("/api/user/messages/preferences").methods("POST").action(async (session) => { const id = currentUser(session); const body = await session.parseRequestBody(); if (id && typeof body?.plugin === "string" && typeof body?.enabled === "boolean") {
+        await service.setEnabled(id, body.plugin, String(body.type || ""), body.enabled);
+        session.respond({ ok: true }, "json");
+    } });
+    ctx.route("/api/user/messages/delete").methods("POST").action(async (session) => { const id = currentUser(session); const body = await session.parseRequestBody(); if (id && Number(body?.id)) {
+        await service.remove(id, Number(body.id));
+        session.respond({ ok: true }, "json");
+    } });
+    ctx.route("/api/user/messages/read").methods("POST").action(async (session) => { const id = currentUser(session); const body = await session.parseRequestBody(); if (id && Number(body?.id)) {
+        await service.markRead(id, Number(body.id));
+        session.respond({ ok: true }, "json");
+    } });
+    ctx.route("/api/user/messages/test").methods("POST").action(async (session) => { const id = currentUser(session); if (!id) {
+        session.status = 401;
+        session.respond({ error: "unauthorized" }, "json");
+        return;
+    } try {
+        const body = await session.parseRequestBody();
+        const language = body?.language === "en" || body?.language === "ja" ? body.language : "zh";
+        const message = await service.send({ userId: id, type: "message:test", dedupeKey: `test-${Date.now()}`, title: messageTranslations["message.testTitle"][language], subtitle: messageTranslations["message.testBody"][language] });
+        if (!message) {
+            session.status = 403;
+            session.respond({ error: "test message type is disabled" }, "json");
+            return;
+        }
+        session.respond({ message }, "json");
+    }
+    catch (error) {
+        session.status = 400;
+        session.respond({ error: error instanceof Error ? error.message : String(error) }, "json");
+    } });
+    initialized.add(core);
+    ctx.affect(() => { initialized.delete(core); });
+}

package/dist/translations.d.ts

@@ -0,0 +1,67 @@
+export declare const messageTranslations: {
+    readonly "message.title": {
+        readonly zh: "消息";
+        readonly en: "Messages";
+        readonly ja: "メッセージ";
+    };
+    readonly "message.description": {
+        readonly zh: "查看和管理来自 Veloce 各功能的消息。";
+        readonly en: "View and manage messages from Veloce features.";
+        readonly ja: "Veloce の各機能からのメッセージを確認・管理します。";
+    };
+    readonly "message.empty": {
+        readonly zh: "暂无消息";
+        readonly en: "No messages";
+        readonly ja: "メッセージはありません";
+    };
+    readonly "message.from": {
+        readonly zh: "来自 {source}";
+        readonly en: "From {source}";
+        readonly ja: "送信元: {source}";
+    };
+    readonly "message.delete": {
+        readonly zh: "删除消息";
+        readonly en: "Delete message";
+        readonly ja: "メッセージを削除";
+    };
+    readonly "message.markRead": {
+        readonly zh: "标记已读";
+        readonly en: "Mark as read";
+        readonly ja: "既読にする";
+    };
+    readonly "message.types": {
+        readonly zh: "消息类型";
+        readonly en: "Message types";
+        readonly ja: "メッセージの種類";
+    };
+    readonly "message.other": {
+        readonly zh: "其他消息";
+        readonly en: "Other messages";
+        readonly ja: "その他のメッセージ";
+    };
+    readonly "message.sendTest": {
+        readonly zh: "发送测试消息";
+        readonly en: "Send test message";
+        readonly ja: "テストメッセージを送信";
+    };
+    readonly "message.testTitle": {
+        readonly zh: "测试消息";
+        readonly en: "Test message";
+        readonly ja: "テストメッセージ";
+    };
+    readonly "message.testBody": {
+        readonly zh: "这是一条测试消息。";
+        readonly en: "This is a test message.";
+        readonly ja: "これはテストメッセージです。";
+    };
+    readonly "message.enablePlugin": {
+        readonly zh: "启用 {plugin} 的消息";
+        readonly en: "Enable messages from {plugin}";
+        readonly ja: "{plugin} のメッセージを有効にする";
+    };
+    readonly "message.enableType": {
+        readonly zh: "启用{type}";
+        readonly en: "Enable {type}";
+        readonly ja: "{type}を有効にする";
+    };
+};

package/dist/translations.js

@@ -0,0 +1,15 @@
+export const messageTranslations = {
+    "message.title": { zh: "消息", en: "Messages", ja: "メッセージ" },
+    "message.description": { zh: "查看和管理来自 Veloce 各功能的消息。", en: "View and manage messages from Veloce features.", ja: "Veloce の各機能からのメッセージを確認・管理します。" },
+    "message.empty": { zh: "暂无消息", en: "No messages", ja: "メッセージはありません" },
+    "message.from": { zh: "来自 {source}", en: "From {source}", ja: "送信元: {source}" },
+    "message.delete": { zh: "删除消息", en: "Delete message", ja: "メッセージを削除" },
+    "message.markRead": { zh: "标记已读", en: "Mark as read", ja: "既読にする" },
+    "message.types": { zh: "消息类型", en: "Message types", ja: "メッセージの種類" },
+    "message.other": { zh: "其他消息", en: "Other messages", ja: "その他のメッセージ" },
+    "message.sendTest": { zh: "发送测试消息", en: "Send test message", ja: "テストメッセージを送信" },
+    "message.testTitle": { zh: "测试消息", en: "Test message", ja: "テストメッセージ" },
+    "message.testBody": { zh: "这是一条测试消息。", en: "This is a test message.", ja: "これはテストメッセージです。" },
+    "message.enablePlugin": { zh: "启用 {plugin} 的消息", en: "Enable messages from {plugin}", ja: "{plugin} のメッセージを有効にする" },
+    "message.enableType": { zh: "启用{type}", en: "Enable {type}", ja: "{type}を有効にする" },
+};

package/frontend/index.tsx

@@ -0,0 +1,39 @@
+import { Bell, Trash2 } from "lucide-react"
+import { useEffect, useState } from "react"
+import type { DashboardContext } from "@velocelab/dashboard/frontend"
+import { api, Button, Sheet, SheetContent, SheetHeader, SheetTitle } from "@velocelab/dashboard/frontend"
+import MessageSettings from "./page"
+import { useI18n } from "@/lib/i18n"
+
+type Message = { id:number; icon?:string; title:string; subtitle?:string; source:string; read:boolean; action?:{href?:string; method?:string; body?:Record<string,unknown>} }
+
+function targetsCurrentPath(href?: string) {
+  if (!href || typeof window === "undefined") return false
+  try {
+    const target = new URL(href, window.location.origin)
+    const current = new URL(window.location.href)
+    const normalize = (pathname: string) => pathname.length > 1 ? pathname.replace(/\/+$/, "") : pathname
+    return target.origin === current.origin && normalize(target.pathname) === normalize(current.pathname)
+  } catch {
+    return false
+  }
+}
+
+export function MessageButton() {
+  const { t } = useI18n()
+  const [open,setOpen]=useState(false); const [messages,setMessages]=useState<Message[]>([])
+  const load=async()=>{try{const response=await api.get("/user/messages"); const next=(response.data.messages||[]) as Message[]; const reached=next.filter((message) => targetsCurrentPath(message.action?.href)); if (reached.length) await Promise.allSettled(reached.map((message) => api.post("/user/messages/delete",{id:message.id}))); setMessages(next.filter((message) => !targetsCurrentPath(message.action?.href)))}catch{setMessages([])}}
+  useEffect(() => { void load(); const timer = window.setInterval(() => void load(), 10000); return () => window.clearInterval(timer) }, [])
+  const activate=async(message:Message)=>{if (message.action?.href) await api.post("/user/messages/delete",{id:message.id}); else await api.post("/user/messages/read",{id:message.id}); setMessages((current) => current.filter((item) => item.id !== message.id)); setOpen(false); if(message.action?.href) window.location.assign(message.action.href)}
+  const remove=async(id:number)=>{await api.post("/user/messages/delete",{id}); await load()}
+  const icon=(_message:Message)=><Bell size={16}/>
+  return <>
+    <Button variant="ghost" size="icon" aria-label={t("message.title")} title={t("message.title")} onClick={()=>{setOpen(true); void load()}} className="relative"><Bell size={18}/>{messages.some(m=>!m.read)&&<span className="absolute right-1 top-1 h-2 w-2 rounded-full bg-primary"/>}</Button>
+    <Sheet open={open} onOpenChange={setOpen}><SheetContent side="right" className="w-full sm:max-w-md"><SheetHeader><SheetTitle className="flex items-center gap-2"><Bell size={18}/>{t("message.title")}</SheetTitle></SheetHeader><div className="mt-4 space-y-2 overflow-y-auto">{messages.length===0?<div className="py-16 text-center text-sm text-muted-foreground">{t("message.empty")}</div>:messages.map(message=><div key={message.id} className="flex gap-3 rounded-lg border p-3"><button className="flex min-w-0 flex-1 gap-3 text-left" onClick={()=>void activate(message)}><span className="mt-0.5 flex h-8 w-8 shrink-0 items-center justify-center rounded-md bg-muted">{icon(message)}</span><span className="min-w-0"><span className="block truncate text-sm font-medium">{message.title}</span><span className="mt-1 block text-xs text-muted-foreground">{message.subtitle}</span><span className="mt-2 block text-[11px] text-muted-foreground">{t("message.from", { source: message.source === "message" ? t("message.title") : message.source })}</span></span></button><Button variant="ghost" size="icon" aria-label={t("message.delete")} title={t("message.delete")} onClick={()=>void remove(message.id)}><Trash2 size={15}/></Button></div>)}</div></SheetContent></Sheet>
+  </>
+}
+export function apply(ctx: DashboardContext) {
+  ctx.slot("topbar.actions", MessageButton, "message.button", 30)
+  ctx.page({ frame: "settings", path: "/settings/messages", component: MessageSettings, minimumPermissionLevel: 10, nav: { id: "message.settings", labelKey: "message.title", icon: Bell, order: 35, minimumPermissionLevel: 10, scope: "settings", group: "general" } })
+}
+export default apply

package/frontend/page.tsx

@@ -0,0 +1,37 @@
+import { Bell, Check, Send, Trash2 } from "lucide-react"
+import { useEffect, useState } from "react"
+import { api, Button, Switch } from "@velocelab/dashboard/frontend"
+import { useI18n } from "@/lib/i18n"
+
+type Message = { id: number; title: string; subtitle?: string; source: string; type: string; read: boolean }
+type MessageType = { id: string; plugin: string; label: string; labelKey?: string }
+
+export default function MessageSettings() {
+  const { language, t } = useI18n()
+  const [messages, setMessages] = useState<Message[]>([])
+  const [types, setTypes] = useState<MessageType[]>([])
+  const [preferences, setPreferences] = useState<Array<{ plugin: string; type: string; enabled: boolean }>>([])
+  const load = async () => { try { setMessages((await api.get("/user/messages")).data.messages || []) } catch { setMessages([]) } }
+  const loadTypes = async () => { const response = await api.get("/user/messages/types"); setTypes(response.data.types || []); setPreferences(response.data.preferences || []) }
+  useEffect(() => { void load(); void loadTypes() }, [])
+  const markRead = async (id: number) => { await api.post("/user/messages/read", { id }); await load() }
+  const remove = async (id: number) => { await api.post("/user/messages/delete", { id }); await load() }
+  const test = async () => { await api.post("/user/messages/test", { language }); await load() }
+  const enabled = (plugin: string, type = "") => preferences.find(item => item.plugin === plugin && item.type === type)?.enabled ?? true
+  const setEnabled = async (plugin: string, type: string, value: boolean) => { await api.post("/user/messages/preferences", { plugin, type, enabled: value }); await loadTypes() }
+  const groups = [...new Set(types.map(type => type.plugin))]
+  const pluginLabel = (plugin: string) => plugin === "message" ? t("message.title") : plugin
+  const typeLabel = (type: MessageType) => type.labelKey ? t(type.labelKey) : type.label
+  const typeById = new Map(types.map(type => [type.id, type]))
+  const messageGroups = messages.reduce<Record<string, Message[]>>((result, message) => {
+    const type = typeById.get(message.type)
+    const key = `${type?.plugin || message.source}::${type ? typeLabel(type) : t("message.other")}`
+    result[key] = [...(result[key] || []), message]
+    return result
+  }, {})
+  return <div className="mx-auto max-w-2xl space-y-6">
+    <div className="flex flex-wrap items-start justify-between gap-4"><div><h1 className="text-3xl font-bold">{t("message.title")}</h1><p className="mt-2 text-sm text-muted-foreground">{t("message.description")}</p></div><Button variant="outline" onClick={() => void test()}><Send size={16} />{t("message.sendTest")}</Button></div>
+    <section className="space-y-3"><h2 className="text-lg font-semibold">{t("message.types")}</h2>{groups.map(plugin => <div key={plugin} className="rounded-lg border p-4"><div className="flex items-center justify-between gap-3"><h3 className="min-w-0 break-words font-medium">{pluginLabel(plugin)}</h3><Switch aria-label={t("message.enablePlugin", { plugin: pluginLabel(plugin) })} checked={enabled(plugin)} onCheckedChange={value => void setEnabled(plugin, "", value)} /></div><div className="mt-3 divide-y">{types.filter(type => type.plugin === plugin).map(type => <div key={type.id} className="flex items-center justify-between gap-3 py-2"><span className="min-w-0 break-words text-sm text-muted-foreground">{typeLabel(type)}</span><Switch aria-label={t("message.enableType", { type: typeLabel(type) })} checked={enabled(plugin, type.id)} disabled={!enabled(plugin)} onCheckedChange={value => void setEnabled(plugin, type.id, value)} /></div>)}</div></div>)}</section>
+    <div className="space-y-5">{messages.length === 0 ? <div className="rounded-lg border py-16 text-center text-sm text-muted-foreground">{t("message.empty")}</div> : Object.entries(messageGroups).map(([key, items]) => { const [plugin, label] = key.split("::"); return <section key={key} className="space-y-2"><h2 className="text-sm font-semibold">{pluginLabel(plugin)} <span className="font-normal text-muted-foreground">/ {label}</span></h2>{items.map(message => <div key={message.id} className="flex items-center gap-3 rounded-lg border p-4"><span className="flex h-8 w-8 shrink-0 items-center justify-center rounded-md bg-muted"><Bell size={16} /></span><div className="min-w-0 flex-1"><p className="truncate font-medium">{message.title}</p><p className="mt-1 text-sm text-muted-foreground">{message.subtitle || pluginLabel(message.source)}</p></div>{!message.read && <Button variant="ghost" size="icon" aria-label={t("message.markRead")} title={t("message.markRead")} onClick={() => void markRead(message.id)}><Check size={16} /></Button>}<Button variant="ghost" size="icon" aria-label={t("message.delete")} title={t("message.delete")} onClick={() => void remove(message.id)}><Trash2 size={16} /></Button></div>)}</section> })}</div>
+  </div>
+}

package/package.json

@@ -1,6 +1,19 @@
 {
   "name": "@velocelab/message",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.2",
+  "type": "module",
+  "main": "dist/index.js",
+  "dev": "src/index.ts",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "../../node_modules/.bin/tsc -p tsconfig.json && ../../node_modules/.bin/vite build"
+  },
+  "dependencies": {
+    "@velocelab/dashboard": "^0.1.5",
+    "@velocelab/database-core": "^0.1.1",
+    "@velocelab/notification": "^0.1.2"
+  },
+  "peerDependencies": {
+    "yumeri": "^3.0.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,57 @@
+import { Context, Core, Database, Service, Session } from "yumeri";
+import "@velocelab/dashboard";
+import "@velocelab/database-core";
+import "@velocelab/notification";
+import { messageTranslations } from "./translations.js";
+
+export const depend = ["database", "dashboard", "notification"];
+export const provide = ["message"];
+export interface MessageAction { href?: string; method?: "GET" | "POST" | "PUT" | "DELETE"; body?: Record<string, unknown> }
+export interface MessageType { id: string; plugin: string; label: string; labelKey?: string }
+export interface MessageInput { userId: number; type: string; dedupeKey: string; icon?: string; title: string; subtitle?: string; action?: MessageAction }
+export interface MessageRecord extends MessageInput { id: number; source: string; read: boolean; created_at: string; updated_at: string }
+interface StoredMessage { id?: number; user_id: number; type?: string; dedupe_key: string; icon: string; title: string; subtitle: string; action: string; source: string; read: boolean; created_at: string; updated_at: string }
+interface MessagePreference { id?: number; user_id: number; plugin: string; type: string; enabled: boolean }
+interface NotificationService { send(input: { userId: number; title: string; body?: string; tag?: string; url?: string }): Promise<void> }
+declare module "@yumerijs/types" { interface Tables { messages: StoredMessage; message_preferences: MessagePreference } }
+declare module "yumeri" { interface Components { message: MessageService } }
+const currentUser = (session: Session) => (session.properties.user as { id?: number } | undefined)?.id;
+const registries = new WeakMap<Core, Map<string, MessageType>>();
+const initialized = new WeakSet<Core>();
+const record = (row: StoredMessage): MessageRecord => ({ id: Number(row.id), userId: row.user_id, type: row.type || `${row.source}:legacy`, dedupeKey: row.dedupe_key, icon: row.icon, title: row.title, subtitle: row.subtitle, action: row.action ? JSON.parse(row.action) : undefined, source: row.source, read: Boolean(row.read), created_at: row.created_at, updated_at: row.updated_at });
+
+export class MessageService extends Service {
+  private readonly typesById: Map<string, MessageType>;
+  private readonly db: Database;
+  private readonly notification: NotificationService;
+  constructor(ctx: Context) { super(ctx); const core = ctx.getCore(); this.typesById = registries.get(core) ?? new Map(); registries.set(core, this.typesById); this.db = ctx.component.database as Database; this.notification = ctx.component.notification as NotificationService; }
+  registerType(owner: Context, type: MessageType) { if (this.typesById.has(type.id)) throw new Error(`Message type already registered: ${type.id}`); this.typesById.set(type.id, type); owner.affect(() => { if (this.typesById.get(type.id) === type) this.typesById.delete(type.id); }); }
+  types() { return [...this.typesById.values()]; }
+  async preferences(userId: number) { return await this.db.select("message_preferences", { user_id: userId }); }
+  async setEnabled(userId: number, plugin: string, type: string, enabled: boolean) { if (!this.types().some(item => item.plugin === plugin && (!type || item.id === type))) throw Error("Unknown message type"); const key = { user_id: userId, plugin, type }; const existing = await this.db.selectOne("message_preferences", key); if (existing) await this.db.update("message_preferences", key, { enabled }); else await this.db.create("message_preferences", { ...key, enabled }); }
+  async send(input: MessageInput): Promise<MessageRecord | undefined> { const type = this.typesById.get(input.type); if (!type) throw Error(`Message type is not registered: ${input.type}`); const prefs = await this.preferences(input.userId); if (prefs.some(item => item.plugin === type.plugin && !item.enabled && (!item.type || item.type === type.id))) return; const now = new Date().toISOString(); const action = input.action ? JSON.stringify(input.action) : ""; const key = { user_id: input.userId, type: type.id, dedupe_key: `${type.id}:${input.dedupeKey}` }; const data = { icon: input.icon || "bell", title: input.title, subtitle: input.subtitle || "", action, source: type.plugin, read: false, updated_at: now }; const existing = await this.db.selectOne("messages", key); let result: MessageRecord; if (existing) { await this.db.update("messages", { id: existing.id }, data); result = record({ ...existing, ...data, type: type.id }); } else result = record(await this.db.create("messages", { ...key, ...data, created_at: now })); await this.notification.send({ userId: input.userId, title: input.title, body: input.subtitle, tag: `message-${type.id}-${input.dedupeKey}`, url: input.action?.href }); return result; }
+  async remove(userId: number, id: number) { await this.db.remove("messages", { id, user_id: userId }); }
+  async markRead(userId: number, id: number) { await this.db.update("messages", { id, user_id: userId }, { read: true, updated_at: new Date().toISOString() }); }
+  async list(userId: number) { return (await this.db.select("messages", { user_id: userId })).sort((a, b) => String(b.updated_at).localeCompare(String(a.updated_at))).map(record); }
+}
+
+export async function apply(ctx: Context) {
+  const core = ctx.getCore();
+  if (initialized.has(core)) return;
+  for (const [key, translations] of Object.entries(messageTranslations)) ctx.i18n(key, translations);
+  const db = ctx.component.database as Database;
+  await db.extend("messages", { id: { type: "integer", autoIncrement: true }, user_id: { type: "integer", nullable: false }, type: "string", dedupe_key: { type: "string", nullable: false }, icon: { type: "string", initial: "bell" }, title: { type: "string", nullable: false }, subtitle: "string", action: "json", source: { type: "string", nullable: false }, read: { type: "boolean", initial: false }, created_at: "timestamp", updated_at: "timestamp" }, { unique: [["user_id", "dedupe_key"]] });
+  await db.extend("message_preferences", { id: { type: "integer", autoIncrement: true }, user_id: { type: "integer", nullable: false }, plugin: { type: "string", nullable: false }, type: { type: "string", nullable: false }, enabled: { type: "boolean", initial: true } }, { unique: [["user_id", "plugin", "type"]] });
+  if (!(ctx.getCore() as Core & { services: Record<string, unknown> }).services.message) ctx.registerService("message", MessageService);
+  const service = (ctx.component.message as MessageService | undefined) ?? new MessageService(ctx);
+  service.registerType(ctx, { id: "message:test", plugin: "message", label: "测试消息", labelKey: "message.testTitle" });
+  ctx.component.dashboard.addEntry({ dev: new URL("../frontend/index.tsx", import.meta.url).pathname, prod: new URL("./frontend/message.js", import.meta.url).pathname, plugin: "message" });
+  ctx.route("/api/user/messages").methods("GET").action(async session => { const id = currentUser(session); if (id) session.respond({ messages: await service.list(id) }, "json"); });
+  ctx.route("/api/user/messages/types").methods("GET").action(async session => { const id = currentUser(session); if (id) session.respond({ types: service.types(), preferences: await service.preferences(id) }, "json"); });
+  ctx.route("/api/user/messages/preferences").methods("POST").action(async session => { const id = currentUser(session); const body = await session.parseRequestBody() as any; if (id && typeof body?.plugin === "string" && typeof body?.enabled === "boolean") { await service.setEnabled(id, body.plugin, String(body.type || ""), body.enabled); session.respond({ ok: true }, "json"); } });
+  ctx.route("/api/user/messages/delete").methods("POST").action(async session => { const id = currentUser(session); const body = await session.parseRequestBody() as any; if (id && Number(body?.id)) { await service.remove(id, Number(body.id)); session.respond({ ok: true }, "json"); } });
+  ctx.route("/api/user/messages/read").methods("POST").action(async session => { const id = currentUser(session); const body = await session.parseRequestBody() as any; if (id && Number(body?.id)) { await service.markRead(id, Number(body.id)); session.respond({ ok: true }, "json"); } });
+  ctx.route("/api/user/messages/test").methods("POST").action(async session => { const id = currentUser(session); if (!id) { session.status = 401; session.respond({ error: "unauthorized" }, "json"); return; } try { const body = await session.parseRequestBody() as { language?: string } | undefined; const language = body?.language === "en" || body?.language === "ja" ? body.language : "zh"; const message = await service.send({ userId: id, type: "message:test", dedupeKey: `test-${Date.now()}`, title: messageTranslations["message.testTitle"][language], subtitle: messageTranslations["message.testBody"][language] }); if (!message) { session.status = 403; session.respond({ error: "test message type is disabled" }, "json"); return; } session.respond({ message }, "json"); } catch (error) { session.status = 400; session.respond({ error: error instanceof Error ? error.message : String(error) }, "json"); } });
+  initialized.add(core);
+  ctx.affect(() => { initialized.delete(core); });
+}

package/src/translations.ts

@@ -0,0 +1,15 @@
+export const messageTranslations = {
+  "message.title": { zh: "消息", en: "Messages", ja: "メッセージ" },
+  "message.description": { zh: "查看和管理来自 Veloce 各功能的消息。", en: "View and manage messages from Veloce features.", ja: "Veloce の各機能からのメッセージを確認・管理します。" },
+  "message.empty": { zh: "暂无消息", en: "No messages", ja: "メッセージはありません" },
+  "message.from": { zh: "来自 {source}", en: "From {source}", ja: "送信元: {source}" },
+  "message.delete": { zh: "删除消息", en: "Delete message", ja: "メッセージを削除" },
+  "message.markRead": { zh: "标记已读", en: "Mark as read", ja: "既読にする" },
+  "message.types": { zh: "消息类型", en: "Message types", ja: "メッセージの種類" },
+  "message.other": { zh: "其他消息", en: "Other messages", ja: "その他のメッセージ" },
+  "message.sendTest": { zh: "发送测试消息", en: "Send test message", ja: "テストメッセージを送信" },
+  "message.testTitle": { zh: "测试消息", en: "Test message", ja: "テストメッセージ" },
+  "message.testBody": { zh: "这是一条测试消息。", en: "This is a test message.", ja: "これはテストメッセージです。" },
+  "message.enablePlugin": { zh: "启用 {plugin} 的消息", en: "Enable messages from {plugin}", ja: "{plugin} のメッセージを有効にする" },
+  "message.enableType": { zh: "启用{type}", en: "Enable {type}", ja: "{type}を有効にする" },
+} as const

package/tsconfig.json

@@ -0,0 +1 @@
+{"extends":"../../tsconfig.json","compilerOptions":{"rootDir":"src","outDir":"dist"},"include":["src"]}

package/vite.config.ts

@@ -0,0 +1,2 @@
+import react from "@vitejs/plugin-react"; import { defineConfig } from "vite"; import { dashboardClientUrl as client } from "../dashboard/client-version";
+export default defineConfig({ define:{"process.env.NODE_ENV":JSON.stringify("production")}, plugins:[react()], resolve:{alias:[{find:"react/jsx-runtime",replacement:client},{find:"react/jsx-dev-runtime",replacement:client},{find:"react-dom/client",replacement:client},{find:"react-dom",replacement:client},{find:"react-router-dom",replacement:client},{find:"@tanstack/react-query",replacement:client},{find:"lucide-react",replacement:client},{find:"react",replacement:client},{find:"@velocelab/dashboard/frontend",replacement:client},{find:/^@\/(components|lib|hooks)(?:\/.*)?$/,replacement:client},{find:"@",replacement:"frontend"}]},build:{outDir:"dist/frontend",rollupOptions:{external:[client]},lib:{entry:"frontend/index.tsx",formats:["es"],fileName:()=>"message.js"}}});

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.